Pour des fonctionnalités similaires à celles d'Amazon Timestream pour, pensez à Amazon Timestream LiveAnalytics pour InfluxDB. Il permet une ingestion simplifiée des données et des temps de réponse aux requêtes à un chiffre en millisecondes pour des analyses en temps réel. Pour en savoir plus, [cliquez ici](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).
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 Gestion des identités et des accès AWS utilise des rôles liés à un service (IAM).](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) Un rôle lié à un service est un type unique de rôle IAM 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 [AWS Services qui fonctionnent avec IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) et recherchez les services avec un **Oui** dans la colonne **Rôle lié à un service**. Choisissez un **Oui** ayant un lien permettant de consulter les détails du rôle pour ce service.
**Contents**
+ [Autorisations de rôles liés à un service](#service-linked-role-permissions)
+ [Création d'un rôle lié à un service (IAM)](#create-service-linked-role-iam)
+ [Modification de la description d'un rôle lié à un service](#edit-service-linked-role)
+ [Utilisation de la console IAM](#edit-service-linked-role-iam-console)
+ [Utilisation de la CLI IAM](#edit-service-linked-role-iam-cli)
+ [Utilisation de l'API IAM](#edit-service-linked-role-iam-api)
+ [Supprimer un rôle lié à un service pour Amazon Timestream pour InfluxDB](#delete-service-linked-role)
+ [Nettoyage d'un rôle lié à un service](#service-linked-role-review-before-delete)
+ [Suppression d'un rôle lié à un service (console IAM)](#delete-service-linked-role-iam-console)
+ [Suppression d'un rôle lié à un service (CLI IAM)](#delete-service-linked-role-iam-cli)
+ [Suppression d'un rôle lié à un service (API IAM)](#delete-service-linked-role-iam-api)
+ [Régions prises en charge pour Amazon Timestream pour les rôles liés au service InfluxDB](#supported-regions)
## Autorisations de rôle liées à un service pour Amazon Timestream pour InfluxDB
Amazon Timestream for InfluxDB utilise le rôle lié à un service **AmazonTimestreamInfluxDBServiceRolePolicy**nommé — 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 DBService RolePolicy liés au service permet à Amazon Timestream pour InfluxDB d'effectuer les actions suivantes sur les ressources spécifiées :
------
#### [ JSON ]
****
```
{
"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 entité IAM à créer des rôles liés à un AmazonTimestreamInflux DBService RolePolicy service**
Ajoutez la déclaration de politique suivante aux autorisations de cette entité IAM :
```
{
"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 entité IAM à supprimer des rôles liés à un AmazonTimestreamInflux DBService RolePolicy service**
Ajoutez la déclaration de politique suivante aux autorisations de cette entité IAM :
```
{
"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 DBService RolePolicy Après avoir 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.
### Modification de la description d'un rôle lié à un service (console IAM)
Vous pouvez utiliser la console IAM pour modifier la description d'un rôle lié à un service.
**Pour modifier la description d'un rôle lié à un service (console)**
1. Dans le volet de navigation de gauche de la console IAM, sélectionnez **Rôles**.
1. Choisissez le nom du rôle à modifier.
1. A l'extrême droite de **Description du rôle**, choisissez **Edit (Modifier)**.
1. Saisissez une nouvelle description dans la zone et choisissez **Save (Enregistrer)**.
### Modification de la description d'un rôle lié à un service (CLI IAM)
Vous pouvez utiliser les opérations IAM depuis le AWS Command Line Interface pour modifier la description d'un rôle lié à un service.
**Pour changer la description d'un rôle d'un rôle lié à un service (CLI)**
1. (Facultatif) Pour afficher la description actuelle d'un rôle, utilisez l'opération AWS CLI `[get-role](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-role.html)` for IAM.
**Example**
```
$ aws iam get-role --role-name AmazonTimestreamInfluxDBServiceRolePolicy
```
Utilisez le nom du rôle, pas l'ARN, pour faire référence aux opérations de la CLI. Par exemple, si un rôle a l'ARN : `arn:aws:iam::123456789012:role/myrole`, faites référence au rôle en tant que **myrole**.
1. Pour mettre à jour la description d'un rôle lié à un service, utilisez l'opération AWS CLI for IAM. `[update-role-description](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/update-role-description.html)`
**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 (API IAM)
Vous pouvez utiliser l'API IAM pour modifier la description d'un rôle lié à un service.
**Pour changer la description d'un rôle lié à un service (API)**
1. (Facultatif) Pour afficher la description courante d'un rôle, utilisez l'opération d'API IAM [GetRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetRole.html).
**Example**
```
https://iam.amazonaws.com/
?Action=[GetRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetRole.html)
&RoleName=AmazonTimestreamInfluxDBServiceRolePolicy
&Version=2010-05-08
&AUTHPARAMS
```
1. Pour mettre à jour la description d'un rôle, utilisez l'opération d'API IAM [UpdateRoleDescription](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateRoleDescription.html).
**Example**
```
https://iam.amazonaws.com/
?Action=[UpdateRoleDescription](https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateRoleDescription.html)
&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 utiliser IAM pour supprimer un rôle lié à un service, vérifiez d'abord qu'aucune ressource (cluster) n'est associée au rôle.
**Pour vérifier si une session est active pour le rôle lié à un service dans la console IAM**
1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse.
1. Dans le volet de navigation de gauche de la console IAM, sélectionnez **Rôles**. Choisissez ensuite le nom (et non la case à cocher) du AmazonTimestreamInflux DBService RolePolicy rôle.
1. Sur la page **Récapitulatif** du rôle sélectionné, choisissez l'onglet **Access Advisor**.
1. Dans l'onglet **Access Advisor**, consultez l'activité récente pour le rôle lié à un service.
### Suppression d'un rôle lié à un service (console IAM)
Vous pouvez utiliser la console IAM pour supprimer un rôle lié à un service.
**Pour supprimer un rôle lié à un service (console)**
1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse.
1. Dans le volet de navigation de gauche de la console IAM, 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.
1. Pour les actions sur les **Rôle** en haut de la page, sélectionnez **Supprimer**.
1. 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.
1. Consultez les notifications de la console IAM pour surveiller la progression de la suppression du rôle lié à un service. Dans la mesure où la suppression du rôle lié à un service IAM est asynchrone, une fois que vous soumettez le rôle afin qu’il soit supprimé, la 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.
### Suppression d'un rôle lié à un service (CLI IAM)
Vous pouvez utiliser les opérations IAM depuis le AWS Command Line Interface pour supprimer un rôle lié à un service.
**Pour supprimer un rôle lié à un service (CLI)**
1. 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, pas l'ARN, pour faire référence aux opérations de la CLI. Par exemple, si un rôle a l'ARN `arn:aws:iam::123456789012:role/myrole`, vous faites référence au rôle en tant que **myrole**.
1. Étant donné qu'un rôle lié à un service ne peut pas être supprimé s'il est utilisé ou s'il est associé à des ressources, vous devez envoyer une demande de suppression avec la [delete-service-linked-role](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/delete-service-linked-role.html)commande. 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
```
1. Exécutez la commande [get-service-linked-role-deletion-status](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/get-service-linked-role-deletion-status.html) 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` ou `FAILED`. Si la suppression échoue, l’appel renvoie le motif de l’échec, afin que vous puissiez apporter une solution.
### Suppression d'un rôle lié à un service (API IAM)
Vous pouvez utiliser l'API IAM pour supprimer un rôle lié à un service.
**Pour supprimer un rôle lié à un service (API)**
1. Pour envoyer une demande de suppression pour un rôle lié à un service, appelez [DeleteServiceLinkedRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_DeleteServiceLinkedRole.html). Dans la demande, spécifiez le nom d'un 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.
1. Pour vérifier l'état de la suppression, appelez [GetServiceLinkedRoleDeletionStatus](https://docs.aws.amazon.com/IAM/latest/APIReference/API_GetServiceLinkedRoleDeletionStatus.html). Dans la demande, spécifiez le `DeletionTaskId`.
L’état de la tâche de suppression peut être `NOT_STARTED`, `IN_PROGRESS`, `SUCCEEDED` ou `FAILED`. 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html).