:doc:`ElasticsearchService <../../es>` / Client / purchase_reserved_elasticsearch_instance_offering

*************************************************
purchase_reserved_elasticsearch_instance_offering
*************************************************



.. py:method:: ElasticsearchService.Client.purchase_reserved_elasticsearch_instance_offering(**kwargs)

  

  Allows you to purchase reserved Elasticsearch instances.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/es-2015-01-01/PurchaseReservedElasticsearchInstanceOffering>`_  


  **Request Syntax**
  ::

    response = client.purchase_reserved_elasticsearch_instance_offering(
        ReservedElasticsearchInstanceOfferingId='string',
        ReservationName='string',
        InstanceCount=123
    )
    
  :type ReservedElasticsearchInstanceOfferingId: string
  :param ReservedElasticsearchInstanceOfferingId: **[REQUIRED]** 

    The ID of the reserved Elasticsearch instance offering to purchase.

    

  
  :type ReservationName: string
  :param ReservationName: **[REQUIRED]** 

    A customer-specified identifier to track this reservation.

    

  
  :type InstanceCount: integer
  :param InstanceCount: 

    The number of Elasticsearch instances to reserve.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'ReservedElasticsearchInstanceId': 'string',
          'ReservationName': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 

      Represents the output of a ``PurchaseReservedElasticsearchInstanceOffering`` operation.

      
      

      - **ReservedElasticsearchInstanceId** *(string) --* 

        Details of the reserved Elasticsearch instance which was purchased.

        
      

      - **ReservationName** *(string) --* 

        The customer-specified identifier used to track this reservation.

        
  
  **Exceptions**
  
  *   :py:class:`ElasticsearchService.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`ElasticsearchService.Client.exceptions.ResourceAlreadyExistsException`

  
  *   :py:class:`ElasticsearchService.Client.exceptions.LimitExceededException`

  
  *   :py:class:`ElasticsearchService.Client.exceptions.DisabledOperationException`

  
  *   :py:class:`ElasticsearchService.Client.exceptions.ValidationException`

  
  *   :py:class:`ElasticsearchService.Client.exceptions.InternalException`

  