Utilisation de rôles liés à un service pour Amazon Managed Grafana

Amazon Managed Grafana utilise des rôles liés à un AWS Identity and Access Management service (IAM). Un rôle lié à un service est un type unique de rôle IAM directement lié à Amazon Managed Grafana. Les rôles liés à un service sont prédéfinis par Amazon Managed Grafana et incluent toutes les autorisations requises par le service pour appeler d'autres AWS services en votre nom.

Un rôle lié à un service facilite la configuration d'Amazon Managed Grafana, car vous n'avez pas à ajouter manuellement les autorisations nécessaires. Amazon Managed Grafana définit les autorisations associées à ses rôles liés aux services et, sauf indication contraire, seul Amazon Managed Grafana peut 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 ressources Amazon Managed Grafana, car vous ne pouvez pas supprimer par inadvertance l'autorisation d'accès aux ressources.

Pour plus d'informations sur les autres services prenant en charge les rôles liés à un service, consultez Services AWS qui fonctionnent 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 à un service pour Amazon Managed Grafana

Amazon Managed Grafana utilise le rôle lié au service nommé. AmazonManagedGrafanaAmazon Managed Grafana utilise ce rôle pour créer et configurer des ressources, telles que des ENI ou des secrets de Secrets Manager, dans les comptes clients. Le rôle AmazonManagedGrafana lié à un service fait confiance aux services suivants pour assumer le rôle :

• grafana.amazonaws.com

Le rôle AmazonManagedGrafana lié au service est rattaché à la AmazonGrafanaServiceLinkedRolePolicy politique. Pour connaître les mises à jour de cette politique, consultez Amazon Managed Grafana met à jour les AWS politiques gérées.

La politique d'autorisation des rôles permet à Amazon Managed Grafana d'effectuer les actions suivantes sur les ressources spécifiées.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ec2:DescribeNetworkInterfaces",
                "ec2:DescribeVpcs",
                "ec2:DescribeDhcpOptions",
                "ec2:DescribeSubnets",
                "ec2:DescribeSecurityGroups"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "ec2:CreateNetworkInterface",
            "Resource": "*",
            "Condition": {
                "ForAllValues:StringEquals": {
                    "aws:TagKeys": [
                        "AmazonGrafanaManaged"
                    ]
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "ec2:CreateTags",
            "Resource": "arn:aws:ec2:*:*:network-interface/*",
                "Condition": {
                    "StringEquals": {
                    "ec2:CreateAction": "CreateNetworkInterface"
                },
                "Null": {
                    "aws:RequestTag/AmazonGrafanaManaged": "false"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "ec2:DeleteNetworkInterface",
            "Resource": "*",
            "Condition": {
                "Null": {
                    "ec2:ResourceTag/AmazonGrafanaManaged": "false"
                }
            }
        }
    ]
} 

Vous devez configurer les autorisations de manière à permettre à une entité IAM (comme un utilisateur, un groupe ou un rôle) 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 Amazon Managed Grafana

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Lorsque vous appelez VpcConfiguration à l' CreateWorkspace aide d'une API AWS Management Console, d'une API ou d'une AWS API, Amazon Managed Grafana crée pour vous le rôle lié au service. AWS CLI

Important

Ce rôle lié à un service peut apparaître dans votre compte si vous avez effectué une action dans un autre service qui utilise les fonctions prises en charge par ce rôle. De plus, si vous utilisiez le service Amazon Managed Grafana avant le 30 novembre 2022, date à laquelle il a commencé à prendre en charge les rôles liés au service, Amazon Managed Grafana a créé le rôle dans votre compte. AmazonManagedGrafana Pour en savoir plus, consultez Un nouveau rôle est apparu dans mon compte IAM.

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 appelez CreateWorkspace avec un VpcConfiguration, Amazon Managed Grafana crée à nouveau le rôle lié au service pour vous.

Vous pouvez également utiliser la console IAM pour créer un rôle lié à un service avec le cas d'utilisation de Grafana. Dans l'API AWS CLI ou dans l' AWS API, créez un rôle lié à un service avec le nom du grafana.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 Amazon Managed Grafana

Amazon Managed Grafana ne vous permet pas de modifier le rôle lié au AmazonManagedGrafana 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 Amazon Managed Grafana

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 Amazon Managed Grafana 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 les ressources Amazon Managed Grafana utilisées par AmazonManagedGrafana

1. Accédez à la vue Tous les espaces de travail Region dans la AWS console.

2. Supprimez tous les espaces de travail duRegion. Vous devez cocher le bouton radio de chaque espace de travail et choisir le bouton Supprimer dans le coin supérieur droit de la vue Tous les espaces de travail. Répétez la suppression de chaque espace de travail jusqu'à ce que tous les espaces de travail soient supprimés duRegion. Pour plus d'informations sur la suppression d'un espace de travail dans Amazon Managed Grafana, consultez la rubrique Suppression d'un espace de travail dans ce guide de l'utilisateur.

Note

Répétez la procédure pour chaque Région AWS endroit où vous disposez d'espaces de travail. Vous devez supprimer tous les espaces de travail dans toutes les régions avant de pouvoir supprimer le rôle lié à un service.

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 AmazonManagedGrafana 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 rôles liés au service Amazon Managed Grafana

Amazon Managed Grafana prend en charge l'utilisation de rôles liés au service dans toutes les régions où le service est disponible. Pour plus d'informations, consultez Régions et points de terminaison AWS.