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