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

**********************
associate_applications
**********************



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

  

  When you associate, or link, an application with a stream group, then Amazon GameLift Streams can launch the application using the stream group's allocated compute resources. The stream group must be in ``ACTIVE`` status. You can reverse this action by using `DisassociateApplications <https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DisassociateApplications.html>`__.

   

  If a stream group does not already have a linked application, Amazon GameLift Streams will automatically assign the first application provided in ``ApplicationIdentifiers`` as the default.

  

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


  **Request Syntax**
  ::

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

    A stream group to associate to the applications.

     

    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 to associate with 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) --* 

        A stream group that is associated to the applications.

         

        This value is 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 associated to the 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`

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

  