As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Compra de instâncias reservadas (AWS CLI)
<a name="ri-cli"></a>

 AWS CLI Tem comandos para visualizar ofertas, comprar uma reserva e visualizar suas reservas. O comando e o exemplo de resposta a seguir mostram as ofertas de um determinado Região da 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"
    }
  ]
}
```

Para obter uma explicação de cada valor de retorno, consulte a tabela a seguir.


****  

| Campo | Description | 
| --- | --- | 
| FixedPrice | O custo inicial da reserva. | 
| ReservedInstanceOfferingId | O ID da oferta. Anote esse valor caso você queira reservar a oferta. | 
| RecurringCharges | A taxa por hora da reserva. | 
| UsagePrice | Um campo herdado. Para OpenSearch Serviço, esse valor é sempre 0. | 
| PaymentOption | Sem adiantamento, adiantamento parcial ou adiantamento total. | 
| Duration | Extensão do prazo em segundos:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/opensearch-service/latest/developerguide/ri-cli.html) | 
| InstanceType | O tipo de instância da reserva. Para obter informações sobre os recursos de hardware que são alocados para cada tipo de instância, consulte os [preços do Amazon OpenSearch Service](https://aws.amazon.com/elasticsearch-service/pricing/). | 
| CurrencyCode | A moeda de FixedPrice e RecurringChargeAmount. | 

Este próximo exemplo compra uma reserva:

```
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"
}
```

Por fim, você pode listar as reservas para uma determinada Região usando o seguinte exemplo:

```
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"
    }
  ]
}
```

**nota**  
`StartTime` é tempo epoch Unix, que é o número de segundos decorridos desde a meia-noite UTC de 1° de janeiro de 1970. Por exemplo, o tempo epoch 1522872571 20:09:31 UTC é de 4 de abril de 2018. Você pode usar conversores online.

Para saber mais sobre os comandos usados nos exemplos anteriores, consulte a [Referência de comandos da AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/es/index.html).