D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

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.

# Exemples d'utilisation d'Amazon SNS AWS CLI
<a name="cli_2_sns_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide d'Amazon SNS.

Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Les *scénarios* sont des exemples de code qui vous montrent comment accomplir des tâches spécifiques en appelant plusieurs fonctions au sein d’un même service ou combinés à d’autres Services AWS.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

**Topics**
+ [Actions](#actions)
+ [Scénarios](#scenarios)

## Actions
<a name="actions"></a>

### `add-permission`
<a name="sns_AddPermission_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`add-permission`.

**AWS CLI**  
**Pour ajouter une autorisation à une rubrique**  
L'`add-permission`exemple suivant ajoute l'autorisation `987654321098` au AWS compte d'utiliser l'`Publish`action avec le sujet spécifié sous AWS compte`123456789012`.  

```
aws sns add-permission \
    --topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --label Publish-Permission \
    --aws-account-id 987654321098 \
    --action-name Publish
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, reportez-vous [AddPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/add-permission.html)à la section *Référence des AWS CLI commandes*. 

### `check-if-phone-number-is-opted-out`
<a name="sns_CheckIfPhoneNumberIsOptedOut_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`check-if-phone-number-is-opted-out`.

**AWS CLI**  
**Pour vérifier la désactivation d’un numéro de téléphone aux SMS**  
L'`check-if-phone-number-is-opted-out`exemple suivant vérifie si le numéro de téléphone spécifié est désactivé pour ne pas recevoir de SMS en provenance du AWS compte courant.  

```
aws sns check-if-phone-number-is-opted-out \
    --phone-number +1555550100
```
Sortie :  

```
{
    "isOptedOut": false
}
```
+  Pour plus de détails sur l'API, reportez-vous [CheckIfPhoneNumberIsOptedOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/check-if-phone-number-is-opted-out.html)à la section *Référence des AWS CLI commandes*. 

### `confirm-subscription`
<a name="sns_ConfirmSubscription_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`confirm-subscription`.

**AWS CLI**  
**Pour confirmer un abonnement**  
La commande `confirm-subscription` suivante termine le processus de confirmation lancé lorsque vous vous êtes abonné à une rubrique SNS nommée `my-topic`. Le paramètre --token provient du message de confirmation envoyé au point de terminaison de notification spécifié dans l’appel d’abonnement.  

```
aws sns confirm-subscription \
    --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic \
    --token 2336412f37fb687f5d51e6e241d7700ae02f7124d8268910b858cb4db727ceeb2474bb937929d3bdd7ce5d0cce19325d036bc858d3c217426bcafa9c501a2cace93b83f1dd3797627467553dc438a8c974119496fc3eff026eaa5d14472ded6f9a5c43aec62d83ef5f49109da7176391
```
Sortie :  

```
{
    "SubscriptionArn": "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
}
```
+  Pour plus de détails sur l'API, reportez-vous [ConfirmSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/confirm-subscription.html)à la section *Référence des AWS CLI commandes*. 

### `create-platform-application`
<a name="sns_CreatePlatformApplication_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`create-platform-application`.

**AWS CLI**  
**Pour créer une application de plate-forme**  
L’exemple `create-platform-application` suivant crée une application de plateforme Google Firebase à l’aide des informations d’identification de plateforme spécifiées.  

```
aws sns create-platform-application \
    --name MyApplication \
    --platform GCM \
    --attributes PlatformCredential=EXAMPLEabcd12345jklm67890stuv12345bcdef
```
Sortie :  

```
{
    "PlatformApplicationArn": "arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication"
}
```
+  Pour plus de détails sur l'API, reportez-vous [CreatePlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/create-platform-application.html)à la section *Référence des AWS CLI commandes*. 

### `create-topic`
<a name="sns_CreateTopic_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`create-topic`.

**AWS CLI**  
**Pour créer une rubrique SNS**  
L’exemple `create-topic` suivant crée une rubrique SNS nommée `my-topic`.  

```
aws sns create-topic \
    --name my-topic
```
Sortie :  

```
{
    "ResponseMetadata": {
        "RequestId": "1469e8d7-1642-564e-b85d-a19b4b341f83"
    },
    "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
}
```
Pour plus d'informations, consultez la section [Utilisation de l'interface de ligne de AWS commande avec Amazon SQS et Amazon SNS](https://docs.aws.amazon.com/cli/latest/userguide/cli-sqs-queue-sns-topic.html) dans le Guide de l'utilisateur de *AWS l'interface de ligne de commande*.  
+  Pour plus de détails sur l'API, reportez-vous [CreateTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/create-topic.html)à la section *Référence des AWS CLI commandes*. 

### `delete-endpoint`
<a name="sns_DeleteEndpoint_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`delete-endpoint`.

**AWS CLI**  
**Pour supprimer le point de terminaison d’une application de plateforme**  
L’exemple `delete-endpoint` suivant supprime le point de terminaison de l’application de plateforme spécifiée.  

```
aws sns delete-endpoint \
    --endpoint-arn arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, reportez-vous [DeleteEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-endpoint.html)à la section *Référence des AWS CLI commandes*. 

### `delete-platform-application`
<a name="sns_DeletePlatformApplication_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`delete-platform-application`.

**AWS CLI**  
**Pour supprimer une application de plateforme**  
L’exemple `delete-platform-application` suivant supprime l’application de plateforme spécifiée.  

```
aws sns delete-platform-application \
    --platform-application-arn arn:aws:sns:us-west-2:123456789012:app/ADM/MyApplication
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, reportez-vous [DeletePlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-platform-application.html)à la section *Référence des AWS CLI commandes*. 

### `delete-topic`
<a name="sns_DeleteTopic_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`delete-topic`.

**AWS CLI**  
**Pour supprimer une rubrique SNS**  
L’exemple `delete-topic` suivant supprime la rubrique SNS spécifiée.  

```
aws sns delete-topic \
    --topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, reportez-vous [DeleteTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-topic.html)à la section *Référence des AWS CLI commandes*. 

### `get-endpoint-attributes`
<a name="sns_GetEndpointAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`get-endpoint-attributes`.

**AWS CLI**  
**Pour répertorier les attributs du point de terminaison d’une application de plateforme**  
L’exemple `get-endpoint-attributes` suivant répertorie les attributs du point de terminaison de l’application de plateforme spécifiée.  

```
aws sns get-endpoint-attributes \
    --endpoint-arn arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234
```
Sortie :  

```
{
    "Attributes": {
        "Enabled": "true",
        "Token": "EXAMPLE12345..."
    }
}
```
+  Pour plus de détails sur l'API, reportez-vous [GetEndpointAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-endpoint-attributes.html)à la section *Référence des AWS CLI commandes*. 

### `get-platform-application-attributes`
<a name="sns_GetPlatformApplicationAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`get-platform-application-attributes`.

**AWS CLI**  
**Pour répertorier les attributs de l’application de plateforme**  
L’exemple `get-platform-application-attributes` suivant répertorie les attributs de l’application de plateforme spécifiée.  

```
aws sns get-platform-application-attributes \
    --platform-application-arn arn:aws:sns:us-west-2:123456789012:app/MPNS/MyApplication
```
Sortie :  

```
{
    "Attributes": {
        "Enabled": "true",
        "SuccessFeedbackSampleRate": "100"
    }
}
```
+  Pour plus de détails sur l'API, reportez-vous [GetPlatformApplicationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-platform-application-attributes.html)à la section *Référence des AWS CLI commandes*. 

### `get-sms-attributes`
<a name="sns_GetSMSAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`get-sms-attributes`.

**AWS CLI**  
**Pour répertorier les attributs des SMS par défaut**  
L’exemple `get-sms-attributes` suivant répertorie les attributs par défaut pour l’envoi de SMS.  

```
aws sns get-sms-attributes
```
Sortie :  

```
{
    "attributes": {
        "DefaultSenderID": "MyName"
    }
}
```
+  Pour plus de détails sur l’API, consultez [GetSMSAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-sms-attributes.html) dans la *Référence des commandes de l‘AWS CLI *. 

### `get-subscription-attributes`
<a name="sns_GetSubscriptionAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`get-subscription-attributes`.

**AWS CLI**  
**Pour extraire les attributs de l’abonnement d’une rubrique**  
L’exemple `get-subscription-attributes` suivant affiche les attributs de l’abonnement spécifié. Vous pouvez obtenir l’`subscription-arn` à partir de la sortie de la commande `list-subscriptions`.  

```
aws sns get-subscription-attributes \
    --subscription-arn "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
```
Sortie :  

```
{
    "Attributes": {
        "Endpoint": "my-email@example.com",
        "Protocol": "email",
        "RawMessageDelivery": "false",
        "ConfirmationWasAuthenticated": "false",
        "Owner": "123456789012",
        "SubscriptionArn": "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f",
        "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
    }
}
```
+  Pour plus de détails sur l'API, reportez-vous [GetSubscriptionAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-subscription-attributes.html)à la section *Référence des AWS CLI commandes*. 

### `get-topic-attributes`
<a name="sns_GetTopicAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`get-topic-attributes`.

**AWS CLI**  
**Pour récupérer les attributs d’une rubrique**  
L’exemple `get-topic-attributes` suivant affiche les attributs de la rubrique spécifiée.  

```
aws sns get-topic-attributes \
    --topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Sortie :  

```
{
    "Attributes": {
        "SubscriptionsConfirmed": "1",
        "DisplayName": "my-topic",
        "SubscriptionsDeleted": "0",
        "EffectiveDeliveryPolicy": "{\"http\":{\"defaultHealthyRetryPolicy\":{\"minDelayTarget\":20,\"maxDelayTarget\":20,\"numRetries\":3,\"numMaxDelayRetries\":0,\"numNoDelayRetries\":0,\"numMinDelayRetries\":0,\"backoffFunction\":\"linear\"},\"disableSubscriptionOverrides\":false}}",
        "Owner": "123456789012",
        "Policy": "{\"Version\":\"2008-10-17\",\"Id\":\"__default_policy_ID\",\"Statement\":[{\"Sid\":\"__default_statement_ID\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"*\"},\"Action\":[\"SNS:Subscribe\",\"SNS:ListSubscriptionsByTopic\",\"SNS:DeleteTopic\",\"SNS:GetTopicAttributes\",\"SNS:Publish\",\"SNS:RemovePermission\",\"SNS:AddPermission\",\"SNS:SetTopicAttributes\"],\"Resource\":\"arn:aws:sns:us-west-2:123456789012:my-topic\",\"Condition\":{\"StringEquals\":{\"AWS:SourceOwner\":\"0123456789012\"}}}]}",
        "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic",
        "SubscriptionsPending": "0"
    }
}
```
+  Pour plus de détails sur l'API, reportez-vous [GetTopicAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-topic-attributes.html)à la section *Référence des AWS CLI commandes*. 

### `list-endpoints-by-platform-application`
<a name="sns_ListEndpointsByPlatformApplication_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-endpoints-by-platform-application`.

**AWS CLI**  
**Pour répertorier les points de terminaison d’une application de plateforme**  
L’exemple `list-endpoints-by-platform-application` suivant répertorie les points de terminaison de l’application de plateforme spécifiée ainsi que leurs attributs.  

```
aws sns list-endpoints-by-platform-application \
    --platform-application-arn arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication
```
Sortie :  

```
{
    "Endpoints": [
        {
            "Attributes": {
                "Token": "EXAMPLE12345...,
                "Enabled": "true"
            },
            "EndpointArn": "arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [ListEndpointsByPlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-endpoints-by-platform-application.html)à la section *Référence des AWS CLI commandes*. 

### `list-phone-numbers-opted-out`
<a name="sns_ListPhoneNumbersOptedOut_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-phone-numbers-opted-out`.

**AWS CLI**  
**Pour répertorier les désactivations des SMS**  
L’exemple `list-phone-numbers-opted-out` suivant répertorie les numéros de téléphone qui ont désactivé la réception de SMS.  

```
aws sns list-phone-numbers-opted-out
```
Sortie :  

```
{
    "phoneNumbers": [
        "+15555550100"
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [ListPhoneNumbersOptedOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-phone-numbers-opted-out.html)à la section *Référence des AWS CLI commandes*. 

### `list-platform-applications`
<a name="sns_ListPlatformApplications_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-platform-applications`.

**AWS CLI**  
**Pour répertorier les applications de plateforme**  
L’exemple `list-platform-applications` suivant répertorie les applications de plateforme d’ADM et de MPNS.  

```
aws sns list-platform-applications
```
Sortie :  

```
{
    "PlatformApplications": [
        {
            "PlatformApplicationArn": "arn:aws:sns:us-west-2:123456789012:app/ADM/MyApplication",
            "Attributes": {
                "SuccessFeedbackSampleRate": "100",
                "Enabled": "true"
            }
        },
        {
            "PlatformApplicationArn": "arn:aws:sns:us-west-2:123456789012:app/MPNS/MyOtherApplication",
            "Attributes": {
                "SuccessFeedbackSampleRate": "100",
                "Enabled": "true"
            }
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [ListPlatformApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-platform-applications.html)à la section *Référence des AWS CLI commandes*. 

### `list-subscriptions-by-topic`
<a name="sns_ListSubscriptionsByTopic_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-subscriptions-by-topic`.

**AWS CLI**  
**Pour répertorier les abonnements associés à une rubrique**  
L’exemple `list-subscriptions-by-topic` suivant extrait la liste des abonnements SNS associés à la rubrique spécifiée.  

```
aws sns list-subscriptions-by-topic \
    --topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Sortie :  

```
{
    "Subscriptions": [
        {
            "Owner": "123456789012",
            "Endpoint": "my-email@example.com",
            "Protocol": "email",
            "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic",
            "SubscriptionArn": "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [ListSubscriptionsByTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-subscriptions-by-topic.html)à la section *Référence des AWS CLI commandes*. 

### `list-subscriptions`
<a name="sns_ListSubscriptions_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-subscriptions`.

**AWS CLI**  
**Pour répertorier vos abonnements SNS**  
L'`list-subscriptions`exemple suivant affiche la liste des abonnements SNS de votre AWS compte.  

```
aws sns list-subscriptions
```
Sortie :  

```
{
    "Subscriptions": [
        {
            "Owner": "123456789012",
            "Endpoint": "my-email@example.com",
            "Protocol": "email",
            "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic",
            "SubscriptionArn": "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [ListSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-subscriptions.html)à la section *Référence des AWS CLI commandes*. 

### `list-tags-for-resource`
<a name="sns_ListTagsForResource_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.

**AWS CLI**  
**Pour répertorier les balises d’une rubrique**  
L’exemple `list-tags-for-resource` suivant répertorie les balises de la rubrique Amazon SNS spécifiée.  

```
aws sns list-tags-for-resource \
    --resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic
```
Sortie :  

```
{
    "Tags": [
        {
            "Key": "Team",
            "Value": "Alpha"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*. 

### `list-topics`
<a name="sns_ListTopics_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`list-topics`.

**AWS CLI**  
**Pour répertorier vos rubriques SNS**  
L'`list-topics`exemple suivant répertorie toutes les rubriques SNS de votre AWS compte.  

```
aws sns list-topics
```
Sortie :  

```
{
    "Topics": [
        {
            "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
        }
    ]
}
```
+  Pour plus de détails sur l'API, reportez-vous [ListTopics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-topics.html)à la section *Référence des AWS CLI commandes*. 

### `opt-in-phone-number`
<a name="sns_OptInPhoneNumber_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`opt-in-phone-number`.

**AWS CLI**  
**Pour vous inscrire aux messages SMS**  
L’exemple `opt-in-phone-number` suivant autorise le numéro de téléphone spécifié à recevoir des messages SMS.  

```
aws sns opt-in-phone-number \
    --phone-number +15555550100
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, reportez-vous [OptInPhoneNumber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/opt-in-phone-number.html)à la section *Référence des AWS CLI commandes*. 

### `publish`
<a name="sns_Publish_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`publish`.

**AWS CLI**  
**Exemple 1 : pour publier un message dans une rubrique**  
L’exemple `publish` suivant publie le message spécifié sur la rubrique SNS spécifiée. Le message provient d’un fichier texte qui vous permet d’inclure des sauts de ligne.  

```
aws sns publish \
    --topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic" \
    --message file://message.txt
```
Contenu de `message.txt` :  

```
Hello World
Second Line
```
Sortie :  

```
{
    "MessageId": "123a45b6-7890-12c3-45d6-111122223333"
}
```
**Exemple 2 : pour publier un SMS sur un numéro de téléphone**  
L’exemple `publish` suivant publie le message `Hello world!` sur le numéro de téléphone `+1-555-555-0100`.  

```
aws sns publish \
    --message "Hello world!" \
    --phone-number +1-555-555-0100
```
Sortie :  

```
{
    "MessageId": "123a45b6-7890-12c3-45d6-333322221111"
}
```
+  Pour plus d’informations sur l’API, consultez [Publish](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/publish.html) dans la *Référence des commandes AWS CLI *. 

### `put-data-protection-policy`
<a name="sns_PutDataProtectionPolicy_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`put-data-protection-policy`.

**AWS CLI**  
**Pour définir une politique de protection des données**  
**Exemple 1 : pour empêcher les éditeurs de publier des messages avec CreditCardNumber**  
L'`put-data-protection-policy`exemple suivant interdit aux éditeurs de publier des messages avec CreditCardNumber.  

```
aws sns put-data-protection-policy \
    --resource-arn arn:aws:sns:us-east-1:123456789012:mytopic \
    --data-protection-policy "{\"Name\":\"data_protection_policy\",\"Description\":\"Example data protection policy\",\"Version\":\"2021-06-01\",\"Statement\":[{\"DataDirection\":\"Inbound\",\"Principal\":[\"*\"],\"DataIdentifier\":[\"arn:aws:dataprotection::aws:data-identifier/CreditCardNumber\"],\"Operation\":{\"Deny\":{}}}]}"
```
Cette commande ne produit aucune sortie.  
**Exemple 2 : pour charger les paramètres d’un fichier**  
L’exemple `put-data-protection-policy` suivant charge les paramètres d’un fichier.  

```
aws sns put-data-protection-policy \
    --resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --data-protection-policy file://policy.json
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, reportez-vous [PutDataProtectionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/put-data-protection-policy.html)à la section *Référence des AWS CLI commandes*. 

### `remove-permission`
<a name="sns_RemovePermission_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`remove-permission`.

**AWS CLI**  
**Pour supprimer une autorisation d’une rubrique**  
L’exemple `remove-permission` suivant supprime l’autorisation `Publish-Permission` du compte spécifié.  

```
aws sns remove-permission \
    --topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --label Publish-Permission
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, reportez-vous [RemovePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/remove-permission.html)à la section *Référence des AWS CLI commandes*. 

### `set-endpoint-attributes`
<a name="sns_SetEndpointAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`set-endpoint-attributes`.

**AWS CLI**  
**Pour configurer les attributs d’un point de terminaison**  
L’exemple `set-endpoint-attributes` suivant désactive le point de terminaison de l’application de plateforme spécifiée.  

```
aws sns set-endpoint-attributes \
    --endpoint-arn arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234 \
    --attributes Enabled=false
```
Sortie :  

```
{
    "Attributes": {
        "Enabled": "false",
        "Token": "EXAMPLE12345..."
    }
}
```
+  Pour plus de détails sur l'API, reportez-vous [SetEndpointAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-endpoint-attributes.html)à la section *Référence des AWS CLI commandes*. 

### `set-platform-application-attributes`
<a name="sns_SetPlatformApplicationAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`set-platform-application-attributes`.

**AWS CLI**  
**Pour définir les attributs d’une application de plateforme**  
L’exemple `set-platform-application-attributes` suivant définit l’attribut `EventDeliveryFailure` de l’application de plateforme spécifiée sur l’ARN de la rubrique Amazon SNS spécifiée.  

```
aws sns set-platform-application-attributes \
    --platform-application-arn arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication \
    --attributes EventDeliveryFailure=arn:aws:sns:us-west-2:123456789012:AnotherTopic
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, reportez-vous [SetPlatformApplicationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-platform-application-attributes.html)à la section *Référence des AWS CLI commandes*. 

### `set-sms-attributes`
<a name="sns_SetSMSAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`set-sms-attributes`.

**AWS CLI**  
**Pour définir les attributs des SMS**  
L’exemple `set-sms-attributes` suivant définit l’ID d’expéditeur par défaut des SMS sur `MyName`.  

```
aws sns set-sms-attributes \
    --attributes DefaultSenderID=MyName
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, voir [Set SMSAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-sms-attributes.html) in *AWS CLI Command Reference*. 

### `set-subscription-attributes`
<a name="sns_SetSubscriptionAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`set-subscription-attributes`.

**AWS CLI**  
**Pour définir des attributs d’abonnement**  
L’exemple `set-subscription-attributes` suivant définit l’attribut `RawMessageDelivery` sur un abonnement SQS.  

```
aws sns set-subscription-attributes \
    --subscription-arn arn:aws:sns:us-east-1:123456789012:mytopic:f248de18-2cf6-578c-8592-b6f1eaa877dc \
    --attribute-name RawMessageDelivery \
    --attribute-value true
```
Cette commande ne produit aucune sortie.  
L’exemple `set-subscription-attributes` suivant définit un attribut `FilterPolicy` sur un abonnement SQS.  

```
aws sns set-subscription-attributes \
    --subscription-arn arn:aws:sns:us-east-1:123456789012:mytopic:f248de18-2cf6-578c-8592-b6f1eaa877dc \
    --attribute-name FilterPolicy \
    --attribute-value "{ \"anyMandatoryKey\": [\"any\", \"of\", \"these\"] }"
```
Cette commande ne produit aucune sortie.  
L’exemple `set-subscription-attributes` suivant supprime l’attribut `FilterPolicy` d’un abonnement SQS.  

```
aws sns set-subscription-attributes \
    --subscription-arn arn:aws:sns:us-east-1:123456789012:mytopic:f248de18-2cf6-578c-8592-b6f1eaa877dc \
    --attribute-name FilterPolicy \
    --attribute-value "{}"
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, voir [SetSubscriptionAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-subscription-attributes.html)la section *Référence des AWS CLI commandes*. 

### `set-topic-attributes`
<a name="sns_SetTopicAttributes_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`set-topic-attributes`.

**AWS CLI**  
**Pour définir un attribut pour une rubrique**  
L’exemple `set-topic-attributes` suivant définit l’attribut `DisplayName` pour la rubrique spécifiée.  

```
aws sns set-topic-attributes \
    --topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --attribute-name DisplayName \
    --attribute-value MyTopicDisplayName
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, voir [SetTopicAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-topic-attributes.html)la section *Référence des AWS CLI commandes*. 

### `subscribe`
<a name="sns_Subscribe_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`subscribe`.

**AWS CLI**  
**Pour s’abonner à une rubrique**  
La commande `subscribe` suivante abonne une adresse e-mail à la rubrique spécifiée.  

```
aws sns subscribe \
    --topic-arn arn:aws:sns:us-west-2:123456789012:my-topic \
    --protocol email \
    --notification-endpoint my-email@example.com
```
Sortie :  

```
{
    "SubscriptionArn": "pending confirmation"
}
```
+  Pour plus d’informations sur l’API, consultez [Subscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/subscribe.html) dans la *Référence des commandes AWS CLI *. 

### `tag-resource`
<a name="sns_TagResource_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`tag-resource`.

**AWS CLI**  
**Pour ajouter une balise à une rubrique**  
L’exemple `tag-resource` suivant ajoute une balise de métadonnées à la rubrique Amazon SNS spécifiée.  

```
aws sns tag-resource \
    --resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --tags Key=Team,Value=Alpha
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, voir [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/tag-resource.html)la section *Référence des AWS CLI commandes*. 

### `unsubscribe`
<a name="sns_Unsubscribe_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`unsubscribe`.

**AWS CLI**  
**Pour se désabonner d’une rubrique**  
L’exemple `unsubscribe` suivant supprime l’abonnement spécifié d’une rubrique.  

```
aws sns unsubscribe \
    --subscription-arn arn:aws:sns:us-west-2:0123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f
```
Cette commande ne produit aucune sortie.  
+  Pour plus d’informations sur l’API, consultez [Unsubscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/unsubscribe.html) dans la *Référence des commandes AWS CLI *. 

### `untag-resource`
<a name="sns_UntagResource_cli_2_topic"></a>

L'exemple de code suivant montre comment utiliser`untag-resource`.

**AWS CLI**  
**Pour supprimer une balise d’une rubrique**  
L’exemple `untag-resource` suivant supprime les balises possédant les clés spécifiées de la rubrique Amazon SNS spécifiée.  

```
aws sns untag-resource \
    --resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --tag-keys Team
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, voir [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/untag-resource.html)la section *Référence des AWS CLI commandes*. 

## Scénarios
<a name="scenarios"></a>

### Création d’un point de terminaison de plateforme pour les notifications push
<a name="sns_CreatePlatformEndpoint_cli_2_topic"></a>

L’exemple de code suivant montre comment créer un point de terminaison de plateforme pour les notifications push Amazon SNS.

**AWS CLI**  
**Pour créer un point de terminaison d’application de plateforme**  
L’exemple `create-platform-endpoint` suivant crée un point de terminaison pour l’application de plateforme spécifiée à l’aide du jeton spécifié.  

```
aws sns create-platform-endpoint \
    --platform-application-arn arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication \
    --token EXAMPLE12345...
```
Sortie :  

```
{
      "EndpointArn": "arn:aws:sns:us-west-2:1234567890:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234"
}
```