

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.

# Trabajar con recursos compartidos en los SMS de mensajería para usuarios AWS finales
<a name="shared-resources"></a>

AWS La mensajería SMS para el usuario final se integra 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](https://docs.aws.amazon.com/ram/latest/userguide/)*.

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**  
Compartir identidades de origen con otras personas Cuentas de AWS no otorga a esas cuentas permiso para enviar mensajes a China. Cada uno Cuenta de AWS debe estar incluido individualmente en una lista de permitidos para su envío a China, independientemente de si la identidad de origen es propia o compartida. AWS RAM Si una cuenta consumidora intenta enviar a China con una identidad de origen compartida sin su propia lista de permitidos en China, la solicitud fallará y se producirá un error de `DESTINATION_COUNTRY_BLOCKED` validación.  
Para solicitar que se permita 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](awssupport.md).

**Topics**
+ [Requisitos previos para compartir el número de teléfono, el grupo, la lista de exclusión o el remitente IDs](#sharing-prereqs)
+ [Cómo compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente](#sharing-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](#sharing-unshare)
+ [Identificación de un número de teléfono, un grupo, una lista de exclusión o un ID de remitente compartidos](#sharing-identify)
+ [Responsabilidades y permisos del número de teléfono, grupo, lista de exclusión o remitente compartidos IDs](#sharing-perms)
+ [Facturación y medición](#sharing-billing)
+ [Cuotas de instancias](#sharing-quotas)
+ [Ejemplos de políticas de uso compartido de un ID de remitente o un número de teléfono con Amazon Pinpoint](#sharing-policy-example)
+ [Ejemplo de política de uso compartido de un ID de remitente con Amazon Pinpoint y Amazon SNS](#sharing-policy-example-sender-id)
+ [Ejemplo de política para compartir un número de teléfono con Amazon Pinpoint y Amazon SNS](#sharing-policy-example-phone-number)

## Requisitos previos para compartir el número de teléfono, el grupo, la lista de exclusión o el remitente IDs
<a name="sharing-prereqs"></a>
+ 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](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-orgs) 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
<a name="sharing-share"></a>

Cuando compartes un recurso que te pertenece con otros Cuentas de AWS, les permites 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.
+ **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 exclusión o un identificador de remitente mediante la consola de SMS de mensajería para el usuario AWS final, lo añades 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](https://console.aws.amazon.com/ram).

Si forma parte de una organización AWS Organizations y está activado el uso compartido dentro de su organización, los consumidores de su organización tienen acceso automático al número de teléfono compartido, al grupo, a la lista de exclusión o al ID del remitente. 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 le pertenezca mediante la consola de SMS de AWS End User Messaging, la AWS RAM consola o la AWS CLI.

**nota**  
Los recursos compartidos solo se pueden usar a través de la AWS CLI [API de mensajería SMS y voz para el usuario AWS final, versión](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/Welcome.html) 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 consola AWS CLI o la [AWS RAM consola](https://console.aws.amazon.com/ram).

Le recomendamos usar la [consola de AWS RAM](https://console.aws.amazon.com/ram) para compartir recursos.

**Para compartir un número de teléfono, grupo, lista de exclusión o ID de remitente de su propiedad mediante la consola de SMS de mensajería para el usuario AWS final**

1. Abra la consola de SMS de mensajería para usuarios AWS finales en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

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

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

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

1. Seleccione **Save changes (Guardar cambios)**.

**Para compartir un número de teléfono, un grupo, una lista de exclusión o un identificador de remitente de su propiedad mediante la AWS RAM consola**  
Consulte [Crear un recurso compartido](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) en la *Guía del usuario de AWS RAM *.

**Para compartir un número de teléfono, un grupo, una lista de exclusión o un identificador de remitente que te pertenezca mediante el AWS CLI**  
Utilice el comando [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html).

## Cómo dejar de compartir un número de teléfono, un grupo, una lista de exclusión o un ID de remitente compartidos
<a name="sharing-unshare"></a>

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 utilizando la consola SMS de mensajería para el usuario AWS final, la AWS RAM consola o el AWS CLI.

**Para dejar de compartir un número de teléfono, grupo, lista de exclusión o ID de remitente compartidos de su propiedad mediante la consola AWS RAM**  
Consulte [Actualización de un recurso compartido](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-update) en la *Guía del usuario de AWS RAM *.

**Para dejar de compartir un número de teléfono, grupo, lista de exclusión o ID de remitente compartidos de tu propiedad mediante el AWS CLI**  
Utilice el comando [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html).

## Identificación de un número de teléfono, un grupo, una lista de exclusión o un ID de remitente compartidos
<a name="sharing-identify"></a>

Los propietarios y los consumidores pueden identificar el número de teléfono compartido, el grupo, la lista de exclusión o el remitente IDs utilizando el AWS CLI.

**nota**  
Los números de teléfono, las agrupaciones, la lista de exclusión y el remitente no IDs suelen identificarse como recursos compartidos en la consola de SMS de mensajería para el usuario AWS final. 

**Para identificar un número de teléfono, un grupo, una lista de exclusión o un identificador de remitente compartidos mediante el AWS CLI**  
Utilice el [describe-sender-ids](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html)comando [describe-opt-out-lists[describe-phone-numbers](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-phone-numbers.html)](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-opt-out-lists.html), [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) o con el `Owner` parámetro establecido en. `SHARED` El comando devuelve el número de teléfono, el grupo, la lista de exclusión o el remitente IDs compartidos con usted. 

## Responsabilidades y permisos del número de teléfono, grupo, lista de exclusión o remitente compartidos IDs
<a name="sharing-perms"></a>

### Permisos de los propietarios
<a name="perms-owner"></a>

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

### Permisos de los consumidores
<a name="perms-consumer"></a>

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

## Facturación y medición
<a name="sharing-billing"></a>

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-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html)o [send-text-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-text-message.html)sin tener [send-voice-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-voice-message.html)en cuenta 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](https://aws.amazon.com//end-user-messaging/pricing/) [Establezca un límite de gasto en SMS, MMS o voz en los SMS de mensajería para usuarios finales AWS](spend-limit.md)

## Cuotas de instancias
<a name="sharing-quotas"></a>

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
<a name="sharing-policy-example"></a>

Se recomienda usar la [consola de AWS RAM](https://console.aws.amazon.com/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 su propiedad mediante la consola SMS de mensajería para el usuario AWS final**

1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

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

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

1. 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**:
   + {{Partition}}Sustitúyala por la AWS partición en la que se encuentra el número de teléfono.
   + {{Region}}Sustitúyala Región de AWS por la que aparece el número de teléfono.
   + {{Account}}Sustitúyalo por el número de cuenta al que pertenece el número de teléfono.
   + {{Phone-id}}Sustitúyalo por el identificador del número de teléfono.

1. 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 de su propiedad mediante la consola SMS de mensajería para el usuario AWS final**

1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. En el panel de navegación, en **Configuraciones**, elija **Remitente IDs** y, a continuación, elija un ID de remitente.

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

1. 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**:
   + {{Partition}}Sustitúyalo por la AWS partición en la que se encuentra el ID del remitente.
   + {{Region}}Sustitúyala Región de AWS por la que aparece el identificador del remitente.
   + {{Account}}Sustitúyalo por el número de cuenta al que pertenece el identificador del remitente.
   + {{Senderid}}Sustitúyalo por el identificador del ID del remitente.
   + {{Countrycode}}Sustitúyalo por el código ISO-3166 alfa-2 de dos letras para el país del identificador del remitente.

1. Seleccione **Save changes (Guardar cambios)**.

## Ejemplo de política de uso compartido de un ID de remitente con Amazon Pinpoint y Amazon SNS
<a name="sharing-policy-example-sender-id"></a>

Se recomienda usar la [consola de AWS RAM](https://console.aws.amazon.com/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 ID de remitente de su propiedad mediante la consola de SMS de mensajería para el usuario AWS final**

1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. En el panel de navegación, en **Configuraciones**, elija **Remitente IDs** y, a continuación, elija un ID de remitente.

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

1. 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**:
   + {{Partition}}Sustitúyalo por la AWS partición en la que se encuentra el número de teléfono.
   + {{Region}}Sustitúyala Región de AWS por la que aparece el número de teléfono.
   + {{OwnersAccountID}}Sustitúyalo por el número de AWS cuenta al que pertenece el identificador del remitente.
   + {{SenderID}}Sustitúyalo por el identificador del ID del remitente.
   + {{ISO}}Sustitúyalo por el código ISO-3166 alfa-2 de dos letras para el país del identificador del remitente.
   + {{ConsumersAccountID}}Sustitúyalo por el número de AWS cuenta al que deseas acceder.

------
#### [ 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}}"
           }
       ]
   }
   ```

------

1. Seleccione **Save changes (Guardar cambios)**.

## Ejemplo de política para compartir un número de teléfono con Amazon Pinpoint y Amazon SNS
<a name="sharing-policy-example-phone-number"></a>

Se recomienda usar la [consola de AWS RAM](https://console.aws.amazon.com/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 de su propiedad mediante la consola SMS de mensajería para el usuario AWS final**

1. Abra la consola de SMS de mensajería para el usuario AWS final en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

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

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

1. 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**:
   + {{Partition}}Sustitúyala por la AWS partición en la que se encuentra el número de teléfono.
   + {{Region}}Sustitúyala Región de AWS por la que aparece el número de teléfono.
   + {{OwnersAccountID}}Sustitúyalo por el número de AWS cuenta al que pertenece el número de teléfono.
   + {{PhoneNumberID}}Sustitúyalo por el identificador del número de teléfono.
   + {{ConsumersAccountID}}Sustitúyalo por el número de AWS cuenta al que deseas acceder.

------
#### [ 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}}"
           }
       ]
   }
   ```

------

1. Seleccione **Save changes (Guardar cambios)**.