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/describe-replace-root-volume-tasks.rst
**Example 1: To view information about a specific root volume replacement task**

The following ``describe-replace-root-volume-tasks`` example describes root volume replacement task replacevol-0111122223333abcd. ::

    aws ec2 describe-replace-root-volume-tasks \
        --replace-root-volume-task-ids replacevol-0111122223333abcd

Output::

    {
        "ReplaceRootVolumeTasks": [
            {
                "ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd", 
                "Tags": [], 
                "InstanceId": "i-0123456789abcdefa", 
                "TaskState": "succeeded", 
                "StartTime": "2022-03-14T15:16:28Z", 
                "CompleteTime": "2022-03-14T15:16:52Z"
            }
        ]
    }

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 view information about all root volume replacement tasks for a specific instance**

The following ``describe-replace-root-volume-tasks`` example describes all of the root volume replacement tasks for instance i-0123456789abcdefa. ::

    aws ec2 describe-replace-root-volume-tasks \
        --filters Name=instance-id,Values=i-0123456789abcdefa

Output::

    {
        "ReplaceRootVolumeTasks": [
            {
                "ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd", 
                "Tags": [], 
                "InstanceId": "i-0123456789abcdefa", 
                "TaskState": "succeeded", 
                "StartTime": "2022-03-14T15:06:38Z", 
                "CompleteTime": "2022-03-14T15:07:03Z"
            }, 
            {
                "ReplaceRootVolumeTaskId": "replacevol-0444455555555abcd", 
                "Tags": [], 
                "InstanceId": "i-0123456789abcdefa", 
                "TaskState": "succeeded", 
                "StartTime": "2022-03-14T15:16:28Z", 
                "CompleteTime": "2022-03-14T15:16:52Z"
            }
        ]
    }

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*.