View a markdown version of this page

Permisos de IAM - Base amazónica AgentCore

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Permisos de IAM

La migración ya está abierta

AWS El registro de agentes se ha lanzado en el nuevo espacio de agent-registry nombres. La compatibilidad con el espacio de bedrock-agentcore nombres de versión preliminar pública dejará de funcionar el 17 de septiembre de 2026. Para obtener instrucciones sobre la migración, consulta la Guía Guía completa de migración de registros completa de migración del registro.

Acciones de registro

Para crear, administrar o usar registros, adjunte a su identidad de IAM una política basada en la identidad que le permita realizar acciones como agente. AWS Registry-related Para obtener permisos completos, puede utilizar la política gestionada. AgentRegistryFullAccess

Para mayor seguridad y control, puede crear su propia política personalizada reduciendo los permisos de la política de acceso total.

nota

En el espacio de bedrock-agentcore nombres, las acciones que se enumeran a continuación están cubiertas por la política BedrockAgentCoreFullAccess administrada. En el espacio de agent-registry nombres, están cubiertas por la nueva política AgentRegistryFullAccess administrada. En las tablas siguientes se muestran ambos espacios de nombres durante la ventana de migración. Para ver el mapeo completo de la migración, consulta la guía completa de migración del registro.

Acciones del plano de control del registro

ejemplo
AWS Agent Registry namespace
Action Description (Descripción) Nivel de acceso

agent-registry:CreateRegistry

Concede permiso para crear un registro

Escritura

agent-registry:GetRegistry

Concede permiso para obtener un registro

Lectura

agent-registry:UpdateRegistry

Concede permiso para actualizar un registro

Escritura

agent-registry:DeleteRegistry

Concede permiso para eliminar un registro

Escritura

agent-registry:ListRegistries

Concede permiso para enumerar los registros

Enumeración

Amazon Bedrock AgentCore namespace (to be deprecated)
Action Description (Descripción) Nivel de acceso

bedrock-agentcore:CreateRegistry

Concede permiso para crear un registro

Escritura

bedrock-agentcore:GetRegistry

Concede permiso para obtener un registro

Lectura

bedrock-agentcore:UpdateRegistry

Concede permiso para actualizar un registro

Escritura

bedrock-agentcore:DeleteRegistry

Concede permiso para eliminar un registro

Escritura

bedrock-agentcore:ListRegistries

Concede permiso para enumerar los registros

Enumeración

Acciones del plano de control de registros

ejemplo
AWS Agent Registry namespace
Action Description (Descripción) Nivel de acceso

agent-registry:CreateRegistryRecord

Concede permiso para crear un registro de registro

Escritura

agent-registry:GetRegistryRecord

Concede permiso para obtener un registro de registro

Lectura

agent-registry:UpdateRegistryRecord

Concede permiso para actualizar un registro de registro

Escritura

agent-registry:DeleteRegistryRecord

Concede permiso para eliminar un registro de registro

Escritura

agent-registry:ListRegistryRecords

Concede permiso para enumerar los registros del registro

Enumeración

agent-registry:SubmitRegistryRecordForApproval

Concede permiso para enviar un registro para su aprobación

Escritura

agent-registry:UpdateRegistryRecordStatus

Concede permiso para aprobar, rechazar o dejar en desuso un registro de registro

Escritura

Amazon Bedrock AgentCore namespace (to be deprecated)
Action Description (Descripción) Nivel de acceso

bedrock-agentcore:CreateRegistryRecord

Concede permiso para crear un registro de registro

Escritura

bedrock-agentcore:GetRegistryRecord

Concede permiso para obtener un registro de registro

Lectura

bedrock-agentcore:UpdateRegistryRecord

Concede permiso para actualizar un registro de registro

Escritura

bedrock-agentcore:DeleteRegistryRecord

Concede permiso para eliminar un registro de registro

Escritura

bedrock-agentcore:ListRegistryRecords

Concede permiso para enumerar los registros del registro

Enumeración

bedrock-agentcore:SubmitRegistryRecordForApproval

Concede permiso para enviar un registro para su aprobación

Escritura

bedrock-agentcore:UpdateRegistryRecordStatus

Concede permiso para aprobar, rechazar o dejar en desuso un registro de registro

Escritura

Acciones del plano de datos de registro

ejemplo
AWS Agent Registry namespace
Action Description (Descripción) Nivel de acceso

agent-registry:SearchDiscoverableRegistryRecords

Concede permiso para buscar en los registros de registro aprobados

Lectura

agent-registry:ListDiscoverableRegistryRecords

Concede permiso para enumerar los registros de registro aprobados

Enumeración

agent-registry:GetDiscoverableRegistryRecord

Concede permiso para recuperar un registro de registro aprobado. También autorizaBatchGetDiscoverableRegistryRecord.

Lectura

agent-registry:InvokeRegistryMcp

Concede permiso para invocar el punto final del MCP del registro

Lectura

Amazon Bedrock AgentCore namespace (to be deprecated)
Action Description (Descripción) Nivel de acceso

bedrock-agentcore:SearchRegistryRecords

Concede permiso para buscar en los registros del registro

Lectura

bedrock-agentcore:InvokeRegistryMcp

Concede permiso para invocar el punto final del MCP del registro

Lectura

nota

Para invocar el punto final del MCP del registro, necesita tanto la acción de búsqueda como la acción. InvokeRegistryMcp En el espacio de agent-registry nombres, la acción de búsqueda esagent-registry:SearchDiscoverableRegistryRecords; en el espacio de bedrock-agentcore nombres, es. bedrock-agentcore:SearchRegistryRecords

nota

BatchGetDiscoverableRegistryRecordno tiene su propia acción de IAM. Se autoriza la anulación de cada registro solicitado. agent-registry:GetDiscoverableRegistryRecord Concesión GetDiscoverableRegistryRecord para su usoBatchGetDiscoverableRegistryRecord.

Acciones de identidad de la carga de trabajo (necesarias para el ciclo de vida del registro)

Las siguientes acciones son necesarias para las operaciones de identidad de la carga de trabajo administradas por el registro. Estas acciones utilizan el espacio de bedrock-agentcore nombres y el servicio las llama en su nombre durante los flujos de trabajo y durante CreateRegistry los flujos de trabajo. DeleteRegistry

Action Description (Descripción) Nivel de acceso

bedrock-agentcore:CreateWorkloadIdentity

Concede permiso para crear una identidad de carga de trabajo para un registro

Escritura

bedrock-agentcore:GetWorkloadIdentity

Concede permiso para recuperar los detalles de identidad de la carga de trabajo (se utilizan para la idempotencia al volver a intentarlo)

Lectura

bedrock-agentcore:DeleteWorkloadIdentity

Concede permiso para eliminar una identidad de carga de trabajo cuando se elimina un registro

Escritura

nota

El GetWorkloadIdentity permiso es necesario para admitir reintentos idempotentes del flujo de trabajo. CreateRegistry Sin este permiso, si se vuelve a intentar crear un registro (por ejemplo, después de un error transitorio), el flujo de trabajo no podrá verificar la identidad de la carga de trabajo existente y fallará.

Acciones de rol vinculadas al servicio de IAM (necesarias para el ciclo de vida del registro)

La siguiente acción es necesaria durante la administración del ciclo de vida del registro. Esta acción usa el espacio de iam nombres y el servicio la llama en su nombre durante el CreateRegistry flujo de trabajo.

Action Description (Descripción) Nivel de acceso

iam:CreateServiceLinkedRole

Concede permiso para crear la función vinculada al servicio para el Registro de agentes AWS

Escritura

nota

El CreateServiceLinkedRole permiso es necesario durante la creación del registro para permitir que el servicio publique CloudWatch las métricas en su cuenta una vez creado el registro. Sin este permiso, la creación del registro fallará.

Tipos de recursos de registro

Se definen los siguientes tipos de recursos para el Registro de AWS agentes:

ejemplo
AWS Agent Registry namespace
Tipo de recurso Formato de ARN

Registro

arn:aws:agent-registry:{region}:{account}:registry/{registryId}

Registro de registro

arn:aws:agent-registry:{region}:{account}:registry/{registryId}/record/{recordId}

Amazon Bedrock AgentCore namespace (to be deprecated)
Tipo de recurso Formato de ARN

Registro

arn:aws:bedrock-agentcore:{region}:{account}:registry/{registryId}

Registro registral

arn:aws:bedrock-agentcore:{region}:{account}:registry/{registryId}/record/{recordId}