---
title: "How to manage a Savings Plan"
description: "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 usin"
url: https://docs.us.ovhcloud.com/en/public-cloud/cross-functional/compute-managing-savings-plan
lang: en
---
> For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt.

# How to manage a Savings Plan

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

- A [Public Cloud project](https://us.ovhcloud.com/public-cloud/) in your OVHcloud account
- Access to the [OVHcloud API](https://api.us.ovhcloud.com/) (create your credentials using [this guide](https://docs.us.ovhcloud.com/en/manage-and-operate/api/first-steps.md))
- Being familiar with [Terraform](https://docs.us.ovhcloud.com/en/public-cloud/cross-functional/how-to-use-terraform.md) if you intend to use it
- Being familiar with the principles of [Savings Plans](https://us.ovhcloud.com/public-cloud/savings-plan/)

 

## Instructions

### OVHcloud Control Panel Access

- **Direct link:** [Public Cloud Projects](https://manager.us.ovhcloud.com/#/public-cloud/pci/projects/)
- **Navigation path:** `Public Cloud` > Select your project

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:

#### Via the OVHcloud Control Panel

Click the `Create a Savings Plan` button.

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

#### Via Terraform

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

#### Via the OVHcloud Control Panel

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.

#### Via the OVHcloud API

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

[GET /services](https://api.us.ovhcloud.com/console/?section=/services&branch=v1#get-/services)

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

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

[GET /services/{serviceId}](https://api.us.ovhcloud.com/console/?section=/services&branch=v1#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:

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](https://api.us.ovhcloud.com/console/?section=/services&branch=v1#get-/services/-serviceId-/savingsPlans/subscribed)

You get a list of Savings Plans as follows:

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}](https://api.us.ovhcloud.com/console/?section=/services&branch=v1#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](https://api.us.ovhcloud.com/console/?section=/services&branch=v1#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:

**Note:** The number of resources can only be increased.

[POST /services/{serviceId}/savingsPlans/subscribed/{savingsPlanId}/changeSize](https://api.us.ovhcloud.com/console/?section=/services&branch=v1#post-/services/-serviceId-/savingsPlans/subscribed/-savingsPlanId-/changeSize)

##### Via Terraform

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

**Note:** Note that only the **service\_name**, **size** and **auto\_renewal** fields can be modified. The **size** can only be increased.

 

## Go further

Browse all the [Public Cloud - General information guides](https://docs.us.ovhcloud.com/en/public-cloud/cross-functional/landing-page-cross-functional.md).

Browse the rest of the [OVHcloud US documentation](https://docs.us.ovhcloud.com/en/index.md) for guides on our other products and services.

Learn more about [Public Cloud](https://us.ovhcloud.com/public-cloud/) on the OVHcloud US website.