Skip to main content
Astra Automation
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Elenca tutti i cluster gestiti

PDF

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

Restituisce un array JSON di tutte le risorse corrispondenti nella raccolta. Se nella richiesta vengono specificati singoli campi, l'array JSON degli elementi conterrà i campi richiesti per ciascuna risorsa corrispondente nell'ordine specificato.

Parametri

Nome Tipo In Obbligatorio Descrizione

ID account

stringa

percorso

Vero

ID della risorsa account contenitore

  • esempio: {{.Account}}

includi

stringa

query

Falso

Indica quali campi devono essere restituiti durante l'elenco di una raccolta.

Esempi di URL: "include=id", "include=id,name"

Esempi OpenAPI: "id"

  • esempio: id,nome,managedState

limite

stringa

query

Falso

Indica il numero massimo di risorse da restituire quando si elenca una raccolta.

Esempi di URL: "limit=2"

Esempi OpenAPI: "2"

filtro

stringa

query

Falso

Indica quali campi devono essere confrontati per restituire una risorsa durante l'elenco di una collezione.

Gli operatori supportati sono:

  • eq - Uguaglianza

  • lt/gt - Minore di/Maggiore di

  • lte/gte - Minore o uguale a/Maggiore o uguale a

Esempio di URL: "filter=field%20eq%20%27value%27"

Esempi OpenAPI: "field eq 'value'"

Risposta

Status: 200, Returns a JSON array of all matching resources in the collection. If individual fields are specified in the request, the items JSON array will contain the fields requested for each matching resource in the order specified.
Nome Tipo Obbligatorio Descrizione

elementi

array[Qualsiasi tra: "managedCluster_1.2_get_response_body", array[]]

Vero

metadati

"elenco_metadati_tipo_astra"

Vero
Risposta tipo 
{
  "type": "application/astra-managedClusters",
  "version": "1.2",
  "items": [
    [
      "0f284377-e5dc-4dcd-bacd-3197f2b8a347",
      "GKE-21",
      "managed"
    ],
    [
      "04dc80fa-d1d8-4850-a49f-3b70d0ec1369",
      "GKE-22",
      "unmanaged"
    ]
  ],
  "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"
}

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 di 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

managedCluster_1.2_get_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"

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

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

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

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

  • "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.

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 di 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.

elenco_metadati_tipo_astra

Nome Tipo Obbligatorio Descrizione

continuare

stringa

Falso

conta

numero

Falso

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