更新时间:2022-04-25 GMT+08:00
分享

订购包年/包月产品

功能介绍

此接口仅提供给已经接入CBC的合作伙伴使用,对于新接入的合作伙伴请使用云服务相关接口。

合作伙伴平台可以调用该接口进行包年/包月产品的下单动作。在调用该接口前,订购包年/包月产品的客户需要先在华为云开通华为云的账户和进行实名认证。并且客户账户上有足够的金额。

注意事项:

  • 该接口受限发布,如需使用,请联系合作伙伴对口的客户经理。
  • 按需产品服务无需调用该接口。
  • 该接口只允许使用合作伙伴AK/SK或者Token调用。
  • 下单前需要先调用“生成订单号”接口获取订单号。
  • 下单完成之后还需要调用“支付包年/包月产品订单”接口进行订单支付,服务才能开通。

URI

POST /v1.0/{partner_id}/partner/order-mgr/order

参数说明请参见表1

表1 URI参数说明

参数

是否必选

取值范围

描述

partner_id

最大长度:64

合作伙伴ID(华为分配)。

获取方法请参见如何获取合作伙伴ID(partner_id)

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

customerId

String

最大长度:64

客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id

xroleName

String

最大长度:64

分解给合作伙伴的角色名称,华为分配。

与合作伙伴平台标识“xaccountType”取值一致。

orderId

String

最大长度:64

订单ID。

请从“生成订单号”接口的响应参数中获取。

cloudServices

List<CloudService>

-

订购的云服务列表。

具体请参见表2

表2 CloudService

参数

是否必选

参数类型

取值范围

描述

cloudServiceType

String

最大长度:64

云服务类型。

  • 弹性云服务器:hws.service.type.ec2
  • 云硬盘:hws.service.type.ebs
  • 虚拟私有云:hws.service.type.vpc
  • 对象存储服务:hws.service.type.obs
  • 镜像服务:hws.service.type.image
  • Anti-DDos流量清洗:hws.service.type.antiddos
  • 数据接入服务:hws.service.type.dis
  • 人工智能服务:hws.service.type.ais
  • 内容分发网络:hws.service.type.cdn

regionId

String

最大长度:36

区域ID。

取值为地区和终端节点中查询的对应云服务的“区域”列的值。

如果要同时订购多个云服务,要求这些云服务的区域ID必须一致。

availableZoneId

String

最大长度:36

可用区ID。

chargingMode

Integer

4

计费模式:

0:包年/包月计费

periodType

Integer

4

订购周期类型:

  • 2:月
  • 3:年
  • 5:绝对时间

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

是否自动续订。

  • 为空时表示不自动续订。
  • 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

下单成功开通云服务的回调接口参数。不同云服务的开通参数不同,在开通具体云服务时,请咨询华为工程师。

表3 ProductInfo

参数

是否必选

参数类型

取值范围

描述

productId

String

最大长度:64

产品标识,通过调用“根据产品规格查询价格(旧)”接口获取。

cloudServiceType

String

最大长度:64

客户购买云服务产品的云服务类型。

  • 弹性云服务器:hws.service.type.ec2
  • 云硬盘:hws.service.type.ebs
  • 虚拟私有云:hws.service.type.vpc
  • 对象存储服务:hws.service.type.obs
  • 镜像服务:hws.service.type.image
  • Anti-DDos流量清洗:hws.service.type.antiddos
  • 数据接入服务:hws.service.type.dis
  • 人工智能服务:hws.service.type.ais
  • 内容分发网络:hws.service.type.cdn

resourceType

String

最大长度:64

客户购买云服务产品的资源类型。

例如ECS中的VM,资源类型为“hws.resource.type.vm”。

“resourceType”是“cloudServiceType”中的一种资源,“cloudServiceType”由多种resourceType组合提供。

  • ECS虚拟机:hws.resource.type.vm
  • EVS卷:hws.resource.type.volume
  • VPC带宽:hws.resource.type.bandwidth
  • VPC公网IP:hws.resource.type.ip
  • 市场镜像:hws.resource.type.marketplace

resourceSpecCode

String

最大长度:64

资源类型编码,例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。

resourceSize

Integer

4

资源容量大小,与“resouceSizeMeasureId”配合使用。

例如购买的卷大小或带宽大小。

resouceSizeMeasureId

Integer

-

资源容量度量标识,枚举值如下:

  • 15:Mbps(购买带宽时使用)
  • 17:GB(购买云硬盘时使用)

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-TokenMIIPAgYJKoZIhvcNAQcCo...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\"}}"
        }
    ]
}

响应消息

响应参数

表4 响应参数

参数

参数类型

取值范围

描述

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"
}

状态码

  • 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
  • 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。

状态码

描述

CBC.0000

成功。

CBC.0999

其他错误。

CBC.5007

订购产品必须属于同一个区域。

分享:

    相关文档

    相关产品

关闭导读