All Products
Search

This Product

    Compute Nest:Upgrade a service instance

    Document Center

    Compute Nest:Upgrade a service instance

    Last Updated:Apr 16, 2026

    After a service provider publishes a new version, both customers and service providers can upgrade service instances to the new version. Customers can upgrade one service instance at a time. Service providers can upgrade multiple service instances in a single batch operation.

    Prerequisites

    Before you begin, make sure that:

    • The service has at least two versions, and the later version supports service instance upgrades. To create a new service version, see Update a service. To enable upgrades on a service version, see Configure service upgrades

    • At least one service instance running an earlier version is deployed. For details, see Deploy service instances

    Upgrade a single service instance

    1. Log on to the Compute Nest console.Compute Nest console

    2. In the left-side navigation pane, click Service Instance.

    3. On the Service Instance page, find the service instance to upgrade and click its ID to go to the Service Instance page.

    4. In the upper-right corner, click Upgrade Service Instance.

    5. In the Upgrade Service Instance dialog box, select the target version and click Start Upgrade. The service instance enters the Upgrading state. When the upgrade completes, the state changes to Deployed and the service version updates to the version you selected.

    Upgrade multiple service instances

    As a service provider, use batch upgrade to upgrade private service instances and single-tenant fully managed service instances across your customers in one operation. You must have upgrade permissions on the target instances.

    How it works

    Batch upgrade uses CloudOps Orchestration Service (OOS) and the BulkyUpgradeServiceInstance template.

    1. The configured parameters trigger a call to the ListServiceInstances operation to query the list of service instances to upgrade.

    2. OOS iterates through the list and calls UpdateServiceInstanceSpec on each instance. You control how many instances are upgraded concurrently.

    3. If any instance fails to upgrade, the task stops immediately. Instances not yet processed remain on their current version.

    Upgrade multiple instances

    1. Log on to the Compute Nest console.

    2. In the left-side navigation pane, click Service Instance. On the Service Instance page, click the My Service Instance tab.

    3. Find one of the service instances you want to upgrade and click its service ID to go to the Service Details page.

    4. Click the O&M Management tab.

    5. In the upper-right corner, click Batch Upgrade.

    6. In the Batch Upgrade dialog box, configure the following parameters: Control Options (optional — Compute Nest applies default settings if left blank)

      Configure Parameters

      Parameter Description
      Upgrade Service Version Select the target version. After selection, the list of instances eligible for upgrade to that version is displayed.
      Instance Select the instances to upgrade using one of these methods: manually select by status and version; filter by tag (one or more tags in the same region); filter by resource group (a resource group in a region); or select all instances matching the specified status and version.
      Parameter Description
      RateControl Controls the upgrade rate. Select Concurrency-based Control and set Concurrency and Error Threshold, or select Batch-based Control and set Batch Array, Concurrency-based Control, and Error Threshold. For details, see Control the loop execution rate.
      OOSAssumeRole Select a Resource Access Management (RAM) role for OOS to assume during the upgrade.

      Task Settings

      Parameter Description
      Task Description Enter a brief description for the batch upgrade task.

    7. Click Next. Review the basic information and resource preview in the OK step.

    8. Click Create.

    9. On the O&M Management tab, find the task and click Details in the Actions column to view its execution status.

    What's next