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 de rôles liés à un service pour Amazon Timestream pour InfluxDB
Amazon Timestream pour InfluxDB utilise () des rôles liés AWS Identity and Access Management à un service. IAM Un rôle lié à un service est un type unique de IAM rôle directement lié à un AWS service, tel qu'Amazon Timestream pour InfluxDB. Les rôles liés au service Amazon Timestream pour InfluxDB sont prédéfinis par Amazon Timestream pour InfluxDB. Elles incluent toutes les autorisations dont le service a besoin pour appeler des AWS services au nom de vos instances de base de données.
Un rôle lié à un service facilite la configuration d'Amazon Timestream pour InfluxDB, car vous n'avez pas à ajouter manuellement les autorisations nécessaires. Les rôles existent déjà dans votre AWS compte mais sont liés à Amazon Timestream pour les cas d'utilisation d'InfluxDB et disposent d'autorisations prédéfinies. Seul Amazon Timestream pour InfluxDB peut assumer ces rôles, et seuls ces rôles peuvent utiliser la politique d'autorisation prédéfinie. Vous pouvez supprimer les rôles uniquement après la suppression préalable de leurs ressources connexes. Cela protège votre Amazon Timestream pour les ressources InfluxDB, car vous ne pouvez pas supprimer par inadvertance les autorisations nécessaires pour accéder aux ressources.
Pour plus d'informations sur les autres services qui prennent en charge les rôles liés à un service, consultez la section AWS Services compatibles avec IAM et recherchez les services dont la valeur est Oui dans la colonne Rôle lié au service. Choisissez un Oui ayant un lien permettant de consulter les détails du rôle pour ce service.
Table des matières
Autorisations de rôle liées à un service pour Amazon Timestream pour InfluxDB
Amazon Timestream for InfluxDB utilise le rôle lié à un service AmazonTimestreamInfluxDBServiceRolePolicynommé — Cette politique permet à Timestream for InfluxDB de gérer les ressources en votre nom selon les besoins de la gestion de AWS vos clusters.
La politique d'autorisation des rôles AmazonTimestreamInflux DBServiceRolePolicy liés au service permet à Amazon Timestream pour InfluxDB d'effectuer les actions suivantes sur les ressources spécifiées :
{ "Version": "2012-10-17", "Statement": [ { "Sid": "DescribeNetworkStatement", "Effect": "Allow", "Action": [ "ec2:DescribeSubnets", "ec2:DescribeVpcs", "ec2:DescribeNetworkInterfaces" ], "Resource": "*" }, { "Sid": "CreateEniInSubnetStatement", "Effect": "Allow", "Action": [ "ec2:CreateNetworkInterface" ], "Resource": [ "arn:aws:ec2:*:*:subnet/*", "arn:aws:ec2:*:*:security-group/*" ] }, { "Sid": "CreateEniStatement", "Effect": "Allow", "Action": [ "ec2:CreateNetworkInterface" ], "Resource": "arn:aws:ec2:*:*:network-interface/*", "Condition": { "Null": { "aws:RequestTag/AmazonTimestreamInfluxDBManaged": "false" } } }, { "Sid": "CreateTagWithEniStatement", "Effect": "Allow", "Action": [ "ec2:CreateTags" ], "Resource": "arn:aws:ec2:*:*:network-interface/*", "Condition": { "Null": { "aws:RequestTag/AmazonTimestreamInfluxDBManaged": "false" }, "StringEquals": { "ec2:CreateAction": [ "CreateNetworkInterface" ] } } }, { "Sid": "ManageEniStatement", "Effect": "Allow", "Action": [ "ec2:CreateNetworkInterfacePermission", "ec2:DeleteNetworkInterface" ], "Resource": "arn:aws:ec2:*:*:network-interface/*", "Condition": { "Null": { "aws:ResourceTag/AmazonTimestreamInfluxDBManaged": "false" } } }, { "Sid": "PutCloudWatchMetricsStatement", "Effect": "Allow", "Action": [ "cloudwatch:PutMetricData" ], "Condition": { "StringEquals": { "cloudwatch:namespace": [ "AWS/Timestream/InfluxDB", "AWS/Usage" ] } }, "Resource": [ "*" ] }, { "Sid": "ManageSecretStatement", "Effect": "Allow", "Action": [ "secretsmanager:CreateSecret", "secretsmanager:DeleteSecret" ], "Resource": [ "arn:aws:secretsmanager:*:*:secret:READONLY-InfluxDB-auth-parameters-*" ], "Condition": { "StringEquals": { "aws:ResourceAccount": "${aws:PrincipalAccount}" } } } ] }
Pour autoriser une IAM entité à créer des rôles liés à un AmazonTimestreamInflux DBServiceRolePolicy service
Ajoutez la déclaration de politique suivante aux autorisations pour cette IAM entité :
{ "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole", "iam:PutRolePolicy" ], "Resource": "arn:aws:iam::*:role/aws-service-role/timestreamforinfluxdb.amazonaws.com/AmazonTimestreamInfluxDBServiceRolePolicy*", "Condition": {"StringLike": {"iam:AWS ServiceName": "timestreamforinfluxdb.amazonaws.com"}} }
Pour autoriser une IAM entité à supprimer des rôles liés à un AmazonTimestreamInflux DBServiceRolePolicy service
Ajoutez la déclaration de politique suivante aux autorisations pour cette IAM entité :
{ "Effect": "Allow", "Action": [ "iam:DeleteServiceLinkedRole", "iam:GetServiceLinkedRoleDeletionStatus" ], "Resource": "arn:aws:iam::*:role/aws-service-role/timestreamforinfluxdb.amazonaws.com/AmazonTimestreamInfluxDBServiceRolePolicy*", "Condition": {"StringLike": {"iam:AWS ServiceName": "timestreamforinfluxdb.amazonaws.com"}} }
Vous pouvez également utiliser une politique AWS gérée pour fournir un accès complet à Amazon Timestream pour InfluxDB.
Création d'un rôle lié à un service () IAM
Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Lorsque vous créez une instance de base de données, Amazon Timestream pour InfluxDB crée le rôle lié au service pour vous.
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 créez une instance de base de données, Amazon Timestream pour InfluxDB crée à nouveau le rôle lié au service pour vous.
Modification de la description d'un rôle lié à un service pour Amazon Timestream pour InfluxDB
Amazon Timestream pour InfluxDB ne vous permet pas de modifier le rôle lié au service. AmazonTimestreamInflux DBServiceRolePolicy 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. Vous pouvez toutefois modifier la description du rôle à l'aide deIAM.
Modification de la description d'un rôle lié à un service (console) IAM
Vous pouvez utiliser la IAM console pour modifier la description d'un rôle lié à un service.
Pour modifier la description d'un rôle lié à un service (console)
-
Dans le volet de navigation gauche de la IAM console, sélectionnez Rôles.
-
Choisissez le nom du rôle à modifier.
-
A l'extrême droite de Description du rôle, choisissez Edit (Modifier).
-
Saisissez une nouvelle description dans la zone et choisissez Save (Enregistrer).
Modification de la description d'un rôle lié à un service () IAM CLI
Vous pouvez utiliser IAM les opérations du AWS Command Line Interface pour modifier la description d'un rôle lié à un service.
Pour modifier la description d'un rôle lié à un service () CLI
-
(Facultatif) Pour afficher la description actuelle d'un rôle, utilisez l'IAMopération AWS CLI for
get-role
.$
aws iam get-role --role-name AmazonTimestreamInfluxDBServiceRolePolicy
Utilisez le nom du rôle, et non leARN, pour faire référence aux rôles associés aux CLI opérations. Par exemple, si un rôle présente les caractéristiques suivantes ARN :
arn:aws:iam::123456789012:role/myrole
, faites référence au rôle en tant quemyrole
. -
Pour mettre à jour la description d'un rôle lié à un service, utilisez l'opération AWS CLI forIAM.
update-role-description
Linux et macOS
$
aws iam update-role-description \ --role-name AmazonTimestreamInfluxDBServiceRolePolicy \ --description "
new description
"Windows
$
aws iam update-role-description ^ --role-name AmazonTimestreamInfluxDBServiceRolePolicy ^ --description "
new description
"
Modification de la description d'un rôle lié à un service () IAM API
Vous pouvez utiliser le IAM API pour modifier la description d'un rôle lié à un service.
Pour modifier la description d'un rôle lié à un service () API
-
(Facultatif) Pour afficher la description actuelle d'un rôle, utilisez l'IAMAPIopération GetRole.
https://iam.amazonaws.com/ ?Action=GetRole &RoleName=AmazonTimestreamInfluxDBServiceRolePolicy &Version=2010-05-08 &AUTHPARAMS
-
Pour mettre à jour la description d'un rôle, utilisez l'IAMAPIopération UpdateRoleDescription.
https://iam.amazonaws.com/ ?Action=UpdateRoleDescription &RoleName=AmazonTimestreamInfluxDBServiceRolePolicy &Version=2010-05-08 &Description="
New description
"
Supprimer un rôle lié à un service pour Amazon Timestream pour InfluxDB
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 votre rôle lié à un service avant de pouvoir le supprimer.
Amazon Timestream pour InfluxDB ne supprime pas pour vous le rôle lié au service.
Nettoyage d'un rôle lié à un service
Avant de pouvoir supprimer un rôle lié IAM à un service, vérifiez d'abord qu'aucune ressource (cluster) n'est associée au rôle.
Pour vérifier si le rôle lié à un service possède une session active dans la console IAM
Connectez-vous à la IAM console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/iam/
. -
Dans le volet de navigation gauche de la IAM console, sélectionnez Rôles. Choisissez ensuite le nom (et non la case à cocher) du AmazonTimestreamInflux DBServiceRolePolicy rôle.
-
Sur la page Récapitulatif du rôle sélectionné, choisissez l'onglet Access Advisor.
-
Dans l'onglet Access Advisor, consultez l'activité récente pour le rôle lié à un service.
Supprimer un rôle lié à un service (console) IAM
Vous pouvez utiliser la IAM console pour supprimer un rôle lié à un service.
Pour supprimer un rôle lié à un service (console)
Connectez-vous à la IAM console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/iam/
. -
Dans le volet de navigation gauche de la IAM console, sélectionnez Rôles. Cochez ensuite la case en regard du nom du rôle que vous souhaitez supprimer, sans sélectionner le nom ou la ligne.
-
Pour les actions sur les Rôle en haut de la page, sélectionnez Supprimer.
-
Sur la page de confirmation, passez en revue les données du dernier accès au service, qui indiquent la date à laquelle chacun des rôles sélectionnés a accédé à un AWS service pour la dernière fois. Cela vous permet de confirmer si le rôle est actif actuellement. Si vous souhaitez continuer, sélectionnez Oui, supprimer pour lancer la tâche de suppression du rôle.
-
Regardez les notifications de la IAM console pour suivre la progression de la suppression des rôles liés au service. La suppression du rôle IAM lié au service étant asynchrone, une fois que vous avez soumis le rôle pour suppression, la tâche de suppression peut réussir ou échouer. Si la tâche échoue, vous pouvez choisir View details (Afficher les détails) ou View Resources (Afficher les ressources) à partir des notifications pour connaître le motif de l'échec de la suppression.
Supprimer un rôle lié à un service () IAM CLI
Vous pouvez utiliser IAM les opérations du AWS Command Line Interface pour supprimer un rôle lié à un service.
Pour supprimer un rôle lié à un service () CLI
-
Si vous ne connaissez pas le nom du rôle lié à un service que vous souhaitez supprimer, saisissez la commande suivante. Cette commande répertorie les rôles et leurs noms de ressources Amazon (ARNs) dans votre compte.
$
aws iam get-role --role-name
role-name
Utilisez le nom du rôle, et non leARN, pour faire référence aux rôles associés aux CLI opérations. Par exemple, si un rôle possède le ARN
arn:aws:iam::123456789012:role/myrole
, vous l'appelezmyrole
. -
Dans la mesure où un rôle lié à un service ne peut pas être supprimé s'il est utilisé ou si des ressources lui sont associées, vous devez envoyer une demande de suppression. Cette demande peut être refusée si ces conditions ne sont pas satisfaites. Vous devez capturer le
deletion-task-id
de la réponse afin de vérifier l'état de la tâche de suppression. Saisissez la commande suivante pour envoyer une demande de suppression d'un rôle lié à un service.$
aws iam delete-service-linked-role --role-name
role-name
-
Tapez la commande suivante pour vérifier l'état de la tâche de suppression.
$
aws iam get-service-linked-role-deletion-status --deletion-task-id
deletion-task-id
L’état de la tâche de suppression peut être
NOT_STARTED
,IN_PROGRESS
,SUCCEEDED
ouFAILED
. Si la suppression échoue, l’appel renvoie le motif de l’échec, afin que vous puissiez apporter une solution.
Supprimer un rôle lié à un service () IAM API
Vous pouvez utiliser le IAM API pour supprimer un rôle lié à un service.
Pour supprimer un rôle lié à un service () API
-
Pour soumettre une demande de suppression pour un rôle lié à un service, appelez DeleteServiceLinkedRole. Dans la demande, spécifiez un nom de rôle.
Dans la mesure où un rôle lié à un service ne peut pas être supprimé s'il est utilisé ou si des ressources lui sont associées, vous devez envoyer une demande de suppression. Cette demande peut être refusée si ces conditions ne sont pas satisfaites. Vous devez capturer le
DeletionTaskId
de la réponse afin de vérifier l'état de la tâche de suppression. -
Pour vérifier l'état de la suppression, appelez GetServiceLinkedRoleDeletionStatus. Dans la demande, spécifiez le
DeletionTaskId
.L’état de la tâche de suppression peut être
NOT_STARTED
,IN_PROGRESS
,SUCCEEDED
ouFAILED
. Si la suppression échoue, l’appel renvoie le motif de l’échec, afin que vous puissiez apporter une solution.
Régions prises en charge pour Amazon Timestream pour les rôles liés au service InfluxDB
Amazon Timestream for InfluxDB prend en charge l'utilisation de rôles liés à un service dans toutes les régions où le service est disponible. Pour plus d’informations, consultez Points de terminaison du service AWS.