全部产品
Search
文档中心

云消息队列 Kafka 版:CreatePostPayOrder - 创建后付费实例

更新时间:Apr 19, 2024

后付费实例根据所购资源规格的实际使用量计费,先使用,后计费。主要适用于测试或者流量峰值不确定的短期场景。本文介绍如何调用CreatePostPayOrder创建后付费实例。

接口说明

请确保在使用该接口前,已充分了解后付费实例的收费方式和价格。更多信息,请参见计费说明

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
alikafka:CreatePostPayOrderWrite
  • Instance
    acs:alikafka:{#regionId}:{#accountId}:instance/*
  • alikafka:DeployModule
  • alikafka:SpecType

请求参数

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

实例的地域 ID。

cn-hangzhou
DiskTypestring

磁盘类型。取值:

  • 0:高效云盘

  • 1:SSD

说明 若创建 V3 系列(Serverless)实例,无需传该参数。
0
DiskSizeinteger

磁盘容量。

取值范围,请参见计费说明

说明 若创建 V3 系列(Serverless)实例,无需传该参数。
500
DeployTypeinteger

部署类型。取值:

  • 4:公网/VPC 实例

  • 5:VPC 实例

5
EipMaxinteger

公网流量。

  • 如果 DeployType4,则需填写。

  • 取值范围,请参见计费说明

说明 若创建 V3 系列(Serverless)实例,无需传该参数。
0
IoMaxinteger

流量峰值(不推荐)。

  • 流量峰值和流量规格必须选填一个。同时填写时,以流量规格为准。建议您只填写流量规格。

  • 取值范围,请参见计费说明

说明 若创建 V3 系列(Serverless)实例,无需传该参数。
20
PartitionNuminteger

分区数(推荐)。

  • 分区数和 Topic 规格必须选填一个,建议您只填写分区数。

  • 分区数和 Topic 规格同时填写时,将会按照老的 Topic 售卖模型去校验分区数和 Topic 规格是否等价:如不等价将返回失败;如等价则按分区数进行购买。

  • 取值范围,请参见计费说明

说明 若创建 V3 系列(Serverless)实例,无需传该参数。
50
TopicQuotainteger

Topic 的数量(不推荐)。

  • 分区数和 Topic 规格必须选填一个,建议您只填写分区数。

  • 分区数和 Topic 规格同时填写时,将会按照老的 Topic 售卖模型去校验分区数和 Topic 规格是否等价:如不等价将返回失败;如等价则按分区数进行购买。

  • 流量规格不同,默认值不同。超过默认值,需额外收费。

  • 取值范围,请参见计费说明

说明 若创建 V3 系列(Serverless)实例,无需传该参数。
50
PaidTypeinteger

付费类型。取值:

  • 1(默认):V2 系列后付费。
  • 3:V3 系列预留规格后付费+Serverless 弹性伸缩后付费。
1
SpecTypestring

规格类型。

当 PaidType 参数为 1(V2 系列后付费)时取值:

  • normal:标准版(高写版)
  • professional:专业版(高写版)
  • professionalForHighRead:专业版(高读版)

当 PaidType 参数为 3(V3 系列预留规格后付费+Serverless 弹性伸缩后付费)时取值:

  • normal:Serverless 标准版

以上规格类型的说明,请参见计费说明

normal
IoMaxSpecstring

流量规格(推荐)。

  • 流量峰值和流量规格必须选填一个。同时填写时,以流量规格为准。建议您只填写流量规格。

  • 取值范围,请参见计费说明

说明 若创建 V3 系列(Serverless)实例,无需传该参数。
alikafka.hw.2xlarge
ResourceGroupIdstring

资源组 ID。

不设置时落在默认资源组里,可在资源组控制台查看资源组 ID。

rg-ac***********7q
Tagobject []

标签列表。

Keystring

资源的标签键。

  • N 为 1~20。
  • 如果为空,则匹配所有标签键。
  • 最多支持 128 个字符,不能以 aliyun 和 acs:开头,不能包含 http://或者 https://。
FinanceDept
Valuestring

资源的标签值。

  • N 为 1~20。
  • 如果标签键为空,则必须为空。为空时,匹配所有标签值。
  • 最多支持 128 个字符,不能以 aliyun 和 acs:开头,不能包含 http://或者 https://。
FinanceJoshua
ServerlessConfigobject

Serverless 实例的相关设置。创建 V3 系列(Serverless)实例时必传。

ReservedPublishCapacitylong

预留的发送流量规格值,仅支持传入整数,最低 60。

说明 实际上限受当前地域库存影响,请参考售卖页可选范围。
60
ReservedSubscribeCapacitylong

预留的消费流量规格值,仅支持传入整数,最低 20。

说明 实际上限受当前地域库存影响,请参考售卖页可选范围。
50

返回参数

名称类型描述示例值
object
Codeinteger

返回码。返回 200 代表成功。

200
Messagestring

返回信息。

operation success.
RequestIdstring

请求的 ID。

06084011-E093-46F3-A51F-4B19A8AD****
Successboolean

调用是否成功。

true
OrderIdstring

订单的 ID。

20497346575****

示例

正常返回示例

JSON格式

{
  "Code": 200,
  "Message": "operation success.",
  "RequestId": "06084011-E093-46F3-A51F-4B19A8AD****",
  "Success": true,
  "OrderId": "20497346575****"
}

错误码

HTTP status code错误码错误信息描述
400Invalid.%sInvalid.%s参数无效。
400BIZ.LIMIT.QUOTA.DOWNInvalid.%s降配失败
400BIZ.LIMIT.QUOTA.DOWN.1Invalid.%s降配失败
400BIZ.LIMIT.QUOTA.DOWN.2Invalid.%s降配失败
400Invalid.Partition.%sInvalid.%s分区数和Topic不等价
400BIZ_FIELD_CHECK_INVALID%s. Please check and try again later.参数错误。
400MissingParameterThe %s parameter is required.参数%s缺失
400InvalidParameter.DataAlreadyExistThe data already exists for the %s parameter.%s参数对应的数据已存在
400InvalidParameter.RangeThe value of the %s parameter is not within the specified range.参数%s范围校验不通过
400Instance.ExceedMaxLimitThe number of instances of a single account exceeds the limit. If you need to increase the limit, please submit a work order.单账号实例数量超限,如需要提升限额,请提交工单。
400Deploy.ResourceNotEnoughInsufficient resources, please submit work order.资源不足,请提交工单。
400InvalidParameter.NotSupportThe %s parameter is not supported.参数%s当前不支持
400InvalidParameter.SizeThe size of the %s parameter is not within the specified range.参数%s长度校验不通过
400InvalidParameter.FormatThe %s format is invalid.参数%s格式校验不通过
400InvalidParameterThe %s parameter is invalid.参数%s校验不通过
404InvalidParameter.DataNotFoundNo data found for the %s parameter.参数%s查找不到数据
404InvalidData.FieldsIncompleteData is incomplete, %s data is missing, please check and try again later.数据不完整,%s 数据缺失,请检查并稍后再试。
500InternalUnknownCodeErrorInternal error, please try again, if still failed, please submit a work order to contact us.内部错误,请重试,若是仍失败请提交工单联系我们。
500InternalUnknownCodeErrorInternal error, please try again. If it still fails, please submit a work order and contact us.内部错误,请重试,若仍然失败请提交工单联系我们。

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

变更历史

变更时间变更内容概要操作
2024-04-11OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    新增错误码:404
    新增错误码:500
入参OpenAPI 入参发生变更
    新增入参:PaidType
    新增入参:ServerlessConfig
2022-10-28OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
入参OpenAPI 入参发生变更
    新增入参:Tag
2022-08-31OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400