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

*************************
unlabel_parameter_version
*************************



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

  

  Remove a label or labels from a parameter.

   

  Parameter names can't contain spaces. The service removes any spaces specified for the beginning or end of a parameter name. If the specified name for a parameter contains spaces between characters, the request fails with a ``ValidationException`` error.

  

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


  **Request Syntax**
  ::

    response = client.unlabel_parameter_version(
        Name='string',
        ParameterVersion=123,
        Labels=[
            'string',
        ]
    )
    
  :type Name: string
  :param Name: **[REQUIRED]** 

    The name of the parameter from which you want to delete one or more labels.

     

    .. note::

      

      You can't enter the Amazon Resource Name (ARN) for a parameter, only the parameter name itself.

      

    

  
  :type ParameterVersion: integer
  :param ParameterVersion: **[REQUIRED]** 

    The specific version of the parameter which you want to delete one or more labels from. If it isn't present, the call will fail.

    

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

    One or more labels to delete from the specified parameter version.

    

  
    - *(string) --* 

    

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

    
    ::

      {
          'RemovedLabels': [
              'string',
          ],
          'InvalidLabels': [
              'string',
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **RemovedLabels** *(list) --* 

        A list of all labels deleted from the parameter.

        
        

        - *(string) --* 
    
      

      - **InvalidLabels** *(list) --* 

        The labels that aren't attached to the given parameter version.

        
        

        - *(string) --* 
    
  
  **Exceptions**
  
  *   :py:class:`SSM.Client.exceptions.InternalServerError`

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

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

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

  