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/dist/awscli/examples/ec2/create-replace-root-volume-task.rst
**Example 1: To restore a root volume to its initial launch state**

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

    aws ec2 create-replace-root-volume-task \
        --instance-id i-0123456789abcdefa

Output::

    {
        "ReplaceRootVolumeTask": 
        {
            "InstanceId": "i-0123456789abcdefa", 
                "ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd", 
                "TaskState": "pending", 
                "StartTime": "2022-03-14T15:06:38Z", 
                "Tags": []
        }
    }

For more information, see `Replace a root volume <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html#replace-root>`__ in the *Amazon Elastic Compute Cloud User Guide*.

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

The following ``create-replace-root-volume-task`` example restores the root volume of instance i-0123456789abcdefa to snapshot snap-0abcdef1234567890. ::

    aws ec2 create-replace-root-volume-task \
        --instance-id i-0123456789abcdefa \
        --snapshot-id  snap-0abcdef1234567890

Output::

    {
        "ReplaceRootVolumeTask": 
        {
            "InstanceId": "i-0123456789abcdefa", 
            "ReplaceRootVolumeTaskId": "replacevol-0555566667777abcd", 
            "TaskState": "pending", 
            "StartTime": "2022-03-14T15:16:28Z", 
            "Tags": []
        }
    }

For more information, see `Replace a root volume <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html#replace-root>`__ in the *Amazon Elastic Compute Cloud User Guide*.