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

Amazon Rekognition (préfixe de service : rekognition) 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.

Actions définies par Amazon Rekognition

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 stratégie, 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
AssociateFaces	Accorde l'autorisation d'associer plusieurs visages à un même utilisateur	Écrire	collection*
CompareFaces	Accorde l'autorisation de comparer les visages de l'image d'entrée source à chaque visage détecté dans l'image d'entrée cible	Lire
CopyProjectVersion	Accorde l'autorisation de copier une version de modèle existante vers une nouvelle version de modèle	Écrire	project*
			projectversion*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateCollection	Accorde l'autorisation de créer une collection dans une Région AWS	Écrire	collection*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDataset	Accorde l'autorisation de créer un jeu de données Amazon Rekognition Custom Labels	Écrire	project*
CreateFaceLivenessSession	Accorde l'autorisation de créer une session de détection du visage	Écrire
CreateProject	Accorde l'autorisation de créer un projet Amazon Rekognition Custom Labels	Écrire	project*
CreateProjectVersion	Accorde l'autorisation de commencer la formation d'une nouvelle version d'un modèle	Écrire	project*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateStreamProcessor	Accorde l'autorisation de créer un processeur de flux Amazon Rekognition	Écrire	collection*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateUser	Accorde l'autorisation de créer un nouvel utilisateur dans une collection à l'aide de l'ID utilisateur unique fourni	Écrire	collection*
DeleteCollection	Accorde l'autorisation de supprimer la collection spécifiée	Écrire	collection*
DeleteDataset	Accorde l'autorisation de supprimer un jeu de données Amazon Rekognition Custom Labels existant	Écrire	dataset*
DeleteFaces	Accorde l'autorisation de supprimer des visages d'une collection	Écrire	collection*
DeleteProject	Accorde l'autorisation de supprimer un projet	Écrire	project*
DeleteProjectPolicy	Accorde l'autorisation de supprimer la politique de ressource attachée à un secret	Écrire	project*
DeleteProjectVersion	Accorde l'autorisation de supprimer un modèle	Écrire	projectversion*
DeleteStreamProcessor	Accorde l'autorisation de supprimer le processeur de flux spécifié	Écrire	streamprocessor*
DeleteUser	Accorde l'autorisation de supprimer un utilisateur d'une collection en fonction de l'ID utilisateur	Écrire	collection*
DescribeCollection	Accorde l'autorisation de lire les informations d'une collection	Lire	collection*
DescribeDataset	Accorde l'autorisation de décrire un jeu de données Amazon Rekognition Custom Labels	Lire	dataset*
DescribeProjectVersions	Accorde l'autorisation de répertorier les versions d'un modèle dans un projet Amazon Rekognition Custom Labels	Lire	project*
DescribeProjects	Accorde l'autorisation de répertorier les projets Amazon Rekognition Custom Labels	Lire
DescribeStreamProcessor	Accorde l'autorisation d'obtenir des informations sur le processeur de flux spécifié	Lire	streamprocessor*
DetectCustomLabels	Accorde l'autorisation de détecter des étiquettes personnalisées dans une image fournie	Lire	projectversion*
DetectFaces	Accorde l'autorisation de détecter des visages humains au sein d'une image fournie comme entrée	Lire
DetectLabels	Accorde l'autorisation de détecter les instances d'étiquettes réelles au sein d'une image fournie comme entrée	Lire
DetectModerationLabels	Accorde l'autorisation de détecter les étiquettes de modération au sein de l'image d'entrée	Lire	projectversion
DetectProtectiveEquipment	Accorde l'autorisation de détecter l'équipement de protection individuelle dans l'image d'entrée	Lire
DetectText	Accorde l'autorisation de détecter du texte dans l'image d'entrée et de le convertir en texte lisible par une machine	Lire
DisassociateFaces	Accorde l'autorisation de supprimer l'association entre une ID utilisateur et une ID de visage	Écrire	collection*
DistributeDatasetEntries	Accorde l'autorisation de distribuer les entrées d'un jeu de données de formation dans le jeu de données de formation et le jeu de données de test d'un projet	Écrire	dataset*
GetCelebrityInfo	Accorde l'autorisation de lire le nom et les informations supplémentaires d'une célébrité	Lire
GetCelebrityRecognition	Accorde l'autorisation de lire les résultats de reconnaissance des célébrités trouvés dans une vidéo stockée par une tâche de reconnaissance asynchrone de célébrités	Lire
GetContentModeration	Accorde l'autorisation de lire les résultats de l'analyse de modération de contenu trouvés dans une vidéo stockée par une tâche de modération de contenu asynchrone	Lire
GetFaceDetection	Accorde l'autorisation de lire les résultats de la détection de visages trouvés dans une vidéo stockée par une tâche de détection de visages asynchrone	Lire
GetFaceLivenessSessionResults	Accorde l'autorisation d'obtenir les résultats d'une session de détection du visage	Lire
GetFaceSearch	Accorde l'autorisation de lire les visages de la collection correspondants trouvés dans une vidéo stockée par une tâche de recherche de visages asynchrone	Lire
GetLabelDetection	Accorde l'autorisation de lire les résultats détectés de l'étiquette trouvés dans une vidéo stockée par une tâche de détection d'étiquettes asynchrone	Lire
GetMediaAnalysisJob	Accorde l'autorisation de lire la référence aux résultats d'une tâche dans S3 et des informations supplémentaires sur une tâche d'analyse des médias	Lire
GetPersonTracking	Accorde l'autorisation de lire la liste des personnes détectées dans une vidéo stockée par une tâche de suivi de personnes asynchrone	Lire
GetSegmentDetection	Accorde l'autorisation d'obtenir les segments vidéo trouvés dans une vidéo stockée par une tâche de détection de segments asynchrone	Lire
GetTextDetection	Accorde l'autorisation d'obtenir le texte trouvé dans une vidéo stockée par une tâche de détection de texte asynchrone	Lire
IndexFaces	Accorde l'autorisation de mettre à jour une collection existante avec des visages détectés dans l'image d'entrée	Écrire	collection*
ListCollections	Accorde l'autorisation de lire les identifiants de collection dans votre compte	Lire
ListDatasetEntries	Accorde l'autorisation de répertorier les entrées du jeu de données dans un jeu de données Amazon Rekognition Custom Labels existant	Lire	dataset*
ListDatasetLabels	Accorde l'autorisation de répertorier les étiquettes d'un jeu de données	Lire	dataset*
ListFaces	Accorde l'autorisation de lire les métadonnées relatives aux visages de la collection spécifiée	Lire	collection*
ListMediaAnalysisJobs	Accorde l'autorisation de lire la liste des tâches d'analyse des médias	Lire
ListProjectPolicies	Accorde l'autorisation d'obtenir la politique de ressource attachée à un secret	Lire	project*
ListStreamProcessors	Accorde l'autorisation d'obtenir une liste de vos processeurs de flux	Liste	streamprocessor*
ListTagsForResource	Accorde l'autorisation de renvoyer une liste de balises associées à une ressource	Lire	projectversion*
ListUsers	Accorde l'autorisation de répertorier les valeurs UserIds et UserStatus	Lire	collection*
PutProjectPolicy	Accorde l'autorisation d'attacher une politique de ressource à un secret	Écrire	project*
RecognizeCelebrities	Accorde l'autorisation de détecter des célébrités dans l'image d'entrée	Lire
SearchFaces	Accorde l'autorisation de rechercher l'ID de visage fourni dans la collection spécifiée	Lire	collection*
SearchFacesByImage	Accorde l'autorisation de rechercher le plus grand visage de l'image d'entrée dans la collection spécifiée	Lire	collection*
SearchUsers	Accorde l'autorisation de rechercher l'ID de visage ou l'ID utilisateur fourni dans la collection spécifiée pour faire correspondre l'utilisateur	Lire	collection*
SearchUsersByImage	Accorde l'autorisation de rechercher le plus grand visage de l'image d'entrée dans la collection spécifiée pour faire correspondre l'utilisateur	Lire	collection*
StartCelebrityRecognition	Accorde l'autorisation de démarrer la reconnaissance asynchrone des célébrités dans une vidéo stockée	Écrire
StartContentModeration	Accorde l'autorisation de démarrer la détection asynchrone de contenus explicites ou suggestifs pour adultes dans une vidéo	Écrire
StartFaceDetection	Accorde l'autorisation de démarrer la détection asynchrone des visages dans une vidéo stockée	Écrire
StartFaceLivenessSession	Accorde l'autorisation de démarrer la diffusion de vidéos pour une session de détection du visage	Écrire
StartFaceSearch	Accorde l'autorisation de démarrer la recherche asynchrone de visages d'une collection qui correspondent à ceux des personnes détectées dans une vidéo	Écrire	collection*
StartLabelDetection	Accorde l'autorisation de démarrer la détection asynchrone des étiquettes dans une vidéo stockée	Écrire
StartMediaAnalysisJob	Accorde l'autorisation de commencer une tâche d'analyse des médias	Écrire	projectversion
StartPersonTracking	Accorde l'autorisation de démarrer le suivi asynchrone des personnes dans une vidéo stockée	Écrire
StartProjectVersion	Accorde l'autorisation de lancer une version de modèle	Écrire	projectversion*
StartSegmentDetection	Accorde l'autorisation de démarrer la détection asynchrone des segments dans une vidéo stockée	Écrire
StartStreamProcessor	Accorde l'autorisation de lancer un processeur de flux	Écrire	streamprocessor*
StartTextDetection	Accorde l'autorisation de démarrer la détection asynchrone de texte dans une vidéo stockée	Écrire
StopProjectVersion	Accorde l'autorisation d'arrêter une version de modèle en cours d'exécution	Écrire	projectversion*
StopStreamProcessor	Accorde l'autorisation d'arrêter un processeur de flux en cours d'exécution	Écrire	streamprocessor*
TagResource	Accorde l'autorisation d'ajouter une ou plusieurs balises à une ressource	Balisage	collection
			projectversion
			streamprocessor
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Accorde l'autorisation de supprimer une ou plusieurs balises d'une ressource	Identification	collection
			projectversion
			streamprocessor
				aws:TagKeys
UpdateDatasetEntries	Accorde l'autorisation d'ajouter ou de mettre à jour une ou plusieurs lignes JSON (entrées) dans un jeu de données	Écrire	dataset*
UpdateStreamProcessor	Accorde l'autorisation de modifier les propriétés d'un processeur de flux	Écrire	streamprocessor*

Types de ressources définis par Amazon Rekognition

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
collection	arn:${Partition}:rekognition:${Region}:${Account}:collection/${CollectionId}	aws:ResourceTag/${TagKey}
streamprocessor	arn:${Partition}:rekognition:${Region}:${Account}:streamprocessor/${StreamprocessorId}	aws:ResourceTag/${TagKey}
project	arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/${CreationTimestamp}
projectversion	arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/version/${VersionName}/${CreationTimestamp}	aws:ResourceTag/${TagKey}
dataset	arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/dataset/${DatasetType}/${CreationTimestamp}

Clés de condition pour Amazon Rekognition

Amazon Rekognition définit les clés de condition suivantes que vous pouvez utiliser dans l'élément Condition d'une politique 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 balises transmises dans la demande	Chaîne
aws:ResourceTag/${TagKey}	Filtre l'accès en fonction des balises associées à la ressource	Chaîne
aws:TagKeys	Filtre l'accès en fonction des clés de balise transmises dans la demande	ArrayOfString