Share via


SubscriptionResource.CreateOrUpdatePredefinedTagAsync Method

Definition

This operation allows adding a name to the list of predefined tag names for the given subscription. A tag name can have a maximum of 512 characters and is case-insensitive. Tag names cannot have the following prefixes which are reserved for Azure use: 'microsoft', 'azure', 'windows'.

  • Request Path: /subscriptions/{subscriptionId}/tagNames/{tagName}
  • Operation Id: Tags_CreateOrUpdate
  • Default Api Version: 2022-09-01
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.ResourceManager.Resources.Models.PredefinedTag>> CreateOrUpdatePredefinedTagAsync (string tagName, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrUpdatePredefinedTagAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.ResourceManager.Resources.Models.PredefinedTag>>
override this.CreateOrUpdatePredefinedTagAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.ResourceManager.Resources.Models.PredefinedTag>>
Public Overridable Function CreateOrUpdatePredefinedTagAsync (tagName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of PredefinedTag))

Parameters

tagName
String

The name of the tag to create.

cancellationToken
CancellationToken

The cancellation token to use.

Returns

Exceptions

tagName is an empty string, and was expected to be non-empty.

tagName is null.

Applies to