create_savings_plan

SavingsPlans.Client.create_savings_plan(**kwargs)

Creates a Savings Plan.

See also: AWS API Documentation

Request Syntax

response = client.create_savings_plan(
    savingsPlanOfferingId='string',
    commitment='string',
    upfrontPaymentAmount='string',
    purchaseTime=datetime(2015, 1, 1),
    clientToken='string',
    tags={
        'string': 'string'
    }
)
Parameters
  • savingsPlanOfferingId (string) --

    [REQUIRED]

    The ID of the offering.

  • commitment (string) --

    [REQUIRED]

    The hourly commitment, in USD. This is a value between 0.001 and 1 million. You cannot specify more than five digits after the decimal point.

  • upfrontPaymentAmount (string) -- The up-front payment amount. This is a whole number between 50 and 99 percent of the total value of the Savings Plan. This parameter is supported only if the payment option is Partial Upfront .
  • purchaseTime (datetime) -- The time at which to purchase the Savings Plan, in UTC format (YYYY-MM-DDTHH:MM:SSZ).
  • clientToken (string) --

    Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

    This field is autopopulated if not provided.

  • tags (dict) --

    One or more tags.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'savingsPlanId': 'string'
}

Response Structure

  • (dict) --

    • savingsPlanId (string) --

      The ID of the Savings Plan.

Exceptions

  • SavingsPlans.Client.exceptions.ResourceNotFoundException
  • SavingsPlans.Client.exceptions.ValidationException
  • SavingsPlans.Client.exceptions.InternalServerException
  • SavingsPlans.Client.exceptions.ServiceQuotaExceededException