@Generated(value="software.amazon.awssdk:codegen") public final class DescribeReservedInstancesOfferingsRequest extends Ec2Request implements ToCopyableBuilder<DescribeReservedInstancesOfferingsRequest.Builder,DescribeReservedInstancesOfferingsRequest>
Contains the parameters for DescribeReservedInstancesOfferings.
| Modifier and Type | Class and Description |
|---|---|
static interface |
DescribeReservedInstancesOfferingsRequest.Builder |
| Modifier and Type | Method and Description |
|---|---|
String |
availabilityZone()
The Availability Zone in which the Reserved Instance can be used.
|
static DescribeReservedInstancesOfferingsRequest.Builder |
builder() |
boolean |
equals(Object obj) |
boolean |
equalsBySdkFields(Object obj) |
List<Filter> |
filters()
One or more filters.
|
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz) |
boolean |
hasFilters()
For responses, this returns true if the service returned a value for the Filters property.
|
int |
hashCode() |
boolean |
hasReservedInstancesOfferingIds()
For responses, this returns true if the service returned a value for the ReservedInstancesOfferingIds property.
|
Boolean |
includeMarketplace()
Include Reserved Instance Marketplace offerings in the response.
|
Tenancy |
instanceTenancy()
The tenancy of the instances covered by the reservation.
|
String |
instanceTenancyAsString()
The tenancy of the instances covered by the reservation.
|
InstanceType |
instanceType()
The instance type that the reservation will cover (for example,
m1.small). |
String |
instanceTypeAsString()
The instance type that the reservation will cover (for example,
m1.small). |
Long |
maxDuration()
The maximum duration (in seconds) to filter when searching for offerings.
|
Integer |
maxInstanceCount()
The maximum number of instances to filter when searching for offerings.
|
Integer |
maxResults()
The maximum number of results to return for the request in a single page.
|
Long |
minDuration()
The minimum duration (in seconds) to filter when searching for offerings.
|
String |
nextToken()
The token to retrieve the next page of results.
|
OfferingClassType |
offeringClass()
The offering class of the Reserved Instance.
|
String |
offeringClassAsString()
The offering class of the Reserved Instance.
|
OfferingTypeValues |
offeringType()
The Reserved Instance offering type.
|
String |
offeringTypeAsString()
The Reserved Instance offering type.
|
RIProductDescription |
productDescription()
The Reserved Instance product platform description.
|
String |
productDescriptionAsString()
The Reserved Instance product platform description.
|
List<String> |
reservedInstancesOfferingIds()
One or more Reserved Instances offering IDs.
|
List<SdkField<?>> |
sdkFields() |
static Class<? extends DescribeReservedInstancesOfferingsRequest.Builder> |
serializableBuilderClass() |
DescribeReservedInstancesOfferingsRequest.Builder |
toBuilder() |
String |
toString()
Returns a string representation of this object.
|
overrideConfigurationclone, finalize, getClass, notify, notifyAll, wait, wait, waitcopypublic final String availabilityZone()
The Availability Zone in which the Reserved Instance can be used.
public final boolean hasFilters()
isEmpty() method on the property). This is
useful because the SDK will never return a null collection or map, but you may need to differentiate between the
service returning nothing (or null) and the service returning an empty collection or map. For requests, this
returns true if a value for the property was specified in the request builder, and false if a value was not
specified.public final List<Filter> filters()
One or more filters.
availability-zone - The Availability Zone where the Reserved Instance can be used.
duration - The duration of the Reserved Instance (for example, one year or three years), in seconds
(31536000 | 94608000).
fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).
instance-type - The instance type that is covered by the reservation.
marketplace - Set to true to show only Reserved Instance Marketplace offerings. When
this filter is not used, which is the default behavior, all offerings from both Amazon Web Services and the
Reserved Instance Marketplace are listed.
product-description - The Reserved Instance product platform description (Linux/UNIX |
Linux with SQL Server Standard | Linux with SQL Server Web |
Linux with SQL Server Enterprise | SUSE Linux | Red Hat Enterprise Linux |
Red Hat Enterprise Linux with HA | Windows |
Windows with SQL Server Standard | Windows with SQL Server Web |
Windows with SQL Server Enterprise).
reserved-instances-offering-id - The Reserved Instances offering ID.
scope - The scope of the Reserved Instance (Availability Zone or Region).
usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that
you can differentiate between null and empty), you can use the hasFilters() method.
availability-zone - The Availability Zone where the Reserved Instance can be used.
duration - The duration of the Reserved Instance (for example, one year or three years), in
seconds (31536000 | 94608000).
fixed-price - The purchase price of the Reserved Instance (for example, 9800.0).
instance-type - The instance type that is covered by the reservation.
marketplace - Set to true to show only Reserved Instance Marketplace offerings.
When this filter is not used, which is the default behavior, all offerings from both Amazon Web Services
and the Reserved Instance Marketplace are listed.
product-description - The Reserved Instance product platform description (
Linux/UNIX | Linux with SQL Server Standard |
Linux with SQL Server Web | Linux with SQL Server Enterprise |
SUSE Linux | Red Hat Enterprise Linux |
Red Hat Enterprise Linux with HA | Windows |
Windows with SQL Server Standard | Windows with SQL Server Web |
Windows with SQL Server Enterprise).
reserved-instances-offering-id - The Reserved Instances offering ID.
scope - The scope of the Reserved Instance (Availability Zone or
Region).
usage-price - The usage price of the Reserved Instance, per hour (for example, 0.84).
public final Boolean includeMarketplace()
Include Reserved Instance Marketplace offerings in the response.
public final InstanceType instanceType()
The instance type that the reservation will cover (for example, m1.small). For more information, see
Instance types in the
Amazon EC2 User Guide.
If the service returns an enum value that is not available in the current SDK version, instanceType will
return InstanceType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from
instanceTypeAsString().
m1.small). For more
information, see Instance types in the
Amazon EC2 User Guide.InstanceTypepublic final String instanceTypeAsString()
The instance type that the reservation will cover (for example, m1.small). For more information, see
Instance types in the
Amazon EC2 User Guide.
If the service returns an enum value that is not available in the current SDK version, instanceType will
return InstanceType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from
instanceTypeAsString().
m1.small). For more
information, see Instance types in the
Amazon EC2 User Guide.InstanceTypepublic final Long maxDuration()
The maximum duration (in seconds) to filter when searching for offerings.
Default: 94608000 (3 years)
Default: 94608000 (3 years)
public final Integer maxInstanceCount()
The maximum number of instances to filter when searching for offerings.
Default: 20
Default: 20
public final Long minDuration()
The minimum duration (in seconds) to filter when searching for offerings.
Default: 2592000 (1 month)
Default: 2592000 (1 month)
public final OfferingClassType offeringClass()
The offering class of the Reserved Instance. Can be standard or convertible.
If the service returns an enum value that is not available in the current SDK version, offeringClass
will return OfferingClassType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available
from offeringClassAsString().
standard or convertible.OfferingClassTypepublic final String offeringClassAsString()
The offering class of the Reserved Instance. Can be standard or convertible.
If the service returns an enum value that is not available in the current SDK version, offeringClass
will return OfferingClassType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available
from offeringClassAsString().
standard or convertible.OfferingClassTypepublic final RIProductDescription productDescription()
The Reserved Instance product platform description. Instances that include (Amazon VPC) in the
description are for use with Amazon VPC.
If the service returns an enum value that is not available in the current SDK version,
productDescription will return RIProductDescription.UNKNOWN_TO_SDK_VERSION. The raw value
returned by the service is available from productDescriptionAsString().
(Amazon VPC) in
the description are for use with Amazon VPC.RIProductDescriptionpublic final String productDescriptionAsString()
The Reserved Instance product platform description. Instances that include (Amazon VPC) in the
description are for use with Amazon VPC.
If the service returns an enum value that is not available in the current SDK version,
productDescription will return RIProductDescription.UNKNOWN_TO_SDK_VERSION. The raw value
returned by the service is available from productDescriptionAsString().
(Amazon VPC) in
the description are for use with Amazon VPC.RIProductDescriptionpublic final boolean hasReservedInstancesOfferingIds()
isEmpty() method on the
property). This is useful because the SDK will never return a null collection or map, but you may need to
differentiate between the service returning nothing (or null) and the service returning an empty collection or
map. For requests, this returns true if a value for the property was specified in the request builder, and false
if a value was not specified.public final List<String> reservedInstancesOfferingIds()
One or more Reserved Instances offering IDs.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that
you can differentiate between null and empty), you can use the hasReservedInstancesOfferingIds() method.
public final Tenancy instanceTenancy()
The tenancy of the instances covered by the reservation. A Reserved Instance with a tenancy of
dedicated is applied to instances that run in a VPC on single-tenant hardware (i.e., Dedicated
Instances).
Important: The host value cannot be used with this parameter. Use the default or
dedicated values only.
Default: default
If the service returns an enum value that is not available in the current SDK version, instanceTenancy
will return Tenancy.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from
instanceTenancyAsString().
dedicated is applied to instances that run in a VPC on single-tenant hardware (i.e.,
Dedicated Instances).
Important: The host value cannot be used with this parameter. Use the
default or dedicated values only.
Default: default
Tenancypublic final String instanceTenancyAsString()
The tenancy of the instances covered by the reservation. A Reserved Instance with a tenancy of
dedicated is applied to instances that run in a VPC on single-tenant hardware (i.e., Dedicated
Instances).
Important: The host value cannot be used with this parameter. Use the default or
dedicated values only.
Default: default
If the service returns an enum value that is not available in the current SDK version, instanceTenancy
will return Tenancy.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from
instanceTenancyAsString().
dedicated is applied to instances that run in a VPC on single-tenant hardware (i.e.,
Dedicated Instances).
Important: The host value cannot be used with this parameter. Use the
default or dedicated values only.
Default: default
Tenancypublic final Integer maxResults()
The maximum number of results to return for the request in a single page. The remaining results of the initial
request can be seen by sending another request with the returned NextToken value. The maximum is
100.
Default: 100
NextToken value.
The maximum is 100.
Default: 100
public final String nextToken()
The token to retrieve the next page of results.
public final OfferingTypeValues offeringType()
The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only
have access to the Medium Utilization Reserved Instance offering type.
If the service returns an enum value that is not available in the current SDK version, offeringType will
return OfferingTypeValues.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from
offeringTypeAsString().
Medium Utilization Reserved Instance offering type.OfferingTypeValuespublic final String offeringTypeAsString()
The Reserved Instance offering type. If you are using tools that predate the 2011-11-01 API version, you only
have access to the Medium Utilization Reserved Instance offering type.
If the service returns an enum value that is not available in the current SDK version, offeringType will
return OfferingTypeValues.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from
offeringTypeAsString().
Medium Utilization Reserved Instance offering type.OfferingTypeValuespublic DescribeReservedInstancesOfferingsRequest.Builder toBuilder()
toBuilder in interface ToCopyableBuilder<DescribeReservedInstancesOfferingsRequest.Builder,DescribeReservedInstancesOfferingsRequest>toBuilder in class Ec2Requestpublic static DescribeReservedInstancesOfferingsRequest.Builder builder()
public static Class<? extends DescribeReservedInstancesOfferingsRequest.Builder> serializableBuilderClass()
public final int hashCode()
hashCode in class AwsRequestpublic final boolean equals(Object obj)
equals in class AwsRequestpublic final boolean equalsBySdkFields(Object obj)
equalsBySdkFields in interface SdkPojopublic final String toString()
public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
getValueForField in class SdkRequestCopyright © 2023. All rights reserved.