Buckets: testIamPermissions

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:

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.