CreateMultiOrder - 组合下单

更新时间:
复制 MD 格式

本接口为无影云电脑企业版按月时长包等部分商品的下单、续费、变配接口。

接口说明

请确保在使用该接口前,已充分了解无影的收费方式和价格。

如果未指定自动支付,则当前接口不负责支付,需要通过本接口返回的订单 ID 拼接支付跳转链接进行支付后订单才会生效,资源才会生产。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecd:CreateMultiOrder

create

*全部资源

*

无 无

请求参数

名称

类型

必填

描述

示例值

OrderItems

array<object>

否

商品信息。

array<object>

否

商品信息。

Amount

integer

否

购买数量。

1

AutoPay

boolean

否

是否自动支付。

枚举值:

  • true :

    自动支付

  • false :

    不自动支付

true

AutoRenew

boolean

否

是否自动续费。

枚举值:

  • true :

    自动续费

  • false :

    不自动续费

false

BuyChange

boolean

否

是否按月时长包变配

true

Components

array<object>

否

商品模块。

object

否

商品模块。

Key

string

否

模块的键(key)。

枚举值:

  • DurationType :

    计算套餐 [新购和变配必填]

  • RootDiskSize :

    系统盘大小 [必填]

  • OsType :

    操作系统类型 [新购和变配必填]

  • RootDiskCategory :

    系统盘类型 [必填]

  • RootPerformanceLevel :

    系统盘性能等级 [在 RootDiskCategory 指定 cloud_essd 时必填]

  • DataPerformanceLevel :

    数据盘性能等级 [非必填,取值同 RootPerformanceLevel]

  • RegionId :

    实例所属地域 [必填]

  • DataDiskSize :

    数据盘大小 [非必填,取值同 RootDiskSize]

  • InstanceType :

    实例规格 [新购和变配必填]

  • DataDiskCategory :

    数据盘类型 [非必填,取值同 RootDiskCategory]

RegionId

Value

string

否

模块的值(value)。

企业版按月时长包各个键的示例值/枚举值如下:

  • RegionId:cn-shanghai

  • InstanceType:eds.enterprise_office.4c8g

  • DurationType(小时):[枚举]
    • 120

    • 250

  • OsType:[枚举]
    • Windows

    • Linux

  • RootDiskSize(GiB):80

  • RootDiskCategory:[枚举]
    • cloud_efficiency(高效云盘)

    • cloud_auto(极速云盘)

    • cloud_essd(增强型 SSD 云盘,仅部分规格支持)

  • RootPerformanceLevel:[枚举]
    • PL0

    • PL1

    • PL2

    • PL3

  • DataDiskSize(GiB):取值同 RootDiskSize

  • DataDiskCategory:取值同 RootDiskCategory

  • DataPerformanceLevel:取值同 RootPerformanceLevel

cn-shanghai

InstanceIds

array

否

实例 ID 列表。

string

否

本次订单操作涉及的售卖实例 ID。

mdp-erdb15ubox6sx****

PaidCallBackUrl

string

否

订单支付成功后的回调 URL。按业务需要填写接收支付结果的地址。

https://example.com/order/paid

Period

integer

否

购买周期。取值范围:

  • 当PeriodUnit为Year时,取值范围:1、2、3、5。

  • 当PeriodUnit为Month时,取值范围:1、2、3、6。

1

PeriodUnit

string

否

包年包月实例的购买时长单位。

说明

仅当实例的付费类型为预付费时,需要填写此参数。该参数区分大小写,请确保拼写正确。

枚举值:

  • Month :

    月

  • Year :

    年

Year

PromotionId

string

否

优惠 ID。

youhuiquan_promotion_option_id_for_blank

ResourceIds

array

否

资源 ID 列表。

说明

对于按月时长包,该参数对应云电脑 ID,OrderType 非create时必填。

string

否

资源 ID 列表。

ecd-7ywwjrhpy9fec****

ResourceType

string

是

资源类型。

说明

该参数区分大小写,请确保拼写正确。

枚举值:

  • DurationPackage :

    企业版按月时长包

DurationPackage

UnifiedExpireDay

integer

否

统一到期日,每月 1~28 日;不传则按普通续费处理

15

OrderType

string

否

订单类型。

枚举值:

  • modify :

    变配

  • create :

    新购

  • renew :

    续费

  • convert :

    订单类型转换

create

Properties

object

否

扩展属性。

string

否

扩展属性。JSON 格式。

示例:通过{"PackageUsedUpStrategyKey":"Postpaid"}指定月度时长使用完毕后的策略为按需付费。

{"PackageUsedUpStrategyKey":"Postpaid"}

ResellerOwnerUid

integer

否

虚商伙伴下单时需传入真正的终端用户 id

100000000001

ChannelCookie

string

否

渠道归因使用的 Cookie 信息。存在渠道归因信息时传入对应值;无该信息时可不填。

channel=example

返回参数

名称

类型

描述

示例值

object

Schema of Response

OrderIds

array

订单 ID 列表。

integer

订单 ID。

23171351342****

RequestId

string

请求 ID。

833C4D2C-09C7-5CE6-8159-06758B964970

示例

正常返回示例

JSON格式

{
  "OrderIds": [
    0
  ],
  "RequestId": "833C4D2C-09C7-5CE6-8159-06758B964970"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。