public class DescribeHostsRequest extends AmazonWebServiceRequest implements java.io.Serializable
DescribeHosts operation
.
Describes one or more of your Dedicated hosts.
The results describe only the Dedicated hosts in the region you're
currently using. All listed instances consume capacity on your
Dedicated host. Dedicated hosts that have recently been released will
be listed with the state released
.
Constructor and Description |
---|
DescribeHostsRequest() |
Modifier and Type | Method and Description |
---|---|
boolean |
equals(java.lang.Object obj) |
java.util.List<Filter> |
getFilter()
One or more filters.
|
java.util.List<java.lang.String> |
getHostIds()
The IDs of the Dedicated hosts.
|
java.lang.Integer |
getMaxResults()
The maximum number of results to return for the request in a single
page.
|
java.lang.String |
getNextToken()
The token to retrieve the next page of results.
|
int |
hashCode() |
void |
setFilter(java.util.Collection<Filter> filter)
One or more filters.
|
void |
setHostIds(java.util.Collection<java.lang.String> hostIds)
The IDs of the Dedicated hosts.
|
void |
setMaxResults(java.lang.Integer maxResults)
The maximum number of results to return for the request in a single
page.
|
void |
setNextToken(java.lang.String nextToken)
The token to retrieve the next page of results.
|
java.lang.String |
toString()
Returns a string representation of this object; useful for testing and
debugging.
|
DescribeHostsRequest |
withFilter(java.util.Collection<Filter> filter)
One or more filters.
|
DescribeHostsRequest |
withFilter(Filter... filter)
One or more filters.
|
DescribeHostsRequest |
withHostIds(java.util.Collection<java.lang.String> hostIds)
The IDs of the Dedicated hosts.
|
DescribeHostsRequest |
withHostIds(java.lang.String... hostIds)
The IDs of the Dedicated hosts.
|
DescribeHostsRequest |
withMaxResults(java.lang.Integer maxResults)
The maximum number of results to return for the request in a single
page.
|
DescribeHostsRequest |
withNextToken(java.lang.String nextToken)
The token to retrieve the next page of results.
|
clone, getCloneRoot, getCloneSource, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector
public java.util.List<java.lang.String> getHostIds()
public void setHostIds(java.util.Collection<java.lang.String> hostIds)
hostIds
- The IDs of the Dedicated hosts. The IDs are used for targeted instance
launches.public DescribeHostsRequest withHostIds(java.lang.String... hostIds)
Returns a reference to this object so that method calls can be chained together.
hostIds
- The IDs of the Dedicated hosts. The IDs are used for targeted instance
launches.public DescribeHostsRequest withHostIds(java.util.Collection<java.lang.String> hostIds)
Returns a reference to this object so that method calls can be chained together.
hostIds
- The IDs of the Dedicated hosts. The IDs are used for targeted instance
launches.public java.lang.String getNextToken()
public void setNextToken(java.lang.String nextToken)
nextToken
- The token to retrieve the next page of results.public DescribeHostsRequest withNextToken(java.lang.String nextToken)
Returns a reference to this object so that method calls can be chained together.
nextToken
- The token to retrieve the next page of results.public java.lang.Integer getMaxResults()
nextToken
value. This value can be
between 5 and 500; if maxResults
is given a larger value
than 500, you will receive an error. You cannot specify this parameter
and the host IDs parameter in the same request.nextToken
value. This value can be
between 5 and 500; if maxResults
is given a larger value
than 500, you will receive an error. You cannot specify this parameter
and the host IDs parameter in the same request.public void setMaxResults(java.lang.Integer maxResults)
nextToken
value. This value can be
between 5 and 500; if maxResults
is given a larger value
than 500, you will receive an error. You cannot specify this parameter
and the host IDs parameter in the same request.maxResults
- 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 will receive an error. You cannot specify this parameter
and the host IDs parameter in the same request.public DescribeHostsRequest withMaxResults(java.lang.Integer maxResults)
nextToken
value. This value can be
between 5 and 500; if maxResults
is given a larger value
than 500, you will receive an error. You cannot specify this parameter
and the host IDs parameter in the same request.
Returns a reference to this object so that method calls can be chained together.
maxResults
- 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 will receive an error. You cannot specify this parameter
and the host IDs parameter in the same request.public java.util.List<Filter> getFilter()
instance-type
- The
instance type size that the Dedicated host is configured to
support.
auto-placement
- Whether
auto-placement is enabled or disabled (on
|
off
).
host-reservation-id
- The
ID of the reservation associated with this host.
client-token
- The idempotency token you provided
when you launched the instance
state
- The
allocation state of the Dedicated host (available
|
under-assessment
| permanent-failure
|
released
| released-permanent-failure
).
availability-zone
- The Availability Zone of the
host.
instance-type
- The
instance type size that the Dedicated host is configured to
support.
auto-placement
- Whether
auto-placement is enabled or disabled (on
|
off
).
host-reservation-id
- The
ID of the reservation associated with this host.
client-token
- The idempotency token you provided
when you launched the instance
state
- The
allocation state of the Dedicated host (available
|
under-assessment
| permanent-failure
|
released
| released-permanent-failure
).
availability-zone
- The Availability Zone of the
host.
public void setFilter(java.util.Collection<Filter> filter)
instance-type
- The
instance type size that the Dedicated host is configured to
support.
auto-placement
- Whether
auto-placement is enabled or disabled (on
|
off
).
host-reservation-id
- The
ID of the reservation associated with this host.
client-token
- The idempotency token you provided
when you launched the instance
state
- The
allocation state of the Dedicated host (available
|
under-assessment
| permanent-failure
|
released
| released-permanent-failure
).
availability-zone
- The Availability Zone of the
host.
filter
- One or more filters. instance-type
- The
instance type size that the Dedicated host is configured to
support.
auto-placement
- Whether
auto-placement is enabled or disabled (on
|
off
).
host-reservation-id
- The
ID of the reservation associated with this host.
client-token
- The idempotency token you provided
when you launched the instance
state
- The
allocation state of the Dedicated host (available
|
under-assessment
| permanent-failure
|
released
| released-permanent-failure
).
availability-zone
- The Availability Zone of the
host.
public DescribeHostsRequest withFilter(Filter... filter)
instance-type
- The
instance type size that the Dedicated host is configured to
support.
auto-placement
- Whether
auto-placement is enabled or disabled (on
|
off
).
host-reservation-id
- The
ID of the reservation associated with this host.
client-token
- The idempotency token you provided
when you launched the instance
state
- The
allocation state of the Dedicated host (available
|
under-assessment
| permanent-failure
|
released
| released-permanent-failure
).
availability-zone
- The Availability Zone of the
host.
Returns a reference to this object so that method calls can be chained together.
filter
- One or more filters. instance-type
- The
instance type size that the Dedicated host is configured to
support.
auto-placement
- Whether
auto-placement is enabled or disabled (on
|
off
).
host-reservation-id
- The
ID of the reservation associated with this host.
client-token
- The idempotency token you provided
when you launched the instance
state
- The
allocation state of the Dedicated host (available
|
under-assessment
| permanent-failure
|
released
| released-permanent-failure
).
availability-zone
- The Availability Zone of the
host.
public DescribeHostsRequest withFilter(java.util.Collection<Filter> filter)
instance-type
- The
instance type size that the Dedicated host is configured to
support.
auto-placement
- Whether
auto-placement is enabled or disabled (on
|
off
).
host-reservation-id
- The
ID of the reservation associated with this host.
client-token
- The idempotency token you provided
when you launched the instance
state
- The
allocation state of the Dedicated host (available
|
under-assessment
| permanent-failure
|
released
| released-permanent-failure
).
availability-zone
- The Availability Zone of the
host.
Returns a reference to this object so that method calls can be chained together.
filter
- One or more filters. instance-type
- The
instance type size that the Dedicated host is configured to
support.
auto-placement
- Whether
auto-placement is enabled or disabled (on
|
off
).
host-reservation-id
- The
ID of the reservation associated with this host.
client-token
- The idempotency token you provided
when you launched the instance
state
- The
allocation state of the Dedicated host (available
|
under-assessment
| permanent-failure
|
released
| released-permanent-failure
).
availability-zone
- The Availability Zone of the
host.
public java.lang.String toString()
toString
in class java.lang.Object
Object.toString()
public int hashCode()
hashCode
in class java.lang.Object
public boolean equals(java.lang.Object obj)
equals
in class java.lang.Object
Copyright © 2018 Amazon Web Services, Inc. All Rights Reserved.