Skip to main content
Eine neuere Version dieses Produkts ist erhältlich.
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Abrufen einer Anwendungsressource für einen verwalteten Cluster

Änderungen vorschlagen
PDFs

GET /accounts/{account_id}/topology/v1/managedClusters/{managedCluster_id}/apps/{app_id}/appAssets/{appAsset_id}

Gibt die gespeicherte Application Asset API-Ressource im JSON-Antworttext zurück.

Parameter

Name Typ In Erforderlich Beschreibung

Konto-ID

Zeichenkette

Pfad

True

ID der übergeordneten Kontoressource

  • Beispiel: {{.Account}}

managedCluster_id

Zeichenkette

Pfad

True

ID der enthaltenden managedCluster-Ressource

App-ID

Zeichenkette

Pfad

True

ID der übergeordneten App-Ressource

appAsset_id

Zeichenkette

Pfad

True

ID der appAsset-Sammlung, die aufgelistet werden soll

Antwort

Status: 200, Returns the stored Application Asset API resource in the JSON response body.
Name Typ Erforderlich Beschreibung

Typ

Zeichenkette

True

Medientyp der Ressource. Folgende Werte sind definiert:

  • "application/astra-appAsset"

Version

Zeichenkette

True

Version der Ressource. Folgende Werte sind definiert:

  • "1,0"

  • "1,1"

id

Zeichenkette

True

Weltweit eindeutiger Bezeichner der Ressource. Folgende Werte sind definiert:

  • Entspricht dem UUIDv4-Schema

assetType

Zeichenkette

True

JSON-Zeichenkette mit einem Wert, der angibt, welcher Asset-Typ von Kubernetes beschrieben wird. Folgende Werte sind definiert:

  • Mindestlänge: 1

  • Maximale Länge: 254

CreationZeitstempel

Zeichenkette

True

JSON-Zeichenkette mit einem Zeitstempel, der angibt, wann die Kubernetes-Metadaten erstellt wurden. Folgende Werte sind definiert:

  • Entspricht dem ISO-8601 Datums- und Zeitschema

GVK

"GVK"

True

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

Ressource

"type_json"

Falsch

JSON-Objekt, das den gesamten Inhalt der Kubernetes-Ressourcendefinition enthält.

Asset-ID

Zeichenkette

True

JSON-Zeichenkette mit einer von Kubernetes zugewiesenen Kennung. Folgende Werte sind definiert:

  • Entspricht dem Astra-Identifikatorschema

Etiketten

Array["Etiketten"]

True

JSON-Array von JSON-Objekten, die jeweils ein dem Asset zugeordnetes Kubernetes-Label enthalten. Sind keine Details verfügbar, ist dieses Array leer.

  • Mindestanzahl: 0

assetName

Zeichenkette

True

JSON-Zeichenkette mit einem von Kubernetes zugewiesenen Namen. Folgende Werte sind definiert:

  • Mindestlänge: 1

  • Maximale Länge: 254

Namensraum

Zeichenkette

Falsch

JSON-Zeichenkette mit einem von Kubernetes zugewiesenen Namespace. Folgende Werte sind definiert:

  • Mindestlänge: 1

  • Maximale Länge: 254

Metadaten

"type_astra_metadata"

True

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

  • Entspricht dem Astra Metadatenschema
Beispielantwort 
{
  "type": "application/astra-appAsset",
  "version": "1.1",
  "id": "6415e851-b820-553b-9432-ebd057d1917d",
  "assetType": "Pod",
  "creationTimestamp": "2020-08-06T12:24:52.256624Z",
  "GVK": {
    "group": "apps",
    "kind": "Pod",
    "version": "v1"
  },
  "assetID": "93ec0c61-d993-4aa1-bb08-f4dcdd5e97f6",
  "labels": [
    {
      "name": "app",
      "value": "mediawiki"
    },
    {
      "name": "pod-template-hash",
      "value": "69c6fcf864"
    }
  ],
  "assetName": "mediawiki-69c6fcf864-2wx6l",
  "namespace": "wiki",
  "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

True

Titel

Zeichenkette

True

Detail

Zeichenkette

True

Status

Zeichenkette

True

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

True

Titel

Zeichenkette

True

Detail

Zeichenkette

True

Status

Zeichenkette

True

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

True

Titel

Zeichenkette

True

Detail

Zeichenkette

True

Status

Zeichenkette

True

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

True

Titel

Zeichenkette

True

Detail

Zeichenkette

True

Status

Zeichenkette

True

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

GVK

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

Name Typ Erforderlich Beschreibung

Gruppe

Zeichenkette

Falsch

JSON-Zeichenkette mit einer von Kubernetes zugewiesenen Gruppenkennung. Folgende Werte sind definiert:

  • Mindestlänge: 1

  • Maximale Länge: 254

Art

Zeichenkette

Falsch

JSON-Zeichenkette, die einen von Kubernetes zugewiesenen Kindbezeichner enthält. Folgende Werte sind definiert:

  • Mindestlänge: 1

  • Maximale Länge: 254

Version

Zeichenkette

Falsch

JSON-Zeichenkette mit einer von Kubernetes zugewiesenen Versionskennung. Folgende Werte sind definiert:

  • Mindestlänge: 1

  • Maximale Länge: 254

type_json

JSON-Objekt, das den gesamten Inhalt der Kubernetes-Ressourcendefinition enthält.

Etiketten

Name Typ Erforderlich Beschreibung

Name

Zeichenkette

True

JSON-Zeichenkette mit dem Labelnamen Definierte Werte sind:

  • Mindestlänge: 1

  • Maximale Länge: 63

  • Der definierte reguläre Ausdruck ist: "^([\S.]{1,253}\/)?([a-z0-9A-Z_.-]){1,63}$"

Wert

Zeichenkette

True

JSON-Zeichenkette, die den Label-Wert enthält Definierte Werte sind:

  • Mindestlänge: 1

  • Maximale Länge: 63

  • Der definierte reguläre Ausdruck lautet: "^([a-z0-9A-Z_.-]){1,63}$"

Typ_Astra_Label

Name Typ Erforderlich Beschreibung

Name

Zeichenkette

True

Wert

Zeichenkette

True

type_astra_metadata

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

  • Entspricht dem Astra Metadatenschema

Name Typ Erforderlich Beschreibung

Etiketten

Array["Typ_Astra_Label"]

True

CreationZeitstempel

Zeichenkette

True

Änderungszeitstempel

Zeichenkette

True

Erstellt von

Zeichenkette

True

modifiedBy

Zeichenkette

Falsch

invalidParams

Name Typ Erforderlich Beschreibung

Name

Zeichenkette

True

Name des ungültigen Abfrageparameters

Grund

Zeichenkette

True

Grund, warum der Abfrageparameter ungültig ist