GET /#Action=DescribeHostReservations

Describes reservations that are associated with Dedicated Hosts in your account.

Servers

https://ec2.{region}.amazonaws.com
https://ec2.amazonaws.com
https://ec2.{region}.amazonaws.com.cn

Request headers

Name	Type	Required	Description
`X-Amz-Content-Sha256`	String	No
`X-Amz-Credential`	String	No
`X-Amz-Date`	String	No
`X-Amz-Algorithm`	String	No
`X-Amz-SignedHeaders`	String	No
`X-Amz-Security-Token`	String	No
`X-Amz-Signature`	String	No

Query parameters

Name	Type	Required	Description
`Filter[]`	Array	No	The filters. `instance-family` - The instance family (for example, `m4`). `payment-option` - The payment option (`NoUpfront` \| `PartialUpfront` \| `AllUpfront`). `state` - The state of the reservation (`payment-pending` \| `payment-failed` \| `active` \| `retired`). `tag:<key>` - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key `Owner` and the value `TeamA`, specify `tag:Owner` for the filter name and `TeamA` for the filter value. `tag-key` - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.
`Version`	String	Yes	Possible values: `"2016-11-15"`
`MaxResults`	Integer	No	The maximum number of results to return for the request in a single page. The remaining results can be seen by sending another request with the returned `nextToken` value. This value can be between 5 and 500. If `maxResults` is given a larger value than 500, you receive an error.
`NextToken`	String	No	The token to use to retrieve the next page of results.
`HostReservationIdSet[]`	Array	No	The host reservation IDs.
`Action`	String	Yes	Possible values: `"DescribeHostReservations"`

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.