:doc:`DirectConnect <../../directconnect>` / Client / describe_locations

******************
describe_locations
******************



.. py:method:: DirectConnect.Client.describe_locations()

  

  Lists the Direct Connect locations in the current Amazon Web Services Region. These are the locations that can be selected when calling  CreateConnection or  CreateInterconnect.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/directconnect-2012-10-25/DescribeLocations>`_  


  **Request Syntax**

  ::

    response = client.describe_locations()
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'locations': [
              {
                  'locationCode': 'string',
                  'locationName': 'string',
                  'region': 'string',
                  'availablePortSpeeds': [
                      'string',
                  ],
                  'availableProviders': [
                      'string',
                  ],
                  'availableMacSecPortSpeeds': [
                      'string',
                  ]
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **locations** *(list) --* 

        The locations.

        
        

        - *(dict) --* 

          Information about an Direct Connect location.

          
          

          - **locationCode** *(string) --* 

            The code for the location.

            
          

          - **locationName** *(string) --* 

            The name of the location. This includes the name of the colocation partner and the physical site of the building.

            
          

          - **region** *(string) --* 

            The Amazon Web Services Region for the location.

            
          

          - **availablePortSpeeds** *(list) --* 

            The available port speeds for the location.

            
            

            - *(string) --* 
        
          

          - **availableProviders** *(list) --* 

            The name of the service provider for the location.

            
            

            - *(string) --* 
        
          

          - **availableMacSecPortSpeeds** *(list) --* 

            The available MAC Security (MACsec) port speeds for the location.

            
            

            - *(string) --* 
        
      
    
  
  **Exceptions**
  
  *   :py:class:`DirectConnect.Client.exceptions.DirectConnectServerException`

  
  *   :py:class:`DirectConnect.Client.exceptions.DirectConnectClientException`

  