Utilisation service-linked-roles pour les abonnements des utilisateurs - Développeur Amazon Q

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation service-linked-roles pour les abonnements des utilisateurs

Les abonnements utilisateurs utilisent des AWS Identity and Access Management rôles liés à un service (IAM). Un rôle lié à un service est un type unique de rôle IAM directement lié aux abonnements des utilisateurs. Les rôles liés au service sont prédéfinis par les abonnements des utilisateurs et incluent toutes les autorisations dont le service a besoin pour appeler d'autres AWS services en votre nom.

Un rôle lié à un service facilite la configuration des abonnements utilisateur, car vous n'avez pas à ajouter manuellement les autorisations nécessaires. Les abonnements utilisateur définissent les autorisations associées à ses rôles liés aux services et, sauf indication contraire, seuls les abonnements utilisateurs peuvent assumer ses rôles. Les autorisations définies comprennent la politique d’approbation et la politique d’autorisation. De plus, cette politique d’autorisation ne peut pas être attachée à une autre entité IAM.

Vous pouvez supprimer un rôle lié à un service uniquement après la suppression préalable de ses ressources connexes. Cela protège vos abonnements utilisateur, car vous ne pouvez pas supprimer par inadvertance les autorisations requises par les ressources.

Pour plus d’informations sur les autres services prenant en charge les rôles liés à un service, consultez les AWS services opérationnels avec IAM et recherchez les services présentant la mention Yes (Oui) dans la colonne Service-linked roles (Rôles liés à un service). Sélectionnez un Oui ayant un lien pour consulter la documentation du rôle lié à un service, pour ce service.

Autorisations de rôle liées au service pour les abonnements d'utilisateurs

Les abonnements utilisateurs utilisent le rôle lié au service nommé AWSServiceRoleForUserSubscriptions— Permet aux utilisateurs d'accéder aux ressources de votre centre d'identité IAM afin de mettre à jour automatiquement vos abonnements.

Le rôle AWSServiceRoleForUserSubscriptions lié à un service fait confiance aux services suivants pour assumer le rôle :

  • user-subscriptions.amazonaws.com

La politique d'autorisation de rôle nommée AWSServiceRoleForUserSubscriptionPolicy permet aux abonnements utilisateurs d'effectuer les actions suivantes sur les ressources spécifiées :

  • Action : identitystore:DescribeGroup sur *

    Action : identitystore:DescribeUser sur *

    Action : identitystore:IsMemberInGroups sur *

    Action : identitystore:ListGroupMemberships sur *

    Action : organizations:DescribeOrganization sur *

    Action : sso:DescribeApplication sur *

    Action : sso:DescribeInstance sur *

    Action : sso:ListInstances sur *

Vous devez configurer les autorisations de manière à permettre à vos utilisateurs, groupes ou rôles de créer, modifier ou supprimer un rôle lié à un service. Pour plus d’informations, consultez Autorisations de rôles liés à un service dans le Guide de l’utilisateur IAM.

Création d'un rôle lié à un service pour les abonnements d'utilisateurs

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Lorsque vous créez un abonnement utilisateur dans le AWS Management Console, User Subscriptions crée pour vous le rôle lié au service.

Si vous supprimez ce rôle lié à un service et que vous avez ensuite besoin de le recréer, vous pouvez utiliser la même procédure pour recréer le rôle dans votre compte. Lorsque vous mettez à jour les paramètres, User Subscriptions crée à nouveau le rôle lié au service pour vous.

Vous pouvez également utiliser la console IAM ou l'interface de ligne de commande AWS pour créer un rôle lié à un service avec le nom du q.amazonaws.com service. Pour plus d’informations, consultez Création d’un rôle lié à un service dans le Guide de l’utilisateur IAM. Si vous supprimez ce rôle lié à un service, vous pouvez utiliser ce même processus pour créer le rôle à nouveau.

Modification d'un rôle lié à un service pour les abonnements d'utilisateurs

Les abonnements utilisateur ne vous permettent pas de modifier le rôle AWSServiceRoleForUserSubscriptions lié au service. Une fois que vous avez créé un rôle lié à un service, vous ne pouvez pas changer le nom du rôle, car plusieurs entités peuvent faire référence à ce rôle. Néanmoins, vous pouvez modifier la description du rôle à l’aide d’IAM. Pour plus d’informations, consultez Modification d’un rôle lié à un service dans le guide de l’utilisateur IAM.

Suppression d'un rôle lié à un service pour les abonnements d'utilisateurs

Si vous n’avez plus besoin d’utiliser une fonctionnalité ou un service qui nécessite un rôle lié à un service, nous vous recommandons de supprimer ce rôle. De cette façon, vous n’avez aucune entité inutilisée qui n’est pas surveillée ou gérée activement. Cependant, vous devez nettoyer les ressources de votre rôle lié à un service avant de pouvoir les supprimer manuellement.

Note

Si le service User Subscriptions utilise le rôle lorsque vous essayez de supprimer les ressources, la suppression risque d'échouer. Si cela se produit, patientez quelques minutes et réessayez.

Pour supprimer manuellement le rôle lié à un service à l’aide d’IAM

Utilisez la console IAM, le AWS CLI, ou l' AWS API pour supprimer le rôle lié au AWSServiceRoleForUserSubscriptions service. Pour plus d’informations, consultez Suppression d’un rôle lié à un service dans le Guide de l’utilisateur IAM.

Régions prises en charge pour les abonnements d'utilisateurs (rôles liés au service)

Amazon Q Developer Subscriptions prend en charge l'utilisation de rôles liés au service dans toutes les régions où le service est disponible. Pour de plus amples informations, veuillez consulter AWS Régions et points de terminaison.

Amazon Q Developer Subscriptions ne prend pas en charge l'utilisation de rôles liés à un service dans toutes les régions où le service est disponible. Vous pouvez utiliser le AWSServiceRoleForUserSubscriptions rôle dans les régions suivantes.

Nom de la région Identité de la région Support pour les abonnements des utilisateurs
US East (Virginie du Nord) us-east-1 Oui
USA Ouest (Oregon) us-west-2 Oui
US East (Virginie du Nord) us-east-1 Oui
USA Est (Ohio) us-east-2 Oui
USA Est (Ohio) us-east-2 Oui
USA Ouest (Californie du Nord) us-west-1 Oui
Asie-Pacifique (Mumbai) ap-south-1 Oui
Asie-Pacifique (Osaka) ap-northeast-3 Oui
Asie-Pacifique (Séoul) ap-northeast-2 Oui
Asie-Pacifique (Singapour) ap-southeast-1 Oui
Asie-Pacifique (Sydney) ap-southeast-2 Oui
Asie-Pacifique (Tokyo) ap-northeast-1 Oui
Canada (Centre) ca-central-1 Oui
Europe (Francfort) eu-central-1 Oui
Europe (Irlande) eu-west-1 Oui
Europe (Londres) eu-west-2 Oui
Europe (Paris) eu-west-3 Oui
Europe (Stockholm) eu-north-1 Oui
Amérique du Sud (São Paulo) sa-east-1 Oui