使用 Amazon 的服務連結角色 AppIntegrations - Amazon Connect
Amazon 的服務連結角色許可 AppIntegrations為 Amazon 建立服務連結角色 AppIntegrations編輯 Amazon 的服務連結角色 AppIntegrations刪除 Amazon 的服務連結角色 AppIntegrationsAmazon AppIntegrations 服務連結角色的支援區域

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Amazon 的服務連結角色 AppIntegrations

Amazon AppIntegrations 使用 AWS Identity and Access Management （IAM） 服務連結角色 。服務連結角色是直接連結至 Amazon 的唯一IAM角色類型 AppIntegrations。服務連結角色由 Amazon 預先定義， AppIntegrations 並包含服務 AWS 代表您呼叫其他服務所需的所有許可。

服務連結角色可讓您 AppIntegrations 更輕鬆地設定 Amazon，因為您不必手動新增必要的許可。Amazon 會 AppIntegrations 定義其服務連結角色的許可，除非另有定義，否則只有 Amazon AppIntegrations 可以擔任其角色。定義的許可包括信任政策和許可政策，該許可政策無法連接到任何其他IAM實體。

您必須先刪除服務連結角色的相關資源，才能將其刪除。這可保護您的 Amazon AppIntegrations 資源，因為您不會不小心移除存取資源的許可。

如需有關支援服務連結角色的其他 服務的資訊，請參閱服務連結角色欄中AWS 使用的服務IAM，並尋找具有 Yes 的服務。選擇具有連結的是，以檢視該服務的服務連結角色文件。

Amazon 的服務連結角色許可 AppIntegrations

Amazon AppIntegrations 使用名為 的服務連結角色AWSServiceRoleForAppIntegrations， AppIntegrations 允許 代表您存取AWS服務和資源。

AWSServiceRoleForAppIntegrations 服務連結角色信任下列服務擔任該角色：

  • app-integrations.amazonaws.com

名為 的角色許可政策 AppIntegrationsServiceLinkedRolePolicy 允許 Amazon 對指定的資源 AppIntegrations 完成下列動作：


     {
    "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 使用者指南 中的服務連結角色許可。

為 Amazon 建立服務連結角色 AppIntegrations

您不需要手動建立一個服務連結角色。當您使用 中的 Amazon Q in Connect、客戶設定檔或 Amazon Connect 中的任務小工具建立資料 AWS CLI或事件整合時 AWS API，Amazon AWS Management Console AppIntegrations 會為您建立服務連結角色。

重要

此服務連結角色可以顯示在您的帳戶，如果您於其他服務中完成一項動作時，可以使用支援此角色的功能。此外，如果您在 2022 年 9 月 30 日之後建立新的 Amazon AppIntegrations 資源，當它開始支援服務連結角色時，Amazon 就會在帳戶中 AppIntegrations 建立 AWSServiceRoleForAppIntegrations 角色。若要進一步了解，請參閱我的IAM帳戶 中出現的新角色。

若您刪除此服務連結角色，之後需要再次建立，您可以在帳戶中使用相同程序重新建立角色。當您使用 Amazon Q in Connect、客戶設定檔或 Amazon Connect 中的任務小工具建立資料或事件整合時，Amazon 會再次為您 AppIntegrations 建立服務連結角色。

您也可以使用 IAM 主控台來建立服務連結角色與AppIntegrations使用案例。在 AWS CLI 或 中 AWS API，使用服務名稱建立app-integrations.amazonaws.com服務連結角色。如需詳細資訊，請參閱 IAM 使用者指南 中的建立服務連結角色。如果您刪除此服務連結角色，您可以使用此相同的程序以再次建立該角色。

編輯 Amazon 的服務連結角色 AppIntegrations

Amazon AppIntegrations 不允許您編輯 AWSServiceRoleForAppIntegrations 服務連結角色。因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。不過，您可以使用 編輯角色的描述IAM。如需詳細資訊，請參閱 IAM 使用者指南 中的編輯服務連結角色。

刪除 Amazon 的服務連結角色 AppIntegrations

若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。然而，在手動刪除服務連結角色之前，您必須先清除資源。您必須先刪除 AWS 主控台中的資料和事件整合關聯，然後使用 刪除資料和事件整合 AWS CLI。

注意

如果嘗試刪除資源時 Amazon AppIntegrations 服務正在使用角色，則刪除可能會失敗。若此情況發生，請等待數分鐘後並再次嘗試操作。

刪除 AWS 主控台 AWSServiceRoleForAppIntegrations 中使用的資料整合關聯

  1. 前往 Amazon Connect 主控台的 Amazon Q in Connect 部分，然後選擇要刪除的資料整合關聯名稱。

  2. 選擇 整合詳細資料 區段右側的 刪除。

  3. 在彈出方塊中，輸入整合的名稱以確認，然後選擇刪除。

AWSServiceRoleForAppIntegrations 使用 刪除 使用的資料整合 AWS CLI

  1. 列出您的資料整合，以檢視現有整合的名稱。

    aws appintegrations list-data-integrations

  2. 使用資料整合名稱刪除每個整合。

    aws appintegrations delete-data-integration --data-integration-identifier DATA_INTEGRATION_NAME

在 AWS 主控台 AWSServiceRoleForAppIntegrations 中刪除 使用的事件整合關聯

  1. 前往 Amazon Connect 主控台的 Customer Profiles 或 Tasks 部分，然後選擇要刪除的事件整合關聯名稱。

  2. 在 Tasks 部分中選擇事件整合後，將出現一個彈出窗口。選擇 移除連線 按鈕，然後輸入 remove 一詞，即可刪除您的事件整合關聯。

AWSServiceRoleForAppIntegrations 使用 刪除 使用的事件整合 AWS CLI

  1. 列出您的事件整合，以檢視現有整合的名稱。

    aws appintegrations list-event-integrations

  2. 使用資料整合名稱刪除每個整合。

    aws appintegrations delete-event-integration --name EVENT_INTEGRATION_NAME

使用 手動刪除服務連結角色 IAM

使用IAM主控台 AWS CLI、 或 AWS API刪除 AWSServiceRoleForAppIntegrations服務連結角色。如需詳細資訊，請參閱 IAM 使用者指南 中的刪除服務連結角色。

Amazon AppIntegrations 服務連結角色的支援區域

Amazon AppIntegrations 支援在所有提供服務的區域中使用服務連結角色。如需詳細資訊，請參閱 AWS 區域與端點。

您可以在下列區域中使用 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 是
非洲 (開普敦) af-south-1 是