View a markdown version of this page

Utilisation de ressources partagées dansAWSMessagerie SMS à l'utilisateur final - AWSMessagerie SMS à l'utilisateur final
Conditions préalables au partage d'un numéro de téléphone, d'un pool, d'une liste de désinscription ou d'un identifiant 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ésIdentification 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ésResponsabilité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 relatives au partage d'un identifiant d'expéditeur ou d'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 dansAWSMessagerie SMS à l'utilisateur final

AWSLes SMS de messagerie destinés aux utilisateurs finaux s'intègrent à AWS Resource Access Manager (AWS RAM) pour permettre le partage des ressources. AWS RAMest un service qui vous permet de partager certaines ressources de messagerie SMS destinées aux utilisateurs AWS finaux avec d'autres personnes Comptes AWS ou par le biais de celles-ciAWS Organizations. AvecAWS 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 dans AWS Organizations

  • Toute son organisation en AWS Organizations

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

Pour plus d'informationsAWS 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éditeurs, pools et listes de désinscription) accessibles via ne AWS RAM peuvent être utilisées qu'avec l'API SMS de messagerie utilisateur AWS final (par exemple, l'SendTextMessageaction). Ils ne sont pas pris en charge par :

  • Amazon SNS (PublishAPI pour SMS)

  • Amazon Pinpoint (API) SendMessages

  • 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 Amazon Resource Name (ARN) complet de la ressource dans l'appel SendTextMessage d'API.

Important

Le partage de l'identité d'origine avec d'autres utilisateurs n'Comptes AWSautorise pas ces comptes à envoyer des messages en Chine. Chacun d'entre eux Compte AWS doit être individuellement autorisé à être envoyé en Chine, que l'identité d'origine soit détenue ou partagée par. AWS RAM Si un compte consommateur tente d'envoyer vers la Chine en utilisant une identité d'origine partagée sans sa propre liste d'autorisation en Chine, la demande échouera en raison d'une erreur de DESTINATION_COUNTRY_BLOCKED validation.

Pour demander l'autorisation d'ouvrir un compte en Chine, 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 préalables au 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

  • Pour partager un numéro de téléphone, un pool, une liste de désinscription ou un identifiant d'expéditeur, vous devez le posséder dans votreCompte 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 ont été partagés 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 une unité organisationnelleAWS Organizations, vous devez activer le partage avecAWS 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 personnesComptes AWS, vous leur permettez d'effectuer les opérations suivantes :

  • Opt-Out Liste — Les consommateurs ayant accès à cette ressource peuvent vérifier le statut 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.

  • Piscine — Les consommateurs ayant accès à cette ressource peuvent consulter la piscine. 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 un mélange de ressources partagées et non partagées dans un pool.

  • ID 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 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 RAMconsole.

Si vous faites partie d'une organisation AWS Organizations et que le partage au sein de votre organisation est activé, les clients de votre organisation ont automatiquement accès au numéro de téléphone, au pool, à la liste de désinscription ou à l'identifiant d'expéditeur partagés. 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, au pool, à la liste de désinscription ou à l'identifiant d'expéditeur partagés 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 utilisateur AWS final, de la AWS RAM console ou duAWS CLI.

Note

Les ressources partagées ne peuvent être utilisées que via l'AWS CLIAPI AWS Final User Messaging SMS and Voice v2. Vous devez utiliser le nom Amazon Resource Name (ARN) complet de la ressource partagée. L'envoi via Amazon SNS, Amazon Pinpoint ou AWS la console SMS de messagerie utilisateur 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 console AWS CLI ou la AWS RAMconsole.

Nous vous recommandons d'utiliser la AWS RAMconsole 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 duAWSConsole de messagerie SMS pour utilisateurs finaux

  1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à 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 duAWS RAMconsole

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 duAWS 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 arrête 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, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur que vous possédez, vous devez le supprimer du partage de ressources. Vous pouvez le faire à l'aide de la console SMS de messagerie utilisateur AWS final, de la AWS RAM console ou duAWS CLI.

Pour 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 à l'aide duAWS RAMconsole

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, d'un pool, d'une liste de désinscription ou d'un identifiant d'expéditeur partagés à l'aide duAWS CLI

Utilisez la commande disassociate-resource-share.

Identification 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

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 duAWS 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 utilisateur AWS final.

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

Utilisez les commandes describe-opt-out-lists, describe-phone-numbers, describe-pools ou describe-sender-ids avec le paramètre défini sur. 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 un numéro de téléphone, un pool, une liste de désinscription ou des identifiants d'expéditeur.

Autorisations accordées aux consommateurs

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

Facturation et mesures

Le propriétaire de la ressource est facturé pour 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 sous forme d'envoi de message texte, d'envoi de message multimédia ou d'envoi de message vocal, cequi est pris en compte dans les limites de dépenses des consommateurs. Pour plus d'informations sur les prix ou les limites de dépenses, consultez les sections Tarification des messages destinés aux utilisateurs AWS finaux etDéfinissez une limite de dépenses pour les SMS, les MMS ou les appels vocaux dansAWSMessagerie SMS à l'utilisateur final.

Quotas d'instances

Le partage d'une ressource n'a aucune incidence sur 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 relatives au partage d'un identifiant d'expéditeur ou d'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 dont vous êtes propriétaire à l'aide duAWSConsole de messagerie SMS pour utilisateurs finaux

  1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, sélectionnez 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 indiqué.

    • Remplacez Account 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'identifiant d'expéditeur spécifié.

Pour partager un identifiant d'expéditeur dont vous êtes le propriétaire à l'aide duAWSConsole de messagerie SMS pour utilisateurs finaux

  1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, sélectionnez Sender IDs, puis choisissez un ID expéditeur.

  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'identifiant de l'expéditeur.

    • Remplacez Region par Région AWS l'identifiant de l'expéditeur indiqué.

    • Remplacez Account par le numéro de compte associé à l'identifiant de l'expéditeur.

    • Remplacez Senderid par l'identifiant de l'expéditeur.

    • CountrycodeRemplacez-le 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'identifiant d'expéditeur spécifié.

Pour partager un identifiant d'expéditeur dont vous êtes le propriétaire à l'aide duAWSConsole de messagerie SMS pour utilisateurs finaux

  1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, sélectionnez Sender IDs, puis choisissez un ID expéditeur.

  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 indiqué.

    • Remplacez OwnersAccountID par le numéro de AWS compte associé à l'identifiant de l'expéditeur.

    • Remplacez SenderID par l'identifiant de l'expéditeur.

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

    • Remplacez ConsumersAccountID 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 dont vous êtes propriétaire à l'aide duAWSConsole de messagerie SMS pour utilisateurs finaux

  1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, sélectionnez 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 indiqué.

    • Remplacez OwnersAccountID 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.

    • Remplacez ConsumersAccountID 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.