Effective June 17, 2024, Cloud Source Repositories isn't available to new customers. If your organization hasn't previously used Cloud Source Repositories, you can't enable the API or use Cloud Source Repositories. New projects not connected to an organization can't enable the Cloud Source Repositories API. Organizations that have used Cloud Source Repositories prior to June 17, 2024 are not affected by this change.

Method: projects.repos.getIamPolicy

HTTP request
Path parameters
Query parameters
Request body
Response body
Authorization scopes
GetPolicyOptions
- JSON representation
Try it!

Gets the IAM policy policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

HTTP request

GET https://sourcerepo.googleapis.com/v1/{resource=projects/*/repos/**}:getIamPolicy

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters

Parameters
`resource`	`string` REQUIRED: The resource for which the policy is being requested. See Resource names for the appropriate value for this field.

resource

string

REQUIRED: The resource for which the policy is being requested. See Resource names for the appropriate value for this field.

Query parameters

Parameters

Parameters
`options`	`object (GetPolicyOptions)` OPTIONAL: A `GetPolicyOptions` object for specifying options to `repos.getIamPolicy`.

options

object (GetPolicyOptions)

OPTIONAL: A GetPolicyOptions object for specifying options to repos.getIamPolicy.

Request body

The request body must be empty.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.

GetPolicyOptions

Encapsulates settings provided to repos.getIamPolicy.

JSON representation
{ "requestedPolicyVersion": integer }

Fields

Fields
`requestedPolicyVersion`	`integer` Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the IAM documentation.

requestedPolicyVersion

integer

Optional. The maximum policy version that will be used to format the policy.

Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected.

Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset.

The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1.

To learn which resources support conditions in their IAM policies, see the IAM documentation.