APapicurio
Admin

Return a single role mapping

Changed on

Gets the details of a single role mapping (by principalId).

This operation can fail for the following reasons:

  • No role mapping for the principalId exists (HTTP error 404)
  • A server error occurred (HTTP error 500)
get/admin/roleMappings/{principalId}

Request

  • The document declares no server URL.
  • Auth
    none declared

Response

When successful, returns the details of a role mapping.

principalIdstring required
role'READ_ONLY' | 'DEVELOPER' | 'ADMIN' required
principalNamestring

A friendly name for the principal.

Example response

{
  "principalId": "svc_account_84874587_123484",
  "principalName": "famartin-svc-account",
  "role": "READ_ONLY"
}

Changes