退订实例前调用InquiryPriceRefundInstance API查询退款金额-费用与成本-阿里云-费用与成本-阿里云帮助中心

InquiryPriceRefundInstance：调用本接口对需要退订的实例进行询价。

接口说明

请仔细核对退订资源的信息，并确认退订条款和退订金额，资源一经退订无法恢复。
退订只退还实付金额的部分，已使用的代金券不退还。
其他问题请参照：退订规则

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

bss:RefundQueryRemainAmount

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
ClientToken	string	否	需要幂等场景必填。UUID 生成的字符串。此字段用于幂等，多次调用传入同样的值，会返回第一次的结果。	793F021C-B589-1225-82A9-99232AEBE494
ProductCode	string	否	退订场景必填，产品 code	ecs
InstanceId	string	否	退订场景必填，实例 id	i-bp1etb69sqxgl4*******
ProductType	string	否	退订场景必填，产品类型，无特殊说明传入“” 空字符串。	”“

返回参数

名称	类型	描述	示例值
	object	result
Message	string	执行结果说明	success
RequestId	string	执行链路追踪字符串，排查问题时，可以提供给平台。	UUID
Data	object	data
HostId	string	执行主机所在站点	cn
InstanceId	string	实例 id	i-bp1etb69sqxgl4*******
Currency	string	币种	退款金额本币币种： CNY：人民币。 USD：美元。 JPY：日元。
RefundAmount	number	金额	12.34
Code	string	响应码	200
Success	boolean	success=true 代表调用执行完成。success=false 代表执行出现错误。	true

示例

正常返回示例

JSON格式

{
  "Message": "success",
  "RequestId": "UUID",
  "Data": {
    "HostId": "cn",
    "InstanceId": "i-bp1etb69sqxgl4*******",
    "Currency": "退款金额本币币种： CNY：人民币。 USD：美元。 JPY：日元。",
    "RefundAmount": 12.34
  },
  "Code": "200",
  "Success": true
}

错误码

HTTP status code	错误码	错误信息	描述
400	ResourceNotExists	The specific resource is not exists.
400	ResourceStatusError	The resource status error.
400	InvalidOwner	The specified owner does not belong to caller.
400	InvalidParameter	The specified request contains invalid parameters.
400	MissingParameter	The specified request lacks essential parameters.
400	NotApplicable	The specified API is not applicable for the user.
400	NotAuthorized	The user is not authorized for the specified API.
400	BindMirrorInstanceError	Charged images that are related to ECS.
400	ExceedRefundQuotaError	The number of unsubscription times has reached the upper limit.
400	ExistUnPaidOrderError	The instance has an unsettled order.
400	ExistRefundingOrderError	The instance ID is invalid: the instance may have expired, been refunded, or been released.
400	NoRestValueError	The refund amount is 0.
400	AmbassadorOrderLimitError	The instance has an ambassador order that may raise risks.
400	ActivityForbiddenError	Promotional orders do not support refunds.
400	ProductCheckError	The cloud service failed SPI preflight verification.
400	CommodityNotSupported	The specified commodity is not supported.
500	InternalError	An error occurred in the internal server.	系统异常，请重试

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

变更历史

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