Copy Images

Last updated: 2020-06-05 20:20:46

    Note:

    This is a legacy API which has been hidden and will no longer be updated. We recommend using the new CVM API 3.0 which is standardized and faster.

    1. API Description

    This API (SyncCvmImage) is used to synchronize a custom image to another region.

    Domain name for API request: image.api.qcloud.com

    • Image service is FREE of charge now.
    • Users can synchronize custom images to different regions.
    • A maximum of 10 custom images can be created for each region.
    • You can use DescribeImages API to query the synchronization information of images. Status of 4 indicates that the image is being synchronized (destination region), and status of 5 indicates that the image is being copied (source region).
    • This does not apply to North America region.

    2. Input Parameters

    The following list only provides API request parameters. For additional parameters, refer to Common Request Parameters page.

    Parameter Name Required Type Description
    srcRegion Yes String The region to which the source image belongs. Input the code such as gz, sh. It can be obtained from DescribeProductRegionList API.
    imgIdList.n Yes String Image ID. It can be obtained from unImgId in the returned value of DescribeImages API (this API allows passing multiple IDs at a time. For the format of this parameter, refer to id.n section of API Introduction).
    dstRegion.n Yes String The region to which the image need to be synchronized. Input the code, such as gz, sh.

    3. Output Parameters

    Parameter Name Type Description
    code Int Common error code. A value of 0 indicates success, and other values indicate failure. For more information, refer to Common Error Codes on Error Code page.
    message String Module error message description depending on API. For more information, refer to Module Error Codes on Error Code page.

    4. Example

    Input

      https://image.api.qcloud.com/v2/index.php?Action=SyncCvmImage
      &srcRegion=gz
      &imgIdList.0=1
      &dstRegion.0=sh
      &desRegion.1=hk
      &<Common request parameters>
    

    Output

    {
        "code": 0,
        "message": ""
    }

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help