Skip to content

/AWS1/CL_EC2=>DESCRIBEHOSTRESERVATIONS()

About DescribeHostReservations

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

Method Signature

IMPORTING

Optional arguments:

IT_FILTER TYPE /AWS1/CL_EC2FILTER=>TT_FILTERLIST TT_FILTERLIST

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.

IT_HOSTRESERVATIONIDSET TYPE /AWS1/CL_EC2HOSTRESERVATIONI00=>TT_HOSTRESERVATIONIDSET TT_HOSTRESERVATIONIDSET

The host reservation IDs.

IV_MAXRESULTS TYPE /AWS1/EC2INTEGER /AWS1/EC2INTEGER

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.

IV_NEXTTOKEN TYPE /AWS1/EC2STRING /AWS1/EC2STRING

The token to use to retrieve the next page of results.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_EC2DESCRHOSTRSVRESULT /AWS1/CL_EC2DESCRHOSTRSVRESULT