針 AWS CodeStar 對通知使用服務連結角色 - 開發人員工具主控台
通知的 AWS CodeStar 服務連結角色權限建立通知的 AWS CodeStar 服務連結角色編輯通知的服務連結角色 AWS CodeStar 刪除通知的服務連結角色 AWS CodeStar AWS CodeStar 通知服務連結角色的支援區域

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

針 AWS CodeStar 對通知使用服務連結角色

AWS CodeStar 通知使用 AWS Identity and Access Management (IAM) 服務連結角色。服務連結角色是直接連結至 AWS CodeStar 通知的唯一 IAM 角色類型。服務連結角色由 AWS CodeStar Avents 預先定義，並包含服務代表您呼叫其他服 AWS 務所需的所有權限。此角色是您第一次建立通知規則時為您建立的。您不必建立角色。

服務連結角色可讓您輕鬆設定「 AWS CodeStar 通知」，因為您不需要手動新增權限。 AWS CodeStar 通知會定義其服務連結角色的權限，除非另有定義，否則只有「 AWS CodeStar 通知」可以擔任其角色。定義的許可包括信任政策和許可政策，且該許可政策無法附加至其他 IAM 實體。

若要刪除服務連結角色，您必須先刪除其相關資源。這樣可以保護您的「 AWS CodeStar 通知」資源，因為您無法意外移除存取資源的權限。

關於支援服務連結角色的其他服務，如需相關資訊，請參閱與 IAM 搭配運作的AWS 服務。

通知的 AWS CodeStar 服務連結角色權限

AWS CodeStar 通知會使用 AWSServiceRoleForCodeStarNotifications 服務連結角色來擷取工具鏈中發生之事件的相關資訊，並將通知傳送至您指定的目標。

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

  • codestar-notifications.amazonaws.com

角色權限原則允許「 AWS CodeStar 通知」在指定資源上完成下列動作：

  • 動作：CloudWatch Event rules that are named awscodestar-notifications-* 上的 PutRule

  • 動作：CloudWatch Event rules that are named awscodestar-notifications-* 上的 DescribeRule

  • 動作：CloudWatch Event rules that are named awscodestar-notifications-* 上的 PutTargets

  • 動作：CreateTopic 至 create Amazon SNS topics for use with AWS CodeStar Notifications with the prefix CodeStarNotifications-

  • 動作：all comments on all pull requests in all CodeCommit repositories in the AWS account 上的 GetCommentsForPullRequests

  • 動作：all comments on all commits in all CodeCommit repositories in the AWS account 上的 GetCommentsForComparedCommit

  • 動作：all commits in all CodeCommit repositories in the AWS account 上的 GetDifferences

  • 動作：all comments on all commits in all CodeCommit repositories in the AWS account 上的 GetCommentsForComparedCommit

  • 動作：all commits in all CodeCommit repositories in the AWS account 上的 GetDifferences

  • 動作：all AWS Chatbot clients in the AWS account 上的 DescribeSlackChannelConfigurations

  • 動作：all AWS Chatbot clients in the AWS account 上的 UpdateSlackChannelConfiguration

  • 動作：all actions in all pipelines in the AWS account 上的 ListActionExecutions

  • 動作：all files in all CodeCommit repositories in the AWS account unless otherwise tagged 上的 GetFile

您可以在 AWSServiceRoleForCodeStarNotifications 服務連結角色的政策聲明中看到這些動作。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "events:PutTargets",
                "events:PutRule",
                "events:DescribeRule"
            ],
            "Resource": "arn:aws:events:*:*:rule/awscodestarnotifications-*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "sns:CreateTopic"
            ],
            "Resource": "arn:aws:sns:*:*:CodeStarNotifications-*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "codecommit:GetCommentsForPullRequest",
                "codecommit:GetCommentsForComparedCommit",
                "codecommit:GetDifferences",
                "chatbot:DescribeSlackChannelConfigurations",
                "chatbot:UpdateSlackChannelConfiguration",
                "codepipeline:ListActionExecutions"
            ],
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "codecommit:GetFile"
            ],
            "Resource": "*",
            "Condition": {
                "StringNotEquals": {
                    "aws:ResourceTag/ExcludeFileContentFromNotifications": "true"
                }
            },
            "Effect": "Allow"
        }
    ]
}

您必須設定許可，IAM 實體 (如使用者、群組或角色) 才可建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱《IAM 使用者指南》中的服務連結角色許可。

建立通知的 AWS CodeStar 服務連結角色

您不需要手動建立一個服務連結角色。您可以使用開發人員工具主控台或 AWS CLI 或 SDK 中的 CreateNotificationRule API 來建立通知規則。您也可以直接呼叫 API。無論您使用哪一種方法，系統都會為您建立服務連結角色。

若您刪除此服務連結角色，之後需要再次建立，您可以在帳戶中使用相同程序重新建立角色。您可以使用開發人員工具主控台或 AWS CLI 或 SDK 中的 CreateNotificationRule API 來建立通知規則。您也可以直接呼叫 API。無論您使用哪一種方法，系統都會為您建立服務連結角色。

編輯通知的服務連結角色 AWS CodeStar

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

刪除通知的服務連結角色 AWS CodeStar

若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。刪除服務連結角色之前，您必須先清理資源。對於「 AWS CodeStar 通知」，這表示刪除 AWS 帳戶中使用服務角色的所有通知規則。

注意

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

若要刪除使用的「 AWS CodeStar 通知」資源 AWSServiceRoleForCodeStarNotifications

  1. 開啟開發 AWS 人員工具主控台，網址為 https://console.aws.amazon.com/codesuite/settings/notifications。

    注意

    通知規則會套用至建立規則的「 AWS 區域」。如果您在多個「 AWS 區域」中有通知規則，請使用「地區」選取器來變更 AWS 區域。

  2. 選擇清單中出現的所有通知規則，然後選擇 Delete (刪除)。

  3. 在您建立通知規則的所有 AWS 區域中重複這些步驟。

使用 IAM 來刪除服務連結角色

使用 IAM 主控 AWS CLI台或 AWS Identity and Access Management API 刪除 AWSServiceRoleForCodeStarNotifications 服務連結角色。如需詳細資訊，請參閱《IAM 使用者指南》中的刪除服務連結角色。

AWS CodeStar 通知服務連結角色的支援區域

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