使用角色為 API 目的地建立密碼 - Amazon EventBridge
服務連結角色許可建立服務連結角色編輯服務連結角色刪除服務連結角色支援地區

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

使用角色為 API 目的地建立密碼

Amazon EventBridge 使用 AWS Identity and Access Management (IAM) 服務連結的角色。服務連結角色是直接連結至 EventBridge 的一種特殊 IAM 角色類型。服務連結角色由 EventBridge 預先定義，且內含該服務代您呼叫其他 AWS 服務所需的所有許可。

服務連結的角色可讓設定 EventBridge 更為簡單，因為您不必手動新增必要的許可。EventBridge​ 定義其服務連結角色的許可，除非另有定義，否則僅有 EventBridge 可以擔任其角色。定義的許可包括信任政策和許可政策，且該許可政策無法附加至其他 IAM 實體。

您必須先刪除服務連結角色的相關資源，才能將其刪除。如此可保護您 EventBridge 的資源，避免您不小心移除資源的存取許可。

如需關於支援服務連結角色的其他服務資訊，請參閱《可搭配 IAM 運作的 AWS 服務》，尋找 Service-linked roles (服務連結角色) 欄中顯示為 Yes (是) 的服務。選擇具有連結的是，以檢視該服務的服務連結角色文件。

EventBridge 的服務連結角色許可

EventBridge使用名為的服務連結角色 AWSServiceRoleForAmazonEventBridgeApiDestinations— 允許存取由EventBridge建立的 Secret 管理員密碼。

AWSServiceRoleForAmazonEventBridgeApiDestinations 服務連結角色信任下列服務以擔任角色：

  • apidestinations.events.amazonaws.com

名為 Policy 的角色權限AmazonEventBridgeApiDestinationsServiceRole原則EventBridge允許對指定的資源完成下列動作：

  • 動作：secrets created for all connections by EventBridge 上的 create, describe, update and delete secrets; get and put secret values

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

為 EventBridge 建立服務連結角色

您不需要手動建立一個服務連結角色。當您在AWS Management Console、或 AWS API 中建EventBridge立連線時AWS CLI，會為您建立服務連結角色。

重要

此服務連結角色可以顯示在您的帳戶，如果您於其他服務中完成一項動作時，可以使用支援此角色的功能。如果您在 2021 年 2 月 11 日之前使用EventBridge服務，則該服務開始支援服務連結角色時，請在您的帳戶中EventBridge建立該AWSServiceRoleForAmazonEventBridgeApiDestinations角色。若要進一步了解，請參閱在我的 AWS 帳戶 中顯示新角色。

若您刪除此服務連結角色然後需要再次建立，便可在帳戶中使用相同程序重新建立角色。建立連線時，請再次為您建EventBridge立服務連結角色。

為 EventBridge 編輯服務連結角色

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

為 EventBridge 刪除服務連結角色

若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。然而，務必清除您的服務連結角色，之後才能以手動方式將其刪除。

清除服務連結角色

在您使用 IAM 刪除服務連結角色之前，您必須先刪除該角色所使用的任何資源。

注意

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

刪除 AWSServiceRoleForAmazonEventBridgeApiDestinations 所使用的 EventBridge 資源 (主控台)

  1. 在以下位置打開 Amazon EventBridge 控制台 https://console.aws.amazon.com/events/。

  2. 在「整合」下選擇「API 目標」，然後選擇「連線」標籤。

  3. 選擇連線，然後選擇「刪除」。

刪除 AWSServiceRoleForAmazonEventBridgeApiDestinations 所使用的 EventBridge 資源 (AWS CLI)
刪除 AWSServiceRoleForAmazonEventBridgeApiDestinations 所使用的 EventBridge 資源 (API)

手動刪除服務連結角色

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

EventBridge 服務連結角色的支援區域

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