Skip to main content

How to manage a Savings Plan

Stephanie R.
Updated

This guide provides a clear, detailed method for creating and updating Savings Plans for your resources. You will discover how to manage your Savings Plans using the OVHcloud Control Panel, the OVHcloud API, and Terraform. By following this guide, you will be able to:

  • Create a Savings Plan for your resources.
  • Modify a Savings Plan.
  • Automate the management of Savings Plans via the API or Terraform for greater efficiency and flexibility.

 

Requirements

 

Instructions

OVHcloud Control Panel Access

Click on Savings Plans in the left-hand navigation bar under Settings.

 

Create a Savings Plan

You can create your Savings Plan for the type of resource you want by following these steps:

Click the Create a Savings Plan button.

PCI_savingsPlans_onboarding.PNG

On the next screen:

  • Select a service
  • Choose a deployment mode
  • Choose model
  • Specify the number of resources
  • Select the subscription period
  • Select a date
  • Enter a name

When you have configured all of your options, click Create a Subscription Plan.

In the pop-up window, confirm all of your selections, agree to the terms of service, and click Create a Savings Plan.

To create a Savings Plan, you will need at least five pieces of information:

  • The ID of your Public Cloud project
  • The flavor concerned by your Savings Plan
  • The duration of your Savings Plan (in standard ISO 8601 format)
  • The number of resources concerned
  • The name of your Savings Plan

In our example, we are going to create a Savings Plan for 10 instances of type b3-8, for a duration of 1 month. Add the following lines to a file named savings_plan.tf:

# creation of a Savings Plan
resource "ovh_savings_plan" "Savings_plan_simple_b3_8" {
  service_name = "<public cloud project ID>"
  flavor = "b3-8" # instance type or rancher/rancher_standard or rancher_ovhcloud_edition
  period = "P1M" #  P mandatory, number for duration and M for ‘month’, Y for ‘year’ ...
  size = 10
  display_name = "Savings_plan_simple_b3_8"
  auto_renewal = true # optional, ‘true’ to activate.
}

You can create your Savings Plan by entering the following command in your console:

terraform apply

 

Modifying a Savings Plan

In the OVHcloud Control Panel, clicking the more options ⋮ button to the right of your plan gives you the option to:

  • Edit the name of the Savings Plan,
  • Activate/deactivate its automatic renewal, and
  • Create an instance to be included in your plan.

PCI_savingsPlans_planList.PNG

First, find the ID of your service in the list of your services, which can be obtained via the following endpoint:

GET /services

You will obtain a list containing the ID of your services as follows:

PCI_savingsPlans_API_serviceList.PNG

You can use this route to check whether the service corresponds to the Public Cloud project concerned:

GET /services/{serviceId}

You'll get a list containing the details of your service as follows. Check that it's the right project, using the vars.value field:

PCI_savingsPlans_API_serviceDetails.PNG

You can find the ID of your Savings Plan in the list of your Savings Plans obtained via this endpoint:

GET /services/{serviceId}/savingsPlans/subscribed

You get a list of Savings Plans as follows:

PCI_savingsPlans_API_planDetails.PNG

Then look for the Savings Plan concerned in the list and copy its ID.

Changing the name of a Savings Plan

To change the name of a Savings Plan, use the following endpoint:

PUT /services/{serviceId}/savingsPlans/subscribed/{savingsPlanId}

The savingsPlanId corresponds to the ID of your previously copied Savings Plan.

Activate/deactivate automatic renewal of a Savings Plan

To activate/disable the automatic renewal of the Savings Plan, use the following endpoint:

POST /services/{serviceId}/savingsPlans/subscribed/{savingsPlanId}/changePeriodEndAction

Increase the number of Savings Plan resources

To increase the number of resources subscribed to your Savings Plan, use this route:

The number of resources can only be increased.

POST /services/{serviceId}/savingsPlans/subscribed/{savingsPlanId}/changeSize

Modify your resource in the savings_plan.tf Terraform file created earlier.

Note that only the service_name, size and auto_renewal fields can be modified. The size can only be increased.

 

Go further

For more information and tutorials, please see our other Public Cloud support guides or explore the guides for other OVHcloud products and services.

Related articles