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

标识符。遵循标准命名方案的资源名称(资源的完整 URI):

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

defaultRelease

string

可选。对要用作创建相应 UnitKind 的新单元的默认版本的 Release 对象的引用(可选)。

如果未指定,新单元必须明确引用用于创建它的版本。

dependencies[]

object (Dependency)

可选。不可变。相应发布版本所依赖的其他单元种类的列表。如果未找到依赖项,系统会自动预配。最多 10 个。

inputVariableMappings[]

object (VariableMapping)

可选。相应版本的 inputVariables 列表,这些变量将从依赖项的 outputVariables 中检索,或传递给依赖项的 inputVariables。最大值为 100。

outputVariableMappings[]

object (VariableMapping)

可选。相应单元种类的 outputVariables 列表将传递给相应单元的 outputVariables。最大值为 100。

defaultFlagRevisions[]

string

可选。相应 UnitKind 的标志的默认修订版本。新创建的单元将使用创建时存在的标志 defaultFlagRevisions。

saas

string

必需。不可变。对 SaaS 的引用,用于定义提供方希望通过 App Lifecycle Manager 管理的产品(代管式服务)。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 可用来唯一地标识资源。此字段应为 UUID4。

etag

string

仅限输出。不透明值,用于唯一地标识资源的版本或世代。它可用于确认客户端和服务器是否就正在写入的资源的顺序达成一致。

createTime

string (Timestamp format)

仅限输出。创建资源时的时间戳。

采用 RFC 3339 标准,生成的输出将始终进行 Z 规范化(即转换为 UTC 零时区格式并在末尾附加 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 规范化(即转换为 UTC 零时区格式并在末尾附加 Z),并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

依赖项

依赖项表示通过别名与另一个单元种类建立的单个依赖关系。

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 将向其传递值的依赖项的别名

outputVariable

string

必需。依赖项上 outputVariable 的名称

ToMapping

其值将传递给依赖项的输入变量

JSON 表示法
{
  "dependency": string,
  "inputVariable": string,
  "ignoreForLookup": boolean
}
字段
dependency

string

必需。inputVariable 将向其传递值的依赖项的别名

inputVariable

string

必需。依赖项上 inputVariable 的名称

ignoreForLookup

boolean

可选。告知 App Lifecycle Manager 在查找期间是否应使用此映射

方法

create

创建新的单元种类。

delete

删除单个单元种类。

get

检索单个单元种类。

list

检索一组单位种类。

patch

更新单个单元种类。