aws:copyImage – 複製或加密 Amazon Machine Image

從任何 AWS 區域 複製 Amazon Machine Image (AMI) 到目前的區域。此動作也可以加密新的 AMI。

Input

此動作支援大部分的 CopyImage 參數。如需詳細資訊，請參閱 CopyImage。

以下範例是在首爾區域建立 AMI 的複本 (SourceImageID: ami-0fe10819. SourceRegion: ap-northeast-2)。新 AMI 已複製到您啟動自動化動作的區域。由於選用的 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 Resource Name (ARN)。如需詳細資訊，請參閱 CopyImage。

類型：字串

必要：否

ClientToken

唯一且區分大小寫的識別符，由您提供以確保請求的冪等。如需詳細資訊，請參閱 CopyImage。

類型：字串

必要：否

輸出

ImageId

所複製映像的 ID。

ImageState

所複製映像的狀態。

有效值：available | pending | failed