Amazonka.EC2.PurchaseScheduledInstances

You can no longer purchase Scheduled Instances.

Purchases the Scheduled Instances with the specified schedule.

Scheduled Instances enable you to purchase Amazon EC2 compute capacity by the hour for a one-year term. Before you can purchase a Scheduled Instance, you must call DescribeScheduledInstanceAvailability to check for available schedules and obtain a purchase token. After you purchase a Scheduled Instance, you must call RunScheduledInstances during each scheduled time period.

After you purchase a Scheduled Instance, you can't cancel, modify, or resell your purchase.

Creating a Request

data PurchaseScheduledInstances

Contains the parameters for PurchaseScheduledInstances.

See: newPurchaseScheduledInstances smart constructor.

Constructors

PurchaseScheduledInstances'

Fields

• clientToken :: Maybe Text

  Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

• 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.

• purchaseRequests :: NonEmpty PurchaseRequest

  The purchase requests.

Instances

ToHeaders PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

toHeaders :: PurchaseScheduledInstances -> [Header]

ToPath PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

toPath :: PurchaseScheduledInstances -> ByteString

ToQuery PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

toQuery :: PurchaseScheduledInstances -> QueryString

AWSRequest PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

Associated Types

type AWSResponse PurchaseScheduledInstances

Methods

request :: (Service -> Service) -> PurchaseScheduledInstances -> Request PurchaseScheduledInstances

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy PurchaseScheduledInstances -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse PurchaseScheduledInstances)))

Generic PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

Associated Types

type Rep PurchaseScheduledInstances :: Type -> Type

Methods

from :: PurchaseScheduledInstances -> Rep PurchaseScheduledInstances x

to :: Rep PurchaseScheduledInstances x -> PurchaseScheduledInstances

Read PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

readsPrec :: Int -> ReadS PurchaseScheduledInstances

readList :: ReadS [PurchaseScheduledInstances]

readPrec :: ReadPrec PurchaseScheduledInstances

readListPrec :: ReadPrec [PurchaseScheduledInstances]

Show PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

showsPrec :: Int -> PurchaseScheduledInstances -> ShowS

show :: PurchaseScheduledInstances -> String

showList :: [PurchaseScheduledInstances] -> ShowS

NFData PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

rnf :: PurchaseScheduledInstances -> ()

Eq PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

(==) :: PurchaseScheduledInstances -> PurchaseScheduledInstances -> Bool

(/=) :: PurchaseScheduledInstances -> PurchaseScheduledInstances -> Bool

Hashable PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

hashWithSalt :: Int -> PurchaseScheduledInstances -> Int

hash :: PurchaseScheduledInstances -> Int

type AWSResponse PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

type AWSResponse PurchaseScheduledInstances = PurchaseScheduledInstancesResponse

type Rep PurchaseScheduledInstances

Defined in Amazonka.EC2.PurchaseScheduledInstances

type Rep PurchaseScheduledInstances = D1 ('MetaData "PurchaseScheduledInstances" "Amazonka.EC2.PurchaseScheduledInstances" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "PurchaseScheduledInstances'" 'PrefixI 'True) (S1 ('MetaSel ('Just "clientToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "dryRun") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "purchaseRequests") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (NonEmpty PurchaseRequest)))))

newPurchaseScheduledInstances

Arguments

:: NonEmpty PurchaseRequest

$sel:purchaseRequests:PurchaseScheduledInstances'

-> PurchaseScheduledInstances

Create a value of PurchaseScheduledInstances 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:

PurchaseScheduledInstances, purchaseScheduledInstances_clientToken - Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

$sel:dryRun:PurchaseScheduledInstances', purchaseScheduledInstances_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:purchaseRequests:PurchaseScheduledInstances', purchaseScheduledInstances_purchaseRequests - The purchase requests.

Request Lenses

purchaseScheduledInstances_clientToken :: Lens' PurchaseScheduledInstances (Maybe Text)

Unique, case-sensitive identifier that ensures the idempotency of the request. For more information, see Ensuring Idempotency.

purchaseScheduledInstances_dryRun :: Lens' PurchaseScheduledInstances (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.

purchaseScheduledInstances_purchaseRequests :: Lens' PurchaseScheduledInstances (NonEmpty PurchaseRequest)

The purchase requests.

Destructuring the Response

data PurchaseScheduledInstancesResponse

Contains the output of PurchaseScheduledInstances.

See: newPurchaseScheduledInstancesResponse smart constructor.

Constructors

PurchaseScheduledInstancesResponse'

Fields

• scheduledInstanceSet :: Maybe [ScheduledInstance]

  Information about the Scheduled Instances.

• httpStatus :: Int

  The response's http status code.

Instances

Generic PurchaseScheduledInstancesResponse

Defined in Amazonka.EC2.PurchaseScheduledInstances

Associated Types

type Rep PurchaseScheduledInstancesResponse :: Type -> Type

Methods

from :: PurchaseScheduledInstancesResponse -> Rep PurchaseScheduledInstancesResponse x

to :: Rep PurchaseScheduledInstancesResponse x -> PurchaseScheduledInstancesResponse

Read PurchaseScheduledInstancesResponse

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

readsPrec :: Int -> ReadS PurchaseScheduledInstancesResponse

readList :: ReadS [PurchaseScheduledInstancesResponse]

readPrec :: ReadPrec PurchaseScheduledInstancesResponse

readListPrec :: ReadPrec [PurchaseScheduledInstancesResponse]

Show PurchaseScheduledInstancesResponse

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

showsPrec :: Int -> PurchaseScheduledInstancesResponse -> ShowS

show :: PurchaseScheduledInstancesResponse -> String

showList :: [PurchaseScheduledInstancesResponse] -> ShowS

NFData PurchaseScheduledInstancesResponse

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

rnf :: PurchaseScheduledInstancesResponse -> ()

Eq PurchaseScheduledInstancesResponse

Defined in Amazonka.EC2.PurchaseScheduledInstances

Methods

(==) :: PurchaseScheduledInstancesResponse -> PurchaseScheduledInstancesResponse -> Bool

(/=) :: PurchaseScheduledInstancesResponse -> PurchaseScheduledInstancesResponse -> Bool

type Rep PurchaseScheduledInstancesResponse

Defined in Amazonka.EC2.PurchaseScheduledInstances

type Rep PurchaseScheduledInstancesResponse = D1 ('MetaData "PurchaseScheduledInstancesResponse" "Amazonka.EC2.PurchaseScheduledInstances" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "PurchaseScheduledInstancesResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "scheduledInstanceSet") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [ScheduledInstance])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newPurchaseScheduledInstancesResponse

Arguments

:: Int

$sel:httpStatus:PurchaseScheduledInstancesResponse'

-> PurchaseScheduledInstancesResponse

Create a value of PurchaseScheduledInstancesResponse 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:scheduledInstanceSet:PurchaseScheduledInstancesResponse', purchaseScheduledInstancesResponse_scheduledInstanceSet - Information about the Scheduled Instances.

$sel:httpStatus:PurchaseScheduledInstancesResponse', purchaseScheduledInstancesResponse_httpStatus - The response's http status code.

Response Lenses

purchaseScheduledInstancesResponse_scheduledInstanceSet :: Lens' PurchaseScheduledInstancesResponse (Maybe [ScheduledInstance])

Information about the Scheduled Instances.

purchaseScheduledInstancesResponse_httpStatus :: Lens' PurchaseScheduledInstancesResponse Int

The response's http status code.