v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-138134216.7 KB
objects

Updates an IAM policy for the specified object.

put/b/{bucket}/o/{object}/iam

Path parameters

bucketstring required

Name of the bucket in which the object resides.

objectstring required

Name of the object. For information about how to URL encode object names to be path safe, see Encoding URI Path Parts.

Query parameters

generationstring

If present, selects a specific revision of this object (as opposed to the latest version, the default).

userProjectstring

The project to be billed for this request. Required for Requester Pays buckets.

Request body

etagstring byte

HTTP 1.1 Entity tag for the policy.

kindstring

The kind of item this is. For policies, this is always storage#policy. This field is ignored on input.

resourceIdstring

The ID of the resource to which this policy belongs. Will be of the form projects//buckets/bucket for buckets, projects//buckets/bucket/objects/object for objects, and projects//buckets/bucket/managedFolders/managedFolder. A specific generation may be specified by appending #generationNumber to the end of the object name, e.g. projects//buckets/my-bucket/objects/data.txt#17. The current generation can be denoted with #0. This field is ignored on input.

versioninteger

The IAM policy format version.

Response

Successful response