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.

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.