:doc:`ACMPCA <../../acm-pca>` / Client / untag_certificate_authority

***************************
untag_certificate_authority
***************************



.. py:method:: ACMPCA.Client.untag_certificate_authority(**kwargs)

  

  Remove one or more tags from your private CA. A tag consists of a key-value pair. If you do not specify the value portion of the tag when calling this action, the tag will be removed regardless of value. If you specify a value, the tag is removed only if it is associated with the specified value. To add tags to a private CA, use the `TagCertificateAuthority <https://docs.aws.amazon.com/privateca/latest/APIReference/API_TagCertificateAuthority.html>`__. Call the `ListTags <https://docs.aws.amazon.com/privateca/latest/APIReference/API_ListTags.html>`__ action to see what tags are associated with your CA.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/acm-pca-2017-08-22/UntagCertificateAuthority>`_  


  **Request Syntax**
  ::

    response = client.untag_certificate_authority(
        CertificateAuthorityArn='string',
        Tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    )
    
  :type CertificateAuthorityArn: string
  :param CertificateAuthorityArn: **[REQUIRED]** 

    The Amazon Resource Name (ARN) that was returned when you called `CreateCertificateAuthority <https://docs.aws.amazon.com/privateca/latest/APIReference/API_CreateCertificateAuthority.html>`__. This must be of the form:

     

    ``arn:aws:acm-pca:region:account:certificate-authority/12345678-1234-1234-1234-123456789012``

    

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

    List of tags to be removed from the CA.

    

  
    - *(dict) --* 

      Tags are labels that you can use to identify and organize your private CAs. Each tag consists of a key and an optional value. You can associate up to 50 tags with a private CA. To add one or more tags to a private CA, call the `TagCertificateAuthority <https://docs.aws.amazon.com/privateca/latest/APIReference/API_TagCertificateAuthority.html>`__ action. To remove a tag, call the `UntagCertificateAuthority <https://docs.aws.amazon.com/privateca/latest/APIReference/API_UntagCertificateAuthority.html>`__ action.

      

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

        Key (name) of the tag.

        

      
      - **Value** *(string) --* 

        Value of the tag.

        

      
    

  
  :returns: None
  **Exceptions**
  
  *   :py:class:`ACMPCA.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`ACMPCA.Client.exceptions.InvalidArnException`

  
  *   :py:class:`ACMPCA.Client.exceptions.InvalidStateException`

  
  *   :py:class:`ACMPCA.Client.exceptions.InvalidTagException`

  