本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
DescribeReservedNodes
傳回此帳戶預留的節點或特定預留節點的相關資訊。
請求語法
{
"Duration": "string",
"MaxResults": number,
"NextToken": "string",
"NodeType": "string",
"OfferingType": "string",
"ReservationId": "string",
"ReservedNodesOfferingId": "string"
}請求參數
如需有關所有動作共用之參數的資訊，請參閱一般參數。
請求接受採用 JSON 格式的下列資料。
- Duration
-
持續時間篩選器值，以年或秒為單位指定。使用此參數可僅顯示此期間的保留項目。
類型：字串
必要：否
- MaxResults
-
要在回應中包含的記錄數量上限。如果存在的記錄多於指定 MaxRecords 值，則響應中包含一個標記，以便可以檢索剩餘的結果。
類型：整數
必要：否
- NextToken
-
從先前的請求返回的可選標記。使用此標記來分頁此操作的結果。若指定此參數，則回應只會包含超過標記的記錄，直到 MaxRecords 指定的值為止。
類型：字串
必要：否
- NodeType
-
節點類型篩選條件值。使用此參數可僅顯示符合指定節點類型的保留區。如需詳細資訊，請參閱支援的節點類型。
類型：字串
必要：否
- OfferingType
-
訂購項目篩選條件值。使用此參數可僅顯示符合指定提供項目類型的可用訂購項目。有效值：「全部正面」|「部分上前」|「不預付」
類型：字串
必要：否
- ReservationId
-
保留的節點識別碼篩選值。使用此參數可僅顯示符合指定保留區 ID 的保留區。
類型：字串
必要：否
- ReservedNodesOfferingId
-
提供項目篩選條件值。使用此參數可僅顯示符合指定提供項目識別碼的已購買保留項目。
類型：字串
必要：否
回應語法
{
"NextToken": "string",
"ReservedNodes": [
{
"ARN": "string",
"Duration": number,
"FixedPrice": number,
"NodeCount": number,
"NodeType": "string",
"OfferingType": "string",
"RecurringCharges": [
{
"RecurringChargeAmount": number,
"RecurringChargeFrequency": "string"
}
],
"ReservationId": "string",
"ReservedNodesOfferingId": "string",
"StartTime": number,
"State": "string"
}
]
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- NextToken
-
從先前的請求返回的可選標記。使用此標記來分頁此操作的結果。若指定此參數，則回應只會包含超過標記的記錄，直到 MaxRecords 指定的值為止。
類型：String
- ReservedNodes
-
傳回此帳戶預留的節點或特定預留節點的相關資訊。
類型：ReservedNode 物件陣列
錯誤
如需所有動作常見的錯誤相關資訊，請參閱常見錯誤。
- InvalidParameterCombinationException
-
HTTP 狀態碼：400
- InvalidParameterValueException
-
HTTP 狀態碼：400
- ReservedNodeNotFoundFault
-
請求的節點不存在。
HTTP 狀態碼：400
- ServiceLinkedRoleNotFoundFault
-
HTTP 狀態碼：400
另請參閱
如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：
