使用服務連結角色進行使用者訂閱 - Amazon Q Developer

使用服務連結角色進行使用者訂閱

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

服務連結角色可簡化使用者訂閱的設定,因為您不必手動新增必要的許可。使用者訂閱會定義其服務連結角色的許可,除非另有定義,否則僅有使用者訂閱可以擔任其角色。定義的許可包括信任政策和許可政策,且該許可政策無法附加至其他 IAM 實體。

您必須先刪除服務連結角色的相關資源,才能將其刪除。如此可保護您的使用者訂閱,避免您不小心移除資源所需的許可。

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

使用者訂閱的服務連結角色許可

使用者訂閱使用名為 AWSServiceRoleForUserSubscriptions 的服務連結角色。此角色可讓使用者訂閱存取您的 Identity Center 資源,以自動更新您的訂閱。

AWSServiceRoleForUserSubscriptions 服務連結角色信任下列服務來擔任該角色:

  • user-subscriptions.amazonaws.com

名為 AWSServiceRoleForUserSubscriptions 的角色許可政策允許使用者訂閱在指定的資源上完成下列動作:

  • 動作:* 上的 identitystore:DescribeGroup

    動作:* 上的 identitystore:DescribeUser

    動作:* 上的 identitystore:IsMemberInGroups

    動作:* 上的 identitystore:ListGroupMemberships

    動作:* 上的 organizations:DescribeOrganization

    動作:* 上的 sso:DescribeApplication

    動作:* 上的 sso:DescribeInstance

    動作:* 上的 sso:ListInstances

    動作:* 上的 sso-directory:DescribeUser

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

為使用者訂閱建立服務連結角色

您不需要手動建立一個服務連結角色。當您在 AWS Management Console 中建立使用者訂閱時,使用者訂閱會為您建立服務連結角色。

若您刪除此服務連結角色,之後需要再次建立,您可以在帳戶中使用相同程序重新建立角色。當您更新設定時,使用者訂閱會再次為您建立服務連結角色。

您也可以使用 IAM 主控台或 AWS CLI 來建立具有 q.amazonaws.com 服務名稱的服務連結角色。如需詳細資訊,請參閱《IAM 使用者指南》中的「建立服務連結角色」。如果您刪除此服務連結角色,您可以使用此相同的程序以再次建立該角色。

編輯使用者訂閱的服務連結角色

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

刪除使用者訂閱的服務連結角色

若您不再使用需要服務連結角色的功能或服務,我們建議您刪除該角色。如此一來,您就沒有未主動監控或維護的未使用實體。然而,在手動刪除服務連結角色之前,您必須先清除資源。

注意

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

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

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

使用者訂閱服務連結角色支援的區域

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

Amazon Q Developer 訂閱並未在提供服務的每個區域中支援使用服務連結角色。您可以在下列區域使用 AWSServiceRoleForUserSubscriptions 角色。

區域名稱 區域身分 使用者訂閱的支援
美國東部 (維吉尼亞北部) us-east-1
美國西部 (奧勒岡) us-west-2
美國東部 (維吉尼亞北部) us-east-1
美國東部 (俄亥俄) us-east-2
美國東部 (俄亥俄) us-east-2
美國西部 (加利佛尼亞北部) us-west-1
亞太區域 (孟買) ap-south-1
亞太區域 (大阪) ap-northeast-3
亞太區域 (首爾) ap-northeast-2
亞太區域 (新加坡) ap-southeast-1
亞太區域 (雪梨) ap-southeast-2
亞太區域 (東京) ap-northeast-1
加拿大 (中部) ca-central-1
歐洲 (法蘭克福) eu-central-1
歐洲 (愛爾蘭) eu-west-1
歐洲 (倫敦) eu-west-2
歐洲 (巴黎) eu-west-3
歐洲 (斯德哥爾摩) eu-north-1
南美洲 (聖保羅) sa-east-1