Trabalhando com recursos compartilhados no AWS End User Messaging SMS - AWS End User Messaging SMS
Pré-requisitos para compartilhar número de telefone, pool, lista de exclusão ou IDs de remetenteCompartilhamento de número de telefone, pool, lista de cancelamento ou ID do remetenteCancelar o compartilhamento de um número de telefone compartilhado, pool, lista de cancelamento ou ID do remetenteIdentificação de um número de telefone compartilhado, pool, lista de cancelamento ou ID de remetenteResponsabilidades e permissões para número de telefone compartilhado, pool, lista de exclusão ou IDs de remetenteFaturamento e mediçãoCotas de instânciasExemplo de políticas para compartilhar um ID de remetente ou número de telefone com o Amazon PinpointExemplo de política para compartilhar um ID de remetente com o Amazon Pinpoint e o Amazon SNSExemplo de política para compartilhar um número de telefone com o Amazon Pinpoint e o Amazon SNS

Trabalhando com recursos compartilhados no AWS End User Messaging SMS

AWS End User Messaging SMS integra-se ao AWS Resource Access Manager (AWS RAM) para permitir o compartilhamento de recursos. AWS RAM é um serviço que permite compartilhar alguns recursos do AWS End User Messaging SMS com outras contas Contas da AWS ou por meio de AWS Organizations. Com o AWS RAM, você compartilha recursos que possui criando um compartilhamento de recursos. Um compartilhamento de recursos especifica os recursos a serem compartilhados, e os consumidores com os quais compartilhá-los. Os consumidores podem incluir:

  • Contas específicas da Contas da AWS dentro ou fora de sua organização no AWS Organizations

  • Uma unidade organizacional dentro da organização no AWS Organizations

  • Toda a organização no AWS Organizations

  • Outros AWS serviços, como Amazon Pinpoint ou Amazon SNS

Para obter mais informações sobre o AWS RAM, consulte o Guia do usuário do AWS RAM.

Este tópico explica como compartilhar recursos que você possui e como usar os recursos que são compartilhados com você.

Pré-requisitos para compartilhar número de telefone, pool, lista de exclusão ou IDs de remetente

  • 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 emAWS Organizations, é necessário habilitar o compartilhamento com. AWS Organizations Para obter mais informações, consulte Habilitar o compartilhamento com o AWS Organizations 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 atributo de sua propriedade com outras 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 — Os 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 cancelamento ou ID de remetente usando o console do AWS End User Messaging SMS, 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.

Se você faz parte de uma organização em AWS Organizations e o compartilhamento dentro da sua organização está habilitado, os consumidores da sua organização recebem automaticamente acesso ao número de telefone compartilhado, ao pool, à lista de cancelamento ou ao 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.

É possível compartilhar um número de telefone, pool, lista de cancelamento ou ID de remetente que você possui usando o console do AWS End User Messaging SMS, o console do AWS RAM ou o AWS CLI.

nota

Os recursos compartilhados só podem ser usados por meio da AWS CLI ou da API AWS End User Messaging SMS and Voice v2. 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 RAMconsole.

Recomendamos usar o AWS RAMconsole para compartilhar recursos.

Para compartilhar um número de telefone, pool, lista de cancelamento ou ID de remetente que você possui usando o console do AWS End User Messaging SMS.

  1. Abra o console do AWS End User Messaging SMS em https://console.aws.amazon.com/sms-voice/.

  2. No painel de navegação, em Configurações, escolha o tipo de recurso e, em seguida, o recurso.

  3. Na guia Política de recursos, escolha Editar.

  4. Você pode editar a política baseada em recursos do JSON para alterar as permissões de compartilhamento.

  5. 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 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.

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, pool, lista de cancelamento ou ID de remetente compartilhado que você possui usando o console AWS RAM.

Consulte Atualização de um compartilhamento de atributos no Guia do usuário do AWS RAM.

Para cancelar o compartilhamento de um número de telefone, pool, lista de cancelamento ou ID de remetente compartilhado que você possui usando o AWS CLI.

Use o comando disassociate-resource-share.

Identificação de um número de telefone compartilhado, pool, lista de cancelamento ou ID de remetente

Proprietários e consumidores podem identificar números de telefone compartilhados, pool, lista de cancelamento ou IDs de remetente usando o AWS CLI.

nota

Números de telefone, pools, listas de cancelamento e IDs de remetente geralmente não são identificáveis como um recurso compartilhado no console do AWS End User Messaging SMS.

Para identificar um número de telefone compartilhado, pool, lista de exclusão ou ID do remetente usando o AWS CLI

Use o comando describe-opt-out-lists, describe-phone-numbers, describe-pools ou describe-sender-ids com o parâmetro Owner definido como SHARED. O comando retorna o número de telefone, pool, lista de cancelamento ou IDs de remetente que são compartilhados com você.

Responsabilidades e permissões para número de telefone compartilhado, pool, lista de exclusão ou IDs de remetente

Permissões para proprietários

Os proprietários podem atualizar, visualizar, compartilhar, interromper o compartilhamento e usar número de telefone, pool, lista de cancelamento ou IDs de remetente.

Permissões para clientes

Os consumidores podem usar e visualizar o número de telefone, o pool, a lista de cancelamento ou os IDs do remetente.

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 mensagens com send-text-message, send-media-message ou send-voice-message, e isso conta para os limites de gastos dos consumidores. Para obter mais informações sobre preços ou limites de gastos, consulte AWS Preços End User Messaging e Defina um limite de gastos com SMS, MMS ou voz no AWS End User Messaging SMS.

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 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 do AWS End User Messaging SMS

  1. Abra o console do AWS End User Messaging SMS em https://console.aws.amazon.com/sms-voice/.

  2. No painel de navegação, em Configurações, selecione Números de telefone. e, em seguida, escolha um número de telefone.

  3. Na guia Política de recursos, escolha Editar.

  4. 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:

    • Substitua a partição pela partição AWS em que o número de telefone está.

    • Substitua Região pelo número de telefone Região da AWS em que está.

    • Substitua Conta pelo número da conta que possui o número de telefone.

    • Substitua o ID do telefone pelo identificador do número de telefone.

  5. 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 um ID de remetente que você possui usando o console do AWS End User Messaging SMS

  1. Abra o console do AWS End User Messaging SMS em https://console.aws.amazon.com/sms-voice/.

  2. No painel de navegação, em Configurações, escolha IDs de remetente e, em seguida, escolha uma ID de remetente.

  3. Na guia Política de recursos, escolha Editar.

  4. 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:

    • Substitua a partição pela AWS partição em que o ID do remetente está.

    • Substitua Região pela Região da AWS ID do remetente.

    • Substitua Conta pelo número da conta que possui o ID do remetente.

    • Substitua Senderid pelo identificador do ID do remetente.

    • Substitua Countrycode pelo código ISO-3166 alfa-2 de duas letras para o país do ID de origem.

  5. 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 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 um ID de remetente que você possui usando o console do AWS End User Messaging SMS

  1. Abra o console do AWS End User Messaging SMS em https://console.aws.amazon.com/sms-voice/.

  2. No painel de navegação, em Configurações, escolha IDs de remetente e, em seguida, escolha uma ID de remetente.

  3. Na guia Política de recursos, escolha Editar.

  4. 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:

    • Substitua a partição pela partição AWS em que o número de telefone está.

    • Substitua Região pelo número de telefone Região da AWS em que está.

    • Substitua OwnersAccountID pelo número da AWS conta que possui o ID do remetente.

    • Substitua SenderID pelo identificador do ID do remetente.

    • Substitua ISO pelo código ISO-3166 alfa-2 de duas letras para o país do ID de origem.

    • Substitua ConsumersAccountID 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"
        }
    ]
}

  5. 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 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 do AWS End User Messaging SMS

  1. Abra o console do AWS End User Messaging SMS em https://console.aws.amazon.com/sms-voice/.

  2. No painel de navegação, em Configurações, selecione Números de telefone. e, em seguida, escolha um número de telefone.

  3. Na guia Política de recursos, escolha Editar.

  4. 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:

    • Substitua a partição pela partição AWS em que o número de telefone está.

    • Substitua Região pelo número de telefone Região da AWS em que está.

    • Substitua OwnersAccountID pelo número da conta AWS que possui o número de telefone.

    • Substitua PhoneNumberID pelo identificador do número de telefone.

    • Substitua ConsumersAccountID 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"
        }
    ]
}

  5. Escolha Salvar alterações.