Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan peran terkait layanan untuk Amazon AppIntegrations
Amazon AppIntegrations menggunakan peran AWS Identity and Access Management [terkait layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) (IAM). Peran terkait layanan adalah jenis peran IAM unik yang ditautkan langsung ke Amazon. AppIntegrations Peran terkait layanan telah ditentukan sebelumnya oleh Amazon AppIntegrations dan mencakup semua izin yang diperlukan layanan untuk memanggil AWS layanan lain atas nama Anda.
Peran terkait layanan membuat pengaturan Amazon AppIntegrations lebih mudah karena Anda tidak perlu menambahkan izin yang diperlukan secara manual. Amazon AppIntegrations mendefinisikan izin peran terkait layanannya, dan kecuali ditentukan lain, hanya Amazon yang AppIntegrations dapat mengambil perannya. Izin yang ditentukan mencakup kebijakan kepercayaan dan kebijakan izin, dan kebijakan izin tersebut tidak dapat dilampirkan ke entitas IAM lainnya.
Anda dapat menghapus peran tertaut layanan hanya setelah menghapus sumber daya terkait terlebih dahulu. Ini melindungi AppIntegrations sumber daya Amazon Anda karena Anda tidak dapat secara tidak sengaja menghapus izin untuk mengakses sumber daya.
Untuk informasi tentang layanan lain yang mendukung peran terkait layanan, lihat [Layanan AWS yang Bekerja bersama IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) dan mencari layanan yang memiliki **Ya** dalam **Peran Terkait Layanan**. Pilih **Ya** dengan sebuah tautan untuk melihat dokumentasi peran terkait layanan untuk layanan tersebut.
## Izin peran terkait layanan untuk Amazon AppIntegrations
Amazon AppIntegrations menggunakan nama peran terkait layanan **AWSServiceRoleForAppIntegrations**yang memungkinkan Anda AppIntegrations mengakses layanan dan sumber daya AWS atas nama Anda.
Peran AWSService RoleForAppIntegrations terkait layanan mempercayai layanan berikut untuk mengambil peran:
+ `app-integrations.amazonaws.com`
Kebijakan izin peran bernama AppIntegrationsServiceLinkedRolePolicy memungkinkan Amazon AppIntegrations menyelesaikan tindakan berikut pada sumber daya yang ditentukan:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:PutMetricData"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"cloudwatch:namespace": "AWS/AppIntegrations"
}
}
},
{
"Effect": "Allow",
"Action": [
"appflow:DescribeConnectorEntity",
"appflow:ListConnectorEntities"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"appflow:DescribeConnectorProfiles",
"appflow:UseConnectorProfile"
],
"Resource": "arn:aws:appflow:*:*:connector-profile/*"
},
{
"Effect": "Allow",
"Action": [
"appflow:DeleteFlow",
"appflow:DescribeFlow",
"appflow:DescribeFlowExecutionRecords",
"appflow:StartFlow",
"appflow:StopFlow",
"appflow:UpdateFlow"
],
"Condition": {
"StringEquals": {
"aws:ResourceTag/AppIntegrationsManaged": "true"
}
},
"Resource": "arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-*"
},
{
"Effect": "Allow",
"Action": [
"appflow:TagResource"
],
"Condition": {
"ForAllValues:StringEquals": {
"aws:TagKeys": [
"AppIntegrationsManaged"
]
}
},
"Resource": "arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-*"
}
]
}
```
------
+ Tindakan: `cloudwatch:PutMetricData` saat `"*"` menggunakan `StringEquals` kondisi`"cloudwatch:namespace": "AWS/AppIntegrations"`.
+ Aksi: `appflow:DescribeConnectorEntity` dan `appflow:ListConnectorEntities` seterusnya`"*"`.
+ Aksi: `appflow:DescribeConnectorProfiles` dan `appflow:UseConnectorProfile` seterusnya ` arn:aws:appflow:*:*:connector-profile/*`
+ Tindakan:`appflow:DeleteFlow`,`appflow:DescribeFlow`,`appflow:DescribeFlowExecutionRecords`, `appflow:StartFlow``appflow:StopFlow`,, dan `appflow:UpdateFlow` pada ` arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-*` penggunaan `StringEquals` kondisi`"aws:ResourceTag/AppIntegrationsManaged": "true"`.
+ Tindakan: `appflow:TagResource` saat `arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-*` menggunakan `ForAllValues:StringEquals aws:TagKeys` kondisi`AppIntegrationsManaged`.
Anda harus mengonfigurasi izin untuk mengizinkan entitas IAM (seperti pengguna, grup, atau peran) untuk membuat, mengedit, atau menghapus peran terkait layanan. Untuk informasi selengkapnya, lihat [Izin peran tertaut layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) dalam *Panduan Pengguna IAM*.
## Membuat peran terkait layanan untuk Amazon AppIntegrations
Anda tidak perlu membuat peran terkait layanan secara manual. Saat Anda membuat integrasi data atau peristiwa menggunakan agen Connect AI, Customer Profiles, atau widget Tasks di Amazon Connect di Konsol Manajemen AWS AWS CLI, the, atau AWS API, Amazon AppIntegrations membuat peran terkait layanan untuk Anda.
**penting**
Peran tertaut layanan ini dapat muncul di akun Anda jika Anda menyelesaikan tindakan di layanan lain yang menggunakan fitur yang disupport oleh peran ini. Selain itu, jika Anda membuat AppIntegrations sumber daya Amazon baru setelah 30 September 2022, ketika mulai mendukung peran terkait layanan, Amazon AppIntegrations membuat AWSService RoleForAppIntegrations peran tersebut di akun Anda. Untuk mempelajari lebih lanjut, lihat [Peran baru muncul di akun IAM saya](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared).
Jika Anda menghapus peran terkait layanan ini, dan ingin membuatnya lagi, Anda dapat mengulangi proses yang sama untuk membuat kembali peran tersebut di akun Anda. Saat Anda membuat integrasi data atau peristiwa menggunakan agen Connect AI, Customer Profiles, atau widget Tasks di Amazon Connect, Amazon akan AppIntegrations membuat peran terkait layanan untuk Anda lagi.
Anda juga dapat menggunakan konsol IAM untuk membuat peran terkait layanan dengan kasus penggunaan. **AppIntegrations** Di AWS CLI atau AWS API, buat peran terkait layanan dengan nama `app-integrations.amazonaws.com` layanan. Untuk informasi selengkapnya, lihat [Membuat peran tertaut layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role) dalam *Panduan Pengguna IAM*. Jika Anda menghapus peran tertaut layanan ini, Anda dapat mengulang proses yang sama untuk membuat peran tersebut lagi.
## Mengedit peran terkait layanan untuk Amazon AppIntegrations
Amazon AppIntegrations tidak mengizinkan Anda mengedit peran AWSService RoleForAppIntegrations terkait layanan. Setelah membuat peran terkait layanan, Anda tidak dapat mengubah nama peran karena berbagai entitas mungkin merujuk peran tersebut. Namun, Anda dapat mengedit penjelasan peran menggunakan IAM. Untuk informasi selengkapnya, lihat [Mengedit peran terkait layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) dalam *Panduan Pengguna IAM*.
## Menghapus peran terkait layanan untuk Amazon AppIntegrations
Jika Anda tidak perlu lagi menggunakan fitur atau layanan yang memerlukan peran terkait layanan, sebaiknya hapus peran tersebut. Dengan begitu, Anda tidak memiliki entitas yang tidak digunakan yang tidak dipantau atau dipelihara secara aktif. Tetapi, Anda harus membersihkan sumber daya peran yang terhubung dengan layanan sebelum menghapusnya secara manual. Pertama-tama Anda harus menghapus data dan asosiasi integrasi acara di AWS Konsol, lalu menghapus data dan integrasi acara menggunakan. AWS CLI
**catatan**
Jika AppIntegrations layanan Amazon menggunakan peran saat Anda mencoba menghapus sumber daya, maka penghapusan mungkin gagal. Jika hal itu terjadi, tunggu beberapa menit dan coba mengoperasikannya lagi.
**Untuk menghapus asosiasi integrasi data yang digunakan oleh AWSService RoleForAppIntegrations di AWS Konsol**
1. Buka bagian Connect AI agents di Amazon Connect Console dan pilih nama asosiasi integrasi data yang ingin Anda hapus.
1. Pilih **Hapus** di sisi kanan bagian **Detail integrasi**.
1. Di kotak pop, masukkan nama integrasi untuk konfirmasi dan pilih **Hapus**.
**Untuk menghapus integrasi data yang digunakan oleh AWSService RoleForAppIntegrations menggunakan AWS CLI**
1. Buat daftar integrasi data Anda untuk melihat nama integrasi yang ada.
`aws appintegrations list-data-integrations`
1. Hapus setiap integrasi menggunakan nama integrasi data.
`aws appintegrations delete-data-integration --data-integration-identifier DATA_INTEGRATION_NAME`
**Untuk menghapus asosiasi integrasi acara yang digunakan oleh AWSService RoleForAppIntegrations di AWS Konsol**
1. Buka Profil Pelanggan atau bagian Tugas di Konsol Amazon Connect dan pilih nama asosiasi integrasi acara yang ingin Anda hapus.
1. Setelah Anda memilih integrasi acara di bagian Tugas, pop-up akan muncul. Pilih tombol **Hapus koneksi** dan masukkan kata hapus untuk *menghapus* asosiasi integrasi acara Anda.
**Untuk menghapus integrasi acara yang digunakan oleh AWSService RoleForAppIntegrations menggunakan AWS CLI**
1. Buat daftar integrasi acara Anda untuk melihat nama integrasi yang ada.
`aws appintegrations list-event-integrations`
1. Hapus setiap integrasi menggunakan nama integrasi data.
`aws appintegrations delete-event-integration --name EVENT_INTEGRATION_NAME`
**Untuk menghapus peran tertaut layanan secara manual menggunakan IAM**
Gunakan konsol IAM, the AWS CLI, atau AWS API untuk menghapus peran AWSService RoleForAppIntegrations terkait layanan. Untuk informasi selengkapnya, lihat [Menghapus peran terkait layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) dalam *Panduan Pengguna IAM*.
## Wilayah yang didukung untuk peran AppIntegrations terkait layanan Amazon
Amazon AppIntegrations mendukung penggunaan peran terkait layanan di semua wilayah tempat layanan tersedia. Untuk informasi selengkapnya, silakan lihat [Wilayah AWS dan titik akhir](https://docs.aws.amazon.com/general/latest/gr/rande.html).
Anda dapat menggunakan AWSService RoleForAppIntegrations peran di wilayah berikut.
****
| Nama wilayah | Identitas wilayah | Support di Amazon AppIntegrations |
| --- | --- | --- |
| US East (Northern Virginia) | us-east-1 | Ya |
| US West (Oregon) | us-west-2 | Ya |
| Asia Pacific (Mumbai) | ap-south-1 | Ya |
| Asia Pacific (Seoul) | ap-northeast-2 | Ya |
| Asia Pacific (Singapore) | ap-southeast-1 | Ya |
| Asia Pacific (Sydney) | ap-southeast-2 | Ya |
| Asia Pacific (Tokyo) | ap-northeast-1 | Ya |
| Canada (Central) | ca-sentral-1 | Ya |
| Eropa (Frankfurt) | eu-central-1 | Ya |
| Eropa (London) | eu-west-2 | Ya |
| Africa (Cape Town) | af-south-1 | Ya |