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 créer OpenSearch des collections sans serveur
<a name="serverless-service-linked-roles"></a>

OpenSearch Serverless utilise des rôles Gestion des identités et des accès AWS liés à un [service](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) (IAM). Un rôle lié à un service est un type unique de rôle IAM directement lié au service. OpenSearch Les rôles liés au service sont prédéfinis par le OpenSearch service et incluent toutes les autorisations dont le service a besoin pour appeler d'autres AWS services en votre nom.

OpenSearch Serverless utilise le rôle lié au service nommé **AWSServiceRoleForAmazonOpenSearchServerless**, qui fournit les autorisations nécessaires pour que le rôle publie des métriques liées au service sans serveur CloudWatch sur votre compte. La politique d'autorisations de rôle associée à AWSService RoleForAmazonOpenSearchServerless est nommée`AmazonOpenSearchServerlessServiceRolePolicy`. Pour plus d'informations sur la politique, consultez [AmazonOpenSearchServerlessServiceRolePolicy](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonOpenSearchServerlessServiceRolePolicy.html)le *Guide de référence des politiques AWS gérées*.

## Autorisations de rôle liées au service pour Serverless OpenSearch
<a name="serverless-slr-permissions"></a>

OpenSearch Serverless utilise le rôle lié au service nommé AWSServiceRoleForAmazonOpenSearchServerless, qui permet à OpenSearch Serverless d'appeler des AWS services en votre nom.

Le rôle AWSService RoleForAmazonOpenSearchServerless lié à un service fait confiance aux services suivants pour assumer le rôle :
+ `observability.aoss.amazonaws.com`

La politique d'autorisation de rôle nommée `AmazonOpenSearchServerlessServiceRolePolicy` permet à OpenSearch Serverless d'effectuer les actions suivantes sur les ressources spécifiées :
+ Action : `cloudwatch:PutMetricData` sur toutes les ressources AWS 

**Note**  
La politique inclut la clé de condition`{"StringEquals": {"cloudwatch:namespace": "AWS/AOSS"}}`, ce qui signifie que le rôle lié à un service peut uniquement envoyer des données métriques à l'`AWS/AOSS` CloudWatchespace de noms.  
 

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](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) dans le *Guide de l’utilisateur IAM*.

## Création du rôle lié à un service pour Serverless OpenSearch
<a name="create-serverless-slr"></a>

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Lorsque vous créez une collection OpenSearch Serverless dans le AWS Management Console, le ou l' AWS API AWS CLI, OpenSearch Serverless crée le rôle lié au service pour vous.

**Note**  
La première fois que vous créez une collection, le rôle `iam:CreateServiceLinkedRole` doit vous être attribué dans une politique basée sur l'identité. 

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 collection OpenSearch Serverless, OpenSearch Serverless 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 **Amazon OpenSearch Serverless**. Dans l'API AWS CLI ou dans l' AWS API, créez un rôle lié à un service avec le nom du `observability.aoss.amazonaws.com` service :

```
aws iam create-service-linked-role --aws-service-name "observability.aoss.amazonaws.com"
```

Pour plus d’informations, consultez [Création d’un rôle lié à un service](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role) 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 du rôle lié à un service pour Serverless OpenSearch
<a name="edit-serverless-slr"></a>

OpenSearch Serverless ne vous permet pas de modifier le rôle lié au AWSService RoleForAmazonOpenSearchServerless 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 au 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) dans le *Guide de l’utilisateur IAM*.

## Suppression du rôle lié à un service pour Serverless OpenSearch
<a name="delete-serverless-slr"></a>

Si vous n’avez plus besoin d’utiliser une fonction ou un service qui nécessite un rôle lié à un service, nous vous recommandons de supprimer ce rôle. Cela vous évite d'avoir une entité inutilisée non surveillée ou non gérée activement. Cependant, vous devez nettoyer les ressources de votre rôle lié à un service avant de pouvoir les supprimer manuellement.

Pour supprimer le AWSServiceRoleForAmazonOpenSearchServerless, vous devez d'abord [supprimer toutes les collections OpenSearch Serverless](serverless-delete.md) de votre Compte AWS.

**Note**  
Si OpenSearch Serverless 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é au service à l’aide d’IAM**

Utilisez la console IAM, le AWS CLI, ou l' AWS API pour supprimer le rôle lié au AWSService RoleForAmazonOpenSearchServerless service. Pour plus d’informations, consultez la section [Suppression d’un rôle lié à un service](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) dans le *Guide de l’utilisateur IAM*.

## Régions prises en charge pour les rôles OpenSearch liés à un service sans serveur
<a name="serverless-slr-regions"></a>

OpenSearch Serverless prend en charge l'utilisation du rôle AWSService RoleForAmazonOpenSearchServerless lié au service dans toutes les régions où OpenSearch Serverless est disponible. Pour obtenir la liste des régions prises en charge, consultez la section [Points de terminaison et quotas Amazon OpenSearch Serverless](https://docs.aws.amazon.com/general/latest/gr/opensearch-service.html) dans le. *Références générales AWS*