你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

TagsOperations 类

警告

请勿直接实例化此类。

相反，应通过以下方式访问以下操作：

ResourceManagementClient的

<xref:tags> 属性。

继承

builtins.object

TagsOperations

构造函数

TagsOperations(*args, **kwargs)

方法

begin_create_or_update_at_scope	在资源或订阅上创建或更新整个标记集。 此操作允许在指定资源或订阅上添加或替换整个标记集。 指定的实体最多可以有 50 个标记。
begin_delete_at_scope	删除资源或订阅上的整个标记集。 删除资源或订阅上的整个标记集。
begin_update_at_scope	有选择地更新资源或订阅上的标记集。 此操作允许替换、合并或有选择地删除指定资源或订阅上的标记。 指定的实体在操作结束时最多可以有 50 个标记。 “替换”选项将整个现有标记集替换为新集。 “合并”选项允许添加具有新名称的标记，以及使用现有名称更新标记的值。 “delete”选项允许根据给定的名称或名称/值对有选择地删除标记。
create_or_update	创建预定义的标记名称。 此操作允许将名称添加到给定订阅的预定义标记名称列表中。 标记名称最多可以包含 512 个字符，并且不区分大小写。 标记名称不能具有以下为 Azure 使用保留的前缀：“microsoft”、“azure”、“windows”。
create_or_update_value	为预定义的标记名称创建预定义值。 此操作允许将值添加到现有预定义标记名称的预定义值列表中。 标记值最多可以包含 256 个字符。
delete	删除预定义的标记名称。 此操作允许从给定订阅的预定义标记名称列表中删除名称。 要删除的名称不得用作任何资源的标记名称。 必须已删除给定名称的所有预定义值。
delete_value	删除预定义标记名称的预定义标记值。 此操作允许从现有预定义标记名称的预定义值列表中删除值。 要删除的值不得用作任何资源的给定标记名称的标记值。
get_at_scope	获取资源或订阅上的整个标记集。 获取资源或订阅上的整个标记集。
list	获取订阅下的标记使用情况的摘要。 此操作执行预定义标记、资源标记、资源组标记和订阅标记的联合，并返回给定订阅下每个标记名称和值的使用情况摘要。 如果标记数量较大，此操作可能会返回以前缓存的结果。

begin_create_or_update_at_scope

在资源或订阅上创建或更新整个标记集。

此操作允许在指定资源或订阅上添加或替换整个标记集。 指定的实体最多可以有 50 个标记。

begin_create_or_update_at_scope(scope: str, parameters: _models.TagsResource, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.TagsResource]

参数

scope

str

必需

资源范围。 必需。

parameters

TagsResource 或 IO

必需

是 TagsResource 类型或 IO 类型。 必需。

content_type

str

正文参数内容类型。 已知值为：“application/json”。 默认值为 None。

cls

callable

将传递直接响应的自定义类型或函数

continuation_token

str

用于从保存状态重启轮询的延续标记。

polling

bool 或 PollingMethod

默认情况下，轮询方法将为 ARMPolling。 如果此操作不轮询，则传入 False，或者为个人轮询策略传入你自己的初始化轮询对象。

polling_interval

int

如果没有Retry-After标头，则 LRO 操作的两次轮询之间的默认等待时间。

返回

返回 TagsResource 或 cls (响应结果的 LROPoller 实例)

返回类型

LROPoller[TagsResource]

例外

HttpResponseError

begin_delete_at_scope

删除资源或订阅上的整个标记集。

删除资源或订阅上的整个标记集。

begin_delete_at_scope(scope: str, **kwargs: Any) -> LROPoller[None]

参数

scope

str

必需

资源范围。 必需。

cls

callable

将传递直接响应的自定义类型或函数

continuation_token

str

用于从保存状态重启轮询的延续标记。

polling

bool 或 PollingMethod

默认情况下，轮询方法将为 ARMPolling。 如果此操作不轮询，则传入 False，或者为个人轮询策略传入你自己的初始化轮询对象。

polling_interval

int

如果没有Retry-After标头，则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例，返回 None 或 cls 的结果 (响应)

返回类型

LROPoller[None]

例外

HttpResponseError

begin_update_at_scope

有选择地更新资源或订阅上的标记集。

此操作允许替换、合并或有选择地删除指定资源或订阅上的标记。 指定的实体在操作结束时最多可以有 50 个标记。 “替换”选项将整个现有标记集替换为新集。 “合并”选项允许添加具有新名称的标记，以及使用现有名称更新标记的值。 “delete”选项允许根据给定的名称或名称/值对有选择地删除标记。

begin_update_at_scope(scope: str, parameters: _models.TagsPatchResource, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.TagsResource]

参数

scope

str

必需

资源范围。 必需。

parameters

TagsPatchResource 或 IO

必需

是 TagsPatchResource 类型或 IO 类型。 必需。

content_type

str

正文参数内容类型。 已知值为：“application/json”。 默认值为 None。

cls

callable

将传递直接响应的自定义类型或函数

continuation_token

str

用于从保存状态重启轮询的延续标记。

polling

bool 或 PollingMethod

默认情况下，轮询方法将为 ARMPolling。 如果此操作不轮询，则传入 False，或者为个人轮询策略传入你自己的初始化轮询对象。

polling_interval

int

如果没有Retry-After标头，则 LRO 操作的两次轮询之间的默认等待时间。

返回

返回 TagsResource 或 cls (响应结果的 LROPoller 实例)

返回类型

LROPoller[TagsResource]

例外

HttpResponseError

create_or_update

创建预定义的标记名称。

此操作允许将名称添加到给定订阅的预定义标记名称列表中。 标记名称最多可以包含 512 个字符，并且不区分大小写。 标记名称不能具有以下为 Azure 使用保留的前缀：“microsoft”、“azure”、“windows”。

create_or_update(tag_name: str, **kwargs: Any) -> TagDetails

参数

tag_name

str

必需

要创建的标记的名称。 必需。

cls

callable

将传递直接响应的自定义类型或函数

返回

TagDetails 或 cls 的结果 (响应)

返回类型

TagDetails

例外

HttpResponseError

create_or_update_value

为预定义的标记名称创建预定义值。

此操作允许将值添加到现有预定义标记名称的预定义值列表中。 标记值最多可以包含 256 个字符。

create_or_update_value(tag_name: str, tag_value: str, **kwargs: Any) -> TagValue

参数

tag_name

str

必需

该标记的名称。 必需。

tag_value

str

必需

要创建的标记的值。 必需。

cls

callable

将传递直接响应的自定义类型或函数

返回

TagValue 或 cls 的结果 (响应)

返回类型

TagValue

例外

HttpResponseError

delete

删除预定义的标记名称。

此操作允许从给定订阅的预定义标记名称列表中删除名称。 要删除的名称不得用作任何资源的标记名称。 必须已删除给定名称的所有预定义值。

delete(tag_name: str, **kwargs: Any) -> None

参数

tag_name

str

必需

该标记的名称。 必需。

cls

callable

将传递直接响应的自定义类型或函数

返回

无或 cls 的结果 (响应)

返回类型

None

例外

HttpResponseError

delete_value

删除预定义标记名称的预定义标记值。

此操作允许从现有预定义标记名称的预定义值列表中删除值。 要删除的值不得用作任何资源的给定标记名称的标记值。

delete_value(tag_name: str, tag_value: str, **kwargs: Any) -> None

参数

tag_name

str

必需

该标记的名称。 必需。

tag_value

str

必需

要删除的标记的值。 必需。

cls

callable

将传递直接响应的自定义类型或函数

返回

无或 cls 的结果 (响应)

返回类型

None

例外

HttpResponseError

get_at_scope

获取资源或订阅上的整个标记集。

获取资源或订阅上的整个标记集。

get_at_scope(scope: str, **kwargs: Any) -> TagsResource

参数

scope

str

必需

资源范围。 必需。

cls

callable

将传递直接响应的自定义类型或函数

返回

TagsResource 或 cls 的结果 (响应)

返回类型

TagsResource

例外

HttpResponseError

list

获取订阅下的标记使用情况的摘要。

此操作执行预定义标记、资源标记、资源组标记和订阅标记的联合，并返回给定订阅下每个标记名称和值的使用情况摘要。 如果标记数量较大，此操作可能会返回以前缓存的结果。

list(**kwargs: Any) -> Iterable[TagDetails]

参数

cls

callable

将传递直接响应的自定义类型或函数

返回

一个迭代器，如 TagDetails 的实例或 cls 的结果 (响应)

返回类型

ItemPaged[TagDetails]

例外

HttpResponseError

属性

models

models = <module 'azure.mgmt.resource.resources.v2022_09_01.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\mgmt\\resource\\resources\\v2022_09_01\\models\\__init__.py'>