Suggest an edit

Changing the commercial type of an Instance with the API or CLI

Reviewed on 19 February 2024Published on 26 May 2021

It is possible to change the commercial type of an Instance by using the Scaleway CLI tool or the Instances API. To do so, you need the Instance’s ID and a valid API key.

Before you start

To complete the actions presented below, you must have:

  • A Scaleway account logged into the console
  • Owner status or IAM permissions allowing you to perform actions in the intended Organization
  • An Instance, which must be stopped and not be in a placement group
  1. Stop the Instance.

    scw instance server stop <instance_id> zone=<zone>

    Replace <zone> with the Availability Zone of your Instance. For example, if your Instance is located in Paris-1, the zone would be fr-par-1. Replace <instance_id> with the ID of your Instance.


    You can find the ID of your Instance on it’s overview page in the Scaleway console or using the CLI by running the following command: scw instance server list.

  2. Update the commercial type of the Instance

    scw instance server update <instance_id> commercial-type=<NEW_INSTANCE_TYPE> zone=<zone>

    Replace <new_instance_type> with the desired new commercial type.


    You can retrieve a list of all available Instance types using the command scw instance server-type list.


    Ensure that local storage constraints are respected. For example, downgrading from a larger Instance type to a smaller one may not be possible if the smaller Instance type cannot support the existing local storage. Check the Scaleway documentation for specific constraints.

  3. Power on the Instance.

    scw instance server start <instance_id> zone=<zone>

You have successfully changed the commercial type of your Scaleway Instance using the Scaleway CLI. For further information, refer to the Instance CLI documentation.

Docs APIScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCarreer
© 2023-2024 – Scaleway