View a markdown version of this page

Descripción de los roles vinculados a servicios - Amazon DocumentDB
Service-linked permisos de rolCrear un rol vinculado a serviciosModificación de un rol vinculado a serviciosEliminar un rol vinculado a un servicioRegiones compatibles con los roles vinculados al servicio de Amazon DocumentDB

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.

Descripción de los roles vinculados a servicios

Amazon DocumentDB (compatible con MongoDB) utiliza funciones vinculadas a servicios AWS Identity and Access Management (IAM). Un rol vinculado a un servicio es un tipo único de rol de IAM que está vinculado directamente a Amazon DocumentDB. Service-linked Amazon DocumentDB predefine los roles e incluyen todos los permisos que el servicio necesita para llamar a otros AWS servicios en su nombre.

Un rol vinculado a un servicio simplifica el uso de Amazon DocumentDB porque ya no tendrá que agregar manualmente los permisos requeridos. Amazon DocumentDB define los permisos de sus roles vinculados al servicio y, a menos que esté definido de otra manera, solo Amazon DocumentDB puede asumir sus roles. Los permisos definidos incluyen las políticas de confianza y de permisos, y que la política de permisos no se pueda asociar a ninguna otra entidad de IAM.

Las funciones se pueden eliminar únicamente después de eliminar primero sus recursos relacionados. De esta forma, se protegen los recursos de Amazon DocumentDB, ya que se evita que se puedan eliminar accidentalmente permisos de acceso a los recursos.

Para obtener información acerca de otros servicios que son compatibles con roles vinculados a servicios, consulte Servicios de AWS que funcionan con IAM y busque los servicios en los que se indica Sí en la columna Service-Linked Rol vinculado a servicios. Elija una opción Sí con un enlace para ver la documentación acerca del rol vinculado al servicio en cuestión.

Permisos de roles vinculados a servicios para Amazon DocumentDB

Amazon DocumentDB (compatible con MongoDB) utiliza el rol vinculado a servicios denominado AWSServiceRoleForRDS para permitir que Amazon DocumentDB llame a los AWS servicios en nombre de sus clústeres.

El rol AWSServiceRoleForRDS vinculado a un servicio confía en que los siguientes servicios asuman el rol:

  • docdb.amazonaws.com

La política de permisos del rol permite que Amazon DocumentDB realice las siguientes acciones en los recursos especificados:

  • Acciones en ec2:

    • AssignPrivateIpAddresses

    • AuthorizeSecurityGroupIngress

    • CreateNetworkInterface

    • CreateSecurityGroup

    • DeleteNetworkInterface

    • DeleteSecurityGroup

    • DescribeAvailabilityZones

    • DescribeInternetGateways

    • DescribeSecurityGroups

    • DescribeSubnets

    • DescribeVpcAttribute

    • DescribeVpcs

    • ModifyNetworkInterfaceAttribute

    • RevokeSecurityGroupIngress

    • UnassignPrivateIpAddresses

  • Acciones en sns:

    • ListTopic

    • Publish

  • Acciones en cloudwatch:

    • PutMetricData

    • GetMetricData

    • CreateLogStream

    • PullLogEvents

    • DescribeLogStreams

    • CreateLogGroup

nota

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. Podría encontrarse con el siguiente mensaje de error:

Unable to create the resource. Verify that you have permission to create service linked role. Otherwise wait and try again later.

Si aparece este error, asegúrese de que tiene los siguientes permisos habilitados:

{
    "Action": "iam:CreateServiceLinkedRole",
    "Effect": "Allow",
    "Resource": "arn:aws:iam::*:role/aws-service-role/rds.amazonaws.com/AWSServiceRoleForRDS",
    "Condition": {
        "StringLike": {
            "iam:AWSServiceName":"rds.amazonaws.com"
        }
    }
}

Para obtener más información, consulte los permisos de Service-Linked rol en la Guía del usuario de IAM.

Creación de un rol vinculado a servicios para Amazon DocumentDB

No necesita crear manualmente un rol vinculado a servicios. Al crear un clúster, Amazon DocumentDB se encarga de crear de nuevo el rol vinculado a servicios en su nombre.

Si elimina este rol vinculado a un servicio y necesita crearlo de nuevo, puede utilizar el mismo proceso para volver a crear el rol en su cuenta. Al crear un clúster, Amazon DocumentDB se encarga de crear de nuevo el rol vinculado a servicios en su nombre de nuevo.

Modificación de un rol vinculado a servicios para Amazon DocumentDB

Amazon DocumentDB no permite modificar el rol vinculado al AWSServiceRoleForRDS servicio. Después de crear un rol vinculado a un servicio, no podrá cambiar el nombre del rol, ya que varias entidades podrían hacer referencia al mismo. Sin embargo, puede modificar la descripción del rol utilizando IAM. Para obtener más información, consulte Edición de un Service-Linked rol en la Guía del usuario de IAM.

Eliminación de un rol vinculado a servicios para Amazon DocumentDB

Si ya no necesita usar una función o un servicio que requiera un rol vinculado a un servicio, elimínelo. De esa forma, no tendrás una entidad sin usar que no se supervise o mantenga activamente. Sin embargo, debe eliminar todos los clústeres para poder eliminar el rol vinculado al servicio.

Limpieza de un rol vinculado a servicios para Amazon DocumentDB

Antes de poder utilizar IAM para eliminar un rol vinculado a un servicio, primero debe confirmar que dicho rol no tiene sesiones activas y eliminar los recursos que utiliza.

Para comprobar si el rol vinculado al servicio tiene una sesión activa mediante la consola

  1. Inicia sesión en Consola de administración de AWS y abre la consola de IAM enhttps://console.aws.amazon.com/iam/.

  2. En el panel de navegación de la consola de IAM, seleccione Funciones y, a continuación, elija el nombre (no la casilla de verificación) de la AWSServiceRoleForRDS función.

  3. En la página Resumen del rol seleccionado, seleccione la pestaña Asesor de acceso.

  4. En la pestaña Access Advisor, revise la actividad reciente del rol vinculado al servicio.

    nota

    Si no está seguro de si Amazon DocumentDB utiliza el AWSServiceRoleForRDS rol, puede intentar eliminarlo. Si el servicio está utilizando el rol, este no podrá eliminarse y podrá ver las regiones en las que se está utilizando. Si el rol se está utilizando, debe esperar que la sesión finalice para poder eliminarlo. No se puede revocar la sesión de un rol vinculado a servicios.

Si desea eliminar el AWSServiceRoleForRDS rol, primero debe eliminar todas las instancias y clústeres. Para obtener información acerca de cómo eliminar instancias y clústeres, consulte los siguientes temas:

Regiones compatibles con los roles vinculados al servicio de Amazon DocumentDB

Amazon DocumentDB admite el uso de roles vinculados a servicios en todas las regiones en las que se encuentra disponible el servicio. Para obtener más información, consulte https://docs.aws.amazon.com/documentdb/latest/devguide/regions-and-azs.html#regions-and-azs-availability.