订购包年/包月产品
功能介绍

此接口仅提供给已经接入CBC的合作伙伴使用,对于新接入的合作伙伴请使用云服务相关接口。
合作伙伴平台可以调用该接口进行包年/包月产品的下单动作。在调用该接口前,订购包年/包月产品的客户需要先在华为云开通华为云的账户和进行实名认证。并且客户账户上有足够的金额。
注意事项:
- 该接口受限发布,如需使用,请联系合作伙伴对口的客户经理。
- 按需产品服务无需调用该接口。
- 该接口只允许使用合作伙伴AK/SK或者Token调用。
- 下单前需要先调用“生成订单号”接口获取订单号。
- 下单完成之后还需要调用“支付包年/包月产品订单”接口进行订单支付,服务才能开通。
请求消息
请求参数
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
customerId |
是 |
String |
最大长度:64 |
客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。 |
xroleName |
是 |
String |
最大长度:64 |
分解给合作伙伴的角色名称,华为分配。 与合作伙伴平台标识“xaccountType”取值一致。 |
orderId |
是 |
String |
最大长度:64 |
订单ID。 请从“生成订单号”接口的响应参数中获取。 |
cloudServices |
是 |
List<CloudService> |
- |
订购的云服务列表。 具体请参见表2。 |
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
cloudServiceType |
是 |
String |
最大长度:64 |
云服务类型。
|
regionId |
是 |
String |
最大长度:36 |
区域ID。 取值为地区和终端节点中查询的对应云服务的“区域”列的值。 如果要同时订购多个云服务,要求这些云服务的区域ID必须一致。 |
availableZoneId |
否 |
String |
最大长度:36 |
可用区ID。 |
chargingMode |
是 |
Integer |
4 |
计费模式: 0:包年/包月计费 |
periodType |
是 |
Integer |
4 |
订购周期类型:
|
periodNum |
否 |
Integer |
4 |
订购周期数。 订购周期类型非5时必填。 |
periodEndDate |
否 |
String |
最大长度:20 |
到期时间。 包年/包月云服务器追加云硬盘或者包年/包月共享带宽新增弹性IP时,填写云服务器或共享带宽的到期时间,订购周期类型为5时必填。 UTC时间,格式:yyyy-MM-ddTHH:mm:ssZ 其中,HH范围是0~23,mm和ss范围是0~59。 |
relativeResourceId |
否 |
String |
最大长度:64 |
关联资源标识。 包年/包月云服务器追加云硬盘或者包年/包月共享带宽新增弹性IP时,填写云服务器或共享带宽的实例标识。 |
isAutoRenew |
否 |
Integer |
1 |
是否自动续订。
|
subscriptionNum |
是 |
Integer |
4 |
订购数量。 |
productInfos |
是 |
List<ProductInfo> |
- |
产品信息。 具体请参见表3。 |
productDescs |
否 |
String/JSON |
最大长度:2048 |
购买的产品实例描述信息,Json格式。 |
cloudServiceEndpoint |
是 |
URL |
最大长度:128 |
下单成功开通云服务的回调接口地址。不同云服务的回调地址不同,在开通具体云服务时,请咨询华为工程师。 例如:华北区开通弹性云服务器的回调地址为“https://10.44.96.10:7443/v1/5ef6664b70274d328cd80256ea5550c9/cloudservers”,其中5ef6664b70274d328cd80256ea5550c9为客户的project id(可以调用“通过assume_role方式获取用户token”接口获取“regionId”取值对应的project id。具体请参见如何将合作伙伴Token置换为客户Token的步骤2)。 |
cloudServiceForm |
是 |
String/JSON |
最大长度:2048 |
下单成功开通云服务的回调接口参数。不同云服务的开通参数不同,在开通具体云服务时,请咨询华为工程师。 |
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
productId |
是 |
String |
最大长度:64 |
产品标识,通过调用“根据产品规格查询价格(旧)”接口获取。 |
cloudServiceType |
是 |
String |
最大长度:64 |
客户购买云服务产品的云服务类型。
|
resourceType |
是 |
String |
最大长度:64 |
客户购买云服务产品的资源类型。 例如ECS中的VM,资源类型为“hws.resource.type.vm”。 “resourceType”是“cloudServiceType”中的一种资源,“cloudServiceType”由多种resourceType组合提供。
|
resourceSpecCode |
是 |
String |
最大长度:64 |
资源类型编码,例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 |
resourceSize |
否 |
Integer |
4 |
资源容量大小,与“resouceSizeMeasureId”配合使用。 例如购买的卷大小或带宽大小。 |
resouceSizeMeasureId |
否 |
Integer |
- |
资源容量度量标识,枚举值如下:
|
extendParams |
否 |
String |
最大长度:1024 |
扩展参数,可空。 |
请求示例
POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/order-mgr/order HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "xroleName": "XXX", "orderId": "CS1712271317IT8C4", "customerId": "b0b2ef71776d465e83e189ca6f50b018", "cloudServices": [ { "periodNum": 1, "isAutoRenew": 0, "chargingMode": 0, "periodType": 2, "subscriptionNum": 1, "regionId": "cn-north-1", "productInfos": [ { "productId": "00301-52002-0--0", "cloudServiceType": "hws.service.type.ec2", "resourceSpecCode": "s2.small.1.linux", "resourceType": "hws.resource.type.vm" }, { "productId": "d5d5ba12f9ed4d0f997ab48464133d24", "cloudServiceType": "hws.service.type.ebs", "resourceType": "hws.resource.type.volume", "resourceSpecCode": "SATA", "resourceSize": 40, "resouceSizeMeasureId": 17 }, { "productId": "da27d47d84ff4adba7de3ca3b0c9ce08", "cloudServiceType": "hws.service.type.vpc", "resourceType": "hws.resource.type.ip", "resourceSpecCode": "5_bgp" }, { "productId": "60564b0c1f484feaad26cda1acc6d4d8", "cloudServiceType": "hws.service.type.vpc", "resourceType": "hws.resource.type.bandwidth", "resourceSpecCode": "19_bgp", "resourceSize": 1, "resouceSizeMeasureId": 15 } ], "cloudServiceType": "hws.service.type.ec2", "cloudServiceEndpoint": "https://10.44.96.10:7443/v1/5ef6664b70274d328cd80256ea5550c9/cloudservers", "cloudServiceForm": "{\"server\":{\"availability_zone\":\"cn-north-1a\",\"name\":\"myfirstcloudserver\",\"imageRef\":\"720accde-70c6-4906-9ac0-a34e2b9b6d6b\",\"flavorRef\":\"s2.small.1\",\"root_volume\":{\"volumetype\":\"SATA\",\"size\":40,\"extendparam\":{\"orderID\":\"CS1712271317IT8C4\",\"productID\":\"d5d5ba12f9ed4d0f997ab48464133d24\",\"resourceSpecCode\":\"SATA\",\"resourceType\":\"3\"}},\"data_volumes\":[],\"vpcid\":\"d45a1fa1-3f12-495d-8cae-265eadd368f6\",\"nics\":[{\"subnet_id\":\"f04adbb7-a73d-4fb6-bf20-7d10bdb1a8b4\",\"ip_address\":\"\",\"nictype\":\"\",\"extra_dhcp_opts\":[],\"binding:profile\":{\"disable_security_groups\":false}}],\"security_groups\":[{\"id\":\"62cd19f0-f635-43e3-b254-a7ebb8560fcb\"}],\"personality\":[],\"count\":1,\"extendparam\":{\"orderID\":\"CS1712271317IT8C4\",\"chargingMode\":1,\"regionID\":\"cn-north-1\",\"productID\":\"00301-52002-0--0\"},\"metadata\":{\"admin_pass\":\"\",\"agency_name\":null},\"tags\":[],\"publicip\":{\"eip\":{\"iptype\":\"5_bgp\",\"ipproductid\":\"da27d47d84ff4adba7de3ca3b0c9ce08\",\"bandwidth\":{\"name\":\"myfirstcloudserver-bandwidth\",\"size\":1,\"sharetype\":\"PER\",\"productid\":\"60564b0c1f484feaad26cda1acc6d4d8\"}}},\"user_data\":\"IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiRWMzlGd0kka0xpMVpRWkJweXhRelNFLkRxak5YOVVrTnNCL1VNMktSV0U0L2hGSWl2c0xGN3hBcjZ5ZFFDaVpwUDBJR0J4YkdOckJ2ZHlJbGl4bEk5OWdwbGMvVy8nIHwgY2hwYXNzd2QgLWU7\"}}" } ] }
响应消息
响应参数
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
error_code |
String |
最大长度:10 |
状态码。 具体请参见状态码。 |
error_msg |
String |
最大长度:256 |
错误描述信息。 |
orderId |
String |
最大长度:64 |
订单ID。 和请求参数中的“orderId”取值一致。 只有状态码为成功的时候才有这个字段。 |
响应示例:
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_code": "CBC.0000", "error_msg": "Success", "orderId": "CS1712271317IT8C4" }
