本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 針對 Application AppIntegrations 使用服務連結角色
Amazon AppIntegrations 使用 AWS Identity and Access Management (IAM)[ 服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role)。服務連結角色是直接連結至 Amazon AppIntegrations 的一種特殊 IAM 角色類型。服務連結角色是由 Amazon AppIntegrations 預先定義，並包含該服務代表您呼叫其他 AWS 服務所需的所有許可。
服務連結角色可讓設定 Amazon AppIntegrations 更為簡單，因為您不必手動新增必要的許可。Amazon AppIntegrations 定義其服務連結角色的許可，除非另有定義，否則僅有 Amazon AppIntegrations 可以擔任其角色。定義的許可包括信任政策和許可政策，且該許可政策無法附加至其他 IAM 實體。
您必須先刪除服務連結角色的相關資源，才能將其刪除。如此可保護您的 Amazon AppIntegrations 資源，避免您不小心移除資源的存取許可。
如需有關支援服務連結角色的其他 服務的資訊，請參閱[AWS 服務連結角色欄中適用於 IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 的服務，並尋找具有**是**的服務。 ****選擇具有連結的**是**，以檢視該服務的服務連結角色文件。
## Amazon AppIntegrations 的服務連結角色許可
Amazon AppIntegrations 使用名為 **AWSServiceRoleForAppIntegrations** 的服務連結角色，其可讓 AppIntegrations 代表您存取 AWS 服務。
AWSServiceRoleForAppIntegrations 服務連結角色會信任下列服務來擔任此角色：
+ `app-integrations.amazonaws.com`
名為 AppIntegrationsServiceLinkedRolePolicy 的服務連結角色許可政策允許 Amazon AppIntegrations 對指定的資源完成下列動作：
------
#### [ 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-*"
}
]
}
```
------
+ 動作：`cloudwatch:PutMetricData` 在 `"*"` 使用 `StringEquals` 條件 `"cloudwatch:namespace": "AWS/AppIntegrations"`。
+ 動作：`appflow:DescribeConnectorEntity` 和 `"*"` 的 `appflow:ListConnectorEntities`。
+ 動作：`appflow:DescribeConnectorProfiles` 和 ` arn:aws:appflow:*:*:connector-profile/*` 的 `appflow:UseConnectorProfile`
+ 動作：`appflow:DeleteFlow`、`appflow:DescribeFlow`、`appflow:DescribeFlowExecutionRecords`、`appflow:StartFlow`、`appflow:StopFlow` 和 `appflow:UpdateFlow` 在 ` arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-*` 使用 `StringEquals` 條件 `"aws:ResourceTag/AppIntegrationsManaged": "true"`。
+ 動作：`appflow:TagResource` 在 `arn:aws:appflow:*:*:flow/FlowCreatedByAppIntegrations-*` 使用 `ForAllValues:StringEquals aws:TagKeys` 條件 `AppIntegrationsManaged`。
您必須設定許可，IAM 實體 (如使用者、群組或角色) 才可建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱 *IAM 使用者指南*中的[服務連結角色許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions)。
## 建立 Amazon AppIntegrations 的服務連結角色
您不需要手動建立服務連結角色，當您使用 、 或 AWS API 中的 Connect AI 代理器、客戶設定檔或任務小工具建立資料 Amazon Connect AWS 管理主控台 AWS CLI或事件整合時，Amazon AppIntegrations 會為您建立服務連結角色。
**重要**
此服務連結角色可以顯示在您的帳戶，如果您於其他服務中完成一項動作時，可以使用支援此角色的功能。此外，2022 年 9 月 30 日開始支援服務連結角色，如果您在這之後建立任何新的 Amazon AppIntegrations 資源，則 Amazon AppIntegrations 會在您的帳戶中建立 AWSServiceRoleForAppIntegrations 角色。若要進一步了解，請參閱[我的 IAM 帳戶中出現的新角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared)。
若您刪除此服務連結角色，之後需要再次建立，您可以在帳戶中使用相同程序重新建立角色。當您使用 Amazon Connect 中的 Connect AI 代理器、客戶設定檔或任務小工具建立資料或事件整合時，Amazon AppIntegrations 會再次為您建立服務連結角色。
您也可以使用 IAM 主控台透過 **AppIntegrations** 使用案例以建立一個服務連結角色。在 AWS CLI 或 AWS API 中，使用服務名稱建立`app-integrations.amazonaws.com`服務連結角色。如需詳細資訊，請參閱《IAM 使用者指南》**中的「[建立服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role)」。如果您刪除此服務連結角色，您可以使用此相同的程序以再次建立該角色。
## 編輯 Amazon AppIntegrations 的服務連結角色
Amazon AppIntegrations 不允許您編輯 AWSServiceRoleForAppIntegrations 服務連結角色。因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。然而，您可使用 IAM 來編輯角色描述。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[編輯服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role)。
## 刪除 Amazon AppIntegrations 的服務連結角色
若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。然而，在手動刪除服務連結角色之前，您必須先清除資源。您必須先刪除 AWS 主控台中的資料和事件整合關聯，然後使用 刪除您的資料和事件整合 AWS CLI。
**注意**
若 Amazon AppIntegrations 服務在您試圖刪除資源時正在使用該角色，刪除可能會失敗。若此情況發生，請等待數分鐘後並再次嘗試操作。
**在 AWS 主控台中刪除 AWSServiceRoleForAppIntegrations 使用的資料整合關聯**
1. 前往 Amazon Connect 主控台的 Connect AI 代理程式區段，然後選擇您要刪除的資料整合關聯名稱。
1. 選擇 **整合詳細資料** 區段右側的 **刪除**。
1. 在彈出方塊中，輸入整合的名稱以確認，然後選擇**刪除**。
**使用 刪除 AWSServiceRoleForAppIntegrations 使用的資料整合 AWS CLI**
1. 列出您的資料整合，以檢視現有整合的名稱。
`aws appintegrations list-data-integrations`
1. 使用資料整合名稱刪除每個整合。
`aws appintegrations delete-data-integration --data-integration-identifier {{DATA_INTEGRATION_NAME}}`
**刪除 AWS 主控台中 AWSServiceRoleForAppIntegrations 使用的事件整合關聯**
1. 前往 Amazon Connect 主控台的 Customer Profiles 或 Tasks 部分，然後選擇要刪除的事件整合關聯名稱。
1. 在 Tasks 部分中選擇事件整合後，將出現一個彈出窗口。選擇 **移除連線** 按鈕，然後輸入 *remove* 一詞，即可刪除您的事件整合關聯。
**使用 刪除 AWSServiceRoleForAppIntegrations 所使用的事件整合 AWS CLI**
1. 列出您的事件整合，以檢視現有整合的名稱。
`aws appintegrations list-event-integrations`
1. 使用資料整合名稱刪除每個整合。
`aws appintegrations delete-event-integration --name {{EVENT_INTEGRATION_NAME}}`
**使用 IAM 手動刪除服務連結角色**
使用 IAM 主控台 AWS CLI、 或 AWS API 來刪除 AWSServiceRoleForAppIntegrations 服務連結角色。如需詳細資訊，請參閱《*IAM 使用者指南*》中的[刪除服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role)。
## Amazon AppIntegrations 服務連結角色的支援區域
Amazon AppIntegrations 在所有提供服務的區域中支援使用服務連結角色。如需詳細資訊，請參閱 [AWS 區域與端點](https://docs.aws.amazon.com/general/latest/gr/rande.html)。
您可以在下列區域使用 AWSServiceRoleForAppIntegrations 角色。
****
| 區域名稱 | 區域身分 | Amazon AppIntegrations 支援 |
| --- | --- | --- |
| 美國東部 (維吉尼亞北部) | us-east-1 | 是 |
| 美國西部 (奧勒岡) | us-west-2 | 是 |
| 亞太區域 (孟買) | ap-south-1 | 是 |
| 亞太區域 (首爾) | ap-northeast-2 | 是 |
| 亞太區域 (新加坡) | ap-southeast-1 | 是 |
| 亞太區域 (雪梨) | ap-southeast-2 | 是 |
| 亞太區域 (東京) | ap-northeast-1 | 是 |
| 加拿大 (中部) | ca-central-1 | 是 |
| 歐洲 (法蘭克福) | eu-central-1 | 是 |
| 歐洲 (倫敦) | eu-west-2 | 是 |
| Africa (Cape Town) | af-south-1 | 是 |