amazonka-ec2-2.0: Amazon Elastic Compute Cloud SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.EC2.DescribeInstanceTypeOfferings

Description

Returns a list of all instance types offered. The results can be filtered by location (Region or Availability Zone). If no location is specified, the instance types offered in the current Region are returned.

This operation returns paginated results.

Synopsis

Creating a Request

data DescribeInstanceTypeOfferings Source #

See: newDescribeInstanceTypeOfferings smart constructor.

Constructors

DescribeInstanceTypeOfferings' 

Fields

  • dryRun :: Maybe Bool

    Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

  • filters :: Maybe [Filter]

    One or more filters. Filter names and values are case-sensitive.

    • location - This depends on the location type. For example, if the location type is region (default), the location is the Region code (for example, us-east-2.)
    • instance-type - The instance type. For example, c5.2xlarge.
  • locationType :: Maybe LocationType

    The location type.

  • maxResults :: Maybe Natural

    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 next token value.

  • nextToken :: Maybe Text

    The token to retrieve the next page of results.

Instances

Instances details
ToHeaders DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

ToPath DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

ToQuery DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

AWSPager DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

AWSRequest DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

Generic DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

Associated Types

type Rep DescribeInstanceTypeOfferings :: Type -> Type #

Read DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

Show DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

NFData DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

Eq DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

Hashable DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

type AWSResponse DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

type Rep DescribeInstanceTypeOfferings Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

type Rep DescribeInstanceTypeOfferings = D1 ('MetaData "DescribeInstanceTypeOfferings" "Amazonka.EC2.DescribeInstanceTypeOfferings" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "DescribeInstanceTypeOfferings'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "dryRun") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "filters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Filter]))) :*: (S1 ('MetaSel ('Just "locationType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe LocationType)) :*: (S1 ('MetaSel ('Just "maxResults") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))))

newDescribeInstanceTypeOfferings :: DescribeInstanceTypeOfferings Source #

Create a value of DescribeInstanceTypeOfferings with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:dryRun:DescribeInstanceTypeOfferings', describeInstanceTypeOfferings_dryRun - Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

$sel:filters:DescribeInstanceTypeOfferings', describeInstanceTypeOfferings_filters - One or more filters. Filter names and values are case-sensitive.

  • location - This depends on the location type. For example, if the location type is region (default), the location is the Region code (for example, us-east-2.)
  • instance-type - The instance type. For example, c5.2xlarge.

DescribeInstanceTypeOfferings, describeInstanceTypeOfferings_locationType - The location type.

$sel:maxResults:DescribeInstanceTypeOfferings', describeInstanceTypeOfferings_maxResults - 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 next token value.

DescribeInstanceTypeOfferings, describeInstanceTypeOfferings_nextToken - The token to retrieve the next page of results.

Request Lenses

describeInstanceTypeOfferings_dryRun :: Lens' DescribeInstanceTypeOfferings (Maybe Bool) Source #

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

describeInstanceTypeOfferings_filters :: Lens' DescribeInstanceTypeOfferings (Maybe [Filter]) Source #

One or more filters. Filter names and values are case-sensitive.

  • location - This depends on the location type. For example, if the location type is region (default), the location is the Region code (for example, us-east-2.)
  • instance-type - The instance type. For example, c5.2xlarge.

describeInstanceTypeOfferings_maxResults :: Lens' DescribeInstanceTypeOfferings (Maybe Natural) Source #

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 next token value.

Destructuring the Response

data DescribeInstanceTypeOfferingsResponse Source #

Constructors

DescribeInstanceTypeOfferingsResponse' 

Fields

Instances

Instances details
Generic DescribeInstanceTypeOfferingsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

Read DescribeInstanceTypeOfferingsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

Show DescribeInstanceTypeOfferingsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

NFData DescribeInstanceTypeOfferingsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

Eq DescribeInstanceTypeOfferingsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

type Rep DescribeInstanceTypeOfferingsResponse Source # 
Instance details

Defined in Amazonka.EC2.DescribeInstanceTypeOfferings

type Rep DescribeInstanceTypeOfferingsResponse = D1 ('MetaData "DescribeInstanceTypeOfferingsResponse" "Amazonka.EC2.DescribeInstanceTypeOfferings" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "DescribeInstanceTypeOfferingsResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "instanceTypeOfferings") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [InstanceTypeOffering])) :*: (S1 ('MetaSel ('Just "nextToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newDescribeInstanceTypeOfferingsResponse Source #

Create a value of DescribeInstanceTypeOfferingsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:instanceTypeOfferings:DescribeInstanceTypeOfferingsResponse', describeInstanceTypeOfferingsResponse_instanceTypeOfferings - The instance types offered.

DescribeInstanceTypeOfferings, describeInstanceTypeOfferingsResponse_nextToken - The token to use to retrieve the next page of results. This value is null when there are no more results to return.

$sel:httpStatus:DescribeInstanceTypeOfferingsResponse', describeInstanceTypeOfferingsResponse_httpStatus - The response's http status code.

Response Lenses

describeInstanceTypeOfferingsResponse_nextToken :: Lens' DescribeInstanceTypeOfferingsResponse (Maybe Text) Source #

The token to use to retrieve the next page of results. This value is null when there are no more results to return.