Method: folders.locations.entitlements.grants.search

grants.search returns grants that are related to the calling user in the specified way.

HTTP request

GET https://privilegedaccessmanager.googleapis.com/v1/{parent=folders/*/locations/*/entitlements/*}/grants:search

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent which owns the grant resources.

Query parameters

Parameters
callerRelationship

enum (CallerRelationshipType)

Required. Only grants which the caller is related to by this relationship are returned in the response.

filter

string

Optional. Only grants matching this filter are returned in the response.

pageSize

integer

Optional. Requested page size. The server may return fewer items than requested. If unspecified, server picks an appropriate default.

pageToken

string

Optional. A token identifying a page of results the server should return.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of SearchGrantsResponse.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.