Tags - Create Or Update

Service:

Resource Management

API Version:

2021-04-01

建立預先定義的標記名稱。
此作業允許將名稱新增至指定訂用帳戶的預先定義標籤名稱清單。 標籤名稱最多可以有 512 個字元，而且不區分大小寫。 標記名稱不能有下列保留給 Azure 使用的前置詞：『microsoft』、『azure』、『windows』。

PUT https://management.azure.com/subscriptions/{subscriptionId}/tagNames/{tagName}?api-version=2021-04-01

URI 參數

名稱	位於	必要	類型	Description
subscriptionId	path	True	string	Microsoft Azure 訂用帳戶標識碼。
tagName	path	True	string	要建立的標記名稱。
api-version	query	True	string	用於此作業的 API 版本。

回應

名稱	類型	Description
200 OK	TagDetails	預先定義的標籤名稱已經存在。 傳回預先定義標籤名稱的相關信息。
201 Created	TagDetails	已成功建立預先定義的標籤名稱。 傳回預先定義標籤名稱的相關信息。
Other Status Codes	CloudError	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名稱	Description
user_impersonation	模擬您的用戶帳戶

定義

名稱	Description
CloudError	資源管理要求的錯誤回應。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorResponse	錯誤回應
TagCount	標記計數。
TagDetails	標記詳細資料。
TagValue	標記資訊。

CloudError

資源管理要求的錯誤回應。

名稱	類型	Description
error	ErrorResponse	錯誤回應 所有 Azure Resource Manager API 的常見錯誤回應，以傳回失敗作業的錯誤詳細數據。 (這也會遵循 OData 錯誤回應格式。)

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorResponse

錯誤回應

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorResponse[]	錯誤詳細資料。
message	string	錯誤訊息。
target	string	錯誤目標。

TagCount

標記計數。

名稱	類型	Description
type	string	計數的類型。
value	integer	計數的值。

TagDetails

標記詳細資料。

名稱	類型	Description
count	TagCount	使用資源標籤的資源總數。 一開始建立標記且沒有相關聯的資源時，值為 0。
id	string	標記名稱識別碼。
tagName	string	標記名稱。
values	TagValue[]	標記值的清單。

TagValue

標記資訊。

名稱	類型	Description
count	TagCount	標籤值計數。
id	string	標記值標識碼。
tagValue	string	標籤值。