• AWS Systems Manager CloudWatch ダッシュボードは、2026 年 4 月 30 日以降は利用できなくなります。お客様は、これまでと同様に Amazon CloudWatch コンソールを使用して、Amazon CloudWatch ダッシュボードの表示、作成、管理を継続できます。詳細については、「[Amazon CloudWatch ダッシュボードのドキュメント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)」を参照してください。

# `aws:copyImage` — Amazon Machine Image のコピーまたは暗号化
<a name="automation-action-copyimage"></a>

任意の AWS リージョン から現在のリージョンに Amazon Machine Image (AMI) をコピーします。このアクションでは、新しい AMI を暗号化することもできます。

**注記**  
`aws:copyImage` アクションは、自動スロットリング再試行をサポートしています。詳細については、「[スロットリングされたオペレーションの自動再試行の設定](automation-throttling-retry.md)」を参照してください。

**Input**  
このアクションでは、ほとんどの `CopyImage` パラメータがサポートされています。詳細については、「[CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CopyImage.html)」を参照してください。

次の例では、ソウルリージョンで 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  
ターゲットイメージの説明。  
型: 文字列  
必須: いいえ

暗号化された  
ターゲット AMI を暗号化します。  
タイプ: ブール値  
必須: いいえ

KmsKeyId  
コピーオペレーション中にイメージのスナップショットを暗号化するときに使用する AWS KMS key の Amazon リソースネーム (ARN)。詳細については、「[CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/api_copyimage.html)」を参照してください。  
型: 文字列  
必須: いいえ

ClientToken  
リクエストのべき等のために割り当てる一意の識別子 (大文字と小文字を区別)。詳細については、「[CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/api_copyimage.html)」を参照してください。  
型: 文字列  
必須: いいえOutput

ImageId  
コピーされたイメージの ID。

ImageState  
コピーされたイメージの状態。  
有効な値: `available` \$1 `pending` \$1 `failed`