EC2 / Client / reboot_instances

reboot_instances#

EC2.Client.reboot_instances(**kwargs)#

Requests a reboot of the specified instances. This operation is asynchronous; it only queues a request to reboot the specified instances. The operation succeeds if the instances are valid and belong to you. Requests to reboot terminated instances are ignored.

If an instance does not cleanly shut down within a few minutes, Amazon EC2 performs a hard reboot.

For more information about troubleshooting, see Troubleshoot an unreachable instance in the Amazon EC2 User Guide.

See also: AWS API Documentation

Request Syntax

response = client.reboot_instances(
    InstanceIds=[
        'string',
    ],
    DryRun=True|False
)
Parameters:

  • InstanceIds (list) –

    [REQUIRED]

    The instance IDs.

    • (string) –

  • DryRun (boolean) – Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Returns:

None

Examples

This example reboots the specified EC2 instance.

response = client.reboot_instances(
    InstanceIds=[
        'i-1234567890abcdef5',
    ],
)

print(response)

Expected Output:

{
    'ResponseMetadata': {
        '...': '...',
    },
}