Claude Platform Docs

取得 RBAC 角色

beta.organization.rbac_roles.retrieve(rbac_role_id) -> BetaRBACRole
GET/v1/organizations/rbac_roles/{rbac_role_id}

依 ID 擷取 RBAC 角色。

RBAC 角色 API 僅供 Claude Enterprise 組織使用。

Parameters
rbac_role_id: str⁠Path parameter

ID of the RBAC Role.

Returns
class BetaRBACRole: type: "rbac_role"; id; created_at; ... # 3 more
type: Literal["rbac_role"]

Object type.

For RBAC Roles, this is always "rbac_role".

defaultrbac_role
id: str

ID of the RBAC Role.

created_at: datetime

RFC 3339 datetime string indicating when the RBAC Role was created.

formatdate-time
display_name: str

Name of the RBAC Role. For a role created by Anthropic, this name can differ from the label claude.ai shows, and Anthropic may change the name. To keep a lasting reference to a role, store its id.

updated_at: datetime

RFC 3339 datetime string indicating when the RBAC Role was last updated.

formatdate-time
name: str⁠Deprecated

Deprecated: use display_name instead. Name of the RBAC Role; always the same value as display_name.

Use `display_name` instead; `name` always has the same value.
取得 RBAC 角色
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
beta_rbac_role = client.beta.organization.rbac_roles.retrieve(
    "rbac_role_id",
)
print(beta_rbac_role.id)
Returns Examples
Response 200
{
  "id": "rbac_role_016J8xVtKpDq3Wy9ZmN2hR4s",
  "created_at": "2024-10-30T23:58:27.427722Z",
  "display_name": "Project Editor",
  "name": "Project Editor",
  "type": "rbac_role",
  "updated_at": "2024-10-30T23:58:27.427722Z"
}