Resource: PolicyOrchestrator
PolicyOrchestrator helps managing project+zone level policy resources (e.g. OS Policy Assignments), by providing tools to create, update and delete them across projects and locations, at scale.
Policy orchestrator functions as an endless loop. Each iteration orchestrator computes a set of resources that should be affected, then progressively applies changes to them. If for some reason this set of resources changes over time (e.g. new projects are added), the future loop iterations will address that.
Orchestrator can either upsert or delete policy resources. For more details, see the description of the action
, and orchestratedResource
fields.
Note that policy orchestrator do not "manage" the resources it creates. Every iteration is independent and only minimal history of past actions is retained (apart from Cloud Logging). If orchestrator gets deleted, it does not affect the resources it created in the past. Those will remain where they were. Same applies if projects are removed from the orchestrator's scope.
JSON representation |
---|
{ "name": string, "description": string, "etag": string, "state": string, "reconciling": boolean, "orchestrationScope": { object ( |
Fields | |
---|---|
name |
Immutable. Identifier. In form of * |
description |
Optional. Freeform text describing the purpose of the resource. |
etag |
Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. |
state |
Optional. State of the orchestrator. Can be updated to change orchestrator behaviour. Allowed values: - Note: There might be more states added in the future. We use string here instead of an enum, to avoid the need of propagating new states to all the client code. |
reconciling |
Output only. Set to true, if the there are ongoing changes being applied by the orchestrator. |
orchestration |
Optional. Defines scope for the orchestration, in context of the enclosing PolicyOrchestrator resource. Scope is expanded into a list of <project, zone> pairs, in which the rollout action will take place. Expansion starts with a Folder resource parenting the PolicyOrchestrator resource: - All the descendant projects are listed. - List of project is cross joined with a list of all available zones. - Resulting list of <project, zone> pairs is filtered according to the selectors. |
action |
Required. Action to be done by the orchestrator in |
orchestrated |
Required. Resource to be orchestrated by the policy orchestrator. |
orchestration |
Output only. State of the orchestration. |
create |
Output only. Timestamp when the policy orchestrator resource was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
update |
Output only. Timestamp when the policy orchestrator resource was last modified. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
labels |
Optional. Labels as key value pairs An object containing a list of |
Methods |
|
---|---|
|
Creates a new policy orchestrator under the given organizations resource. |
|
Deletes an existing policy orchestrator resource, parented by an organization. |
|
Retrieves an existing policy orchestrator, parented by an organization. |
|
Lists the policy orchestrators under the given parent organization resource. |
|
Updates an existing policy orchestrator, parented by an organization. |