Amazon Elastic Container Registry에 사용되는 작업, 리소스 및 조건 키

Amazon Elastic Container Registry(서비스 접두사: ecr)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.

참조:

이 서비스를 구성하는 방법을 알아봅니다.
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.

주제

Amazon Elastic Container Registry에서 정의한 작업
Amazon Elastic Container Registry에서 정의한 리소스 유형
Amazon Elastic Container Registry에 사용되는 조건 키

Amazon Elastic Container Registry에서 정의한 작업

IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.

작업 테이블의 액세스 수준 열은 작업이 분류되는 방법(목록, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 수준에 대한 자세한 내용은 정책 요약의 액세스 수준을 참조하세요.

작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.

작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.

작업 테이블의 종속 작업 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 작업 자체에 대한 권한 외에 이러한 권한이 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.

참고

리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.

다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.

작업	설명	액세스 레벨	리소스 유형(*필수)	조건 키	종속 작업
BatchCheckLayerAvailability	지정된 레지스트리 및 리포지토리에서 다중 이미지 계층의 가용성을 확인할 수 있는 권한을 부여합니다.	Read	repository*
BatchDeleteImage	지정된 리포지토리 내의 지정된 이미지 목록을 삭제할 수 있는 권한을 부여합니다.	Write	repository*
BatchGetImage	지정된 리포지토리 내의 지정된 이미지에 대한 세부 정보를 가져올 수 있는 권한을 부여합니다.	Read	repository*
BatchGetRepositoryScanningConfiguration	리포지토리 목록에 대한 리포지토리 검사 구성을 검색할 수 있는 권한을 부여합니다.	Read	repository*
BatchImportUpstreamImage [권한만 해당]	업스트림 레지스트리에서 이미지를 검색하고 이 이미지를 프라이빗 레지스트리로 가져올 수 있는 권한을 부여합니다.	쓰기	repository*
CompleteLayerUpload	지정된 레지스트리, 리포지토리 이름 및 업로드 ID에 대한 이미지 계층 업로드가 완료되었음을 Amazon ECR에 알릴 수 있는 권한을 부여합니다.	쓰기	repository*
CreatePullThroughCacheRule	새 풀스루 캐시 규칙을 생성할 수 있는 권한을 부여합니다.	쓰기			iam:CreateServiceLinkedRole
CreateRepository	이미지 리포지토리를 생성할 수 있는 권한을 부여합니다.	쓰기	repository*		ecr:TagResource
CreateRepository	이미지 리포지토리를 생성할 수 있는 권한을 부여합니다.	쓰기		aws:RequestTag/${TagKey} aws:TagKeys
CreateRepositoryCreationTemplate	리포지토리 생성 템플릿을 생성할 수 있는 권한을 부여합니다.	쓰기			ecr:CreateRepository ecr:PutLifecyclePolicy ecr:SetRepositoryPolicy iam:CreateServiceLinkedRole iam:PassRole
DeleteLifecyclePolicy	지정된 수명 주기 정책을 삭제할 수 있는 권한을 부여합니다.	쓰기	repository*
DeletePullThroughCacheRule	풀스루 캐시 규칙을 삭제할 수 있는 권한을 부여합니다.	쓰기
DeleteRegistryPolicy	레지스트리 정책을 삭제할 수 있는 권한을 부여합니다.	권한 관리
DeleteRepository	기존 이미지 리포지토리를 삭제할 수 있는 권한을 부여합니다.	쓰기	repository*
DeleteRepositoryCreationTemplate	리포지토리 생성 템플릿을 삭제할 수 있는 권한을 부여합니다.	쓰기
DeleteRepositoryPolicy	지정된 리포지토리에서 리포지토리 정책을 삭제할 수 있는 권한을 부여합니다.	권한 관리	repository*
DescribeImageReplicationStatus	복제가 실패한 경우 실패 이유를 포함해 레지스트리 내의 이미지에 대한 복제 상태를 검색할 수 있는 권한을 부여합니다.	Read	repository*
DescribeImageScanFindings	지정된 이미지에 대한 이미지 스캔 결과를 설명할 수 있는 권한을 부여합니다.	Read	repository*
DescribeImages	이미지 크기, 이미지 태그, 생성 날짜를 포함하여 리포지토리의 이미지에 대한 메타데이터를 가져올 수 있는 권한을 부여합니다.	List	repository*
DescribePullThroughCacheRules	풀스루 캐시 규칙을 설명할 수 있는 권한을 부여합니다.	List
DescribeRegistry	레지스트리 설정을 설명하는 권한을 부여합니다.	Read
DescribeRepositories	레지스트리의 이미지 리포지토리를 설명할 수 있는 권한을 부여합니다.	Read	repository*
DescribeRepositoryCreationTemplates	리포지토리 생성 템플릿을 설명할 수 있는 권한을 부여합니다.	Read
GetAccountSetting	계정 설정을 검색할 수 있는 권한을 부여합니다.	Read		ecr:AccountSetting
GetAuthorizationToken	12시간 동안 지정된 레지스트리에 유효한 토큰을 검색할 수 있는 권한을 부여합니다.	Read
GetDownloadUrlForLayer	이미지 계층에 해당하는 다운로드 URL을 검색할 수 있는 권한을 부여합니다.	Read	repository*
GetImageCopyStatus [권한만 해당]	이미지 복사본에 대한 상태를 검색할 수 있는 권한을 부여합니다.	Read	repository*
GetLifecyclePolicy	지정된 수명 주기 정책을 검색할 수 있는 권한을 부여합니다.	Read	repository*
GetLifecyclePolicyPreview	지정된 수명 주기 정책 미리 보기 요청의 결과를 검색할 수 있는 권한을 부여합니다.	Read	repository*
GetRegistryPolicy	레지스트리 정책을 검색할 수 있는 권한을 부여합니다.	Read
GetRegistryScanningConfiguration	레지스트리 검사 구성을 검색할 수 있는 권한을 부여합니다.	Read
GetRepositoryPolicy	지정된 리포지토리에 대한 리포지토리 정책을 검색할 수 있는 권한을 부여합니다.	Read	repository*
InitiateLayerUpload	이미지 계층을 업로드할 예정임을 Amazon ECR에 알릴 수 있는 권한을 부여합니다.	Write	repository*
ListImages	지정된 리포지토리에 대한 모든 이미지 ID를 나열할 수 있는 권한을 부여합니다.	나열	repository*
ListTagsForResource	Amazon ECR 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다.	Read	repository*
ListTagsForResource	Amazon ECR 리소스에 대한 태그를 나열할 수 있는 권한을 부여합니다.	Read		aws:RequestTag/${TagKey} aws:TagKeys
PutAccountSetting	계정 설정을 업데이트할 수 있는 권한을 부여합니다.	쓰기		ecr:AccountSetting
PutImage	이미지와 관련된 이미지 매니페스트를 생성하거나 업데이트할 수 있는 권한을 부여합니다.	Write	repository*
PutImageScanningConfiguration	리포지토리에 대한 이미지 스캔 구성을 업데이트할 수 있는 권한을 부여합니다.	Write	repository*
PutImageTagMutability	리포지토리에 대한 이미지 태그 변경 가능성 설정을 업데이트할 수 있는 권한을 부여합니다.	Write	repository*
PutLifecyclePolicy	수명 주기 정책을 생성하거나 업데이트할 수 있는 권한을 부여합니다.	Write	repository*
PutRegistryPolicy	레지스트리 정책을 업데이트할 수 있는 권한을 부여합니다.	권한 관리
PutRegistryScanningConfiguration	레지스트리 검사 구성을 업데이트할 수 있는 권한을 부여합니다.	쓰기
PutReplicationConfiguration	레지스트리에 대한 복제 구성을 업데이트할 수 있는 권한을 부여합니다.	쓰기			iam:CreateServiceLinkedRole
ReplicateImage [권한만 해당]	대상 레지스트리에 이미지를 복제할 수 있는 권한을 부여합니다.	Write	repository*
SetRepositoryPolicy	지정된 리포지토리에 리포지토리 정책을 적용하여 액세스 권한을 제어할 수 있는 권한을 부여합니다.	권한 관리	repository*
StartImageScan	이미지 스캔을 시작할 수 있는 권한을 부여합니다.	Write	repository*
StartLifecyclePolicyPreview	지정된 수명 주기 정책의 미리 보기를 시작할 수 있는 권한을 부여합니다.	Write	repository*
TagResource	Amazon ECR 리소스에 태그를 지정할 수 있는 권한을 부여합니다.	태그 지정	repository*
TagResource	Amazon ECR 리소스에 태그를 지정할 수 있는 권한을 부여합니다.	태그 지정		aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Amazon ECR 리소스의 태그를 해제할 수 있는 권한을 부여합니다.	태그 지정	repository*
UntagResource	Amazon ECR 리소스의 태그를 해제할 수 있는 권한을 부여합니다.	태그 지정		aws:TagKeys
UpdatePullThroughCacheRule	풀스루 캐시 규칙을 업데이트할 수 있는 권한을 부여합니다.	쓰기
UpdateRepositoryCreationTemplate	리포지토리 생성 템플릿을 업데이트할 수 있는 권한을 부여합니다.	쓰기			ecr:CreateRepository ecr:PutLifecyclePolicy ecr:SetRepositoryPolicy iam:CreateServiceLinkedRole iam:PassRole
UploadLayerPart	Amazon ECR에 이미지 계층 부분을 업로드할 수 있는 권한을 부여합니다.	쓰기	repository*
ValidatePullThroughCacheRule	풀스루 캐시 규칙을 검증할 수 있는 권한을 부여합니다.	Read

Amazon Elastic Container Registry에서 정의한 리소스 유형

이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.

리소스 유형 ARN 조건 키

리소스 유형	ARN	조건 키
repository	`arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}`	aws:ResourceTag/${TagKey} ecr:ResourceTag/${TagKey}

repository

arn:${Partition}:ecr:${Region}:${Account}:repository/${RepositoryName}

aws:ResourceTag/${TagKey}

ecr:ResourceTag/${TagKey}

Amazon Elastic Container Registry에 사용되는 조건 키

Amazon Elastic Container Registry는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.

모든 서비스에서 사용할 수 있는 전역 조건 키를 보려면 AWS 전역 조건 컨텍스트 키를 참조하세요.

조건 키	설명	Type
aws:RequestTag/${TagKey}	각 태그에 허용되는 값 집합을 기준으로 액세스를 필터링합니다.	String
aws:ResourceTag/${TagKey}	리소스와 연결된 태그-값을 기준으로 액세스를 필터링합니다.	String
aws:TagKeys	요청에 필수 태그가 있는지 여부를 기준으로 액세스를 필터링합니다.	ArrayOfString
ecr:AccountSetting	ECR 계정 설정 이름을 기준으로 액세스를 필터링합니다.	String
ecr:ResourceTag/${TagKey}	리소스와 연결된 태그-값을 기준으로 액세스를 필터링합니다.	String

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

Amazon Elastic Block Store

Amazon Elastic Container Registry Public