SavingsPlans / Client / create_savings_plan

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