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.

Recupera un cluster

PDF

GET /accounts/{account_id}/topology/v1/clusters/{cluster_id}

Restituisce la risorsa Cluster API memorizzata nel corpo della risposta JSON.

Parametri

Nome Tipo In Obbligatorio Descrizione

ID account

stringa

percorso

Vero

ID della risorsa account contenitore

  • esempio: {{.Account}}

cluster_id

stringa

percorso

Vero

ID della raccolta cluster da elencare

Risposta

Status: 200, Returns the stored Cluster API resource in the JSON response body.
Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

Tipo di media della risorsa. I valori definiti sono:

  • "application/astra-cluster"

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. Se non specificato, verrà utilizzato il nome Kubernetes del 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

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 è nello stato "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. I motivi di questa non idoneità sono forniti nel valore chiave unready

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

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

  • "gestione" - Il cluster è nello 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 ha solo storageClasses 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

restoreTargetSupported

stringa

Falso

Stringa JSON contenente un valore che indica la capacità del cluster 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 di eseguire operazioni simili al backup per la gestione dei dati delle applicazioni. 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.

managedStateUnready

array[string]

Vero

Array JSON di stringhe JSON, ognuna delle quali indica un motivo per cui il cluster non è idoneo a essere gestito, oppure che il cluster è gestito ma si sono verificati errori non critici durante la gestione del cluster. Valori definiti sono:

  • Lunghezza minima: 1

  • Lunghezza massima: 127

managedTimestamp

stringa

Falso

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

Falso

Stringa JSON contenente un valore che indica 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

Falso

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 impostata in Kubernetes. I valori definiti sono:

  • Conforme allo schema identificativo Astra

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 di identificazione Astra. Se vengono forniti privateRouteID e connectorCapabilities con l'opzione connectorV2, credentialID è facoltativo. Se non vengono forniti, credentialID è obbligatorio, altrimenti viene generato un errore. Se vengono forniti credentialID e un connettore con capacità di relay, viene generato un errore.

posizione

stringa

Falso

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

  • Lunghezza minima: 1

  • Lunghezza massima: 63

isMultizonal

stringa

Falso

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 l'ID della posizione per i cluster privati.

  • Lunghezza minima: 1

  • Lunghezza massima: 255

connectorCapabilities

array[string]

Falso

Funzionalità del connettore associato a questo cluster. Opzionale per la compatibilità con le versioni precedenti. Se non presente, proxy è la funzionalità presunta.

apiServiceID

stringa

Falso

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

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-cluster",
  "version": "1.7",
  "id": "dd95ce34-55ce-5f74-bb49-2f734fe5da30",
  "name": "GKE-22",
  "state": "running",
  "stateUnready": [],
  "managedState": "unmanaged",
  "managedStateUnready": [],
  "protectionState": "full",
  "protectionStateDetails": [],
  "tridentVersion": "23.10.0",
  "acpVersion": "23.10.0",
  "tridentManagedState": "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": "31c95aba-99d9-4987-b1bb-000dfce5952c",
  "cloudID": "548bdc1f-f00e-4a23-a062-83265d224d46",
  "credentialID": "6fa2f917-f730-41b8-9c15-17f531843b31",
  "location": "europe-west4",
  "isMultizonal": "false",
  "apiServiceID": "6bf33af2-872a-4553-a891-26b510c3edbe",
  "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

invalidParams

vettore["invalidParams"]

Falso

Elenco dei parametri di query non validi
Risposta tipo 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

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"
}

Risposta

Status: 500, Internal server error
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/65",
  "title": "Cluster GET not performed",
  "detail": "The cluster GET call didn't perform the lookup operation on the cluster.",
  "status": "500"
}

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

additionalDetails

type_astra_stateDetail

Nome Tipo Obbligatorio Descrizione

tipo

stringa

Vero

titolo

stringa

Vero

dettaglio

stringa

Vero

additionalDetails

"additionalDetails"

Falso

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

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