기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 |
iam:CreateServiceLinkedRole imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext |
||
CreateContainerRecipe | 새 컨테이너 레시피를 생성할 수 있는 권한을 부여합니다. | Write |
ecr:DescribeImages ecr:DescribeRepositories iam:CreateServiceLinkedRole imagebuilder:GetComponent imagebuilder:GetImage imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext |
||
CreateDistributionConfiguration | 새 배포 구성을 생성할 수 있는 권한을 부여합니다. | Write |
iam:CreateServiceLinkedRole imagebuilder:TagResource |
||
CreateImage | 새 이미지를 생성할 수 있는 권한을 부여합니다. | Write |
iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow imagebuilder:TagResource |
||
CreateImagePipeline | 새 이미지 파이프라인을 생성할 수 있는 권한을 부여합니다. | Write |
iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow imagebuilder:TagResource |
||
CreateImageRecipe | 새 이미지 레시피를 생성할 수 있는 권한을 부여합니다. | Write |
ec2:DescribeImages iam:CreateServiceLinkedRole imagebuilder:GetComponent imagebuilder:GetImage imagebuilder:TagResource |
||
CreateInfrastructureConfiguration | 새 인프라 구성을 생성할 수 있는 권한을 부여합니다. | 쓰기 |
imagebuilder:CreatedResourceTagKeys imagebuilder:CreatedResourceTag/<key> |
iam:CreateServiceLinkedRole iam:PassRole imagebuilder:TagResource sns:Publish |
|
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 | 인프라 구성에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | 읽기 | |||
GetLifecycleExecution | 수명 주기 실행에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | 읽기 | |||
GetLifecyclePolicy | 수명 주기 정책에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | 읽기 | |||
GetWorkflow | 워크플로에 대한 세부 정보를 볼 수 있는 권한 부여 | 읽기 |
kms:Decrypt |
||
GetWorkflowExecution | 워크플로 실행에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | 읽기 | |||
GetWorkflowStepExecution | 워크플로 단계 실행에 대한 세부 정보를 볼 수 있는 권한을 부여합니다. | 읽기 | |||
ImportComponent | 새 구성 요소를 가져올 수 있는 권한을 부여합니다. | 쓰기 |
iam:CreateServiceLinkedRole imagebuilder:TagResource kms:Encrypt kms:GenerateDataKey kms:GenerateDataKeyWithoutPlaintext |
||
ImportVmImage | 이미지를 가져올 수 있는 권한을 부여합니다. | 쓰기 |
ec2:DescribeImages ec2:DescribeImportImageTasks iam:CreateServiceLinkedRole |
||
ListComponentBuildVersions | 계정의 구성 요소 빌드 버전을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListComponents | 계정에서 소유하거나 계정과 공유하는 구성 요소 버전을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListContainerRecipes | 계정에서 소유하거나 계정과 공유하는 컨테이너 레시피를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListDistributionConfigurations | 계정의 배포 구성을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListImageBuildVersions | 계정의 이미지 빌드 버전을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListImagePackages | 지정된 이미지에 설치된 패키지 목록을 반환할 수 있는 권한을 부여합니다. | 나열 | |||
ListImagePipelineImages | 지정된 파이프라인에 의해 생성된 이미지 목록을 반환할 수 있는 권한을 부여합니다. | 나열 | |||
ListImagePipelines | 계정의 이미지 파이프라인을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListImageRecipes | 계정에서 소유하거나 계정과 공유하는 이미지 레시피를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListImageScanFindingAggregations | 계정의 이미지 스캔 결과에 대한 집계를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListImageScanFindings | 계정의 이미지에 대한 이미지 스캔 결과를 나열할 수 있는 권한을 부여합니다. | 나열 |
inspector2:ListFindings |
||
ListImages | 계정에서 소유하거나 계정과 공유하는 이미지 버전을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListInfrastructureConfigurations | 계정의 인프라 구성을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListLifecycleExecutionResources | 지정된 수명 주기 실행에 대한 리소스를 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListLifecycleExecutions | 지정된 리소스에 대한 수명 주기 실행을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListLifecyclePolicies | 계정의 수명 주기 정책을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListTagsForResource | Image Builder 리소스의 태그를 나열할 수 있는 권한을 부여합니다. | 읽기 | |||
ListWaitingWorkflowSteps | 호출자 계정에 대기 중인 워크플로 단계를 나열할 수 있는 권한 부여 | 나열 | |||
ListWorkflowBuildVersions | 계정의 워크플로 빌드 버전을 나열할 수 있는 권한 부여 | 나열 | |||
ListWorkflowExecutions | 지정된 이미지에 대한 워크플로 실행을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListWorkflowStepExecutions | 지정된 워크플로에 대한 워크플로 단계 실행을 나열할 수 있는 권한을 부여합니다. | 나열 | |||
ListWorkflows | 계정에서 소유하거나 계정과 공유하는 워크플로 버전을 나열할 수 있는 권한 부여 | 나열 | |||
PutComponentPolicy | 구성 요소에 연결된 리소스 정책을 설정할 수 있는 권한을 부여합니다. | 권한 관리 | |||
PutContainerRecipePolicy | 컨테이너 레시피에 연결된 리소스 정책을 설정할 수 있는 권한을 부여합니다. | 권한 관리 | |||
PutImagePolicy | 이미지에 연결된 리소스 정책을 설정할 수 있는 권한을 부여합니다. | 권한 관리 | |||
PutImageRecipePolicy | 이미지 레시피에 연결된 리소스 정책을 설정할 수 있는 권한을 부여합니다. | 권한 관리 | |||
SendWorkflowStepAction | 워크플로 단계에 작업을 보낼 수 있는 권한 부여 | 쓰기 | |||
StartImagePipelineExecution | 파이프라인에서 새 이미지를 생성할 수 있는 권한을 부여합니다. | 쓰기 |
iam:CreateServiceLinkedRole imagebuilder:GetImagePipeline |
||
StartResourceStateUpdate | 지정된 리소스에 대한 상태 업데이트를 시작할 수 있는 권한을 부여합니다. | 쓰기 | |||
TagResource | Image Builder 리소스에 태그를 지정할 수 있는 권한을 부여합니다. | 태그 지정 | |||
UntagResource | Image Builder 리소스의 태그를 해제할 수 있는 권한을 부여합니다. | 태그 지정 | |||
UpdateDistributionConfiguration | 기존 배포 구성을 업데이트할 수 있는 권한을 부여합니다. | Write | |||
UpdateImagePipeline | 기존 이미지 파이프라인을 업데이트할 수 있는 권한을 부여합니다. | Write |
iam:CreateServiceLinkedRole iam:PassRole imagebuilder:GetContainerRecipe imagebuilder:GetDistributionConfiguration imagebuilder:GetImageRecipe imagebuilder:GetInfrastructureConfiguration imagebuilder:GetWorkflow |
||
UpdateInfrastructureConfiguration | 기존 인프라 구성을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
imagebuilder:CreatedResourceTagKeys imagebuilder:CreatedResourceTag/<key> |
iam:PassRole sns:Publish |
|
UpdateLifecyclePolicy | 기존 수명 주기 정책을 업데이트할 수 있는 권한을 부여합니다. | 쓰기 |
iam:PassRole |
Amazon EC2 Image Builder에서 정의한 리소스 유형
이 서비스에서 정의하는 리소스 유형은 다음과 같으며, IAM 권한 정책 설명의 Resource
요소에서 사용할 수 있습니다. 작업 테이블의 각 작업에서 해당 작업으로 지정할 수 있는 리소스 유형을 식별합니다. 리소스 유형은 정책에 포함할 조건 키를 정의할 수도 있습니다. 이러한 키는 리소스 유형 테이블의 마지막 열에 표시됩니다. 다음 테이블의 열에 관한 자세한 내용은 리소스 유형 테이블을 참조하세요.
리소스 유형 | ARN | 조건 키 |
---|---|---|
component |
arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}/${ComponentBuildVersion}
|
|
componentVersion |
arn:${Partition}:imagebuilder:${Region}:${Account}:component/${ComponentName}/${ComponentVersion}
|
|
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}
|
|
kmsKey |
arn:${Partition}:kms:${Region}:${Account}:key/${KeyId}
|
|
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}
|
|
workflowVersion |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow/${WorkflowType}/${WorkflowName}/${WorkflowVersion}
|
|
workflowExecution |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow-execution/${WorkflowExecutionId}
|
|
workflowStepExecution |
arn:${Partition}:imagebuilder:${Region}:${Account}:workflow-step-execution/${WorkflowStepExecutionId}
|
Amazon EC2 Image Builder에 사용되는 조건 키
Amazon EC2 Image Builder는 IAM 정책의 Condition
요소에 사용할 수 있는 다음과 같은 조건 키를 정의합니다. 이러한 키를 사용하여 정책 설명이 적용되는 조건을 보다 상세하게 설정할 수 있습니다. 다음 테이블의 열에 대한 자세한 내용은 조건 키 테이블을 참조하세요.
모든 서비스에 사용할 수 있는 글로벌 조건 키를 보려면 사용 가능한 글로벌 조건 키를 참조하세요.
조건 키 | 설명 | 유형 |
---|---|---|
aws:RequestTag/${TagKey} | 요청에 태그 키-값 페어가 있는지 여부를 기준으로 액세스를 필터링합니다. | String |
aws:ResourceTag/${TagKey} | 리소스에 연결된 태그 키-값 페어를 기준으로 액세스를 필터링합니다. | String |
aws:TagKeys | 요청에 태그 키가 있는지 여부를 기준으로 액세스를 필터링합니다. | ArrayOfString |
imagebuilder:CreatedResourceTag/<key> | Image Builder에서 생성된 리소스에 연결된 태그 키-값 페어로 액세스 필터링 | 문자열 |
imagebuilder:CreatedResourceTagKeys | 요청에 태그 키가 있는지 여부를 기준으로 액세스를 필터링합니다. | ArrayOfString |
imagebuilder:Ec2MetadataHttpTokens | 요청에 지정된 EC2 인스턴스 메타데이터 HTTP 토큰 요구 사항을 기준으로 액세스를 필터링합니다. | String |
imagebuilder:LifecyclePolicyResourceType | 요청에 지정된 수명 주기 정책 리소스 유형을 기준으로 액세스를 필터링합니다. | String |
imagebuilder:StatusTopicArn | 터미널 상태 알림을 게시하는 요청에서 SNS Topic Arn을 기준으로 액세스를 필터링합니다. | ARN |