文档首页 > > API参考> 附录> 待下线接口> 变更包周期产品规格

变更包周期产品规格

分享
更新时间: 2020/03/20 GMT+08:00

功能介绍

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

合作伙伴平台可以调用该接口进行包周期产品的订单变更。首先要成功支付包周期产品订单,产生一条有效的订单,才能进行变更。

注意事项:

  • 该接口受限发布,如需使用,请联系合作伙伴对口的客户经理。
  • 该接口只允许使用合作伙伴AK/SK或者Token调用。
  • 变更,目前只支持规格扩容(比如CPU、内存、磁盘扩容),不支持规格缩减。
  • 变更前需要先调用“生成订单号”接口获取订单号。

URI

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

参数说明请参见表1

表1 URI参数说明

参数

是否必选

取值范围

描述

partner_id

最大长度:64

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

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

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

customerId

String

最大长度:64

客户ID。

该参数通过调用IAM的“帐号绑定结果通知接口”获取,是响应参数中的“domainId”。

xroleName

String

最大长度:64

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

cloudServiceType

String

最大长度:64

客户变更云服务产品的云服务类型。

例如ECS,云服务类型为“hws.service.type.ec2”。

具体参考附录订单管理支持的云服务类型

orderId

String

最大长度:64

订单ID。

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

regionId

String

最大长度:36

区域ID。

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

resourceId

String

最大长度:128

资源标识ID。

productInfo

ProductInfo

N/A

变更后的新的云服务产品信息,具体请参见表2

productDescs

String/JSON

最大长度:2048

购买的产品实例描述信息,Json格式,参考订购接口描述

cloudServiceEndpoint

String

最大长度:128

下单成功变更云服务的回调接口地址。不同云服务的回调地址不同,在变更具体云服务时,请咨询华为工程师。

例如:华北区变更弹性云服务器的回调地址为“https://10.44.96.10:7443/v1/5ef6664b70274d328cd80256ea5550c9/cloudservers/{server_id}/resize”,其中5ef6664b70274d328cd80256ea5550c9为客户的project id(可以调用“通过assume_role方式获取用户token”接口获取“regionId”取值对应的project id。具体请参见如何将合作伙伴Token置换为客户Token的步骤2)。

cloudServiceForm

String/JSON

最大长度:2048

云服务回调接口参数。

参考cloudformation方式,由云服务提供者定义,运营平台回调时传给云服务提供者。

extendParams

String/JSON

最大长度:1024

带宽续约降配时,传递带宽关联的ip资源标识、续订周期类型和续订周期数量。

  • ip资源标识。格式如下:

    "ipResourceIds":["xx","xx","xx",…]

  • 续订周期类型,不传时缺省为资源原购买周期类型。格式如下:

    "periodType":xx

  • 续订周期数量,不传时缺省为1。格式如下:

    "periodNum":xx

表2 ProductInfo

参数

是否必选

参数类型

取值范围

描述

productId

String

最大长度:64

产品标识。

通过“根据变更产品规格查询价格(旧)”接口获得。

cloudServiceType

String

最大长度:64

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

例如ECS,云服务类型为“hws.service.type.ec2”。

具体请参见订单管理支持的云服务类型

resourceType

String

最大长度:64

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

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

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

具体请参见订单管理支持的资源类型

resourceSpecCode

String

最大长度:64

客户购买云服务产品的资源规格。

例如VM的资源规格举例为“s2.small.1.linux”。

具体请参见订单管理支持的资源规格列表

resourceSize

Integer

4

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

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

resouceSizeMeasureId

Integer

2

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

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

extendParams

String/JSON

最大长度:1024

扩展参数,可空。

请求示例

POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/order-mgr/orders/update HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
    "customerId": "b0b2ef71776d465e83e189ca6f50b018",
    "xroleName": "customer",
    "orderId": "HWC1IV0K0ENGD9",
    "cloudServiceType": "hws.service.type.ec2",
    "resourceId": "c1e0ad87-0aa8-4d65-a41e-29055265b5f8",
    "productInfo": {
        "productId": "64bdab39aa6e4da4ae5a01b743b7d0f9",
        "cloudServiceType": "hws.service.type.ec2",
        "resourceType": "hws.resource.type.vm",
        "resourceSpecCode": null,
        "resourceSize": null,
        "resouceSizeMeasureId": null,
        "extendParams": null
    },
    "cloudServiceEndpoint": "https://192.144.51.124:7443/v1/6df3b021d4d6451f95ef6a4c77edc68a/cloudservers/c1e0ad87-0aa8-4d65-a41e-29055265b5f8/resize",
    "cloudServiceForm": "{\"resize\":{\"flavorRef\":\"104\",\"extendparam\":{\"productID\":\"64bdab39aa6e4da4ae5a01b743b7d0f9\",\"orderID\":\"HWC1IV0K0ENGD9\"}}}"
}

响应消息

响应参数

参数

参数类型

取值范围

描述

error_code

String

10

状态码。

具体请参见状态码

error_msg

String

256

错误描述信息。

customerOrder

CustomerOrder

-

客户订单信息。

具体请参见表3

表3 CustomerOrder

参数

参数类型

取值范围

描述

orderId

String

64

新订单的ID。

和请求参数中的“orderId”取值一致。

status

String

64

新订单的状态。

  • 0:初始化
  • 1:待审核
  • 2:待付款
  • 3:处理中
  • 4:已取消
  • 5:已完成
  • 6:待付款

响应示例

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",
    "customerOrder": 
   {
        "orderId": "HWC1IV0K0ENGD9",
        "status": "6"
    }
}

状态码

状态码

描述

CBC.0000

成功。

CBC.0999

其他错误。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区