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
The parent bucket of the managed folder.
managedFolder
string
The name of the managed folder, expressed as a path. For example,
example-dir. If the managed folder is nested (for example,
example-dir1/example-dir2), the / character in the managed folder
path must be escaped. For example, example-dir1%2Fexample-dir2.
Required query parameters
permissions
string
Permissions to test.
Request body
Do not supply a request body with this method.
Response
If successful, this method returns a response body with the following structure:
The permissions held by the caller. Permissions are always of the format
"storage.resource.capability", where
resource is one of buckets, objects, or
managedfolders.
See Cloud Storage IAM
Permissions for a list of supported permissions.
For information about status and error codes returned by this API, see the
reference page.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[],[],null,["# ManagedFolder: testIamPermissions\n\nTests a set of permissions on the given\n[managed folder](/storage/docs/managed-folders) to see which, if any, are held by the\ncaller.\n\nRequired permissions\n--------------------\n\nPermissions are not required for using this method.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://storage.googleapis.com/storage/v1/b/bucket/managedFolders/managedFolder/iam/testPermissions\n```\n\nIn addition to [standard query parameters](/storage/docs/json_api/v1/parameters#query),\nthe following parameters apply to this method.\n\nTo see an example of how to include query parameters in a request, see the\n[JSON API Overview](/storage/docs/json_api#query_parameters) page.\n\n### Parameters\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"kind\": \"storage#testIamPermissionsResponse\",\n \"permissions\": [\n string\n ]\n}\n```\n\nFor information about status and error codes returned by this API, see the\n[reference page](/storage/docs/json_api/v1/status-codes).\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]