Claude Platform Docs
API 參考支援與設定

Claude Platform on AWS 的 IAM 動作

透過 AWS 政策控制 Claude Platform on AWS 存取權限的 IAM 動作參考。

Claude Platform on AWS 使用 AWS IAM 進行存取控制。每個 API 路由都對應到 aws-external-anthropic 命名空間中的一個 IAM 動作。本頁列出所有動作、每個動作所授權的路由,以及適用於常見存取模式的受管政策(managed policies)。如需平台設定與驗證的相關資訊,請參閱 Claude Platform on AWS

服務詳細資訊

屬性
IAM 服務前綴aws-external-anthropic
資源類型workspace

Workspace ARN 格式:

arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}

ARN 的區域欄位一律會填入,且與該 workspace 所綁定的區域相符。資源區段為帶標籤的 workspace ID(wrkspc_...),與您在 anthropic-workspace-id 標頭中傳入的值相同。

動作

此服務定義了 71 個動作。動作遵循 AWS 的 VerbNoun 慣例並採用動詞規範,使 Get*List* 萬用字元能產生清晰的唯讀邊界。

推論

動作授權的路由
CreateInferencePOST /v1/messages
CountTokensPOST /v1/messages/count_tokens

批次處理

動作授權的路由
CreateBatchInferencePOST /v1/messages/batches
GetBatchInferenceGET /v1/messages/batches/{id}
GET /v1/messages/batches/{id}/results
ListBatchInferencesGET /v1/messages/batches
CancelBatchInferencePOST /v1/messages/batches/{id}/cancel
DeleteBatchInferenceDELETE /v1/messages/batches/{id}

模型

動作授權的路由
GetModelGET /v1/models/{id}
ListModelsGET /v1/models

檔案

動作授權的路由
CreateFilePOST /v1/files
GetFileGET /v1/files/{id}
GET /v1/files/{id}/content
ListFilesGET /v1/files
DeleteFileDELETE /v1/files/{id}

Skills

動作授權的路由
CreateSkillPOST /v1/skills
GetSkillGET /v1/skills/{id}
GET /v1/skills/{id}/versions
GET /v1/skills/{id}/versions/{version}
GET /v1/skills/{id}/versions/{version}/content
ListSkillsGET /v1/skills
UpdateSkillPOST /v1/skills/{id}/versions
DELETE /v1/skills/{id}/versions/{version}
DeleteSkillDELETE /v1/skills/{id}

Agents

動作授權的路由
CreateAgentPOST /v1/agents
GetAgentGET /v1/agents/{id}
GET /v1/agents/{id}/versions
ListAgentsGET /v1/agents
UpdateAgentPOST /v1/agents/{id}
ArchiveAgentPOST /v1/agents/{id}/archive

Sessions

動作授權的路由
CreateSessionPOST /v1/sessions
GetSessionGET /v1/sessions/{id}
GET /v1/sessions/{id}/events
GET /v1/sessions/{id}/events/stream
GET /v1/sessions/{id}/resources
GET /v1/sessions/{id}/resources/{id}
ListSessionsGET /v1/sessions
UpdateSessionPOST /v1/sessions/{id}
POST /v1/sessions/{id}/events
POST /v1/sessions/{id}/resources
POST /v1/sessions/{id}/resources/{id}
DELETE /v1/sessions/{id}/resources/{id}
ArchiveSessionPOST /v1/sessions/{id}/archive
DeleteSessionDELETE /v1/sessions/{id}

Environments

動作授權的路由
CreateEnvironmentPOST /v1/environments
GetEnvironmentGET /v1/environments/{id}
GET /v1/environments/{id}/work
GET /v1/environments/{id}/work/{work_id}
GET /v1/environments/{id}/work/stats
ListEnvironmentsGET /v1/environments
UpdateEnvironmentPOST /v1/environments/{id}
ArchiveEnvironmentPOST /v1/environments/{id}/archive
DeleteEnvironmentDELETE /v1/environments/{id}
ProcessEnvironmentWorkGET /v1/environments/{id}/work/poll
POST /v1/environments/{id}/work/{work_id}
POST /v1/environments/{id}/work/{work_id}/ack
POST /v1/environments/{id}/work/{work_id}/heartbeat
POST /v1/environments/{id}/work/{work_id}/stop

Vaults

動作授權的路由
CreateVaultPOST /v1/vaults
GetVaultGET /v1/vaults/{id}
GET /v1/vaults/{id}/credentials
GET /v1/vaults/{id}/credentials/{id}
ListVaultsGET /v1/vaults
UpdateVaultPOST /v1/vaults/{id}
POST /v1/vaults/{id}/credentials
POST /v1/vaults/{id}/credentials/{id}
POST /v1/vaults/{id}/credentials/{id}/archive
DELETE /v1/vaults/{id}/credentials/{id}
ArchiveVaultPOST /v1/vaults/{id}/archive
DeleteVaultDELETE /v1/vaults/{id}

Memory stores

動作授權的路由
CreateMemoryStorePOST /v1/memory_stores
GetMemoryStoreGET /v1/memory_stores/{id}
GET /v1/memory_stores/{id}/memories
GET /v1/memory_stores/{id}/memories/{id}
GET /v1/memory_stores/{id}/memory_versions
GET /v1/memory_stores/{id}/memory_versions/{id}
ListMemoryStoresGET /v1/memory_stores
UpdateMemoryStorePOST /v1/memory_stores/{id}
POST /v1/memory_stores/{id}/memories
POST /v1/memory_stores/{id}/memories/{id}
DELETE /v1/memory_stores/{id}/memories/{id}
POST /v1/memory_stores/{id}/memory_versions/{id}/redact
ArchiveMemoryStorePOST /v1/memory_stores/{id}/archive
DeleteMemoryStoreDELETE /v1/memory_stores/{id}

Webhooks

動作授權的路由
CreateWebhookPOST /v1/webhooks
GetWebhookGET /v1/webhooks/{id}
ListWebhooksGET /v1/webhooks
UpdateWebhookPOST /v1/webhooks/{id}
DeleteWebhookDELETE /v1/webhooks/{id}
RotateWebhookSecretPOST /v1/webhooks/{id}/regenerate_signing_secret

使用者設定檔

動作授權的路由
CreateUserProfilePOST /v1/user_profiles
GetUserProfileGET /v1/user_profiles/{id}
ListUserProfilesGET /v1/user_profiles
UpdateUserProfilePOST /v1/user_profiles/{id}

Workspaces

動作授權的路由
CreateWorkspacePOST /v1/organizations/workspaces
GetWorkspaceGET /v1/organizations/workspaces/{id}
ListWorkspacesGET /v1/organizations/workspaces
UpdateWorkspacePOST /v1/organizations/workspaces/{id}
ArchiveWorkspacePOST /v1/organizations/workspaces/{id}/archive

加密金鑰

動作授權的路由
RegisterKeyPOST /v1/organizations/external_keys
GetKeyGET /v1/organizations/external_keys/{id}
ListKeysGET /v1/organizations/external_keys
UpdateKeyPOST /v1/organizations/external_keys/{id}
DisableKeyDELETE /v1/organizations/external_keys/{id}

合規

動作授權的路由
ListComplianceActivitiesGET /v1/compliance/activities

驗證

動作授權的路由
CallWithBearerToken(無)

CallWithBearerToken 是驗證層的權限,授權主體透過 API 金鑰(bearer token)而非 AWS SigV4 進行驗證。它不對應到任何路由。請將其與您希望 API 金鑰持有者能執行的路由對應動作一併授予。

Console 存取

動作授權的路由
AssumeConsole(無)

AssumeConsole 授權主體透過 AWS Console 聯合流程,為 Claude Platform on AWS workspace 開啟 Claude Console。它不對應到任何路由。請將其授予應能在 AWS Console 的 Claude Platform on AWS 服務頁面上點擊 Open Claude Console 的主體。Claude Console 角色(Admin 或 Developer)由您的 Anthropic 帳戶代表另行指派;並非由主體的 IAM 權限推導而來。如需登入流程與角色說明,請參閱使用 Claude Console

路由對動作對應

下表列出 Claude Platform on AWS 上的每個路由,以及呼叫該路由所需的 IAM 動作。每個 IAM 動作也授權使用 anthropic-beta 標頭的請求;路由的 beta 變體不需要另外的 IAM 動作。CloudTrail 將每個動作分類為 Data 事件(高流量的資料平面操作)或 Management 事件(控制平面操作)。Vault 與 webhook 動作被分類為 Management 事件,因為它們持有密鑰(vault 憑證與 webhook 簽署密鑰),並受益於預設開啟的稽核記錄。Workspace、外部金鑰與合規動作也被分類為 Management 事件,因為它們是組織範圍的控制平面操作。所有其他動作,包括推論、批次、模型、檔案、skill、使用者設定檔以及其餘的 Claude Managed Agents 動作,皆被分類為 Data 事件。

方法路由IAM 動作CloudTrail 事件類型
POST/v1/messagesCreateInferenceData
POST/v1/messages/count_tokensCountTokensData
POST/v1/messages/batchesCreateBatchInferenceData
GET/v1/messages/batchesListBatchInferencesData
GET/v1/messages/batches/{id}GetBatchInferenceData
GET/v1/messages/batches/{id}/resultsGetBatchInferenceData
POST/v1/messages/batches/{id}/cancelCancelBatchInferenceData
DELETE/v1/messages/batches/{id}DeleteBatchInferenceData
GET/v1/modelsListModelsData
GET/v1/models/{id}GetModelData
POST/v1/filesCreateFileData
GET/v1/filesListFilesData
GET/v1/files/{id}GetFileData
GET/v1/files/{id}/contentGetFileData
DELETE/v1/files/{id}DeleteFileData
POST/v1/skillsCreateSkillData
GET/v1/skillsListSkillsData
GET/v1/skills/{id}GetSkillData
DELETE/v1/skills/{id}DeleteSkillData
POST/v1/skills/{id}/versionsUpdateSkillData
GET/v1/skills/{id}/versionsGetSkillData
GET/v1/skills/{id}/versions/{version}GetSkillData
GET/v1/skills/{id}/versions/{version}/contentGetSkillData
DELETE/v1/skills/{id}/versions/{version}UpdateSkillData
POST/v1/user_profilesCreateUserProfileData
GET/v1/user_profilesListUserProfilesData
GET/v1/user_profiles/{id}GetUserProfileData
POST/v1/user_profiles/{id}UpdateUserProfileData
POST/v1/organizations/workspacesCreateWorkspaceManagement
GET/v1/organizations/workspacesListWorkspacesManagement
GET/v1/organizations/workspaces/{id}GetWorkspaceManagement
POST/v1/organizations/workspaces/{id}UpdateWorkspaceManagement
POST/v1/organizations/workspaces/{id}/archiveArchiveWorkspaceManagement
POST/v1/organizations/external_keysRegisterKeyManagement
GET/v1/organizations/external_keysListKeysManagement
GET/v1/organizations/external_keys/{id}GetKeyManagement
POST/v1/organizations/external_keys/{id}UpdateKeyManagement
DELETE/v1/organizations/external_keys/{id}DisableKeyManagement
GET/v1/compliance/activitiesListComplianceActivitiesManagement
POST/v1/agentsCreateAgentData
GET/v1/agentsListAgentsData
GET/v1/agents/{id}GetAgentData
POST/v1/agents/{id}UpdateAgentData
POST/v1/agents/{id}/archiveArchiveAgentData
GET/v1/agents/{id}/versionsGetAgentData
POST/v1/sessionsCreateSessionData
GET/v1/sessionsListSessionsData
GET/v1/sessions/{id}GetSessionData
POST/v1/sessions/{id}UpdateSessionData
POST/v1/sessions/{id}/archiveArchiveSessionData
DELETE/v1/sessions/{id}DeleteSessionData
GET/v1/sessions/{id}/eventsGetSessionData
POST/v1/sessions/{id}/eventsUpdateSessionData
GET/v1/sessions/{id}/events/streamGetSessionData
GET/v1/sessions/{id}/resourcesGetSessionData
GET/v1/sessions/{id}/resources/{id}GetSessionData
POST/v1/sessions/{id}/resourcesUpdateSessionData
POST/v1/sessions/{id}/resources/{id}UpdateSessionData
DELETE/v1/sessions/{id}/resources/{id}UpdateSessionData
POST/v1/environmentsCreateEnvironmentData
GET/v1/environmentsListEnvironmentsData
GET/v1/environments/{id}GetEnvironmentData
POST/v1/environments/{id}UpdateEnvironmentData
POST/v1/environments/{id}/archiveArchiveEnvironmentData
DELETE/v1/environments/{id}DeleteEnvironmentData
GET/v1/environments/{id}/workGetEnvironmentData
GET/v1/environments/{id}/work/pollProcessEnvironmentWorkData
GET/v1/environments/{id}/work/{work_id}GetEnvironmentData
GET/v1/environments/{id}/work/statsGetEnvironmentData
POST/v1/environments/{id}/work/{work_id}ProcessEnvironmentWorkData
POST/v1/environments/{id}/work/{work_id}/ackProcessEnvironmentWorkData
POST/v1/environments/{id}/work/{work_id}/heartbeatProcessEnvironmentWorkData
POST/v1/environments/{id}/work/{work_id}/stopProcessEnvironmentWorkData
POST/v1/vaultsCreateVaultManagement
GET/v1/vaultsListVaultsManagement
GET/v1/vaults/{id}GetVaultManagement
POST/v1/vaults/{id}UpdateVaultManagement
POST/v1/vaults/{id}/archiveArchiveVaultManagement
DELETE/v1/vaults/{id}DeleteVaultManagement
GET/v1/vaults/{id}/credentialsGetVaultManagement
POST/v1/vaults/{id}/credentialsUpdateVaultManagement
GET/v1/vaults/{id}/credentials/{id}GetVaultManagement
POST/v1/vaults/{id}/credentials/{id}UpdateVaultManagement
POST/v1/vaults/{id}/credentials/{id}/archiveUpdateVaultManagement
DELETE/v1/vaults/{id}/credentials/{id}UpdateVaultManagement
POST/v1/memory_storesCreateMemoryStoreData
GET/v1/memory_storesListMemoryStoresData
GET/v1/memory_stores/{id}GetMemoryStoreData
POST/v1/memory_stores/{id}UpdateMemoryStoreData
POST/v1/memory_stores/{id}/archiveArchiveMemoryStoreData
DELETE/v1/memory_stores/{id}DeleteMemoryStoreData
POST/v1/memory_stores/{id}/memoriesUpdateMemoryStoreData
GET/v1/memory_stores/{id}/memoriesGetMemoryStoreData
GET/v1/memory_stores/{id}/memories/{id}GetMemoryStoreData
POST/v1/memory_stores/{id}/memories/{id}UpdateMemoryStoreData
DELETE/v1/memory_stores/{id}/memories/{id}UpdateMemoryStoreData
GET/v1/memory_stores/{id}/memory_versionsGetMemoryStoreData
GET/v1/memory_stores/{id}/memory_versions/{id}GetMemoryStoreData
POST/v1/memory_stores/{id}/memory_versions/{id}/redactUpdateMemoryStoreData
GET/v1/webhooksListWebhooksManagement
GET/v1/webhooks/{id}GetWebhookManagement
POST/v1/webhooksCreateWebhookManagement
POST/v1/webhooks/{id}UpdateWebhookManagement
DELETE/v1/webhooks/{id}DeleteWebhookManagement
POST/v1/webhooks/{id}/regenerate_signing_secretRotateWebhookSecretManagement

不在此表格中的路由在 Claude Platform on AWS 上不可用。閘道預設會拒絕任何未列於此處的路由。

受管政策

AWS 為 Claude Platform on AWS 提供五個受管政策。所有受管政策皆套用於 Resource: "*"

政策授予
AnthropicFullAccessaws-external-anthropic:*
AnthropicReadOnlyAccessGet*List*CallWithBearerToken
AnthropicInferenceAccessGet*List*CreateInferenceCreateBatchInferenceCancelBatchInferenceDeleteBatchInferenceCountTokensCallWithBearerToken
AnthropicLimitedAccess所有 AnthropicInferenceAccess 動作,加上所有 Claude Managed Agents 動作(agents、sessions、environments、vaults、memory stores、webhooks 以及自行託管 environment 工作)
AnthropicSelfHostedEnvironmentAccessGetEnvironmentProcessEnvironmentWorkGetSessionUpdateSessionGetSkillCallWithBearerToken

AnthropicInferenceAccess 是足以執行推論的最窄受管政策。它涵蓋同步與批次推論,並透過 Get*List* 萬用字元授予對命名空間中每個 API 資源的讀取權限,包括 Claude Managed Agents(CMA)資源(agents、sessions、environments、vaults、memory stores 與 webhooks)。這包括透過 GetFile 下載檔案內容(請參閱檔案說明)、透過 GetSkill 下載 skill 內容(請參閱 Skills 說明),以及透過 GetMemoryStore 讀取記憶內容。Vault 憑證密鑰與 webhook 簽署密鑰不會外洩:這些欄位為唯寫,且 GetVaultGetWebhook 永遠不會回傳它們(請參閱使用 vaults 進行驗證)。AnthropicInferenceAccess 不授予檔案建立或刪除、skill 管理、使用者設定檔管理、workspace 變動、加密金鑰管理,或任何 Claude Managed Agents 寫入動作(建立、更新、封存、刪除、處理或輪替)。若要排除 CMA 讀取,請以僅列舉您所需特定非 CMA 動作的自訂政策取代 AnthropicInferenceAccess

AnthropicLimitedAccess 除了推論動作之外,還包含所有 Claude Managed Agents 動作。

AnthropicSelfHostedEnvironmentAccess 是足以執行自行託管沙箱工作程式的最窄受管政策。請將其附加到您的 environment 工作程式用以驗證的主體。

AssumeConsole 不包含在 AnthropicReadOnlyAccessAnthropicInferenceAccessAnthropicLimitedAccessAnthropicSelfHostedEnvironmentAccess 中。需要 Claude Console 存取權的主體需要 AnthropicFullAccess,或授予 aws-external-anthropic:AssumeConsole 的自訂政策。請參閱 Console 存取

範例政策

單一 workspace 上的同步推論

為針對單一正式環境 workspace 執行推論的 IAM 主體授予最小權限:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-external-anthropic:CreateInference",
        "aws-external-anthropic:CountTokens",
        "aws-external-anthropic:GetModel",
        "aws-external-anthropic:ListModels",
        "aws-external-anthropic:GetWorkspace"
      ],
      "Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj"
    }
  ]
}

每位客戶的 workspace 隔離

將角色限制於單一 workspace:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "aws-external-anthropic:*",
      "Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj"
    },
    {
      "Effect": "Allow",
      "Action": [
        "aws-external-anthropic:CallWithBearerToken",
        "aws-external-anthropic:AssumeConsole"
      ],
      "Resource": "*"
    }
  ]
}

針對 ZDR 敏感 workspace 的功能鎖定

在特定 workspace 上封鎖批次處理與檔案上傳,同時保留同步推論可用。當 workspace 處理不得在伺服器端保存的零資料保留(Zero Data Retention,ZDR)資料時非常有用。請將此政策與 Allow 政策(例如 AnthropicInferenceAccess單一 workspace 範例)一併附加;僅含 Deny 的政策本身不會授予任何權限:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Deny",
      "Action": [
        "aws-external-anthropic:CreateBatchInference",
        "aws-external-anthropic:CreateFile"
      ],
      "Resource": "arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj"
    }
  ]
}

佈建自動化

授予 CI/CD 角色建立與管理工作區所需的動作,而不包含任何推論權限:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-external-anthropic:CreateWorkspace",
        "aws-external-anthropic:GetWorkspace",
        "aws-external-anthropic:ListWorkspaces",
        "aws-external-anthropic:UpdateWorkspace",
        "aws-external-anthropic:ArchiveWorkspace"
      ],
      "Resource": "*"
    }
  ]
}

CreateWorkspaceListWorkspaces 是帳戶範圍的操作。在這些動作上指定工作區 ARN 不會產生任何效果;請使用 Resource: "*"

另請參閱

Was this page helpful?