:doc:`MigrationHubRefactorSpaces <../../migration-hub-refactor-spaces>` / Client / list_environments

*****************
list_environments
*****************



.. py:method:: MigrationHubRefactorSpaces.Client.list_environments(**kwargs)

  

  Lists Amazon Web Services Migration Hub Refactor Spaces environments owned by a caller account or shared with the caller account.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/migration-hub-refactor-spaces-2021-10-26/ListEnvironments>`_  


  **Request Syntax**
  ::

    response = client.list_environments(
        MaxResults=123,
        NextToken='string'
    )
    
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned ``nextToken`` value.

    

  
  :type NextToken: string
  :param NextToken: 

    The token for the next page of results.

    

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

    
    ::

      {
          'EnvironmentSummaryList': [
              {
                  'Arn': 'string',
                  'CreatedTime': datetime(2015, 1, 1),
                  'Description': 'string',
                  'EnvironmentId': 'string',
                  'Error': {
                      'AccountId': 'string',
                      'AdditionalDetails': {
                          'string': 'string'
                      },
                      'Code': 'INVALID_RESOURCE_STATE'|'RESOURCE_LIMIT_EXCEEDED'|'RESOURCE_CREATION_FAILURE'|'RESOURCE_UPDATE_FAILURE'|'SERVICE_ENDPOINT_HEALTH_CHECK_FAILURE'|'RESOURCE_DELETION_FAILURE'|'RESOURCE_RETRIEVAL_FAILURE'|'RESOURCE_IN_USE'|'RESOURCE_NOT_FOUND'|'STATE_TRANSITION_FAILURE'|'REQUEST_LIMIT_EXCEEDED'|'NOT_AUTHORIZED',
                      'Message': 'string',
                      'ResourceIdentifier': 'string',
                      'ResourceType': 'ENVIRONMENT'|'APPLICATION'|'ROUTE'|'SERVICE'|'TRANSIT_GATEWAY'|'TRANSIT_GATEWAY_ATTACHMENT'|'API_GATEWAY'|'NLB'|'TARGET_GROUP'|'LOAD_BALANCER_LISTENER'|'VPC_LINK'|'LAMBDA'|'VPC'|'SUBNET'|'ROUTE_TABLE'|'SECURITY_GROUP'|'VPC_ENDPOINT_SERVICE_CONFIGURATION'|'RESOURCE_SHARE'|'IAM_ROLE'
                  },
                  'LastUpdatedTime': datetime(2015, 1, 1),
                  'Name': 'string',
                  'NetworkFabricType': 'TRANSIT_GATEWAY'|'NONE',
                  'OwnerAccountId': 'string',
                  'State': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED',
                  'Tags': {
                      'string': 'string'
                  },
                  'TransitGatewayId': 'string'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **EnvironmentSummaryList** *(list) --* 

        The list of ``EnvironmentSummary`` objects.

        
        

        - *(dict) --* 

          The summary information for environments as a response to ``ListEnvironments``.

          
          

          - **Arn** *(string) --* 

            The Amazon Resource Name (ARN) of the environment.

            
          

          - **CreatedTime** *(datetime) --* 

            A timestamp that indicates when the environment is created.

            
          

          - **Description** *(string) --* 

            A description of the environment.

            
          

          - **EnvironmentId** *(string) --* 

            The unique identifier of the environment.

            
          

          - **Error** *(dict) --* 

            Any error associated with the environment resource.

            
            

            - **AccountId** *(string) --* 

              The Amazon Web Services account ID of the resource owner.

              
            

            - **AdditionalDetails** *(dict) --* 

              Additional details about the error.

              
              

              - *(string) --* 
                

                - *(string) --* 
          
        
            

            - **Code** *(string) --* 

              The error code associated with the error.

              
            

            - **Message** *(string) --* 

              The message associated with the error.

              
            

            - **ResourceIdentifier** *(string) --* 

              The ID of the resource.

              
            

            - **ResourceType** *(string) --* 

              The type of resource.

              
        
          

          - **LastUpdatedTime** *(datetime) --* 

            A timestamp that indicates when the environment was last updated.

            
          

          - **Name** *(string) --* 

            The name of the environment.

            
          

          - **NetworkFabricType** *(string) --* 

            The network fabric type of the environment.

            
          

          - **OwnerAccountId** *(string) --* 

            The Amazon Web Services account ID of the environment owner.

            
          

          - **State** *(string) --* 

            The current state of the environment.

            
          

          - **Tags** *(dict) --* 

            The tags assigned to the environment.

            
            

            - *(string) --* 
              

              - *(string) --* 
        
      
          

          - **TransitGatewayId** *(string) --* 

            The ID of the Transit Gateway set up by the environment.

            
      
    
      

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

        The token for the next page of results.

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

  
  *   :py:class:`MigrationHubRefactorSpaces.Client.exceptions.InternalServerException`

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

  
  *   :py:class:`MigrationHubRefactorSpaces.Client.exceptions.ThrottlingException`

  
  *   :py:class:`MigrationHubRefactorSpaces.Client.exceptions.AccessDeniedException`

  