HEX
Server: Apache/2.4.41 (Ubuntu)
System: Linux ip-172-31-42-149 5.15.0-1084-aws #91~20.04.1-Ubuntu SMP Fri May 2 07:00:04 UTC 2025 aarch64
User: ubuntu (1000)
PHP: 7.4.33
Disabled: pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare,
Upload Files
File: //usr/local/aws-cli/v2/current/dist/awscli/examples/ec2/copy-image.rst
**Example 1: To copy an AMI to another Region**

The following ``copy-image`` example command copies the specified AMI from the ``us-west-2`` Region to the ``us-east-1`` Region and adds a short description. ::

    aws ec2 copy-image \
        --region us-east-1 \
        --name ami-name \
        --source-region us-west-2 \
        --source-image-id ami-066877671789bd71b \
        --description "This is my copied image."

Output::

    {
        "ImageId": "ami-0123456789abcdefg"
    }

For more information, see `Copy an AMI <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html>`__ in the *Amazon EC2 User Guide*.

**Example 2: To copy an AMI to another Region and encrypt the backing snapshot**

The following ``copy-image`` command copies the specified AMI from the ``us-west-2`` Region to the current Region and encrypts the backing snapshot using the specified KMS key. ::

    aws ec2 copy-image \
        --source-region us-west-2 \
        --name ami-name \
        --source-image-id ami-066877671789bd71b \
        --encrypted \
        --kms-key-id alias/my-kms-key

Output::

    {
        "ImageId": "ami-0123456789abcdefg"
    }

For more information, see `Copy an AMI <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html>`__ in the *Amazon EC2 User Guide*.

**Example 3: To include your user-defined AMI tags when copying an AMI**

The following ``copy-image`` command uses the ``--copy-image-tags`` parameter to copy your user-defined AMI tags when copying the AMI. ::

    aws ec2 copy-image \
        --region us-east-1 \
        --name ami-name \
        --source-region us-west-2 \
        --source-image-id ami-066877671789bd71b \
        --description "This is my copied image."
        --copy-image-tags

Output::

    {
        "ImageId": "ami-0123456789abcdefg"
    }

For more information, see `Copy an AMI <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/CopyingAMIs.html>`__ in the *Amazon EC2 User Guide*.