REST Resource: projects.locations.flagReleases

資源：FlagRelease

FlagRevision 的集合。

JSON 表示法 
{
  "name": string,
  "flagRevisions": [
    string
  ],
  "obsoleteFlags": [
    string
  ],
  "unitKind": string,
  "flagSets": [
    string
  ],
  "allFlags": boolean,
  "effectiveFlagRevisions": [
    string
  ],
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,

  // Union field release_content can be only one of the following:
  "flagRevisionsRelease": {
    object (FlagRevisionList)
  },
  "flagSetsRelease": {
    object (FlagSetList)
  },
  "allFlagsRelease": boolean
  // End of list of possible types for union field release_content.
}
欄位
name

string

ID。資源名稱 (資源的完整 URI)，遵循標準命名架構：

"projects/{project}/locations/{location}/flagReleases/{flagReleaseId}"
flagRevisions[]
(deprecated)

string

選用。不可變動。已淘汰：請改用 flagRevisionsRelease。FlagRevisions 即將推出。只能設定 flagRevisions、allFlags 或 flagSets 其中之一。這個屬性過去是最終的準確資料來源，現在已移至 effectiveFlagRevisions。
obsoleteFlags[]
(deprecated)

string

選用。不可變動。已淘汰：請使用「Flag」資源中的「state」欄位，管理旗標生命週期的清除作業，包括從 UnitKind 和 Units 中移除。Flags 要從指定的 UnitKind 和所有相關 Units 中移除。如果在此提供 Flag，系統會從 UnitKind 和 Units 移除其 FlagRevision。
unitKind

string

這是必要旗標，不可變動。此 FlagRelease 適用的 UnitKind。
flagSets[]
(deprecated)

string

選用。不可變動。已淘汰：請改用 flagSetsRelease。要推出的旗標集。只能設定 flagRevisions、allFlags 或 flagSets 其中之一。
allFlags
(deprecated)

boolean

選用。不可變動。已淘汰：請改用 allFlagsRelease。在提供的 UnitKind 中推出所有旗標。只能設定 flagRevisions、allFlags 或 flagSets 其中之一。
effectiveFlagRevisions[]

string

僅供輸出。OUTPUT_ONLY 欄位，內含要推出的 FlagRevision。這是 Rollout 或 UnitOperation 所攜帶內容的最終可靠來源。
labels

map (key: string, value: string)

選用。資源上的標籤，可用於分類，類似於 Kubernetes 資源標籤。

包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
annotations

map (key: string, value: string)

選用。註解是與資源一起儲存的非結構化鍵/值對應，外部工具可能會設定註解，用來儲存及擷取任意中繼資料。這些屬性無法查詢，修改物件時應保留這些屬性。

詳情請參閱：https://kubernetes.io/docs/user-guide/annotations

包含 "key": value 組合清單的物件，例如 { "name": "wrench", "mass": "1.3kg", "count": "3" }。
uid

string

僅供輸出。資源專屬識別碼。在服務範圍內，這項資源適用的時間和空間中，UID 是獨一無二的。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"。
聯集欄位 release_content。定義這個旗標版本的內容或類型。這個 oneof 內只能設定一個欄位。release_content 只能是下列其中一個設定：
flagRevisionsRelease

object (FlagRevisionList)

選用。不可變動。指定版本包含旗標修訂版本清單。
flagSetsRelease

object (FlagSetList)

選用。不可變動。指定版本包含一組旗標。
allFlagsRelease

boolean

選用。不可變動。指定版本包含所有旗標。

FlagRevisionList

旗標修訂版本清單的包裝函式。

JSON 表示法 
{
  "revisions": [
    string
  ]
}
欄位
revisions[]

string

必要欄位。FlagRevision。

FlagSetList

旗標集清單的包裝函式。

JSON 表示法 
{
  "sets": [
    string
  ]
}
欄位
sets[]

string

這是必要旗標，要推出的旗標集。

方法

create

 建立新的旗標版本。

delete

 刪除單一旗標版本。

get

 擷取單一旗標版本。

list

 擷取一系列旗標版本。

patch

 更新單一旗標版本。