:doc:`LicenseManagerLinuxSubscriptions <../../license-manager-linux-subscriptions>` / Client / list_linux_subscription_instances

*********************************
list_linux_subscription_instances
*********************************



.. py:method:: LicenseManagerLinuxSubscriptions.Client.list_linux_subscription_instances(**kwargs)

  

  Lists the running Amazon EC2 instances that were discovered with commercial Linux subscriptions.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/license-manager-linux-subscriptions-2018-05-10/ListLinuxSubscriptionInstances>`_  


  **Request Syntax**
  ::

    response = client.list_linux_subscription_instances(
        Filters=[
            {
                'Name': 'string',
                'Operator': 'Equal'|'NotEqual'|'Contains',
                'Values': [
                    'string',
                ]
            },
        ],
        MaxResults=123,
        NextToken='string'
    )
    
  :type Filters: list
  :param Filters: 

    An array of structures that you can use to filter the results by your specified criteria. For example, you can specify ``Region`` in the ``Name``, with the ``contains`` operator to list all subscriptions that match a partial string in the ``Value``, such as ``us-west``.

     

    For each filter, you can specify one of the following values for the ``Name`` key to streamline results:

     

    
    * ``AccountID``
     
    * ``AmiID``
     
    * ``DualSubscription``
     
    * ``InstanceID``
     
    * ``InstanceType``
     
    * ``ProductCode``
     
    * ``Region``
     
    * ``Status``
     
    * ``UsageOperation``
    

     

    For each filter, you can use one of the following ``Operator`` values to define the behavior of the filter:

     

    
    * ``contains``
     
    * ``equals``
     
    * ``Notequal``
    

    

  
    - *(dict) --* 

      A filter object that is used to return more specific results from a describe operation. Filters can be used to match a set of resources by specific criteria.

      

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

        The type of name to filter by.

        

      
      - **Operator** *(string) --* 

        An operator for filtering results.

        

      
      - **Values** *(list) --* 

        One or more values for the name to filter by.

        

      
        - *(string) --* 

        
    
    

  :type MaxResults: integer
  :param MaxResults: 

    The maximum items to return in a request.

    

  
  :type NextToken: string
  :param NextToken: 

    A token to specify where to start paginating. This is the nextToken from a previously truncated response.

    

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

    
    ::

      {
          'Instances': [
              {
                  'AccountID': 'string',
                  'AmiId': 'string',
                  'DualSubscription': 'string',
                  'InstanceID': 'string',
                  'InstanceType': 'string',
                  'LastUpdatedTime': 'string',
                  'OsVersion': 'string',
                  'ProductCode': [
                      'string',
                  ],
                  'Region': 'string',
                  'RegisteredWithSubscriptionProvider': 'string',
                  'Status': 'string',
                  'SubscriptionName': 'string',
                  'SubscriptionProviderCreateTime': 'string',
                  'SubscriptionProviderUpdateTime': 'string',
                  'UsageOperation': 'string'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Instances** *(list) --* 

        An array that contains instance objects.

        
        

        - *(dict) --* 

          Details discovered information about a running instance using Linux subscriptions.

          
          

          - **AccountID** *(string) --* 

            The account ID which owns the instance.

            
          

          - **AmiId** *(string) --* 

            The AMI ID used to launch the instance.

            
          

          - **DualSubscription** *(string) --* 

            Indicates that you have two different license subscriptions for the same software on your instance.

            
          

          - **InstanceID** *(string) --* 

            The instance ID of the resource.

            
          

          - **InstanceType** *(string) --* 

            The instance type of the resource.

            
          

          - **LastUpdatedTime** *(string) --* 

            The time in which the last discovery updated the instance details.

            
          

          - **OsVersion** *(string) --* 

            The operating system software version that runs on your instance.

            
          

          - **ProductCode** *(list) --* 

            The product code for the instance. For more information, see `Usage operation values <https://docs.aws.amazon.com/license-manager/latest/userguide/linux-subscriptions-usage-operation.html>`__ in the *License Manager User Guide* .

            
            

            - *(string) --* 
        
          

          - **Region** *(string) --* 

            The Region the instance is running in.

            
          

          - **RegisteredWithSubscriptionProvider** *(string) --* 

            Indicates that your instance uses a BYOL license subscription from a third-party Linux subscription provider that you've registered with License Manager.

            
          

          - **Status** *(string) --* 

            The status of the instance.

            
          

          - **SubscriptionName** *(string) --* 

            The name of the license subscription that the instance uses.

            
          

          - **SubscriptionProviderCreateTime** *(string) --* 

            The timestamp when you registered the third-party Linux subscription provider for the subscription that the instance uses.

            
          

          - **SubscriptionProviderUpdateTime** *(string) --* 

            The timestamp from the last time that the instance synced with the registered third-party Linux subscription provider.

            
          

          - **UsageOperation** *(string) --* 

            The usage operation of the instance. For more information, see For more information, see `Usage operation values <https://docs.aws.amazon.com/license-manager/latest/userguide/linux-subscriptions-usage-operation.html>`__ in the *License Manager User Guide*.

            
      
    
      

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

        The next token used for paginated responses. When this field isn't empty, there are additional elements that the service hasn't included in this request. Use this token with the next request to retrieve additional objects.

        
  
  **Exceptions**
  
  *   :py:class:`LicenseManagerLinuxSubscriptions.Client.exceptions.InternalServerException`

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

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

  