全部产品
Search
文档中心

阿里云交易和账单管理API:CreateSavingsPlansInstance - 节省计划实例创建

更新时间:Jul 10, 2024

新购一个节省计划,并自动完成支付,创建节省计划实例。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
SpecTypestring

规格类型,和 Specification 字段配合使用,当不为通用型时需要指定该字段:

  • group 规格套餐

  • family 规格族

family
PayModestring

支付方式:

  • total 全预付

  • half 部分预付

  • zero 0 预付

total
Specificationstring

规格信息,和 SpecType 字段配合使用

ecs.g6
Typestring

节省计划类型:

  • universal 通用型

  • ecs 计算型

  • elasticy 弹性版

universal
PoolValuestring

承付款,单位元

0.1
Durationstring

购买时长,和 PricingCycle 配合使用

1
CommodityCodestring

商品编码

savingplan_common_public_cn
PricingCyclestring

购买时长单位,和 duration 字段配合使用

  • Year 年

  • Month 月

Year
Regionstring

抵扣地域,当购买非通用型时需要指定抵扣地域

cn-hangzhou
EffectiveDatestring

指定生效时间,日期格式按照 ISO8601 标准表示,并需要使用 UTC 时间。格式为:yyyy-MM-ddTHH:mm:ssZ

2021-12-31T00:00:00Z
ExtendMapobject

扩展参数 Map

string

扩展参数键值对

TEST:123

返回参数

名称类型描述示例值
object

结果

Messagestring

错误信息

参数不能为空
RequestIdstring

请求 ID

26dabb0c-8ca0-4aa0-8143-30499f3fe304
Dataobject

返回结果

OrderIdlong

订单号

202110260001
Codestring

错误码

PARAM_ERROR
Successboolean

是否调用成功

true

示例

正常返回示例

JSON格式

{
  "Message": "参数不能为空",
  "RequestId": "26dabb0c-8ca0-4aa0-8143-30499f3fe304",
  "Data": {
    "OrderId": 202110260001
  },
  "Code": "PARAM_ERROR",
  "Success": true
}

错误码

HTTP status code错误码错误信息描述
400IdempotentParameterMismatchThe request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.幂等参数错误

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

变更历史

变更时间变更内容概要操作
2023-03-27OpenAPI 错误码发生变更、OpenAPI 入参发生变更查看变更详情
2023-03-22OpenAPI 错误码发生变更查看变更详情