Skip to main content

reserved_instances

Creates, updates, deletes, gets or lists a reserved_instances resource.

Overview

Namereserved_instances
TypeResource
Idaws.opensearch.reserved_instances

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
next_tokenstringWhen nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Send the request again using the returned token to retrieve the next page.
reserved_instancesarrayList of Reserved Instances in the current Region.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_reserved_instancesselectregionreservationId, maxResults, nextTokenDescribes the Amazon OpenSearch Service instances that you have reserved in a given Region. For more information, see Reserved Instances in Amazon OpenSearch Service.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
maxResultsintegerAn optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
nextTokenstringIf your initial DescribeReservedInstances operation returns a nextToken, you can include the returned nextToken in subsequent DescribeReservedInstances operations, which returns results in the next page.
reservationIdstringThe reserved instance identifier filter value. Use this parameter to show only the reservation that matches the specified reserved OpenSearch instance ID.

SELECT examples

Describes the Amazon OpenSearch Service instances that you have reserved in a given Region. For more information, see Reserved Instances in Amazon OpenSearch Service.

SELECT
next_token,
reserved_instances
FROM aws.opensearch.reserved_instances
WHERE region = '{{ region }}' -- required
AND reservationId = '{{ reservationId }}'
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;