

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

# Berlangganan laporan penggunaan SMS harian Amazon SNS
<a name="sms_stats_usage"></a>

Anda dapat memantau pengiriman SMS Anda dengan berlangganan laporan penggunaan harian dari Amazon SNS. Untuk setiap hari saat Anda mengirim setidaknya satu pesan SMS, Amazon SNS mengirimkan laporan penggunaan dalam file CSV ke bucket Amazon S3 tertentu. Dibutuhkan 24 jam agar laporan penggunaan SMS tersedia di bucket Amazon S3. 

## Informasi laporan penggunaan harian
<a name="daily_usage_info"></a>

Laporan penggunaan mencakup informasi berikut untuk setiap pesan SMS yang Anda kirim dari akun Anda.

 Perhatikan bahwa laporan ini tidak menyertakan pesan yang dikirim ke penerima yang telah memilih untuk tidak menerima pesan.
+ Waktu penerbitan untuk pesan (dalam UTC)
+ ID Pesan
+ Nomor telepon tujuan
+ Jenis pesan
+ Status pengiriman
+ Harga pesan (dalam USD)
+ Jumlah bagian (pesan dibagi menjadi beberapa bagian jika terlalu panjang untuk satu pesan)
+ Jumlah total bagian

**catatan**  
Jika Amazon SNS tidak menerima jumlah bagian, kami mengatur nilainya ke nol.

## Berlangganan laporan penggunaan harian
<a name="subscribe-to-daily-usage-reports"></a>

Untuk berlangganan laporan penggunaan harian, Anda harus membuat bucket Amazon S3 dengan izin yang sesuai.

**Cara membuat bucket Amazon S3 untuk laporan penggunaan harian Anda**

1. Dari Akun AWS yang mengirim pesan SMS, masuk ke konsol [Amazon S3](https://console.aws.amazon.com/s3/).

1. Pilih **Create Bucket** (Buat Bucket).

1. Untuk **Bucket Name** (Nama Bucket), sebaiknya masukkan nama yang unik untuk akun dan organisasi Anda. Misalnya, gunakan pola `<my-bucket-prefix>-<account_id>-<org-id>`. 

   Untuk informasi tentang konvensi dan batasan untuk nama bucket, lihat [Aturan untuk Penamaan Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html#bucketnamingrules) di *Panduan Pengguna Layanan Penyimpanan Sederhana Amazon*.

1. Pilih **Buat**.

1. Di tabel **All Buckets** (Semua Bucket), pilih nama bucket.

1. Di tab **Permission** (Izin), pilih **Bucket policy** (Kebijakan bucket).

1. Di jendela **Bucket Policy Editor** (Editor Kebijakan Bucket), berikan kebijakan yang mengizinkan perwakilan layanan Amazon SNS untuk menulis ke bucket Anda. Sebagai contoh, lihat [Contoh kebijakan bucket](#example_bucket_policy).

   Jika Anda menggunakan kebijakan contoh, ingatlah untuk mengganti {{my-s3-bucket}} dengan nama bucket yang Anda pilih di Langkah 3.

1. Pilih **Simpan**.

**Cara berlangganan laporan penggunaan harian**

1. Masuk ke [konsol Amazon SNS](https://console.aws.amazon.com/sns/).

1. Di panel navigasi, pilih **Text messaging (SMS)** (Olahpesan teks (SMS)).

1. Di halaman **Text messaging (SMS)** (Olahpesan teks (SMS)), di bagian **Text messaging preferences** (Preferensi olahpesan teks), pilih **Edit**.  
![Bagian preferensi pesan teks di konsol Amazon SNS](http://docs.aws.amazon.com/id_id/sns/latest/dg/images/daily-usage-report1.png)

1. Di halaman **Edit text messaging preferences** (Edit preferensi olahpesan teks), di bagian **Details** (Detail), tentukan **Nama bucket Amazon S3 untuk laporan penggunaan**.  
![Bagian detail dari halaman Edit preferensi pesan teks di konsol Amazon SNS](http://docs.aws.amazon.com/id_id/sns/latest/dg/images/daily-usage-report2.png)

1. Pilih **Simpan perubahan**.

### Contoh kebijakan bucket
<a name="example_bucket_policy"></a>

Kebijakan berikut mengizinkan perwakilan layanan Amazon SNS untuk melakukan tindakan `s3:PutObject`, `s3:GetBucketLocation`, dan `s3:ListBucket`.

AWS menyediakan alat untuk semua layanan dengan prinsip layanan yang telah diberikan akses ke sumber daya di akun Anda. Ketika kepala sekolah dalam pernyataan kebijakan bucket Amazon S3 adalah masalah [wakil yang membingungkan](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html). Untuk membatasi wilayah dan akun tempat bucket dapat menerima laporan penggunaan harian, gunakan `aws:SourceArn` seperti yang ditunjukkan pada contoh di bawah ini. Jika Anda tidak ingin membatasi wilayah mana yang dapat menghasilkan laporan ini, gunakan `aws:SourceAccount` untuk membatasi berdasarkan akun mana yang menghasilkan laporan. Jika Anda tidak tahu ARN sumber daya, gunakan. `aws:SourceAccount`

Gunakan contoh berikut yang menyertakan perlindungan wakil yang membingungkan saat Anda membuat bucket Amazon S3 untuk menerima laporan penggunaan SMS harian dari Amazon SNS.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowPutObject",
            "Effect": "Allow",
            "Principal": {
                "Service": "sns.amazonaws.com"
            },
            "Action": "s3:PutObject",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "account_id"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:sns:us-west-1:123456789012:*"
                }
            }
        },
        {
            "Sid": "AllowGetBucketLocation",
            "Effect": "Allow",
            "Principal": {
                "Service": "sns.amazonaws.com"
            },
            "Action": "s3:GetBucketLocation",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "account_id"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:sns:us-west-1:123456789012:*"
                }
            }
        },
        {
            "Sid": "AllowListBucket",
            "Effect": "Allow",
            "Principal": {
                "Service": "sns.amazonaws.com"
            },
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "account_id"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:sns:us-west-1:123456789012:*"
                }
            }
        }
    ]
}
```

------

**catatan**  
Anda dapat menerbitkan laporan penggunaan ke bucket Amazon S3 yang dimiliki oleh Akun AWS yang ditentukan dalam elemen `Condition` di kebijakan Amazon S3. Untuk mempublikasikan laporan penggunaan ke bucket Amazon S3 yang Akun AWS dimiliki orang lain, [lihat Bagaimana cara menyalin objek Amazon S3](https://aws.amazon.com/premiumsupport/knowledge-center/copy-s3-objects-account/) dari yang lain? Akun AWS. 

### Contoh laporan penggunaan harian
<a name="example_report"></a>

Setelah Anda berlangganan laporan penggunaan harian, setiap hari, Amazon SNS menempatkan file CSV dengan data penggunaan di lokasi berikut:

```
{{<my-s3-bucket>}}/SMSUsageReports/{{<region>}}/{{YYYY}}/{{MM}}/{{DD}}/{{00x}}.csv.gz
```

Setiap file dapat berisi hingga 50.000 catatan. Jika catatan untuk satu hari melebihi kuota ini, Amazon SNS akan menambahkan beberapa file. Berikut adalah contoh laporan:

```
PublishTimeUTC,MessageId,DestinationPhoneNumber,MessageType,DeliveryStatus,PriceInUSD,PartNumber,TotalParts
2016-05-10T03:00:29.476Z,96a298ac-1458-4825-a7eb-7330e0720b72,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.90084,0,1
2016-05-10T03:00:29.561Z,1e29d394-d7f4-4dc9-996e-26412032c344,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.34322,0,1
2016-05-10T03:00:30.769Z,98ba941c-afc7-4c51-ba2c-56c6570a6c08,1XXX5550100,Transactional,Message has been accepted by phone carrier,0.27815,0,1
```