aws:copyImage - Amazon Machine Image 복사 또는 암호화 - AWS Systems Manager

aws:copyImage - Amazon Machine Image 복사 또는 암호화

모든 AWS 리전의 Amazon Machine Image(AMI)를 현재 리전에 복사합니다. 이 작업은 새 AMI를 암호화할 수도 있습니다.

참고

aws:copyImage 작업은 자동 스로틀링 재시도를 지원합니다. 자세한 정보는 스로틀링된 작업에 대한 자동 재시도 구성 섹션을 참조하세요.

입력

이 작업은 대부분의 CopyImage 파라미터를 지원합니다. 자세한 내용은 CopyImage를 참조하세요.

다음 예에서는 서울 리전의 AMI 복사본을 생성합니다(SourceImageID: ami-0fe10819. SourceRegion: ap-northeast-2). 새 AMI가 Automation 작업을 시작한 리전에 복사됩니다. Encrypted 플래그(옵션)가 true로 설정되어 있으므로 복사한 AMI가 암호화됩니다.

YAML
name: createEncryptedCopy
action: aws:copyImage
maxAttempts: 3
onFailure: Abort
inputs:
  SourceImageId: ami-0fe10819
  SourceRegion: ap-northeast-2
  ImageName: Encrypted Copy of LAMP base AMI in ap-northeast-2
  Encrypted: true
JSON
{   
    "name": "createEncryptedCopy",
    "action": "aws:copyImage",
    "maxAttempts": 3,
    "onFailure": "Abort",
    "inputs": {
        "SourceImageId": "ami-0fe10819",
        "SourceRegion": "ap-northeast-2",
        "ImageName": "Encrypted Copy of LAMP base AMI in ap-northeast-2",
        "Encrypted": true
    }   
}
SourceRegion

원본 AMI가 존재하는 리전입니다.

유형: 문자열

필수 여부: 예

SourceImageId

원본 리전에서 복사할 AMI ID입니다.

유형: 문자열

필수 여부: 예

ImageName

새 이미지의 이름입니다.

유형: 문자열

필수 여부: 예

ImageDescription

대상 이미지에 대한 설명입니다.

유형: 문자열

필수 여부: 아니요

Encrypted

대상 AMI를 암호화합니다.

유형: 부울

필수 여부: 아니요

KmsKeyId

복사 작업 중에 이미지의 스냅샷을 암호화할 때 사용할 AWS KMS key의 전체 Amazon 리소스 이름(ARN)입니다. 자세한 내용은 CopyImage를 참조하세요.

유형: 문자열

필수 여부: 아니요

ClientToken

요청 멱등성을 보장하기 위해 제공하는 고유의 대/소문자 구분 식별자입니다. 자세한 내용은 CopyImage를 참조하세요.

유형: 문자열

필수 여부: 아니요

출력
ImageId

복사한 이미지의 ID입니다.

ImageState

복사한 이미지의 상태입니다.

유효한 값: available | pending | failed