:doc:`Outposts <../../outposts>` / Client / list_blocking_instances_for_capacity_task

*****************************************
list_blocking_instances_for_capacity_task
*****************************************



.. py:method:: Outposts.Client.list_blocking_instances_for_capacity_task(**kwargs)

  

  A list of Amazon EC2 instances running on the Outpost and belonging to the account that initiated the capacity task. Use this list to specify the instances you cannot stop to free up capacity to run the capacity task.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/outposts-2019-12-03/ListBlockingInstancesForCapacityTask>`_  


  **Request Syntax**
  ::

    response = client.list_blocking_instances_for_capacity_task(
        OutpostIdentifier='string',
        CapacityTaskId='string',
        MaxResults=123,
        NextToken='string'
    )
    
  :type OutpostIdentifier: string
  :param OutpostIdentifier: **[REQUIRED]** 

    The ID or ARN of the Outpost associated with the specified capacity task.

    

  
  :type CapacityTaskId: string
  :param CapacityTaskId: **[REQUIRED]** 

    The ID of the capacity task.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum page size.

    

  
  :type NextToken: string
  :param NextToken: 

    The pagination token.

    

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

    
    ::

      {
          'BlockingInstances': [
              {
                  'InstanceId': 'string',
                  'AccountId': 'string',
                  'AwsServiceName': 'AWS'|'EC2'|'ELASTICACHE'|'ELB'|'RDS'|'ROUTE53'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **BlockingInstances** *(list) --* 

        A list of all running Amazon EC2 instances on the Outpost. Stopping one or more of these instances can free up the capacity needed to run the capacity task.

        
        

        - *(dict) --* 

          A running Amazon EC2 instance that can be stopped to free up capacity needed to run the capacity task.

          
          

          - **InstanceId** *(string) --* 

            The ID of the blocking instance.

            
          

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

            The ID of the Amazon Web Services account.

            
          

          - **AwsServiceName** *(string) --* 

            The Amazon Web Services service name that owns the specified blocking instance.

            
      
    
      

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

        The pagination token.

        
  
  **Exceptions**
  
  *   :py:class:`Outposts.Client.exceptions.ValidationException`

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

  
  *   :py:class:`Outposts.Client.exceptions.NotFoundException`

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

  