:doc:`MemoryDB <../../memorydb>` / Client / describe_reserved_nodes_offerings

*********************************
describe_reserved_nodes_offerings
*********************************



.. py:method:: MemoryDB.Client.describe_reserved_nodes_offerings(**kwargs)

  

  Lists available reserved node offerings.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/memorydb-2021-01-01/DescribeReservedNodesOfferings>`_  


  **Request Syntax**
  ::

    response = client.describe_reserved_nodes_offerings(
        ReservedNodesOfferingId='string',
        NodeType='string',
        Duration='string',
        OfferingType='string',
        MaxResults=123,
        NextToken='string'
    )
    
  :type ReservedNodesOfferingId: string
  :param ReservedNodesOfferingId: 

    The offering identifier filter value. Use this parameter to show only the available offering that matches the specified reservation identifier.

    

  
  :type NodeType: string
  :param NodeType: 

    The node type for the reserved nodes. For more information, see `Supported node types <https://docs.aws.amazon.com/memorydb/latest/devguide/nodes.reserved.html#reserved-nodes-supported>`__.

    

  
  :type Duration: string
  :param Duration: 

    Duration filter value, specified in years or seconds. Use this parameter to show only reservations for a given duration.

    

  
  :type OfferingType: string
  :param OfferingType: 

    The offering type filter value. Use this parameter to show only the available offerings matching the specified offering type. Valid values: "All Upfront"|"Partial Upfront"| "No Upfront"

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.

    

  
  :type NextToken: string
  :param NextToken: 

    An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

    

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

    
    ::

      {
          'NextToken': 'string',
          'ReservedNodesOfferings': [
              {
                  'ReservedNodesOfferingId': 'string',
                  'NodeType': 'string',
                  'Duration': 123,
                  'FixedPrice': 123.0,
                  'OfferingType': 'string',
                  'RecurringCharges': [
                      {
                          'RecurringChargeAmount': 123.0,
                          'RecurringChargeFrequency': 'string'
                      },
                  ]
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **NextToken** *(string) --* 

        An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.

        
      

      - **ReservedNodesOfferings** *(list) --* 

        Lists available reserved node offerings.

        
        

        - *(dict) --* 

          The offering type of this node.

          
          

          - **ReservedNodesOfferingId** *(string) --* 

            The offering identifier.

            
          

          - **NodeType** *(string) --* 

            The node type for the reserved nodes. For more information, see `Supported node types <https://docs.aws.amazon.com/memorydb/latest/devguide/nodes.reserved.html#reserved-nodes-supported>`__.

            
          

          - **Duration** *(integer) --* 

            The duration of the reservation in seconds.

            
          

          - **FixedPrice** *(float) --* 

            The fixed price charged for this reserved node.

            
          

          - **OfferingType** *(string) --* 

            The offering type of this reserved node.

            
          

          - **RecurringCharges** *(list) --* 

            The recurring price charged to run this reserved node.

            
            

            - *(dict) --* 

              The recurring charge to run this reserved node.

              
              

              - **RecurringChargeAmount** *(float) --* 

                The amount of the recurring charge to run this reserved node.

                
              

              - **RecurringChargeFrequency** *(string) --* 

                The frequency of the recurring price charged to run this reserved node.

                
          
        
      
    
  
  **Exceptions**
  
  *   :py:class:`MemoryDB.Client.exceptions.ReservedNodesOfferingNotFoundFault`

  
  *   :py:class:`MemoryDB.Client.exceptions.ServiceLinkedRoleNotFoundFault`

  
  *   :py:class:`MemoryDB.Client.exceptions.InvalidParameterValueException`

  
  *   :py:class:`MemoryDB.Client.exceptions.InvalidParameterCombinationException`

  