Updating your pricing plan

You can update the pricing plan of an IBM Cloud® service if plan updates are enabled for the specific service. For example, you might want to upgrade or reduce your pricing plan. You can update the service's pricing plan from the service instance dashboard.

Are you looking for details about upgrading your account type? See Upgrading your account for more information.

You can update the pricing plan only for certain services. If plan updates are enabled for the service, a Plan option is displayed on the service instance dashboard. Each service has a different set of steps to follow if you update your plan.

Updating a plan in the console

From the IBM Cloud console, click the Navigation Menu icon > Resource list, and select the service.
Click Plan in the service instance dashboard. Select the pricing plan that you want, and click Save.

Some services have pricing plans that are not selectable from the Plan page. Typically, these plans aren't selectable because they require assistance from the IBM Cloud Sales team or they require a migration before you can update plans. See the documentation for the specific service for information about the required next steps.

Depending on the type of plan updates you make, your next steps can vary. For example, if you reduced the pricing plan, restart your app. Or, if you upgraded the pricing plan, you might need to restart your app, and then take other actions.

Complete the following steps to restart your app:

Click the Navigation Menu icon > Resource List, and find the app that the service is bound to.
From the app menu, select Restart App.

For more information about any further required actions, see the documentation for the specific service.

Updating a pricing plan by using the CLI

Complete the following steps to update a pricing plan by using the IBM Cloud command-line interface (CLI).

Check whether the service is enabled with the resource controller.

ibmcloud catalog service <service_name>

The output lists RC Compatible true. Make a note of the ID of the plan that you want to update to.

RC Compatible      true
RC Provisionable   true
IAM Compatible     true
Children   Name                      Kind         ID
           lite                      plan         4bcd3fgh-3cf2-47c0-93d4-d2f2289eac28
           standard                  plan         264d0450-996d-4bcd-894d-fc7018dacf1e

Update the pricing plan for your service instance.
- If the service is enabled with the resource controller, run the ibmcloud resource service-instance-update command.
```
ibmcloud resource service-instance-update <service_instance_name> --service-plan-id <plan_id>
```

Updating a pricing plan by using the API

You can programmatically update a pricing plan for a service by calling the IBM Cloud Resource Controller API as shown in the following sample request. The example updates a pricing plan for an instance.

curl -X PATCH https://resource-controller.cloud.ibm.com/v2/resource_instances/8d7af921-b136-4078-9666-081bd8470d94 -H 'Authorization: Bearer <>' -H 'Content-Type: application/json' -d '{
    "name": "my-instance-new-binding-1",
    "resource_plan_id": "744bfc56-d12c-4866-88d5-dac9139e0e5d"
  }'

Map<String, Object> parameters = new HashMap<String, Object>();
parameters.put("exampleProperty", "exampleValue");

UpdateResourceInstanceOptions updateResourceInstanceOptions = new UpdateResourceInstanceOptions.Builder()
  .id(instanceGuid)
  .name(resourceInstanceUpdateName)
  .parameters(parameters)
  .build();

Response<ResourceInstance> response = service.updateResourceInstance(updateResourceInstanceOptions).execute();
ResourceInstance resourceInstance = response.getResult();

System.out.printf("updateResourceInstance() response:\n%s\n", resourceInstance.toString());

getAccountUsage(params)

parameters = {
    'exampleProperty': 'exampleValue'
}
resource_instance = resource_controller_service.update_resource_instance(
    id=instance_guid,
    name=resource_instance_update_name,
    parameters=parameters
).get_result()

print('\nupdate_resource_instance() response:\n',
      json.dumps(resource_instance, indent=2))

parameters := map[string]interface{}{"exampleProperty": "exampleValue"}
updateResourceInstanceOptions := resourceControllerService.NewUpdateResourceInstanceOptions(
  instanceGUID,
)
updateResourceInstanceOptions = updateResourceInstanceOptions.SetName(resourceInstanceUpdateName)
updateResourceInstanceOptions = updateResourceInstanceOptions.SetParameters(parameters)

resourceInstance, response, err := resourceControllerService.UpdateResourceInstance(updateResourceInstanceOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(resourceInstance, "", "  ")
fmt.Printf("\nUpdateResourceInstance() response:\n%s\n", string(b))