DescribeReservedNodes - Amazon MemoryDB

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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。

类型:字符串

ReservedNodes

返回此账户的预留节点的相关信息,或指定的预留节点的相关信息。

类型:ReservedNode 对象数组

错误

有关所有操作的常见错误的信息,请参阅常见错误

InvalidParameterCombinationException

HTTP 状态代码:400

InvalidParameterValueException

HTTP 状态代码:400

ReservedNodeNotFoundFault

请求的节点不存在。

HTTP 状态代码:400

ServiceLinkedRoleNotFoundFault

HTTP 状态代码:400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: