**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.
# Peran IAM untuk mengambil rekomendasi dari Amazon Personalize
Anda dapat mengonfigurasi Amazon Pinpoint untuk mengambil data rekomendasi dari solusi Personalisasi Amazon yang telah digunakan sebagai kampanye Personalisasi Amazon. Anda dapat menggunakan data ini untuk mengirim rekomendasi yang dipersonalisasi kepada penerima pesan berdasarkan atribut dan perilaku masing-masing penerima. Untuk mempelajari lebih lanjut, lihat [Model pembelajaran mesin](https://docs.aws.amazon.com/pinpoint/latest/userguide/ml-models.html) di *Panduan Pengguna Amazon Pinpoint*.
Sebelum Anda dapat mengambil data rekomendasi dari kampanye Amazon Personalize, Anda harus membuat AWS Identity and Access Management peran (IAM) yang memungkinkan Amazon Pinpoint untuk mengambil data dari kampanye. Amazon Pinpoint dapat membuat peran ini untuk Anda secara otomatis saat Anda menggunakan konsol untuk menyiapkan model pemberi rekomendasi di Amazon Pinpoint. Atau, Anda dapat membuat peran ini secara manual.
Untuk membuat peran secara manual, gunakan IAM API untuk menyelesaikan langkah-langkah berikut:
1. Buat kebijakan IAM yang memungkinkan entitas (dalam hal ini, Amazon Pinpoint) untuk mengambil data rekomendasi dari kampanye Amazon Personalize.
1. Buat IAM role dan lampirkan kebijakan IAM ke IAM role tersebut.
Topik ini menjelaskan cara menyelesaikan langkah-langkah ini dengan menggunakan AWS Command Line Interface (AWS CLI). Ini mengasumsikan bahwa Anda telah membuat solusi Amazon Personalize dan menerapkannya sebagai kampanye Amazon Personalize. Untuk informasi tentang membuat dan menerapkan kampanye, lihat [Membuat kampanye di Panduan](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html) Pengembang *Personalisasi Amazon*.
Topik ini juga mengasumsikan bahwa Anda telah menginstal dan mengkonfigurasi. AWS CLI Untuk informasi tentang pengaturan AWS CLI, lihat [Menginstal AWS CLI di](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) *Panduan AWS Command Line Interface Pengguna*.
## Langkah 1: Buat kebijakan IAM
Kebijakan IAM mendefinisikan izin untuk entitas, seperti identitas atau sumber daya. Untuk membuat peran yang memungkinkan Amazon Pinpoint mengambil data rekomendasi dari kampanye Amazon Personalize, Anda harus terlebih dahulu membuat kebijakan IAM untuk peran tersebut. Kebijakan ini perlu mengizinkan Amazon Pinpoint untuk:
+ Ambil informasi konfigurasi untuk solusi yang diterapkan oleh campaign ()`DescribeSolution`.
+ Periksa status kampanye (`DescribeCampaign`).
+ Mengambil data rekomendasi dari kampanye (`GetRecommendations`).
Dalam prosedur berikut, kebijakan contoh memungkinkan akses ini untuk solusi Amazon Personalize tertentu yang digunakan oleh kampanye Amazon Personalize tertentu.
**Untuk membuat kebijakan IAM**
1. Di editor teks, buat file baru. Tempel kode berikut ke file:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "RetrieveRecommendationsOneCampaign",
"Effect": "Allow",
"Action": [
"personalize:DescribeSolution",
"personalize:DescribeCampaign",
"personalize:GetRecommendations"
],
"Resource": [
"arn:aws:personalize:{{us-east-1}}:{{111122223333}}:solution/{{solutionId}}",
"arn:aws:personalize:{{us-east-1}}:{{111122223333}}:campaign/{{campaignId}}"
]
}
]
}
```
------
Dalam contoh sebelumnya, ganti {{italicized}} teks dengan informasi Anda:
+ {{region}}— Nama AWS Wilayah yang menjadi tuan rumah solusi dan kampanye Amazon Personalize.
+ {{accountId}}— Akun AWS ID Anda.
+ {{solutionId}}— ID sumber daya unik untuk solusi Amazon Personalize yang digunakan oleh kampanye.
+ {{campaignId}}— ID sumber daya unik untuk kampanye Amazon Personalize untuk mengambil data rekomendasi.
1. Setelah selesai, simpan file sebagai `RetrieveRecommendationsPolicy.json`.
1. Dengan menggunakan antarmuka baris perintah, arahkan ke direktori tempat Anda menyimpan `RetrieveRecommendationsPolicy.json` file.
1. Masukkan perintah berikut untuk membuat kebijakan dan beri nama`RetrieveRecommendationsPolicy`. Untuk menggunakan nama yang berbeda, ubah {{RetrieveRecommendationsPolicy}} ke nama yang Anda inginkan.
```
aws iam create-policy --policy-name {{RetrieveRecommendationsPolicy}} --policy-document file://RetrieveRecommendationsPolicy.json
```
**catatan**
Jika Anda menerima pesan bahwa akun Anda tidak diizinkan untuk melakukan `CreatePolicy` operasi, Anda harus melampirkan kebijakan kepada pengguna yang memungkinkan Anda membuat kebijakan dan peran IAM baru untuk akun Anda. Untuk informasi lebih lanjut, lihat [Menambahkan dan menghapus izin identitas IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#attach-managed-policy-console) dalam *Panduan Pengguna IAM*.
1. Salin Nama Sumber Daya Amazon (ARN) kebijakan (`arn:aws:iam::123456789012:policy/RetrieveRecommendationsPolicy`dalam contoh sebelumnya). Anda memerlukan ARN ini untuk membuat peran IAM di bagian berikutnya.
## Langkah 2: Buat peran IAM
Setelah membuat kebijakan IAM, Anda dapat membuat peran IAM dan melampirkan kebijakan tersebut.
Setiap peran IAM berisi *kebijakan kepercayaan*, yang merupakan seperangkat aturan yang menentukan entitas mana yang diizinkan untuk mengambil peran tersebut. Di bagian ini, Anda membuat kebijakan kepercayaan yang memungkinkan Amazon Pinpoint untuk mengambil peran tersebut. Selanjutnya, Anda membuat peran itu sendiri. Kemudian, Anda melampirkan kebijakan ke peran tersebut.
**Untuk membuat peran IAM**
1. Di editor teks, buat file baru. Tempel kode berikut ke file:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Effect": "Allow",
"Principal": {
"Service": "pinpoint.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "{{111122223333}}"
},
"ArnLike": {
"AWS:SourceArn": "arn:aws:mobiletargeting:{{us-east-1}}:{{444455556666}}:apps/*"
}
}
}
]
}
```
------
1. Simpan file sebagai `RecommendationsTrustPolicy.json`.
1. Dengan menggunakan antarmuka baris perintah, arahkan ke direktori tempat Anda menyimpan `RecommendationsTrustPolicy.json` file.
1. Masukkan perintah berikut untuk membuat peran baru dan beri nama`PinpointRoleforPersonalize`. Untuk menggunakan nama yang berbeda, ubah {{PinpointRoleforPersonalize}} ke nama yang Anda inginkan.
```
aws iam create-role --role-name {{PinpointRoleforPersonalize}} --assume-role-policy-document file://RecommendationsTrustPolicy.json
```
1. Masukkan perintah berikut untuk melampirkan kebijakan yang Anda buat di bagian sebelumnya ke peran yang baru saja Anda buat:
```
aws iam attach-role-policy --policy-arn {{arn:aws:iam::123456789012:policy/RetrieveRecommendationsPolicy}} --role-name {{PinpointRoleforPersonalize}}
```
Pada perintah sebelumnya, ganti {{arn:aws:iam::123456789012:policy/RetrieveRecommendationsPolicy}} dengan ARN kebijakan yang Anda buat di bagian sebelumnya. Juga, ganti {{PinpointRoleforPersonalize}} dengan nama peran yang Anda tentukan di langkah 4, jika Anda menentukan nama yang berbeda untuk peran tersebut.