

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Contoh Amazon SNS menggunakan AWS CLI
<a name="cli_sns_code_examples"></a>

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan Amazon SNS.

*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

*Skenario* adalah contoh kode yang menunjukkan kepada Anda bagaimana menyelesaikan tugas tertentu dengan memanggil beberapa fungsi dalam layanan atau dikombinasikan dengan yang lain Layanan AWS.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

**Topics**
+ [Tindakan](#actions)
+ [Skenario](#scenarios)

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

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

Contoh kode berikut menunjukkan cara menggunakan`add-permission`.

**AWS CLI**  
**Untuk menambahkan izin ke topik**  
`add-permission`Contoh berikut menambahkan izin untuk AWS akun `987654321098` untuk menggunakan `Publish` tindakan dengan topik yang ditentukan di bawah AWS akun`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
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [AddPermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/add-permission.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`check-if-phone-number-is-opted-out`.

**AWS CLI**  
**Untuk memeriksa pesan SMS opt-out untuk nomor telepon**  
`check-if-phone-number-is-opted-out`Contoh berikut memeriksa apakah nomor telepon yang ditentukan dipilih untuk tidak menerima pesan SMS dari AWS akun saat ini.  

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

```
{
    "isOptedOut": false
}
```
+  Untuk detail API, lihat [CheckIfPhoneNumberIsOptedOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/check-if-phone-number-is-opted-out.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`confirm-subscription`.

**AWS CLI**  
**Untuk mengonfirmasi langganan**  
`confirm-subscription`Perintah berikut menyelesaikan proses konfirmasi yang dimulai saat Anda berlangganan topik SNS bernama. `my-topic` Parameter --token berasal dari pesan konfirmasi yang dikirim ke titik akhir notifikasi yang ditentukan dalam panggilan berlangganan.  

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

```
{
    "SubscriptionArn": "arn:aws:sns:us-west-2:123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f"
}
```
+  Untuk detail API, lihat [ConfirmSubscription](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/confirm-subscription.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`create-platform-application`.

**AWS CLI**  
**Untuk membuat aplikasi platform**  
`create-platform-application`Contoh berikut membuat aplikasi platform Google Firebase menggunakan kredensi platform yang ditentukan.  

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

```
{
    "PlatformApplicationArn": "arn:aws:sns:us-west-2:123456789012:app/GCM/MyApplication"
}
```
+  Untuk detail API, lihat [CreatePlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/create-platform-application.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`create-topic`.

**AWS CLI**  
**Untuk membuat topik SNS**  
`create-topic`Contoh berikut membuat topik SNS bernama`my-topic`.  

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

```
{
    "ResponseMetadata": {
        "RequestId": "1469e8d7-1642-564e-b85d-a19b4b341f83"
    },
    "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
}
```
Untuk informasi selengkapnya, lihat [Menggunakan Antarmuka Baris AWS Perintah dengan Amazon SQS dan Amazon SNS](https://docs.aws.amazon.com/cli/latest/userguide/cli-sqs-queue-sns-topic.html) di Panduan Pengguna Antarmuka *Baris AWS Perintah*.  
+  Untuk detail API, lihat [CreateTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/create-topic.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`delete-endpoint`.

**AWS CLI**  
**Untuk menghapus titik akhir aplikasi platform**  
`delete-endpoint`Contoh berikut menghapus endpoint aplikasi platform yang ditentukan.  

```
aws sns delete-endpoint \
    --endpoint-arn arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [DeleteEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-endpoint.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`delete-platform-application`.

**AWS CLI**  
**Untuk menghapus aplikasi platform**  
`delete-platform-application`Contoh berikut menghapus aplikasi platform yang ditentukan.  

```
aws sns delete-platform-application \
    --platform-application-arn arn:aws:sns:us-west-2:123456789012:app/ADM/MyApplication
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [DeletePlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-platform-application.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`delete-topic`.

**AWS CLI**  
**Untuk menghapus topik SNS**  
`delete-topic`Contoh berikut menghapus topik SNS yang ditentukan.  

```
aws sns delete-topic \
    --topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [DeleteTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-topic.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`get-endpoint-attributes`.

**AWS CLI**  
**Untuk membuat daftar atribut endpoint aplikasi platform**  
`get-endpoint-attributes`Contoh berikut mencantumkan atribut untuk endpoint aplikasi platform tertentu.  

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

```
{
    "Attributes": {
        "Enabled": "true",
        "Token": "EXAMPLE12345..."
    }
}
```
+  Untuk detail API, lihat [GetEndpointAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-endpoint-attributes.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`get-platform-application-attributes`.

**AWS CLI**  
**Untuk membuat daftar atribut aplikasi platform**  
`get-platform-application-attributes`Contoh berikut mencantumkan atribut untuk aplikasi platform tertentu.  

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

```
{
    "Attributes": {
        "Enabled": "true",
        "SuccessFeedbackSampleRate": "100"
    }
}
```
+  Untuk detail API, lihat [GetPlatformApplicationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-platform-application-attributes.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`get-sms-attributes`.

**AWS CLI**  
**Untuk mencantumkan atribut pesan SMS default**  
`get-sms-attributes`Contoh berikut mencantumkan atribut default untuk mengirim pesan SMS.  

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

```
{
    "attributes": {
        "DefaultSenderID": "MyName"
    }
}
```
+  Untuk detail API, lihat [Dapatkan SMSAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-sms-attributes.html) *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`get-subscription-attributes`.

**AWS CLI**  
**Untuk mengambil atribut langganan untuk topik**  
Berikut ini `get-subscription-attributes` menampilkan atribut langganan yang ditentukan. Anda bisa mendapatkan `subscription-arn` dari output `list-subscriptions` perintah.  

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

```
{
    "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"
    }
}
```
+  Untuk detail API, lihat [GetSubscriptionAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-subscription-attributes.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`get-topic-attributes`.

**AWS CLI**  
**Untuk mengambil atribut topik**  
`get-topic-attributes`Contoh berikut menampilkan atribut untuk topik yang ditentukan.  

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

```
{
    "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"
    }
}
```
+  Untuk detail API, lihat [GetTopicAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/get-topic-attributes.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`list-endpoints-by-platform-application`.

**AWS CLI**  
**Untuk membuat daftar titik akhir untuk aplikasi platform**  
`list-endpoints-by-platform-application`Contoh berikut mencantumkan titik akhir dan atribut endpoint untuk aplikasi platform tertentu.  

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

```
{
    "Endpoints": [
        {
            "Attributes": {
                "Token": "EXAMPLE12345...,
                "Enabled": "true"
            },
            "EndpointArn": "arn:aws:sns:us-west-2:123456789012:endpoint/GCM/MyApplication/12345678-abcd-9012-efgh-345678901234"
        }
    ]
}
```
+  Untuk detail API, lihat [ListEndpointsByPlatformApplication](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-endpoints-by-platform-application.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`list-phone-numbers-opted-out`.

**AWS CLI**  
**Untuk membuat daftar opt-out pesan SMS**  
`list-phone-numbers-opted-out`Contoh berikut mencantumkan nomor telepon yang dipilih untuk tidak menerima pesan SMS.  

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

```
{
    "phoneNumbers": [
        "+15555550100"
    ]
}
```
+  Untuk detail API, lihat [ListPhoneNumbersOptedOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-phone-numbers-opted-out.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`list-platform-applications`.

**AWS CLI**  
**Untuk membuat daftar aplikasi platform**  
`list-platform-applications`Contoh berikut mencantumkan aplikasi platform untuk ADM dan MPNS.  

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

```
{
    "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"
            }
        }
    ]
}
```
+  Untuk detail API, lihat [ListPlatformApplications](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-platform-applications.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`list-subscriptions-by-topic`.

**AWS CLI**  
**Untuk membuat daftar langganan yang terkait dengan topik**  
Berikut ini `list-subscriptions-by-topic` mengambil daftar langganan SNS yang terkait dengan topik yang ditentukan.  

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

```
{
    "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"
        }
    ]
}
```
+  Untuk detail API, lihat [ListSubscriptionsByTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-subscriptions-by-topic.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`list-subscriptions`.

**AWS CLI**  
**Untuk membuat daftar langganan SNS Anda**  
`list-subscriptions`Contoh berikut menampilkan daftar langganan SNS di akun Anda AWS .  

```
aws sns list-subscriptions
```
Output:  

```
{
    "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"
        }
    ]
}
```
+  Untuk detail API, lihat [ListSubscriptions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-subscriptions.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`list-tags-for-resource`.

**AWS CLI**  
**Untuk mencantumkan tag untuk suatu topik**  
`list-tags-for-resource`Contoh berikut mencantumkan tag untuk topik Amazon SNS yang ditentukan.  

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

```
{
    "Tags": [
        {
            "Key": "Team",
            "Value": "Alpha"
        }
    ]
}
```
+  Untuk detail API, lihat [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-tags-for-resource.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`list-topics`.

**AWS CLI**  
**Untuk membuat daftar topik SNS Anda**  
`list-topics`Contoh berikut mencantumkan semua topik SNS di AWS akun Anda.  

```
aws sns list-topics
```
Output:  

```
{
    "Topics": [
        {
            "TopicArn": "arn:aws:sns:us-west-2:123456789012:my-topic"
        }
    ]
}
```
+  Untuk detail API, lihat [ListTopics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-topics.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`opt-in-phone-number`.

**AWS CLI**  
**Untuk ikut serta dalam pesan SMS**  
`opt-in-phone-number`Contoh berikut memilih nomor telepon yang ditentukan untuk menerima pesan SMS.  

```
aws sns opt-in-phone-number \
    --phone-number +15555550100
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [OptInPhoneNumber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/opt-in-phone-number.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`publish`.

**AWS CLI**  
**Contoh 1: Untuk mempublikasikan pesan ke topik**  
`publish`Contoh berikut menerbitkan pesan yang ditentukan ke topik SNS yang ditentukan. Pesan berasal dari file teks, yang memungkinkan Anda untuk memasukkan jeda baris.  

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

```
Hello World
Second Line
```
Output:  

```
{
    "MessageId": "123a45b6-7890-12c3-45d6-111122223333"
}
```
**Contoh 2: Untuk mempublikasikan pesan SMS ke nomor telepon**  
`publish`Contoh berikut menerbitkan pesan `Hello world!` ke nomor `+1-555-555-0100` telepon.  

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

```
{
    "MessageId": "123a45b6-7890-12c3-45d6-333322221111"
}
```
+  Untuk detail API, lihat [Menerbitkan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/publish.html) di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`put-data-protection-policy`.

**AWS CLI**  
**Untuk menetapkan kebijakan perlindungan data**  
**Contoh 1: Untuk menolak penerbit mempublikasikan pesan dengan CreditCardNumber**  
`put-data-protection-policy`Contoh berikut menyangkal penerbit dari mempublikasikan pesan dengan. 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\":{}}}]}"
```
Perintah ini tidak menghasilkan output.  
**Contoh 2: Untuk memuat parameter dari file**  
Berikut ini `put-data-protection-policy` memuat parameter dari file.  

```
aws sns put-data-protection-policy \
    --resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --data-protection-policy file://policy.json
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [PutDataProtectionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/put-data-protection-policy.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`remove-permission`.

**AWS CLI**  
**Untuk menghapus izin dari topik**  
`remove-permission`Contoh berikut menghapus izin `Publish-Permission` dari topik yang ditentukan.  

```
aws sns remove-permission \
    --topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --label Publish-Permission
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [RemovePermission](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/remove-permission.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`set-endpoint-attributes`.

**AWS CLI**  
**Untuk mengatur atribut titik akhir**  
`set-endpoint-attributes`Contoh berikut menonaktifkan endpoint aplikasi platform yang ditentukan.  

```
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
```
Output:  

```
{
    "Attributes": {
        "Enabled": "false",
        "Token": "EXAMPLE12345..."
    }
}
```
+  Untuk detail API, lihat [SetEndpointAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-endpoint-attributes.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`set-platform-application-attributes`.

**AWS CLI**  
**Untuk mengatur atribut aplikasi platform**  
`set-platform-application-attributes`Contoh berikut menetapkan `EventDeliveryFailure` atribut untuk aplikasi platform yang ditentukan ke ARN dari topik Amazon SNS yang ditentukan.  

```
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
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [SetPlatformApplicationAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-platform-application-attributes.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`set-sms-attributes`.

**AWS CLI**  
**Untuk mengatur atribut pesan SMS**  
`set-sms-attributes`Contoh berikut menetapkan ID pengirim default untuk pesan SMS ke`MyName`.  

```
aws sns set-sms-attributes \
    --attributes DefaultSenderID=MyName
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [Menyetel SMSAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-sms-attributes.html) di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`set-subscription-attributes`.

**AWS CLI**  
**Untuk mengatur atribut langganan**  
`set-subscription-attributes`Contoh berikut menetapkan `RawMessageDelivery` atribut ke langganan 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
```
Perintah ini tidak menghasilkan output.  
`set-subscription-attributes`Contoh berikut menetapkan `FilterPolicy` atribut ke langganan 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\"] }"
```
Perintah ini tidak menghasilkan output.  
`set-subscription-attributes`Contoh berikut menghapus `FilterPolicy` atribut dari langganan 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 "{}"
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [SetSubscriptionAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-subscription-attributes.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`set-topic-attributes`.

**AWS CLI**  
**Untuk menetapkan atribut untuk topik**  
`set-topic-attributes`Contoh berikut menetapkan `DisplayName` atribut untuk topik yang ditentukan.  

```
aws sns set-topic-attributes \
    --topic-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --attribute-name DisplayName \
    --attribute-value MyTopicDisplayName
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [SetTopicAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-topic-attributes.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`subscribe`.

**AWS CLI**  
**Untuk berlangganan topik**  
`subscribe`Perintah berikut berlangganan alamat email ke topik yang ditentukan.  

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

```
{
    "SubscriptionArn": "pending confirmation"
}
```
+  Untuk detail API, lihat [Berlangganan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/subscribe.html) di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`tag-resource`.

**AWS CLI**  
**Untuk menambahkan tag ke topik**  
`tag-resource`Contoh berikut menambahkan tag metadata ke topik Amazon SNS yang ditentukan.  

```
aws sns tag-resource \
    --resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --tags Key=Team,Value=Alpha
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/tag-resource.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`unsubscribe`.

**AWS CLI**  
**Untuk berhenti berlangganan dari suatu topik**  
`unsubscribe`Contoh berikut menghapus langganan yang ditentukan dari suatu topik.  

```
aws sns unsubscribe \
    --subscription-arn arn:aws:sns:us-west-2:0123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [Berhenti berlangganan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/unsubscribe.html) di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`untag-resource`.

**AWS CLI**  
**Untuk menghapus tag dari topik**  
`untag-resource`Contoh berikut menghapus tag apa pun dengan kunci yang ditentukan dari topik Amazon SNS yang ditentukan.  

```
aws sns untag-resource \
    --resource-arn arn:aws:sns:us-west-2:123456789012:MyTopic \
    --tag-keys Team
```
Perintah ini tidak menghasilkan output.  
+  Untuk detail API, lihat [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/untag-resource.html)di *Referensi AWS CLI Perintah*. 

## Skenario
<a name="scenarios"></a>

### Buat titik akhir platform untuk pemberitahuan push
<a name="sns_CreatePlatformEndpoint_cli_topic"></a>

Contoh kode berikut menunjukkan cara membuat titik akhir platform untuk notifikasi push Amazon SNS.

**AWS CLI**  
**Untuk membuat endpoint aplikasi platform**  
`create-platform-endpoint`Contoh berikut membuat titik akhir untuk aplikasi platform tertentu menggunakan token yang ditentukan.  

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

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