HEX
Server: Apache
System: Linux vps-cdc32557.vps.ovh.ca 5.15.0-156-generic #166-Ubuntu SMP Sat Aug 9 00:02:46 UTC 2025 x86_64
User: hanode (1017)
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: //lib/python3/dist-packages/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*.