Tests a set of permissions on the given bucket to see which, if any, are held by the caller. Try it now.
Request
HTTP request
GET https://storage.googleapis.com/storage/v1/b/bucket/iam/testPermissions
In addition to standard query parameters, the following query parameters apply to this method.
To see an example of how to include query parameters in a request, see the JSON API Overview page.
Parameters
Parameter name | Value | Description |
---|---|---|
Path parameters | ||
bucket |
string |
Name of a bucket. |
Required query parameters | ||
permissions |
string |
Permissions to test.
Note: Providing storage.buckets.list or storage.buckets.create
returns an error, as these permissions apply to projects instead of buckets.
|
Request body
Do not supply a request body with this method.
Response
If successful, this method returns a response body with the following structure:
{ "kind": "storage#testIamPermissionsResponse", "permissions": [ string ] }
Property name | Value | Description | Notes |
---|---|---|---|
kind |
string |
The kind of item this is. | |
permissions[] |
list |
The permissions held by the caller. Permissions are always of the format
storage.resource.capability , where
resource is one of buckets or objects .
See Cloud Storage IAM
Permissions for a list of supported permissions. |
Try it!
Use the APIs Explorer below to call this method on live data and see the response.