本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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 的更多信息,请参阅以下内容: