

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

# 使用預留節點
<a name="reserved-nodes-working-with"></a>

您可以使用 AWS 管理主控台、 AWS Command Line Interface和 MemoryDB API 來使用預留節點。

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

**取得可用預留節點方案的定價和資訊**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。

1. 在導覽窗格中，選擇**預留節點**。

1. 選擇**購買預留節點**。

1. 針對**節點類型**，選擇您要部署的節點類型。

1. 針對**數量**，選擇您要部署的節點數量。

1. 針對 **Term**，選擇您要保留資料庫節點的時間長度。

1. 在 **Offering type (方案類型)** 中，選擇方案類型。

進行這些選擇後，您可以在**保留摘要**下查看定價資訊。

**重要**  
選擇**取消**，以避免購買這些預留節點並產生任何費用。

取得可用預留節點方案的相關資訊後，您可以使用該資訊來購買方案，如下列程序所示：

**購買預留節點**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。

1. 在導覽窗格中，選擇**預留節點**。

1. 選擇**購買預留節點**。

1. 針對**節點類型**，選擇您要部署的節點類型。

1. 針對**數量**，選擇您要部署的節點數量。

1. 針對 **Term**，選擇您要保留資料庫節點的時間長度。

1. 在 **Offering type (方案類型)** 中，選擇方案類型。

1. （選用） 您可以將自己的識別符指派給您購買的預留節點，以協助您追蹤這些節點。針對**保留 ID**，輸入預留節點的識別符。

   進行這些選擇後，您可以在**保留摘要**下查看定價資訊。

1. 選擇**購買預留節點**。

1. 您的預留節點已購買，然後顯示在**預留節點**清單中。

**取得您 AWS 帳戶預留節點的相關資訊**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。

1. 在導覽窗格中，選擇**預留節點**。

1. 您帳戶的預留節點隨即出現。若要查看特定預留節點的詳細資訊，請在清單中選擇該節點。然後，您可以在詳細資訊中查看有關該節點的詳細資訊。

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

下列`describe-reserved-nodes-offerings`範例會傳回 reserved-node 方案的詳細資訊。

```
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**

傳回 reserved-node 方案的詳細資訊。

```
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 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/memorydb/](https://console.aws.amazon.com/memorydb/) 的 MemoryDB 主控台。

1. 從主控台頂端的搜尋按鈕中，選擇**帳單**。

1. 從儀表板左側選擇**帳單**。

1. 在**AWS 服務費用**下，展開 **MemoryDB**。

1. 展開預留節點所在的 AWS 區域，例如**美國東部 （維吉尼亞北部）**。

您預留的節點及其當月的每小時費用會顯示在 **Amazon MemoryDB CreateCluster 預留執行個體**下。

![\[帳單的螢幕擷取，顯示當月的每小時費用。\]](http://docs.aws.amazon.com/zh_tw/memorydb/latest/devguide/images/reserved-nodes.png)
