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 mithilfe von Amazon SNS Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface
*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 unter [ListSubscriptions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-subscriptions.html)*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"
}
```