:doc:`GameLiftStreams <../../gameliftstreams>` / Client / disassociate_applications

*************************
disassociate_applications
*************************



.. py:method:: GameLiftStreams.Client.disassociate_applications(**kwargs)

  

  When you disassociate, or unlink, an application from a stream group, you can no longer stream this application by using that stream group's allocated compute resources. Any streams in process will continue until they terminate, which helps avoid interrupting an end-user's stream. Amazon GameLift Streams will not initiate new streams in the stream group using the disassociated application. The disassociate action does not affect the stream capacity of a stream group. To disassociate an application, the stream group must be in ``ACTIVE`` status.

   

  If you disassociate the default application, Amazon GameLift Streams will automatically choose a new default application from the remaining associated applications. To change which application is the default application, call `UpdateStreamGroup <https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html>`__ and specify a new ``DefaultApplicationIdentifier``.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/gameliftstreams-2018-05-10/DisassociateApplications>`_  


  **Request Syntax**
  ::

    response = client.disassociate_applications(
        Identifier='string',
        ApplicationIdentifiers=[
            'string',
        ]
    )
    
  :type Identifier: string
  :param Identifier: **[REQUIRED]** 

    A stream group to disassociate these applications from.

     

    This value is an `Amazon Resource Name (ARN) <https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html>`__ or ID that uniquely identifies the stream group resource. Example ARN: ``arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4``. Example ID: ``sg-1AB2C3De4``.

    

  
  :type ApplicationIdentifiers: list
  :param ApplicationIdentifiers: **[REQUIRED]** 

    A set of applications that you want to disassociate from the stream group.

     

    This value is a set of either `Amazon Resource Names (ARN) <https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html>`__ or IDs that uniquely identify application resources. Example ARN: ``arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6``. Example ID: ``a-9ZY8X7Wv6``.

    

  
    - *(string) --* 

    

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

    
    ::

      {
          'Arn': 'string',
          'ApplicationArns': [
              'string',
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

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

        An `Amazon Resource Name (ARN) <https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html>`__ that uniquely identifies the stream group resource. Example ARN: ``arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4``.

        
      

      - **ApplicationArns** *(list) --* 

        A set of applications that are disassociated from this stream group.

         

        This value is a set of `Amazon Resource Names (ARNs) <https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html>`__ that uniquely identify application resources. Example ARN: ``arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6``.

        
        

        - *(string) --* 
    
  
  **Exceptions**
  
  *   :py:class:`GameLiftStreams.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`GameLiftStreams.Client.exceptions.ResourceNotFoundException`

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

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

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

  