Claude Platform Docs
Referência da APISuporte e configuração

Ações do IAM para o Claude Platform on AWS

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.

Detalhes do serviço

AtributoValor
Prefixo de serviço do IAMaws-external-anthropic
Tipos de recursoworkspace

Formato do ARN de workspace:

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

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

O serviço define 71 ações. As ações seguem a convenção VerbNoun da AWS e usam disciplina de verbos para que os curingas Get* e List* produzam um limite somente leitura bem definido.

Inferência

AçãoRotas autorizadas
CreateInferencePOST /v1/messages
CountTokensPOST /v1/messages/count_tokens

Processamento em lote

AçãoRotas autorizadas
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}

Modelos

AçãoRotas autorizadas
GetModelGET /v1/models/{id}
ListModelsGET /v1/models

Arquivos

AçãoRotas autorizadas
CreateFilePOST /v1/files
GetFileGET /v1/files/{id}
GET /v1/files/{id}/content
ListFilesGET /v1/files
DeleteFileDELETE /v1/files/{id}

Skills

AçãoRotas autorizadas
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}

Agentes

AçãoRotas autorizadas
CreateAgentPOST /v1/agents
GetAgentGET /v1/agents/{id}
GET /v1/agents/{id}/versions
ListAgentsGET /v1/agents
UpdateAgentPOST /v1/agents/{id}
ArchiveAgentPOST /v1/agents/{id}/archive

Sessões

AçãoRotas autorizadas
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}

Ambientes

AçãoRotas autorizadas
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

AçãoRotas autorizadas
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

AçãoRotas autorizadas
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

AçãoRotas autorizadas
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

Perfis de usuário

AçãoRotas autorizadas
CreateUserProfilePOST /v1/user_profiles
GetUserProfileGET /v1/user_profiles/{id}
ListUserProfilesGET /v1/user_profiles
UpdateUserProfilePOST /v1/user_profiles/{id}

Workspaces

AçãoRotas autorizadas
CreateWorkspacePOST /v1/organizations/workspaces
GetWorkspaceGET /v1/organizations/workspaces/{id}
ListWorkspacesGET /v1/organizations/workspaces
UpdateWorkspacePOST /v1/organizations/workspaces/{id}
ArchiveWorkspacePOST /v1/organizations/workspaces/{id}/archive

Chaves de criptografia

AçãoRotas autorizadas
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}

Conformidade

AçãoRotas autorizadas
ListComplianceActivitiesGET /v1/compliance/activities

Autenticação

AçãoRotas autorizadas
CallWithBearerToken(nenhuma)

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çãoRotas 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 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.

MétodoRotaAção do IAMTipo de evento do CloudTrail
POST/v1/messagesCreateInferenceDados
POST/v1/messages/count_tokensCountTokensDados
POST/v1/messages/batchesCreateBatchInferenceDados
GET/v1/messages/batchesListBatchInferencesDados
GET/v1/messages/batches/{id}GetBatchInferenceDados
GET/v1/messages/batches/{id}/resultsGetBatchInferenceDados
POST/v1/messages/batches/{id}/cancelCancelBatchInferenceDados
DELETE/v1/messages/batches/{id}DeleteBatchInferenceDados
GET/v1/modelsListModelsDados
GET/v1/models/{id}GetModelDados
POST/v1/filesCreateFileDados
GET/v1/filesListFilesDados
GET/v1/files/{id}GetFileDados
GET/v1/files/{id}/contentGetFileDados
DELETE/v1/files/{id}DeleteFileDados
POST/v1/skillsCreateSkillDados
GET/v1/skillsListSkillsDados
GET/v1/skills/{id}GetSkillDados
DELETE/v1/skills/{id}DeleteSkillDados
POST/v1/skills/{id}/versionsUpdateSkillDados
GET/v1/skills/{id}/versionsGetSkillDados
GET/v1/skills/{id}/versions/{version}GetSkillDados
GET/v1/skills/{id}/versions/{version}/contentGetSkillDados
DELETE/v1/skills/{id}/versions/{version}UpdateSkillDados
POST/v1/user_profilesCreateUserProfileDados
GET/v1/user_profilesListUserProfilesDados
GET/v1/user_profiles/{id}GetUserProfileDados
POST/v1/user_profiles/{id}UpdateUserProfileDados
POST/v1/organizations/workspacesCreateWorkspaceGerenciamento
GET/v1/organizations/workspacesListWorkspacesGerenciamento
GET/v1/organizations/workspaces/{id}GetWorkspaceGerenciamento
POST/v1/organizations/workspaces/{id}UpdateWorkspaceGerenciamento
POST/v1/organizations/workspaces/{id}/archiveArchiveWorkspaceGerenciamento
POST/v1/organizations/external_keysRegisterKeyGerenciamento
GET/v1/organizations/external_keysListKeysGerenciamento
GET/v1/organizations/external_keys/{id}GetKeyGerenciamento
POST/v1/organizations/external_keys/{id}UpdateKeyGerenciamento
DELETE/v1/organizations/external_keys/{id}DisableKeyGerenciamento
GET/v1/compliance/activitiesListComplianceActivitiesGerenciamento
POST/v1/agentsCreateAgentDados
GET/v1/agentsListAgentsDados
GET/v1/agents/{id}GetAgentDados
POST/v1/agents/{id}UpdateAgentDados
POST/v1/agents/{id}/archiveArchiveAgentDados
GET/v1/agents/{id}/versionsGetAgentDados
POST/v1/sessionsCreateSessionDados
GET/v1/sessionsListSessionsDados
GET/v1/sessions/{id}GetSessionDados
POST/v1/sessions/{id}UpdateSessionDados
POST/v1/sessions/{id}/archiveArchiveSessionDados
DELETE/v1/sessions/{id}DeleteSessionDados
GET/v1/sessions/{id}/eventsGetSessionDados
POST/v1/sessions/{id}/eventsUpdateSessionDados
GET/v1/sessions/{id}/events/streamGetSessionDados
GET/v1/sessions/{id}/resourcesGetSessionDados
GET/v1/sessions/{id}/resources/{id}GetSessionDados
POST/v1/sessions/{id}/resourcesUpdateSessionDados
POST/v1/sessions/{id}/resources/{id}UpdateSessionDados
DELETE/v1/sessions/{id}/resources/{id}UpdateSessionDados
POST/v1/environmentsCreateEnvironmentDados
GET/v1/environmentsListEnvironmentsDados
GET/v1/environments/{id}GetEnvironmentDados
POST/v1/environments/{id}UpdateEnvironmentDados
POST/v1/environments/{id}/archiveArchiveEnvironmentDados
DELETE/v1/environments/{id}DeleteEnvironmentDados
GET/v1/environments/{id}/workGetEnvironmentDados
GET/v1/environments/{id}/work/pollProcessEnvironmentWorkDados
GET/v1/environments/{id}/work/{work_id}GetEnvironmentDados
GET/v1/environments/{id}/work/statsGetEnvironmentDados
POST/v1/environments/{id}/work/{work_id}ProcessEnvironmentWorkDados
POST/v1/environments/{id}/work/{work_id}/ackProcessEnvironmentWorkDados
POST/v1/environments/{id}/work/{work_id}/heartbeatProcessEnvironmentWorkDados
POST/v1/environments/{id}/work/{work_id}/stopProcessEnvironmentWorkDados
POST/v1/vaultsCreateVaultGerenciamento
GET/v1/vaultsListVaultsGerenciamento
GET/v1/vaults/{id}GetVaultGerenciamento
POST/v1/vaults/{id}UpdateVaultGerenciamento
POST/v1/vaults/{id}/archiveArchiveVaultGerenciamento
DELETE/v1/vaults/{id}DeleteVaultGerenciamento
GET/v1/vaults/{id}/credentialsGetVaultGerenciamento
POST/v1/vaults/{id}/credentialsUpdateVaultGerenciamento
GET/v1/vaults/{id}/credentials/{id}GetVaultGerenciamento
POST/v1/vaults/{id}/credentials/{id}UpdateVaultGerenciamento
POST/v1/vaults/{id}/credentials/{id}/archiveUpdateVaultGerenciamento
DELETE/v1/vaults/{id}/credentials/{id}UpdateVaultGerenciamento
POST/v1/memory_storesCreateMemoryStoreDados
GET/v1/memory_storesListMemoryStoresDados
GET/v1/memory_stores/{id}GetMemoryStoreDados
POST/v1/memory_stores/{id}UpdateMemoryStoreDados
POST/v1/memory_stores/{id}/archiveArchiveMemoryStoreDados
DELETE/v1/memory_stores/{id}DeleteMemoryStoreDados
POST/v1/memory_stores/{id}/memoriesUpdateMemoryStoreDados
GET/v1/memory_stores/{id}/memoriesGetMemoryStoreDados
GET/v1/memory_stores/{id}/memories/{id}GetMemoryStoreDados
POST/v1/memory_stores/{id}/memories/{id}UpdateMemoryStoreDados
DELETE/v1/memory_stores/{id}/memories/{id}UpdateMemoryStoreDados
GET/v1/memory_stores/{id}/memory_versionsGetMemoryStoreDados
GET/v1/memory_stores/{id}/memory_versions/{id}GetMemoryStoreDados
POST/v1/memory_stores/{id}/memory_versions/{id}/redactUpdateMemoryStoreDados
GET/v1/webhooksListWebhooksGerenciamento
GET/v1/webhooks/{id}GetWebhookGerenciamento
POST/v1/webhooksCreateWebhookGerenciamento
POST/v1/webhooks/{id}UpdateWebhookGerenciamento
DELETE/v1/webhooks/{id}DeleteWebhookGerenciamento
POST/v1/webhooks/{id}/regenerate_signing_secretRotateWebhookSecretGerenciamento

Rotas que não estão nesta tabela não estão disponíveis no Claude Platform on AWS. O gateway nega por padrão qualquer rota não listada aqui.

Políticas gerenciadas

A AWS fornece cinco políticas gerenciadas para o Claude Platform on AWS. Todas as políticas gerenciadas se aplicam a Resource: "*".

PolíticaConcede
AnthropicFullAccessaws-external-anthropic:*
AnthropicReadOnlyAccessGet*, List*, CallWithBearerToken
AnthropicInferenceAccessGet*, List*, CreateInference, CreateBatchInference, CancelBatchInference, DeleteBatchInference, CountTokens, CallWithBearerToken
AnthropicLimitedAccessTodas 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)
AnthropicSelfHostedEnvironmentAccessGetEnvironment, ProcessEnvironmentWork, GetSession, UpdateSession, GetSkill, CallWithBearerToken

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 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:

{
  "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"
    }
  ]
}

Isolamento de workspace por cliente

Restringe uma função a um único 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": "*"
    }
  ]
}

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:

{
  "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"
    }
  ]
}

Automação de provisionamento

Concede a uma função de CI/CD as ações necessárias para criar e gerenciar workspaces, sem nenhuma permissão de inferência:

{
  "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": "*"
    }
  ]
}

CreateWorkspace e ListWorkspaces são operações com escopo de conta. Especificar um ARN de workspace nessas ações não tem efeito; use Resource: "*".

Veja também

Was this page helpful?