REST Resource: projects.locations.unitKinds

Ressource: UnitKind

Definition einer Einheit. Einheiten, die zur selben UnitKind gehören, werden gemeinsam verwaltet. Sie folgen beispielsweise demselben Release-Modell (Blueprints, Versionen usw.) und werden in der Regel gemeinsam eingeführt.

JSON-Darstellung
{
  "name": string,
  "defaultRelease": string,
  "dependencies": [
    {
      object (Dependency)
    }
  ],
  "inputVariableMappings": [
    {
      object (VariableMapping)
    }
  ],
  "outputVariableMappings": [
    {
      object (VariableMapping)
    }
  ],
  "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}/unitKinds/{unitKind}"

defaultRelease

string

Optional. Eine Referenz auf das Release-Objekt, das standardmäßig zum Erstellen neuer Einheiten dieser UnitKind verwendet werden soll (optional).

Wenn keine Angabe erfolgt, muss eine neue Einheit explizit angeben, welche Version für die Erstellung verwendet werden soll.

dependencies[]

object (Dependency)

Optional. Nicht veränderbar. Liste der anderen Arten von Einheiten, von denen dieser Release abhängt. Abhängigkeiten werden automatisch bereitgestellt, wenn sie nicht gefunden werden. Maximal 10.

inputVariableMappings[]

object (VariableMapping)

Optional. Liste der inputVariables für diese Version, die entweder aus den outputVariables einer Abhängigkeit abgerufen oder an die inputVariables einer Abhängigkeit übergeben werden. Maximal 100.

outputVariableMappings[]

object (VariableMapping)

Optional. Die Liste der „outputVariables“ für diese Art von Einheit wird an die „outputVariables“ dieser Einheit übergeben. Maximal 100.

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. Kann nach der Festlegung nicht mehr geändert werden.

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

Abhängigkeit

„Dependency“ stellt eine einzelne Abhängigkeit von einer anderen Art von Einheit nach Alias dar.

JSON-Darstellung
{
  "unitKind": string,
  "alias": string
}
Felder
unitKind

string

Erforderlich. Nicht veränderbar. Die Art der Einheit der Abhängigkeit.

alias

string

Erforderlich. Ein Alias für die Abhängigkeit. Wird für die Zuordnung von Eingabevariablen verwendet.

VariableMapping

Zuordnung von Eingabevariablen zu ihrer jeweiligen Ausgabevariable für Abhängigkeiten

JSON-Darstellung
{
  "variable": string,

  // Union field mapping_type can be only one of the following:
  "from": {
    object (FromMapping)
  },
  "to": {
    object (ToMapping)
  }
  // End of list of possible types for union field mapping_type.
}
Felder
variable

string

Erforderlich. Name der Variablen.

Union-Feld mapping_type.

Für mapping_type ist nur einer der folgenden Werte zulässig:

from

object (FromMapping)

Optional. Ausgabevariablen, deren Werte aus Abhängigkeiten stammen

to

object (ToMapping)

Optional. Eingabevariablen, deren Werte an Abhängigkeiten übergeben werden.

FromMapping

Ausgabevariablen, deren Werte an Abhängigkeiten übergeben werden

JSON-Darstellung
{
  "dependency": string,
  "outputVariable": string
}
Felder
dependency

string

Erforderlich. Alias der Abhängigkeit, an die die outputVariable ihren Wert übergibt

outputVariable

string

Erforderlich. Name der outputVariable in der Abhängigkeit

ToMapping

Eingabevariablen, deren Werte an Abhängigkeiten übergeben werden

JSON-Darstellung
{
  "dependency": string,
  "inputVariable": string,
  "ignoreForLookup": boolean
}
Felder
dependency

string

Erforderlich. Alias der Abhängigkeit, an die die inputVariable ihren Wert übergibt

inputVariable

string

Erforderlich. Name der inputVariable in der Abhängigkeit

ignoreForLookup

boolean

Optional. Gibt an, ob diese Zuordnung bei der Suche verwendet werden soll

Methoden

create

Erstellen Sie eine neue Art von Einheit.

delete

Einzelne Art von Einheit löschen

get

Einzelne Art von Einheit abrufen

list

Eine Sammlung von Einheitenarten abrufen.

patch

Eine einzelne Art von Einheit aktualisieren.