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](registry-faq.md) 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). ](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) 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`](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAgentRegistryServiceRolePolicy.html) Para ver el documento de política completo, consulte [ AWSAgentRegistryServiceRolePolicy ](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAgentRegistryServiceRolePolicy.html) 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 denominada`AWSServiceRoleForAgentRegistry`, 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`](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSAgentRegistryServiceRolePolicy.html) 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ón`config.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 (`Put`y`Delete`) están condicionadas a la `config:ConfigurationRecorderServicePrincipal` equivalencia`agent-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 | `organizations:DescribeAccount`, `organizations:DescribeOrganization`, `organizations:ListAccounts`, `organizations:ListDelegatedAdministrators` |
| Configura la AWS configuración | `iam:CreateServiceLinkedRole`(para Config)`config:PutServiceLinkedConfigurationRecorder`,`config:DeleteServiceLinkedConfigurationRecorder`,`config:DescribeConfigurationRecorders`, `config:DescribeConfigurationRecorderStatus` |
| Gestione los registros de registro | `agent-registry:CreateRegistryRecord`, `agent-registry:DeleteRegistryRecord`, `agent-registry:GetRegistryRecord`, `agent-registry:ListRegistryRecords`, `agent-registry:UpdateRegistryRecord` |
| Publicar las métricas | `cloudwatch:PutMetricData` |
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 ](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) 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 llamar`CreateRegistry`; 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 ](registry-organizations.md#registry-organizations-step1) y crear el rol vinculado al servicio. ](registry-kms-key-policy.md#registry-encryption-key-policy-slr)
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](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role) 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:
1. Deshabilite la detección automática en cualquier registro que abarque la organización.
1. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) 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.