华为云用户手册

主体识别示例 本章节对主体识别AK/SK方式使用SDK进行示例说明。 主体识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化ImageMainObjectDetectionReq中的url或image配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 主体识别调用示例代码如下： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 # coding: utf-8 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkimage.v2.region.image_region import ImageRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkimage.v2 import * if __name__ == "__main__": # 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； # 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak = os.getenv("HUAWEICLOUD_SDK_AK") sk = os.getenv("HUAWEICLOUD_SDK_SK") credentials = BasicCredentials(ak, sk) \ client = ImageClient.new_builder() \ .with_credentials(credentials) \ .with_region(ImageRegion.value_of("cn-north-4")) \ //此处替换为您开通服务的区域 .build() try: request = RunImageMainObjectDetectionRequest() request.body = ImageMainObjectDetectionReq( threshold=30, url="https://XXX.jpg" //替换为公网可以访问的图片地址 ) response = client.run_image_main_object_detection(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) 执行示例代码文件，控制台输出主体识别结果即表示程序执行成功。相关参数说明请参考主体识别API。 1 2 3 4 5 6 7 8 { "result": [{ "label": "bounding_box", "location": {"height": 327.77, "top_left_x": 3.7, "top_left_y": 1.72, "width": 463.03}, "confidence": "95.73"}, {"label": "main_object_box", "location": {"height": 328.35, "top_left_x": 3.22, "top_left_y": 1.5, "width": 456.63}, "confidence": "88.35"}] } 父主题： 使用SDK（Python）

翻拍识别示例 本章节对翻拍识别AK/SK方式使用SDK进行示例说明。 翻拍识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用RunRecaptureDetectReq中的withUrl或withImage方法配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 翻拍识别调用示例代码如下： package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.image.v2.region.ImageRegion; import com.huaweicloud.sdk.image.v2.*; import com.huaweicloud.sdk.image.v2.model.*; public class RunRecaptureDetectSolution { public static void main(String[] args) { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 // 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK String ak = System.getenv("HUAWEICLOUD_SDK_AK"); String sk = System.getenv("HUAWEICLOUD_SDK_SK"); ICredential auth = new BasicCredentials() .withAk(ak) .withSk(sk); ImageClient client = ImageClient.newBuilder() .withCredential(auth) .withRegion(ImageRegion.valueOf("cn-north-4")) //此处替换为您开通服务的区域 .build(); RunRecaptureDetectRequest request = new RunRecaptureDetectRequest(); RecaptureDetectReq body = new RecaptureDetectReq(); body.withThreshold(0f); body.withUrl("https://bucketname.obs.cn-north-4.myhuaweicloud.com/image/test1.jpg"); //替换为公网可以访问的图片地址 request.withBody(body); try { RunRecaptureDetectResponse response = client.runRecaptureDetect(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } 执行示例代码文件，控制台输出翻拍识别结果即表示程序执行成功。 class RunRecaptureDetectResponse { result: class RecaptureDetectResponseResult { suggestion: false category: recapture score: 0.9998 detail: [class RecaptureDetectResponseResultDetail { label: recapture confidence: 0.9998 }] } } 父主题： 使用SDK（Java）

名人识别示例 本章节对名人识别AK/SK方式使用SDK进行示例说明。 名人识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化CelebrityRecognitionReq中的url或image配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 名人识别调用示例代码如下： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 # coding: utf-8 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkcore.http.http_config import HttpConfig from huaweicloudsdkimage.v2 import ImageClient,RunCelebrityRecognitionRequest,CelebrityRecognitionReq from huaweicloudsdkimage.v2.region.image_region import ImageRegion if __name__ == "__main__": # 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； # 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak = os.getenv("HUAWEICLOUD_SDK_AK") sk = os.getenv("HUAWEICLOUD_SDK_SK") credentials = BasicCredentials(ak, sk) client = ImageClient.new_builder() \ .with_credentials(credentials) \ .with_region(ImageRegion.value_of("cn-north-1")) \ //此处替换为您开通服务的区域 .build() try: request = RunCelebrityRecognitionRequest() request.body = CelebrityRecognitionReq( threshold=0, url="https://XXX.jpg" //此处替换为公网可以访问的图片地址 ) response = client.run_celebrity_recognition(request) print(response.status_code) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg) 执行示例代码文件，控制台输出名人识别结果即表示程序执行成功。相关参数说明请参考名人识别API。 1 2 3 4 200 {'result': [{'confidence': 0.9990678852332598, 'face_detail': {'h': 510, 'w': 357, 'x': 260, 'y': 201}, 'label': '迈克尔·杰克逊'}]} 父主题： 使用SDK（Python）

主体识别示例 本章节对主体识别AK/SK方式使用SDK进行示例说明。 主体识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用ImageMainObjectDetectionReq中的url或image方法配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 主体识别调用示例代码如下： using System; using System.Collections.Generic; using HuaweiCloud.SDK.Core; using HuaweiCloud.SDK.Core.Auth; using HuaweiCloud.SDK.Image; using HuaweiCloud.SDK.Image.V2; using HuaweiCloud.SDK.Image.V2.Model; namespace RunImageMainObjectDetectionSolution { class Program { static void Main(string[] args) { //认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 //本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK string accessKey= Environment.GetEnvironmentVariable("HUAWEICLOUD_SDK_AK", EnvironmentVariableTarget.Machine); string secretKey= Environment.GetEnvironmentVariable("HUAWEICLOUD_SDK_SK", EnvironmentVariableTarget.Machine); var config = HttpConfig.GetDefaultConfig(); config.IgnoreSslVerification = true; var auth = new BasicCredentials(ak, sk); var client = ImageClient.NewBuilder() .WithCredential(auth) .WithRegion(ImageRegion.ValueOf("cn-north-4")) //此处替换为您开通服务的区域 .WithHttpConfig(config) .Build(); var req = new RunImageMainObjectDetectionRequest { }; req.Body = new ImageMainObjectDetectionReq() { Threshold = 30, Url = "https://XXX.jpg" //替换为公网可以访问的图片地址 }; try { var resp = client.RunImageMainObjectDetection(req); var respStatusCode = resp.HttpStatusCode; Console.WriteLine(respStatusCode); } catch (RequestTimeoutException requestTimeoutException) { Console.WriteLine(requestTimeoutException.ErrorMessage); } catch (ServiceResponseException clientRequestException) { Console.WriteLine(clientRequestException.HttpStatusCode); Console.WriteLine(clientRequestException.ErrorCode); Console.WriteLine(clientRequestException.ErrorMsg); } catch (ConnectionException connectionException) { Console.WriteLine(connectionException.ErrorMessage); } } } } 执行示例代码文件，控制台输出主体识别结果即表示程序执行成功。相关参数说明请参考主体识别API。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 { "result": [{ "confidence": "95.73", "label": "bounding_box", "location": { "height": 327.77, "top_left_x": 3.7, "top_left_y": 1.72, "width": 463.03}}, { "confidence": "88.35", "label": "main_object_box", "location": { "height": 328.35, "top_left_x": 3.22, "top_left_y": 1.5, "width": 456.63} }] } 父主题： 使用SDK（.NET）

图像标签示例 本章节对图像标签AK/SK方式使用SDK进行示例说明。 图像标签示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用ImageTaggingReq中的withUrl或withImage方法配置图像信息（image和url参数二选一），示例中以url为例配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 图像标签调用示例代码如下： package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.image.v2.region.ImageRegion; import com.huaweicloud.sdk.image.v2.*; import com.huaweicloud.sdk.image.v2.model.*; public class RunImageTaggingSolution { public static void main(String[] args) { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 // 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK String ak = System.getenv("HUAWEICLOUD_SDK_AK"); String sk = System.getenv("HUAWEICLOUD_SDK_SK"); ICredential auth = new BasicCredentials() .withAk(ak) .withSk(sk); ImageClient client = ImageClient.newBuilder() .withCredential(auth) .withRegion(ImageRegion.valueOf("XXXX")) //此处替换为您开通服务的区域 .build(); RunImageTaggingRequest request = new RunImageTaggingRequest(); ImageTaggingReq body = new ImageTaggingReq(); body.withLimit(50); body.withThreshold(95f); body.withLanguage("zh"); body.withUrl("https://XXX.jpg"); //此处替换为公网可以访问的图片地址 request.withBody(body); try { RunImageTaggingResponse response = client.runImageTagging(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } } 执行示例代码，控制台返回200即表示程序执行成功。相关参数说明请参考图像标签API。 class RunImageTaggingResponse { result: class ImageTaggingResponseResult { tags: [class ImageTaggingItemBody { confidence: 98.00 type: 树 tag: 树 i18nTag: class ImageTaggingItemBodyI18nTag { zh: 树 en: Tree } i18nType: class ImageTaggingItemBodyI18nType { zh: 树 en: Tree } instances: [] }] } } Process finished with exit code 0 父主题： 使用SDK（Java）

名人识别示例 本章节对名人识别AK/SK方式使用SDK进行示例说明。 名人识别示例代码只需将AK/SK信息替换为实际AK/SK，代码中可以使用初始化CelebrityRecognitionReq中的Image或Url配置图像信息（image和url参数二选一），示例中以url为例，配置完成后运行即可。 endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 名人识别调用示例代码如下： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" image "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/image/v2/region" ) func main() { // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； // 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 ak := os.Getenv("HUAWEICLOUD_SDK_AK") sk := os.Getenv("HUAWEICLOUD_SDK_SK") auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). Build() client := image.NewImageClient( image.ImageClientBuilder(). WithRegion(region.ValueOf("cn-north-1")). //此处替换为您开通服务的区域 WithCredential(auth). Build()) request := &model.RunCelebrityRecognitionRequest{} thresholdCelebrityRecognitionReq:= float32(0.48) urlCelebrityRecognitionReq:= "https://XXX.jpg" //此处替换为公网可以访问的图片地址 request.Body = &model.CelebrityRecognitionReq{ Threshold: &thresholdCelebrityRecognitionReq, Url: &urlCelebrityRecognitionReq, } response, err := client.RunCelebrityRecognition(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } } 识别结果输出到控制台表示执行成功。相关参数说明请参考名人识别API。 1 2 RunCelebrityRecognitionResponse {"result":[{"confidence":0.9990679,"face_detail":{"h":510,"w":357,"x":260,"y":201},"label":"迈克尔·杰克逊"}]} Process exiting with code: 0 父主题： 使用SDK（GO）

访问网站时，为什么会提示不安全？ 若您的网站未绑定SSL证书的，访问都会提示不安全。 如果您需要实现网站HTTPS化，可通过购买SSL证书并部署在网站对应的服务器上来实现。 SSL证书采用SSL协议进行通信，SSL证书部署到服务器后，服务器端的访问将启用HTTPS协议。您的网站将会通过HTTPS加密协议来传输数据，可帮助服务器端和客户端之间建立加密链接，从而保证数据传输的安全。 部署SSL证书后，通过https访问网站时，在地址栏或地址栏右侧有加密锁标志，能直观的表明网站是加密的。使用EV证书，公司名称能直接显示在地址栏。 购买证书详细操作请参见购买证书。

购买证书时，提示证书数量已经达到最大值，是什么意思？ 当您在SCM控制台购买证书时，出现“当前用户证书数量已经达到最大值，不能继续添加”提示信息，表示当前帐号的免费证书额度已用完。如需继续购买SSL证书，建议您购买收费证书。 免费的SSL证书一个帐号最多可以申请20张。同时，为了减少证书资源的浪费，SCM只支持单次申请一张免费证书。 20张的测试证书额度包括：已删除或已吊销证书，即测试证书申请后进行吊销或删除的操作其额度不会恢复。。 同一个帐号不区分主帐号和子帐号。例如，主帐号已使用了20张的额度，则主帐号和子帐号均无测试证书额度。 如果您华为云帐号下的20张测试SSL证书额度已用完，还需继续使用测试证书，可以购买Digicert DV(basic) 单域名扩容包，对测试证书额度进行扩容。详细操作请参见测试证书额度已用完，该如何处理？

约束与限制 满足以下条件（必须全部满足）的SSL证书订单，可申请退订： 您通过华为云SSL证书管理控制台购买了SSL证书。 距离SSL证书订单下单时间（完成支付的时间）不超过7个自然日，即距离SSL证书订单完成支付时间顺延不超过7*24小时。 例如，12月1日12:00完成SSL证书订单支付，则在12月8日11:59前可以退订，12月8日11:59后将不支持退订。 购买7天后不支持退款。 已购买的SSL证书符合以下情况之一： 未提交证书申请，证书状态为“待申请”。 提交过证书申请，证书未签发，且已取消申请，证书状态为“待申请”。 提交过证书申请，证书已签发，且在下单后7个自然日内完成了证书吊销流程（不仅是提交了吊销申请，须完成吊销流程），证书状态为“已吊销”。 全额退款将退还您在购买SSL证书时所支付的费用。 退款仅限于退还您在购买或续费SSL证书或相关服务订单时所支付的费用，代金券、优惠券抵扣的部分不支持退回。 多年期证书，第一张证书已签发，并在下单后7个自然日内完成了证书吊销流程，支持全额退订。

测试（免费）证书使用须知 测试证书一个帐号最多可以申请20张。同时，为了减少证书资源的浪费，SCM只支持单次申请一张测试证书。 20张的测试证书额度包括：已删除或已吊销证书，即测试证书申请后进行吊销或删除的操作其额度不会恢复。。 同一个帐号不区分主帐号和子帐号。例如，主帐号已使用了20张的额度，则主帐号和子帐号均无测试证书额度。 如果您华为云帐号下的20张测试SSL证书额度已用完，还需继续使用测试证书，可以购买Digicert DV(basic) 单域名扩容包，对测试证书额度进行扩容。详细操作请参见测试证书额度已用完，该如何处理？ 一张测试证书仅支持绑定一个单域名。 测试证书不支持保护IP和泛域名（通配符域名）。 测试证书的信任等级和安全性都较低，所以建议只用于测试。 由于DigiCert品牌的DV（Basic）免费证书是无偿提供给个人用户用于测试或个人业务，因此不支持任何免费的人工技术支持或安装指导。如果您需要专业的工程师为您提供SSL证书支撑服务，您可以进入云市场购买HTTPS服务配置全站加密SSL优化检测服务。 测试证书签发后，不支持续费和续期，到期之后，将无法继续使用。如需继续使用SSL证书，请在控制台重新创建。

测试（免费）证书与收费证书的区别 所有SSL证书都具备SSL加密传输功能，都可通过https访问网站，在浏览器上显示安全锁标志。 本章节将介绍免费证书和收费证书的区别。 表1 测试证书和收费证书的区别 区别项 测试证书 收费证书 安全等级 一般 高 证书运行环境的兼容性 一般 高 CA中心对证书的安全保险赔付 不支持 支持 证书数量限制 每个帐号（不区分主帐号和子帐号）仅限20张 不限制 支持保护的网站域名类型 仅支持保护一个单域名 支持保护单域名、多域名、泛域名 支持绑定IP地址 不支持 GlobalSign品牌的OV型证书支持 支持的证书类型 仅DV DV、OV、EV 人工客服支持 不支持 支持 OCSP（Online Certificate Status Protocol，在线证书状态协议） 无本地OCSP，可能会有网络延时或超时情况 除DV (Basic) ，其他付费证书均支持OCSP加速访问 测试证书一般仅用于个人网站或测试使用，不建议业务成熟的企业类型网站使用。 如果您是企业类型网站，建议您购买收费证书。对于政府、金融、电子商务、医疗等组织或机构，推荐使用OV型证书或安全等级最高的EV型证书，不仅让您的用户更信赖您的网站，同时对您的网站数据和身份认证安全提供更强的保障。关于收费证书选型的更多建议，请参见如何选择SSL证书？。 父主题： 测试证书相关

操作步骤 登录您申请域名的域名管理员邮箱。 打开来自CA机构的域名确认邮件。 CA机构发送域名确认邮件需要大约一个工作日。如您短时间内未收到域名确认邮件，请耐心等待。如一个工作日后仍未收到邮件，请检查域名管理员邮箱正确性。 预留域名管理员邮箱地址配置错误：需要您撤回当前SSL证书申请，并重新配置邮箱地址信息，具体操作请参见撤回SSL证书申请，是否撤回成功以华为云SSL证书列表呈现最终状态为准。 预留域名管理员邮箱地址配置无误：一个工作日后仍未收到邮件，请您提工单联系我们，并在工单中进行描述。 单击邮件中的认证按钮，完成域名验证。 验证完成后，CA机构可能还需要一段时间审核域名信息。在此期间，证书状态为“待完成域名验证”。 若您已完成域名验证操作，由于CA机构需要2-3个工作日对您提交的信息进行验证，请您耐心等待。CA机构审核通过后，证书审核才可以进入“待完成组织验证”状态。

一键部署SSL证书至云产品和手动部署SSL证书至云产品的区别是什么？ 在华为云购买申请的SSL证书支持一键部署到WAF、ELB和CDN产品，部署成功后，可以帮助您提升云产品访问数据的安全性，具体操作请参见部署证书。 本章节将介绍一键部署SSL证书至云产品和手动导入证书至云产品的区别。 表1 一键部署和手动部署的区别 区别项 一键部署 手动部署 操作难度 操作便捷 可在云证书管理服务SSL证书管理控制台一键部署。 操作步骤较复杂 需要去对应云产品控制台手动上传，不排除手动操作期间会出现证书链不完整等需要人为处理的问题。 安全性 安全性高 一键部署过程中私钥不会经过人为手动操作，避免了私钥泄露的风险。 安全性一般 私钥会经过人为手动操作。 是否收费 是 第三方上传证书和2023年11月15日之后创建并签发的测试证书部署到华为云产品需要收费，价格为30元/次，详情请参见证书部署服务是如何收费的？。 否 手动部署证书至云产品不收费。 父主题： SSL证书应用类

响应示例 状态码： 200 OK { "group_id" : "9522a7e5-b4fc-44b9-93e1-4dbadbd86e67", "status" : 3, "error_reason" : null, "src_node" : { "bucket" : "dst-test-001", "cloud_type" : "HUAWEICLOUD", "region" : "cn-north-7", "app_id" : "", "object_key" : [ "" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "assess-bucket-1", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 7907369, "start_time" : 1659937788779, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 4128588, "create_complete_num" : null, "success_num" : 0, "fail_num" : 0, "skip_num" : 0, "total_size" : 27814708666, "create_complete_size" : null, "complete_size" : 0, "failed_object_record" : { "result" : null, "list_file_key" : null, "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false }

响应参数 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_msg String 错误信息。 error_code String 错误码。 状态码： 404 表5 响应Body参数 参数 参数类型 描述 error_msg String 错误信息。 error_code String 错误码。 状态码： 503 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误信息。 error_code String 错误码。

请求示例 对子任务31e9b7e6-6ffb-452f-9842-6ce354d99d75创建同步事件，对 [ "test%2F001.txt", "test%2F002.txt" ] 进行同步 /v2/f697f813-554a-4f05-bac8-82a183b20878/sync-tasks/31e9b7e6-6ffb-452f-9842-6ce354d99d75/events { "object_keys" : [ "test%2F001.txt", "test%2F002.txt" ] } 对子任务31e9b7e6-6ffb-452f-9842-6ce354d99d75创建同步事件，对 [ "test%2B001.txt"] 进行同步 /v2/f697f813-554a-4f05-bac8-82a183b20878/sync-tasks/31e9b7e6-6ffb-452f-9842-6ce354d99d75/events { "object_keys" : [ "test%2B001.txt" ] } 对子任务31e9b7e6-6ffb-452f-9842-6ce354d99d75创建同步事件，对 [ "test+001.txt" ] 进行同步 /v2/f697f813-554a-4f05-bac8-82a183b20878/sync-tasks/31e9b7e6-6ffb-452f-9842-6ce354d99d75/events { "object_keys" : [ "test+001.txt" ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String API认证鉴权的Token认证方式。推荐使用Authorization签名认证方式，具体请参考API认证鉴权 最小长度：1 最大长度：16384 表3 请求Body参数 参数 是否必选 参数类型 描述 object_keys 是 Array of strings 待同步对象的列表,其中待同步对象最大数量为10,列表中object_key为URL编码处理后的结果 最小长度：1 最大长度：16384 数组长度：1 - 100

请求示例 使用阿里云A方式进行https CDN方式迁移，开启按时段限速，限速值为50MB/S，将对象列表object_list_file.txt中的对象列表执行迁移，并开启迁移结果通知。 POST https://{endpoint}/v2/{project_id}/tasks { "task_type" : "list", "src_node" : { "cloud_type" : "HuaweiCloud", "region" : "cn-north-1", "bucket" : "src_bucket", "ak" : "src_ak", "sk" : "src_sk", "list_file" : { "obs_bucket" : "list_file_bucket", "list_file_key" : "object_list_file.txt" } }, "dst_node" : { "region" : "cn-north-1", "ak" : "dst_ak", "sk" : "dst_sk", "bucket" : "dst_bucket" }, "enable_kms" : false, "enable_failed_object_recording" : true, "description" : "xxx", "migrate_since" : 123456789, "bandwidth_policy" : [ { "start" : "00:00", "end" : "23:59", "max_bandwidth" : 50000000 } ], "source_cdn" : { "protocol" : "https", "domain" : "xxx.xxx.xxx", "authentication_type" : "ALIYUN_OSS_A", "authentication_key" : "xxx" }, "smn_config" : { "topic_urn" : "urn:smn:region:4cf2090802d94440b4cdd72ef26857b2:OMS", "trigger_conditions" : [ "SUCCESS", "FAILURE" ], "language" : "en-us" } } 使用阿里云A方式进行https CDN方式迁移，开启按时段限速，限速值为50MB/S，将对象文件/前缀["file1.xxx", "file2.xxx", "path1/"]进行迁移，并开启迁移结果通知 POST https://{endpoint}/v2/{project_id}/tasks { "task_type" : "object", "src_node" : { "cloud_type" : "HuaweiCloud", "region" : "cn-north-1", "bucket" : "src_bucket", "ak" : "src_ak", "sk" : "src_sk", "object_key" : [ "file1.xxx", "file2.xxx", "path1/" ] }, "dst_node" : { "region" : "cn-north-1", "ak" : "dst_ak", "sk" : "dst_sk", "bucket" : "dst_bucket" }, "enable_kms" : false, "enable_failed_object_recording" : true, "description" : "xxx", "migrate_since" : 123456789, "bandwidth_policy" : [ { "start" : "00:00", "end" : "23:59", "max_bandwidth" : 50000000 } ], "source_cdn" : { "protocol" : "https", "domain" : "xxx.xxx.xxx", "authentication_type" : "ALIYUN_OSS_A", "authentication_key" : "xxx" }, "smn_config" : { "topic_urn" : "urn:smn:region:4cf2090802d94440b4cdd72ef26857b2:OMS", "trigger_conditions" : [ "SUCCESS", "FAILURE" ], "language" : "en-us" } } 创建URL列表迁移任务，将object_list_file.txt中的URL列表执行迁移。 POST https://{endpoint}/v2/{project_id}/tasks { "task_type" : "url_list", "src_node" : { "cloud_type" : "URLSource", "list_file" : { "obs_bucket" : "list_file_bucket", "list_file_key" : "object_list_file.txt" } }, "dst_node" : { "region" : "cn-north-1", "ak" : "dst_ak", "sk" : "dst_sk", "bucket" : "dst_bucket" }, "enable_kms" : false, "enable_failed_object_recording" : true, "description" : "xxx" } 创建前缀迁移任务，将[ "abc", "123", "prefix3", "path/prefix4" ]为前缀的对象文件进行迁移。 POST https://{endpoint}/v2/{project_id}/tasks { "task_type" : "prefix", "src_node" : { "cloud_type" : "HuaweiCloud", "region" : "cn-north-1", "bucket" : "src_bucket", "ak" : "src_ak", "sk" : "src_sk", "object_key" : [ "abc", "123", "prefix3", "path/prefix4" ] }, "dst_node" : { "region" : "cn-north-1", "ak" : "dst_ak", "sk" : "dst_sk", "bucket" : "dst_bucket" }, "enable_kms" : false, "enable_failed_object_recording" : true, "description" : "xxx" }

URI GET /v2/{project_id}/taskgroups 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID 最小长度：1 最大长度：1024 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 查询返回迁移组任务列表当前页面的数量，默认查询10条。 最多返回100条迁移任务信息。 最小值：1 最大值：100 缺省值：10 offset 否 Integer 起始的任务序号，默认为0。 取值大于等于0，取值为0时从第一条开始查询。 最小值：0 最大值：10000 缺省值：0 status 否 Integer 迁移任务组状态（无该参数时代表查询所有状态的任务） 0 – 等待中 1 – 执行中/创建中 2 – 监控任务执行 3 – 暂停 4 – 创建任务失败 5 – 迁移失败 6 – 迁移完成 7 – 暂停中 8 – 等待删除中 9 – 删除 最小值：0 最大值：9

响应示例 状态码： 200 Ok { "count" : 353, "taskgroups" : [ { "group_id" : "9dd98a5e-7ea3-4d80-abff-4c23914313e4", "status" : 6, "error_reason" : null, "src_node" : { "bucket" : "api-auto-test", "cloud_type" : "TENCENT", "region" : "ap-beijing", "app_id" : "1254563210", "object_key" : [ "test" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "test-l30022277", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 973657, "start_time" : 1663654062461, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 6, "create_complete_num" : null, "success_num" : 6, "fail_num" : 0, "skip_num" : 0, "total_size" : 2469022100, "create_complete_size" : null, "complete_size" : 2469022100, "failed_object_record" : { "result" : null, "list_file_key" : null, "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false }, { "group_id" : "2597fc69-af30-4411-b59d-b37857b69792", "status" : 6, "error_reason" : null, "src_node" : { "bucket" : "test-retry", "cloud_type" : "HUAWEICLOUD", "region" : "cn-north-7", "app_id" : "", "object_key" : [ "%21" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "assess-bucket-1", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 43440, "start_time" : 1663340552910, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 1, "create_complete_num" : null, "success_num" : 0, "fail_num" : 0, "skip_num" : 1, "total_size" : 1205, "create_complete_size" : null, "complete_size" : 1205, "failed_object_record" : { "result" : null, "list_file_key" : null, "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false }, { "group_id" : "d85ed5a8-61a1-492f-a146-2fd092dc37cf", "status" : 5, "error_reason" : null, "src_node" : { "bucket" : "assess-bucket-1", "cloud_type" : "HUAWEICLOUD", "region" : "cn-north-7", "app_id" : "", "object_key" : [ "" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "assess-bucket-1", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 4047612, "start_time" : 1663070894867, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 99020, "create_complete_num" : null, "success_num" : 0, "fail_num" : 99020, "skip_num" : 0, "total_size" : 954329692, "create_complete_size" : null, "complete_size" : 954329692, "failed_object_record" : { "result" : true, "list_file_key" : "oms/task_group/d85ed5a8-61a1-492f-a146-2fd092dc37cf/failed_object_lists/", "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false }, { "group_id" : "2a84320a-eddb-4413-9b12-a0251aae0f3e", "status" : 6, "error_reason" : null, "src_node" : { "bucket" : "api-test", "cloud_type" : "UCLOUD", "region" : "cn-bj", "app_id" : "", "object_key" : [ "test" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "test-l30022277", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 63228, "start_time" : 1662725286648, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 6, "create_complete_num" : null, "success_num" : 5, "fail_num" : 0, "skip_num" : 1, "total_size" : 0, "create_complete_size" : null, "complete_size" : 0, "failed_object_record" : { "result" : null, "list_file_key" : null, "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false }, { "group_id" : "64bca3b2-6ccc-4ca4-8394-17d3c7bdf871", "status" : 6, "error_reason" : null, "src_node" : { "bucket" : "api-auto-test", "cloud_type" : "TENCENT", "region" : "ap-beijing", "app_id" : "1254563210", "object_key" : [ "test" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "test-l30022277", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 553999, "start_time" : 1662725057215, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 6, "create_complete_num" : null, "success_num" : 6, "fail_num" : 0, "skip_num" : 0, "total_size" : 2469022100, "create_complete_size" : null, "complete_size" : 2469022100, "failed_object_record" : { "result" : null, "list_file_key" : null, "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false }, { "group_id" : "4c019e94-9ac1-4cd6-b404-982816b20c2f", "status" : 6, "error_reason" : null, "src_node" : { "bucket" : "api-auto-hangzhou", "cloud_type" : "ALIYUN", "region" : "cn-hangzhou", "app_id" : "", "object_key" : [ "test" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "test-l30022277", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 33279, "start_time" : 1662723650469, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 3, "create_complete_num" : null, "success_num" : 3, "fail_num" : 0, "skip_num" : 0, "total_size" : 31840, "create_complete_size" : null, "complete_size" : 31840, "failed_object_record" : { "result" : null, "list_file_key" : null, "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false }, { "group_id" : "5f5dd578-a3a6-4324-ad64-647a38ffb395", "status" : 6, "error_reason" : null, "src_node" : { "bucket" : "api-auto-test", "cloud_type" : "BAIDU", "region" : "bj", "app_id" : "", "object_key" : [ "test" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "assess-bucket-1", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 53427, "start_time" : 1662722500472, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 15, "create_complete_num" : null, "success_num" : 15, "fail_num" : 0, "skip_num" : 0, "total_size" : 94864941, "create_complete_size" : null, "complete_size" : 94864941, "failed_object_record" : { "result" : null, "list_file_key" : null, "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false }, { "group_id" : "912e951b-ae19-4f65-bb94-c889601d8a43", "status" : 6, "error_reason" : null, "src_node" : { "bucket" : "assess-bucket-1", "cloud_type" : "HUAWEICLOUD", "region" : "cn-north-7", "app_id" : "", "object_key" : [ "" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "oms-onebox-lqm", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 590588, "start_time" : 1662640213374, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 99052, "create_complete_num" : null, "success_num" : 99052, "fail_num" : 0, "skip_num" : 0, "total_size" : 1847919442, "create_complete_size" : null, "complete_size" : 1847919442, "failed_object_record" : { "result" : null, "list_file_key" : null, "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false }, { "group_id" : "398b5845-b180-47a1-a7c9-56f051ed3f34", "status" : 5, "error_reason" : null, "src_node" : { "bucket" : "hw-src", "cloud_type" : "HUAWEICLOUD", "region" : "cn-north-7", "app_id" : "", "object_key" : [ "gd.jpg" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "zzww", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 709891300, "start_time" : 1662369530210, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 1, "create_complete_num" : null, "success_num" : 0, "fail_num" : 1, "skip_num" : 0, "total_size" : 3528, "create_complete_size" : null, "complete_size" : 0, "failed_object_record" : { "result" : true, "list_file_key" : "oms/task_group/398b5845-b180-47a1-a7c9-56f051ed3f34/failed_object_lists/", "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false }, { "group_id" : "494cad85-cbe5-4d62-8e70-e4f0e847e39c", "status" : 6, "error_reason" : null, "src_node" : { "bucket" : "test-l30022277-src", "cloud_type" : "HUAWEICLOUD", "region" : "cn-north-7", "app_id" : "", "object_key" : [ "test" ], "list_file" : null }, "description" : "", "dst_node" : { "bucket" : "test-l30022277", "region" : "cn-north-7", "save_prefix" : "" }, "enable_metadata_migration" : false, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_kms" : false, "task_type" : "PREFIX", "bandwidth_policy" : [ ], "smn_config" : null, "source_cdn" : null, "migrate_since" : 0, "migrate_speed" : 0, "total_time" : 33513, "start_time" : 1661928705453, "total_task_num" : null, "create_task_num" : null, "failed_task_num" : null, "complete_task_num" : null, "paused_task_num" : null, "executing_task_num" : null, "waiting_task_num" : null, "total_num" : 2, "create_complete_num" : null, "success_num" : 0, "fail_num" : 0, "skip_num" : 2, "total_size" : 155, "create_complete_size" : null, "complete_size" : 155, "failed_object_record" : { "result" : null, "list_file_key" : null, "error_code" : null }, "object_overwrite_mode" : "SIZE_LAST_MODIFIED_COMPARISON_OVERWRITE", "consistency_check" : "size_last_modified", "enable_requester_pays" : false } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 [数组元素] Array of ShowRegionInfoResp objects 查询Region信息响应体 表4 ShowRegionInfoResp 参数 参数类型 描述 service_name String 服务名称 最小长度：0 最大长度：255 region_list Array of RegionInfo objects Region列表 数组长度：0 - 1024 表5 RegionInfo 参数 参数类型 描述 cloud_type String 云服务名称 最小长度：1 最大长度：255 value String region名称 最小长度：1 最大长度：255 description String region的描述信息 最小长度：0 最大长度：1024

响应示例 状态码： 200 查询Region信息响应体 [ { "service_name" : "AWS", "region_list" : [ { "cloud_type" : "AWS", "value" : "us-east-1", "description" : "US Standard (N. Virginia)" }, { "cloud_type" : "AWS", "value" : "us-west-1", "description" : "US West (N. California)" }, { "cloud_type" : "AWS", "value" : "us-west-2", "description" : "US West (Oregon)" }, { "cloud_type" : "AWS", "value" : "eu-west-1", "description" : "EU (Ireland)" }, { "cloud_type" : "AWS", "value" : "eu-central-1", "description" : "EU (Frankfurt)" }, { "cloud_type" : "AWS", "value" : "ap-northeast-1", "description" : "Asia Pacific (Tokyo)" }, { "cloud_type" : "AWS", "value" : "ap-northeast-2", "description" : "Asia Pacific (Seoul)" }, { "cloud_type" : "AWS", "value" : "ap-southeast-1", "description" : "Asia Pacific (Singapore)" }, { "cloud_type" : "AWS", "value" : "ap-southeast-2", "description" : "Asia Pacific (Sydney)" }, { "cloud_type" : "AWS", "value" : "ap-south-1", "description" : "Asia Pacific (Mumbai)" }, { "cloud_type" : "AWS", "value" : "sa-east-1", "description" : "South America (Sao Paulo)" }, { "cloud_type" : "AWS", "value" : "us-east-2", "description" : "US East (Ohio)" }, { "cloud_type" : "AWS", "value" : "eu-west-2", "description" : "EU (London)" }, { "cloud_type" : "AWS", "value" : "ca-central-1", "description" : "Canada (Central)" }, { "cloud_type" : "AWS", "value" : "ap-east-1", "description" : "Asia Pacific (Hong Kong)" } ] } ]

请求示例 根据给出信息查询桶对象，返回分页的桶对象列表 POST https://{endpoint}/v2/{project_id}/objectstorage/buckets/objects { "page_size": 100, "behind_filename": "", "file_path": "A/", "cloud_type": "HuaweiCloud", "bucket_name": "xxx" "ak": "xxxxxak", "sk": "xxxxxsk", "data_center": "cn-north-x" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 next_page Boolean 是否存在下一页 next_marker String 查询下一页所需要的标记（此页末尾对象名，偏移量） 最小长度：0 最大长度：1024 records Array of ShowBucketRecord objects 查询桶信息返回的record 数组长度：0 - 100 表5 ShowBucketRecord 参数 参数类型 描述 name String 对象名 最小长度：0 最大长度：1024 size String 对象大小，若对象无size属性，则返回-- 最小长度：0 最大长度：100 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误信息。 error_code String 错误码。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token认证，需要确认Token中包含的Project ID与请求URI中修改资源的Project ID匹配。 最小长度：1 最大长度：16384 表3 请求Body参数 参数 是否必选 参数类型 描述 cloud_type 是 String 云类型 AWS：亚马逊 Aliyun：阿里云 Qiniu：七牛云 QingCloud：青云 Tencent：腾讯云 Baidu：百度云 KingsoftCloud：金山云 Azure：微软云 UCloud：优刻得 HuaweiCloud：华为云 URLSource：URL HEC：HEC 最小长度：0 最大长度：100 file_path 是 String 目标桶中需要查询的对象文件路径，/结尾 最小长度：0 最大长度：1023 ak 否 String 源端桶的AK（最大长度100个字符） 最小长度：0 最大长度：100 sk 否 String 源端桶的SK（最大长度100个字符） 最小长度：0 最大长度：100 data_center 是 String 数据中心，区域 最小长度：0 最大长度：100 page_size 是 Integer 分页信息，页大小 最小值：0 最大值：100 behind_filename 是 String 分页信息，当前页最后一个对象名称（偏移量） 最小长度：0 最大长度：1024 app_id 否 String 当源端为腾讯云时，会返回此参数。 最小长度：0 最大长度：255 bucket_name 是 String 桶名 最小长度：0 最大长度：100

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String IAM Token认证，需要确认Token中包含的Project ID与请求URI中修改资源的Project ID匹配。 最小长度：1 最大长度：16384 表3 请求Body参数 参数 是否必选 参数类型 描述 cloud_type 是 String 云类型 AWS：亚马逊 Aliyun：阿里云 Qiniu：七牛云 QingCloud：青云 Tencent：腾讯云 Baidu：百度云 KingsoftCloud：金山云 Azure：微软云 UCloud：优刻得 HuaweiCloud：华为云 URLSource：URL HEC：HEC 缺省值：Aliyun 最小长度：0 最大长度：100 ak 否 String 源端桶的AK（最大长度100个字符），task_type为非url_list时，本参数为必选。 最小长度：0 最大长度：100 sk 否 String 源端桶的SK（最大长度100个字符），task_type为非url_list时，本参数为必选。 最小长度：0 最大长度：100 app_id 否 String 当源端为腾讯云时，会返回此参数。 最小长度：0 最大长度：255 bucket_name 是 String 桶名 最小长度：0 最大长度：100 file_name 是 String 前缀名称 最小长度：0 最大长度：1024 data_center 是 String 数据中心，区域 最小长度：0 最大长度：100 security_token 否 String 安全令牌 最小长度：0 最大长度：16384

请求示例 检查xxxx的前缀是否在xxx桶中存在 POST https://{endpoint}/v2/{project_id}/objectstorage/buckets/prefix { "cloud_type" : "HuaweiCloud", "ak" : "xxxxak", "sk" : "xxxxsk", "app_id" : "apptest123", "bucket_name" : "xxx", "file_name" : "xxxx", "data_center" : "cn-north-x", "security_token" : "string" }

请求示例 创建迁移任务组任务，以hw/目录下的txt文件中的对象列表信息作为华为云桶bucket的源端数据，迁移至目的端桶zzww。 POST https://{endpoint}/v2/{project_id}/taskgroups { "enable_failed_object_recording" : true, "src_node" : { "bucket" : "hw-src", "cloud_type" : "HuaweiCloud", "ak" : "******", "sk" : "******", "region" : "cn-north-7", "list_file" : { "obs_bucket" : "list-file-bucket", "list_file_key" : "hw/" } }, "enable_kms" : false, "task_type" : "LIST", "enable_restore" : false, "dst_node" : { "bucket" : "zzww", "cloud_type" : "HEC", "ak" : "******", "sk" : "******", "region" : "cn-north-7" }, "enable_metadata_migration" : true } 创建迁移任务组任务，将前缀为Objectlist的对象从源端桶src-bucket迁移至目的端桶dst-bucket。 POST https://{endpoint}/v2/{project_id}/taskgroups { "src_node" : { "region" : "cn-north-4", "ak" : "******", "sk" : "******.", "bucket" : "src-bucket", "cloud_type" : "HuaweiCloud", "object_key" : [ "Objectlist" ] }, "dst_node" : { "region" : "cn-north-4", "ak" : "******", "sk" : "******", "bucket" : "dst-bucket" }, "task_type" : "PREFIX", "enable_failed_object_recording" : true, "enable_kms" : false, "bandwidth_policy" : [ { "max_bandwidth" : 1048576, "start" : "00:01", "end" : "23:59" } ] } 创建迁移任务组任务，以test01/路径下的txt文件作为URL列表目录，迁移至目的端桶jjyy。 POST https://{endpoint}/v2/{project_id}/taskgroups { "src_node" : { "cloud_type" : "URLSource", "list_file" : { "obs_bucket" : "url-file-bucket", "list_file_key" : "test01/" } }, "description" : "", "dst_node" : { "region" : "cn-north-4", "ak" : "******", "sk" : "******.", "bucket" : "jjyy", "cloud_type" : "HEC" }, "enable_failed_object_recording" : true, "enable_restore" : false, "enable_metadata_migration" : false, "enable_kms" : false, "task_type" : "URL_LIST" }

响应参数 状态码： 200 表10 响应Body参数 参数 参数类型 描述 group_id String 创建的迁移任务组id 最小长度：1 最大长度：100 状态码： 400 表11 响应Body参数 参数 参数类型 描述 error_msg String 错误信息。 error_code String 错误码。 状态码： 403 表12 响应Body参数 参数 参数类型 描述 error_msg String 错误信息。 error_code String 错误码。 状态码： 500 表13 响应Body参数 参数 参数类型 描述 error_msg String 错误信息。 error_code String 错误码。

URI GET /v2/{project_id}/tasks 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID 最小长度：1 最大长度：1024 表2 Query参数 参数 是否必选 参数类型 描述 group_id 否 String 迁移任务组group_id 最小长度：1 最大长度：100 limit 否 Integer 查询返回迁移任务列表当前页面的数量，默认查询10条。 最多返回100条迁移任务信息。 最小值：1 最大值：100 缺省值：10 offset 否 Integer 起始的任务序号，默认为0。 取值大于等于0，取值为0时从第一条开始查询。 最小值：0 最大值：10000 缺省值：0 status 否 Integer 迁移任务状态（无该参数时代表查询所有状态的任务）： 1：等待调度 2：正在执行 3：停止 4：失败 5：成功 7: 暂停中 最小值：1 最大值：7