Describe Host Reservations
Describes reservations that are associated with Dedicated Hosts in your account.
ec2_describe_host_reservations( Filter = NULL, HostReservationIdSet = NULL, MaxResults = NULL, NextToken = NULL, simplify = TRUE, others = list(), print_on_error = aws_get_print_on_error(), retry_time = aws_get_retry_time(), network_timeout = aws_get_network_timeout(), region = aws_get_region() )
Filter |
Named list where the name is the filter name and the value is the filter's value. The value can be a vector or a list object (see below)[optional] |
HostReservationIdSet |
List. The host reservation IDs.[optional] |
MaxResults |
Integer. The maximum number of results to return for the request in a single page.[optional] |
NextToken |
Characters. The token for the next page of results[optional] |
simplify |
Logical. Whether to simplify the result and handle |
others |
Named list. The parameters that are not included in the function parameters and need to be added into the request[optional] |
print_on_error |
Logical. Whether to show an error message when a network error occurs. |
retry_time |
Integer. Number of retries for a REST request when encounter the
network issue. If the request has been sent |
network_timeout |
Numeric. Number of seconds to wait for a REST response until giving up. Can not be less than 1 ms. |
region |
Character. The region of the AWS service. |
A list object or a character vector
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
:\ - 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.
The host reservation IDs.
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.
Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.