View a markdown version of this page

Trabajando con recursos compartidos en AWS Mensajería SMS para el usuario final - AWS Mensajería SMS para el usuario final
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

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.

Trabajando con recursos compartidos en AWS Mensajería SMS para el usuario final

AWS Los SMS de mensajería para usuarios finales se integran con AWS Resource Access Manager (AWS RAM) para permitir el intercambio de recursos. AWS RAM es un servicio que le permite compartir algunos recursos de mensajería SMS para usuarios AWS finales con otros Cuentas de AWS o a través de ellos AWS Organizations. Con AWS RAM, puede compartir los recursos de su propiedad mediante la creación de un recurso compartido. 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ífico dentro o fuera de su organización en AWS Organizations

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

  • Toda su organización en AWS Organizations

  • Otros AWS servicios como Amazon Pinpoint o Amazon SNS

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

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

importante

Los recursos compartidos (números de teléfono, identificadores de remitentes, grupos y listas de exclusión voluntaria) a los que se accede solo se AWS RAM pueden usar con la API de mensajería por SMS para usuarios AWS finales (por ejemplo, la SendTextMessage acción). No son compatibles con:

  • Amazon SNS (PublishAPI para SMS)

  • Amazon Pinpoint (API) SendMessages

  • La consola de SMS de mensajería para usuarios AWS finales

Para enviar desde un recurso compartido, utilice el nombre de recurso de Amazon (ARN) completo del recurso en la llamada a la SendTextMessage API AWS CLI o un con el nombre de recurso de Amazon (ARN) completo del recurso.

importante

Compartir las identidades de origen con otras Cuentas de AWS no otorga a esas cuentas permiso para enviar mensajes a China. Cada una de ellas Cuenta de AWS debe figurar individualmente en la lista de personas autorizadas para enviar a China, independientemente de si la identidad de origen es propia o se comparte a través de ella. AWS RAM Si una cuenta consumidora intenta enviar dinero a China con una identidad de origen compartida sin tener su propia lista de China permitida, la solicitud fallará y se producirá un error de validación. DESTINATION_COUNTRY_BLOCKED

Para solicitar la inclusión de una cuenta en China, abre un caso con. AWS Support Para obtener más información, consulte Solicitud de asistencia para mensajes SMS, MMS y de voz a través de Soporte.

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

Cuando compartes un recurso de tu propiedad con otras personas Cuentas de AWS, les permites hacer lo siguiente:

  • Opt-Out Lista: 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 añadir números de teléfono a la lista de exclusión voluntaria.

  • PhoneNumber— 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 compartes un número de teléfono, un grupo, una lista de inhabilitaciones o un identificador de remitente mediante la consola de mensajería por SMS para usuarios AWS finales, lo agregas 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 AWS Organizations y está habilitada la opción de compartir contenido dentro de su organización, los consumidores de su organización tendrán acceso automáticamente al número de teléfono, al grupo, a la lista de inhabilitaciones o al identificador 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.

Puedes compartir un número de teléfono, un grupo, una lista de inhabilitaciones o un identificador de remitente de tu propiedad mediante la consola, AWS RAM la consola o la consola de mensajería de usuario AWS final por SMS AWS CLI.

nota

Los recursos compartidos solo se pueden usar a través de la AWS CLI API v2 de SMS y voz de mensajería de usuario AWS final. Debe utilizar el nombre de recurso de Amazon (ARN) completo del recurso compartido. Los recursos compartidos no admiten el envío a través de Amazon SNS, Amazon Pinpoint o la consola de mensajería por SMS para usuarios AWS finales.

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

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

Para compartir un número de teléfono, un grupo, una lista de inhabilitaciones o un identificador de remitente de tu propiedad mediante el AWS Consola de mensajería SMS para usuarios finales

  1. Abra la consola de SMS de mensajería para el usuario AWS final 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 Save changes (Guardar cambios).

Para compartir un número de teléfono, un grupo, una lista de exclusión voluntaria o un identificador de remitente de su propiedad mediante el AWS RAM consola

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

Para compartir un número de teléfono, un grupo, una lista de exclusión voluntaria o un identificador de remitente de tu propiedad mediante el 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 SMS de mensajería para usuarios AWS finales, la AWS RAM consola o la AWS CLI.

Para dejar de compartir un número de teléfono compartido, un grupo, una lista de exclusión voluntaria o un identificador de remitente de tu propiedad, utiliza el AWS RAM consola

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

Para dejar de compartir un número de teléfono compartido, un grupo, una lista de inhabilitaciones o un identificador de remitente de tu propiedad, mediante el 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 de contactos, las listas de exclusión voluntaria y los identificadores de remitentes no suelen identificarse como un recurso compartido en la consola de SMS de mensajería para usuarios AWS finales.

Para identificar un número de teléfono, un grupo, una lista de inhabilitaciones o un identificador de remitente compartidos mediante el 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 costos 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 Mensajería para usuarios finales de AWS Establece un límite de gastos de SMS, MMS o voz en AWS Mensajería SMS para el usuario final

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.

Para compartir un número de teléfono de tu propiedad mediante el AWS Consola de mensajería SMS para el usuario final

  1. Abra la consola de SMS de mensajería para el usuario AWS final 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:

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

    • RegionSustitúyalo por Región de AWS el número en el que se encuentra el número de teléfono.

    • AccountSustitúyalo por el número de cuenta al que pertenece el número de teléfono.

    • Phone-idSustitúyalo por el identificador del número de teléfono.

  5. Seleccione Save changes (Guardar cambios).

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

Para compartir un identificador de remitente del que seas propietario, utiliza el AWS Consola de mensajería SMS para usuarios finales

  1. Abra la consola de SMS de mensajería para el usuario AWS final 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:

    • PartitionSustitúyala por la AWS partición en la que se encuentra el identificador del remitente.

    • RegionSustitúyalo por Región de AWS el nombre en el que se encuentra el identificador del remitente.

    • AccountSustitúyalo por el número de cuenta al que pertenece el identificador del remitente.

    • SenderidSustitúyalo por el identificador del identificador del remitente.

    • CountrycodeSustitúyalo por el código ISO-3166 alfa-2 de dos letras del país del identificador del remitente.

  5. Seleccione Save changes (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.

Para compartir un identificador de remitente del que seas propietario, utiliza el AWS Consola de mensajería SMS para usuarios finales

  1. Abra la consola de SMS de mensajería para el usuario AWS final 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:

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

    • RegionSustitúyalo por Región de AWS el número en el que se encuentra el número de teléfono.

    • OwnersAccountIDSustitúyalo por el número de AWS cuenta al que pertenece el identificador del remitente.

    • SenderIDSustitúyalo por el identificador del identificador del remitente.

    • ISOSustitúyalo por el código ISO-3166 alfa-2 de dos letras del país del identificador del remitente.

    • ConsumersAccountIDSustitúyalo por el número de AWS cuenta a la que quieres dar 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 Save changes (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.

Para compartir un número de teléfono del que eres propietario mediante el AWS Consola de mensajería SMS para el usuario final

  1. Abra la consola de SMS de mensajería para el usuario AWS final 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:

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

    • RegionSustitúyalo por Región de AWS el número en el que se encuentra el número de teléfono.

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

    • PhoneNumberIDSustitúyalo por el identificador del número de teléfono.

    • ConsumersAccountIDSustitúyalo por el número de AWS cuenta al que dar 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 Save changes (Guardar cambios).