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

Alle Apps auflisten

Änderungen vorschlagen
PDFs

GET /accounts/{account_id}/k8s/v2/apps

Gibt ein JSON-Array aller übereinstimmenden Ressourcen in der Sammlung zurück. Wenn in der Anfrage einzelne Felder angegeben werden, enthält das JSON-Array der Elemente die angeforderten Felder für jede übereinstimmende Ressource in der angegebenen Reihenfolge.

Parameter

Name Typ In Erforderlich Beschreibung

Konto-ID

Zeichenkette

Pfad

Wahr

ID der übergeordneten Kontoressource

  • Beispiel: {{.Account}}

Einschließlich

Zeichenkette

Abfrage

Falsch

Gibt an, welche Felder beim Auflisten einer Sammlung zurückgegeben werden sollen.

URL-Beispiele: "include=id", "include=id,name"

OpenAPI-Beispiele: "id"

  • Beispiel: id,name,state

Grenze

Zeichenkette

Abfrage

Falsch

Gibt die maximale Anzahl der Ressourcen an, die beim Auflisten einer Sammlung zurückgegeben werden sollen.

URL-Beispiele: "limit=2"

OpenAPI-Beispiele: "2"

Filtern

Zeichenkette

Abfrage

Falsch

Gibt an, welche Felder übereinstimmen müssen, um beim Auflisten einer Sammlung eine Ressource zurückzugeben.

Unterstützte Operatoren sind:

  • eq – Gleichheit

  • lt/gt – Kleiner als/Größer als

  • lte/gte – Kleiner oder gleich/Größer oder gleich

URL-Beispiel: "filter=field%20eq%20%27value%27"

OpenAPI-Beispiele: "field eq 'value'"

Antwort

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.
Name Typ Erforderlich Beschreibung

Elemente

array[Beliebig aus: "app_2.2_get_response_body", array[]]

Wahr

Metadaten

"type_astra_metadata_list"

Wahr
Beispielantwort 
{
  "type": "application/astra-apps",
  "version": "2.2",
  "items": [
    [
      "2ff50f4b-fe40-4980-913f-8a4469184822",
      "mysql",
      "ready"
    ],
    [
      "ae1e6561-9e22-406c-8a5a-762f4604da00",
      "jenkins",
      "ready"
    ]
  ],
  "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 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 Beschreibung

Typ

Zeichenkette

Wahr

Titel

Zeichenkette

Wahr

Detail

Zeichenkette

Wahr

Status

Zeichenkette

Wahr

Korrelations-ID

Zeichenkette

Falsch

invalidParams

Array["invalidParams"]

Falsch

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

Antwort

Status: 403, Forbidden
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 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

targetSchema

accept-post

accept-put

Hinweise

Name Typ Erforderlich Beschreibung

Status

Zeichenkette

Falsch

erlauben

Array[string]

Falsch

accept-post

"accept-post"

Falsch

Berechtigungen

Array[string]

Falsch

accept-put

"accept-put"

Falsch

type_astra_link

Name Typ Erforderlich Beschreibung

rel

Zeichenkette

Wahr

href

Zeichenkette

Wahr

Typ

Zeichenkette

Falsch

targetSchema

"targetSchema"

Falsch

Titel

Zeichenkette

Falsch

Hinweise

"Hinweise"

Falsch

GVK

JSON-Objekt, das eine Kubernetes-Gruppe/Version/Kind enthält.

  • Dieses Objekt wird intern gegen Astra/apiResources validiert.

Name Typ Erforderlich Beschreibung

Gruppe

Zeichenkette

Wahr

JSON-Zeichenkette mit einer von Kubernetes zugewiesenen Gruppenkennung.

  • Diese Zeichenkette wird intern gegen Astra/apiResources validiert

Art

Zeichenkette

Wahr

JSON-Zeichenkette, die einen von Kubernetes zugewiesenen Kindbezeichner enthält.

  • Diese Zeichenkette wird intern gegen Astra/apiResources validiert

Version

Zeichenkette

Wahr

JSON-Zeichenkette mit einer von Kubernetes zugewiesenen Versionskennung.

  • Diese Zeichenkette wird intern gegen Astra/apiResources validiert

clusterScopedResources

Name Typ Erforderlich Beschreibung

GVK

"GVK"

Wahr

JSON-Objekt, das eine Kubernetes-Gruppe/Version/Kind enthält.

  • Dieses Objekt wird intern gegen Astra/apiResources validiert.

labelSelectors

Array[string]

Falsch

JSON-Array von JSON-Strings, das einen Label-Selektor für die clusterweiten GroupVersionKinds (GVKs) innerhalb des Clusters darstellt. Wenn dieses leer ist, werden alle GVK-Instanzen im Cluster einbezogen. Jedes Element in diesem Array ist ein Kubernetes-Label-Selektor-String und folgt derselben Grammatik für diese Werte. Beispiele:

namespaceScopedResources

Name Typ Erforderlich Beschreibung

Namensraum

Zeichenkette

Wahr

JSON-Zeichenkette mit dem Namen eines Namespace, in dem die Anwendung definiert ist. Definierte Werte sind:

  • Mindestlänge: 1

  • Maximale Länge: 253

  • Entspricht dem DNS 1123 Label Schema

labelSelectors

Array[string]

Wahr

JSON-Array von JSON-Strings, das einen Label-Selektor innerhalb des Namespace darstellt. Ist das Array leer, werden alle Ressourcen im Namespace eingeschlossen. Jedes Element in diesem Array ist ein Kubernetes-Label-Selektor-String und folgt der Grammatik für diese Werte. Beispiele:

  • [ "app=mysql" ] — Wählen Sie alle Ressourcen aus, die ein Label mit dem Namen app und dem Wert mysql haben

  • [ "app != mysql" ] — Wählt alle Ressourcen aus, deren Label den Namen „app“ hat und deren Wert nicht „mysql“ ist

  • [ "app in (mysql, mariadb)" ] — Wählt alle Ressourcen aus, deren Label „app“ heißt und deren Wert „mysql“ oder „mariadb“ ist.

  • [ "app notin (nginx, wordpress)" ] — Wählt alle Ressourcen aus, die kein Label mit dem Namen app und den Werten nginx oder wordpress haben.

  • [ "app" ] — Wählen Sie alle Ressourcen aus, die ein Label mit dem Namen app haben

  • [ "!app" ] — Wählt alle Ressourcen aus, die keine Bezeichnung namens „app“ haben. Beachten Sie, dass mehrere Auswahloperatoren durch Kommas getrennt in einem einzigen Selektor angegeben werden können. In diesem Fall werden die Ergebnisse der einzelnen Auswahloperatoren mit UND verknüpft:

  • [ "app=mysql,version=2" ] — Wählt alle Ressourcen aus, die ein Label mit dem Namen „app“ und dem Wert „mysql“ sowie ein Label mit dem Namen „version“ und dem Wert „2“ besitzen

type_astra_stateTransition

Name Typ Erforderlich Beschreibung

aus

Zeichenkette

Wahr

:

Array[string]

Wahr

additionalDetails

type_astra_stateDetail

Name Typ Erforderlich Beschreibung

Typ

Zeichenkette

Wahr

Titel

Zeichenkette

Wahr

Detail

Zeichenkette

Wahr

additionalDetails

"additionalDetails"

Falsch

namespaceMapping

Name Typ Erforderlich Beschreibung

Quelle

Zeichenkette

Wahr

JSON-Zeichenkette mit dem Namen des Namespace im Quell-Cluster. Folgende Werte sind definiert:

  • Mindestlänge: 1

  • Maximale Länge: 253

  • Entspricht dem DNS 1123 Label Schema

Ziel

Zeichenkette

Wahr

JSON-Zeichenkette mit dem Namen des Namespace im Ziel-Cluster. Folgende Werte sind definiert:

  • Mindestlänge: 1

  • Maximale Länge: 253

  • Entspricht dem DNS 1123 Label Schema

storageClassMapping

Name Typ Erforderlich Beschreibung

Quelle

Zeichenkette

Wahr

JSON-Zeichenkette mit dem Namen der Quellspeicherklasse. Kann auch '*' enthalten, um alle Quellspeicherklassen anzugeben. Definierte Werte sind:

  • Mindestlänge: 1

  • Maximale Länge: 63

  • Entspricht dem DNS 1123 Label Schema, wenn ein Speicherklassenname verwendet wird

  • '*' zur Angabe aller Speicherklassen

Ziel

Zeichenkette

Wahr

JSON-Zeichenkette mit dem Namen der Zielspeicherklasse. Folgende Werte sind definiert:

  • Mindestlänge: 1

  • Maximale Länge: 63

  • Entspricht dem DNS 1123 Label Schema

GVKN

Name Typ Erforderlich Beschreibung

Gruppe

Zeichenkette

Falsch

JSON-Zeichenkette mit einer von Kubernetes zugewiesenen Gruppenkennung.

  • Diese Zeichenkette wird intern gegen Astra/apiResources validiert

Version

Zeichenkette

Falsch

JSON-Zeichenkette mit einer von Kubernetes zugewiesenen Versionskennung.

  • Diese Zeichenkette wird intern gegen Astra/apiResources validiert

Art

Zeichenkette

Falsch

JSON-Zeichenkette, die einen von Kubernetes zugewiesenen Kindbezeichner enthält.

  • Diese Zeichenkette wird intern gegen Astra/apiResources validiert

Namensräume

Array[string]

Falsch

JSON-Array von JSON-Zeichenketten, die die Namensräume beschreiben, aus denen Ressourcen ein- oder ausgeschlossen werden sollen. Definierte Werte sind:

  • Mindestlänge: 1

  • Maximale Länge: 63

  • Entspricht dem DNS 1123 Label Schema

Namen

Array[string]

Falsch

JSON-Array mit JSON-Zeichenketten, die die Namen der Kubernetes-Ressourcen beschreiben, die in die selektive Wiederherstellung einbezogen oder ausgeschlossen werden sollen. Definierte Werte sind:

  • Mindestlänge: 1

  • Maximale Länge: 253

  • Entspricht dem DNS 1123 Label Schema

labelSelectors

Array[string]

Falsch

JSON-Array mit JSON-Strings, die Kubernetes-Label-Selektoren beschreiben, welche zum Ein- oder Ausschließen von Ressourcen bei der selektiven Wiederherstellung verwendet werden. Jedes Element in diesem Array ist ein Kubernetes-Label-Selektor-String und folgt derselben Grammatik für diese Werte. Beispiele:

restoreFilter

JSON-Objekt mit einer Liste von Filtern, die beschreiben, welche Ressourcen in eine selektive Wiederherstellung einbezogen oder ausgeschlossen werden. Include und Exclude schließen sich gegenseitig aus, und eine selektive Wiederherstellung kann nur einen Filtertyp verwenden.

Name Typ Erforderlich Beschreibung

resourceSelectionCriteria

Zeichenkette

Falsch

JSON-Zeichenkette mit einem Wert, der angibt, wie Ressourcenfilter Ressourcen auswählen. Gültige Werte sind include oder exclude.

GVKN

Array["GVKN"]

Falsch

Ein JSON-Array von JSON-Objekten beschreibt Ressourcen, die bei einer selektiven Wiederherstellung gefiltert werden sollen. Eine Ressource entspricht einem einzelnen GVKN-Filterelement, wenn alle angegebenen Filterfelder mit dem entsprechenden Ressourcenfeld übereinstimmen. Filterfelder, die Arrays sind (z. B. Namespaces und Namen), entsprechen einem Feld, wenn mindestens eines ihrer Elemente mit dem entsprechenden Ressourcenfeld übereinstimmt. Das Feld labelSelectors erfordert, dass alle Selektoren übereinstimmen. Eine Ressource, die einem Filter im Array von GVKN-Filterobjekten entspricht, wird je nach resourceSelectionCriteria-Wert in die Wiederherstellung einbezogen oder ausgeschlossen. Leere GVKN-Objekte führen zu einem Validierungsfehler.

Typ_Astra_Label

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 Beschreibung

Etiketten

Array["Typ_Astra_Label"]

Falsch

CreationZeitstempel

Zeichenkette

Falsch

Änderungszeitstempel

Zeichenkette

Falsch

Erstellt von

Zeichenkette

Falsch

modifiedBy

Zeichenkette

Falsch

app_2.2_get_response_body

Name Typ Erforderlich Beschreibung

Typ

Zeichenkette

Wahr

Medientyp der Ressource. Definierte Werte sind:

  • "application/astra-app"

Version

Zeichenkette

Wahr

Version der Ressource. Definierte Werte sind:

  • "2,0"

  • "2,1"

  • "2,2"

id

Zeichenkette

Wahr

Weltweit eindeutiger Bezeichner der Ressource. Definierte Werte sind:

  • Entspricht dem UUIDv4-Schema

Links

Array["type_astra_link"]

Wahr

Links mit Beschreibungen der unterstützten Operationen für die Ressource.

Name

Zeichenkette

Wahr

JSON-Zeichenkette mit einem Namen für die Anwendung. 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.

  • Entspricht dem DNS 1123 Label Schema

clusterScopedResources

Array["clusterScopedResources"]

Falsch

JSON-Array von JSON-Objekten, die die clusterweiten Ressourcen beschreiben, die Teil dieser App sind

namespaceScopedResources

Array["namespaceScopedResources"]

Wahr

JSON-Array von JSON-Objekten, die die Ressourcen beschreiben, die Teil dieser App sind

lastResourceCollectionTimestamp

Zeichenkette

Falsch

JSON-Zeichenfolge mit dem Zeitstempel der letzten Ressourcenerfassung. Dieses Feld ist leer, wenn für diese Anwendung noch keine Ressourcenerfassung durchgeführt wurde. Folgende Werte sind definiert:

  • Entspricht dem ISO-8601 Datums- und Zeitschema

Zustand

Zeichenkette

Wahr

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

  • „pending“ – Die Applikation ist zur Erkennung vorgesehen

  • „discovering“ – Die Anwendung befindet sich im Entdeckungsprozess.

  • „Bereitstellung“ – Die Anwendung wird gerade bereitgestellt

  • „ready“ – Die Anwendung läuft normal

  • „Fehlgeschlagen“ – Die Anwendung befindet sich in einem permanenten Fehlerzustand

  • „Wiederherstellung“ – Die Anwendung wird aus einer Sicherung oder einem Snapshot wiederhergestellt

  • „Nicht verfügbar“ – Die Anwendung ist momentan nicht zugänglich

  • "unbekannt" – Der Anwendungsstatus kann nicht ermittelt werden

  • „Wird gelöscht“ – Die Anwendung wird gerade gelöscht

stateTransitions

Array["type_astra_stateTransition"]

Falsch

Ein JSON-Array mit JSON-Objekten, die jeweils die Menge der zulässigen Zustandsübergänge von einem definierten Zustand aus darstellen. Jedes JSON-Objekt enthält die Felder "from" und "to", wobei der Wert von "from" der Name eines Zustands ist und der Wert von "to" ein Array zulässiger Zielzustände ist.

stateDetails

Array["type_astra_stateDetail"]

Wahr

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 der Anwendung angibt. Folgende Werte sind definiert:

  • „geschützt“ – Für die Anwendung ist eine Datensicherungsstrategie definiert und sie entspricht dieser Strategie

  • „Teilweise“ – Die Anwendung verfügt über eine definierte Datensicherungsstrategie, entspricht dieser jedoch nicht.

  • "keine" – Für die Anwendung ist keine Datensicherungsstrategie definiert

  • „atRisk“ - Die standardmäßige Speicherklasse des Clusters unterstützt keine Snapshots, die Anwendung läuft Gefahr, ein nicht unterstütztes Volume zu erhalten

protectionStateDetails

Array["type_astra_stateDetail"]

Wahr

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

  • Mindestanzahl: 0

appDetectedType

Zeichenkette

Falsch

JSON-Zeichenkette, die den spezifischen erkannten Anwendungstyp eindeutig repräsentiert. Definierte Werte sind:

  • "system" – Die Anwendung enthält eine Ressource, die sie als Teil der Kubernetes-Umgebung kennzeichnet.

  • "acc" - Die Anwendung enthält Ressourcen, die sie als Astra Control Center-Instanz identifizieren

Namensräume

Array[string]

Wahr

JSON-Array von JSON-Zeichenketten, die die Namen der Namespaces enthalten, in denen die Anwendung ausgeführt wird. Definierte Werte sind:

  • Mindestlänge: 1

  • Maximale Länge: 253

  • Entspricht dem DNS 1123 Label Schema

namespaceMapping

Array["namespaceMapping"]

Falsch

JSON-Array von JSON-Objekten, die jeweils einen Quell-Namespace einem Ziel-Namespace für einen Klonvorgang zuordnen. Definierte Werte sind:

  • Mindestanzahl: 0

storageClassMapping

Array["storageClassMapping"]

Falsch

JSON-Array von JSON-Objekten, die jeweils eine Quellspeicherklasse einer Zielspeicherklasse für einen Wiederherstellungsvorgang zuordnen. Sind keine Elemente vorhanden oder ist das Feld nicht vorhanden, werden die ursprünglichen Quellspeicherklassennamen verwendet. Definierte Werte sind:

  • Mindestanzahl: 0

clusterName

Zeichenkette

Falsch

JSON-Zeichenkette mit dem Namen des Clusters, auf dem die Anwendung ausgeführt wird. Wird nicht zurückgegeben, wenn die Anwendung aktuell nicht ausgeführt wird.

Cluster-ID

Zeichenkette

Falsch

JSON-Zeichenfolge mit der ID des Clusters, auf dem die Anwendung ausgeführt wird. Wird nicht zurückgegeben, wenn die Anwendung derzeit nicht ausgeführt wird. Wenn beim Erstellen angegeben, gibt clusterID an, in welchen Cluster die Anwendung geklont werden muss. Existiert der angegebene Cluster nicht oder stimmt der angegebene Cluster nicht mit der in der Anforderungs-URI angegebenen clusterID überein, schlägt das Klonen fehl. Definierte Werte sind:

  • Entspricht dem Astra-Identifikatorschema

clusterType

Zeichenkette

Falsch

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

  • "gke" - Kubernetes, gehostet auf Google Kubernetes Engine (GKE)

  • "aks" - Kubernetes, gehostet auf Microsoft Azure Kubernetes Service (AKS)

  • "eks" - Kubernetes, gehostet auf Amazon Elastic Kubernetes Service (Amazon EKS)

  • "openshift" - Der Cluster ist vom Typ OpenShift

  • "kubernetes" - Der Cluster ist ein generisches Kubernetes

sourceAppID

Zeichenkette

Falsch

JSON-Zeichenfolge mit der ID einer Quellanwendung. Wird nur zurückgegeben, wenn die Anwendung von einer anderen Anwendung geklont oder aus einer Sicherung oder einem Snapshot wiederhergestellt wurde. Bei der Erstellung wird die sourceAppID zusammen mit der sourceClusterID verwendet und gibt an, welche laufende Anwendung geklont wird. Existiert die angegebene Anwendung nicht im angegebenen Quell-Cluster, schlägt der Klonvorgang fehl. Beim Erstellen einer Anwendung kann nur eine der folgenden IDs angegeben werden: sourceAppID, backupID oder snapshotID. Folgende Werte sind definiert:

  • Entspricht dem Astra-Identifikatorschema

sourceClusterName

Zeichenkette

Falsch

JSON-Zeichenkette mit dem Namen des Clusters, auf dem die Anwendung zuvor ausgeführt wurde. Wird nur zurückgegeben, wenn die Anwendung von einem anderen Cluster geklont wurde.

Quell-Cluster-ID

Zeichenkette

Falsch

JSON-Zeichenfolge mit der ID des Clusters, auf dem die Anwendung zuvor ausgeführt wurde. Wird nur zurückgegeben, wenn die Anwendung von einem anderen Cluster geklont wurde. Bei der Erstellung wird die sourceClusterID zusammen mit der sourceAppID verwendet und gibt den Quell-Cluster der zu klonenden Anwendung an. Wenn der angegebene Quell-Cluster nicht existiert, schlägt der Klonvorgang fehl. Folgende Werte sind definiert:

  • Entspricht dem Astra-Identifikatorschema

Backup-ID

Zeichenkette

Falsch

JSON-Zeichenfolge mit der ID des Backups, aus dem die Anwendung wiederhergestellt wurde. Wird nur zurückgegeben, wenn die Anwendung aus einem Backup wiederhergestellt wurde. Bei der Erstellung einer Anwendung gibt backupID an, dass die Anwendung aus einem vorhandenen Backup geklont wird. Existiert das angegebene Backup nicht, schlägt der Klonvorgang fehl. Bei der Erstellung einer Anwendung kann nur entweder sourceAppID, backupID oder snapshotID angegeben werden. Bei einer Ersetzung gibt backupID das Anwendungs-Backup an, aus dem die Anwendung direkt wiederhergestellt wird. Existiert das angegebene Backup nicht, schlägt die Wiederherstellung fehl. Bei der Aktualisierung einer Anwendung kann nur entweder backupID oder snapshotID angegeben werden. Definierte Werte sind:

  • Entspricht dem Astra-Identifikatorschema

Snapshot-ID

Zeichenkette

Falsch

JSON-Zeichenfolge mit der ID des Snapshots, aus dem die Anwendung wiederhergestellt wurde. Wird nur zurückgegeben, wenn die Anwendung aus einem Snapshot wiederhergestellt wurde. Bei der Erstellung gibt snapshotID an, dass eine Anwendung aus einem vorhandenen Snapshot geklont wird. Existiert der angegebene Snapshot nicht, schlägt der Klonvorgang fehl. Bei der Erstellung einer Anwendung kann nur einer von sourceAppID, backupID oder snapshotID angegeben werden. Bei einer Ersetzung gibt snapshotID den Anwendungssnapshot an, aus dem die Anwendung direkt wiederhergestellt wird. Existiert der angegebene Snapshot nicht, schlägt die Wiederherstellung fehl. Bei der Aktualisierung einer Anwendung kann nur einer von backupID oder snapshotID angegeben werden. Definierte Werte sind:

  • Entspricht dem Astra-Identifikatorschema

replicationSourceAppID

Zeichenkette

Falsch

JSON-Zeichenfolge mit der ID der Anwendung, die in diese Anwendung repliziert wird. Wird nur zurückgegeben, wenn die Anwendung aktuell das Ziel einer AppMirror-Beziehung ist und sich die Beziehung nicht im failedOver-Status befindet. Befindet sich die Beziehung im failedOver-Status, wird dieses Feld nicht zurückgegeben. Definierte Werte sind:

  • Entspricht dem Astra-Identifikatorschema

restoreFilter

"restoreFilter"

Falsch

JSON-Objekt mit einer Liste von Filtern, die beschreiben, welche Ressourcen in eine selektive Wiederherstellung einbezogen oder ausgeschlossen werden. Include und Exclude schließen sich gegenseitig aus, und eine selektive Wiederherstellung kann nur einen Filtertyp verwenden.

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.

type_astra_metadata_list

Name Typ Erforderlich Beschreibung

fortfahren

Zeichenkette

Falsch

Zählen

Nummer

Falsch

Etiketten

Array["Typ_Astra_Label"]

Falsch

CreationZeitstempel

Zeichenkette

Falsch

Änderungszeitstempel

Zeichenkette

Falsch

Erstellt von

Zeichenkette

Falsch

modifiedBy

Zeichenkette

Falsch

invalidParams

Name Typ Erforderlich Beschreibung

Name

Zeichenkette

Wahr

Name des ungültigen Abfrageparameters

Grund

Zeichenkette

Wahr

Grund, warum der Abfrageparameter ungültig ist