:doc:`Route53Profiles <../../route53profiles>` / Client / associate_profile

*****************
associate_profile
*****************



.. py:method:: Route53Profiles.Client.associate_profile(**kwargs)

  

  Associates a Route 53 Profiles profile with a VPC. A VPC can have only one Profile associated with it, but a Profile can be associated with 1000 of VPCs (and you can request a higher quota). For more information, see `https\://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html#limits-api-entities <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/DNSLimitations.html#limits-api-entities>`__.

  

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


  **Request Syntax**
  ::

    response = client.associate_profile(
        Name='string',
        ProfileId='string',
        ResourceId='string',
        Tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    )
    
  :type Name: string
  :param Name: **[REQUIRED]** 

    A name for the association.

    

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

    ID of the Profile.

    

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

    The ID of the VPC.

    

  
  :type Tags: list
  :param Tags: 

    A list of the tag keys and values that you want to identify the Profile association.

    

  
    - *(dict) --* 

      Tag for the Profile.

      

    
      - **Key** *(string) --* **[REQUIRED]** 

        Key associated with the ``Tag``.

        

      
      - **Value** *(string) --* **[REQUIRED]** 

        Value for the Tag.

        

      
    

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

    
    ::

      {
          'ProfileAssociation': {
              'CreationTime': datetime(2015, 1, 1),
              'Id': 'string',
              'ModificationTime': datetime(2015, 1, 1),
              'Name': 'string',
              'OwnerId': 'string',
              'ProfileId': 'string',
              'ResourceId': 'string',
              'Status': 'COMPLETE'|'DELETING'|'UPDATING'|'CREATING'|'DELETED'|'FAILED',
              'StatusMessage': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ProfileAssociation** *(dict) --* 

        The association that you just created. The association has an ID that you can use to identify it in other requests, like update and delete.

        
        

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

          The date and time that the Profile association was created, in Unix time format and Coordinated Universal Time (UTC).

          
        

        - **Id** *(string) --* 

          ID of the Profile association.

          
        

        - **ModificationTime** *(datetime) --* 

          The date and time that the Profile association was modified, in Unix time format and Coordinated Universal Time (UTC).

          
        

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

          Name of the Profile association.

          
        

        - **OwnerId** *(string) --* 

          Amazon Web Services account ID of the Profile association owner.

          
        

        - **ProfileId** *(string) --* 

          ID of the Profile.

          
        

        - **ResourceId** *(string) --* 

          The Amazon Resource Name (ARN) of the VPC.

          
        

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

          Status of the Profile association.

          
        

        - **StatusMessage** *(string) --* 

          Additional information about the Profile association.

          
    
  
  **Exceptions**
  
  *   :py:class:`Route53Profiles.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`Route53Profiles.Client.exceptions.ResourceExistsException`

  
  *   :py:class:`Route53Profiles.Client.exceptions.LimitExceededException`

  
  *   :py:class:`Route53Profiles.Client.exceptions.InvalidParameterException`

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

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

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

  
  *   :py:class:`Route53Profiles.Client.exceptions.ConflictException`

  