調(diào)用DescribeDedicatedHostAutoRenew查詢一臺或多臺包年包月專有宿主機(jī)自動續(xù)費(fèi)狀態(tài)。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(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)操作 |
---|---|---|---|---|
ecs:DescribeDedicatedHostAutoRenew | get | *DedicatedHost acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId} |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
DedicatedHostIds | string | 是 | 專有宿主機(jī) ID。最多可以輸入 100 個包年包月專有宿主機(jī) ID,ID 之間用半角逗號(,)隔開。 | dh-bp165p6xk2tlw61e****,dh-bp1f9vxmno**** |
RegionId | string | 是 | 專有宿主機(jī)所屬的地域 ID。 | cn-hangzhou |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
"DedicatedHostRenewAttributes": {
"DedicatedHostRenewAttribute": [
{
"PeriodUnit": "Month",
"Duration": 0,
"DedicatedHostId": "dh-bp165p6xk2tlw61e****",
"RenewalStatus": "Normal",
"AutoRenewEnabled": false,
"AutoRenewWithEcs": "StopRenewWithEcs"
}
]
}
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
403 | ChargeTypeViolation | Pay-As-You-Go dedicated host does not support this operation. | 按量付費(fèi)的宿主機(jī)不支持當(dāng)前操作。 |
403 | MissingParameter.DedicatedHostId | DedicatedHostId should not be null. | 參數(shù) DedicatedHostId 不能為空。 |
403 | InvalidParameter.ToManyDedicatedHostIds | DedicatedHostId should be less than 100. | 參數(shù) DedicatedHostIds 包含的專有宿主機(jī) ID 應(yīng)該少于 100 個。 |
403 | InvalidParameter.InvalidDedicatedHostId | %s | 指定的參數(shù) DedicatedHostId 無效。 |
403 | IncorrectDedicatedHostStatus | The current status of the resource does not support this operation. | 當(dāng)前資源的狀態(tài)不支持此操作。 |
403 | MissingParamter.InstanceId | InstanceId should not be null. | 實例id不能為空 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2023-06-13 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |