DescribeOrderableDBInstanceOptions
Returns a list of orderable DB instance options for the specified DB engine, DB engine version, and DB instance class.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- Engine
-
The name of the engine to retrieve DB instance options for.
Valid Values:
-
aurora-mysql
-
aurora-postgresql
-
custom-oracle-ee
-
mariadb
-
mysql
-
oracle-ee
-
oracle-ee-cdb
-
oracle-se2
-
oracle-se2-cdb
-
postgres
-
sqlserver-ee
-
sqlserver-se
-
sqlserver-ex
-
sqlserver-web
Type: String
Required: Yes
-
- AvailabilityZoneGroup
-
The Availability Zone group associated with a Local Zone. Specify this parameter to retrieve available offerings for the Local Zones in the group.
Omit this parameter to show the available offerings in the specified AWS Region.
This setting doesn't apply to RDS Custom.
Type: String
Required: No
- DBInstanceClass
-
The DB instance class filter value. Specify this parameter to show only the available offerings matching the specified DB instance class.
Type: String
Required: No
- EngineVersion
-
The engine version filter value. Specify this parameter to show only the available offerings matching the specified engine version.
Type: String
Required: No
- Filters.Filter.N
-
This parameter isn't currently supported.
Type: Array of Filter objects
Required: No
- LicenseModel
-
The license model filter value. Specify this parameter to show only the available offerings matching the specified license model.
RDS Custom supports only the BYOL licensing model.
Type: String
Required: No
- Marker
-
An optional pagination token provided by a previous DescribeOrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by
MaxRecords
.Type: String
Required: No
- MaxRecords
-
The maximum number of records to include in the response. If more records exist than the specified
MaxRecords
value, a pagination token called a marker is included in the response so that you can retrieve the remaining results.Default: 100
Constraints: Minimum 20, maximum 10000.
Type: Integer
Required: No
- Vpc
-
A value that indicates whether to show only VPC or non-VPC offerings. RDS Custom supports only VPC offerings.
RDS Custom supports only VPC offerings. If you describe non-VPC offerings for RDS Custom, the output shows VPC offerings.
Type: Boolean
Required: No
Response Elements
The following elements are returned by the service.
- Marker
-
An optional pagination token provided by a previous OrderableDBInstanceOptions request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by
MaxRecords
.Type: String
- OrderableDBInstanceOptions.OrderableDBInstanceOption.N
-
An
OrderableDBInstanceOption
structure containing information about orderable options for the DB instance.Type: Array of OrderableDBInstanceOption objects
Errors
For information about the errors that are common to all actions, see Common Errors.
Examples
Example
This example illustrates one usage of DescribeOrderableDBInstanceOptions.
Sample Request
https://rds.us-west-2.amazonaws.com/
?Action=DescribeOrderableDBInstanceOptions
&Engine=mysql
&EngineVersion=8.0.26
&DBInstanceClass=db.r6gd.large
&SignatureMethod=HmacSHA256
&SignatureVersion=4
&Version=2014-10-31
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIADQKE4SARGYLE/20140421/us-west-2/rds/aws4_request
&X-Amz-Date=20211020T205537Z
&X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
&X-Amz-Signature=b49545dd3c933bdded80655d433d84bf743261ea1bebb33a7922c5c2c5240cd8
Sample Response
<DescribeOrderableDBInstanceOptionsResponse xmlns="http://rds.amazonaws.com/doc/2014-10-31/">
<DescribeOrderableDBInstanceOptionsResult>
<Marker>ZGIubTEuc21hbGwKZ2VuZXJhbC1wdWJsaWMtbGljZW5zZQo1LjEuNjkKTg==</Marker>
<OrderableDBInstanceOptions>
<OrderableDBInstanceOption>
<MultiAZCapable>true</MultiAZCapable>
<Engine>mysql</Engine>
<LicenseModel>general-public-license</LicenseModel>
<ReadReplicaCapable>true</ReadReplicaCapable>
<Vpc>false</Vpc>
<EngineVersion>5.1.57</EngineVersion>
<AvailabilityZones>
<AvailabilityZone>
<Name>us-west-2a</Name>
<ProvisionedIopsCapable>true</ProvisionedIopsCapable>
</AvailabilityZone>
<AvailabilityZone>
<Name>us-west-2b</Name>
<ProvisionedIopsCapable>true</ProvisionedIopsCapable>
</AvailabilityZone>
<AvailabilityZone>
<Name>us-west-2c</Name>
<ProvisionedIopsCapable>true</ProvisionedIopsCapable>
</AvailabilityZone>
</AvailabilityZones>
<DBInstanceClass>db.m1.large</DBInstanceClass>
</OrderableDBInstanceOption>
<OrderableDBInstanceOption>
<MultiAZCapable>true</MultiAZCapable>
<Engine>mysql</Engine>
<LicenseModel>general-public-license</LicenseModel>
<ReadReplicaCapable>true</ReadReplicaCapable>
<Vpc>true</Vpc>
<EngineVersion>5.1.57</EngineVersion>
<AvailabilityZones>
<AvailabilityZone>
<Name>us-west-2a</Name>
<ProvisionedIopsCapable>true</ProvisionedIopsCapable>
</AvailabilityZone>
<AvailabilityZone>
<Name>us-west-2b</Name>
<ProvisionedIopsCapable>true</ProvisionedIopsCapable>
</AvailabilityZone>
<AvailabilityZone>
<Name>us-west-2c</Name>
<ProvisionedIopsCapable>true</ProvisionedIopsCapable>
</AvailabilityZone>
</AvailabilityZones>
<DBInstanceClass>db.m1.large</DBInstanceClass>
</OrderableDBInstanceOption>
</OrderableDBInstanceOptions>
</DescribeOrderableDBInstanceOptionsResult>
<ResponseMetadata>
<RequestId>b7ceb73e-b98c-11d3-a907-5a2c468b9cb0</RequestId>
</ResponseMetadata>
</DescribeOrderableDBInstanceOptionsResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: