Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Amazon SNS SNS-Beispiele mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon SNS Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
*Szenarien* sind Codebeispiele, die Ihnen zeigen, wie Sie bestimmte Aufgaben ausführen, indem Sie mehrere Funktionen innerhalb eines Service aufrufen oder mit anderen AWS-Services kombinieren.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
+ [Szenarien](#scenarios)
## Aktionen
### `add-permission`
Das folgende Codebeispiel zeigt, wie Sie`add-permission`.
**AWS CLI**
**So fügen Sie einem Thema eine Berechtigung hinzu**
Im folgenden `add-permission` Beispiel wird die Berechtigung für das AWS Konto `987654321098` hinzugefügt, die `Publish` Aktion mit dem angegebenen Thema unter AWS Konto zu verwenden`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
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [AddPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/add-permission.html)unter *AWS CLI Befehlsreferenz*.
### `check-if-phone-number-is-opted-out`
Das folgende Codebeispiel zeigt die Verwendung`check-if-phone-number-is-opted-out`.
**AWS CLI**
**So überprüfen Sie SMS-Nachrichten-Abmeldungen für eine Telefonnummer**
Im folgenden `check-if-phone-number-is-opted-out` Beispiel wird geprüft, ob die angegebene Telefonnummer den Empfang von SMS-Nachrichten vom AWS Girokonto deaktiviert hat.
```
aws sns check-if-phone-number-is-opted-out \
--phone-number +1555550100
```
Ausgabe:
```
{
"isOptedOut": false
}
```
+ Einzelheiten zur API finden Sie [CheckIfPhoneNumberIsOptedOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/check-if-phone-number-is-opted-out.html)unter *AWS CLI Befehlsreferenz*.
### `confirm-subscription`
Das folgende Codebeispiel zeigt die Verwendung`confirm-subscription`.
**AWS CLI**
**So bestätigen Sie ein Abonnement**
Mit dem folgenden `confirm-subscription`-Befehl wird der Bestätigungsvorgang abgeschlossen, der gestartet wurde, als Sie ein SNS-Thema mit dem Namen `my-topic` abonniert haben. Der --token-Parameter stammt aus der Bestätigungsnachricht, die an den im Abonnementaufruf angegebenen Benachrichtigungsendpunkt gesendet wurde.
```
aws sns confirm-subscription \
--topic-arn arn:aws:sns:us-west-2:123456789012:my-topic \
--token 2336412f37fb687f5d51e6e241d7700ae02f7124d8268910b858cb4db727ceeb2474bb937929d3bdd7ce5d0cce19325d036bc858d3c217426bcafa9c501a2cace93b83f1dd3797627467553dc438a8c974119496fc3eff026eaa5d14472ded6f9a5c43aec62d83ef5f49109da7176391
```
Ausgabe:
```
{
"SubscriptionArn": "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
}
```
+ Einzelheiten zur API finden Sie [ConfirmSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/confirm-subscription.html)in der *AWS CLI Befehlsreferenz*.
### `create-platform-application`
Das folgende Codebeispiel zeigt die Verwendung`create-platform-application`.
**AWS CLI**
**Um eine Plattformanwendung zu erstellen**
Im folgenden Beispiel für `create-platform-application` wird eine Google-Firebase-Plattformanwendung mit den angegebenen Plattformanmeldeinformationen erstellt.
```
aws sns create-platform-application \
--name MyApplication \
--platform GCM \
--attributes PlatformCredential=EXAMPLEabcd12345jklm67890stuv12345bcdef
```
Ausgabe:
```
{
"PlatformApplicationArn": "arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication"
}
```
+ Einzelheiten zur API finden Sie [CreatePlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/create-platform-application.html)in der *AWS CLI Befehlsreferenz*.
### `create-topic`
Das folgende Codebeispiel zeigt die Verwendung`create-topic`.
**AWS CLI**
**So erstellen Sie ein SNS-Thema**
Das folgende `create-topic`-Beispiel erstellt ein SNS-Thema namens `my-topic`.
```
aws sns create-topic \
--name my-topic
```
Ausgabe:
```
{
"ResponseMetadata": {
"RequestId": "1469e8d7-1642-564e-b85d-a19b4b341f83"
},
"TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
}
```
Weitere Informationen finden Sie unter [Verwenden der AWS Befehlszeilenschnittstelle mit Amazon SQS und Amazon SNS](https://docs.aws.amazon.com/cli/latest/userguide/cli-sqs-queue-sns-topic.html) im *Benutzerhandbuch für die AWS Befehlszeilenschnittstelle*.
+ Einzelheiten zur API finden Sie unter [CreateTopic AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/create-topic.html)*Befehlsreferenz*.
### `delete-endpoint`
Das folgende Codebeispiel zeigt die Verwendung`delete-endpoint`.
**AWS CLI**
**So löschen Sie einen Plattformanwendungsendpunkt**
Im folgenden Beispiel für `delete-endpoint` wird der angegebene Plattformanwendungsendpunkt gelöscht.
```
aws sns delete-endpoint \
--endpoint-arn arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [DeleteEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-endpoint.html)in der *AWS CLI Befehlsreferenz*.
### `delete-platform-application`
Das folgende Codebeispiel zeigt die Verwendung`delete-platform-application`.
**AWS CLI**
**So löschen Sie eine Plattformanwendung**
Im folgenden Beispiel für `delete-platform-application` wird die angegebene Plattformanwendung gelöscht.
```
aws sns delete-platform-application \
--platform-application-arn arn:aws:sns:us-west-2:123456789012:app/ADM/MyApplication
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [DeletePlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-platform-application.html)in der *AWS CLI Befehlsreferenz*.
### `delete-topic`
Das folgende Codebeispiel zeigt die Verwendung`delete-topic`.
**AWS CLI**
**So löschen Sie das SNS-Thema**
Das folgende `delete-topic`-Beispiel löscht die angegebene SNS-Thema.
```
aws sns delete-topic \
--topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [DeleteTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-topic.html)in der *AWS CLI Befehlsreferenz*.
### `get-endpoint-attributes`
Das folgende Codebeispiel zeigt die Verwendung`get-endpoint-attributes`.
**AWS CLI**
**So listen Sie die Endpunktattribute der Plattformanwendung auf**
Im folgenden Beispiel für `get-endpoint-attributes` werden die Attribute für den angegebenen Plattformanwendungsendpunkt aufgelistet.
```
aws sns get-endpoint-attributes \
--endpoint-arn arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234
```
Ausgabe:
```
{
"Attributes": {
"Enabled": "true",
"Token": "EXAMPLE12345..."
}
}
```
+ Einzelheiten zur API finden Sie [GetEndpointAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-endpoint-attributes.html)in der *AWS CLI Befehlsreferenz*.
### `get-platform-application-attributes`
Das folgende Codebeispiel zeigt die Verwendung`get-platform-application-attributes`.
**AWS CLI**
**So listen Sie die Attribute der Plattformanwendung auf**
Im folgenden Beispiel für `get-platform-application-attributes` werden die Attribute für die angegebene Plattformanwendung aufgelistet.
```
aws sns get-platform-application-attributes \
--platform-application-arn arn:aws:sns:us-west-2:123456789012:app/MPNS/MyApplication
```
Ausgabe:
```
{
"Attributes": {
"Enabled": "true",
"SuccessFeedbackSampleRate": "100"
}
}
```
+ Einzelheiten zur API finden Sie [GetPlatformApplicationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-platform-application-attributes.html)in der *AWS CLI Befehlsreferenz*.
### `get-sms-attributes`
Das folgende Codebeispiel zeigt die Verwendung`get-sms-attributes`.
**AWS CLI**
**So führen Sie die Standard-SMS-Nachrichtenattribute auf**
Das folgende `get-sms-attributes`-Beispiel führt die Standardattribute für das Senden von SMS-Nachrichten auf.
```
aws sns get-sms-attributes
```
Ausgabe:
```
{
"attributes": {
"DefaultSenderID": "MyName"
}
}
```
+ Weitere API-Informationen finden Sie unter [GetSMSAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-sms-attributes.html) in der *AWS CLI -Befehlsreferenz*.
### `get-subscription-attributes`
Das folgende Codebeispiel zeigt die Verwendung`get-subscription-attributes`.
**AWS CLI**
**So rufen Sie Abonnementattribute für ein Thema ab**
Im folgenden Beispiel für `get-subscription-attributes` werden die Attribute des angegebenen Abonnements angezeigt. Sie können das `subscription-arn` aus der Ausgabe des `list-subscriptions`-Befehls abrufen.
```
aws sns get-subscription-attributes \
--subscription-arn "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
```
Ausgabe:
```
{
"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"
}
}
```
+ Einzelheiten zur API finden Sie [GetSubscriptionAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-subscription-attributes.html)in der *AWS CLI Befehlsreferenz*.
### `get-topic-attributes`
Das folgende Codebeispiel zeigt die Verwendung`get-topic-attributes`.
**AWS CLI**
**So rufen Sie die Attribute eines Themas ab**
Im folgenden Beispiel für `get-topic-attributes` werden die Attribute für das angegebene Thema angezeigt.
```
aws sns get-topic-attributes \
--topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Ausgabe:
```
{
"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"
}
}
```
+ Einzelheiten zur API finden Sie [GetTopicAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-topic-attributes.html)in der *AWS CLI Befehlsreferenz*.
### `list-endpoints-by-platform-application`
Das folgende Codebeispiel zeigt die Verwendung`list-endpoints-by-platform-application`.
**AWS CLI**
**So listen Sie die Endpunkte für eine Plattformanwendung auf**
Im folgenden Beispiel für `list-endpoints-by-platform-application` werden die Endpunkte und Endpunktattribute für die angegebene Plattformanwendung aufgelistet.
```
aws sns list-endpoints-by-platform-application \
--platform-application-arn arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication
```
Ausgabe:
```
{
"Endpoints": [
{
"Attributes": {
"Token": "EXAMPLE12345...,
"Enabled": "true"
},
"EndpointArn": "arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234"
}
]
}
```
+ Einzelheiten zur API finden Sie [ListEndpointsByPlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-endpoints-by-platform-application.html)in der *AWS CLI Befehlsreferenz*.
### `list-phone-numbers-opted-out`
Das folgende Codebeispiel zeigt die Verwendung`list-phone-numbers-opted-out`.
**AWS CLI**
**So führen Sie Abmeldungen für SMS-Nachrichten auf**
Das folgende `list-phone-numbers-opted-out`-Beispiel listet die Telefonnummern auf, bei denen der Empfang von SMS-Nachrichten abbestellt wurde.
```
aws sns list-phone-numbers-opted-out
```
Ausgabe:
```
{
"phoneNumbers": [
"+15555550100"
]
}
```
+ Einzelheiten zur API finden Sie [ListPhoneNumbersOptedOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-phone-numbers-opted-out.html)in der *AWS CLI Befehlsreferenz*.
### `list-platform-applications`
Das folgende Codebeispiel zeigt die Verwendung`list-platform-applications`.
**AWS CLI**
**So listen Sie Plattformanwendungen auf**
Im folgenden Beispiel für `list-platform-applications` werden die Plattformanwendungen für ADM und MPNS aufgelistet.
```
aws sns list-platform-applications
```
Ausgabe:
```
{
"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"
}
}
]
}
```
+ Einzelheiten zur API finden Sie [ListPlatformApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-platform-applications.html)in der *AWS CLI Befehlsreferenz*.
### `list-subscriptions-by-topic`
Das folgende Codebeispiel zeigt die Verwendung`list-subscriptions-by-topic`.
**AWS CLI**
**So listen Sie die Abonnements auf, die einem Thema zugeordnet sind**
Der folgende `list-subscriptions-by-topic` ruft eine Liste der SNS-Abonnements ab, die dem angegebenen Thema zugeordnet sind.
```
aws sns list-subscriptions-by-topic \
--topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Ausgabe:
```
{
"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"
}
]
}
```
+ Einzelheiten zur API finden Sie [ListSubscriptionsByTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-subscriptions-by-topic.html)in der *AWS CLI Befehlsreferenz*.
### `list-subscriptions`
Das folgende Codebeispiel zeigt die Verwendung`list-subscriptions`.
**AWS CLI**
**So führen Sie Ihre SNS-Abonnements auf**
Im folgenden `list-subscriptions` Beispiel wird eine Liste der SNS-Abonnements in Ihrem AWS Konto angezeigt.
```
aws sns list-subscriptions
```
Ausgabe:
```
{
"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"
}
]
}
```
+ Einzelheiten zur API finden Sie [ListSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-subscriptions.html)in der *AWS CLI Befehlsreferenz.*
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`.
**AWS CLI**
**So listen Sie Tags für ein Thema auf**
Im folgenden Beispiel für `list-tags-for-resource` werden die Tags für das angegebene Amazon SNS-Thema aufgelistet.
```
aws sns list-tags-for-resource \
--resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic
```
Ausgabe:
```
{
"Tags": [
{
"Key": "Team",
"Value": "Alpha"
}
]
}
```
+ Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*.
### `list-topics`
Das folgende Codebeispiel zeigt die Verwendung`list-topics`.
**AWS CLI**
**So führen Sie Ihre SNS-Themen auf**
Das folgende `list-topics` Beispiel listet alle SNS-Themen in Ihrem AWS Konto auf.
```
aws sns list-topics
```
Ausgabe:
```
{
"Topics": [
{
"TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
}
]
}
```
+ Einzelheiten zur API finden Sie [ListTopics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-topics.html)in der *AWS CLI Befehlsreferenz.*
### `opt-in-phone-number`
Das folgende Codebeispiel zeigt die Verwendung`opt-in-phone-number`.
**AWS CLI**
**So melden Sie für SMS-Nachrichten an**
Im folgenden Beispiel für `opt-in-phone-number` werden die Telefonnummern für den Empfang von SMS-Nachrichten angemeldet.
```
aws sns opt-in-phone-number \
--phone-number +15555550100
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [OptInPhoneNumber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/opt-in-phone-number.html)in der *AWS CLI Befehlsreferenz*.
### `publish`
Das folgende Codebeispiel zeigt die Verwendung`publish`.
**AWS CLI**
**Beispiel 1: So veröffentlichen Sie eine Nachricht für ein Thema**
Das folgende `publish`-Beispiel veröffentlicht die angegebene Nachricht im angegebenen SNS-Thema. Die Nachricht stammt aus einer Textdatei, in der Sie Zeilenumbrüche einfügen können.
```
aws sns publish \
--topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic" \
--message file://message.txt
```
Inhalt von `message.txt`:
```
Hello World
Second Line
```
Ausgabe:
```
{
"MessageId": "123a45b6-7890-12c3-45d6-111122223333"
}
```
**Beispiel 2: So veröffentlichen Sie eine SMS-Nachricht an eine Telefonnummer**
Im folgenden Beispiel für `publish` wird Nachricht `Hello world!` an Telefonnummer `+1-555-555-0100` veröffentlicht.
```
aws sns publish \
--message "Hello world!" \
--phone-number +1-555-555-0100
```
Ausgabe:
```
{
"MessageId": "123a45b6-7890-12c3-45d6-333322221111"
}
```
+ Weitere API-Informationen finden Sie unter [Publish](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/publish.html) in der *AWS CLI -Befehlsreferenz*.
### `put-data-protection-policy`
Das folgende Codebeispiel zeigt die Verwendung`put-data-protection-policy`.
**AWS CLI**
**So legen Sie die Datenschutzrichtlinie fest**
**Beispiel 1: Um Publishern das Veröffentlichen von Nachrichten mit zu verbieten CreditCardNumber**
Im folgenden `put-data-protection-policy` Beispiel wird Verlegern das Veröffentlichen von Nachrichten mit CreditCardNumber verweigert.
```
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\":{}}}]}"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
**Beispiel 2: So laden Sie Parameter aus einer Datei**
Im folgenden Beispiel für `put-data-protection-policy` werden Parameter aus einer Datei geladen.
```
aws sns put-data-protection-policy \
--resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--data-protection-policy file://policy.json
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie unter [PutDataProtectionPolicy AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/put-data-protection-policy.html)*Befehlsreferenz.*
### `remove-permission`
Das folgende Codebeispiel zeigt die Verwendung`remove-permission`.
**AWS CLI**
**So entfernen Sie eine Berechtigung aus einem Thema**
Im folgenden Beispiel für `remove-permission` wird die Berechtigung `Publish-Permission` aus dem angegebenen Thema entfernt.
```
aws sns remove-permission \
--topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--label Publish-Permission
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [RemovePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/remove-permission.html)in der *AWS CLI Befehlsreferenz*.
### `set-endpoint-attributes`
Das folgende Codebeispiel zeigt die Verwendung`set-endpoint-attributes`.
**AWS CLI**
**So legen Sie Endpunktattribute fest**
Im folgenden Beispiel für `set-endpoint-attributes` wird der angegebene Plattformanwendungsendpunkt deaktiviert.
```
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
```
Ausgabe:
```
{
"Attributes": {
"Enabled": "false",
"Token": "EXAMPLE12345..."
}
}
```
+ Einzelheiten zur API finden Sie [SetEndpointAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-endpoint-attributes.html)in der *AWS CLI Befehlsreferenz*.
### `set-platform-application-attributes`
Das folgende Codebeispiel zeigt die Verwendung`set-platform-application-attributes`.
**AWS CLI**
**So legen Sie Attribute für Plattformanwendungen fest**
Im folgenden Beispiel für `set-platform-application-attributes` wird das `EventDeliveryFailure`-Attribut für die angegebene Plattformanwendung auf den ARN des angegebenen Amazon-SNS-Themas gesetzt.
```
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
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [SetPlatformApplicationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-platform-application-attributes.html)in der *AWS CLI Befehlsreferenz*.
### `set-sms-attributes`
Das folgende Codebeispiel zeigt die Verwendung`set-sms-attributes`.
**AWS CLI**
**So legen Sie SMS-Nachrichtenattribute fest**
Im folgenden Beispiel für `set-sms-attributes` wird die standardmäßige Absender-ID für SMS-Nachrichten auf `MyName` festgelegt.
```
aws sns set-sms-attributes \
--attributes DefaultSenderID=MyName
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie unter [Set SMSAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-sms-attributes.html) in der *AWS CLI Befehlsreferenz*.
### `set-subscription-attributes`
Das folgende Codebeispiel zeigt die Verwendung`set-subscription-attributes`.
**AWS CLI**
**So legen Sie Abonnementattribute fest**
Im folgenden Beispiel für `set-subscription-attributes` wird das `RawMessageDelivery`-Attribut auf ein SQS-Abonnement festgelegt.
```
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
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Im folgenden Beispiel für `set-subscription-attributes` wird ein `FilterPolicy`-Attribut auf ein SQS-Abonnement festgelegt.
```
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\"] }"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Im folgenden Beispiel für `set-subscription-attributes` wird das `FilterPolicy`-Attribut von einem SQS-Abonnement entfernt.
```
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 "{}"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [SetSubscriptionAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-subscription-attributes.html)in der *AWS CLI Befehlsreferenz*.
### `set-topic-attributes`
Das folgende Codebeispiel zeigt die Verwendung`set-topic-attributes`.
**AWS CLI**
**So legen Sie ein Attribut für ein Thema fest**
Im folgenden Beispiel für `set-topic-attributes` wird das `DisplayName`-Attribute für das angegebene Thema festgelegt.
```
aws sns set-topic-attributes \
--topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--attribute-name DisplayName \
--attribute-value MyTopicDisplayName
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [SetTopicAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-topic-attributes.html)in der *AWS CLI Befehlsreferenz*.
### `subscribe`
Das folgende Codebeispiel zeigt die Verwendung`subscribe`.
**AWS CLI**
**So abonnieren Sie ein Thema**
Der folgende `subscribe`-Befehl abonniert das angegebene Thema mit eine E-Mail-Adresse.
```
aws sns subscribe \
--topic-arn arn:aws:sns:us-west-2:123456789012:my-topic \
--protocol email \
--notification-endpoint my-email@example.com
```
Ausgabe:
```
{
"SubscriptionArn": "pending confirmation"
}
```
+ Weitere API-Informationen finden Sie unter [Subscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/subscribe.html) in der *AWS CLI -Befehlsreferenz*.
### `tag-resource`
Das folgende Codebeispiel zeigt die Verwendung`tag-resource`.
**AWS CLI**
**So fügen Sie einem Thema ein Tag hinzu**
Das folgende `tag-resource`-Beispiel fügt dem angegebenen Amazon-SNS-Thema ein Metadaten-Tag hinzu.
```
aws sns tag-resource \
--resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--tags Key=Team,Value=Alpha
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/tag-resource.html)in der *AWS CLI Befehlsreferenz*.
### `unsubscribe`
Das folgende Codebeispiel zeigt die Verwendung`unsubscribe`.
**AWS CLI**
**So melden Sie sich von einem Thema ab**
Im folgenden Beispiel für `unsubscribe` wird das angegebene Abonnement aus einem Thema gelöscht.
```
aws sns unsubscribe \
--subscription-arn arn:aws:sns:us-west-2:0123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/unsubscribe.html) in der *AWS CLI -Befehlsreferenz*.
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-resource`.
**AWS CLI**
**So entfernen Sie ein Tag aus einem Thema**
Im folgenden Beispiel für `untag-resource` werden alle Tags mit den angegebenen Schlüsseln aus dem angegebenen Amazon SNS-Thema entfernt.
```
aws sns untag-resource \
--resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
--tag-keys Team
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/untag-resource.html)in der *AWS CLI Befehlsreferenz*.
## Szenarien
### Erstellen eines Plattformendpunkts für Push-Benachrichtigungen
Das folgende Codebeispiel zeigt, wie ein Plattformendpunkt für Amazon-SNS-Push-Benachrichtigungen erstellt wird.
**AWS CLI**
**So erstellen Sie ein Plattformanwendungsendpunkt**
Im folgenden Beispiel für `create-platform-endpoint` wird mithilfe des angegebenen Tokens ein Endpunkt für die angegebene Plattformanwendung erstellt.
```
aws sns create-platform-endpoint \
--platform-application-arn arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication \
--token EXAMPLE12345...
```
Ausgabe:
```
{
"EndpointArn": "arn:aws:sns:us-west-2:1234567890:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234"
}
```