azure.mgmt.resource.resources.v2019_08_01.operations.TagsOperations.yml

### YamlMime:PythonClass
uid: azure.mgmt.resource.resources.v2019_08_01.operations.TagsOperations
name: TagsOperations
fullName: azure.mgmt.resource.resources.v2019_08_01.operations.TagsOperations
module: azure.mgmt.resource.resources.v2019_08_01.operations
inheritances:
- builtins.object
summary: "> [!WARNING]\n> DO NOT instantiate this class directly.\n>\n> \n>\n> Instead,\
  \ you should access the following operations through\n>\n> <xref:azure.mgmt.resource.resources.v2019_08_01.ResourceManagementClient>'s\n\
  >\n> <xref:tags> attribute.\n>"
constructor:
  syntax: TagsOperations(*args, **kwargs)
methods:
- uid: azure.mgmt.resource.resources.v2019_08_01.operations.TagsOperations.create_or_update
  name: create_or_update
  summary: 'Creates a tag in the subscription.


    The tag name can have a maximum of 512 characters and is case insensitive. Tag
    names created by

    Azure have prefixes of microsoft, azure, or windows. You cannot create tags with
    one of these

    prefixes.'
  signature: 'create_or_update(tag_name: str, **kwargs: Any) -> TagDetails'
  parameters:
  - name: tag_name
    description: The name of the tag to create. Required.
    isRequired: true
    types:
    - <xref:str>
  return:
    description: TagDetails or the result of cls(response)
    types:
    - <xref:azure.mgmt.resource.resources.v2019_08_01.models.TagDetails>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.resource.resources.v2019_08_01.operations.TagsOperations.create_or_update_value
  name: create_or_update_value
  summary: Creates a tag value. The name of the tag must already exist.
  signature: 'create_or_update_value(tag_name: str, tag_value: str, **kwargs: Any)
    -> TagValue'
  parameters:
  - name: tag_name
    description: The name of the tag. Required.
    isRequired: true
    types:
    - <xref:str>
  - name: tag_value
    description: The value of the tag to create. Required.
    isRequired: true
    types:
    - <xref:str>
  return:
    description: TagValue or the result of cls(response)
    types:
    - <xref:azure.mgmt.resource.resources.v2019_08_01.models.TagValue>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.resource.resources.v2019_08_01.operations.TagsOperations.delete
  name: delete
  summary: 'Deletes a tag from the subscription.


    You must remove all values from a resource tag before you can delete it.'
  signature: 'delete(tag_name: str, **kwargs: Any) -> None'
  parameters:
  - name: tag_name
    description: The name of the tag. Required.
    isRequired: true
    types:
    - <xref:str>
  return:
    description: None or the result of cls(response)
    types:
    - <xref:None>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.resource.resources.v2019_08_01.operations.TagsOperations.delete_value
  name: delete_value
  summary: Deletes a tag value.
  signature: 'delete_value(tag_name: str, tag_value: str, **kwargs: Any) -> None'
  parameters:
  - name: tag_name
    description: The name of the tag. Required.
    isRequired: true
    types:
    - <xref:str>
  - name: tag_value
    description: The value of the tag to delete. Required.
    isRequired: true
    types:
    - <xref:str>
  return:
    description: None or the result of cls(response)
    types:
    - <xref:None>
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
- uid: azure.mgmt.resource.resources.v2019_08_01.operations.TagsOperations.list
  name: list
  summary: Gets the names and values of all resource tags that are defined in a subscription.
  signature: 'list(**kwargs: Any) -> Iterable[TagDetails]'
  return:
    description: An iterator like instance of either TagDetails or the result of cls(response)
    types:
    - <xref:azure.core.paging.ItemPaged>[<xref:azure.mgmt.resource.resources.v2019_08_01.models.TagDetails>]
  exceptions:
  - type: azure.core.exceptions.HttpResponseError
attributes:
- uid: azure.mgmt.resource.resources.v2019_08_01.operations.TagsOperations.models
  name: models
  signature: models = <module 'azure.mgmt.resource.resources.v2019_08_01.models' from
    'C:\\hostedtoolcache\\windows\\Python\\3.11.9\\x64\\Lib\\site-packages\\azure\\mgmt\\resource\\resources\\v2019_08_01\\models\\__init__.py'>