Required. The name of the principal access boundary policy. Format: organizations/{organizationId}/locations/{location}/principalAccessBoundaryPolicies/{principalAccessBoundaryPolicyId}
Query parameters
Parameters
pageSize
integer
Optional. The maximum number of policy bindings to return. The service may return fewer than this value.
If unspecified, at most 50 policy bindings will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
pageToken
string
Optional. A page token, received from a previous SearchPrincipalAccessBoundaryPolicyBindingsRequest call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to SearchPrincipalAccessBoundaryPolicyBindingsRequest must match the call that provided the page token.
Request body
The request body must be empty.
Response body
Response message for principalAccessBoundaryPolicies.searchPolicyBindings rpc.
If successful, the response body contains data with the following structure:
[[["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-05-21 UTC."],[[["\u003cp\u003eThis endpoint retrieves policy bindings associated with a specific principal access boundary policy, provided the user has the necessary \u003ccode\u003esearchPolicyBindings\u003c/code\u003e permission.\u003c/p\u003e\n"],["\u003cp\u003eThe request is a \u003ccode\u003eGET\u003c/code\u003e method using a URL with gRPC Transcoding syntax, including a required \u003ccode\u003ename\u003c/code\u003e path parameter specifying the principal access boundary policy.\u003c/p\u003e\n"],["\u003cp\u003eOptional \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters are available to manage pagination, with a default of 50 policy bindings returned and a maximum of 1000.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the response includes a list of \u003ccode\u003epolicyBindings\u003c/code\u003e and an optional \u003ccode\u003enextPageToken\u003c/code\u003e for subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003eiam.principalaccessboundarypolicies.searchPolicyBindings\u003c/code\u003e IAM permission.\u003c/p\u003e\n"]]],[],null,["# Method: organizations.locations.principalAccessBoundaryPolicies.searchPolicyBindings\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SearchPrincipalAccessBoundaryPolicyBindingsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nReturns all policy bindings that bind a specific policy if a user has searchPolicyBindings permission on that policy.\n\n### HTTP request\n\n`GET https://iam.googleapis.com/v3beta/{name=organizations/*/locations/*/principalAccessBoundaryPolicies/*}:searchPolicyBindings`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for principalAccessBoundaryPolicies.searchPolicyBindings rpc.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `iam.principalaccessboundarypolicies.searchPolicyBindings`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]