describe_orderable_db_instance_options

DocDB.Client.describe_orderable_db_instance_options(**kwargs)

Returns a list of orderable instance options for the specified engine.

See also: AWS API Documentation

Request Syntax

response = client.describe_orderable_db_instance_options(
    Engine='string',
    EngineVersion='string',
    DBInstanceClass='string',
    LicenseModel='string',
    Vpc=True|False,
    Filters=[
        {
            'Name': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    MaxRecords=123,
    Marker='string'
)
Parameters
  • Engine (string) --

    [REQUIRED]

    The name of the engine to retrieve instance options for.

  • EngineVersion (string) -- The engine version filter value. Specify this parameter to show only the available offerings that match the specified engine version.
  • DBInstanceClass (string) -- The instance class filter value. Specify this parameter to show only the available offerings that match the specified instance class.
  • LicenseModel (string) -- The license model filter value. Specify this parameter to show only the available offerings that match the specified license model.
  • Vpc (boolean) -- The virtual private cloud (VPC) filter value. Specify this parameter to show only the available VPC or non-VPC offerings.
  • Filters (list) --

    This parameter is not currently supported.

    • (dict) --

      A named set of filter values, used to return a more specific list of results. You can use a filter to match a set of resources by specific criteria, such as IDs.

      Wildcards are not supported in filters.

      • Name (string) -- [REQUIRED]

        The name of the filter. Filter names are case sensitive.

      • Values (list) -- [REQUIRED]

        One or more filter values. Filter values are case sensitive.

        • (string) --
  • MaxRecords (integer) --

    The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token (marker) is included in the response so that the remaining results can be retrieved.

    Default: 100

    Constraints: Minimum 20, maximum 100.

  • Marker (string) -- An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .
Return type

dict

Returns

Response Syntax

{
    'OrderableDBInstanceOptions': [
        {
            'Engine': 'string',
            'EngineVersion': 'string',
            'DBInstanceClass': 'string',
            'LicenseModel': 'string',
            'AvailabilityZones': [
                {
                    'Name': 'string'
                },
            ],
            'Vpc': True|False
        },
    ],
    'Marker': 'string'
}

Response Structure

  • (dict) --

    Represents the output of DescribeOrderableDBInstanceOptions.

    • OrderableDBInstanceOptions (list) --

      The options that are available for a particular orderable instance.

      • (dict) --

        The options that are available for an instance.

        • Engine (string) --

          The engine type of an instance.

        • EngineVersion (string) --

          The engine version of an instance.

        • DBInstanceClass (string) --

          The instance class for an instance.

        • LicenseModel (string) --

          The license model for an instance.

        • AvailabilityZones (list) --

          A list of Availability Zones for an instance.

          • (dict) --

            Information about an Availability Zone.

            • Name (string) --

              The name of the Availability Zone.

        • Vpc (boolean) --

          Indicates whether an instance is in a virtual private cloud (VPC).

    • Marker (string) --

      An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .