REST Resource: projects.locations.unitKinds

資源：UnitKind

單位的定義。屬於同一個 UnitKind 的單元會一起管理，例如採用相同的發布模型 (藍圖、版本等)，且通常會一起推出。

JSON 表示法 
{
  "name": string,
  "defaultRelease": string,
  "dependencies": [
    {
      object (Dependency)
    }
  ],
  "inputVariableMappings": [
    {
      object (VariableMapping)
    }
  ],
  "outputVariableMappings": [
    {
      object (VariableMapping)
    }
  ],
  "defaultFlagRevisions": [
    string
  ],
  "saas": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
欄位
name

string

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

"projects/{project}/locations/{location}/unitKinds/{unitKind}"
defaultRelease

string

選用。要用做建立這個 UnitKind 新單元預設值的 Release 物件參照 (選用)。

如未指定，新單元必須明確參照要用於建立單元的版本。
dependencies[]

object (Dependency)

選用。不可變動。這個發布版本所依附的其他單元 kind 清單。如果找不到依附元件，系統會自動佈建。最多 10 個。
inputVariableMappings[]

object (VariableMapping)

選用。這個版本適用的 inputVariables 清單，這些變數會從依附元件的 outputVariables 擷取，或傳遞至依附元件的 inputVariables。最多 100 個。
outputVariableMappings[]

object (VariableMapping)

選用。這個單元 kind 的 outputVariables 清單會傳遞至這個單元的 outputVariables。最多 100 個。
defaultFlagRevisions[]

string

選用。這個 UnitKind 的旗標預設修訂版本。新建立的單位會使用建立時的旗標預設值 defaultFlagRevisions。
saas

string

這是必要旗標，不可變動。這是指供應商要透過 App Lifecycle Manager 管理的產品 (代管服務) 所定義的 SaaS。App Lifecycle Manager 通用資料模型的一部分。設定後即無法變更。
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"。

依附元件

依附元件代表與另一個單元 kind 的單一依附元件 (透過別名)。

JSON 表示法 
{
  "unitKind": string,
  "alias": string
}
欄位
unitKind

string

這是必要旗標，不可變動。依附元件的單元種類。
alias

string

這是必要旗標，依附元件的別名。用於輸入變數對應。

VariableMapping

將輸入變數對應至各自的輸出變數，以建立依附元件

JSON 表示法 
{
  "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.
}
欄位
variable

string

必要。變數名稱

聯集欄位 mapping_type。

mapping_type 只能是下列其中一項：
from

object (FromMapping)

選用。輸出變數，這些變數會從依附元件取得值
to

object (ToMapping)

選用。輸入變數，這些變數的值會傳遞至依附元件。

FromMapping

輸出變數，其值會傳遞至依附元件

JSON 表示法 
{
  "dependency": string,
  "outputVariable": string
}
欄位
dependency

string

這是必要旗標，輸出變數會將值傳遞至的依附元件別名
outputVariable

string

這是必要旗標，依附元件的 outputVariable 名稱

ToMapping

值會傳遞至依附元件的輸入變數

JSON 表示法 
{
  "dependency": string,
  "inputVariable": string,
  "ignoreForLookup": boolean
}
欄位
dependency

string

這是必要旗標，inputVariable 會將值傳遞至的依附元件別名
inputVariable

string

這是必要旗標，依附元件的 inputVariable 名稱
ignoreForLookup

boolean

選用。告知 App Lifecycle Manager 在查詢期間是否應使用這個對應

方法

create

 建立新的單元種類。

delete

 刪除單一單元 kind。

get

 擷取單一單元 kind。

list

 擷取單元 kind 集合。

patch

 更新單一單元 kind。