- [Resource: FlagRelease](https://docs.cloud.google.com/app-lifecycle-manager/reference/rest/v1beta1/projects.locations.flagReleases.md.txt#FlagRelease)
  - [JSON representation](https://docs.cloud.google.com/app-lifecycle-manager/reference/rest/v1beta1/projects.locations.flagReleases.md.txt#FlagRelease.SCHEMA_REPRESENTATION)
- [FlagRevisionList](https://docs.cloud.google.com/app-lifecycle-manager/reference/rest/v1beta1/projects.locations.flagReleases.md.txt#FlagRevisionList)
  - [JSON representation](https://docs.cloud.google.com/app-lifecycle-manager/reference/rest/v1beta1/projects.locations.flagReleases.md.txt#FlagRevisionList.SCHEMA_REPRESENTATION)
- [FlagSetList](https://docs.cloud.google.com/app-lifecycle-manager/reference/rest/v1beta1/projects.locations.flagReleases.md.txt#FlagSetList)
  - [JSON representation](https://docs.cloud.google.com/app-lifecycle-manager/reference/rest/v1beta1/projects.locations.flagReleases.md.txt#FlagSetList.SCHEMA_REPRESENTATION)
- [FlagNameList](https://docs.cloud.google.com/app-lifecycle-manager/reference/rest/v1beta1/projects.locations.flagReleases.md.txt#FlagNameList)
  - [JSON representation](https://docs.cloud.google.com/app-lifecycle-manager/reference/rest/v1beta1/projects.locations.flagReleases.md.txt#FlagNameList.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/app-lifecycle-manager/reference/rest/v1beta1/projects.locations.flagReleases.md.txt#METHODS_SUMMARY)

## Resource: FlagRelease

A collection of `FlagRevision`s.

| 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, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "flagRevisionsRelease": { object (`FlagRevisionList`) }, "flagSetsRelease": { object (`FlagSetList`) }, "allFlagsRelease": boolean, "flagNamesRelease": { object (`FlagNameList`) } // End of mutually exclusive fields. } ``` |

| 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` > [!WARNING] > This item is deprecated! Optional. Immutable. DEPRECATED: Use flagRevisionsRelease instead. `FlagRevision`s 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` > [!WARNING] > This item is deprecated! Optional. Immutable. Deprecated: Use the 'state' field in the 'Flag' resource to manage the cleanup of flag lifecycles including removal from UnitKind and Units. `Flag`s to be removed from given UnitKind and all related Units. If `Flag` is provided here, its `FlagRevision`s will be removed from UnitKind and Units. |
| `unitKind` | `string` Required. Immutable. The `UnitKind` this FlagRelease applies to. |
| `flagSets[] (deprecated)` | `string` > [!WARNING] > This item is deprecated! 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` > [!WARNING] > This item is deprecated! 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 `FlagRevision`s 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"`. |
| Defines the content or type of this flag release. Only one field within this oneof can be set. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `flagRevisionsRelease` | ``object (`FlagRevisionList`)`` Optional. Immutable. Specifies the release consisting of a list of flag revisions. |
| `flagSetsRelease` | ``object (`FlagSetList`)`` Optional. Immutable. Specifies the release consisting of a list of flag sets. |
| `allFlagsRelease` | `boolean` Optional. Immutable. Specifies the release includes all flags. |
| `flagNamesRelease` | ``object (`FlagNameList`)`` Optional. Immutable. Specifies the release consisting of a list of flags. |
| End of mutually exclusive fields. ||

## FlagRevisionList

Wrapper for a list of flag revisions.

| JSON representation |
|---|
| ``` { "revisions": [ string ] } ``` |

| Fields ||
|---|---|
| `revisions[]` | `string` Required. `FlagRevision`s 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. |

## FlagNameList

Wrapper for a list of flags.

| JSON representation |
|---|
| ``` { "flags": [ string ] } ``` |

| Fields ||
|---|---|
| `flags[]` | `string` Required. `Flag`s 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. |