HEX
Server: Apache
System: Linux pdx1-shared-a1-38 6.6.104-grsec-jammy+ #3 SMP Tue Sep 16 00:28:11 UTC 2025 x86_64
User: mmickelson (3396398)
PHP: 8.1.31
Disabled: NONE
Upload Files
File: //usr/share/doc/awscli/examples/ec2/create-replace-root-volume-task.rst
**Example 1: To restore the root volume to its initial state**

The following ``create-replace-root-volume-task`` example restores the root volume of the specified instance to its initial state. ::

    aws ec2 create-replace-root-volume-task \
        --instance-id i-1234567890abcdef0

Output::

    {
        "ReplaceRootVolumeTask": {
            "ReplaceRootVolumeTaskId": "replacevol-05efec875b94ae34d",
            "InstanceId": "i-1234567890abcdef0
            "TaskState": "pending",
            "StartTime": "2021-09-16T00:19:30Z",
            "Tags": []
        }
    }

For more information, see `Replace an Amazon EBS volume <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html>`__ in the *Amazon EC2 User Guide*.

**Example 2: To restore the root volume to a specific snapshot**

The following ``create-replace-root-volume-task`` example replaces the root volume of the specified instance with the specified snapshot. ::

    aws ec2 create-replace-root-volume-task \
        --instance-id i-1234567890abcdef0 \
        --snapshot-id snap-9876543210abcdef0

Output::

    {
        "ReplaceRootVolumeTask": {
            "ReplaceRootVolumeTaskId": "replacevol-05efec875b94ae34d",
            "InstanceId": "i-1234567890abcdef0
            "TaskState": "pending",
            "StartTime": "2021-09-16T00:19:30Z",
            "Tags": []
        }
    }

For more information, see `Replace an Amazon EBS volume <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html>`__ in the *Amazon EC2 User Guide*.