REST Resource: projects.locations.releases

Ressource: Release

Eine neue Version, die auf Einheiten übertragen und bereitgestellt werden soll. Dazu gehören Verweise auf verpackte Blueprints für die Ausführung (z. B. Helm- oder Terraform-Konfigurationspakete) über die Artifact Registry.

JSON-Darstellung 
{
  "name": string,
  "unitKind": string,
  "blueprint": {
    object (Blueprint)
  },
  "releaseRequirements": {
    object (ReleaseRequirements)
  },
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "outputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "inputVariableDefaults": [
    {
      object (UnitVariable)
    }
  ],
  "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}/releases/{release}"
unitKind

string

Erforderlich. Nicht veränderbar. Verweis auf die UnitKind, der diese Version entspricht (erforderlich und nach der Erstellung unveränderlich).
blueprint

object (Blueprint)

Optional. Blueprints sind OCI-Images, die alle Artefakte enthalten, die zum Bereitstellen einer Einheit erforderlich sind.
releaseRequirements

object (ReleaseRequirements)

Optional. Eine Reihe von Anforderungen, die auf der Einheit erfüllt werden müssen, wenn dieser Release verwendet wird.
inputVariables[]

object (UnitVariable)

Optional. Nur Ausgabe. Liste der Eingabevariablen, die im Blueprint deklariert sind und mit ihren Werten in der Einheitenspezifikation vorhanden sein können
outputVariables[]

object (UnitVariable)

Optional. Nur Ausgabe. Liste der Ausgabevariablen, die im Blueprint deklariert sind und mit ihren Werten im Gerätestatus vorhanden sein können
inputVariableDefaults[]

object (UnitVariable)

Optional. Zuordnung von Eingabevariablen zu Standardwerten. Maximal 100
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".

Entwurf

Blueprints sind OCI-Images, die alle Artefakte enthalten, die zum Bereitstellen einer Einheit erforderlich sind. Metadaten wie der Typ der Engine, die zum Ausführen des Blueprints verwendet wird (z. B. Terraform, Helm usw.), und die Version stammen aus dem Image-Manifest. Wenn der Hostname weggelassen wird, wird davon ausgegangen, dass es sich um den regionalen Pfad zu Artifact Registry handelt (z. B. us-east1-docker.pkg.dev).

JSON-Darstellung 
{
  "package": string,
  "engine": string,
  "version": string
}
Felder
package

string

Optional. Nicht veränderbar. URI zu einem Blueprint, der von der Einheit verwendet wird (erforderlich, sofern „unitKind“ oder „release“ festgelegt ist).
engine

string

Nur Ausgabe. Der Typ der Engine, die zum Ausführen des Blueprints verwendet wird, z. B. Terraform oder Helm.
version

string

Nur Ausgabe. Versionsmetadaten, sofern im Blueprint vorhanden.

ReleaseRequirements

Eine Reihe von Anforderungen, die auf der Einheit erfüllt werden müssen, wenn dieser Release verwendet wird.

JSON-Darstellung 
{
  "upgradeableFromReleases": [
    string
  ]
}
Felder
upgradeableFromReleases[]

string

Optional. Eine Liste der Releases, von denen aus ein Upgrade einer Einheit auf diesen Release möglich ist (optional). Wenn das Feld leer gelassen wird, werden keine Einschränkungen angewendet. Wenn angegeben, werden bei Anfragen zum Upgrade von Einheiten auf diese Version diese Einschränkungen geprüft und durchgesetzt.

Methoden

create

 Erstellen Sie einen neuen Release.

delete

 Einzelnen Release löschen

get

 Einzelnen Release abrufen

list

 Eine Sammlung von Releases abrufen

patch

 Einzelnen Release aktualisieren