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

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

"projects/{project}/locations/{location}/flagReleases/{flagReleaseId}"

flagRevisions[]
(deprecated)

string

可选。不可变。已弃用:请改用 flagRevisionsRelease。FlagRevision 即将推出。只能设置 flagRevisions、allFlags 或 flagSets 中的一个。它曾经是最终的可靠来源,现在已移至 effectiveFlagRevisions。

obsoleteFlags[]
(deprecated)

string

可选。不可变。已弃用:请使用“Flag”资源中的“state”字段来管理标志生命周期的清理,包括从 UnitKind 和 Units 中移除。要从给定 UnitKind 和所有相关 Units 中移除的 Flag。如果此处提供了 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。这是 RolloutUnitOperation 所携带内容的最终可靠来源。

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"

联合字段 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

更新单个标志发布。