:doc:`SSM <../../ssm>` / Client / delete_association

******************
delete_association
******************



.. py:method:: SSM.Client.delete_association(**kwargs)

  

  Disassociates the specified Amazon Web Services Systems Manager document (SSM document) from the specified managed node. If you created the association by using the ``Targets`` parameter, then you must delete the association by using the association ID.

   

  When you disassociate a document from a managed node, it doesn't change the configuration of the node. To change the configuration state of a managed node after you disassociate a document, you must create a new document with the desired configuration and associate it with the node.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DeleteAssociation>`_  


  **Request Syntax**
  ::

    response = client.delete_association(
        Name='string',
        InstanceId='string',
        AssociationId='string'
    )
    
  :type Name: string
  :param Name: 

    The name of the SSM document.

    

  
  :type InstanceId: string
  :param InstanceId: 

    The managed node ID.

     

    .. note::

      

      ``InstanceId`` has been deprecated. To specify a managed node ID for an association, use the ``Targets`` parameter. Requests that include the parameter ``InstanceID`` with Systems Manager documents (SSM documents) that use schema version 2.0 or later will fail. In addition, if you use the parameter ``InstanceId``, you can't use the parameters ``AssociationName``, ``DocumentVersion``, ``MaxErrors``, ``MaxConcurrency``, ``OutputLocation``, or ``ScheduleExpression``. To use these parameters, you must use the ``Targets`` parameter.

      

    

  
  :type AssociationId: string
  :param AssociationId: 

    The association ID that you want to delete.

    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`SSM.Client.exceptions.AssociationDoesNotExist`

  
  *   :py:class:`SSM.Client.exceptions.InternalServerError`

  
  *   :py:class:`SSM.Client.exceptions.InvalidDocument`

  
  *   :py:class:`SSM.Client.exceptions.InvalidInstanceId`

  
  *   :py:class:`SSM.Client.exceptions.TooManyUpdates`

  