REST Resource: projects.locations.releases

リソース: Release

ユニットに伝播してデプロイされる新しいバージョン。これには、Artifact Registry を介したアクチュエーション用のパッケージ化されたブループリント（Helm や Terraform 構成パッケージなど）へのポインタが含まれます。

JSON 表現 
{
  "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
}
フィールド
name

string

ID。標準の命名スキームに沿ったリソース名（リソースの完全な URI）。

"projects/{project}/locations/{location}/releases/{release}"
unitKind

string

必須。変更不可。このリリースに対応する UnitKind への参照（必須。作成後は変更不可）。
blueprint

object (Blueprint)

省略可。ブループリントは、ユニットのプロビジョニングに必要なすべてのアーティファクトを含む OCI イメージです。
releaseRequirements

object (ReleaseRequirements)

省略可。このリリースを使用する際にユニットで満たす必要のある要件のセット。
inputVariables[]

object (UnitVariable)

省略可。出力専用。ブループリントで宣言された入力変数のリスト。ユニット仕様で値とともに存在できます
outputVariables[]

object (UnitVariable)

省略可。出力専用。ブループリントで宣言され、ユニット ステータスに値とともに存在できる出力変数のリスト
inputVariableDefaults[]

object (UnitVariable)

省略可。入力変数とデフォルト値のマッピング。最大 100
labels

map (key: string, value: string)

省略可。リソースのラベル。分類に使用できます。Kubernetes リソースラベルに似ています。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
annotations

map (key: string, value: string)

省略可。アノテーションは、任意のメタデータを保存して取得するため、外部ツールによって設定される可能性のあるリソースとともに保存される非構造化 Key-Value マップです。クエリは実行可能ではなく、オブジェクトを変更する際に保持する必要があります。

詳細: https://kubernetes.io/docs/user-guide/annotations

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
uid

string

出力専用。リソースの一意の識別子。UID は、サービスのスコープ内で、このリソースの時間と場所において一意性を持ちます。通常は、リソースの作成時にサーバーによって生成され、変更されることはありません。UID は、リソース名が再利用される場合でも一意にリソースを識別するために使用されます。UUID4 であることが必要です。
etag

string

出力専用。リソースのバージョンまたは世代を一意に識別する、不透明な値です。書き込まれるリソースの順序についてクライアントとサーバーの間で確実に同意するために使用できます。
createTime

string (Timestamp format)

出力専用。リソース作成時のタイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

出力専用。リソース最終更新時のタイムスタンプ。ユーザーがリソースを変更した場合は、この値を更新する必要があります。サービスがリソースを変更した場合は、この値を更新する必要があります。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

ブループリント

ブループリントは、ユニットのプロビジョニングに必要なすべてのアーティファクトを含む OCI イメージです。ブループリントの起動に使用されるエンジンのタイプ（terraform、helm など）やバージョンなどのメタデータは、イメージ マニフェストから取得されます。ホスト名を省略すると、Artifact Registry のリージョン パス（us-east1-docker.pkg.dev など）とみなされます。

JSON 表現 
{
  "package": string,
  "engine": string,
  "version": string
}
フィールド
package

string

省略可。変更不可。Unit で使用されるブループリントの URI（unitKind または release が設定されていない場合は必須）。
engine

string

出力専用。ブループリントの実行に使用されるエンジンのタイプ（terraform、helm など）。
version

string

出力専用。ブループリントにバージョン メタデータがある場合。

ReleaseRequirements

このリリースを使用する際にユニットで満たす必要のある要件のセット。

JSON 表現 
{
  "upgradeableFromReleases": [
    string
  ]
}
フィールド
upgradeableFromReleases[]

string

省略可。ユニットをアップグレードできる対象のリリースの一覧（省略可）。空のままにすると、制約は適用されません。このリリースにユニット アップグレード リクエストが提供されると、この制約がチェックされ、適用されます。

メソッド

create

 新しいリリースを作成します。

delete

 1 つのリリースを削除します。

get

 単一のリリースを取得します。

list

 リリースのコレクションを取得します。

patch

 単一のリリースを更新します。