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).