Returns an IAM policy for the specified bucket.
Arguments
Parameters | |
---|---|
bucket |
Required. Name of a bucket.
|
optionsRequestedPolicyVersion |
The IAM policy format version to be returned. If the optionsRequestedPolicyVersion is for an older version that doesn't support part of the requested IAM policy, the request fails.
|
userProject |
The project to be billed for this request. Required for Requester Pays buckets.
|
Raised exceptions
Exceptions | |
---|---|
ConnectionError |
In case of a network problem (such as DNS failure or refused connection). |
HttpError |
If the response status is >= 400 (excluding 429 and 503). |
TimeoutError |
If a long-running operation takes longer to finish than the specified timeout limit. |
TypeError |
If an operation or function receives an argument of the wrong type. |
ValueError |
If an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout. |
Response
If successful, the response contains an instance of Policy
.
Subworkflow snippet
Some fields might be optional or required. To identify required fields, refer to the API documentation.
YAML
- getIamPolicy: call: googleapis.storage.v1.buckets.getIamPolicy args: bucket: ... optionsRequestedPolicyVersion: ... userProject: ... result: getIamPolicyResult
JSON
[ { "getIamPolicy": { "call": "googleapis.storage.v1.buckets.getIamPolicy", "args": { "bucket": "...", "optionsRequestedPolicyVersion": "...", "userProject": "..." }, "result": "getIamPolicyResult" } } ]