DescribeReservedNodes - Amazon MemoryDB

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

DescribeReservedNodes

傳回此帳戶預留節點的相關資訊,或指定預留節點的相關資訊。

請求語法

{ "Duration": "string", "MaxResults": number, "NextToken": "string", "NodeType": "string", "OfferingType": "string", "ReservationId": "string", "ReservedNodesOfferingId": "string" }

請求參數

如需所有動作的一般參數資訊,請參閱《Common Parameters》。

請求接受採用 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 指定的值為止。

類型:字串

ReservedNodes

傳回此帳戶預留節點的相關資訊,或指定預留節點的相關資訊。

類型:ReservedNode 物件陣列

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

InvalidParameterCombinationException

HTTP 狀態碼:400

InvalidParameterValueException

HTTP 狀態碼:400

ReservedNodeNotFoundFault

請求的節點不存在。

HTTP 狀態碼:400

ServiceLinkedRoleNotFoundFault

HTTP 狀態碼:400

另請參閱

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: