:doc:`SageMaker <../../sagemaker>` / Client / list_hubs

*********
list_hubs
*********



.. py:method:: SageMaker.Client.list_hubs(**kwargs)

  

  List all existing hubs.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/sagemaker-2017-07-24/ListHubs>`_  


  **Request Syntax**
  ::

    response = client.list_hubs(
        NameContains='string',
        CreationTimeBefore=datetime(2015, 1, 1),
        CreationTimeAfter=datetime(2015, 1, 1),
        LastModifiedTimeBefore=datetime(2015, 1, 1),
        LastModifiedTimeAfter=datetime(2015, 1, 1),
        SortBy='HubName'|'CreationTime'|'HubStatus'|'AccountIdOwner',
        SortOrder='Ascending'|'Descending',
        MaxResults=123,
        NextToken='string'
    )
    
  :type NameContains: string
  :param NameContains: 

    Only list hubs with names that contain the specified string.

    

  
  :type CreationTimeBefore: datetime
  :param CreationTimeBefore: 

    Only list hubs that were created before the time specified.

    

  
  :type CreationTimeAfter: datetime
  :param CreationTimeAfter: 

    Only list hubs that were created after the time specified.

    

  
  :type LastModifiedTimeBefore: datetime
  :param LastModifiedTimeBefore: 

    Only list hubs that were last modified before the time specified.

    

  
  :type LastModifiedTimeAfter: datetime
  :param LastModifiedTimeAfter: 

    Only list hubs that were last modified after the time specified.

    

  
  :type SortBy: string
  :param SortBy: 

    Sort hubs by either name or creation time.

    

  
  :type SortOrder: string
  :param SortOrder: 

    Sort hubs by ascending or descending order.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of hubs to list.

    

  
  :type NextToken: string
  :param NextToken: 

    If the response to a previous ``ListHubs`` request was truncated, the response includes a ``NextToken``. To retrieve the next set of hubs, use the token in the next request.

    

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

    
    ::

      {
          'HubSummaries': [
              {
                  'HubName': 'string',
                  'HubArn': 'string',
                  'HubDisplayName': 'string',
                  'HubDescription': 'string',
                  'HubSearchKeywords': [
                      'string',
                  ],
                  'HubStatus': 'InService'|'Creating'|'Updating'|'Deleting'|'CreateFailed'|'UpdateFailed'|'DeleteFailed',
                  'CreationTime': datetime(2015, 1, 1),
                  'LastModifiedTime': datetime(2015, 1, 1)
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **HubSummaries** *(list) --* 

        The summaries of the listed hubs.

        
        

        - *(dict) --* 

          Information about a hub.

          
          

          - **HubName** *(string) --* 

            The name of the hub.

            
          

          - **HubArn** *(string) --* 

            The Amazon Resource Name (ARN) of the hub.

            
          

          - **HubDisplayName** *(string) --* 

            The display name of the hub.

            
          

          - **HubDescription** *(string) --* 

            A description of the hub.

            
          

          - **HubSearchKeywords** *(list) --* 

            The searchable keywords for the hub.

            
            

            - *(string) --* 
        
          

          - **HubStatus** *(string) --* 

            The status of the hub.

            
          

          - **CreationTime** *(datetime) --* 

            The date and time that the hub was created.

            
          

          - **LastModifiedTime** *(datetime) --* 

            The date and time that the hub was last modified.

            
      
    
      

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

        If the response is truncated, SageMaker returns this token. To retrieve the next set of hubs, use it in the subsequent request.

        
  