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

# 購買預留執行個體 (AWS CLI)
<a name="ri-cli"></a>

 AWS CLI 具有檢視方案、購買保留和檢視保留的命令。下列命令和範例回應會顯示指定 的方案 AWS 區域：

```
aws opensearch describe-reserved-instance-offerings --region us-east-1
{
  "ReservedInstanceOfferings": [
    {
      "FixedPrice": x,
      "ReservedInstanceOfferingId": "1a2a3a4a5-1a2a-3a4a-5a6a-1a2a3a4a5a6a",
      "RecurringCharges": [
        {
          "RecurringChargeAmount": y,
          "RecurringChargeFrequency": "Hourly"
        }
      ],
      "UsagePrice": 0.0,
      "PaymentOption": "PARTIAL_UPFRONT",
      "Duration": 31536000,
      "InstanceType": "m4.2xlarge.search",
      "CurrencyCode": "USD"
    }
  ]
}
```

如需每個傳回值的詳細說明，請參閱下表。


****  

| 欄位 | Description | 
| --- | --- | 
| FixedPrice | 預訂的預付費用。 | 
| ReservedInstanceOfferingId | 方案 ID。如果您想要預訂產品，請備註此值。 | 
| RecurringCharges | 預訂的小時費率。 | 
| UsagePrice | 傳統欄位。對於 OpenSearch Service，此值始終為 0。 | 
| PaymentOption | 無預付、部分預付或全部預付。 | 
| Duration | 期限長度，以秒為單位：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/opensearch-service/latest/developerguide/ri-cli.html) | 
| InstanceType | 預訂的執行個體類型。如需分配給每個執行個體類型的硬體資源的資訊，請參閱 [Amazon OpenSearch Service 定價](https://aws.amazon.com/elasticsearch-service/pricing/)。 | 
| CurrencyCode | 用於 FixedPrice 和 RecurringChargeAmount 的貨幣。 | 

這個下一個範例購買預訂：

```
aws opensearch purchase-reserved-instance-offering --reserved-instance-offering-id 1a2a3a4a5-1a2a-3a4a-5a6a-1a2a3a4a5a6a --reservation-name my-reservation --instance-count 3 --region us-east-1
{
  "ReservationName": "my-reservation",
  "ReservedInstanceId": "9a8a7a6a-5a4a-3a2a-1a0a-9a8a7a6a5a4a"
}
```

最後，您可以使用下列範例，列出指定區域的預訂：

```
aws opensearch describe-reserved-instances --region us-east-1
{
  "ReservedInstances": [
    {
      "FixedPrice": x,
      "ReservedInstanceOfferingId": "1a2a3a4a5-1a2a-3a4a-5a6a-1a2a3a4a5a6a",
      "ReservationName": "my-reservation",
      "PaymentOption": "PARTIAL_UPFRONT",
      "UsagePrice": 0.0,
      "ReservedInstanceId": "9a8a7a6a-5a4a-3a2a-1a0a-9a8a7a6a5a4a",
      "RecurringCharges": [
        {
          "RecurringChargeAmount": y,
          "RecurringChargeFrequency": "Hourly"
        }
      ],
      "State": "payment-pending",
      "StartTime": 1522872571.229,
      "InstanceCount": 3,
      "Duration": 31536000,
      "InstanceType": "m4.2xlarge.search",
      "CurrencyCode": "USD"
    }
  ]
}
```

**注意**  
`StartTime` 是 Unix epoch 時間，以秒數計算，從 1970 年 1 月 1 日 UTC 午夜起已經過的秒數。例如，1522872571 epoch 時間是 2018 年 4 月 4 日 20:09:31 UTC。您可以使用線上轉換器。

若要進一步了解前述範例中使用的命令，請參閱 [AWS CLI 命令參考](https://docs.aws.amazon.com/cli/latest/reference/es/index.html)。