Referência de ações do IAM para controlar o acesso ao Claude Platform on AWS por meio de políticas da AWS.
O Claude Platform on AWS usa o AWS IAM para controle de acesso. Cada rota da API é mapeada para uma ação do IAM no namespace aws-external-anthropic. Esta página lista todas as ações, as rotas que cada ação autoriza e as políticas gerenciadas disponíveis para padrões de acesso comuns. Para configuração da plataforma e autenticação, consulte Claude Platform on AWS.
A região do ARN é sempre preenchida e corresponde à região à qual o workspace está vinculado. O segmento de recurso é o ID do workspace com tag (wrkspc_...), o mesmo valor que você passa no cabeçalho anthropic-workspace-id.
Ações
As ações seguem a convenção VerbNoun da AWS e usam disciplina de verbos para que os "wildcards" (curingas) Get* e List* produzam um limite somente leitura bem definido.
Inferência
Ação
Rotas autorizadas
CreateInference
POST /v1/messages
CountTokens
POST /v1/messages/count_tokens
Processamento em lote
Ação
Rotas autorizadas
CreateBatchInference
POST /v1/messages/batches
GetBatchInference
GET /v1/messages/batches/{id} GET /v1/messages/batches/{id}/results
ListBatchInferences
GET /v1/messages/batches
CancelBatchInference
POST /v1/messages/batches/{id}/cancel
DeleteBatchInference
DELETE /v1/messages/batches/{id}
Modelos
Ação
Rotas autorizadas
GetModel
GET /v1/models/{id}
ListModels
GET /v1/models
Arquivos
Ação
Rotas autorizadas
CreateFile
POST /v1/files
GetFile
GET /v1/files/{id} GET /v1/files/{id}/content
ListFiles
GET /v1/files
DeleteFile
DELETE /v1/files/{id}
Skills
Ação
Rotas autorizadas
CreateSkill
POST /v1/skills
GetSkill
GET /v1/skills/{id} GET /v1/skills/{id}/versions GET /v1/skills/{id}/versions/{version} GET /v1/skills/{id}/versions/{version}/content
ListSkills
GET /v1/skills
UpdateSkill
POST /v1/skills/{id}/versions DELETE /v1/skills/{id}/versions/{version}
DeleteSkill
DELETE /v1/skills/{id}
Agentes
Ação
Rotas autorizadas
CreateAgent
POST /v1/agents
GetAgent
GET /v1/agents/{id} GET /v1/agents/{id}/versions
ListAgents
GET /v1/agents
UpdateAgent
POST /v1/agents/{id}
ArchiveAgent
POST /v1/agents/{id}/archive
Sessões
Ação
Rotas autorizadas
CreateSession
POST /v1/sessions
GetSession
GET /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}
ListSessions
GET /v1/sessions
UpdateSession
POST /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}
ArchiveSession
POST /v1/sessions/{id}/archive
DeleteSession
DELETE /v1/sessions/{id}
Ambientes
Ação
Rotas autorizadas
CreateEnvironment
POST /v1/environments
GetEnvironment
GET /v1/environments/{id} GET /v1/environments/{id}/work GET /v1/environments/{id}/work/{work_id} GET /v1/environments/{id}/work/stats
ListEnvironments
GET /v1/environments
UpdateEnvironment
POST /v1/environments/{id}
ArchiveEnvironment
POST /v1/environments/{id}/archive
DeleteEnvironment
DELETE /v1/environments/{id}
ProcessEnvironmentWork
GET /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
Ação
Rotas autorizadas
CreateVault
POST /v1/vaults
GetVault
GET /v1/vaults/{id} GET /v1/vaults/{id}/credentials GET /v1/vaults/{id}/credentials/{id}
ListVaults
GET /v1/vaults
UpdateVault
POST /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}
ArchiveVault
POST /v1/vaults/{id}/archive
DeleteVault
DELETE /v1/vaults/{id}
Memory stores
Ação
Rotas autorizadas
CreateMemoryStore
POST /v1/memory_stores
GetMemoryStore
GET /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}
ListMemoryStores
GET /v1/memory_stores
UpdateMemoryStore
POST /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
ArchiveMemoryStore
POST /v1/memory_stores/{id}/archive
DeleteMemoryStore
DELETE /v1/memory_stores/{id}
Webhooks
Ação
Rotas autorizadas
CreateWebhook
POST /v1/webhooks
GetWebhook
GET /v1/webhooks/{id}
ListWebhooks
GET /v1/webhooks
UpdateWebhook
POST /v1/webhooks/{id}
DeleteWebhook
DELETE /v1/webhooks/{id}
RotateWebhookSecret
POST /v1/webhooks/{id}/regenerate_signing_secret
Perfis de usuário
Ação
Rotas autorizadas
CreateUserProfile
POST /v1/user_profiles
GetUserProfile
GET /v1/user_profiles/{id}
ListUserProfiles
GET /v1/user_profiles
UpdateUserProfile
POST /v1/user_profiles/{id}
CreateUserProfileEnrollmentUrl
POST /v1/user_profiles/{id}/enrollment_url
Workspaces
Ação
Rotas autorizadas
CreateWorkspace
POST /v1/organizations/workspaces
GetWorkspace
GET /v1/organizations/workspaces/{id}
ListWorkspaces
GET /v1/organizations/workspaces
UpdateWorkspace
POST /v1/organizations/workspaces/{id}
ArchiveWorkspace
POST /v1/organizations/workspaces/{id}/archive
Chaves de criptografia
Ação
Rotas autorizadas
RegisterKey
POST /v1/organizations/external_keys
GetKey
GET /v1/organizations/external_keys/{id}
ListKeys
GET /v1/organizations/external_keys
UpdateKey
POST /v1/organizations/external_keys/{id}
DisableKey
DELETE /v1/organizations/external_keys/{id}
Conformidade
Ação
Rotas autorizadas
ListComplianceActivities
GET /v1/compliance/activities
Destinos de telemetria
Ação
Rotas autorizadas
CreateAccountTelemetryDestination
POST /v1/organizations/telemetry_destinations
GetAccountTelemetryDestination
GET /v1/organizations/telemetry_destinations/{id}
ListAccountTelemetryDestinations
GET /v1/organizations/telemetry_destinations
UpdateAccountTelemetryDestination
POST /v1/organizations/telemetry_destinations/{id}
CallWithBearerToken é uma permissão da camada de autenticação que autoriza um principal a se autenticar por meio de uma chave de API (bearer token) em vez do AWS SigV4. Ela não é mapeada para uma rota. Conceda-a junto com as ações mapeadas para rotas que você deseja que o detentor da chave de API execute.
Acesso ao Console
Ação
Rotas autorizadas
AssumeConsole
(nenhuma)
AssumeConsole autoriza um principal a abrir o Claude Console para um workspace do Claude Platform on AWS por meio do fluxo de federação do AWS Console. Ela não é mapeada para uma rota. Conceda-a a principals que devem poder clicar em Open Claude Console na página de serviço do Claude Platform on AWS no AWS Console. A função do Claude Console (Admin ou Developer) é atribuída separadamente pelo seu representante de conta da Anthropic; ela não é derivada das permissões do IAM do principal. Consulte Usando o Claude Console para o fluxo de login e as descrições das funções.
Mapeamento de rota para ação
A tabela a seguir lista todas as rotas do Claude Platform on AWS e a ação do IAM necessária para chamá-las. Cada ação do IAM também autoriza requisições que usam o cabeçalho anthropic-beta; variantes beta de uma rota não exigem uma ação do IAM separada. O CloudTrail classifica cada ação como um evento de Dados (operações de plano de dados de alto volume) ou um evento de Gerenciamento (operações de plano de controle). As ações de vault e webhook são classificadas como eventos de Gerenciamento porque armazenam segredos (credenciais de vault e segredos de assinatura de webhook) e se beneficiam do log de auditoria ativado por padrão. As ações de workspace, chave externa, destino de telemetria e conformidade também são classificadas como eventos de Gerenciamento porque são operações de plano de controle com escopo de organização. Todas as outras ações, incluindo inferência, lote, modelo, arquivo, skill, perfil de usuário e as demais ações do Claude Managed Agents, são classificadas como eventos de Dados.
Todas as ações de AnthropicInferenceAccess, mais todas as ações do Claude Managed Agents (agentes, sessões, ambientes, vaults, memory stores, webhooks e trabalho de ambiente auto-hospedado)
AnthropicInferenceAccess é a política gerenciada mais restrita suficiente para executar inferência. Ela cobre tanto inferência síncrona quanto em lote e, por meio dos curingas Get* e List*, concede acesso de leitura a todos os recursos da API no namespace, incluindo recursos do Claude Managed Agents (CMA) (agentes, sessões, ambientes, vaults, memory stores e webhooks). Isso inclui o download de conteúdo de arquivos por meio de GetFile (consulte a nota de Arquivos), o download de conteúdo de skills por meio de GetSkill (consulte a nota de Skills) e o conteúdo de memórias por meio de GetMemoryStore. Os segredos de credenciais de vault e os segredos de assinatura de webhook não são expostos: esses campos são somente gravação e nunca são retornados por GetVault ou GetWebhook (consulte Autenticar com vaults). AnthropicInferenceAccess não concede criação ou exclusão de arquivos, gerenciamento de skills, gerenciamento de perfis de usuário, mutação de workspace, gerenciamento de chaves de criptografia, gerenciamento de destinos de telemetria nem qualquer ação de gravação do Claude Managed Agents (criar, atualizar, arquivar, excluir, processar ou rotacionar). Para excluir leituras de CMA, substitua AnthropicInferenceAccess por uma política personalizada que enumere apenas as ações específicas não relacionadas a CMA de que você precisa.
AnthropicLimitedAccess inclui todas as ações do Claude Managed Agents além das ações de inferência.
AnthropicSelfHostedEnvironmentAccess é a política gerenciada mais restrita suficiente para executar um worker de sandbox auto-hospedado. Anexe-a ao principal com o qual seu worker de ambiente se autentica.
AssumeConsole não está incluída em AnthropicReadOnlyAccess, AnthropicInferenceAccess, AnthropicLimitedAccess ou AnthropicSelfHostedEnvironmentAccess. Principals que precisam de acesso ao Claude Console exigem AnthropicFullAccess ou uma política personalizada que conceda aws-external-anthropic:AssumeConsole. Consulte Acesso ao Console.
Exemplos de políticas
Inferência síncrona em um único workspace
Concede as permissões mínimas para um principal do IAM que executa inferência em um workspace de produção:
Bloqueio de recursos para um workspace sensível a ZDR
Bloqueia o processamento em lote e o upload de arquivos em um workspace específico, mantendo a inferência síncrona disponível. Útil quando um workspace lida com dados de Zero Data Retention (ZDR) que não devem persistir no lado do servidor. Anexe esta política junto com uma política Allow, como AnthropicInferenceAccess ou o exemplo de workspace único; sozinha, uma política somente de Deny não concede nenhuma permissão: