Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Erstellen Sie einen neuen verwalteten Cluster

05/23/2026

PDFs

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

Gibt die gewünschten Werte für die zu erstellende Managed Cluster API-Ressource an.

Parameter

Name	Typ	In	Erforderlich	Beschreibung
Konto-ID	Zeichenkette	Pfad	Wahr	ID der übergeordneten Kontoressource Beispiel: {{.Account}}

Name

Typ

Erforderlich

Beschreibung

Konto-ID

Zeichenkette

Pfad

Wahr

ID der übergeordneten Kontoressource

Beispiel: {{.Account}}

Anfragetext

Gibt die gewünschten Werte für die zu erstellende Managed Cluster API-Ressource an.

Name	Typ	Erforderlich	Beschreibung
Typ	Zeichenkette	Wahr	Medientyp der Ressource. Definierte Werte sind: "application/astra-managedCluster"
Version	Zeichenkette	Wahr	Version der Ressource. Definierte Werte sind: "1,0" "1,1" "1,2" "1,3" "1,4" "1,5" "1,6" "1,7"
id	Zeichenkette	Wahr	Weltweit eindeutiger Bezeichner der Ressource. Definierte Werte sind: Entspricht dem UUIDv4-Schema
tridentManagedStateDesired	Zeichenkette	Falsch	JSON-Zeichenkette mit einem Wert, der den gewünschten Verwaltungsstatus für Trident angibt. Definierte Werte sind: "verwaltet" – Trident auf diesem Cluster verwalten „Nicht verwaltet“ – Trident auf diesem Cluster nicht verwalten
defaultStorageClass	Zeichenkette	Falsch	JSON-Zeichenkette mit einer Speicherklassen-ID, die der in Kubernetes festgelegten Standard-Speicherklasse entspricht. Folgende Werte sind definiert: Entspricht dem Astra-Identifikatorschema. Falls nicht enthalten, wurde es noch nicht entdeckt.
Standard-Bucket-ID	Zeichenkette	Falsch	JSON-Zeichenfolge mit der ID eines Buckets, der standardmäßig zum Speichern von Anwendungsmetadaten für einen verwalteten Neptune-Cluster verwendet wird. Wenn kein Standard-Bucket für den Cluster angegeben ist, wird der entsprechende Cloud-Standard-Bucket verwendet.
Metadaten	"type_astra_metadata_update"	Falsch	Client- und dienstspezifische Metadaten, die der Ressource zugeordnet sind. Definierte Werte sind: Entspricht dem Astra-Metadatenschema. Wird beim Erstellen kein Label angegeben, wird ein Metadatenobjekt ohne Labels erstellt. Wird beim Aktualisieren kein Label angegeben, bleiben die Labels, creationTimestamp und createdBy, des Metadatenobjekts unverändert erhalten.

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

Wahr

Medientyp der Ressource. Definierte Werte sind:

"application/astra-managedCluster"

Version

Zeichenkette

Wahr

Version der Ressource. Definierte Werte sind:

"1,0"
"1,1"
"1,2"
"1,3"
"1,4"
"1,5"
"1,6"
"1,7"

Zeichenkette

Wahr

Weltweit eindeutiger Bezeichner der Ressource. Definierte Werte sind:

Entspricht dem UUIDv4-Schema

tridentManagedStateDesired

Zeichenkette

Falsch

JSON-Zeichenkette mit einem Wert, der den gewünschten Verwaltungsstatus für Trident angibt. Definierte Werte sind:

"verwaltet" – Trident auf diesem Cluster verwalten
„Nicht verwaltet“ – Trident auf diesem Cluster nicht verwalten

defaultStorageClass

Zeichenkette

Falsch

JSON-Zeichenkette mit einer Speicherklassen-ID, die der in Kubernetes festgelegten Standard-Speicherklasse entspricht. Folgende Werte sind definiert:

Entspricht dem Astra-Identifikatorschema. Falls nicht enthalten, wurde es noch nicht entdeckt.

Standard-Bucket-ID

Zeichenkette

Falsch

JSON-Zeichenfolge mit der ID eines Buckets, der standardmäßig zum Speichern von Anwendungsmetadaten für einen verwalteten Neptune-Cluster verwendet wird. Wenn kein Standard-Bucket für den Cluster angegeben ist, wird der entsprechende Cloud-Standard-Bucket verwendet.

Metadaten

"type_astra_metadata_update"

Falsch

Client- und dienstspezifische Metadaten, die der Ressource zugeordnet sind. Definierte Werte sind:

Entspricht dem Astra-Metadatenschema. Wird beim Erstellen kein Label angegeben, wird ein Metadatenobjekt ohne Labels erstellt. Wird beim Aktualisieren kein Label angegeben, bleiben die Labels, creationTimestamp und createdBy, des Metadatenobjekts unverändert erhalten.

Beispielanfrage

{
  "type": "application/astra-managedCluster",
  "version": "1.7",
  "id": "241e9d94-eb8b-5c25-ba20-9292baac2396",
  "defaultStorageClass": "e280ff62-be35-4f31-a31b-a210a1ad1b33",
  "tridentManagedStateDesired": "managed"
}

Antwort

Status: 201, Returns the newly created managedCluster resource in the JSON response body.

Name	Typ	Erforderlich	Beschreibung
Typ	Zeichenkette	Wahr	Medientyp der Ressource. Definierte Werte sind: "application/astra-managedCluster"
Version	Zeichenkette	Wahr	Version der Ressource. Definierte Werte sind: "1,0" "1,1" "1,2" "1,3" "1,4" "1,5" "1,6" "1,7"
id	Zeichenkette	Wahr	Weltweit eindeutiger Bezeichner der Ressource. Definierte Werte sind: Entspricht dem UUIDv4-Schema
Name	Zeichenkette	Wahr	JSON-Zeichenkette mit einem Namen für den Cluster. Folgende Werte sind definiert: Mindestlänge: 1 Maximale Länge: 63 Diese Zeichenkette wird intern validiert, um XSS-, Unicode-, Directory-Traversal- und SQL-Injection-Angriffe zu verhindern.
Zustand	Zeichenkette	Wahr	JSON-Zeichenkette mit einem Wert, der den Betriebszustand des Clusters angibt. Folgende Werte sind definiert: „pending“ – Der Cluster ist zur Erkennung geplant. „discovering“ – Der Cluster befindet sich im Entdeckungsprozess „Bereitstellung“ – Der Cluster wird gerade bereitgestellt "läuft" - Der Cluster läuft normal „Fehlgeschlagen“ – Der Cluster befindet sich in einem permanenten Fehlerzustand „Entfernt“ – Der Cluster ist derzeit nicht erreichbar "unbekannt" – Der Zustand des Clusters kann nicht bestimmt werden
restoreTargetSupported	Zeichenkette	Falsch	JSON-Zeichenkette mit einem Wert, der die Fähigkeit des verwalteten Clusters angibt, ein Ziel für Anwendungsdatenverwaltungsoperationen zu sein. Definierte Werte sind: "true" – Cluster ist ein geeignetes Ziel für App-Datenverwaltungsoperationen. "false" - Cluster ist kein geeignetes Ziel für App-Datenverwaltungsoperationen.
snapshotSupported	Zeichenkette	Falsch	JSON-Zeichenkette mit einem Wert, der die Fähigkeit des verwalteten Clusters zur Durchführung von Backup-ähnlichen Operationen für die Anwendungsdatenverwaltung angibt. Definierte Werte sind: "true" – Cluster ist berechtigt, Anwendungsdatenverwaltungsoperationen durchzuführen. "false" - Cluster ist nicht berechtigt, App-Datenverwaltungsoperationen durchzuführen.
stateUnready	Array[string]	Wahr	JSON-Array mit JSON-Strings, die jeweils einen Grund dafür angeben, warum der Cluster nicht in den Status „running“ wechseln kann, wenn im Status „running“ Probleme auftreten oder warum er in den Status „failed“ oder „removed“ gewechselt ist. Definierte Werte sind: Mindestlänge: 1 Maximale Länge: 127
managedState	Zeichenkette	Wahr	JSON-Zeichenkette mit einem Wert, der den Verwaltungsstatus des Clusters angibt. Folgende Werte sind definiert: „pending“ – Der Cluster ist zur Entdeckung oder zum Hinzufügen geplant „Nicht berechtigt“ – Der Cluster befindet sich im Status „Wird ausgeführt“, wird nicht verwaltet und ist nicht für die Verwaltung berechtigt. Die Gründe für diese Nichtberechtigung sind im Wert des Schlüssels „unready“ angegeben. "Löschen" – Der Cluster wird gerade gelöscht „Nicht verwaltet“ – Der Cluster befindet sich im Status „Läuft“ oder „Fehlgeschlagen“, wird nicht verwaltet und ist für die Verwaltung geeignet. „managing“ – Der Cluster befindet sich im Status „running“ und wird gerade verwaltet. „Verwaltet“ – Der Cluster befindet sich im Status „Wird ausgeführt“, „Fehlgeschlagen“ oder „Entfernt“ und wird verwaltet
managedStateDetails	Array["type_astra_stateDetail"]	Falsch	Ein JSON-Array mit JSON-Objekten, das zusätzliche Details zum aktuellen Zustand auflistet, einschließlich der Gründe, warum der aktuelle Zustand erreicht wurde. Sind keine Details verfügbar, ist dieses Array leer. Definierte Werte sind: Mindestanzahl: 0
protectionState	Zeichenkette	Wahr	JSON-Zeichenkette mit einem Wert, der den Schutzstatus des Clusters angibt. Folgende Werte sind definiert: „vollständig“ – Die Standard-Speicherklasse des Clusters unterstützt Snapshots "partiell" – Der Cluster verfügt nur über Speicherklassen, die keine Snapshots unterstützen "atRisk" - Die Standard-Speicherklasse des Clusters unterstützt keine Snapshots
protectionStateDetails	Array["type_astra_stateDetail"]	Wahr	JSON-Array mit JSON-Objekten, das zusätzliche Details zum aktuellen Schutzstatus auflistet, einschließlich der Gründe für das Erreichen dieses Status. Sind keine Details verfügbar, ist dieses Array leer. Definierte Werte sind: Mindestanzahl: 0
managedStateUnready	Array[string]	Wahr	JSON-Array von JSON-Zeichenketten, die jeweils einen Grund dafür angeben, warum der Cluster nicht zur Verwaltung geeignet ist. Definierte Werte sind: Mindestlänge: 1 Maximale Länge: 127
managedTimestamp	Zeichenkette	Wahr	JSON-Zeichenkette mit dem Zeitstempel, der angibt, wann der Cluster unter Verwaltung gestellt wurde. Definierte Werte sind: Entspricht dem ISO-8601 Datums- und Zeitschema. Dieser Schlüssel wird nur zurückgegeben, wenn ein Cluster einen managedState von „managed“ hat.
tridentVersion	Zeichenkette	Falsch	JSON-Zeichenkette mit der auf dem Cluster installierten Trident-Version. Folgende Werte sind definiert: Entspricht dem Softwareversionsschema
acpVersion	Zeichenkette	Falsch	JSON-Zeichenkette mit der Version von Astra Control Provisioner, die auf dem Cluster installiert ist. Folgende Werte sind definiert: Entspricht dem Softwareversionsschema
tridentManagedState	Zeichenkette	Falsch	JSON-Zeichenkette, die einen von mehreren aufgezählten Werten enthält und den Verwaltungsstatus von Trident auf diesem Cluster angibt. Folgende Werte sind definiert: „Verwaltet“ – Trident Instanz im Cluster wird von Astra verwaltet „Nicht verwaltet“ – Trident Instanz im Cluster wird nicht von Astra verwaltet
tridentManagedStateDesired	Zeichenkette	Falsch	JSON-Zeichenkette mit einem Wert, der den gewünschten Verwaltungsstatus für Trident angibt. Definierte Werte sind: "verwaltet" – Trident auf diesem Cluster verwalten „Nicht verwaltet“ – Trident auf diesem Cluster nicht verwalten
tridentManagedStateDetails	Array["type_astra_stateDetail"]	Falsch	JSON-Array mit JSON-Objekten, das zusätzliche Details darüber auflistet, warum „state“ zu „managed“ oder „unmanaged“ gewechselt hat. + Falls keine Details verfügbar sind, ist dieses Array leer. Mindestanzahl: 0
tridentManagedStateAllowed	Array[string]	Falsch	Zustände, die in einem gegebenen tridentManagedState angefordert werden können. Die folgenden Zustände können in jedem definierten Zustand angefordert werden: "verwaltet": "verwaltet" "unmanaged": "unverwaltet"
inUse	Zeichenkette	Wahr	JSON-Zeichenkette mit einem Wert, der angibt, ob der Cluster verwaltete Anwendungen enthält und daher nicht gelöscht werden kann. Folgende Werte sind definiert: „falsch“ – Der Cluster wird nicht verwaltet, oder er wird zwar verwaltet, aber es sind keine verwalteten Anwendungen damit verknüpft „true“ – Der Cluster wird verwaltet und hat verwaltete Anwendungen, die ihm zugeordnet sind
accHost	Zeichenkette	Falsch	JSON-Zeichenkette, die angibt, dass dieser Cluster die Instanz von Astra Control Center hostet, auf die derzeit zugegriffen wird. Definierte Werte sind: "true" - Dieser Cluster hostet die Instanz des Astra Control Center, auf die aktuell zugegriffen wird.
clusterType	Zeichenkette	Wahr	JSON-Zeichenkette mit einem Wert, der den Clustertyp angibt. Folgende Werte sind definiert: "gke" - Kubernetes, gehostet auf der Google Kubernetes Engine "aks" - Kubernetes, gehostet auf Microsoft Azure Kubernetes Service "eks" - Kubernetes, gehostet auf Amazon Elastic Kubernetes Service "rke" – Der Cluster ist vom Typ Rancher "tanzu" - Der Cluster ist vom Typ Tanzu Kubernetes Grid "openshift" - Der Cluster ist vom Typ OpenShift "anthos" - Der Cluster ist vom Typ GKE Anthos "kubernetes" - Der Cluster ist ein generisches Kubernetes
clusterVersion	Zeichenkette	Wahr	JSON-Zeichenkette mit der semantischen Versionsdarstellung der Clusterumgebung. Bei Kubernetes-Clustern ist dies die Kubernetes-Version. Definierte Werte sind: Mindestlänge: 1 Maximale Länge: 31
clusterVersionString	Zeichenkette	Wahr	JSON-Zeichenkette mit einem Wert, der die erweiterten Versionsinformationen für die Clusterumgebung angibt. Bei Kubernetes-Clustern ist dies die vollständige Kubernetes-Version. Folgende Werte sind definiert: Mindestlänge: 1 Maximale Länge: 31
clusterCreationTimestamp	Zeichenkette	Falsch	JSON-Zeichenkette mit dem Zeitstempel, der angibt, wann der Cluster ursprünglich erstellt wurde. Folgende Werte sind definiert: Entspricht dem ISO-8601 Datums- und Zeitschema
Namensräume	Array[string]	Falsch	JSON-Array von JSON-Zeichenketten, die jeweils einen Namespace innerhalb des Clusters angeben. Definierte Werte sind: Mindestlänge: 1 Maximale Länge: 253
defaultStorageClass	Zeichenkette	Falsch	JSON-Zeichenkette mit einer Speicherklassen-ID, die der in Kubernetes festgelegten Standard-Speicherklasse entspricht. Folgende Werte sind definiert: Entspricht dem Astra-Identifikatorschema. Falls nicht enthalten, wurde es noch nicht entdeckt.
cloudID	Zeichenkette	Wahr	JSON-Zeichenkette mit einem Wert, der die ID der Cloud angibt, auf der der Cluster ausgeführt wird. Folgende Werte sind definiert: Entspricht dem Astra-Identifikatorschema
Anmeldeinformations-ID	Zeichenkette	Falsch	JSON-Zeichenkette mit einem Wert, der die ID der Anmeldeinformation angibt, die die kubeconfig-Datei für den Cluster enthält. Folgende Werte sind definiert: Entspricht dem Astra-Identifikatorschema
Standort	Zeichenkette	Falsch	JSON-Zeichenkette mit einem Wert, der von der Cloud bereitgestellt wird, auf der der Cluster ausgeführt wird und den cloudspezifischen Standort des Clusters angibt. Definierte Werte sind: Mindestlänge: 1 Maximale Länge: 63
isMultizonal	Zeichenkette	Wahr	JSON-Zeichenkette mit einem Wert, der von der Cloud bereitgestellt wird, auf der der Cluster ausgeführt wird und angibt, ob sich der Cluster über zwei oder mehr Verfügbarkeitszonen erstreckt. Definierte Werte sind: "wahr" - Der Cluster erstreckt sich über zwei oder mehr Verfügbarkeitszonen "falsch" - Der Cluster befindet sich vollständig innerhalb einer einzigen Verfügbarkeitszone
privateRouteID	Zeichenkette	Falsch	JSON-Zeichenkette mit der locationID für private Cluster. Mindestlänge: 1 Maximale Länge: 255
apiServiceID	Zeichenkette	Falsch	JSON-Zeichenkette mit der UUID des Kubernetes (k8s)-API-Dienstobjekts. Wird zur eindeutigen Identifizierung eines Clusters verwendet.
Standard-Bucket-ID	Zeichenkette	Falsch	JSON-Zeichenfolge mit der ID eines Buckets, der standardmäßig zum Speichern von Anwendungsmetadaten für einen verwalteten Neptune-Cluster verwendet wird. Wenn kein Standard-Bucket für den Cluster angegeben ist, wird der entsprechende Cloud-Standard-Bucket verwendet.
Metadaten	"type_astra_metadata_update"	Wahr	Client- und dienstspezifische Metadaten, die der Ressource zugeordnet sind. Definierte Werte sind: Entspricht dem Astra-Metadatenschema. Wird beim Erstellen kein Label angegeben, wird ein Metadatenobjekt ohne Labels erstellt. Wird beim Aktualisieren kein Label angegeben, bleiben die Labels, creationTimestamp und createdBy, des Metadatenobjekts unverändert erhalten.

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

Wahr

Medientyp der Ressource. Definierte Werte sind:

"application/astra-managedCluster"

Version

Zeichenkette

Wahr

Version der Ressource. Definierte Werte sind:

"1,0"
"1,1"
"1,2"
"1,3"
"1,4"
"1,5"
"1,6"
"1,7"

Zeichenkette

Wahr

Weltweit eindeutiger Bezeichner der Ressource. Definierte Werte sind:

Entspricht dem UUIDv4-Schema

Name

Zeichenkette

Wahr

JSON-Zeichenkette mit einem Namen für den Cluster. Folgende Werte sind definiert:

Mindestlänge: 1
Maximale Länge: 63
Diese Zeichenkette wird intern validiert, um XSS-, Unicode-, Directory-Traversal- und SQL-Injection-Angriffe zu verhindern.

Zustand

Zeichenkette

Wahr

JSON-Zeichenkette mit einem Wert, der den Betriebszustand des Clusters angibt. Folgende Werte sind definiert:

„pending“ – Der Cluster ist zur Erkennung geplant.
„discovering“ – Der Cluster befindet sich im Entdeckungsprozess
„Bereitstellung“ – Der Cluster wird gerade bereitgestellt
"läuft" - Der Cluster läuft normal
„Fehlgeschlagen“ – Der Cluster befindet sich in einem permanenten Fehlerzustand
„Entfernt“ – Der Cluster ist derzeit nicht erreichbar
"unbekannt" – Der Zustand des Clusters kann nicht bestimmt werden

restoreTargetSupported

Zeichenkette

Falsch

JSON-Zeichenkette mit einem Wert, der die Fähigkeit des verwalteten Clusters angibt, ein Ziel für Anwendungsdatenverwaltungsoperationen zu sein. Definierte Werte sind:

"true" – Cluster ist ein geeignetes Ziel für App-Datenverwaltungsoperationen.
"false" - Cluster ist kein geeignetes Ziel für App-Datenverwaltungsoperationen.

snapshotSupported

Zeichenkette

Falsch

JSON-Zeichenkette mit einem Wert, der die Fähigkeit des verwalteten Clusters zur Durchführung von Backup-ähnlichen Operationen für die Anwendungsdatenverwaltung angibt. Definierte Werte sind:

"true" – Cluster ist berechtigt, Anwendungsdatenverwaltungsoperationen durchzuführen.
"false" - Cluster ist nicht berechtigt, App-Datenverwaltungsoperationen durchzuführen.

stateUnready

Array[string]

Wahr

JSON-Array mit JSON-Strings, die jeweils einen Grund dafür angeben, warum der Cluster nicht in den Status „running“ wechseln kann, wenn im Status „running“ Probleme auftreten oder warum er in den Status „failed“ oder „removed“ gewechselt ist. Definierte Werte sind:

Mindestlänge: 1
Maximale Länge: 127

managedState

Zeichenkette

Wahr

JSON-Zeichenkette mit einem Wert, der den Verwaltungsstatus des Clusters angibt. Folgende Werte sind definiert:

„pending“ – Der Cluster ist zur Entdeckung oder zum Hinzufügen geplant
„Nicht berechtigt“ – Der Cluster befindet sich im Status „Wird ausgeführt“, wird nicht verwaltet und ist nicht für die Verwaltung berechtigt. Die Gründe für diese Nichtberechtigung sind im Wert des Schlüssels „unready“ angegeben.
"Löschen" – Der Cluster wird gerade gelöscht
„Nicht verwaltet“ – Der Cluster befindet sich im Status „Läuft“ oder „Fehlgeschlagen“, wird nicht verwaltet und ist für die Verwaltung geeignet.
„managing“ – Der Cluster befindet sich im Status „running“ und wird gerade verwaltet.
„Verwaltet“ – Der Cluster befindet sich im Status „Wird ausgeführt“, „Fehlgeschlagen“ oder „Entfernt“ und wird verwaltet

managedStateDetails

Array["type_astra_stateDetail"]

Falsch

Ein JSON-Array mit JSON-Objekten, das zusätzliche Details zum aktuellen Zustand auflistet, einschließlich der Gründe, warum der aktuelle Zustand erreicht wurde. Sind keine Details verfügbar, ist dieses Array leer. Definierte Werte sind:

Mindestanzahl: 0

protectionState

Zeichenkette

Wahr

JSON-Zeichenkette mit einem Wert, der den Schutzstatus des Clusters angibt. Folgende Werte sind definiert:

„vollständig“ – Die Standard-Speicherklasse des Clusters unterstützt Snapshots
"partiell" – Der Cluster verfügt nur über Speicherklassen, die keine Snapshots unterstützen
"atRisk" - Die Standard-Speicherklasse des Clusters unterstützt keine Snapshots

protectionStateDetails

Array["type_astra_stateDetail"]

Wahr

JSON-Array mit JSON-Objekten, das zusätzliche Details zum aktuellen Schutzstatus auflistet, einschließlich der Gründe für das Erreichen dieses Status. Sind keine Details verfügbar, ist dieses Array leer. Definierte Werte sind:

Mindestanzahl: 0

managedStateUnready

Array[string]

Wahr

JSON-Array von JSON-Zeichenketten, die jeweils einen Grund dafür angeben, warum der Cluster nicht zur Verwaltung geeignet ist. Definierte Werte sind:

Mindestlänge: 1
Maximale Länge: 127

managedTimestamp

Zeichenkette

Wahr

JSON-Zeichenkette mit dem Zeitstempel, der angibt, wann der Cluster unter Verwaltung gestellt wurde. Definierte Werte sind:

Entspricht dem ISO-8601 Datums- und Zeitschema. Dieser Schlüssel wird nur zurückgegeben, wenn ein Cluster einen managedState von „managed“ hat.

tridentVersion

Zeichenkette

Falsch

JSON-Zeichenkette mit der auf dem Cluster installierten Trident-Version. Folgende Werte sind definiert:

Entspricht dem Softwareversionsschema

acpVersion

Zeichenkette

Falsch

JSON-Zeichenkette mit der Version von Astra Control Provisioner, die auf dem Cluster installiert ist. Folgende Werte sind definiert:

Entspricht dem Softwareversionsschema

tridentManagedState

Zeichenkette

Falsch

JSON-Zeichenkette, die einen von mehreren aufgezählten Werten enthält und den Verwaltungsstatus von Trident auf diesem Cluster angibt. Folgende Werte sind definiert:

„Verwaltet“ – Trident Instanz im Cluster wird von Astra verwaltet
„Nicht verwaltet“ – Trident Instanz im Cluster wird nicht von Astra verwaltet

tridentManagedStateDesired

Zeichenkette

Falsch

JSON-Zeichenkette mit einem Wert, der den gewünschten Verwaltungsstatus für Trident angibt. Definierte Werte sind:

"verwaltet" – Trident auf diesem Cluster verwalten
„Nicht verwaltet“ – Trident auf diesem Cluster nicht verwalten

tridentManagedStateDetails

Array["type_astra_stateDetail"]

Falsch

JSON-Array mit JSON-Objekten, das zusätzliche Details darüber auflistet, warum „state“ zu „managed“ oder „unmanaged“ gewechselt hat. + Falls keine Details verfügbar sind, ist dieses Array leer.

Mindestanzahl: 0

tridentManagedStateAllowed

Array[string]

Falsch

Zustände, die in einem gegebenen tridentManagedState angefordert werden können. Die folgenden Zustände können in jedem definierten Zustand angefordert werden:

"verwaltet": "verwaltet"
"unmanaged": "unverwaltet"

inUse

Zeichenkette

Wahr

JSON-Zeichenkette mit einem Wert, der angibt, ob der Cluster verwaltete Anwendungen enthält und daher nicht gelöscht werden kann. Folgende Werte sind definiert:

„falsch“ – Der Cluster wird nicht verwaltet, oder er wird zwar verwaltet, aber es sind keine verwalteten Anwendungen damit verknüpft
„true“ – Der Cluster wird verwaltet und hat verwaltete Anwendungen, die ihm zugeordnet sind

accHost

Zeichenkette

Falsch

JSON-Zeichenkette, die angibt, dass dieser Cluster die Instanz von Astra Control Center hostet, auf die derzeit zugegriffen wird. Definierte Werte sind:

"true" - Dieser Cluster hostet die Instanz des Astra Control Center, auf die aktuell zugegriffen wird.

clusterType

Zeichenkette

Wahr

JSON-Zeichenkette mit einem Wert, der den Clustertyp angibt. Folgende Werte sind definiert:

"gke" - Kubernetes, gehostet auf der Google Kubernetes Engine
"aks" - Kubernetes, gehostet auf Microsoft Azure Kubernetes Service
"eks" - Kubernetes, gehostet auf Amazon Elastic Kubernetes Service
"rke" – Der Cluster ist vom Typ Rancher
"tanzu" - Der Cluster ist vom Typ Tanzu Kubernetes Grid
"openshift" - Der Cluster ist vom Typ OpenShift
"anthos" - Der Cluster ist vom Typ GKE Anthos
"kubernetes" - Der Cluster ist ein generisches Kubernetes

clusterVersion

Zeichenkette

Wahr

JSON-Zeichenkette mit der semantischen Versionsdarstellung der Clusterumgebung. Bei Kubernetes-Clustern ist dies die Kubernetes-Version. Definierte Werte sind:

Mindestlänge: 1
Maximale Länge: 31

clusterVersionString

Zeichenkette

Wahr

JSON-Zeichenkette mit einem Wert, der die erweiterten Versionsinformationen für die Clusterumgebung angibt. Bei Kubernetes-Clustern ist dies die vollständige Kubernetes-Version. Folgende Werte sind definiert:

Mindestlänge: 1
Maximale Länge: 31

clusterCreationTimestamp

Zeichenkette

Falsch

JSON-Zeichenkette mit dem Zeitstempel, der angibt, wann der Cluster ursprünglich erstellt wurde. Folgende Werte sind definiert:

Entspricht dem ISO-8601 Datums- und Zeitschema

Namensräume

Array[string]

Falsch

JSON-Array von JSON-Zeichenketten, die jeweils einen Namespace innerhalb des Clusters angeben. Definierte Werte sind:

Mindestlänge: 1
Maximale Länge: 253

defaultStorageClass

Zeichenkette

Falsch

JSON-Zeichenkette mit einer Speicherklassen-ID, die der in Kubernetes festgelegten Standard-Speicherklasse entspricht. Folgende Werte sind definiert:

Entspricht dem Astra-Identifikatorschema. Falls nicht enthalten, wurde es noch nicht entdeckt.

cloudID

Zeichenkette

Wahr

JSON-Zeichenkette mit einem Wert, der die ID der Cloud angibt, auf der der Cluster ausgeführt wird. Folgende Werte sind definiert:

Entspricht dem Astra-Identifikatorschema

Anmeldeinformations-ID

Zeichenkette

Falsch

JSON-Zeichenkette mit einem Wert, der die ID der Anmeldeinformation angibt, die die kubeconfig-Datei für den Cluster enthält. Folgende Werte sind definiert:

Entspricht dem Astra-Identifikatorschema

Standort

Zeichenkette

Falsch

JSON-Zeichenkette mit einem Wert, der von der Cloud bereitgestellt wird, auf der der Cluster ausgeführt wird und den cloudspezifischen Standort des Clusters angibt. Definierte Werte sind:

Mindestlänge: 1
Maximale Länge: 63

isMultizonal

Zeichenkette

Wahr

JSON-Zeichenkette mit einem Wert, der von der Cloud bereitgestellt wird, auf der der Cluster ausgeführt wird und angibt, ob sich der Cluster über zwei oder mehr Verfügbarkeitszonen erstreckt. Definierte Werte sind:

"wahr" - Der Cluster erstreckt sich über zwei oder mehr Verfügbarkeitszonen
"falsch" - Der Cluster befindet sich vollständig innerhalb einer einzigen Verfügbarkeitszone

privateRouteID

Zeichenkette

Falsch

JSON-Zeichenkette mit der locationID für private Cluster.

Mindestlänge: 1
Maximale Länge: 255

apiServiceID

Zeichenkette

Falsch

JSON-Zeichenkette mit der UUID des Kubernetes (k8s)-API-Dienstobjekts. Wird zur eindeutigen Identifizierung eines Clusters verwendet.

Standard-Bucket-ID

Zeichenkette

Falsch

Metadaten

"type_astra_metadata_update"

Wahr

Client- und dienstspezifische Metadaten, die der Ressource zugeordnet sind. Definierte Werte sind:

Entspricht dem Astra-Metadatenschema. Wird beim Erstellen kein Label angegeben, wird ein Metadatenobjekt ohne Labels erstellt. Wird beim Aktualisieren kein Label angegeben, bleiben die Labels, creationTimestamp und createdBy, des Metadatenobjekts unverändert erhalten.

Beispielantwort

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

Antwort

Status: 401, Unauthorized

Name	Typ	Erforderlich
Typ	Zeichenkette	Wahr
Titel	Zeichenkette	Wahr
Detail	Zeichenkette	Wahr
Status	Zeichenkette	Wahr
Korrelations-ID	Zeichenkette	Falsch

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

Wahr

Titel

Zeichenkette

Wahr

Detail

Zeichenkette

Wahr

Status

Zeichenkette

Wahr

Korrelations-ID

Zeichenkette

Falsch

Beispielantwort

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

Antwort

Status: 400, Bad request

Name	Typ	Erforderlich
Typ	Zeichenkette	Wahr
Titel	Zeichenkette	Wahr
Detail	Zeichenkette	Wahr
Status	Zeichenkette	Wahr
Korrelations-ID	Zeichenkette	Falsch

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

Wahr

Titel

Zeichenkette

Wahr

Detail

Zeichenkette

Wahr

Status

Zeichenkette

Wahr

Korrelations-ID

Zeichenkette

Falsch

Beispielantwort

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

Antwort

Status: 409, Conflict

Name	Typ	Erforderlich	Beschreibung
Typ	Zeichenkette	Wahr
Titel	Zeichenkette	Wahr
Detail	Zeichenkette	Wahr
Status	Zeichenkette	Wahr
Korrelations-ID	Zeichenkette	Falsch
invalidFields	Array["invalidFields"]	Falsch	Liste ungültiger Anfragetextfelder

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

Wahr

Titel

Zeichenkette

Wahr

Detail

Zeichenkette

Wahr

Status

Zeichenkette

Wahr

Korrelations-ID

Zeichenkette

Falsch

invalidFields

Array["invalidFields"]

Falsch

Liste ungültiger Anfragetextfelder

Beispielantwort

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

Antwort

Status: 403, Forbidden

Name	Typ	Erforderlich
Typ	Zeichenkette	Wahr
Titel	Zeichenkette	Wahr
Detail	Zeichenkette	Wahr
Status	Zeichenkette	Wahr
Korrelations-ID	Zeichenkette	Falsch

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

Wahr

Titel

Zeichenkette

Wahr

Detail

Zeichenkette

Wahr

Status

Zeichenkette

Wahr

Korrelations-ID

Zeichenkette

Falsch

Beispielantwort

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

Fehler

Status: 404, Not found

Name	Typ	Erforderlich
Typ	Zeichenkette	Wahr
Titel	Zeichenkette	Wahr
Detail	Zeichenkette	Wahr
Status	Zeichenkette	Wahr
Korrelations-ID	Zeichenkette	Falsch

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

Wahr

Titel

Zeichenkette

Wahr

Detail

Zeichenkette

Wahr

Status

Zeichenkette

Wahr

Korrelations-ID

Zeichenkette

Falsch

Beispiel-Fehlermeldung

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

Definitionen

Siehe Definitionen

Typ_Astra_Label

Name	Typ	Erforderlich	Beschreibung
Name	Zeichenkette	Wahr
Wert	Zeichenkette	Wahr

Name

Typ

Erforderlich

Beschreibung

Name

Zeichenkette

Wahr

Wert

Zeichenkette

Wahr

type_astra_metadata_update

Client- und dienstspezifische Metadaten, die der Ressource zugeordnet sind. Definierte Werte sind:

Entspricht dem Astra-Metadatenschema. Wird beim Erstellen kein Label angegeben, wird ein Metadatenobjekt ohne Labels erstellt. Wird beim Aktualisieren kein Label angegeben, bleiben die Labels, creationTimestamp und createdBy, des Metadatenobjekts unverändert erhalten.

Name	Typ	Erforderlich
Etiketten	Array["Typ_Astra_Label"]	Falsch
CreationZeitstempel	Zeichenkette	Falsch
Änderungszeitstempel	Zeichenkette	Falsch
Erstellt von	Zeichenkette	Falsch
modifiedBy	Zeichenkette	Falsch

Name

Typ

Erforderlich

Beschreibung

Etiketten

Array["Typ_Astra_Label"]

Falsch

CreationZeitstempel

Zeichenkette

Falsch

Änderungszeitstempel

Zeichenkette

Falsch

Erstellt von

Zeichenkette

Falsch

modifiedBy

Zeichenkette

Falsch

additionalDetails

type_astra_stateDetail

Name	Typ	Erforderlich
Typ	Zeichenkette	Wahr
Titel	Zeichenkette	Wahr
Detail	Zeichenkette	Wahr
additionalDetails	"additionalDetails"	Falsch

Name

Typ

Erforderlich

Beschreibung

Typ

Zeichenkette

Wahr

Titel

Zeichenkette

Wahr

Detail

Zeichenkette

Wahr

additionalDetails

"additionalDetails"

Falsch

invalidParams

Name	Typ	Erforderlich	Beschreibung
Name	Zeichenkette	Wahr	Name des ungültigen Abfrageparameters
Grund	Zeichenkette	Wahr	Grund, warum der Abfrageparameter ungültig ist

Name

Typ

Erforderlich

Beschreibung

Name

Zeichenkette

Wahr

Name des ungültigen Abfrageparameters

Grund

Zeichenkette

Wahr

Grund, warum der Abfrageparameter ungültig ist

invalidFields

Name	Typ	Erforderlich	Beschreibung
Name	Zeichenkette	Wahr	Name des ungültigen Anfragetextfelds
Grund	Zeichenkette	Wahr	Grund, warum das Anfragekörperfeld ungültig ist

Name

Typ

Erforderlich

Beschreibung

Name

Zeichenkette

Wahr

Name des ungültigen Anfragetextfelds

Grund

Zeichenkette

Wahr

Grund, warum das Anfragekörperfeld ungültig ist

Erstellen Sie einen neuen verwalteten Cluster

Creating your file...

Parameter

Anfragetext

Antwort

Antwort

Antwort

Antwort

Antwort

Fehler

Definitionen