Baidu AI Cloud
中国站

百度智能云

Cloud Compute Service

Perform Cross-region Replication of the Custom Image

Description

  • This API is used for the cross-region replication of custom image, which is only limited to the custom image. The system image and service integration image can not be replicated.
  • The image specified by imageId does not exist, and it prompts an error 404.
  • After the successful cross-region replication of image, you can create or reset the instance in the destination region through this image.

Request Structure

POST /v{version}/image/{imageId}?{action} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string

{
    "name" : "destImageName",
    "destRegion" : ["bj","gz"]
}

Request Header Field

There are no other special header fields except the public header field.

Request Parameters

Parameter Name Type Required Parameter Position Description
version String Yes URL parameter API version number
imageId String Yes URL parameter Image ID to replicate
action String Yes Query Parameter Action on image, whose current value is remoteCopy.
name String No Request Body Parameter Replicate the image name.
destRegion List<String> Yes Request Body Parameter Destination regionId, more than one regionId can be uploaded.

Return Header Field

There are no other special header fields except the common header field.

Return Parameter

No specific parameters are returned.

Error Code

Error Code Error Description HTTP Status Code Explanations
Image.RegionNotSupportCopy Region not support copy. 409 The destination region can not be replicated.
Image.ImageStorageFormatInvalid Image storage format is invalid. 409 The image storage format can not be replicated.
Image.ImageNotSupportCopy Image not support copy. 409 The non-custom image can not be replicated.
Image.ImageStatusForbidden Image status is not Available. 409 The image is not available.
Image.LargeImageCopyForbidden Image is larger than 200G. 409 The image larger than 200 GB can not be replicated.

Request Instance

POST /v2/image/m-nky7qeom?remoteCopy HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Date: Wed, 01 Mar 2006 12:00:00 GMT
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
  "name": "test-copy-image",
  "destRegion": ["bj","gz"]
}

Return Instance

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
Previous
Cancel the Shared Custom Image.
Next
Cancel the Cross-region Replicated Custom Image