Actions, ressources et clés de condition pour Amazon Kendra - Référence de l'autorisation de service
ActionsTypes de ressourcesClés de condition

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.

Actions, ressources et clés de condition pour Amazon Kendra

Amazon Kendra (préfixe de service : kendra) fournit les ressources, actions et clés de contexte de condition spécifiques au service suivantes en vue de leur utilisation dans les stratégies d'autorisation IAM.

Références :

Actions définies par Amazon Kendra

Vous pouvez spécifier les actions suivantes dans l'élément Action d'une instruction de stratégie IAM. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une politique, vous autorisez ou refusez généralement l'accès à l'APIopération ou à la CLI commande portant le même nom. Toutefois, dans certains cas, une seule action contrôle l'accès à plusieurs opérations. D'autres opérations, quant à elles, requièrent plusieurs actions différentes.

La colonne Types de ressources indique si chaque action prend en charge les autorisations au niveau des ressources. S'il n'y a pas de valeur pour cette colonne, vous devez indiquer toutes les ressources (« * ») dans l'élément Resource de votre déclaration de politique. Si la colonne inclut un type de ressource, vous pouvez spécifier un type ARN de ressource de ce type dans une instruction comportant cette action. Si l'action comporte une ou plusieurs ressources requises, l'appelant doit être autorisé à utiliser l'action avec ces ressources. Les ressources requises sont indiquées dans le tableau par un astérisque (*). Si vous limitez l'accès aux ressources avec l'Resourceélément d'une IAM politique, vous devez inclure un modèle ARN ou pour chaque type de ressource requis. Certaines actions prennent en charge plusieurs types de ressources. Si le type de ressource est facultatif (non indiqué comme obligatoire), vous pouvez choisir d'utiliser l'un, mais pas l'autre.

La colonne Clés de condition inclut des clés que vous pouvez spécifier dans l'élément Condition d'une déclaration de politique. Pour plus d'informations sur les clés de condition associées aux ressources du service, consultez la colonne Clés de condition du tableau des types de ressources.

Note

Les clés de condition des ressources sont répertoriées dans le tableau Types de ressources. Vous pouvez trouver un lien vers le type de ressource qui s'applique à une action dans la colonne Types de ressources (* obligatoire) du tableau Actions. Le type de ressource indiqué dans le tableau Types de ressources inclut la colonne Clés de condition, qui contient les clés de condition de ressource qui s'appliquent à une action dans le tableau Actions.

Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Actions.

Actions Description Niveau d'accès Types de ressources (*obligatoire) Clés de condition Actions dépendantes
AssociateEntitiesToExperience Accorde l'autorisation de placer le mappage principal dans l'index Écrire

experience*

index*

AssociatePersonasToEntities Définit les autorisations spécifiques des utilisateurs ou des groupes de votre source AWS SSO d'identité ayant accès à votre expérience Amazon Kendra Écrire

experience*

index*

BatchDeleteDocument Accorde l'autorisation de supprimer des documents par lots Écrire

index*

BatchDeleteFeaturedResultsSet Accorde l'autorisation de supprimer un jeu de résultats présenté Écrire

featured-results-set*

index*

BatchGetDocumentStatus Accorde l'autorisation d'obtenir par lots le statut de document Lecture

index*

BatchPutDocument Accorde l'autorisation d'ajouter des documents par lots Écrire

index*

ClearQuerySuggestions Accorde l'autorisation d'effacer les suggestions pour un index donné généré jusqu'à maintenant Écrire

index*

CreateAccessControlConfiguration Accorde l'autorisation de créer une configuration de contrôle d'accès Écrire

index*

CreateDataSource Accorde l'autorisation de créer une source de données. Écrire

index*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateExperience Crée une expérience Amazon Kendra, telle qu'une application de recherche Écrire

index*

CreateFaq Accorde l'autorisation de créer une FAQ Écrire

index*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateFeaturedResultsSet Accorde l'autorisation de créer un jeu de résultats présenté Écrire

index*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateIndex Accorde l'autorisation de créer un index Écrire

aws:RequestTag/${TagKey}

aws:TagKeys

CreateQuerySuggestionsBlockList Accorde l'autorisation de créer un QuerySuggestions BlockList Écrire

index*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateThesaurus Accorde l'autorisation de créer un thésaurus Écrire

index*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteAccessControlConfiguration Accorde l'autorisation de supprimer une configuration de contrôle d'accès Écrire

access-control-configuration*

index*

DeleteDataSource Accorde l'autorisation de supprimer une source de données. Écrire

data-source*

index*

DeleteExperience Supprime votre expérience Amazon Kendra, telle qu'une application de recherche Écrire

experience*

index*

DeleteFaq Accorde l'autorisation de supprimer une FAQ Écrire

faq*

index*

DeleteIndex Accorde l'autorisation de supprimer un index Écrire

index*

DeletePrincipalMapping Accorde l'autorisation de supprimer le mappage principal de l'index Écrire

index*

data-source

DeleteQuerySuggestionsBlockList Accorde l'autorisation de supprimer un QuerySuggestions BlockList Écrire

index*

query-suggestions-block-list*

DeleteThesaurus Accorde l'autorisation de supprimer un thésaurus Écrire

index*

thesaurus*

DescribeAccessControlConfiguration Accorde l'autorisation de décrire une configuration de contrôle d'accès Lecture

access-control-configuration*

index*

DescribeDataSource Accorde l'autorisation de décrire une source de données Lecture

data-source*

index*

DescribeExperience Obtient des informations sur votre expérience Amazon Kendra, comme une application de recherche Lecture

experience*

index*

DescribeFaq Accorde l'autorisation de décrire une FAQ Lecture

faq*

index*

DescribeFeaturedResultsSet Accorde l'autorisation de décrire un jeu de résultats présenté Lecture

featured-results-set*

index*

DescribeIndex Accorde l'autorisation de décrire un index Lecture

index*

DescribePrincipalMapping Accorde l'autorisation de décrire le mappage principal depuis l'index Lecture

index*

data-source

DescribeQuerySuggestionsBlockList Accorde l'autorisation de décrire un QuerySuggestions BlockList Lecture

index*

query-suggestions-block-list*

DescribeQuerySuggestionsConfig Accorde l'autorisation de décrire la configuration des suggestions de requête pour un index Lecture

index*

DescribeThesaurus Accorde l'autorisation de décrire un thésaurus Lecture

index*

thesaurus*

DisassociateEntitiesFromExperience Empêche les utilisateurs ou les groupes de votre source AWS SSO d'identité d'accéder à votre expérience Amazon Kendra Écrire

experience*

index*

DisassociatePersonasFromEntities Supprime les autorisations spécifiques des utilisateurs ou des groupes de votre source AWS SSO d'identité avec accès à votre expérience Amazon Kendra Écrire

experience*

index*

GetQuerySuggestions Accorde l'autorisation d'obtenir des suggestions pour un préfixe de requête Lecture

index*

GetSnapshots Récupère les données des métriques de recherche Lecture

index*

ListAccessControlConfigurations Accorde l'autorisation de répertorier les configurations de contrôle d'accès Liste

index*

ListDataSourceSyncJobs Accorde l'autorisation d'obtenir l'historique des tâches de synchronisation des sources de données Liste

data-source*

index*

ListDataSources Accorde l'autorisation de répertorier les sources de données Liste

index*

ListEntityPersonas Répertorie les autorisations spécifiques des utilisateurs et des groupes ayant accès à votre expérience Amazon Kendra Liste

experience*

index*

ListExperienceEntities Répertorie les utilisateurs ou les groupes de votre source AWS SSO d'identité autorisés à accéder à votre expérience Amazon Kendra Liste

experience*

index*

ListExperiences Répertorie une ou plusieurs expériences Amazon Kendra. Vous pouvez créer une expérience Amazon Kendra, telle qu'une application de recherche Liste

index*

ListFaqs Accorde l'autorisation de répertorier les FAQ Liste

index*

ListFeaturedResultsSets Accorde l'autorisation de répertorier les jeux de résultats présentés Liste

index*

ListGroupsOlderThanOrderingId Accorde l'autorisation de répertorier les groupes plus anciens qu'un ID de classement Liste

index*

data-source

ListIndices Accorde l'autorisation de répertorier les index Liste
ListQuerySuggestionsBlockLists Accorde l'autorisation de répertorier les QuerySuggestions BlockLists Liste

index*

ListTagsForResource Accorde l'autorisation de répertorier les identifications d'une ressource. Lecture

data-source

faq

featured-results-set

index

query-suggestions-block-list

thesaurus

ListThesauri Accorde l'autorisation de répertorier des thésaurus Liste

index*

PutPrincipalMapping Accorde l'autorisation de placer le mappage principal dans l'index Écrire

index*

data-source

Query Accorde l'autorisation d'interroger des documents et des FAQ Lecture

index*

Retrieve Accorde l'autorisation de récupérer le contenu pertinent d'un index Lecture

index*

StartDataSourceSyncJob Accorde l'autorisation de démarrer la tâche de synchronisation des sources de données Écrire

data-source*

index*

StopDataSourceSyncJob Accorde l'autorisation d'arrêter la tâche de synchronisation des sources de données Écrire

data-source*

index*

SubmitFeedback Accorde l'autorisation d'envoyer des commentaires sur les résultats d'une requête Écrire

index*

TagResource Accorde l'autorisation d'identificationr une ressource avec des paires de valeurs clés données Identification

data-source

faq

featured-results-set

index

query-suggestions-block-list

thesaurus

aws:RequestTag/${TagKey}

aws:TagKeys

UntagResource Accorde l'autorisation de supprimer la balise avec la clé donnée d'une ressource Identification

data-source

faq

featured-results-set

index

query-suggestions-block-list

thesaurus

aws:TagKeys

UpdateAccessControlConfiguration Accorde l'autorisation de mettre à jour une configuration de contrôle d'accès Écrire

access-control-configuration*

index*

UpdateDataSource Accorde l'autorisation de mettre à jour une source de données Écrire

data-source*

index*

UpdateExperience Met à jour votre expérience Amazon Kendra, telle qu'une application de recherche Écrire

index*

UpdateFeaturedResultsSet Accorde l'autorisation de mettre à jour un jeu de résultats présenté Écrire

featured-results-set*

index*

UpdateIndex Accorde l'autorisation de mettre à jour un index Écrire

index*

UpdateQuerySuggestionsBlockList Accorde l'autorisation de mettre à jour un QuerySuggestions BlockList Écrire

index*

query-suggestions-block-list*

UpdateQuerySuggestionsConfig Accorde l'autorisation de mettre à jour la configuration des suggestions de requête pour un index Écrire

index*

UpdateThesaurus Accorde l'autorisation de mettre à jour un thésaurus Écrire

index*

thesaurus*

Types de ressources définis par Amazon Kendra

Ce service définit les types de ressources suivants, qui peuvent être utilisés dans l'élément Resource des instructions de stratégie d'autorisation IAM. Chaque action du tableau Actions identifie les types de ressources pouvant être spécifiés avec cette action. Un type de ressource peut également définir les clés de condition que vous pouvez inclure dans une politique. Ces clés sont affichées dans la dernière colonne du tableau. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Types de ressources.

Types de ressources ARN Clés de condition
index arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}

aws:ResourceTag/${TagKey}

data-source arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/data-source/${DataSourceId}

aws:ResourceTag/${TagKey}

faq arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/faq/${FaqId}

aws:ResourceTag/${TagKey}

experience arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/experience/${ExperienceId}
thesaurus arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/thesaurus/${ThesaurusId}

aws:ResourceTag/${TagKey}

query-suggestions-block-list arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/query-suggestions-block-list/${QuerySuggestionsBlockListId}

aws:ResourceTag/${TagKey}

arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/featured-results-set/${FeaturedResultsSetId}

aws:ResourceTag/${TagKey}

access-control-configuration arn:${Partition}:kendra:${Region}:${Account}:index/${IndexId}/access-control-configuration/${AccessControlConfigurationId}

Clés de condition pour Amazon Kendra

Amazon Kendra définit les clés de condition suivantes que vous pouvez utiliser dans l'élément Condition d'une stratégie IAM. Vous pouvez utiliser ces clés pour affiner les conditions d'application de la déclaration de politique. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Clés de condition.

Pour afficher les clés de condition globales disponibles pour tous les services, consultez Clés de condition globales disponibles.

Clés de condition Description Type
aws:RequestTag/${TagKey} Filtre l'accès en fonction des identifications transmises dans la demande Chaîne
aws:ResourceTag/${TagKey} Filtre l'accès en fonction des identifications associées à la ressource Chaîne
aws:TagKeys Filtre l'accès en fonction des clés d'identification qui sont transmises dans la demande ArrayOfString