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

# 购买预留实例 (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"
    }
  ]
}
```

有关每个返回值的说明，请参阅下表。


****  

| 字段 | 说明 | 
| --- | --- | 
| FixedPrice | 预留的前期成本。 | 
| ReservedInstanceOfferingId | 产品 ID。如果要预留产品，则记下此值。 | 
| RecurringCharges | 预留的小时费率。 | 
| UsagePrice | 旧字段。对于 OpenSearch 服务，此值始终为 0。 | 
| PaymentOption | 无预付费用、预付部分费用或预付全费。 | 
| Duration | 期限长度 (秒)：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/opensearch-service/latest/developerguide/ri-cli.html) | 
| InstanceType | 预留的实例类型。有关分配给每种实例类型的硬件资源的信息，请参阅 [Amazon OpenSearch 服务定价](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)。