Claude Platform Docs

新增聯合規則工作區

organization.federation.rules.workspaces.add(federation_rule_id, **kwargs) -> FederationRuleWorkspace
POST/v1/organizations/federation_rules/{federation_rule_id}/workspaces

需要具有 org:admin 範圍的 OAuth 存取權杖,可透過 ant auth login --scope org:admin 或工作負載身分聯合(workload identity federation)規則取得;不接受 Admin API 金鑰。請參閱使用 Admin API 管理 WIF。

為工作區啟用聯合規則。

此操作具冪等性;重複啟用會傳回現有的啟用設定。規則與工作區都必須屬於您的組織。啟用時不會檢查規則的目標服務帳戶是否為此工作區的成員:除非目標是成員,否則交換至此工作區的權杖會被拒絕(目標隱含為預設工作區的成員)。已封存的規則會以 400 拒絕。OAuth 呼叫者只能管理 oauth_scope 為 workspace:developer 或 workspace:inference 的規則;其他範圍需要 Console 工作階段。

Parameters
federation_rule_id: str⁠Path parameter

ID of the federation rule.

workspace_id: str

Tagged ID of the workspace to enable this rule for.

Returns
class FederationRuleWorkspace: type: "federation_rule_workspace"; created_at; created_by_actor_id; ... # 3 more
type: Literal["federation_rule_workspace"]
defaultfederation_rule_workspace
created_at: datetime

When this workspace was enabled for the rule.

formatdate-time
created_by_actor_id: Optional[str]

Tagged ID (user_... or svac_...) of the actor that enabled this workspace for the rule, if known.

federation_rule_id: str

Tagged ID of the federation rule.

workspace_id: str

Tagged ID of the workspace this rule is enabled for.

workspace_name: Optional[str]

Workspace display name. Populated when listing; null in the enable response.

新增聯合規則工作區
import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ.get(
        "ANTHROPIC_API_KEY"
    ),  # This is the default and can be omitted
)
federation_rule_workspace = client.organization.federation.rules.workspaces.add(
    federation_rule_id="federation_rule_id",
    workspace_id="workspace_id",
)
print(federation_rule_workspace.created_by_actor_id)
Returns Examples
Response 200
{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "created_by_actor_id": "created_by_actor_id",
  "federation_rule_id": "federation_rule_id",
  "type": "federation_rule_workspace",
  "workspace_id": "workspace_id",
  "workspace_name": "workspace_name"
}