Actions, ressources et clés de condition pour Amazon Elastic Container Registry

Amazon Elastic Container Registry (préfixe de service : ecr) 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 Elastic Container Registry

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
BatchCheckLayerAvailability	Accorde l'autorisation de vérifier la disponibilité de plusieurs couches d'images dans un registre et un référentiel spécifiés.	Lire	repository*
BatchDeleteImage	Accorde l'autorisation de supprimer une liste d'images spécifiées au sein d'un référentiel spécifié.	Écrire	repository*
BatchGetImage	Accorde l'autorisation d'obtenir des informations détaillées pour les images spécifiées dans un référentiel spécifié	Lire	repository*
BatchGetRepositoryScanningConfiguration	Accorde l'autorisation de récupérer la configuration d'analyse du référentiel pour une liste de référentiels	Lire	repository*
BatchImportUpstreamImage [autorisation uniquement]	Accorde l'autorisation de récupérer l'image dans le registre amont et de l'importer dans votre registre privé	Écrire
CompleteLayerUpload	Accorde l'autorisation d'informer Amazon ECR que le chargement d'une couche d'image pour le registre, du nom de référentiel et de l'ID de chargement spécifiés est terminé.	Écrire	repository*
CreatePullThroughCacheRule	Accorde l'autorisation de créer une règle de cache de passage	Écrire			iam:CreateServiceLinkedRole
CreateRepository	Accorde l'autorisation de créer un référentiel d'images.	Écrire		aws:RequestTag/${TagKey} aws:TagKeys	ecr:TagResource
CreateRepositoryCreationTemplate	Octroie l'autorisation de créer un modèle de création de référentiel.	Écrire			ecr:PutLifecyclePolicy ecr:SetRepositoryPolicy
DeleteLifecyclePolicy	Accorde l'autorisation de supprimer la politique de cycle de vie spécifiée	Écrire	repository*
DeletePullThroughCacheRule	Accorde l'autorisation de supprimer la règle de cache de passage	Écrire
DeleteRegistryPolicy	Accorde l'autorisation de supprimer la politique de registre.	Gestion des autorisations
DeleteRepository	Accorde l'autorisation de supprimer un référentiel d'images existant	Écrire	repository*
DeleteRepositoryCreationTemplate	Octroie l'autorisation de supprimer le modèle de création de référentiel.	Écrire
DeleteRepositoryPolicy	Accorde l'autorisation de supprimer la politique de référentiel d'un référentiel spécifié	Gestion des autorisations	repository*
DescribeImageReplicationStatus	Accorde l'autorisation de récupérer le statut de réplication d'une image dans un registre, y compris, en cas d'échec de la réplication, la raison de cet échec	Lire	repository*
DescribeImageScanFindings	Accorde l'autorisation de décrire les résultats de numérisation d'image pour l'image spécifiée	Lire	repository*
DescribeImages	Accorde l'autorisation de récupérer les métadonnées sur les images dans un référentiel, y compris la taille de l'image, les balises de l'image et la date de création.	Liste	repository*
DescribePullThroughCacheRules	Accorde l'autorisation de décrire les règles de cache de passage	Liste
DescribeRegistry	Accorde l'autorisation de décrire les paramètres du registre.	Lire
DescribeRepositories	Accorde l'autorisation de décrire des référentiels d'images dans un registre	Lire	repository
DescribeRepositoryCreationTemplate	Octroie l'autorisation de décrire le modèle de création de référentiel.	Lire
GetAuthorizationToken	Accorde l'autorisation de récupérer un jeton valide pour un registre spécifié pendant 12 heures	Lire
GetDownloadUrlForLayer	Accorde l'autorisation de récupérer l'URL de téléchargement correspondant à une couche d'image	Lire	repository*
GetLifecyclePolicy	Accorde l'autorisation de récupérer la politique de cycle de vie spécifiée	Lire	repository*
GetLifecyclePolicyPreview	Accorde l'autorisation de récupérer les résultats de la demande d'aperçu de politique de cycle de vie spécifiée	Lire	repository*
GetRegistryPolicy	Accorde l'autorisation de récupérer la politique de registre.	Lire
GetRegistryScanningConfiguration	Accorde l'autorisation de récupérer une configuration de numérisation de registre	Lire
GetRepositoryPolicy	Accorde l'autorisation de récupérer la politique de référentiel pour un référentiel spécifié	Lire	repository*
InitiateLayerUpload	Accorde l'autorisation de notifier Amazon ECR que vous avez l'intention de charger une couche d'image	Écrire	repository*
ListImages	Accorde l'autorisation de répertorier tous les ID d'image d'un référentiel donné	Liste	repository*
ListTagsForResource	Accorde l'autorisation de répertorier les balises pour une ressource Amazon ECR	Lire	repository*
				aws:RequestTag/${TagKey} aws:TagKeys
PutImage	Accorde l'autorisation de créer ou de mettre à jour le manifeste d'image associé à une image	Écrire	repository*
PutImageScanningConfiguration	Accorde l'autorisation de mettre à jour la configuration de numérisation d'images pour un référentiel	Écrire	repository*
PutImageTagMutability	Accorde l'autorisation de mettre à jour les paramètres d'immuabilité des balises d'image pour un référentiel	Écrire	repository*
PutLifecyclePolicy	Accorde l'autorisation de créer ou de mettre à jour une politique de cycle de vie	Écrire	repository*
PutRegistryPolicy	Accorde l'autorisation de mettre à jour la politique de registre.	Gestion des autorisations
PutRegistryScanningConfiguration	Accorde l'autorisation de mettre à jour la configuration de numérisation de registre	Écrire
PutReplicationConfiguration	Accorde l'autorisation de mettre à jour la configuration de la réplication pour le registre.	Écrire
ReplicateImage [autorisation uniquement]	Accorde l'autorisation de répliquer des images vers le registre de destination.	Écrire	repository*
SetRepositoryPolicy	Accorde l'autorisation d'appliquer une politique de référentiel sur un référentiel spécifié pour contrôler les autorisations d'accès	Gestion des autorisations	repository*
StartImageScan	Accorde l'autorisation de démarrer une numérisation d'image	Écrire	repository*
StartLifecyclePolicyPreview	Accorde l'autorisation de démarrer un aperçu de la politique de cycle de vie spécifiée	Écrire	repository*
TagResource	Accorde l'autorisation de baliser une ressource Amazon ECR	Identification	repository*
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Accorde l'autorisation d'annuler le balisage d'une ressource Amazon ECR	Identification	repository*
				aws:TagKeys
UpdatePullThroughCacheRule	Octroie l'autorisation de mettre à jour la règle de cache de passage.	Écrire
UploadLayerPart	Accorde l'autorisation de charger une partie de couche d'image dans Amazon ECR	Écrire	repository*
ValidatePullThroughCacheRule	Octroie l'autorisation de valider la règle de cache de passage.	Lire

Types de ressources définis par Amazon Elastic Container Registry

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
repository	arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}	aws:ResourceTag/${TagKey} ecr:ResourceTag/${TagKey}

Clés de condition pour Amazon Elastic Container Registry

Amazon Elastic Container Registry 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 de l'ensemble de valeurs autorisées pour chacune des identifications	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 de identifications obligatoires dans la demande	ArrayOfString
ecr:ResourceTag/${TagKey}	Filtre l'accès en fonction de la valeur d'identification associée à la ressource	Chaîne