REST Resource: projects.locations.saas

Ressource: SaaS

SaaS ist eine Darstellung eines vom Ersteller verwalteten SaaS-Dienstes.

JSON-Darstellung
{
  "name": string,
  "locations": [
    {
      object (Location)
    }
  ],
  "state": enum (State),
  "conditions": [
    {
      object (SaasCondition)
    }
  ],
  "error": {
    object (Status)
  },
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
Felder
name

string

ID. Der Ressourcenname (vollständiger URI der Ressource) gemäß dem Standardbenennungsschema:

"projects/{project}/locations/{location}/saas/{saas}"

locations[]

object (Location)

Optional. Liste der Standorte, an denen der Dienst verfügbar ist. „Rollout“ bezieht sich auf die Liste, aus der ein Roll-out-Plan generiert wird.

state

enum (State)

Nur Ausgabe. Status der SaaS. Wenn die ApplicationTemplate leer ist, hat sie immer den Status ACTIVE.

conditions[]

object (SaasCondition)

Nur Ausgabe. Eine Reihe von Bedingungen, die die verschiedenen Bedingungen angeben, die diese Ressource haben kann.

error

object (Status)

Nur Ausgabe. Wenn der Status FAILED ist, der entsprechende Fehlercode und die entsprechende Meldung. Standardmäßig ist für alle anderen Bundesstaaten „code=OK“ festgelegt.

labels

map (key: string, value: string)

Optional. Die Labels der Ressource, die zur Kategorisierung verwendet werden können, ähnlich wie Kubernetes-Ressourcenlabels.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

annotations

map (key: string, value: string)

Optional. „Annotations“ ist eine unstrukturierte Schlüssel/Wert-Zuordnung, die mit einer Ressource gespeichert wird und von externen Tools festgelegt werden kann, um beliebige Metadaten zu speichern und abzurufen. Sie können nicht abgefragt werden und sollten beim Ändern von Objekten beibehalten werden.

Weitere Informationen: https://kubernetes.io/docs/user-guide/annotations

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

uid

string

Nur Ausgabe. Die eindeutige Kennzeichnung der Ressource. Die UID gilt zeitlich und räumlich im Rahmen des Dienstes nur für diese eine Ressource. Sie wird in der Regel nach dem Erstellen der Ressource vom Server generiert und darf nicht geändert werden. Die UID dient dazu, Ressourcen, deren Namen wiederverwendet werden, eindeutig zu kennzeichnen. Dies sollte eine UUID4 sein.

etag

string

Nur Ausgabe. Ein opaker Wert, der eine Version oder Generation einer Ressource eindeutig kennzeichnet. Damit kann bestätigt werden, dass Client und Server der Reihenfolge einer Ressource, die gerade geschrieben wird, zustimmen.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Ressource erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Ressource zuletzt aktualisiert wurde. Wenn Nutzer Änderungen an der Ressource vornehmen, muss dieser Wert aktualisiert werden. Gleiches gilt bei Änderungen an der Ressource durch den Dienst.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Standort

Standortinformationen, an denen der Dienst verfügbar ist.

JSON-Darstellung
{
  "name": string
}
Felder
name

string

Optional. Name des Standorts.

Bundesland

Status der SaaS.

Enums
STATE_TYPE_UNSPECIFIED Der Status ist nicht angegeben.
ACTIVE

Verworfen: Verwenden Sie STATE_ACTIVE.

RUNNING

Verworfen: Verwenden Sie STATE_RUNNING.

FAILED

Verworfen: Verwenden Sie STATE_FAILED.

STATE_ACTIVE Die SaaS-Lösung ist bereit
STATE_RUNNING Beim Importieren, Synchronisieren oder Replizieren von ApplicationTemplates
STATE_FAILED Fehler beim Importieren, Synchronisieren oder Replizieren der Verarbeitung von ApplicationTemplate

SaasCondition

SaasCondition beschreibt den Status eines SaaS.

JSON-Darstellung
{
  "status": enum (Status),
  "type": enum (Type),
  "lastTransitionTime": string,
  "message": string,
  "reason": string
}
Felder
status

enum (Status)

Erforderlich. Status der Bedingung.

type

enum (Type)

Erforderlich. Typ der Bedingung.

lastTransitionTime

string (Timestamp format)

Erforderlich. Der Zeitpunkt der letzten Änderung der Bedingung von einem Status in einen anderen.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

message

string

Erforderlich. Eine menschenlesbare Nachricht mit Details zur letzten Statusänderung.

reason

string

Erforderlich. Kurzer Grund für die letzte Statusänderung der Bedingung.

Status

Aufzählung der Status von Bedingungen.

Enums
STATUS_UNSPECIFIED Der Status der Bedingung ist nicht angegeben.
STATUS_UNKNOWN Die Bedingung ist unbekannt.
STATUS_TRUE Die Bedingung ist wahr.
STATUS_FALSE Die Bedingung ist falsch.

Typ

Aufzählung der Bedingungstypen.

Enums
TYPE_UNSPECIFIED Der Bedingungstyp ist nicht angegeben.
TYPE_READY Der Bedingungstyp ist bereit.
TYPE_SYNCHRONIZED Der Bedingungstyp wird synchronisiert.

Methoden

create

Erstellen Sie eine neue SaaS-Lösung.

delete

Einzelne SaaS löschen

get

Einzelnen SaaS-Typ abrufen.

list

Eine Sammlung von SaaS-Produkten abrufen.

patch

Einzelne SaaS-Lösung aktualisieren