Share via


SubscriptionResource.CreateOrUpdatePredefinedTag 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 Azure.Response<Azure.ResourceManager.Resources.Models.PredefinedTag> CreateOrUpdatePredefinedTag (string tagName, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateOrUpdatePredefinedTag : string * System.Threading.CancellationToken -> Azure.Response<Azure.ResourceManager.Resources.Models.PredefinedTag>
override this.CreateOrUpdatePredefinedTag : string * System.Threading.CancellationToken -> Azure.Response<Azure.ResourceManager.Resources.Models.PredefinedTag>
Public Overridable Function CreateOrUpdatePredefinedTag (tagName As String, Optional cancellationToken As CancellationToken = Nothing) As 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