

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

# 使用预留节点
<a name="reserved-nodes-working-with"></a>

您可以使用 AWS 管理控制台 AWS Command Line Interface、和 MemoryDB API 来处理预留节点。

## 控制台
<a name="reserved-nodes-working-with-console"></a>

**获取有关可用预留节点产品的定价和信息**

1. 登录 AWS 管理控制台 并打开 MemoryDB 控制台，网址为。[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/)

1. 在导航窗格中，选择**预留节点**。

1. 选择**购买预留节点**。

1. 对于**节点类型**，请选择要部署的节点类型。

1. 对于**数量**，请选择要部署的节点数量。

1. 对于**期限**，选择希望预留数据库节点的时间长度。

1. 对于**产品类型**，请选择产品类型。

做出这些选择后，您可以在**预留摘要**中看到定价信息。

**重要**  
选择**取消**可避免购买这些预留节点和产生任何费用。

在获得有关可用预留节点产品的信息后，您可以使用该信息来购买以下过程中所示的产品：

**要购买预留节点**

1. 登录 AWS 管理控制台 并打开 MemoryDB 控制台，网址为。[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/)

1. 在导航窗格中，选择**预留节点**。

1. 选择**购买预留节点**。

1. 对于**节点类型**，请选择要部署的节点类型。

1. 对于**数量**，请选择要部署的节点数量。

1. 对于**期限**，选择希望预留数据库节点的时间长度。

1. 对于**产品类型**，请选择产品类型。

1. （可选）您可以将自己的标识符分配给购买的预留节点，以帮助您跟踪这些节点。对于**预留 ID**，请为您的预留节点键入一个标识符。

   做出这些选择后，您可以在**预留摘要**中看到定价信息。

1. 选择**购买预留节点**。

1. 您的预留节点已购买，然后显示在**预留节点**列表中。

**获取有关您 AWS 账户的预留节点的信息**

1. 登录 AWS 管理控制台 并打开 MemoryDB 控制台，网址为。[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/)

1. 在导航窗格中，选择**预留节点**。

1. 您的账户的预留节点出现。要查看有关特定预留节点的详细信息，请在列表中选择该节点。之后，您可以在详细信息中查看有关该节点的详细信息。

## AWS Command Line Interface
<a name="reserved-nodes-working-with-cli"></a>

以下 `describe-reserved-nodes-offerings` 示例将返回预留节点产品的详细信息。

```
aws memorydb describe-reserved-nodes-offerings                                                             
```

此操作将生成类似于下述信息的输出：

```
{
    "ReservedNodesOfferings": [
        {
            "ReservedNodesOfferingId": "0193cc9d-7037-4d49-b332-xxxxxxxxxxxx",
            "NodeType": "db.xxx.large",
            "Duration": 94608000,
            "FixedPrice": $xxx.xx,
            "OfferingType": "Partial Upfront",
            "RecurringCharges": [
                {
                    "RecurringChargeAmount": $xx.xx,
                    "RecurringChargeFrequency": "Hourly"
                }
            ]
        }
    ]
}
```

您还可以传递以下参数以限制返回内容的范围：
+ `--reserved-nodes-offering-id` – 您要购买的产品的 ID。
+ `--node-type` – 节点类型筛选值。使用此参数仅显示与指定节点类型匹配的预留。
+ `--duration` – 以年或秒为单位指定的持续时间筛选值。使用此参数仅显示此时段的预留。
+ `--offering-type` – 使用此参数仅显示与指定产品类型匹配的可用产品。

在获得有关可用预留节点产品的信息后，您可以使用该信息来购买产品。

以下 `purchase-reserved-nodes-offering` 示例将购买新预留节点

对于 Linux、macOS 或 Unix：

```
aws memorydb purchase-reserved-nodes-offering \                                                              
    --reserved-nodes-offering-id 0193cc9d-7037-4d49-b332-d5e984f1d8ca \
    --reservation-id reservation \
    --node-count 2
```

对于 Windows：

```
aws memorydb purchase-reserved-nodes-offering ^
    --reserved-nodes-offering-id 0193cc9d-7037-4d49-b332-d5e984f1d8ca ^
    --reservation-id MyReservation
```
+ `--reserved-nodes-offering-id` 表示要购买的预留节点产品的名称。
+ `--reservation-id` 是一个用来跟踪此预留的客户指定的标识符。
**注意**  
预留 ID 是用来跟踪此预留的客户指定的唯一标识符。如果此参数未指定，则 MemoryDB 将自动生成此预留的标识符。
+ `--node-count` 是要预留的节点数量。其默认值为 1。

此操作将生成类似于下述信息的输出：

```
{
    "ReservedNode": {
        "ReservationId": "reservation",
        "ReservedNodesOfferingId": "0193cc9d-7037-4d49-b332-xxxxxxxxxxxx",
        "NodeType": "db.xxx.large",
        "StartTime": 1671173133.982,
        "Duration": 94608000,
        "FixedPrice": $xxx.xx,
        "NodeCount": 2,
        "OfferingType": "Partial Upfront",
        "State": "payment-pending",
        "RecurringCharges": [
            {
                "RecurringChargeAmount": $xx.xx,
                "RecurringChargeFrequency": "Hourly"
            }
        ],
        "ARN": "arn:aws:memorydb:us-east-1:xxxxxxxx:reservednode/reservation"
    }
}
```

在购买了预留节点后，您可以获取有关预留节点的信息。

以下 `describe-reserved-nodes` 示例将返回有关该账户的预留节点的信息。

```
aws memorydb describe-reserved-nodes                                                             
```

此操作将生成类似于下述信息的输出：

```
{
    "ReservedNodes": [
        {
            "ReservationId": "ri-2022-12-16-00-28-40-600",
            "ReservedNodesOfferingId": "0193cc9d-7037-4d49-b332-xxxxxxxxxxxx",
            "NodeType": "db.xxx.large",
            "StartTime": 1671150737.969,
            "Duration": 94608000,
            "FixedPrice": $xxx.xx,
            "NodeCount": 1,
            "OfferingType": "Partial Upfront",
            "State": "active",
            "RecurringCharges": [
                {
                    "RecurringChargeAmount": $xx.xx,
                    "RecurringChargeFrequency": "Hourly"
                }
            ],
            "ARN": "arn:aws:memorydb:us-east-1:xxxxxxxx:reservednode/ri-2022-12-16-00-28-40-600"
        }
    ]
}
```

您还可以传递以下参数以限制返回内容的范围：
+ `--reservation-id` – 您可以将自己的标识符分配给购买的预留节点，以帮助您跟踪这些实例。
+ `--reserved-nodes-offering-id` – 产品标识符筛选值。使用此参数仅显示与指定产品标识符相匹配的已购买的预留。
+ `--node-type` – 节点类型筛选值。使用此参数仅显示与指定节点类型匹配的预留。
+ `--duration` – 以年或秒为单位指定的持续时间筛选值。使用此参数仅显示此时段的预留。
+ `--offering-type` – 使用此参数仅显示与指定产品类型匹配的可用产品。

## MemoryDB API
<a name="reserved-nodes-working-with-api"></a>

以下示例演示如何将 [MemoryDB 查询 API](https://docs.aws.amazon.com/memorydb/latest/devguide/programmingguide.queryapi.html) 用于预留节点：

**DescribeReservedNodesOfferings**

返回预留节点产品的详细信息。

```
https://memorydb.us-west-2.amazonaws.com/
    ?Action=DescribeReservedNodesOfferings
    &ReservedNodesOfferingId=649fd0c8-xxxx-xxxx-xxxx-06xxxx75e95f    
	&"Duration": 94608000,
    &NodeType="db.r6g.large"    
    &OfferingType="Partial Upfront"    
    &Version=2021-01-01
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20141201T220302Z
    &X-Amz-Algorithm
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20141201T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>
```

以下参数限制了返回内容的范围：
+ `ReservedNodesOfferingId` 表示要购买的预留节点产品的名称。
+ `Duration` – 以年或秒为单位指定的持续时间筛选值。使用此参数仅显示此时段的预留。
+ `NodeType` – 节点类型筛选值。使用此参数仅显示与指定节点类型匹配的产品。
+ `OfferingType` – 使用此参数仅显示与指定产品类型匹配的可用产品。

在获得有关可用预留节点产品的信息后，您可以使用该信息来购买产品。

**PurchaseReservedNodesOffering**

允许您购买预留节点产品。

```
https://memorydb.us-west-2.amazonaws.com/
    ?Action=PurchasedReservedNodesOffering
    &ReservedNodesOfferingId=649fd0c8-xxxx-xxxx-xxxx-06xxxx75e95f
    &ReservationID=myreservationID
    &NodeCount=1
    &Version=2021-01-01
    &SignatureVersion=4
    &SignatureMethod=HmacSHA256
    &Timestamp=20141201T220302Z
    &X-Amz-Algorithm
    &X-Amz-SignedHeaders=Host
    &X-Amz-Expires=20141201T220302Z
    &X-Amz-Credential=<credential>
    &X-Amz-Signature=<signature>
```
+ `ReservedNodesOfferingId` 表示要购买的预留节点产品的名称。
+ `ReservationID` 是一个用来跟踪此预留的客户指定的标识符。
**注意**  
预留 ID 是用来跟踪此预留的客户指定的唯一标识符。如果此参数未指定，则 MemoryDB 将自动生成此预留的标识符。
+ `NodeCount` 是要预留的节点数量。其默认值为 1。

在购买了预留节点后，您可以获取有关预留节点的信息。

**DescribeReservedNodes**

返回有关该账户的预留节点的信息。

```
https://memorydb.us-west-2.amazonaws.com/
	?Action=DescribeReservedNodes
	&ReservedNodesOfferingId=649fd0c8-xxxx-xxxx-xxxx-06xxxx75e95f
	&ReservationID=myreservationID
	&NodeType="db.r6g.large"
	&Duration=94608000
	&OfferingType="Partial Upfront"    
	&Version=2021-01-01
	&SignatureVersion=4
	&SignatureMethod=HmacSHA256
	&Timestamp=20141201T220302Z
	&X-Amz-Algorithm
	&X-Amz-SignedHeaders=Host
	&X-Amz-Expires=20141201T220302Z
	&X-Amz-Credential=<credential>
	&X-Amz-Signature=<signature>
```

以下参数限制了返回内容的范围：
+ `ReservedNodesOfferingId` 表示预留节点的名称。
+ `ReservationID` – 您可以将自己的标识符分配给购买的预留节点，以帮助您跟踪这些实例。
+ `NodeType` – 节点类型筛选值。使用此参数仅显示与指定节点类型匹配的预留。
+ `Duration` – 以年或秒为单位指定的持续时间筛选值。使用此参数仅显示此时段的预留。
+ `OfferingType` – 使用此参数仅显示与指定产品类型匹配的可用产品。

## 查看预留节点的账单
<a name="reserved-nodes-view-billing"></a>

您可以在 AWS 管理控制台中账单控制面板上查看预留节点的账单。

**要查看预留节点账单**

1. 登录 AWS 管理控制台 并打开 MemoryDB 控制台，网址为。[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/)

1. 从控制台顶部的搜索按钮中，选择**账单**。

1. 从控制面板的左侧选择**账单**。

1. 在**AWS 服务费用**下，展开 **MemoryDB**。

1. 扩展您的预留节点所在的 AWS 区域，例如**美国东部（弗吉尼亚北部）**。

您的预留节点及其当月的小时费用显示在 **Amazon MemoryDB CreateCluster 预留实例**下。

![\[该屏幕截图显示了当月每小时费用的账单。\]](http://docs.aws.amazon.com/zh_cn/memorydb/latest/devguide/images/reserved-nodes.png)
