MigrateInstanceZone - Hologres - Alibaba Cloud Documentation Center

Migrates an instance to a target availability zone. This operation only supports instances deployed across three availability zones. The instance is launched in the target availability zone without migrating its storage. The process takes approximately 5 minutes.

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

PATCH /api/v1/instances/{instanceId}/migrateInstanceZone HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
instanceId	string	No	The instance ID.	hgprecn-cn-i7m2v08uxxxx

Request parameters

Parameter	Type	Required	Description	Example
body	object	No	The request body.
zoneId	string	No	The ID of the target availability zone. Call the `ListMigrationZones` operation to confirm that the target availability zone meets the migration requirements.	cn-hangzhou-h

Response elements

Element	Type	Description	Example
	object	The response object.
requestId	string	The request ID.	819A7F0F-2951-540F-BD94-6A41ECF0281F
data	boolean	Specifies whether the operation was successful. `true` indicates success and `false` indicates failure.	true

Examples

Success response

JSON format

{
  "requestId": "819A7F0F-2951-540F-BD94-6A41ECF0281F",
  "data": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.