Trabajo con recursos compartidos en AWS End User Messaging SMS - AWS End User Messaging SMS
Requisitos previos para compartir números de teléfono, grupos, listas de exclusión o ID de remitenteCómo compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitenteCómo dejar de compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente compartidosIdentificación de un número de teléfono, un grupo, una lista de exclusión o un ID de remitente compartidosResponsabilidades y permisos para número de teléfono, grupo, lista de exclusión o ID de remitente compartidosFacturación y mediciónCuotas de instanciasEjemplos de políticas de uso compartido de un ID de remitente o un número de teléfono con Amazon PinpointEjemplo de política de uso compartido de un ID de remitente con Amazon Pinpoint y Amazon SNSEjemplo de política para compartir un número de teléfono con Amazon Pinpoint y Amazon SNS

Trabajo con recursos compartidos en AWS End User Messaging SMS

AWS End User Messaging SMS se integra con AWS Resource Access Manager (AWS RAM) para permitir el uso compartido de recursos. AWS RAM es un servicio que le permite compartir algunos recursos de AWS End User Messaging SMS con otras Cuentas de AWS o a través de AWS Organizations. Con AWS RAM, puede compartir recursos de su propiedad creando un uso compartido de recursos. Un uso compartido de recursos especifica los recursos que compartir y los consumidores con quienes compartirlos. Los consumidores pueden incluir lo siguiente:

  • Cuentas de AWS específicas dentro o fuera de su organización en AWS Organizations

  • Una unidad organizativa dentro de la organización en AWS Organizations

  • Toda la organización en AWS Organizations

  • Otros servicios de AWS como Amazon Pinpoint o Amazon SNS

Para obtener más información sobre AWS RAM, consulte la Guía del usuario de AWS RAM.

En este tema se explica cómo compartir los recursos que le pertenecen y cómo utilizar los recursos que se comparten con usted.

Requisitos previos para compartir números de teléfono, grupos, listas de exclusión o ID de remitente

  • Para compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente, debe ser propietario de ellos en su Cuenta de AWS. Esto significa que el recurso debe asignarse o suministrarse en su cuenta. No puede compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente que se ha compartido con usted.

  • Para compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente con su organización o una unidad organizativa en AWS Organizations, debe habilitar el uso compartido con AWS Organizations. Para obtener más información, consulte Habilitar el uso compartido con AWS Organizations en la Guía del usuario de AWS RAM.

Cómo compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente

Al compartir un recurso del que es propietario con otras Cuentas de AWS, les permite hacer lo siguiente:

  • Lista de exclusión: los consumidores con acceso a este recurso pueden comprobar el estado de un número de teléfono, eliminar un número de teléfono y agregar números de teléfono a la lista de exclusión.

  • Número de teléfono: los consumidores con acceso a este recurso pueden usar el número de teléfono para enviar mensajes.

  • Grupo: los consumidores con acceso a este recurso pueden ver el grupo. Todos los recursos incluidos en el grupo también deben compartirse para que otras Cuentas de AWS puedan acceder a ellos. En un grupo se puede tener una combinación de recursos compartidos y no compartidos.

  • ID de remitente: los consumidores con acceso a este recurso pueden usar el ID de remitente para enviar mensajes.

Para compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente, debe agregarlo a un recurso compartido. Un recurso compartido es un recurso de AWS RAM que le permite compartir los recursos a través de Cuentas de AWS. Un recurso compartido especifica los recursos que compartir y los consumidores con quienes se comparten. Cuando comparte un número de teléfono, un grupo, una lista de exclusión o un ID de remitente mediante la consola de AWS End User Messaging SMS, los agrega a un recurso compartido existente. Para agregar el número de teléfono, grupo, lista de exclusión o ID de remitente a un nuevo recurso compartido, debe crear el recurso compartido mediante la consola de AWS RAM.

Si forma parte de una organización en AWS Organizations y el uso compartido está habilitado en ella, los consumidores de la organización tienen automáticamente acceso a los números de teléfono, grupos, listas de exclusión e ID de remitente compartidos. De lo contrario, los consumidores reciben una invitación para unirse al recurso compartido y se les concede acceso a los números de teléfono, grupos, listas de exclusión e ID de remitente compartidos tras aceptar la invitación.

Puede compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente que sea de su propiedad mediante la consola de AWS End User Messaging SMS, la consola de AWS RAM o laAWS CLI.

nota

Los recursos compartidos solo se pueden usar a través de la AWS CLI o la API de SMS y voz de AWS End User Messaging SMS, versión 2. Para usar un recurso compartido debe utilizar el nombre de recurso de Amazon (ARN) completo.

Para ver los recursos compartidos con su cuenta, debe usar la AWS CLI o la consola de AWS RAM.

Le recomendamos usar la consola de AWS RAM para compartir recursos.

Cómo compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente de su propiedad mediante la consola de AWS End User Messaging SMS

  1. Abra la consola de AWS End User Messaging SMS en https://console.aws.amazon.com/sms-voice/.

  2. En el panel de navegación, en Configuraciones, seleccione el tipo de recurso y a continuación, el recurso.

  3. En la pestaña Política de recursos, elija Editar.

  4. Puede editar la política basada en recursos JSON para cambiar los permisos de uso compartido.

  5. Seleccione Guardar cambios.

Cómo compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente de su propiedad mediante la consola de AWS RAM

Consulte Crear un recurso compartido en la Guía del usuario de AWS RAM.

Cómo compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente de su propiedad mediante la AWS CLI

Utilice el comando create-resource-share.

Cómo dejar de compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente compartidos

Cuando el propietario de un recurso deja de compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente con un consumidor, el recurso deja de aparecer en la consola del consumidor.

Para dejar de compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente de su propiedad, debe quitarlo del recurso compartido. Puede hacerlo mediante la consola de AWS End User Messaging SMS, la consola de AWS RAM o la AWS CLI.

Cómo compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente compartidos de su propiedad mediante la consola de AWS RAM

Consulte Actualización de un recurso compartido en la Guía del usuario de AWS RAM.

Cómo dejar de compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente compartidos de su propiedad mediante la AWS CLI

Utilice el comando disassociate-resource-share.

Identificación de un número de teléfono, un grupo, una lista de exclusión o un ID de remitente compartidos

Los propietarios y los consumidores pueden identificar números de teléfono, grupos, listas de exclusión o ID de remitente compartido mediante la AWS CLI.

nota

Los números de teléfono, los grupos, las listas de exclusión y los ID de remitentes no suelen identificarse como un recurso compartido en la consola de AWS End User Messaging SMS.

Cómo identificar un número de teléfono, un grupo, una lista de exclusión o un ID de remitente compartidos mediante la AWS CLI

Utilice el comando describe-opt-out-lists, describe-phone-numbers, describe-pools o describe-sender-ids con el parámetro Owner configurado como SHARED. El comando devuelve el número de teléfono, el grupo, la lista de exclusión o los ID de remitente que se comparten con usted.

Responsabilidades y permisos para número de teléfono, grupo, lista de exclusión o ID de remitente compartidos

Permisos de los propietarios

Los propietarios pueden actualizar, ver, compartir, dejar de compartir y utilizar el número de teléfono, el grupo, la lista de exclusión o los ID de remitente.

Permisos de los consumidores

Los consumidores pueden usar y ver el número de teléfono, el grupo, la lista de exclusión o los ID de remitente.

Facturación y medición

Al propietario del recurso se le factura por el recurso. No se factura a los consumidores por los recursos compartidos con ellos, sino por el uso de los recursos para enviar mensajes. Compartir un recurso no conlleva costes adicionales.

A los consumidores se les factura por enviar un mensaje con send-text-message, send-media-message or send-voice-message y esto se descuenta de los límites de gasto de los consumidores. Para obtener más información sobre los precios o los límites de gasto, consulte Precios de AWS End User Messaging Establecimiento de un límite de gasto de SMS, MMS o voz en Mensajes SMS para usuarios finales de AWS

Cuotas de instancias

Compartir un recurso no afecta a los límites del recurso en la cuenta del propietario o del consumidor. Solo se utiliza la cuenta del propietario para calcular los límites del recurso.

Ejemplos de políticas de uso compartido de un ID de remitente o un número de teléfono con Amazon Pinpoint

Se recomienda usar la consola de AWS RAM para crear y administrar recursos compartidos.

En el siguiente ejemplo se permite a Amazon Pinpoint enviar mensajes SMS o de voz con el número de teléfono especificado.

Cómo compartir un número de teléfono de su propiedad mediante la consola de AWS End User Messaging SMS

  1. Abra la consola de AWS End User Messaging SMS en https://console.aws.amazon.com/sms-voice/.

  2. En el panel de navegación, en Configuraciones, elija Números de teléfono y elija uno.

  3. En la pestaña Política de recursos, elija Editar.

  4. Puede editar la política basada en recursos JSON para cambiar los permisos de uso compartido.

    En el siguiente JSON, realiza los siguientes cambios y, a continuación, pegue el JSON en la Política de recursos:

    • Sustituya Partition por la partición de AWS en la que se encuentra el número de teléfono.

    • Sustituya Region por la Región de AWS en la que está el número de teléfono.

    • Sustituya Account por el número de cuenta al que pertenece el número de teléfono.

    • Sustituya Phone-id por el identificador del número de teléfono.

  5. Seleccione Guardar cambios.

En el siguiente ejemplo se permite a Amazon Pinpoint enviar mensajes SMS con el ID de remitente especificado.

Cómo compartir un ID de remitente de su propiedad mediante la consola de AWS End User Messaging SMS

  1. Abra la consola de AWS End User Messaging SMS en https://console.aws.amazon.com/sms-voice/.

  2. En el panel de navegación, en Configuraciones, seleccione ID de remitente y elija uno.

  3. En la pestaña Política de recursos, elija Editar.

  4. Puede editar la política basada en recursos JSON para cambiar los permisos de uso compartido.

    En el siguiente JSON, realiza los siguientes cambios y, a continuación, pegue el JSON en la Política de recursos:

    • Sustituya Partition por la partición de AWS en la que se encuentra el ID de remitente.

    • Sustituya Region por Región de AWS en la que está el ID de remitente.

    • Sustituya Account por el número de cuenta al que pertenece el ID de remitente.

    • Sustituya Senderid por el identificador del ID de remitente.

    • Sustituya Countrycode por el código ISO-3166 alpha-2 de dos letras del país del ID de remitente.

  5. Seleccione Guardar cambios.

Ejemplo de política de uso compartido de un ID de remitente con Amazon Pinpoint y Amazon SNS

Se recomienda usar la consola de AWS RAM para crear y administrar recursos compartidos.

En el siguiente ejemplo se permite a Amazon Pinpoint y Amazon SNS enviar mensajes SMS con el ID de remitente especificado.

Cómo compartir un ID de remitente de su propiedad mediante la consola de AWS End User Messaging SMS

  1. Abra la consola de AWS End User Messaging SMS en https://console.aws.amazon.com/sms-voice/.

  2. En el panel de navegación, en Configuraciones, seleccione ID de remitente y elija uno.

  3. En la pestaña Política de recursos, elija Editar.

  4. Puede editar la política basada en recursos JSON para cambiar los permisos de uso compartido.

    En el siguiente JSON, realiza los siguientes cambios y, a continuación, pegue el JSON en la Política de recursos:

    • Sustituya Partition por la partición de AWS en la que se encuentra el número de teléfono.

    • Sustituya Region por la Región de AWS en la que está el número de teléfono.

    • Sustituya OwnersAccountID por el número de cuenta de AWS al que pertenece el ID de remitente.

    • Sustituya SenderID por el identificador del ID de remitente.

    • Sustituya ISO por el código ISO-3166 alpha-2 de dos letras del país de ID de remitente.

    • Sustituya ConsumersAccountID por el número de cuenta de AWS al que se concede acceso.

    JSON
    {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "pinpoint.amazonaws.com"
            },
            "Action": [
                "sms-voice:SendTextMessage",
                "sms-voice:SendVoiceMessage"
            ],
            "Resource": "arn:aws:sms-voice:us-east-1:111122223333:sender-id/SenderID/ISO",
            "Condition": {
                "StringEquals": {
                "aws:SourceAccount": "111122223333"
                }
            }
        },
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sns.amazonaws.com"
            },
            "Action": "sms-voice:SendTextMessage",
            "Resource": "arn:aws:sms-voice:us-east-1:111122223333:sender-id/SenderID/ISO",
            "Condition": {
                "StringEquals": {
                "aws:SourceAccount": "111122223333"
                }
            }
        },
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            },
            "Action": "sms-voice:SendTextMessage",
            "Resource": "arn:aws:sms-voice:us-east-1:111122223333:sender-id/SenderID/ISO"
        }
    ]
}

  5. Seleccione Guardar cambios.

Ejemplo de política para compartir un número de teléfono con Amazon Pinpoint y Amazon SNS

Se recomienda usar la consola de AWS RAM para crear y administrar recursos compartidos.

En el siguiente ejemplo se permite a Amazon Pinpoint y Amazon SNS enviar mensajes SMS con el número de teléfono especificado.

Como compartir un número de teléfono del que es propietario mediante la consola de AWS End User Messaging SMS

  1. Abra la consola de AWS End User Messaging SMS en https://console.aws.amazon.com/sms-voice/.

  2. En el panel de navegación, en Configuraciones, elija Números de teléfono y elija uno.

  3. En la pestaña Política de recursos, elija Editar.

  4. Puede editar la política basada en recursos JSON para cambiar los permisos de uso compartido.

    En el siguiente JSON, realiza los siguientes cambios y, a continuación, pegue el JSON en la Política de recursos:

    • Sustituya Partition por la partición de AWS en la que se encuentra el número de teléfono.

    • Sustituya Region por la Región de AWS en la que está el número de teléfono.

    • Sustituya OwnersAccountID por el número de cuenta de AWS al que pertenece el número de teléfono.

    • Sustituya PhoneNumberID por el identificador del número de teléfono.

    • Sustituya ConsumersAccountID por el número de cuenta de AWS al que se concede acceso.

    JSON
    {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "pinpoint.amazonaws.com"
            },
            "Action": [
                "sms-voice:SendTextMessage",
                "sms-voice:SendVoiceMessage"
            ],
            "Resource": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/PhoneNumberID",
            "Condition": {
                "StringEquals": {
                "aws:SourceAccount": "111122223333"
                }
            }
        },
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sns.amazonaws.com"
            },
            "Action": "sms-voice:SendTextMessage",
            "Resource": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/PhoneNumberID",
            "Condition": {
                "StringEquals": {
                "aws:SourceAccount": "111122223333"
                }
            }
        },
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:root"
            },
            "Action": "sms-voice:SendTextMessage",
            "Resource": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/PhoneNumberID"
        }
    ]
}

  5. Seleccione Guardar cambios.