Skip to main content
GET
Retrieve policy binding details

Authorizations

Authorization
string
header
required

Bearer token authentication using OAuth2/OIDC tokens

Path Parameters

id
string
required

Unique policy binding identifier

Response

Policy binding details

IAM policy binding (role binding to principal at scope).

uid
string<uuid>
required
read-only

Server-generated UUID.

id
string
required

Resource identifier. Provided by the client at creation or server-generated if omitted. Must be 1-63 lowercase characters matching a-z [blocked]?. Immutable after creation.

Required string length: 1 - 63
Pattern: ^[a-z]([-a-z0-9]*[a-z0-9])?$
Example:

"policy-g8h9i1"

role
string
required

Role identifier

principal
object
required

User, group, or service account to bind role to

scope
object
required

Scope of the role binding

createdAt
string<date-time>
required
read-only

Policy binding creation timestamp

Server-defined URL for this resource.

Example:

"/v1/regions/global/iam/policies/policy-g8h9i1"

displayName
string

Optional human-readable name for the policy binding.

Maximum string length: 255
description
string

Optional explanation of why this binding exists.

Maximum string length: 1024
updatedAt
string<date-time>
read-only

Policy binding last update timestamp