REST Resource: projects.locations.tenants

Ressource: Mandant

Der Mandant repräsentiert die Diensterstellerseite einer Instanz des Dienstes, die auf der Grundlage einer Anfrage eines Nutzers erstellt wurde. In einem typischen Szenario hat ein Mandant eine Eins-zu-eins-Zuordnung zu einer Ressource, die einem Dienstnutzer zugewiesen wird.

Beispiel:

tenant: name: "projects/svc1/locations/loc/tenants/inst-068afff8" consumerResource: "projects/gshoe/locations/loc/shoes/black-shoe"

JSON-Darstellung
{
  "name": string,
  "consumerResource": string,
  "saas": string,
  "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}/tenants/{tenant}"

consumerResource

string

Optional. Nicht veränderbar. Ein Verweis auf die Nutzerressource, die dieser SaaS-Mandant darstellt.

Die Beziehung zu einer Nutzerressource kann von der SaaS-Laufzeit verwendet werden, um vom Nutzer definierte Einstellungen und Richtlinien wie Wartungsrichtlinien (über die Unified Maintenance Policy API) abzurufen.

saas

string

Erforderlich. Nicht veränderbar. Eine Referenz auf das SaaS, das das Produkt (den verwalteten Dienst) definiert, das der Ersteller mit der SaaS-Laufzeit verwalten möchte. Teil des gemeinsamen Datenmodells der SaaS-Laufzeit.

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

Methoden

create

Neuen Mandanten erstellen

delete

Einzelnen Mandanten löschen.

get

Einen einzelnen Mandanten abrufen.

list

Eine Sammlung von Mandanten abrufen.

patch

Einzelnen Mandanten aktualisieren