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 Comprehend
Amazon Comprehend (préfixe de service : comprehend) fournit les ressources, actions et clés de contexte de condition spécifiques au service suivantes en vue de leur utilisation dans les politiques d'autorisation IAM.
Références :
-
Découvrez comment configurer ce service.
-
Affichez la liste des opérations d'API disponibles pour ce service.
-
Découvrez comment protéger ce service et ses ressources avec les stratégies d'autorisation IAM.
Rubriques
Actions définies par Amazon Comprehend
Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique 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'opération d'API ou à la commande CLI 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 indiquer un ARN de ce type dans une déclaration avec 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 dans une politique IAM, vous devez inclure un ARN ou un modèle 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 |
|---|---|---|---|---|---|
| BatchDetectDominantLanguage | Accorde l'autorisation de détecter la ou les langues présentes dans la liste des documents texte | Lecture | |||
| BatchDetectEntities | Accorde l'autorisation de détecter des entités nommées (« Personnes », « Emplacements », « Lieux », etc.) dans la liste des documents texte fournie | Lecture | |||
| BatchDetectKeyPhrases | Accorde l'autorisation de détecter, dans la liste des documents texte, les expressions qui sont les plus révélatrices du contenu | Lecture | |||
| BatchDetectSentiment | Accorde l'autorisation de détecter le sentiment émanant d'un texte dans la liste des documents (positif, négatif, neutre ou mixte). | Lecture | |||
| BatchDetectSyntax | Accorde l'autorisation de détecter des informations syntaxiques (comme la partie vocale, les jetons) dans une liste de documents texte | Lecture | |||
| BatchDetectTargetedSentiment | Accorde l'autorisation de détecter les sentiments associés à des entités spécifiques (telles que des marques ou des produits) dans une liste donnée de documents texte | Lecture | |||
| ClassifyDocument | Accorde l'autorisation de créer une demande de classification de document pour analyser un document unique en temps réel à l'aide d'un modèle personnalisé préalablement créé et entraîné, ainsi que d'un point de terminaison. | Lecture | |||
| ContainsPiiEntities | Accorde l'autorisation de classer en temps réel les informations personnelles identifiables dans des documents donnés | Lecture | |||
| CreateDataset | Octroie l'autorisation de créer un jeu de données dans un volant d'inertie | Écrire | |||
| CreateDocumentClassifier | Accorde l'autorisation de créer un classificateur de documents que vous pouvez utiliser pour catégoriser des documents | Écriture | |||
| CreateEndpoint | Accorde l'autorisation de créer un point de terminaison spécifique au modèle pour l'inférence synchrone pour un modèle personnalisé préalablement entraîné | Écriture | |||
| CreateEntityRecognizer | Accorde l'autorisation de créer un module de reconnaissance d'entité à l'aide des fichiers soumis | Écrire | |||
| CreateFlywheel | Octroie l'autorisation de créer un nouveau volant d'inertie que vous pouvez utiliser pour entraîner des versions de modèles | Écrire | |||
| DeleteDocumentClassifier | Accorde l'autorisation de supprimer un classificateur de documents précédemment créé | Écriture | |||
| DeleteEndpoint | Accorde l'autorisation de supprimer un point de terminaison spécifique au modèle pour un modèle personnalisé déjà entraîné. Tous les points de terminaison doivent être supprimés pour que le modèle soit supprimé. | Écriture | |||
| DeleteEntityRecognizer | Accorde l'autorisation de supprimer un module de reconnaissance d'entité soumis | Écrire | |||
| DeleteFlywheel | Octroie l'autorisation de supprimer un volant d'inertie | Écrire | |||
| DeleteResourcePolicy | Accorde l'autorisation de supprimer la politique d'une ressource. | Écrire | |||
| DescribeDataset | Octroie l'autorisation d'obtenir les propriétés associées à un jeu de données | Lecture | |||
| DescribeDocumentClassificationJob | Accorde l'autorisation d'obtenir les propriétés associées à une tâche de classification de documents | Lecture | |||
| DescribeDocumentClassifier | Accorde l'autorisation d'obtenir les propriétés associées à un classificateur de documents | Lecture | |||
| DescribeDominantLanguageDetectionJob | Accorde l'autorisation d'obtenir les propriétés associées à une tâche de détection de langue dominante | Lecture | |||
| DescribeEndpoint | Accorde l'autorisation d'obtenir les propriétés associées à un point de terminaison spécifique. Utilisez cette opération pour obtenir le statut d'un point de terminaison. | Lecture | |||
| DescribeEntitiesDetectionJob | Accorde l'autorisation d'obtenir les propriétés associées à une tâche de détection d'entités | Lecture | |||
| DescribeEntityRecognizer | Accorde l'autorisation de fournir les détails relatifs à un module de reconnaissance d'entités, y compris le statut, les compartiments S3 contenant les données d'entraînement, les métadonnées du module de reconnaissance, les métriques, etc. | Lecture | |||
| DescribeEventsDetectionJob | Accorde l'autorisation d'obtenir les propriétés associées à une tâche de détection d'événements. | Lecture | |||
| DescribeFlywheel | Octroie l'autorisation d'obtenir les propriétés associées à un volant d'inertie | Lecture | |||
| DescribeFlywheelIteration | Octroie l'autorisation d'obtenir les propriétés associées à l'itération d'un volant d'inertie pour un volant d'inertie | Lecture | |||
| DescribeKeyPhrasesDetectionJob | Accorde l'autorisation d'obtenir les propriétés associées à une tâche de détection d'expressions clés | Lecture | |||
| DescribePiiEntitiesDetectionJob | Accorde l'autorisation d'obtenir les propriétés associées à une tâche de détection d'entités PII | Lecture | |||
| DescribeResourcePolicy | Accorde l'autorisation de lire la politique attachée sur une ressource | Lecture | |||
| DescribeSentimentDetectionJob | Accorde l'autorisation d'obtenir les propriétés associées à une tâche de détection de sentiment | Lecture | |||
| DescribeTargetedSentimentDetectionJob | Accorde l'autorisation d'obtenir les propriétés associées à une tâche de détection ciblée des sentiments | Lecture | |||
| DescribeTopicsDetectionJob | Accorde l'autorisation d'obtenir les propriétés associées à une tâche de détection de rubrique | Lecture | |||
| DetectDominantLanguage | Accorde l'autorisation de détecter la ou les langues présentes dans le texte | Lecture | |||
| DetectEntities | Accorde l'autorisation de détecter les entités nommées (« Personnes », « Lieux », « Emplacements », etc.) dans le document texte donné | Lecture | |||
| DetectKeyPhrases | Accorde l'autorisation de détecter les expressions textuelles sont les plus révélatrices du contenu | Lecture | |||
| DetectPiiEntities | Accorde l'autorisation de détecter les entités d'information personnellement identifiables (« Nom », « SSN », « PIN », etc.) dans le document texte donné | Lecture | |||
| DetectSentiment | Accorde l'autorisation de détecter le sentiment d'un texte dans un document (positif, négatif, neutre ou mixte) | Lecture | |||
| DetectSyntax | Accorde l'autorisation de détecter d'informations syntaxiques (comme la partie vocale, les jetons) dans un document texte | Lecture | |||
| DetectTargetedSentiment | Accorde l'autorisation de détecter les sentiments associés à des entités spécifiques (telles que des marques ou des produits) dans un document | Lecture | |||
| DetectToxicContent | Autorise la détection de contenus toxiques dans la liste donnée de segments de texte | Lecture | |||
| ImportModel | Accorde l'autorisation d'importer un modèle Comprehend formé | Écrire | |||
| ListDatasets | Octroie l'autorisation d'obtenir une liste des jeux de données associés à un volant d'inertie | Lecture | |||
| ListDocumentClassificationJobs | Accorde l'autorisation d'obtenir une liste des tâches de classification de documents que vous avez soumises | Lecture | |||
| ListDocumentClassifierSummaries | Accorde l'autorisation d'obtenir une liste de résumés des classificateurs de documents que vous avez créés | Lecture | |||
| ListDocumentClassifiers | Accorde l'autorisation d'obtenir une liste des classificateurs de documents que vous avez créés | Lecture | |||
| ListDominantLanguageDetectionJobs | Accorde l'autorisation d'obtenir une liste des tâches de détection de langue dominante que vous avez soumises | Lecture | |||
| ListEndpoints | Accorde l'autorisation d'obtenir une liste de tous les points de terminaison existants que vous avez créés | Lecture | |||
| ListEntitiesDetectionJobs | Accorde l'autorisation d'obtenir une liste des tâches de détection d'entités que vous avez soumises | Lecture | |||
| ListEntityRecognizerSummaries | Accorde l'autorisation d'obtenir une liste de résumés des modules de reconnaissance d'entités que vous avez créés | Lecture | |||
| ListEntityRecognizers | Accorde l'autorisation d'obtenir une liste des propriétés de tous les modules de reconnaissance d'entités créés, y compris ceux en cours d'entraînement. | Lecture | |||
| ListEventsDetectionJobs | Accorde l'autorisation d'obtenir une liste de tâches de détection d'événements que vous avez soumises. | Lecture | |||
| ListFlywheelIterationHistory | Octroie l'autorisation d'obtenir une liste des itérations associées à un volant d'inertie | Lecture | |||
| ListFlywheels | Octroie l'autorisation d'obtenir une liste des volants d'inertie que vous avez créés | Lecture | |||
| ListKeyPhrasesDetectionJobs | Accorde l'autorisation d'obtenir une liste des tâches de détection d'expressions clés que vous avez envoyées | Lecture | |||
| ListPiiEntitiesDetectionJobs | Accorde l'autorisation d'obtenir une liste des tâches de détection d'entités PII que vous avez soumises | Lecture | |||
| ListSentimentDetectionJobs | Accorde l'autorisation d'obtenir une liste des tâches de détection de ressenti que vous avez soumises | Lecture | |||
| ListTagsForResource | Accorde l'autorisation de répertorier les identifications d'une ressource | Lecture | |||
| ListTargetedSentimentDetectionJobs | Accorde l'autorisation d'obtenir une liste des tâches de détection ciblée des sentiments que vous avez soumises | Lecture | |||
| ListTopicsDetectionJobs | Accorde l'autorisation d'obtenir une liste des tâches de détection de rubrique que vous avez soumises | Lecture | |||
| PutResourcePolicy | Accorde l'autorisation d'attacher une politique à une ressource | Écrire | |||
| StartDocumentClassificationJob | Accorde l'autorisation de démarrer une tâche de classification de document asynchrone | Écriture | |||
| StartDominantLanguageDetectionJob | Accorde l'autorisation de démarrer une tâche de détection de langue dominante asynchrone pour un ensemble de documents | Écriture | |||
| StartEntitiesDetectionJob | Accorde l'autorisation de démarrer une tâche de détection d'entités asynchrone pour un ensemble de documents | Écriture | |||
| StartEventsDetectionJob | Autorise le démarrage d'une tâche de détection d'événements asynchrone pour un ensemble de documents | Écrire | |||
| StartFlywheelIteration | Octroie l'autorisation de lancer une itération de volant d'inertie pour un volant d'inertie | Écrire | |||
| StartKeyPhrasesDetectionJob | Accorde l'autorisation de démarrer une tâche de détection d'expressions clés asynchrone pour un ensemble de documents | Écriture | |||
| StartPiiEntitiesDetectionJob | Accorde l'autorisation de démarrer une tâche de détection d'entités PII asynchrone pour un ensemble de documents | Écriture | |||
| StartSentimentDetectionJob | Accorde l'autorisation de démarrer une tâche de détection de sentiment asynchrone pour un ensemble de documents | Écrire | |||
| StartTargetedSentimentDetectionJob | Accorde l'autorisation de démarrer une tâche asynchrone de détection ciblée des sentiments pour une collection de documents | Écrire | |||
| StartTopicsDetectionJob | Accorde l'autorisation de démarrer une tâche asynchrone pour détecter les rubriques les plus courantes dans l'ensemble de documents et les expressions associées à chaque rubrique | Écriture | |||
| StopDominantLanguageDetectionJob | Accorde l'autorisation d'arrêter une tâche de détection de langue dominante | Écriture | |||
| StopEntitiesDetectionJob | Accorde l'autorisation d'arrêter une tâche de détection d'entités | Écriture | |||
| StopEventsDetectionJob | Accorde l'autorisation d'arrêter une tâche de détection d'événements | Écriture | |||
| StopKeyPhrasesDetectionJob | Accorde l'autorisation d'arrêter une tâche de détection d'expressions clés | Écriture | |||
| StopPiiEntitiesDetectionJob | Accorde l'autorisation d'arrêter une tâche de détection d'entités PII | Écriture | |||
| StopSentimentDetectionJob | Accorde l'autorisation d'arrêter une tâche de détection de sentiment | Écrire | |||
| StopTargetedSentimentDetectionJob | Accorde l'autorisation d'arrêter une tâche de détection ciblée des sentiments | Écrire | |||
| StopTrainingDocumentClassifier | Accorde l'autorisation d'arrêter une tâche d'entraînement de classificateur de documents déjà créée | Écriture | |||
| StopTrainingEntityRecognizer | Accorde l'autorisation d'arrêter une tâche d'entraînement du module de reconnaissance d'entités créée précédemment | Écriture | |||
| TagResource | Accorde l'autorisation d'identificationr une ressource avec des paires de valeurs clés données | Balisage | |||
| UntagResource | Accorde l'autorisation d'annuler le balisage d'une ressource avec une clé donnée | Balisage | |||
| UpdateEndpoint | Accorde l'autorisation de mettre à jour les informations sur le point de terminaison spécifié | Écrire | |||
| UpdateFlywheel | Octroie l'autorisation de mettre à jour la configuration d'un volant d'inertie | Écrire | |||
Types de ressources définis par Amazon Comprehend
Ce service définit les types de ressources suivants, qui peuvent être utilisés dans l' Resource élément des déclarations de politique 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 |
|---|---|---|
| targeted-sentiment-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:targeted-sentiment-detection-job/${JobId}
|
|
| document-classifier |
arn:${Partition}:comprehend:${Region}:${Account}:document-classifier/${DocumentClassifierName}
|
|
| document-classifier-endpoint |
arn:${Partition}:comprehend:${Region}:${Account}:document-classifier-endpoint/${DocumentClassifierEndpointName}
|
|
| entity-recognizer |
arn:${Partition}:comprehend:${Region}:${Account}:entity-recognizer/${EntityRecognizerName}
|
|
| entity-recognizer-endpoint |
arn:${Partition}:comprehend:${Region}:${Account}:entity-recognizer-endpoint/${EntityRecognizerEndpointName}
|
|
| dominant-language-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:dominant-language-detection-job/${JobId}
|
|
| entities-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:entities-detection-job/${JobId}
|
|
| pii-entities-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:pii-entities-detection-job/${JobId}
|
|
| events-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:events-detection-job/${JobId}
|
|
| key-phrases-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:key-phrases-detection-job/${JobId}
|
|
| sentiment-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:sentiment-detection-job/${JobId}
|
|
| topics-detection-job |
arn:${Partition}:comprehend:${Region}:${Account}:topics-detection-job/${JobId}
|
|
| document-classification-job |
arn:${Partition}:comprehend:${Region}:${Account}:document-classification-job/${JobId}
|
|
| flywheel |
arn:${Partition}:comprehend:${Region}:${Account}:flywheel/${FlywheelName}
|
|
| flywheel-dataset |
arn:${Partition}:comprehend:${Region}:${Account}:flywheel/${FlywheelName}/dataset/${DatasetName}
|
Clés de condition pour Amazon Comprehend
Amazon Comprehend 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 exigeant des valeurs d'identification présentes dans une demande de création de ressources | Chaîne |
| aws:ResourceTag/${TagKey} | Filtre l'accès en fonction de la valeur d'identification associée à la ressource | Chaîne |
| aws:TagKeys | Filtre l'accès en fonction de la présence d'identifications obligatoires dans la demande | ArrayOfString |
| comprehend:DataLakeKmsKey | Filtre l'accès par la clé DataLake Kms associée à la ressource volante dans la requête | ARN |
| comprehend:FlywheelIterationId | Filtre l'accès en fonction de l'ID d'itération spécifique d'un volant d'inertie | Chaîne |
| comprehend:ModelKmsKey | Filtre l'accès en fonction de la clé KMS de modèle associée à la ressource dans la demande | ARN |
| comprehend:OutputKmsKey | Filtre l'accès en fonction de la clé KMS de sortie associée à la ressource dans la demande | ARN |
| comprehend:VolumeKmsKey | Filtre l'accès en fonction de la clé KMS de volume associée à la ressource dans la demande | ARN |
| comprehend:VpcSecurityGroupIds | Filtre l'accès en fonction de la liste de tous les ID de groupe de sécurité VPC associés à la ressource dans la demande | ArrayOfString |
| comprehend:VpcSubnets | Filtre l'accès en fonction de la liste de tous les sous-réseaux VPC associés à la ressource dans la demande | ArrayOfString |
