기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon EC2 Image Builder에 사용되는 작업, 리소스 및 조건 키
Amazon EC2 Image Builder(서비스 접두사: imagebuilder)는 IAM 권한 정책에 사용할 수 있는 다음과 같은 서비스별 리소스, 작업 및 조건 컨텍스트 키를 제공합니다.
참조:
-
이 서비스를 구성하는 방법을 알아봅니다.
-
이 서비스에 사용 가능한 API 작업의 목록을 봅니다.
-
IAM 권한 정책을 사용하여 이 서비스와 리소스를 보호하는 방법을 알아봅니다.
주제
Amazon EC2 Image Builder에서 정의한 작업
IAM 정책 설명의 Action 요소에서는 다음 작업을 지정할 수 있습니다. 정책을 사용하여 AWS에서 작업할 수 있는 권한을 부여합니다. 정책에서 작업을 사용하면 일반적으로 이름이 같은 API 작업 또는 CLI 명령에 대한 액세스를 허용하거나 거부합니다. 그러나 경우에 따라 하나의 작업으로 둘 이상의 작업에 대한 액세스가 제어됩니다. 또는 일부 작업을 수행하려면 다양한 작업이 필요합니다.
작업 테이블의 액세스 수준 열은 작업이 분류되는 방법(목록, 읽기, 권한 관리 또는 태그 지정)을 설명합니다. 이 분류는 정책에서 사용하는 작업이 부여하는 액세스 레벨을 이해하는 데 도움이 될 수 있습니다. 액세스 수준에 대한 자세한 내용은 정책 요약의 액세스 수준을 참조하세요.
작업 테이블의 리소스 유형 열에는 각 작업이 리소스 수준 권한을 지원하는지 여부가 표시됩니다. 리소스 열에 값이 없으면 정책 문의 Resource 요소에서 정책이 적용되는 모든 리소스("*")를 지정해야 합니다. 리소스 열에 리소스 유형이 포함되어 있으면 해당 작업 시 문에서 해당 유형의 ARN을 지정할 수 있습니다. 작업에 필요한 리소스가 하나 이상 있는 경우, 호출자에게 해당 리소스와 함께 작업을 사용할 수 있는 권한이 있어야 합니다. 필수 리소스는 테이블에서 별표(*)로 표시됩니다. IAM 정책의 Resource 요소로 리소스 액세스를 제한하는 경우, 각 필수 리소스 유형에 대해 ARN 또는 패턴을 포함해야 합니다. 일부 작업은 다수의 리소스 유형을 지원합니다. 리소스 유형이 옵션(필수 리소스로 표시되지 않은 경우)인 경우에는 선택적 리소스 유형 중 하나를 사용하도록 선택할 수 있습니다.
작업 테이블의 조건 키 열에는 정책 설명의 Condition 요소에서 지정할 수 있는 키가 포함됩니다. 서비스의 리소스와 연결된 조건 키에 대한 자세한 내용은 리소스 유형 테이블의 조건 키 열을 참조하세요.
작업 테이블의 종속 작업 열에는 작업을 성공적으로 호출하는 데 필요할 수 있는 추가 권한이 표시됩니다. 작업 자체에 대한 권한 외에 이러한 권한이 필요할 수 있습니다. 작업이 종속 작업을 지정하는 경우 해당 종속성은 테이블에 나열된 첫 번째 리소스뿐만 아니라 해당 작업에 정의된 추가 리소스에도 적용될 수 있습니다.
참고
리소스 조건 키는 리소스 유형 표에 나열되어 있습니다. 작업에 적용되는 리소스 유형에 대한 링크는 리소스 유형(*필수) 작업 표의 열에서 찾을 수 있습니다. 리소스 유형 테이블의 리소스 유형에는 조건 키 열이 포함되고 이는 작업 표의 작업에 적용되는 리소스 조건 키입니다.
다음 테이블의 열에 대한 자세한 내용은 작업 테이블을 참조하세요.
| 작업 | 설명 | 액세스 레벨 | 리소스 유형(*필수) | 조건 키 | 종속 작업 |
|---|---|---|---|---|---|
| CancelImageCreation | 이미지 생성을 취소할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CancelLifecycleExecution | 수명 주기 실행을 취소할 수 있는 권한을 부여합니다. | 쓰기 | |||
| CreateComponent | 새 구성 요소를 생성할 수 있는 권한을 부여합니다. | Write |
imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext s3:GetObject s3:ListBucket |
||
| CreateContainerRecipe | 새 컨테이너 레시피를 생성할 수 있는 권한을 부여합니다. | Write |
ec2:DescribeImages ecr:DescribeImages ecr:DescribeRepositories imagebuilder:GetComponent imagebuilder:GetImage imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext s3:GetObject s3:ListBucket ssm:GetParameter |
||
| CreateDistributionConfiguration | 새 배포 구성을 생성할 수 있는 권한을 부여합니다. | Write |
ec2:CreateLaunchTemplateVersion ec2:DescribeLaunchTemplates ec2:ModifyLaunchTemplate imagebuilder:TagResource s3:ListBucket ssm:GetParameter |
||
| CreateImage | 새 이미지를 생성할 수 있는 권한을 부여합니다. | Write |
ecr:BatchGetRepositoryScanningConfiguration ecr:DescribeRepositories iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow imagebuilder:TagResource inspector2:BatchGetAccountStatus |
||
| CreateImagePipeline | 새 이미지 파이프라인을 생성할 수 있는 권한을 부여합니다. | Write |
ecr:BatchGetRepositoryScanningConfiguration ecr:DescribeRepositories iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow imagebuilder:TagResource inspector2:BatchGetAccountStatus |
||
| CreateImageRecipe | 새 이미지 레시피를 생성할 수 있는 권한을 부여합니다. | Write |
ec2:DescribeImages imagebuilder:GetComponent imagebuilder:GetImage imagebuilder:TagResource ssm:GetParameter |
||
| CreateInfrastructureConfiguration | 새 인프라 구성을 생성할 수 있는 권한을 부여합니다. | 쓰기 |
ec2:DescribeAvailabilityZones ec2:DescribeHosts iam:PassRole imagebuilder:TagResource resource-groups:GetGroup sns:Publish |
||
|
imagebuilder:CreatedResourceTagKeys imagebuilder:CreatedResourceTag/${TagKey} |
|||||
| CreateLifecyclePolicy | 새 수명 주기 정책을 생성할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole imagebuilder:TagResource |
||
| CreateWorkflow | 새 워크플로를 생성할 수 있는 권한 부여 | 쓰기 |
imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext s3:GetObject s3:ListBucket |
||
| DeleteComponent | 구성 요소를 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteContainerRecipe | 컨테이너 레시피를 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteDistributionConfiguration | 배포 구성을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteImage | 이미지를 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteImagePipeline | 이미지 파이프라인을 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteImageRecipe | 이미지 레시피를 삭제할 수 있는 권한을 부여합니다. | Write | |||
| DeleteInfrastructureConfiguration | 인프라 구성을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteLifecyclePolicy | 수명 주기 정책을 삭제할 수 있는 권한을 부여합니다. | 쓰기 | |||
| DeleteWorkflow | 워크플로우를 삭제할 권한을 부여합니다. | 쓰기 | |||
| GetComponent | 구성 요소에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read |
kms:Decrypt |
||
| GetComponentPolicy | 구성 요소에 연결된 리소스 정책을 볼 수 있는 권한을 부여합니다. | Read | |||
| GetContainerRecipe | 컨테이너 레시피에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read | |||
| GetContainerRecipePolicy | 컨테이너 레시피에 연결된 리소스 정책을 볼 수 있는 권한을 부여합니다. | Read | |||
| GetDistributionConfiguration | 배포 구성에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read | |||
| GetImage | 이미지에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read | |||
| GetImagePipeline | 이미지 파이프라인에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read | |||
| GetImagePolicy | 이미지에 연결된 리소스 정책을 볼 수 있는 권한을 부여합니다. | Read | |||
| GetImageRecipe | 이미지 레시피에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read | |||
| GetImageRecipePolicy | 이미지 레시피에 연결된 리소스 정책을 볼 수 있는 권한을 부여합니다. | Read | |||
| GetInfrastructureConfiguration | 인프라 구성에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read | |||
| GetLifecycleExecution | 수명 주기 실행에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read | |||
| GetLifecyclePolicy | 수명 주기 정책에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read | |||
| GetMarketplaceResource | Marketplace 제공 리소스를 검색할 수 있는 권한을 부여합니다. | Read | |||
| GetWorkflow | 워크플로에 대한 세부 정보를 볼 수 있는 권한 부여 | Read |
kms:Decrypt |
||
| GetWorkflowExecution | 워크플로 실행에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read | |||
| GetWorkflowStepExecution | 워크플로 단계 실행에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | Read |
kms:Decrypt |
||
| ImportComponent | 새 구성 요소를 가져올 수 있는 권한을 부여합니다. | 쓰기 |
imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext s3:GetObject s3:ListBucket |
||
| ImportDiskImage | 디스크 이미지를 가져올 수 있는 권한을 부여합니다. | 쓰기 |
iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow imagebuilder:TagResource s3:GetObject s3:ListBucket |
||
| ImportVmImage | 이미지를 가져올 수 있는 권한을 부여합니다. | 쓰기 |
ec2:DescribeImages ec2:DescribeImportImageTasks iam:CreateServiceLinkedRole imagebuilder:TagResource |
||
| ListComponentBuildVersions | 계정의 구성 요소 빌드 버전을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListComponents | 계정에서 소유하거나 계정과 공유하는 구성 요소 버전을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListContainerRecipes | 계정에서 소유하거나 계정과 공유하는 컨테이너 레시피를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListDistributionConfigurations | 계정의 배포 구성을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListImageBuildVersions | 계정의 이미지 빌드 버전을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListImagePackages | 지정된 이미지에 설치된 패키지 목록을 반환할 수 있는 권한을 부여합니다. | List | |||
| ListImagePipelineImages | 지정된 파이프라인에 의해 생성된 이미지 목록을 반환할 수 있는 권한을 부여합니다. | List | |||
| ListImagePipelines | 계정의 이미지 파이프라인을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListImageRecipes | 계정에서 소유하거나 계정과 공유하는 이미지 레시피를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListImageScanFindingAggregations | 계정의 이미지 스캔 결과에 대한 집계를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListImageScanFindings | 계정의 이미지에 대한 이미지 스캔 결과를 나열할 수 있는 권한을 부여합니다. | List |
inspector2:ListFindings |
||
| ListImages | 계정에서 소유하거나 계정과 공유하는 이미지 버전을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
| ListInfrastructureConfigurations | 계정의 인프라 구성을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListLifecycleExecutionResources | 지정된 수명 주기 실행에 대한 리소스를 나열할 수 있는 권한을 부여합니다. | List | |||
| ListLifecycleExecutions | 지정된 리소스에 대한 수명 주기 실행을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListLifecyclePolicies | 계정의 수명 주기 정책을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListTagsForResource | Image Builder 리소스의 태그를 나열할 수 있는 권한을 부여합니다. | Read | |||
| ListWaitingWorkflowSteps | 호출자 계정에 대기 중인 워크플로 단계를 나열할 수 있는 권한 부여 | List | |||
| ListWorkflowBuildVersions | 계정의 워크플로 빌드 버전을 나열할 수 있는 권한 부여 | List | |||
| ListWorkflowExecutions | 지정된 이미지에 대한 워크플로 실행을 나열할 수 있는 권한을 부여합니다. | List | |||
| ListWorkflowStepExecutions | 지정된 워크플로에 대한 워크플로 단계 실행을 나열할 수 있는 권한을 부여합니다. | List |
kms:Decrypt |
||
| ListWorkflows | 계정에서 소유하거나 계정과 공유하는 워크플로 버전을 나열할 수 있는 권한 부여 | List | |||
| PutComponentPolicy | 구성 요소에 연결된 리소스 정책을 설정할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| PutContainerRecipePolicy | 컨테이너 레시피에 연결된 리소스 정책을 설정할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| PutImagePolicy | 이미지에 연결된 리소스 정책을 설정할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| PutImageRecipePolicy | 이미지 레시피에 연결된 리소스 정책을 설정할 수 있는 권한을 부여합니다. | 권한 관리 | |||
| SendWorkflowStepAction | 워크플로 단계에 작업을 보낼 수 있는 권한 부여 | 쓰기 | |||
| StartImagePipelineExecution | 파이프라인에서 새 이미지를 생성할 수 있는 권한을 부여합니다. | 쓰기 |
iam:CreateServiceLinkedRole imagebuilder:GetImagePipeline imagebuilder:TagResource |
||
| StartResourceStateUpdate | 지정된 리소스에 대한 상태 업데이트를 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
| TagResource | Image Builder 리소스에 태그를 지정할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UntagResource | Image Builder 리소스의 태그를 해제할 수 있는 권한을 부여합니다. | 태그 지정 | |||
| UpdateDistributionConfiguration | 기존 배포 구성을 업데이트할 수 있는 권한을 부여합니다. | Write |
ec2:CreateLaunchTemplateVersion ec2:DescribeLaunchTemplates ec2:ModifyLaunchTemplate s3:ListBucket ssm:GetParameter |
||
| UpdateImagePipeline | 기존 이미지 파이프라인을 업데이트할 수 있는 권한을 부여합니다. | Write |
ecr:BatchGetRepositoryScanningConfiguration ecr:DescribeRepositories iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow inspector2:BatchGetAccountStatus |
||
| UpdateInfrastructureConfiguration | 기존 인프라 구성을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
ec2:DescribeAvailabilityZones ec2:DescribeHosts iam:PassRole resource-groups:GetGroup sns:Publish |
||
|
imagebuilder:CreatedResourceTagKeys imagebuilder:CreatedResourceTag/${TagKey} |
|||||
| UpdateLifecyclePolicy | 기존 수명 주기 정책을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
||
Amazon EC2 Image Builder에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource 요소에서 사용할 수 있습니다. 작업 테이블의 각 작업은 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
| 리소스 유형 | ARN | 조건 키 |
|---|---|---|
| component |
arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}/${ComponentBuildVersion}
|
|
| distributionConfiguration |
arn:${Partition}:imagebuilder:${Region}:${Account}:distribution-configuration/${DistributionConfigurationName}
|
|
| image |
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}/${ImageBuildVersion}
|
|
| imageVersion |
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}
|
|
| imageRecipe |
arn:${Partition}:imagebuilder:${Region}:${Account}:image-recipe/${ImageRecipeName}/${ImageRecipeVersion}
|
|
| containerRecipe |
arn:${Partition}:imagebuilder:${Region}:${Account}:container-recipe/${ContainerRecipeName}/${ContainerRecipeVersion}
|
|
| imagePipeline |
arn:${Partition}:imagebuilder:${Region}:${Account}:image-pipeline/${ImagePipelineName}
|
|
| infrastructureConfiguration |
arn:${Partition}:imagebuilder:${Region}:${Account}:infrastructure-configuration/${ResourceId}
|
|
| lifecycleExecution |
arn:${Partition}:imagebuilder:${Region}:${Account}:lifecycle-execution/${LifecycleExecutionId}
|
|
| lifecyclePolicy |
arn:${Partition}:imagebuilder:${Region}:${Account}:lifecycle-policy/${LifecyclePolicyName}
|
|
| workflow |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow/${WorkflowType}/${WorkflowName}/${WorkflowVersion}/${WorkflowBuildVersion}
|
|
| workflowExecution |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow-execution/${WorkflowExecutionId}
|
|
| workflowStepExecution |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow-step-execution/${WorkflowStepExecutionId}
|
|
| allComponentBuildVersions |
arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}/*
|
|
| allImageBuildVersions |
arn:${Partition}:imagebuilder:${Region}:${Account}:image/${ImageName}/${ImageVersion}/*
|
|
| allWorkflowBuildVersions |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow/${WorkflowType}/${WorkflowName}/${WorkflowVersion}/*
|
Amazon EC2 Image Builder에 사용되는 조건 키
Amazon EC2 Image Builder는 IAM 정책의 Condition 요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에서 사용할 수 있는 전역 조건 키를 보려면 AWS 전역 조건 컨텍스트 키를 참조하세요.
| 조건 키 | 설명 | 형식 |
|---|---|---|
| aws:RequestTag/${TagKey} | 요청에 태그 키-값 페어가 있는지 여부를 기준으로 액세스를 필터링합니다. | String |
| aws:ResourceTag/${TagKey} | 리소스에 연결된 태그 키-값 페어를 기준으로 액세스를 필터링합니다. | String |
| aws:TagKeys | 요청에 태그 키가 있는지 여부를 기준으로 액세스를 필터링합니다. | ArrayOfString |
| imagebuilder:CreatedResourceTag/${TagKey} | Image Builder에서 생성된 리소스에 연결된 태그 키-값 페어로 액세스 필터링 | 문자열 |
| imagebuilder:CreatedResourceTagKeys | 요청에 태그 키가 있는지 여부를 기준으로 액세스를 필터링합니다. | ArrayOfString |
| imagebuilder:Ec2MetadataHttpTokens | 요청에 지정된 EC2 인스턴스 메타데이터 HTTP 토큰 요구 사항을 기준으로 액세스를 필터링합니다. | String |
| imagebuilder:LifecyclePolicyResourceType | 요청에 지정된 수명 주기 정책 리소스 유형을 기준으로 액세스를 필터링합니다. | String |
| imagebuilder:StatusTopicArn | 터미널 상태 알림을 게시하는 요청에서 SNS Topic Arn을 기준으로 액세스를 필터링합니다. | ARN |
