Method: policies.test

  • Tests user permissions on a specified resource using a POST request.

  • The request body includes the resource and desired permissions to check.

  • The response body returns the allowed permissions for the caller on that resource.

  • Authorization requires the https://www.googleapis.com/auth/userinfo.email scope.

Returns permissions that a caller has on the specified resource.

HTTP request

POST https://sasportal.googleapis.com/v1alpha1/policies:test

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "resource": string,
  "permissions": [
    string
  ]
}
Fields
resource

string

Required. The resource for which the permissions are being requested.

permissions[]

string

The set of permissions to check for the resource.

Response body

If successful, the response body contains data with the following structure:

Response message for policies.test method.

JSON representation 
{
  "permissions": [
    string
  ]
}
Fields
permissions[]

string

A set of permissions that the caller is allowed.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/userinfo.email