文档

GetResult4QueryInstancePrice4Modify - 获取询价结果

更新时间:

获取询价结果。

调试

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

授权信息

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

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

请求参数

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

变配询价任务 id(有效时间为 1 小时,超时后无法查询到结果并且返回参数没有 Data 这一属性)

price4modify/19862074****/rm-uf69xr871l***fj39/WQ9ULO4SLD**PQY5/FL1IZLW**3H78OC
ApplicationIdstring

应用 ID

02S7UU41WKJL7ERR

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID

A07FFDF2-78FA-1B48-9E38-88E833A93187
Messagestring

错误信息

Success
Codestring

响应码

200
Dataobject

变配询价结果

TaskIdstring

任务 ID。

d9a3e99b-6954-4a16-ad51-954db4a528b7
Statusstring

应用状态

SUCCESS
PriceListarray<object>

计费结果列表
(如果查询变配价格时传递了 period_unit,period 两个 Configuration 将会返回三个价格; 如果不传递 period_unit,period 将只返回变配后应该支付金额)
三个价格(按顺序):

  • 变配后应该支付金额(按量付费时,等于新规格价格。 包年包月时,为升配后剩余实例时间需要补交的金额,如一个月的实例,用了半个月时升配,剩下半个月的时间需要补交的金额)(包年包月时,随着实例剩余时间不断变少,此金额在不断变化,QueryInstancePrice4Modify 时间不同,金额也会有差异。)
  • 原规格价格
  • 新规格价格 (包年包月时,为完整时间周期,如一个月的价格)
itemobject

计费结果列表

NodeTypestring

产品 code

vpc
TradeAmountdouble

最终价,为原价减去折扣金额。

1
DiscountAmountdouble

减免金额

2
OriginalAmountdouble

原价

3
PriceUnitstring

单位:金额/时

金额/时
PromotionNamestring

优惠信息

优惠信息
Errorstring

失败原因

获取价格失败的信息
AccessDeniedDetailstring

权限校验失败详情。

{ "PolicyType": "", "AuthPrincipalOwnerId": "", "EncodedDiagnosticMessage": "", "AuthPrincipalType": "", "AuthPrincipalDisplayName": "", "NoPermissionType": "", "AuthAction": "" }

示例

正常返回示例

JSON格式

{
  "RequestId": "A07FFDF2-78FA-1B48-9E38-88E833A93187",
  "Message": "Success",
  "Code": "200",
  "Data": {
    "TaskId": "d9a3e99b-6954-4a16-ad51-954db4a528b7",
    "Status": "SUCCESS",
    "PriceList": [
      {
        "NodeType": "vpc",
        "TradeAmount": 1,
        "DiscountAmount": 2,
        "OriginalAmount": 3,
        "PriceUnit": "金额/时",
        "PromotionName": "优惠信息",
        "Error": "获取价格失败的信息"
      }
    ]
  },
  "AccessDeniedDetail": "{\n    \"PolicyType\": \"\",\n    \"AuthPrincipalOwnerId\": \"\",\n    \"EncodedDiagnosticMessage\": \"\",\n    \"AuthPrincipalType\": \"\",\n    \"AuthPrincipalDisplayName\": \"\",\n    \"NoPermissionType\": \"\",\n    \"AuthAction\": \"\"\n  }"
}

错误码

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

变更历史

变更时间变更内容概要操作
2024-09-24OpenAPI 返回结构发生变更查看变更详情