

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Adquisición de instancias reservadas (AWS CLI)
<a name="ri-cli"></a>

 AWS CLI Tiene comandos para ver las ofertas, comprar una reserva y ver tus reservas. El siguiente comando y un ejemplo de respuesta muestran las ofertas de un determinado comando Región de 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 ver una explicación de cada valor de retorno, consulte la tabla siguiente.


****  

| Campo | Description (Descripción) | 
| --- | --- | 
| FixedPrice | El costo inicial de la reserva. | 
| ReservedInstanceOfferingId | El ID de la oferta. Anote este valor si desea reservar la oferta. | 
| RecurringCharges | La tarifa por hora de la reserva. | 
| UsagePrice | Campo heredado. En el OpenSearch caso del servicio, este valor es siempre 0. | 
| PaymentOption | No Upfront (Sin pago inicial), Partial Upfront (Pago inicial parcial) o All Upfront (Pago inicial total). | 
| Duration | La duración en segundos:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/ri-cli.html) | 
| InstanceType | El tipo de instancia de la reserva. Para obtener información sobre los recursos de hardware que se asignan a cada tipo de instancia, consulta los [precios OpenSearch de Amazon Service](https://aws.amazon.com/elasticsearch-service/pricing/). | 
| CurrencyCode | La divisa para FixedPrice y RecurringChargeAmount. | 

El siguiente ejemplo adquiere una 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 último, puede obtener una lista de las reservas para una región determinada mediante el siguiente ejemplo:

```
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` se expresa en formato de tiempo Unix, que es el número de segundos que han transcurrido desde la medianoche UTC del 1 de enero de 1970. Por ejemplo, 1522872571 en formato de tiempo Unix son las 20:09:31 UTC del 4 de abril de 2018. Puede utilizar convertidores online.

Para obtener más información acerca de los comandos utilizados en los ejemplos anteriores, consulte la [Referencia de comandos de la AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/es/index.html).