InquiryPriceRefundInstance：調用本接口對需要退訂的實例進行詢價。
接口說明
- 請仔細核對退訂資源的信息，并確認退訂條款和退訂金額，資源一經退訂無法恢復。
- 退訂只退還實付金額的部分，已使用的代金券不退還。
- 其他問題請參照：退訂規則
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| bss:RefundQueryRemainAmount | Read |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ClientToken | string | 否 | 需要冪等場景必填。UUID 生成的字符串。此字段用于冪等，多次調用傳入同樣的值，會返回第一次的結果。 | 793F021C-B589-1225-82A9-99232AEBE494 |
| ProductCode | string | 否 | 退訂場景必填，產品 code | ecs |
| InstanceId | string | 否 | 退訂場景必填，實例 id | i-bp1etb69sqxgl4******* |
| ProductType | string | 否 | 退訂場景必填，產品類型，無特殊說明傳入“” 空字符串。 | ”“ |
返回參數
示例
正常返回示例
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. | 此API不適用于調用方。 |
| 400 | NotAuthorized | The user is not authorized for the specified API. | 此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. | 商品code無效 |
| 500 | InternalError | An error occurred in the internal server. | - |
訪問錯誤中心查看更多錯誤碼。
針對部分業務規則攔截返回的錯誤碼的解釋
- ResourceNotExists：實例不存在
- ResourceStatusError：實例狀態不對
- BindMirrorInstanceError：ecs 有關聯的收費鏡像
- ExceedRefundQuotaError：退訂次數超過 quota 配額上限
- ExistUnPaidOrderError：實例下存在未支付訂單
- ExistRefundingOrderError：無效實例 ID(實例已到期或已退款或已釋放)
- NoRestValueError：退款金額為 0
- AmbassadorOrderLimitError：實例下有云大使訂單
- ActivityForbiddenError：活動訂單禁止退款
- ProductCheckError：云產品規則預校驗未通過