Skip to main content
Astra Automation
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Creare un nuovo cluster gestito

PDF

POST /accounts/{account_id}/topology/v1/managedClusters

Indica i valori desiderati per la risorsa API del cluster gestito da creare.

Parametri

Nome Tipo In Obbligatorio Descrizione

ID account

stringa

percorso

Vero

ID della risorsa account contenitore

  • esempio: {{.Account}}

Corpo della richiesta

Indica i valori desiderati per la risorsa API del cluster gestito da creare.

Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

Tipo di media della risorsa. I valori definiti sono:

  • "applicazione/astra-managedCluster"

versione

stringa

Vero

Versione della risorsa. I valori definiti sono:

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

  • "1,4"

  • "1,5"

  • "1,6"

  • "1,7"

id

stringa

Vero

Identificatore univoco globale della risorsa. I valori definiti sono:

  • Conforme allo schema UUIDv4

tridentManagedStateDesired

stringa

Falso

Stringa JSON contenente un valore che indica lo stato di gestione desiderato per Trident. I valori definiti sono:

  • "gestito" - Gestisci Trident su questo cluster

  • "non gestito" - Non gestire Trident su questo cluster

defaultStorageClass

stringa

Falso

Stringa JSON contenente un ID di classe di archiviazione corrispondente alla classe di archiviazione predefinita, come impostata in Kubernetes. I valori definiti sono:

  • Conforme allo schema di identificazione Astra. Se non incluso, non è stato ancora rilevato.

defaultBucketID

stringa

Falso

Stringa JSON contenente l'ID di un bucket che verrà utilizzato di default per la persistenza dei metadati delle applicazioni per un cluster Neptune gestito. Se non viene specificato alcun bucket predefinito sul cluster, verrà utilizzato il bucket predefinito del cloud corrispondente.

metadati

"aggiornamento dei metadati di tipo Astra"

Falso

Metadati specificati dal client e dal servizio associati alla risorsa. I valori definiti sono:

  • Conforme allo schema dei metadati Astra. Se non specificato in fase di creazione, verrà creato un oggetto metadati senza etichette. Se non specificato in fase di aggiornamento, le etichette dell'oggetto metadati, creationTimestamp e createdBy, verranno conservate senza modifiche.
Esempio di richiesta 
{
  "type": "application/astra-managedCluster",
  "version": "1.7",
  "id": "241e9d94-eb8b-5c25-ba20-9292baac2396",
  "defaultStorageClass": "e280ff62-be35-4f31-a31b-a210a1ad1b33",
  "tridentManagedStateDesired": "managed"
}

Risposta

Status: 201, Returns the newly created managedCluster resource in the JSON response body.
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

Tipo di media della risorsa. I valori definiti sono:

  • "applicazione/astra-managedCluster"

versione

stringa

Vero

Versione della risorsa. I valori definiti sono:

  • "1,0"

  • "1,1"

  • "1,2"

  • "1,3"

  • "1,4"

  • "1,5"

  • "1,6"

  • "1,7"

id

stringa

Vero

Identificatore univoco globale della risorsa. I valori definiti sono:

  • Conforme allo schema UUIDv4

nome

stringa

Vero

Stringa JSON contenente un nome per il cluster. I valori definiti sono:

  • Lunghezza minima: 1

  • Lunghezza massima: 63

  • Questa stringa viene convalidata internamente per prevenire attacchi XSS, Unicode, directory traversal e SQL-injection.

stato

stringa

Vero

Stringa JSON contenente un valore che indica lo stato operativo del cluster. I valori definiti sono:

  • "in sospeso" - Il cluster è programmato per la scoperta

  • "scoperta" - Il cluster è in fase di scoperta

  • "Provisioning" - Il cluster è in fase di provisioning

  • "in esecuzione" - Il cluster è in esecuzione normalmente

  • "fallito" - Il cluster si trova in uno stato di errore permanente

  • "rimosso" - Il cluster non è attualmente accessibile

  • "sconosciuto" - Non è possibile determinare lo stato del cluster

restoreTargetSupported

stringa

Falso

Stringa JSON contenente un valore che indica la capacità del cluster gestito di essere un target delle operazioni di gestione dei dati dell'applicazione. I valori definiti sono:

  • "vero" - Il cluster è una destinazione idonea per le operazioni di gestione dei dati dell'app.

  • "falso" - Il cluster non è una destinazione idonea per le operazioni di gestione dei dati delle app.

snapshotSupported

stringa

Falso

Stringa JSON contenente un valore che indica la capacità del cluster gestito di eseguire operazioni di gestione dei dati delle applicazioni simili a backup. I valori definiti sono:

  • "vero" - Il cluster è idoneo a eseguire operazioni di gestione dei dati dell'app.

  • "falso" - Il cluster non è idoneo a eseguire operazioni di gestione dei dati dell'app.

stateUnready

array[string]

Vero

Array JSON di stringhe JSON, ognuna delle quali indica un motivo per cui il cluster non è in grado di passare allo stato "in esecuzione", quando si verificano problemi mentre è già in esecuzione, o perché è passato allo stato "non riuscito" o "rimosso". I valori definiti sono:

  • Lunghezza minima: 1

  • Lunghezza massima: 127

managedState

stringa

Vero

Stringa JSON contenente un valore che indica lo stato di gestione del cluster. I valori definiti sono:

  • "in sospeso" - Il cluster è programmato per essere scoperto o aggiunto

  • "non idoneo" - Il cluster è in stato "in esecuzione", non è gestito e non è idoneo alla gestione. Il motivo o i motivi di questa inidoneità sono forniti nel valore della chiave unready

  • "eliminazione" - Il cluster è in fase di eliminazione

  • "non gestito" - Il cluster si trova in uno stato "in esecuzione" o "non riuscito", non è gestito ed è idoneo alla gestione

  • "gestione" - Il cluster è in stato "in esecuzione" ed è in fase di gestione

  • "gestito" - Il cluster si trova nello stato "in esecuzione", "non riuscito" o "rimosso" ed è sotto gestione

managedStateDetails

vettore["type_astra_stateDetail"]

Falso

Array JSON di oggetti JSON che elenca dettagli aggiuntivi sullo stato corrente, incluso il motivo per cui è stato raggiunto tale stato. Se non sono disponibili dettagli, questo array sarà vuoto. I valori definiti sono:

  • Elementi minimi: 0

protectionState

stringa

Vero

Stringa JSON contenente un valore che indica lo stato di protezione del cluster. I valori definiti sono:

  • "full" - La classe di archiviazione predefinita del cluster supporta gli snapshot

  • "parziale" - Il cluster dispone solo di classi di archiviazione che non supportano gli snapshot

  • "atRisk" - La classe di archiviazione predefinita del cluster non supporta gli snapshot

protectionStateDetails

vettore["type_astra_stateDetail"]

Vero

Array JSON di oggetti JSON che elenca dettagli aggiuntivi sullo stato di protezione corrente, incluso il motivo per cui è stato raggiunto tale stato. Se non sono disponibili dettagli, questo array sarà vuoto. I valori definiti sono:

  • Elementi minimi: 0

managedStateUnready

array[string]

Vero

Array JSON di stringhe JSON, ognuna delle quali indica un motivo per cui il cluster non è idoneo alla gestione. I valori definiti sono:

  • Lunghezza minima: 1

  • Lunghezza massima: 127

managedTimestamp

stringa

Vero

Stringa JSON contenente il timestamp che indica quando il cluster è stato messo sotto gestione. I valori definiti sono:

  • Conforme allo schema di data e ora ISO-8601. Questa chiave viene restituita solo quando un cluster ha un managedState di "managed".

tridentVersion

stringa

Falso

Stringa JSON contenente la versione di Trident installata sul cluster. I valori definiti sono:

  • Conforme allo schema di versione del software

acpVersion

stringa

Falso

Stringa JSON contenente la versione di Astra Control Provisioner installata sul cluster. I valori definiti sono:

  • Conforme allo schema di versione del software

tridentManagedState

stringa

Falso

Stringa JSON contenente uno di un insieme di valori enumerati che indicano lo stato di gestione di Trident su questo cluster. I valori definiti sono:

  • "gestito" - L'istanza Trident sul cluster è gestita da Astra

  • "non gestito" - L'istanza Trident sul cluster non è gestita da Astra

tridentManagedStateDesired

stringa

Falso

Stringa JSON contenente un valore che indica lo stato di gestione desiderato per Trident. I valori definiti sono:

  • "gestito" - Gestisci Trident su questo cluster

  • "non gestito" - Non gestire Trident su questo cluster

tridentManagedStateDetails

vettore["type_astra_stateDetail"]

Falso

Array JSON di oggetti JSON che elenca ulteriori dettagli sul motivo per cui lo "stato" è passato a "gestito" o "non gestito". + Se non sono disponibili dettagli, questo array sarà vuoto.

  • Elementi minimi: 0

tridentManagedStateAllowed

array[string]

Falso

Stati che possono essere richiesti in un dato tridentManagedState. I seguenti stati possono essere richiesti in ciascuno stato definito:

  • "gestito": "gestito"

  • "unmanaged": "non gestito"

inUse

stringa

Vero

Stringa JSON contenente un valore che indica se il cluster ha applicazioni gestite e pertanto non può essere eliminato. I valori definiti sono:

  • "falso" - Il cluster non è gestito, oppure è gestito ma non ha applicazioni gestite associate ad esso

  • "vero" - Il cluster è gestito e ha applicazioni gestite associate con esso

accHost

stringa

Falso

Stringa JSON che indica che questo cluster ospita l'istanza di Astra Control Center a cui si sta attualmente accedendo. I valori definiti sono:

  • "true" - Questo cluster ospita l'istanza di Astra Control Center a cui si sta attualmente accedendo.

clusterType

stringa

Vero

Stringa JSON contenente un valore che indica il tipo di cluster. I valori definiti sono:

  • "gke" - Kubernetes ospitato su Google Kubernetes Engine

  • "aks" - Kubernetes ospitato su Microsoft Azure Kubernetes Service

  • "eks" - Kubernetes ospitato su Amazon Elastic Kubernetes Service

  • "rke" - Il cluster è di tipo Rancher

  • "tanzu" - Il cluster è di tipo Tanzu Kubernetes Grid

  • "openshift" - Il cluster è di tipo OpenShift

  • "anthos" - Il cluster è di tipo GKE Anthos

  • "kubernetes" - Il cluster è Kubernetes generico

clusterVersion

stringa

Vero

Stringa JSON contenente la rappresentazione della versione semantica dell'ambiente del cluster. Per i cluster Kubernetes, questa è la versione di Kubernetes. I valori definiti sono:

  • Lunghezza minima: 1

  • Lunghezza massima: 31

clusterVersionString

stringa

Vero

Stringa JSON contenente un valore che indica le informazioni di versione estese per l'ambiente del cluster. Per i cluster Kubernetes, questa è la versione completa di Kubernetes. I valori definiti sono:

  • Lunghezza minima: 1

  • Lunghezza massima: 31

clusterCreationTimestamp

stringa

Falso

Stringa JSON contenente il timestamp che indica quando il cluster è stato originariamente creato. I valori definiti sono:

  • Conforme allo schema di data e ora ISO-8601

spazi dei nomi

array[string]

Falso

Array JSON di stringhe JSON, ognuna delle quali indica uno spazio dei nomi all'interno del cluster. I valori definiti sono:

  • Lunghezza minima: 1

  • Lunghezza massima: 253

defaultStorageClass

stringa

Falso

Stringa JSON contenente un ID di classe di archiviazione corrispondente alla classe di archiviazione predefinita, come impostata in Kubernetes. I valori definiti sono:

  • Conforme allo schema di identificazione Astra. Se non incluso, non è stato ancora rilevato.

cloudID

stringa

Vero

Stringa JSON contenente un valore che indica l'ID del cloud su cui è in esecuzione il cluster. I valori definiti sono:

  • Conforme allo schema identificativo Astra

ID credenziale

stringa

Falso

Stringa JSON contenente un valore che indica l'ID della credenziale che contiene il file kubeconfig per il cluster. I valori definiti sono:

  • Conforme allo schema identificativo Astra

posizione

stringa

Falso

Stringa JSON contenente un valore fornito dal cloud su cui è in esecuzione il cluster, che indica la posizione specifica del cluster nel cloud. I valori definiti sono:

  • Lunghezza minima: 1

  • Lunghezza massima: 63

isMultizonal

stringa

Vero

Stringa JSON contenente un valore fornito dal cloud su cui è in esecuzione il cluster, che indica se il cluster si estende su due o più zone di disponibilità. I valori definiti sono:

  • "vero" - Il cluster si estende su due o più zone di disponibilità

  • "falso" - Il cluster è interamente situato all'interno di un'unica zona di disponibilità

privateRouteID

stringa

Falso

Stringa JSON contenente il locationID per i cluster privati.

  • Lunghezza minima: 1

  • Lunghezza massima: 255

apiServiceID

stringa

Falso

Stringa JSON contenente l'UUID dell'oggetto del servizio API di Kubernetes (k8s). Utilizzata per identificare in modo univoco un cluster.

defaultBucketID

stringa

Falso

Stringa JSON contenente l'ID di un bucket che verrà utilizzato di default per la persistenza dei metadati delle applicazioni per un cluster Neptune gestito. Se non viene specificato alcun bucket predefinito sul cluster, verrà utilizzato il bucket predefinito del cloud corrispondente.

metadati

"aggiornamento dei metadati di tipo Astra"

Vero

Metadati specificati dal client e dal servizio associati alla risorsa. I valori definiti sono:

  • Conforme allo schema dei metadati Astra. Se non specificato in fase di creazione, verrà creato un oggetto metadati senza etichette. Se non specificato in fase di aggiornamento, le etichette dell'oggetto metadati, creationTimestamp e createdBy, verranno conservate senza modifiche.
Risposta tipo 
{
  "type": "application/astra-managedCluster",
  "version": "1.7",
  "id": "241e9d94-eb8b-5c25-ba20-9292baac2396",
  "name": "GKE-22",
  "state": "running",
  "stateUnready": [],
  "managedState": "managed",
  "managedStateUnready": [],
  "managedTimestamp": "2020-08-06T12:24:52.256624Z",
  "protectionState": "full",
  "protectionStateDetails": [],
  "tridentVersion": "23.10.0",
  "acpVersion": "23.10.0",
  "tridentManagedState": "managed",
  "tridentManagedStateDesired": "managed",
  "tridentManagedStateDetails": [],
  "inUse": "false",
  "clusterType": "kubernetes",
  "clusterVersion": "1.91.1",
  "clusterVersionString": "1.19.1",
  "clusterCreationTimestamp": "2020-08-06T12:24:52.256624Z",
  "namespaces": [
    "kube-system",
    "kube-public",
    "my-app-1"
  ],
  "defaultStorageClass": "e280ff62-be35-4f31-a31b-a210a1ad1b33",
  "cloudID": "548bdc1f-f00e-4a23-a062-83265d224d46",
  "credentialID": "055e365a-2215-40de-aecb-a4070a7e6f1e",
  "location": "europe-west4",
  "isMultizonal": "false",
  "apiServiceID": "6bf33af2-872a-4553-a891-26b510c3edbe",
  "defaultBucketID": "a549b757-2be1-494f-aafa-4ee399ca3f00",
  "metadata": {
    "labels": [],
    "creationTimestamp": "2022-10-06T20:58:16.305662Z",
    "modificationTimestamp": "2022-10-06T20:58:16.305662Z",
    "createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
  }
}

Risposta

Status: 401, Unauthorized
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

stato

stringa

Vero

ID correlazione

stringa

Falso
Risposta tipo 
{
  "type": "https://astra.netapp.io/problems/3",
  "title": "Missing bearer token",
  "detail": "The request is missing the required bearer token.",
  "status": "401"
}

Risposta

Status: 400, Bad request
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

stato

stringa

Vero

ID correlazione

stringa

Falso
Risposta tipo 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

Risposta

Status: 409, Conflict
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

stato

stringa

Vero

ID correlazione

stringa

Falso

invalidFields

vettore["invalidFields"]

Falso

Elenco dei campi non validi del corpo della richiesta
Risposta tipo 
{
  "type": "https://astra.netapp.io/problems/10",
  "title": "JSON resource conflict",
  "detail": "The request body JSON contains a field that conflicts with an idempotent value.",
  "status": "409"
}

Risposta

Status: 403, Forbidden
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

stato

stringa

Vero

ID correlazione

stringa

Falso
Risposta tipo 
{
  "type": "https://astra.netapp.io/problems/11",
  "title": "Operation not permitted",
  "detail": "The requested operation isn't permitted.",
  "status": "403"
}

Errore

Status: 404, Not found
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

stato

stringa

Vero

ID correlazione

stringa

Falso
Esempio di risposta di errore 
{
  "type": "https://astra.netapp.io/problems/2",
  "title": "Collection not found",
  "detail": "The collection specified in the request URI wasn't found.",
  "status": "404"
}

Definizioni

Vedi definizioni

etichetta tipo_astra

Nome Tipo Obbligatorio Descrizione

nome

stringa

Vero

valore

stringa

Vero

aggiornamento dei metadati di tipo Astra

Metadati specificati dal client e dal servizio associati alla risorsa. I valori definiti sono:

  • Conforme allo schema dei metadati Astra. Se non specificato in fase di creazione, verrà creato un oggetto metadati senza etichette. Se non specificato in fase di aggiornamento, le etichette dell'oggetto metadati, creationTimestamp e createdBy, verranno conservate senza modifiche.

Nome Tipo Obbligatorio Descrizione

etichette

vettore["etichetta tipo_astra"]

Falso

CreationTimestamp

stringa

Falso

ModificationTimestamp

stringa

Falso

CreatedBy

stringa

Falso

modifiedBy

stringa

Falso

additionalDetails

type_astra_stateDetail

Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

additionalDetails

"additionalDetails"

Falso

invalidParams

Nome Tipo Obbligatorio Descrizione

nome

stringa

Vero

Nome del parametro di query non valido

motivo

stringa

Vero

Motivo per cui il parametro di query non è valido

invalidFields

Nome Tipo Obbligatorio Descrizione

nome

stringa

Vero

Nome del campo del corpo della richiesta non valido

motivo

stringa

Vero

Motivo per cui il campo del corpo della richiesta non è valido