REST Resource: permissions

  • Permissions define access levels (OWNER, READER, WRITER) for users, groups, or service accounts associated with an issuer ID.

  • Permissions can be managed through the get and update methods to retrieve and modify access rights.

  • Permissions are structured with an issuer ID and an array of individual permissions, each specifying an email address and a role.

  • The Permissions resource provides a comprehensive list of permissions for a given issuer, enabling centralized access control.

Resource: Permissions

JSON representation 
{
  "issuerId": string,
  "permissions": [
    {
      object (Permission)
    }
  ]
}
Fields
issuerId

string (int64 format)

ID of the issuer the list of permissions refer to.
permissions[]

object (Permission)

The complete list of permissions for the issuer account.

Permission

JSON representation 
{
  "emailAddress": string,
  "role": enum (Role)
}
Fields
emailAddress

string

The email address of the user, group, or service account to which this permission refers to.
role

enum (Role)

The role granted by this permission.

Role

Enums
ROLE_UNSPECIFIED
OWNER
owner

Legacy alias for OWNER. Deprecated.
READER
reader

Legacy alias for READER. Deprecated.
WRITER
writer

Legacy alias for WRITER. Deprecated.

Methods

get

 Returns the permissions for the given issuer id.

update

 Updates the permissions for the given issuer.