View a markdown version of this page

Utilisation de ressources partagées dans AWS Messagerie SMS pour l'utilisateur final - AWS Messagerie SMS pour l'utilisateur final
Conditions requises pour partager un numéro de téléphone, un pool, une liste de désinscription ou des identifiants d'expéditeurPartage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeurAnnuler le partage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur partagésIdentifier un numéro de téléphone partagé, un pool, une liste de désinscription ou un identifiant d'expéditeurResponsabilités et autorisations relatives au numéro de téléphone partagé, au pool, à la liste de désinscription ou aux identifiants d'expéditeurFacturation et mesuresQuotas d'instancesExemples de politiques pour partager un identifiant d'expéditeur ou un numéro de téléphone avec Amazon PinpointExemple de politique de partage d'un identifiant d'expéditeur avec Amazon Pinpoint et Amazon SNSExemple de politique de partage d'un numéro de téléphone avec Amazon Pinpoint et Amazon SNS

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de ressources partagées dans AWS Messagerie SMS pour l'utilisateur final

AWS La messagerie SMS destinée aux utilisateurs finaux s'intègre à AWS Resource Access Manager (AWS RAM) pour permettre le partage des ressources. AWS RAM est un service qui vous permet de partager certaines ressources SMS de messagerie des utilisateurs AWS finaux avec d'autres Comptes AWS personnes ou via AWS Organizations. Avec AWS RAM, vous partagez les ressources que vous possédez en créant un partage de ressources. Un partage de ressources spécifie les ressources à partager, ainsi que les consommateurs avec qui elles seront partagées. Les consommateurs peuvent être :

  • Spécifique Comptes AWS à l'intérieur ou à l'extérieur de son organisation dans AWS Organizations

  • Une unité organisationnelle au sein de son organisation en AWS Organizations

  • L'ensemble de son organisation en AWS Organizations

  • Autres AWS services tels qu'Amazon Pinpoint ou Amazon SNS

Pour plus d'informations à ce sujet AWS RAM, consultez le Guide de AWS RAM l'utilisateur .

Cette rubrique explique comment partager les ressources que vous possédez et comment utiliser les ressources qui sont partagées avec vous.

Important

Les ressources partagées (numéros de téléphone, identifiants d'expéditeur, pools et listes de désinscription) accessibles via ne AWS RAM peuvent être utilisées qu'avec l'API SMS de messagerie des utilisateurs AWS finaux (par exemple, l'SendTextMessageaction). Ils ne sont pas pris en charge par :

  • Amazon SNS (PublishAPI pour SMS)

  • Amazon Pinpoint (SendMessagesAPI)

  • La console de messagerie SMS pour l'utilisateur AWS final

Pour envoyer depuis une ressource partagée, utilisez le AWS CLI ou un avec le nom de ressource Amazon (ARN) complet de la ressource dans l'appel SendTextMessage d'API.

Important

Le partage des identités d'origine avec d'autres comptes Comptes AWS n'autorise pas ces comptes à envoyer des messages en Chine. Chacun Compte AWS doit être autorisé individuellement pour l'envoi vers la Chine, que l'identité d'origine soit détenue ou partagée via. AWS RAM Si un compte utilisateur tente d'envoyer des fonds vers la Chine en utilisant une identité d'origine partagée sans disposer de sa propre liste d'autorisation en Chine, la demande échouera avec une erreur de DESTINATION_COUNTRY_BLOCKED validation.

Pour demander à la Chine d'autoriser la création d'un compte, ouvrez un dossier auprès AWS Support de. Pour de plus amples informations, veuillez consulter Demande d'assistance pour les SMS, les MMS et la messagerie vocale via Support.

Conditions requises pour partager un numéro de téléphone, un pool, une liste de désinscription ou des identifiants d'expéditeur

  • Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur, vous devez en être le propriétaire dans votre Compte AWS. Cela signifie que la ressource doit être allouée ou provisionnée dans votre compte. Vous ne pouvez pas partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur qui a été partagé avec vous.

  • Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur avec votre organisation ou l'une de ses unités organisationnelles AWS Organizations, vous devez activer le partage avec AWS Organizations. Pour plus d’informations, consultez Activation du partage avec AWS Organizations dans le Guide de l’utilisateur AWS RAM .

Partage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur

Lorsque vous partagez une ressource que vous possédez avec d'autres personnes Comptes AWS, vous leur permettez d'effectuer les opérations suivantes :

  • Opt-Out Liste — Les consommateurs ayant accès à cette ressource peuvent vérifier l'état d'un numéro de téléphone, supprimer un numéro de téléphone et ajouter des numéros de téléphone à la liste de désinscription.

  • PhoneNumber— Les consommateurs ayant accès à cette ressource peuvent utiliser le numéro de téléphone pour envoyer des messages.

  • Pool — Les consommateurs ayant accès à cette ressource peuvent consulter le pool. Toutes les ressources contenues dans le pool doivent également être partagées pour que d'autres Comptes AWS puissent y accéder. Vous pouvez avoir une combinaison de ressources partagées et non partagées dans un pool.

  • Identifiant de l'expéditeur — Les consommateurs ayant accès à cette ressource peuvent utiliser l'identifiant de l'expéditeur pour envoyer des messages.

Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur, vous devez l'ajouter à un partage de ressources. Un partage de ressources est une ressource AWS RAM qui vous permet de partager vos ressources entre des Comptes AWS. Un partage de ressources spécifie les ressources à partager, ainsi que les consommateurs avec qui elles seront partagées. Lorsque vous partagez un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur à l'aide de la console SMS de messagerie de l'utilisateur AWS final, vous l'ajoutez à un partage de ressources existant. Pour ajouter le numéro de téléphone, le pool, la liste de désinscription ou l'identifiant de l'expéditeur à un nouveau partage de ressources, vous devez d'abord créer le partage de ressources à l'aide de la AWS RAM console.

Si vous faites partie d'une organisation AWS Organizations et que le partage au sein de votre organisation est activé, les consommateurs de votre organisation ont automatiquement accès au numéro de téléphone partagé, au pool, à la liste de désinscription ou à l'identifiant d'expéditeur. Dans le cas contraire, les consommateurs reçoivent une invitation à rejoindre le partage de ressources et ont accès au numéro de téléphone partagé, au pool, à la liste de désinscription ou à l'identifiant de l'expéditeur après avoir accepté l'invitation.

Vous pouvez partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur que vous possédez à l'aide de la console SMS de messagerie des utilisateurs AWS finaux, de la AWS RAM console ou du AWS CLI.

Note

Les ressources partagées ne peuvent être utilisées que par le AWS CLI biais de l'API SMS et Voice v2 de messagerie pour les utilisateurs AWS finaux. Vous devez utiliser le nom de ressource Amazon (ARN) complet de la ressource partagée. L'envoi via Amazon SNS, Amazon Pinpoint ou la console SMS de messagerie de l'utilisateur AWS final n'est pas pris en charge pour les ressources partagées.

Pour consulter les ressources partagées avec votre compte, vous devez utiliser la AWS CLI ou la AWS RAM console.

Nous vous recommandons d'utiliser la AWS RAM console pour partager des ressources.

Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur dont vous êtes propriétaire à l'aide du AWS Console de messagerie SMS pour l'utilisateur final

  1. Ouvrez la console de messagerie SMS destinée aux utilisateurs AWS finaux à l'adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, choisissez le type de ressource, puis la ressource.

  3. Dans l’onglet Stratégie de ressources choisissez Modifier.

  4. Vous pouvez modifier la politique basée sur les ressources JSON pour modifier les autorisations de partage.

  5. Sélectionnez Enregistrer les modifications.

Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur dont vous êtes propriétaire à l'aide du AWS RAM console

Consultez Création d’un partage de ressources dans le Guide de l’utilisateur AWS RAM .

Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur dont vous êtes propriétaire à l'aide du AWS CLI

Utilisez la commande create-resource-share.

Annuler le partage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur partagés

Lorsqu'un propriétaire de ressource cesse de partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur avec un consommateur, la ressource n'apparaît plus dans la console du consommateur.

Pour annuler le partage d'un numéro de téléphone partagé, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur dont vous êtes propriétaire, vous devez le supprimer du partage de ressources. Vous pouvez le faire à l'aide de la console SMS de messagerie de l'utilisateur AWS final, de la AWS RAM console ou du AWS CLI.

Pour annuler le partage d'un numéro de téléphone partagé, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur dont vous êtes propriétaire à l'aide du AWS RAM console

Consultez Mise à jour d’un partage de ressources dans le Guide de l’utilisateur AWS RAM .

Pour annuler le partage d'un numéro de téléphone partagé, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur dont vous êtes propriétaire à l'aide du AWS CLI

Utilisez la commande disassociate-resource-share.

Identifier un numéro de téléphone partagé, un pool, une liste de désinscription ou un identifiant d'expéditeur

Les propriétaires et les consommateurs peuvent identifier le numéro de téléphone partagé, le pool, la liste de désinscription ou les identifiants d'expéditeur à l'aide du AWS CLI.

Note

Les numéros de téléphone, les pools, la liste de désinscription et les identifiants d'expéditeur ne sont généralement pas identifiables en tant que ressource partagée dans la console SMS de messagerie des utilisateurs AWS finaux.

Pour identifier un numéro de téléphone partagé, un pool, une liste de désinscription ou un identifiant d'expéditeur à l'aide du AWS CLI

Utilisez la commande describe-opt-out-lists, describe-phone-numbers, describe-pools ou describe-sender-ids avec le paramètre défini sur. https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html Owner SHARED La commande renvoie le numéro de téléphone, le pool, la liste de désinscription ou les identifiants d'expéditeur qui sont partagés avec vous.

Responsabilités et autorisations relatives au numéro de téléphone partagé, au pool, à la liste de désinscription ou aux identifiants d'expéditeur

Autorisations accordées aux propriétaires

Les propriétaires peuvent mettre à jour, consulter, partager, arrêter de partager et utiliser le numéro de téléphone, le pool, la liste de désinscription ou les identifiants d'expéditeur.

Autorisations accordées aux consommateurs

Les consommateurs peuvent utiliser et consulter leur numéro de téléphone, leur pool, leur liste de désinscription ou leurs identifiants d'expéditeur.

Facturation et mesures

La ressource est facturée au propriétaire de la ressource. Les consommateurs ne sont pas facturés pour les ressources partagées avec eux, mais pour l'utilisation de ressources pour envoyer des messages. Le partage d'une ressource n'entraîne aucun coût supplémentaire.

Les consommateurs sont facturés pour l'envoi d'un message contenant un message texte, un message multimédia ou un message vocal, et cela est pris en compte dans les limites de dépenses des consommateurs. Pour plus d'informations sur les tarifs ou les limites de dépenses, voir Tarification de la messagerie destinée aux utilisateurs AWS finaux etDéfinissez une limite de dépenses pour les SMS, les MMS ou les appels vocaux dans AWS Messagerie SMS pour l'utilisateur final.

Quotas d'instances

Le partage d'une ressource n'affecte pas les limites de la ressource sur le compte du propriétaire ou du consommateur. Seul le compte du propriétaire est utilisé pour calculer les limites de la ressource.

Exemples de politiques pour partager un identifiant d'expéditeur ou un numéro de téléphone avec Amazon Pinpoint

Nous vous recommandons d’utiliser la console AWS RAM pour créer et gérer des partages de ressources.

L'exemple suivant permet à Amazon Pinpoint d'envoyer des SMS ou des messages vocaux avec le numéro de téléphone spécifié.

Pour partager un numéro de téléphone qui vous appartient à l'aide du AWS Console de messagerie SMS pour l'utilisateur final

  1. Ouvrez la console de messagerie SMS destinée aux utilisateurs AWS finaux à l'adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, choisissez Numéros de téléphone, puis choisissez un numéro de téléphone.

  3. Dans l’onglet Stratégie de ressources choisissez Modifier.

  4. Vous pouvez modifier la politique basée sur les ressources JSON pour modifier les autorisations de partage.

    Dans le JSON suivant, apportez les modifications suivantes, puis collez le JSON dans la politique de ressources  :

    • Remplacez le numéro Partition de téléphone par la AWS partition dans laquelle se trouve le numéro de téléphone.

    • Remplacez Region par Région AWS le numéro de téléphone saisi.

    • AccountRemplacez-le par le numéro de compte auquel appartient le numéro de téléphone.

    • Remplacez Phone-id par l'identifiant du numéro de téléphone.

  5. Sélectionnez Enregistrer les modifications.

L'exemple suivant permet à Amazon Pinpoint d'envoyer des SMS avec l'ID d'expéditeur spécifié.

Pour partager un identifiant d'expéditeur qui vous appartient à l'aide du AWS Console de messagerie et SMS pour l'utilisateur final

  1. Ouvrez la console de messagerie SMS destinée aux utilisateurs AWS finaux à l'adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, choisissez Sender IDs, puis choisissez un Sender ID.

  3. Dans l’onglet Stratégie de ressources choisissez Modifier.

  4. Vous pouvez modifier la politique basée sur les ressources JSON pour modifier les autorisations de partage.

    Dans le JSON suivant, apportez les modifications suivantes, puis collez le JSON dans la politique de ressources  :

    • Remplacez Partition par la AWS partition dans laquelle se trouve l'ID de l'expéditeur.

    • Remplacez Region par Région AWS le code d'identification de l'expéditeur indiqué.

    • AccountRemplacez-le par le numéro de compte auquel appartient l'identifiant de l'expéditeur.

    • SenderidRemplacez-le par l'identifiant de l'identifiant de l'expéditeur.

    • Remplacez-le Countrycode par le code ISO-3166 alpha-2 à deux lettres correspondant au pays de l'identifiant de l'expéditeur.

  5. Sélectionnez Enregistrer les modifications.

Exemple de politique de partage d'un identifiant d'expéditeur avec Amazon Pinpoint et Amazon SNS

Nous vous recommandons d’utiliser la console AWS RAM pour créer et gérer des partages de ressources.

L'exemple suivant permet à Amazon Pinpoint et Amazon SNS d'envoyer des SMS avec l'ID d'expéditeur spécifié.

Pour partager un identifiant d'expéditeur qui vous appartient à l'aide du AWS Console de messagerie SMS pour l'utilisateur final

  1. Ouvrez la console de messagerie SMS destinée aux utilisateurs AWS finaux à l'adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, choisissez Sender IDs, puis choisissez un Sender ID.

  3. Dans l’onglet Stratégie de ressources choisissez Modifier.

  4. Vous pouvez modifier la politique basée sur les ressources JSON pour modifier les autorisations de partage.

    Dans le JSON suivant, apportez les modifications suivantes, puis collez le JSON dans la politique de ressources  :

    • Remplacez Partition par la AWS partition dans laquelle se trouve le numéro de téléphone.

    • Remplacez Region par Région AWS le numéro de téléphone saisi.

    • OwnersAccountIDRemplacez-le par le numéro de AWS compte auquel appartient l'identifiant de l'expéditeur.

    • SenderIDRemplacez-le par l'identifiant de l'identifiant de l'expéditeur.

    • Remplacez-le ISO par le code ISO-3166 alpha-2 à deux lettres correspondant au pays de l'identifiant de l'expéditeur.

    • ConsumersAccountIDRemplacez-le par le numéro de AWS compte auquel vous souhaitez donner accès.

    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. Sélectionnez Enregistrer les modifications.

Exemple de politique de partage d'un numéro de téléphone avec Amazon Pinpoint et Amazon SNS

Nous vous recommandons d’utiliser la console AWS RAM pour créer et gérer des partages de ressources.

L'exemple suivant permet à Amazon Pinpoint et Amazon SNS d'envoyer des SMS avec le numéro de téléphone spécifié.

Pour partager un numéro de téléphone qui vous appartient à l'aide du AWS Console de messagerie SMS pour l'utilisateur final

  1. Ouvrez la console de messagerie SMS destinée aux utilisateurs AWS finaux à l'adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, choisissez Numéros de téléphone, puis choisissez un numéro de téléphone.

  3. Dans l’onglet Stratégie de ressources choisissez Modifier.

  4. Vous pouvez modifier la politique basée sur les ressources JSON pour modifier les autorisations de partage.

    Dans le JSON suivant, apportez les modifications suivantes, puis collez le JSON dans la politique de ressources  :

    • Remplacez Partition par la AWS partition dans laquelle se trouve le numéro de téléphone.

    • Remplacez Region par Région AWS le numéro de téléphone saisi.

    • OwnersAccountIDRemplacez-le par le numéro de AWS compte auquel appartient le numéro de téléphone.

    • Remplacez PhoneNumberID par l'identifiant du numéro de téléphone.

    • ConsumersAccountIDRemplacez-le par le numéro de AWS compte auquel vous souhaitez donner accès.

    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. Sélectionnez Enregistrer les modifications.