:doc:`EVS <../../evs>` / Paginator / ListEnvironmentHosts

********************
ListEnvironmentHosts
********************



.. py:class:: EVS.Paginator.ListEnvironmentHosts

  ::

    
    paginator = client.get_paginator('list_environment_hosts')

  
  

  .. py:method:: paginate(**kwargs)

    Creates an iterator that will paginate through responses from :py:meth:`EVS.Client.list_environment_hosts`.

    See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/evs-2023-07-27/ListEnvironmentHosts>`_    


    **Request Syntax**
    ::

      response_iterator = paginator.paginate(
          environmentId='string',
          PaginationConfig={
              'MaxItems': 123,
              'PageSize': 123,
              'StartingToken': 'string'
          }
      )
      
    :type environmentId: string
    :param environmentId: **[REQUIRED]** 

      A unique ID for the environment.

      

    
    :type PaginationConfig: dict
    :param PaginationConfig: 

      A dictionary that provides parameters to control pagination.

      

    
      - **MaxItems** *(integer) --* 

        The total number of items to return. If the total number of items available is more than the value specified in max-items then a ``NextToken`` will be provided in the output that you can use to resume pagination.

        

      
      - **PageSize** *(integer) --* 

        The size of each page.

        

      
      - **StartingToken** *(string) --* 

        A token to specify where to start paginating. This is the ``NextToken`` from a previous response.

        

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

      
      ::

        {
            'environmentHosts': [
                {
                    'hostName': 'string',
                    'ipAddress': 'string',
                    'keyName': 'string',
                    'instanceType': 'i4i.metal',
                    'placementGroupId': 'string',
                    'dedicatedHostId': 'string',
                    'createdAt': datetime(2015, 1, 1),
                    'modifiedAt': datetime(2015, 1, 1),
                    'hostState': 'CREATING'|'CREATED'|'UPDATING'|'DELETING'|'DELETED'|'CREATE_FAILED'|'UPDATE_FAILED',
                    'stateDetails': 'string',
                    'ec2InstanceId': 'string',
                    'networkInterfaces': [
                        {
                            'networkInterfaceId': 'string'
                        },
                    ]
                },
            ],
            'NextToken': 'string'
        }
        
      **Response Structure**

      

      - *(dict) --* 
        

        - **environmentHosts** *(list) --* 

          A list of hosts in the environment.

          
          

          - *(dict) --* 

            An ESX host that runs on an Amazon EC2 bare metal instance. Four hosts are created in an Amazon EVS environment during environment creation. You can add hosts to an environment using the ``CreateEnvironmentHost`` operation. Amazon EVS supports 4-16 hosts per environment.

            
            

            - **hostName** *(string) --* 

              The DNS hostname of the host. DNS hostnames for hosts must be unique across Amazon EVS environments and within VCF.

              
            

            - **ipAddress** *(string) --* 

              The IP address of the host.

              
            

            - **keyName** *(string) --* 

              The name of the SSH key that is used to access the host.

              
            

            - **instanceType** *(string) --* 

              The EC2 instance type of the host.

               

              .. note::

                

                Currently, Amazon EVS supports only the ``i4i.metal`` instance type.

                

               

              .. note::

                

                EC2 instances created through Amazon EVS do not support associating an IAM instance profile.

                

              
            

            - **placementGroupId** *(string) --* 

              The unique ID of the placement group where the host is placed.

              
            

            - **dedicatedHostId** *(string) --* 

              The unique ID of the Amazon EC2 Dedicated Host.

              
            

            - **createdAt** *(datetime) --* 

              The date and time that the host was created.

              
            

            - **modifiedAt** *(datetime) --* 

              The date and time that the host was modified.

              
            

            - **hostState** *(string) --* 

              The state of the host.

              
            

            - **stateDetails** *(string) --* 

              A detailed description of the ``hostState`` of a host.

              
            

            - **ec2InstanceId** *(string) --* 

              The unique ID of the EC2 instance that represents the host.

              
            

            - **networkInterfaces** *(list) --* 

              The elastic network interfaces that are attached to the host.

              
              

              - *(dict) --* 

                An elastic network interface (ENI) that connects hosts to the VLAN subnets. Amazon EVS provisions two identically configured ENIs in the VMkernel management subnet during host creation. One ENI is active, and the other is in standby mode for automatic switchover during a failure scenario.

                
                

                - **networkInterfaceId** *(string) --* 

                  The unique ID of the elastic network interface.

                  
            
          
        
      
        

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

          A token to resume pagination.

          
    