As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Trabalhando com recursos compartilhados no SMS de mensagens para usuários AWS finais AWS O End User Messaging SMS se integra com AWS Resource Access Manager (AWS RAM) para permitir o compartilhamento de recursos. AWS RAM é um serviço que permite que você compartilhe alguns recursos de SMS de mensagens de usuário AWS final com outras pessoas Contas da AWS ou por meio de AWS Organizations. Com AWS RAM, você compartilha recursos de sua propriedade criando um *compartilhamento de recursos*. Um compartilhamento de atributos especifica os atributos a serem compartilhados, e os consumidores com os quais compartilhá-los. Os consumidores podem incluir: + Específico Contas da AWS dentro ou fora de sua organização em AWS Organizations + Uma unidade organizacional dentro de sua organização em AWS Organizations + Toda a sua organização em AWS Organizations + Outros AWS serviços, como Amazon Pinpoint ou Amazon SNS Para obter mais informações sobre AWS RAM, consulte o *[Guia AWS RAM do usuário](https://docs.aws.amazon.com/ram/latest/userguide/)*. Este tópico explica como compartilhar recursos que você possui e como usar os recursos que são compartilhados com você. **Importante** Compartilhar identidades de origem com outras pessoas Contas da AWS não concede permissão a essas contas para enviar mensagens para a China. Cada um Conta da AWS deve estar individualmente na lista de permissões para envio para a China, independentemente de a identidade de origem ser de propriedade ou compartilhada por meio dela. AWS RAM Se uma conta consumidora tentar enviar para a China usando uma identidade de origem compartilhada sem sua própria lista de permissões na China, a solicitação falhará com um erro de `DESTINATION_COUNTRY_BLOCKED` validação. Para solicitar a inclusão de uma conta na China na lista de permissões, abra um caso com AWS Support. Para obter mais informações, consulte [Solicitar suporte para SMS, MMS e mensagens de voz através de Suporte](awssupport.md). **Topics** + [Pré-requisitos para compartilhar número de telefone, pool, lista de exclusão ou remetente IDs](#sharing-prereqs) + [Compartilhamento de número de telefone, pool, lista de cancelamento ou ID do remetente](#sharing-share) + [Cancelar o compartilhamento de um número de telefone compartilhado, pool, lista de cancelamento ou ID do remetente](#sharing-unshare) + [Identificação de um número de telefone compartilhado, pool, lista de cancelamento ou ID de remetente](#sharing-identify) + [Responsabilidades e permissões para número de telefone compartilhado, pool, lista de exclusão ou remetente IDs](#sharing-perms) + [Faturamento e medição](#sharing-billing) + [Cotas de instâncias](#sharing-quotas) + [Exemplo de políticas para compartilhar um ID de remetente ou número de telefone com o Amazon Pinpoint](#sharing-policy-example) + [Exemplo de política para compartilhar um ID de remetente com o Amazon Pinpoint e o Amazon SNS](#sharing-policy-example-sender-id) + [Exemplo de política para compartilhar um número de telefone com o Amazon Pinpoint e o Amazon SNS](#sharing-policy-example-phone-number) ## Pré-requisitos para compartilhar número de telefone, pool, lista de exclusão ou remetente IDs + Para compartilhar um número de telefone, pool, lista de exclusão ou ID de remetente, você deve possuí-lo em seu Conta da AWS. Isso significa que o recurso deve ser alocado ou provisionado em sua conta. Não é possível compartilhar um número de telefone, pool, lista de cancelamento de assinatura ou ID de remetente que tenha sido compartilhado com você. + Para compartilhar um número de telefone, pool, lista de cancelamento de assinatura ou ID de remetente com sua organização ou uma unidade organizacional em AWS Organizations, é necessário habilitar o compartilhamento com. AWS Organizations Para obter mais informações, consulte [Habilitar o compartilhamento com o AWS Organizations](https://docs.aws.amazon.com/ram/latest/userguide/getting-started-sharing.html#getting-started-sharing-orgs) no *Guia do usuário do AWS RAM *. ## Compartilhamento de número de telefone, pool, lista de cancelamento ou ID do remetente Ao compartilhar um recurso que você possui com outras pessoas Contas da AWS, você permite que elas façam o seguinte: + **Lista de cancelamento** — Os consumidores com acesso a esse recurso podem verificar o status de um número de telefone, remover um número de telefone e adicionar números de telefone à lista de exclusão. + **PhoneNumber**— Consumidores com acesso a esse recurso podem usar o número de telefone para enviar mensagens. + **Pool** — Os consumidores com acesso a este recurso podem visualizar o grupo. Todos os recursos contidos no pool também devem ser compartilhados Contas da AWS para que outros possam acessá-los. Você pode ter uma combinação de recursos compartilhados e não compartilhados em um pool. + **ID do remetente** — Os consumidores com acesso a esse recurso podem usar o ID do remetente para enviar mensagens. Para compartilhar um número de telefone, pool, lista de cancelamento ou ID do remetente, você deve adicioná-lo a um compartilhamento de recursos. Um compartilhamento de recursos é um recurso do AWS RAM que permite que você compartilhe seus recursos entre Contas da AWS. Um compartilhamento de recursos especifica os recursos a serem compartilhados, e os clientes com os quais compartilhá-los. Ao compartilhar um número de telefone, pool, lista de exclusão ou ID de remetente usando o console SMS do AWS End User Messaging, você o adiciona a um compartilhamento de recursos existente. Para adicionar o número de telefone, pool, lista de cancelamento ou ID do remetente a um novo compartilhamento de recursos, você deve primeiro criar o compartilhamento de recursos usando o console [AWS RAM](https://console.aws.amazon.com/ram). Se você faz parte de uma organização AWS Organizations e o compartilhamento dentro de sua organização está ativado, os consumidores em sua organização recebem automaticamente acesso ao número de telefone compartilhado, pool, lista de exclusão ou ID do remetente. Caso contrário, os consumidores recebem um convite para participar do compartilhamento de recursos e têm acesso ao número de telefone compartilhado, ao pool, à lista de cancelamento ou ao ID do remetente após aceitarem o convite. Você pode compartilhar um número de telefone, pool, lista de exclusão ou ID de remetente de sua propriedade usando o console SMS do AWS End User Messaging, o AWS RAM console ou o. AWS CLI **nota** Os recursos compartilhados só podem ser usados por meio da AWS CLI [API AWS End User Messaging SMS and Voice v2](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/Welcome.html). Para usar um recurso compartilhado, você deve usar o nome do recurso da Amazon (ARN) completo. Para visualizar os recursos compartilhados com sua conta, você deve usar o console AWS CLI ou o [AWS RAM console](https://console.aws.amazon.com/ram). Recomendamos usar o [AWS RAM console](https://console.aws.amazon.com/ram) para compartilhar recursos. **Para compartilhar um número de telefone, pool, lista de exclusão ou ID de remetente que você possui usando o console SMS do AWS End User Messaging** 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações**, escolha o tipo de recurso e, em seguida, o recurso. 1. Na guia **Política de recursos**, escolha **Editar**. 1. Você pode editar a política baseada em recursos do JSON para alterar as permissões de compartilhamento. 1. Escolha **Salvar alterações**. **Para compartilhar um número de telefone, pool, lista de exclusão ou ID de remetente que você possui usando o console AWS RAM** Consulte [Criar um compartilhamento de recursos](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-create) no *Manual do usuário do AWS RAM *. **Para compartilhar um número de telefone, pool, lista de exclusão ou ID de remetente que você possui usando o AWS CLI** Use o comando [create-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/create-resource-share.html). ## Cancelar o compartilhamento de um número de telefone compartilhado, pool, lista de cancelamento ou ID do remetente Quando o proprietário de um atributo deixa de compartilhar um número de telefone, pool, lista de cancelamento ou ID de remetente com um consumidor, o recurso não aparece mais no console do consumidor. Para cancelar o compartilhamento de um número de telefone, pool, lista de cancelamento ou ID de remetente compartilhado que você possui, é necessário removê-lo do compartilhamento de recursos. Você pode fazer isso usando o console SMS do AWS End User Messaging, o AWS RAM console ou AWS CLI o. **Para cancelar o compartilhamento de um número de telefone compartilhado, pool, lista de exclusão ou ID de remetente que você possui usando o console AWS RAM** Consulte [Atualização de um compartilhamento de atributos](https://docs.aws.amazon.com/ram/latest/userguide/working-with-sharing.html#working-with-sharing-update) no *Guia do usuário do AWS RAM *. **Para cancelar o compartilhamento de um número de telefone compartilhado, pool, lista de exclusão ou ID de remetente que você possui usando o AWS CLI** Use o comando [disassociate-resource-share](https://docs.aws.amazon.com/cli/latest/reference/ram/disassociate-resource-share.html). ## Identificação de um número de telefone compartilhado, pool, lista de cancelamento ou ID de remetente Proprietários e consumidores podem identificar o número de telefone compartilhado, o pool, a lista de exclusão ou o remetente usando o. IDs AWS CLI **nota** Números de telefone, pools, listas de exclusão e remetente geralmente não IDs são identificáveis como um recurso compartilhado no console SMS do AWS End User Messaging. **Para identificar um número de telefone compartilhado, pool, lista de exclusão ou ID de remetente usando o AWS CLI** Use o [describe-sender-ids](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html)comando [describe-opt-out-lists](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-opt-out-lists.html), [describe-phone-numbers](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-phone-numbers.html), [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) ou com o `Owner` parâmetro definido como. `SHARED` O comando retorna o número de telefone, o pool, a lista de exclusão ou o remetente IDs que são compartilhados com você. ## Responsabilidades e permissões para número de telefone compartilhado, pool, lista de exclusão ou remetente IDs ### Permissões para proprietários Os proprietários podem atualizar, visualizar, compartilhar, interromper o compartilhamento e usar o número de telefone, o pool, a lista de exclusão ou o remetente. IDs ### Permissões para clientes Os consumidores podem usar e visualizar o número de telefone, o pool, a lista de exclusão ou o remetente. IDs ## Faturamento e medição O proprietário do atributo é cobrado pelo atributo. Os consumidores não são cobrados pelos atributos compartilhados com eles, mas pelo uso de recursos para enviar mensagens. Não há custos extras associados ao compartilhamento de um atributo. Os consumidores são cobrados pelo envio de uma mensagem com [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html)ou [send-text-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-text-message.html), [send-voice-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-voice-message.html)e isso conta contra os limites de gastos dos consumidores. Para obter mais informações sobre preços ou limites de gastos, consulte [Preços do AWS End User Messaging](https://aws.amazon.com//end-user-messaging/pricing/) e [Defina um limite de gastos com SMS, MMS ou voz no AWS End User Messaging SMS](spend-limit.md). ## Cotas de instâncias Compartilhar um atributo não afeta os limites do atributo na conta do proprietário ou do consumidor. Somente a conta do proprietário é usada para calcular os limites do atributo. ## Exemplo de políticas para compartilhar um ID de remetente ou número de telefone com o Amazon Pinpoint Recomendamos que você use o [console do AWS RAM](https://console.aws.amazon.com/ram) para criar e gerenciar compartilhamentos de recursos. O exemplo a seguir permite que o Amazon Pinpoint envie mensagens SMS ou de voz com o número de telefone especificado. **Para compartilhar um número de telefone que você possui usando o console AWS End User Messaging SMS** 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações**, selecione **Números de telefone**. e, em seguida, escolha um número de telefone. 1. Na guia **Política de recursos**, escolha **Editar**. 1. Você pode editar a política baseada em recursos do JSON para alterar as permissões de compartilhamento. No JSON a seguir, faça as seguintes alterações e cole o JSON na **política de recursos**: + {{Partition}}Substitua pela AWS partição em que o número de telefone está. + {{Region}}Substitua Região da AWS pelo número de telefone inserido. + {{Account}}Substitua pelo número da conta que possui o número de telefone. + {{Phone-id}}Substitua pelo identificador do número de telefone. 1. Escolha **Salvar alterações**. O exemplo a seguir permite que o Amazon Pinpoint envie mensagens SMS ou de voz com o ID de remetente especificado. **Para compartilhar uma ID de remetente que você possui usando o console AWS End User Messaging SMS** 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações**, escolha **Remetente IDs e escolha uma ID de remetente**. 1. Na guia **Política de recursos**, escolha **Editar**. 1. Você pode editar a política baseada em recursos do JSON para alterar as permissões de compartilhamento. No JSON a seguir, faça as seguintes alterações e cole o JSON na **política de recursos**: + {{Partition}}Substitua pela AWS partição em que o ID do remetente está. + {{Region}}Substitua pela ID Região da AWS do remetente que está inserida. + {{Account}}Substitua pelo número da conta que possui o ID do remetente. + {{Senderid}}Substitua pelo identificador do ID do remetente. + {{Countrycode}}Substitua pelo código ISO-3166 alfa-2 de duas letras do país do ID do remetente. 1. Escolha **Salvar alterações**. ## Exemplo de política para compartilhar um ID de remetente com o Amazon Pinpoint e o Amazon SNS Recomendamos que você use o [console do AWS RAM](https://console.aws.amazon.com/ram) para criar e gerenciar compartilhamentos de recursos. O exemplo a seguir permite que o Amazon Pinpoint e o Amazon SNS enviem mensagens SMS com o ID do remetente especificado. **Para compartilhar uma ID de remetente que você possui usando o console AWS End User Messaging SMS** 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações**, escolha **Remetente IDs e escolha uma ID de remetente**. 1. Na guia **Política de recursos**, escolha **Editar**. 1. Você pode editar a política baseada em recursos do JSON para alterar as permissões de compartilhamento. No JSON a seguir, faça as seguintes alterações e cole o JSON na **política de recursos**: + {{Partition}}Substitua pela AWS partição em que o número de telefone está. + {{Region}}Substitua Região da AWS pelo número de telefone inserido. + {{OwnersAccountID}}Substitua pelo número da AWS conta que possui o ID do remetente. + {{SenderID}}Substitua pelo identificador do ID do remetente. + {{ISO}}Substitua pelo código ISO-3166 alfa-2 de duas letras do país do ID do remetente. + {{ConsumersAccountID}}Substitua pelo número da AWS conta à qual dar acesso. ------ #### [ 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. Escolha **Salvar alterações**. ## Exemplo de política para compartilhar um número de telefone com o Amazon Pinpoint e o Amazon SNS Recomendamos que você use o [console do AWS RAM](https://console.aws.amazon.com/ram) para criar e gerenciar compartilhamentos de recursos. O exemplo a seguir permite que o Amazon Pinpoint e o Amazon SNS enviem mensagens SMS com o número de telefone especificado. **Para compartilhar um número de telefone que você possui usando o console AWS End User Messaging SMS** 1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/). 1. No painel de navegação, em **Configurações**, selecione **Números de telefone**. e, em seguida, escolha um número de telefone. 1. Na guia **Política de recursos**, escolha **Editar**. 1. Você pode editar a política baseada em recursos do JSON para alterar as permissões de compartilhamento. No JSON a seguir, faça as seguintes alterações e cole o JSON na **política de recursos**: + {{Partition}}Substitua pela AWS partição em que o número de telefone está. + {{Region}}Substitua Região da AWS pelo número de telefone inserido. + {{OwnersAccountID}}Substitua pelo número da AWS conta que possui o número de telefone. + {{PhoneNumberID}}Substitua pelo identificador do número de telefone. + {{ConsumersAccountID}}Substitua pelo número da AWS conta à qual dar acesso. ------ #### [ 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. Escolha **Salvar alterações**.