View a markdown version of this page

Trabalhando com recursos compartilhados no AWS Mensagens SMS para o usuário final - AWS Mensagens SMS para o usuário final
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

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 AWS Mensagens SMS para o usuário final

AWS O SMS de mensagens do usuário final 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 do usuário AWS final com outras pessoas Contas da AWS ou por meio de AWS Organizations. Com AWS RAM, você compartilha recursos que possui 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 .

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

Importante

Os recursos compartilhados (números de telefone, IDs de remetentes, grupos e listas de exclusão) acessados por meio dele só AWS RAM podem ser usados com a API SMS de mensagens do usuário AWS final (por exemplo, a SendTextMessage ação). Eles não são compatíveis com:

  • Amazon SNS (PublishAPI para SMS)

  • Amazon Pinpoint (SendMessagesAPI)

  • O console SMS de mensagens do usuário AWS final

Para enviar de um recurso compartilhado, use o AWS CLI ou an com o Nome de recurso da Amazon (ARN) completo do recurso na chamada de SendTextMessage API.

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 autorizado 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ão na China, a solicitação falhará com um erro de DESTINATION_COUNTRY_BLOCKED validação.

Para solicitar uma conta na lista de permissões da China, 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.

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 em AWS 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 recurso que você possui com outras pessoas Contas da AWS, você permite que elas façam o seguinte:

  • Opt-Out Lista — 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. Quando você compartilha um número de telefone, pool, lista de exclusão ou ID do remetente usando o console SMS de mensagens do usuário AWS final, 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ê fizer parte de uma organização AWS Organizations e o compartilhamento em sua organização estiver ativado, os consumidores em sua organização receberão 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 de mensagens do usuário AWS final, o AWS RAM console ou o. AWS CLI

nota

Os recursos compartilhados só podem ser usados por meio da API AWS CLI ou AWS End User Messaging SMS and Voice v2. Você deve usar o Nome de recurso da Amazon (ARN) completo do recurso compartilhado. O envio via Amazon SNS, Amazon Pinpoint ou pelo console de SMS de mensagens do usuário AWS final não é compatível com recursos compartilhados.

Para visualizar os recursos compartilhados com sua conta, você deve usar o AWS CLI ou o AWS RAM console.

Recomendamos usar o AWS RAM console para compartilhar recursos.

Para compartilhar um número de telefone, pool, lista de exclusão ou ID de remetente que você possui usando o AWS Console de mensagens SMS para o usuário final

  1. Abra o console SMS de mensagens do usuário AWS final 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 AWS RAM console

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 de mensagens do usuário AWS final, 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 AWS RAM console

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 compartilhado, pool, lista de exclusão ou ID de remetente 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, grupos, listas de exclusão e IDs de remetente geralmente não são identificáveis como um recurso compartilhado no console SMS de mensagens do usuário AWS final.

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 Preços do AWS End User Messaging e Defina um limite de gastos com SMS, MMS ou voz em AWS Mensagens SMS para o usuário final.

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 AWS Console de mensagens SMS para o usuário final

  1. Abra o console SMS de mensagens do usuário AWS final 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:

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

    • RegionSubstitua Região da AWS pela entrada do número de telefone.

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

    • Phone-idSubstitua 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 uma ID de remetente que você possui usando o AWS Console de mensagens SMS para o usuário final

  1. Abra o console SMS de mensagens do usuário AWS final 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:

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

    • RegionSubstitua pela ID Região da AWS do remetente em que está.

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

    • SenderidSubstitua pelo identificador do ID do remetente.

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

  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 AWS Console de mensagens SMS para o usuário final

  1. Abra o console SMS de mensagens do usuário AWS final 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:

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

    • RegionSubstitua Região da AWS pela entrada do número de telefone.

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

    • SenderIDSubstitua pelo identificador do ID do remetente.

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

    • ConsumersAccountIDSubstitua 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 AWS Console de mensagens SMS para o usuário final

  1. Abra o console SMS de mensagens do usuário AWS final 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:

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

    • RegionSubstitua Região da AWS pela entrada do número de telefone.

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

    • PhoneNumberIDSubstitua pelo identificador do número de telefone.

    • ConsumersAccountIDSubstitua 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.