Utilisation de rôles liés à un service pour créer OpenSearch des collections sans serveur - Amazon OpenSearch Service

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

OpenSearch Serverless utilise AWS Identity and Access Management (IAM) des rôles liés à un service. Un rôle lié à un service est un type unique de IAM rôle 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 à AWSServiceRoleForAmazonOpenSearchServerless est nomméeAmazonOpenSearchServerlessServiceRolePolicy. Pour plus d'informations sur la politique, consultez AmazonOpenSearchServerlessServiceRolePolicyle Guide de référence des politiques AWS gérées.

Autorisations de rôle liées au service pour Serverless OpenSearch

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 AWSServiceRoleForAmazonOpenSearchServerless 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 AWS ressources

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, groupe ou rôle) de créer, modifier ou supprimer un rôle lié à un service. Pour plus d'informations, consultez la section Autorisations relatives aux rôles liés à un service dans le Guide de l'IAMutilisateur.

Création du rôle lié à un service pour Serverless OpenSearch

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 le AWS CLI AWS API, 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 IAM console pour créer un rôle lié à un service avec le cas d'utilisation Amazon OpenSearch Serverless. Dans le AWS CLI ou le 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 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

OpenSearch Serverless ne vous permet pas de modifier le rôle lié au AWSServiceRoleForAmazonOpenSearchServerless 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 de IAM. Pour plus d'informations, consultez la section Modification d'un rôle lié à un service dans le Guide de l'IAMutilisateur.

Suppression du rôle lié à un service pour Serverless OpenSearch

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. 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 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é à un service à l'aide d'IAM

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

Régions prises en charge pour les rôles OpenSearch liés à un service sans serveur

OpenSearch Serverless prend en charge l'utilisation du rôle AWSServiceRoleForAmazonOpenSearchServerless 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 dans le. Références générales AWS