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.
Uso de funciones vinculadas a servicios para AWS Registro de agentes
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.
AWS El registro de agentes utiliza AWS funciones vinculadas al servicio de administración de acceso e identidad (IAM). Una función vinculada a un servicio es un tipo único de función de IAM que está vinculada directamente al registro de agentes. AWS Service-linked Las funciones están predefinidas por AWS el Registro de Agentes e incluyen todos los permisos que el servicio necesita para llamar a otros AWS servicios en su nombre.
AWS El registro de agentes usa el rol vinculado al servicio denominado. AWSServiceRoleForAgentRegistry Esta función proporciona los permisos necesarios para que AWS Agent Registry descubra los recursos de las cuentas de los miembros de la organización (detección automática), gestione los registros del registro en su nombre, configure los registradores de AWS configuración para el seguimiento de los recursos y publique las métricas. CloudWatch La política de permisos de rol asociada AWSServiceRoleForAgentRegistry recibe un nombre. AWSAgentRegistryServiceRolePolicy Para ver el documento de política completo, consulte AWSAgentRegistryServiceRolePolicy la Guía de referencia de políticas AWS administradas.
Service-linked permisos de rol para AWS Registro de agentes
AWS El Registro de agentes utiliza la función vinculada a servicios denominadaAWSServiceRoleForAgentRegistry, que permite al Registro de AWS agentes llamar a AWS los servicios en su nombre.
El rol vinculado al servicio AWSServiceRoleForAgentRegistry depende de los siguientes servicios para asumir el rol:
-
agent-registry.amazonaws.com
La política de permisos de funciones denominada AWSAgentRegistryServiceRolePolicy permite a AWS Agent Registry realizar las siguientes acciones:
AWS Acceso de las organizaciones
AWS El registro de agentes lee los metadatos de la organización para permitir la detección automática de los recursos en las cuentas de los miembros.
-
organizations:DescribeAccount— Recupera los detalles de las cuentas de los miembros de tu organización. -
organizations:DescribeOrganization— Recuperar información sobre la organización. -
organizations:ListAccounts— Listar todas las cuentas de la organización. -
organizations:ListDelegatedAdministrators— Identifique a los administradores delegados registrados para la detección automática.
Estas acciones se aplican a todos los recursos (*).
AWS Configure la creación de roles vinculados al servicio
AWS El registro de agentes crea el rol vinculado al servicio de AWS configuración al configurar los grabadores de configuración para el seguimiento de los recursos en las cuentas de los miembros.
-
iam:CreateServiceLinkedRole— Crea el rol.AWSServiceRoleForConfig
Esta acción está restringida al recurso arn:aws:iam::*:role/aws-service-role/config.amazonaws.com/AWSServiceRoleForConfig y está condicionada a la iam:AWSServiceName igualaciónconfig.amazonaws.com.
AWS Configure la configuración y la administración del registrador
AWS El registro de agentes administra los grabadores de configuración vinculados a servicios para realizar un seguimiento de los recursos compatibles con el fin de detectarlos automáticamente.
-
config:PutServiceLinkedConfigurationRecorder— Cree o actualice un grabador de configuración para la detección automática. -
config:DeleteServiceLinkedConfigurationRecorder— Elimine el grabador de configuración cuando la detección automática esté desactivada. -
config:DescribeConfigurationRecorders— Describa los grabadores de configuración (acceso de lectura). -
config:DescribeConfigurationRecorderStatus— Compruebe el estado de los grabadores de configuración.
Las acciones de escritura (PutyDelete) están condicionadas a la config:ConfigurationRecorderServicePrincipal equivalenciaagent-registry.amazonaws.com, lo que significa que solo se pueden modificar las grabadoras que pertenezcan a AWS Agent Registry.
Las acciones de lectura (Describe) se limitan a la coincidencia de recursos. arn:aws:config:*:*:configuration-recorder/AWSConfigurationRecorderForAgentRegistry*
Administración de registros
AWS Agent Registry administra los registros de registro como parte de la detección automática: crea, actualiza y elimina registros cuando se descubren, modifican o eliminan recursos en las cuentas de los miembros.
-
agent-registry:CreateRegistryRecord— Crea un registro para un recurso recién descubierto. -
agent-registry:DeleteRegistryRecord— Eliminar un registro cuando se elimina el recurso de origen. -
agent-registry:GetRegistryRecord— Leer un registro para comprobar su estado actual. -
agent-registry:ListRegistryRecords— Listar los registros de un registro. -
agent-registry:UpdateRegistryRecord— Actualizar un registro cuando cambie el recurso de origen.
Estas acciones tienen un alcance arn:aws:agent-registry:*:*:registry/* y están condicionadas a la aws:ResourceAccount coincidencia${aws:PrincipalAccount}, lo que significa que el rol solo puede administrar los registros de los registros que pertenecen a la misma cuenta.
CloudWatch métricas
AWS El registro de agentes publica las métricas operativas en Amazon CloudWatch para su supervisión.
-
cloudwatch:PutMetricData— Publica las métricas en CloudWatch.
Esta acción está condicionada a cloudwatch:namespace que sea una AWS/AgentRegistry opción o AWS/Usage y a aws:ResourceAccount que coincida${aws:PrincipalAccount}. El rol solo puede enviar datos métricos a estos espacios de nombres específicos dentro de la misma cuenta.
Resumen de permisos
| Funcionalidad | Acciones |
|---|---|
|
Lea los metadatos de la organización |
|
|
Configura la AWS configuración |
|
|
Gestione los registros de registro |
|
|
Publicar las métricas |
|
Debe configurar permisos para permitir a una entidad de IAM (como un usuario, grupo o rol) crear, editar o eliminar un rol vinculado a servicios. Para obtener más información, consulte los permisos de los Service-linked roles en la Guía del usuario de IAM.
Crear el rol vinculado al servicio para AWS Registro de agentes
Por lo general, no es necesario crear manualmente el rol vinculado al servicio. Al crear un registro en el Registro de AWS agentes, en la consola AWS de administración, la AWS CLI o la AWS API, el Registro del AWS agente crea automáticamente el rol vinculado al servicio.
nota
La primera vez que cree un registro, se le debe conceder el iam:CreateServiceLinkedRole permiso en una política basada en la identidad.
importante
En el caso de un registro de ámbito organizativo cifrado con una clave gestionada por el cliente, la función vinculada al servicio ya debe existir en la cuenta del administrador del registro (normalmente, la de administrador delegado) antes de llamarCreateRegistry; no se crea para ti como parte de esa llamada. La política de claves de KMS del administrador del registro nombra al AWSServiceRoleForAgentRegistry rol como principal e IAM rechaza cualquier política de claves que haga referencia a un principal que aún no existe.
Cree primero el rol en la cuenta del administrador del registro, ya sea habilitando el acceso confiable para la detección automática (que lo aprovisiona mediante ASLRP) o ejecutándolo. aws iam create-service-linked-role --aws-service-name agent-registry.amazonaws.com
En todos los demás casos (incluidos los registros que no pertenecen a una organización y se cifran con una clave gestionada por el cliente), CreateRegistry crea automáticamente la función vinculada al servicio, si aún no existe.
Para ver los pasos de configuración relacionados, consulta la declaración de política para el rol vinculado a un servicio y el Paso 1: Habilitar el acceso confiable y crear el rol vinculado al servicio.
Si elimina este rol vinculado al servicio y necesita crearlo de nuevo, puede utilizar el mismo proceso para volver a crear el rol en su cuenta. Al crear un registro en el Registro de agentes, AWS el Registro de AWS agentes vuelve a crear el rol vinculado al servicio para usted.
También puede usar la consola de IAM para crear un rol vinculado a un servicio con el caso práctico del AWS Registro de agentes. En la AWS CLI o la AWS API, cree un rol vinculado a un servicio con el nombre del servicio: agent-registry.amazonaws.com
aws iam create-service-linked-role --aws-service-name "agent-registry.amazonaws.com"
Para obtener más información, consulte Crear un rol vinculado a un servicio en la Guía del usuario de IAM. Si elimina este rol vinculado al servicio, puede utilizar este mismo proceso para volver a crear el rol.
Editar el rol vinculado al servicio para AWS Registro de agentes
AWS El registro de agentes no permite editar el rol AWSServiceRoleForAgentRegistry vinculado al servicio. Después de crear un rol vinculado a servicios, no puede cambiarle el nombre, ya que varias entidades pueden hacer referencia a él.
Eliminar el rol vinculado al servicio para AWS Registro de agentes
Si ya no necesita usar una característica o servicio que requieran un rol vinculado a un servicio, le recomendamos que elimine dicho rol. Esto evita que tenga una entidad no utilizada que no se supervise ni mantenga activamente. Sin embargo, debe limpiar los recursos de su rol vinculado al servicio antes de eliminarlo manualmente.
Para eliminar el AWSServiceRoleForAgentRegistry rol, primero debes:
-
Deshabilite la detección automática en cualquier registro que abarque la organización.
-
Elimine todos los registros del Registro de agentes. AWS
importante
Si elimina el rol AWSServiceRoleForAgentRegistry vinculado al servicio mientras los registros aún existen, la detección automática deja de funcionar: no se descubren nuevos recursos y los registros existentes no se actualizan ni eliminan. CloudWatch Las métricas del registro de AWS agentes también dejan de publicarse. Para restaurar la funcionalidad, vuelva a crear el rol creando un registro nuevo o aws iam create-service-linked-role --aws-service-name "agent-registry.amazonaws.com" ejecutándolo.
nota
Si AWS Agent Registry utiliza la función cuando intenta eliminar los recursos, es posible que no se pueda eliminar. En tal caso, espere unos minutos e intente de nuevo la operación.
Para eliminar manualmente el rol vinculado a servicios mediante IAM
Utilice la consola de IAM, la AWS CLI o la AWS API para eliminar el rol vinculado al AWSServiceRoleForAgentRegistry servicio. Para obtener más información, consulte Eliminación de un rol vinculado a servicios en la Guía del usuario de IAM.
Regiones compatibles para AWS Funciones vinculadas al servicio de registro de agentes
AWS El registro de agentes admite el uso de la función AWSServiceRoleForAgentRegistry vinculada al servicio en todas las regiones en las que esté disponible el registro de AWS agentes.
