Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . ec2 ]



Modify the auto-placement setting of a Dedicated Host. When auto-placement is enabled, AWS will place instances that you launch with a tenancy of host , but without targeting a specific host ID, onto any available Dedicated Host in your account which has auto-placement enabled. When auto-placement is disabled, you need to provide a host ID if you want the instance to launch onto a specific host. If no host ID is provided, the instance will be launched onto a suitable host which has auto-placement enabled.

See also: AWS API Documentation


--auto-placement <value>
--host-ids <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--auto-placement (string)

Specify whether to enable or disable auto-placement.

Possible values:

  • on
  • off

--host-ids (list)

The host IDs of the Dedicated Hosts you want to modify.


"string" "string" ...

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.


To describe Dedicated hosts in your account and generate a machine-readable list

To output a list of Dedicated host IDs in JSON (comma separated).


aws ec2 describe-hosts --query 'Hosts[].HostId' --output json



To output a list of Dedicated host IDs in plaintext (comma separated).


aws ec2 describe-hosts --query 'Hosts[].HostId' --output text

Output:: h-085664df5899941c h-056c1b0724170dc38

To describe available Dedicated hosts in your account


aws ec2 describe-hosts --filter "Name=state,Values=available"


  "Hosts":  [
          "HostId": "h-085664df5899941c"
          "HostProperties: {
              "Cores": 20,
               "Sockets": 2,
                "InstanceType": "m3.medium".
                "TotalVCpus": 32
           "Instances": [],
            "State": "available",
            "AvailabilityZone": "us-east-1b",
            "AvailableCapacity": {
                "AvailableInstanceCapacity": [
                          "AvailableCapacity": 32,
                          "InstanceType": "m3.medium",
                          "TotalCapacity": 32
                 "AvailableVCpus": 32
            "AutoPlacement": "off"


Successful -> (list)

The IDs of the Dedicated Hosts that were successfully modified.


Unsuccessful -> (list)

The IDs of the Dedicated Hosts that could not be modified. Check whether the setting you requested can be used.


Information about items that were not successfully processed in a batch call.

Error -> (structure)

Information about the error.

Code -> (string)

The error code.

Message -> (string)

The error message accompanying the error code.

ResourceId -> (string)

The ID of the resource.