Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1352032.6 KB
policies

Updates the specified policy. You can update only the rules and the display name for the policy. To update a policy, you should use a read-modify-write loop: 1. Use GetPolicy to read the current version of the policy. 2. Modify the policy as needed. 3. Use UpdatePolicy to write the updated policy. This pattern helps prevent conflicts between concurrent updates.

put/v2/{+name}

Path parameters

namestring required

Immutable. The resource name of the Policy, which must be unique. Format: policies/{attachment_point}/denypolicies/{policy_id} The attachment point is identified by its URL-encoded full resource name, which means that the forward-slash character, /, must be written as %2F. For example, policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies/my-deny-policy. For organizations and folders, use the numeric ID in the full resource name. For projects, requests can use the alphanumeric or the numeric ID. Responses always contain the numeric ID.

Request body

createTimestring google-datetime

Output only. The time when the Policy was created.

uidstring

Immutable. The globally unique ID of the Policy. Assigned automatically when the Policy is created.

displayNamestring

A user-specified description of the Policy. This value can be up to 63 characters.

updateTimestring google-datetime

Output only. The time when the Policy was last updated.

etagstring

An opaque tag that identifies the current version of the Policy. IAM uses this value to help manage concurrent updates, so they do not cause one update to be overwritten by another. If this field is present in a CreatePolicyRequest, the value is ignored.

annotationsobject

A key-value map to store arbitrary metadata for the Policy. Keys can be up to 63 characters. Values can be up to 255 characters.

kindstring

Output only. The kind of the Policy. Always contains the value DenyPolicy.

deleteTimestring google-datetime

Output only. The time when the Policy was deleted. Empty if the policy is not deleted.

namestring

Immutable. The resource name of the Policy, which must be unique. Format: policies/{attachment_point}/denypolicies/{policy_id} The attachment point is identified by its URL-encoded full resource name, which means that the forward-slash character, /, must be written as %2F. For example, policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-project/denypolicies/my-deny-policy. For organizations and folders, use the numeric ID in the full resource name. For projects, requests can use the alphanumeric or the numeric ID. Responses always contain the numeric ID.

Response

Successful response