All Products
Search
Document Center

Hologres:ListMigrationZones

Last Updated:May 21, 2026

Lists the availability zones to which an instance can be migrated. This operation applies to instances that are deployed across three availability zones.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET /api/v1/instances/{instanceId}/listMigrationZones HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

instanceId

string

Yes

The ID of the instance.

hgprecn-cn-g9j4olkzhxxx

Request parameters

Parameter

Type

Required

Description

Example

maxResults

integer

No

The maximum number of results to return per page.

10

nextToken

string

No

The token from a previous call to retrieve the next page of results. Omit this parameter to get the first page.

2

Response elements

Element

Type

Description

Example

object

The response schema.

requestId

string

The request ID.

819A7F0F-2951-540F-BD94-6A41ECF0281F

zoneList

array<object>

The list of availability zones.

object

zoneId

string

The ID of the availability zone.

cn-beijing-i

available

boolean

Indicates whether the instance can be migrated to the availability zone. A value of false indicates that the migration conditions are not met.

true

maxResults

integer

The maximum number of results returned per page.

10

nextToken

string

A token used to retrieve the next page of results. This parameter is not returned if no more results are available.

11

Examples

Success response

JSON format

{
  "requestId": "819A7F0F-2951-540F-BD94-6A41ECF0281F",
  "zoneList": [
    {
      "zoneId": "cn-beijing-i",
      "available": true
    }
  ],
  "maxResults": 10,
  "nextToken": "11"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.