REST Resource: projects.locations.flagReleases

Resource: FlagRelease

A collection of FlagRevisions.

JSON representation
{
  "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.
}
Fields
name

string

Identifier. The resource name (full URI of the resource) following the standard naming scheme:

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

flagRevisions[]
(deprecated)

string

Optional. Immutable. DEPRECATED: Use flagRevisionsRelease instead. FlagRevisions to be rolled out. Only one of flagRevisions, allFlags, or flagSets can be set. It used to be the ultimate source to truth and has been moved to effectiveFlagRevisions.

obsoleteFlags[]
(deprecated)

string

Optional. Immutable. Deprecated: Use the 'state' field in the 'Flag' resource to manage the cleanup of flag lifecycles including removal from UnitKind and Units. Flags to be removed from given UnitKind and all related Units. If Flag is provided here, its FlagRevisions will be removed from UnitKind and Units.

unitKind

string

Required. Immutable. The UnitKind this FlagRelease applies to.

flagSets[]
(deprecated)

string

Optional. Immutable. DEPRECATED: Use flagSetsRelease instead. Flag sets to be rolled out. Only one of flagRevisions, allFlags, or flagSets can be set.

allFlags
(deprecated)

boolean

Optional. Immutable. DEPRECATED: Use allFlagsRelease instead. Rollout all flags in the provided UnitKind. Only one of flagRevisions, allFlags, or flagSets can be set.

effectiveFlagRevisions[]

string

Output only. An OUTPUT_ONLY field that contains FlagRevisions to be rolled out. This is the ultimate source of truth of what a Rollout or a UnitOperation carries.

labels

map (key: string, value: string)

Optional. The labels on the resource, which can be used for categorization. similar to Kubernetes resource labels.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

annotations

map (key: string, value: string)

Optional. Annotations is an unstructured key-value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when modifying objects.

More info: https://kubernetes.io/docs/user-guide/annotations

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

uid

string

Output only. The unique identifier of the resource. UID is unique in the time and space for this resource within the scope of the service. It is typically generated by the server on successful creation of a resource and must not be changed. UID is used to uniquely identify resources with resource name reuses. This should be a UUID4.

etag

string

Output only. An opaque value that uniquely identifies a version or generation of a resource. It can be used to confirm that the client and server agree on the ordering of a resource being written.

createTime

string (Timestamp format)

Output only. The timestamp when the resource was created.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Output only. The timestamp when the resource was last updated. Any change to the resource made by users must refresh this value. Changes to a resource made by the service should refresh this value.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

Union field release_content. Defines the content or type of this flag release. Only one field within this oneof can be set. release_content can be only one of the following:
flagRevisionsRelease

object (FlagRevisionList)

Optional. Immutable. Specifies the release consists of a list of flag revisions.

flagSetsRelease

object (FlagSetList)

Optional. Immutable. Specifies the release consists of a list of flag sets.

allFlagsRelease

boolean

Optional. Immutable. Specifies the release includes all flags.

FlagRevisionList

Wrapper for a list of flag revisions.

JSON representation
{
  "revisions": [
    string
  ]
}
Fields
revisions[]

string

Required. FlagRevisions to be rolled out.

FlagSetList

Wrapper for a list of flag sets.

JSON representation
{
  "sets": [
    string
  ]
}
Fields
sets[]

string

Required. Flag sets to be rolled out.

Methods

create

Create a new flag release.

delete

Delete a single flag release.

get

Retrieve a single flag release.

list

Retrieve a collection of flag releases.

patch

Update a single flag release.