**Pemberitahuan akhir dukungan:** Pada 30 Oktober 2026, AWS akan mengakhiri dukungan untuk Amazon Pinpoint. Setelah 30 Oktober 2026, Anda tidak akan lagi dapat mengakses konsol Amazon Pinpoint atau sumber daya Amazon Pinpoint (titik akhir, segmen, kampanye, perjalanan, dan analitik). Untuk informasi selengkapnya, lihat [Amazon Pinpoint akhir dukungan.](https://docs.aws.amazon.com/console/pinpoint/migration-guide) **Catatan:** APIs terkait dengan SMS, suara, push seluler, OTP, dan validasi nomor telepon tidak terpengaruh oleh perubahan ini dan didukung oleh AWS End User Messaging.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengelola tag sumber daya Amazon Pinpoint
*Tag* adalah label yang secara opsional Anda tentukan dan kaitkan dengan AWS sumber daya, termasuk jenis sumber daya Amazon Pinpoint tertentu. Tag dapat membantu Anda mengkategorikan dan mengelola sumber daya dengan berbagai cara, seperti berdasarkan tujuan, pemilik, lingkungan, atau kriteria lainnya. Misalnya, Anda dapat menggunakan tag untuk menerapkan kebijakan atau otomatisasi, atau untuk mengidentifikasi sumber daya yang tunduk pada persyaratan kepatuhan tertentu. Anda dapat menambahkan tag ke jenis sumber daya Amazon Pinpoint berikut:
+ Kampanye
+ Template pesan
+ Proyek (aplikasi)
+ Segmen
Sumber daya dapat memiliki sebanyak 50 tag. Setiap tag terdiri dari *kunci tag* yang diperlukan dan *nilai tag* opsional, yang keduanya Anda tentukan. *Kunci tag* adalah label umum yang bertindak sebagai kategori untuk nilai tag yang lebih spesifik. *Nilai tag* bertindak sebagai deskriptor untuk kunci tag.
Kunci tag dapat berisi sebanyak 128 karakter. Nilai tag dapat berisi sebanyak 256 karakter. Karakter dapat berupa huruf Unicode, angka, spasi putih, atau salah satu simbol berikut: \$1. :/= \$1 -. Pembatasan tambahan berikut berlaku untuk tag:
+ Kunci dan nilai tag sensitif huruf besar dan kecil.
+ Untuk setiap sumber daya terkait, setiap kunci tag harus unik dan hanya dapat memiliki satu nilai.
+ `aws:`Awalan dicadangkan untuk digunakan oleh AWS; Anda tidak dapat menggunakannya dalam kunci tag atau nilai apa pun yang Anda tentukan. Selain itu, Anda tidak dapat mengedit atau menghapus kunci tag atau nilai yang menggunakan awalan ini. Tag yang menggunakan awalan ini tidak dihitung terhadap kuota 50 tag per sumber daya.
+ Anda tidak dapat memperbarui atau menghapus sumber daya hanya berdasarkan tagnya. Anda juga harus menentukan Nama Sumber Daya Amazon (ARN) atau ID sumber daya, tergantung pada operasi yang Anda gunakan.
+ Anda dapat mengaitkan tag dengan sumber daya publik atau bersama. Namun, tag hanya tersedia untuk AWS akun Anda, bukan akun lain yang berbagi sumber daya. Selain itu, tag hanya tersedia untuk sumber daya yang terletak di AWS Wilayah yang ditentukan untuk AWS akun Anda.
Untuk menambahkan, menampilkan, memperbarui, dan menghapus kunci dan nilai tag dari sumber daya Amazon Pinpoint, Anda dapat menggunakan AWS Command Line Interface (AWS CLI), Amazon Pinpoint API, API Tagging, AWS Resource Groups atau SDK. AWS Untuk mengelola kunci dan nilai tag di semua AWS sumber daya yang terletak di AWS Wilayah tertentu untuk AWS akun Anda (termasuk sumber daya Amazon Pinpoint), gunakan API [AWS Resource Groups Penandaan](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html).
[Untuk informasi selengkapnya tentang perintah CLI yang dapat Anda gunakan untuk mengelola sumber daya Amazon Pinpoint, lihat bagian Amazon Pinpoint pada Referensi Perintah.AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/)
Untuk informasi selengkapnya tentang sumber daya di Amazon Pinpoint API, termasuk metode, parameter, dan skema HTTP (S) yang didukung, lihat Referensi API [Amazon](https://docs.aws.amazon.com/pinpoint/latest/apireference/) Pinpoint.
# Menggunakan tag Amazon Pinpoint dalam kebijakan IAM dan operasi API
Setelah mulai menerapkan tag, Anda dapat menerapkan izin tingkat sumber daya berbasis tag ke kebijakan AWS Identity and Access Management (IAM) dan operasi API. Ini termasuk operasi yang mendukung penambahan tag ke sumber daya saat sumber daya dibuat. Dengan menggunakan tag dengan cara ini, Anda dapat menerapkan kontrol terperinci dari grup dan pengguna mana di AWS akun Anda yang memiliki izin untuk membuat dan menandai sumber daya, dan grup dan pengguna mana yang memiliki izin untuk membuat, memperbarui, dan menghapus tag secara lebih umum.
Misalnya, Anda dapat membuat kebijakan yang memungkinkan pengguna memiliki akses penuh ke semua sumber daya Amazon Pinpoint yang namanya merupakan nilai dalam `Owner` tag untuk sumber daya:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "ModifyResourceIfOwner",
"Effect": "Allow",
"Action": "mobiletargeting:*",
"Resource": "*",
"Condition": {
"StringEqualsIgnoreCase": {
"aws:ResourceTag/Owner": "${aws:username}"
}
}
}
]
}
```
------
Jika Anda menentukan izin tingkat sumber daya berbasis tag, izin akan segera berlaku. Ini berarti bahwa sumber daya Anda lebih aman segera setelah dibuat, dan Anda dapat dengan cepat mulai menerapkan penggunaan tag untuk sumber daya baru. Anda juga dapat menggunakan izin tingkat sumber daya untuk mengontrol kunci dan nilai tag mana yang dapat dikaitkan dengan sumber daya baru dan yang sudah ada. Untuk informasi selengkapnya, lihat [Mengontrol Akses Menggunakan Tanda](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) di *AWS Panduan Pengguna IAM*.
# Tambahkan tag ke sumber daya Amazon Pinpoint secara terprogram
Contoh berikut menunjukkan cara menambahkan tag ke sumber daya Amazon Pinpoint dengan menggunakan API REST [Amazon Pinpoint [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/)dan Amazon](https://docs.aws.amazon.com/pinpoint/latest/apireference/). Anda juga dapat menggunakan AWS SDK apa pun yang didukung untuk menambahkan tag ke sumber daya.
[Untuk menambahkan tag ke beberapa sumber daya Amazon Pinpoint dalam satu operasi, gunakan operasi penandaan grup sumber daya dari AWS CLI atau API Penandaan.AWS Resource Groups](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html)
## Tambahkan tag dengan menggunakan API
Untuk membuat sumber daya baru dan menambahkan tag ke dalamnya menggunakan Amazon Pinpoint REST API, kirim permintaan POST ke URI sumber daya yang sesuai. Sertakan `tags` parameter dan nilai dalam badan permintaan. Contoh berikut menunjukkan cara menentukan tag saat Anda membuat proyek baru.
```
POST /v1/apps HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
Accept: application/json
Cache-Control: no-cache
{
"Name":"MyProject",
"tags":{
"key1":"value1"
}
}
```
Untuk menambahkan tag ke sumber daya yang ada, kirim permintaan POST ke URI [Tag](https://docs.aws.amazon.com/pinpoint/latest/apireference/tags-resource-arn.html). Sertakan Nama Sumber Daya Amazon (ARN) sumber daya di URI. ARN harus dikodekan URL. Di badan permintaan, sertakan `tags` parameter dan nilai, seperti yang ditunjukkan pada contoh berikut.
```
POST /v1/tags/resource-arn HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
{
"tags":{
"key1":"value1"
}
}
```
## Tambahkan tag dengan menggunakan AWS CLI
Untuk membuat sumber daya baru dan menambahkan tag ke dalamnya dengan menggunakan AWS CLI, gunakan `create` perintah yang sesuai untuk sumber daya. Sertakan `tags` parameter dan nilai. Contoh berikut menunjukkan cara menentukan tag saat Anda membuat proyek baru.
------
#### [ Linux, macOS, or Unix ]
```
$ aws pinpoint create-app \
--create-application-request '{
"Name":"MyProject",
"tags": {
"key1":"value1",
"key2":"value2"
}
}'
```
------
#### [ Windows Command prompt ]
```
C:\> aws pinpoint create-app ^
--create-application-request Name=MyProject,tags={key1=value1,key2=value2}
```
------
Pada contoh sebelumnya, lakukan hal berikut:
+ Ganti *MyProject* dengan nama yang ingin Anda berikan proyek.
+ Ganti *key1* dan *key2* dengan kunci tag yang ingin Anda tambahkan ke sumber daya.
+ Ganti *value1* dan *value2* dengan nilai tag yang ingin Anda tambahkan untuk masing-masing kunci.
Untuk informasi tentang perintah yang dapat Anda gunakan untuk membuat sumber daya Amazon Pinpoint, lihat Referensi [AWS CLI Perintah](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/).
Untuk menambahkan tag ke sumber daya yang ada, gunakan `tag-resource` perintah dan tentukan nilai yang sesuai untuk parameter yang diperlukan:
------
#### [ Linux, macOS, or Unix ]
```
$ aws pinpoint tag-resource \
--resource-arn resource-arn \
--tags-model '{
"tags": {
"key1":"value1",
"key2":"value2"
}
}'
```
------
#### [ Windows Command Prompt ]
```
C:\> aws pinpoint tag-resource ^
--resource-arn resource-arn ^
--tags-model tags={key1=value1,key2=value2}
```
------
Pada contoh sebelumnya, lakukan hal berikut:
+ Ganti *resource-arn* dengan Amazon Resource Name (ARN) dari sumber daya yang ingin Anda tambahkan tag.
+ Ganti *key1* dan *key2* dengan kunci tag yang ingin Anda tambahkan ke sumber daya.
+ Ganti *value1* dan *value2* dengan nilai tag yang ingin Anda tambahkan untuk masing-masing kunci.
# Menampilkan tag untuk sumber daya Amazon Pinpoint secara terprogram
Contoh berikut menunjukkan cara menggunakan [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/)dan [Amazon Pinpoint REST API](https://docs.aws.amazon.com/pinpoint/latest/apireference/) untuk menampilkan daftar semua tag (kunci dan nilai) yang terkait dengan sumber daya Amazon Pinpoint. Anda juga dapat menggunakan AWS SDK apa pun yang didukung untuk menampilkan tag yang terkait dengan sumber daya.
## Menampilkan tag dengan menggunakan API
Untuk menggunakan Amazon Pinpoint REST API untuk menampilkan semua tag yang terkait dengan sumber daya tertentu, kirim permintaan GET ke URI [Tag](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html) dan sertakan Nama Sumber Daya Amazon (ARN) sumber daya di URI. ARN harus dikodekan URL. Misalnya, permintaan berikut mengambil semua tag yang terkait dengan kampanye tertentu (*resource-arn*):
```
GET /v1/tags/resource-arn HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
```
Respons JSON untuk permintaan termasuk `tags` objek. `tags`Objek mencantumkan semua kunci tag dan nilai yang terkait dengan kampanye.
Untuk menampilkan semua tag yang terkait dengan lebih dari satu sumber daya dari jenis yang sama, kirim permintaan GET ke URI yang sesuai untuk jenis sumber daya tersebut. Misalnya, permintaan berikut mengambil informasi tentang semua kampanye dalam project (*application-id*) yang ditentukan:
```
GET /v1/apps/application-id/campaigns HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
```
Respons JSON terhadap permintaan mencantumkan semua kampanye dalam proyek. `tags`Objek setiap kampanye mencantumkan semua kunci tag dan nilai yang terkait dengan kampanye.
## Menampilkan tag dengan menggunakan AWS CLI
Untuk menggunakan AWS CLI untuk menampilkan daftar tag yang terkait dengan sumber daya tertentu, jalankan `list-tags-for-resource` perintah dan tentukan Nama Sumber Daya Amazon (ARN) sumber daya untuk `resource-arn` parameter, seperti yang ditunjukkan pada contoh berikut.
------
#### [ Linux, macOS, or Unix ]
```
$ aws pinpoint list-tags-for-resource \
--resource-arn resource-arn
```
------
#### [ Windows Command Prompt ]
```
C:\> aws pinpoint list-tags-for-resource ^
--resource-arn resource-arn
```
------
Untuk menampilkan daftar semua resource Amazon Pinpoint yang memiliki tag, dan semua tag yang terkait dengan masing-masing resource tersebut, gunakan perintah [get-resources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html) dari API Tagging. AWS Resource Groups Atur `resource-type-filters` parameter ke`mobiletargeting`, seperti yang ditunjukkan pada contoh berikut.
------
#### [ Linux, macOS, or Unix ]
```
$ aws resourcegroupstaggingapi get-resources \
--resource-type-filters "mobiletargeting"
```
------
#### [ Windows Command Prompt ]
```
C:\> aws resourcegroupstaggingapi get-resources ^
--resource-type-filters "mobiletargeting"
```
------
Output dari perintah ini adalah daftar ARNs untuk semua sumber daya Amazon Pinpoint yang memiliki tag. Daftar ini mencakup semua kunci tag dan nilai yang terkait dengan setiap sumber daya.
# Memperbarui atau menimpa tag untuk sumber daya Amazon Pinpoint secara terprogram
Ada beberapa cara untuk memperbarui (menimpa) tag untuk sumber daya Amazon Pinpoint. Cara terbaik untuk memperbarui tag tergantung pada:
+ Jenis sumber daya yang ingin Anda perbarui tag.
+ Apakah Anda ingin memperbarui tag untuk satu atau beberapa sumber daya secara bersamaan.
+ Apakah Anda ingin memperbarui kunci tag, nilai tag, atau keduanya.
[Untuk memperbarui tag untuk proyek Amazon Pinpoint atau untuk beberapa sumber daya secara bersamaan, gunakan operasi penandaan grup sumber daya dari AWS CLI atau API Penandaan.AWS Resource Groups](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) Amazon Pinpoint API saat ini tidak memberikan dukungan langsung untuk salah satu tugas tersebut.
Untuk memperbarui tag untuk satu sumber daya, Anda dapat [menghapus tag saat ini](tags-remove.md) dan [menambahkan tag baru](tags-add.md) dengan menggunakan Amazon Pinpoint API.
# Hapus tag dari sumber daya Amazon Pinpoint secara terprogram
Contoh berikut menunjukkan cara menghapus tag (kunci dan nilai) dari sumber daya Amazon Pinpoint dengan menggunakan API REST [Amazon Pinpoint [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/)dan Amazon](https://docs.aws.amazon.com/pinpoint/latest/apireference/). Anda juga dapat menggunakan AWS SDK yang didukung untuk menghapus tag dari sumber daya.
[Untuk menghapus tag dari beberapa sumber daya Amazon Pinpoint dalam satu operasi, gunakan operasi penandaan grup sumber daya dari AWS CLI atau API Penandaan.AWS Resource Groups](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/Welcome.html) Untuk menghapus hanya nilai tag tertentu (bukan kunci tag) dari sumber daya, [perbarui tag untuk sumber daya](tags-update.md).
## Hapus tag dengan menggunakan API
Untuk menghapus tag dari sumber daya menggunakan Amazon Pinpoint REST API, kirim permintaan DELETE ke URI [Tag](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-tags.html). Di URI, sertakan Nama Sumber Daya Amazon (ARN) sumber daya yang ingin Anda hapus tag, diikuti oleh `tagKeys` parameter dan tag yang akan dihapus. Contoh:
```
https://endpoint/v1/tags/resource-arn?tagKeys=key
```
Di mana:
+ *endpoint*adalah titik akhir Amazon Pinpoint untuk AWS Wilayah yang menampung sumber daya.
+ *resource-arn*adalah ARN dari sumber daya yang ingin Anda hapus tag.
+ *key*adalah tag yang ingin Anda hapus dari sumber daya.
Semua parameter harus dikodekan URL.
Untuk menghapus beberapa kunci tag dan nilai terkaitnya dari sumber daya, tambahkan `tagKeys` parameter dan argumen untuk setiap tag tambahan yang akan dihapus, dipisahkan oleh ampersand (&). Contoh:
```
https://endpoint/v1/tags/resource-arn?tagKeys=key1&tagKeys=key2
```
Semua parameter harus dikodekan URL.
## Hapus tag dengan menggunakan AWS CLI
Untuk menghapus tag dari sumber daya dengan menggunakan AWS CLI, jalankan `untag-resource` perintah. Sertakan `tag-keys` parameter dan argumen, seperti yang ditunjukkan pada contoh berikut.
------
#### [ Linux, macOS, or Unix ]
```
$ aws pinpoint untag-resource \
--resource-arn resource-arn \
--tag-keys key1 key2
```
------
#### [ Windows Command Prompt ]
```
C:\> aws pinpoint untag-resource ^
--resource-arn resource-arn ^
--tag-keys key1 key2
```
------
Pada contoh sebelumnya, lakukan perubahan berikut:
+ Ganti *resource-arn* dengan ARN sumber daya yang ingin Anda hapus tag.
+ Ganti *key1* dan *key2* dengan kunci tag yang ingin Anda hapus dari sumber daya.