IApiTagDescriptionOperations.CreateOrUpdateWithHttpMessagesAsync Method

Definition

Namespace:

Microsoft.Azure.Management.ApiManagement

Assembly:

Microsoft.Azure.Management.ApiManagement.dll

Package:

Microsoft.Azure.Management.ApiManagement v8.0.0-preview

Create/Update tag description in scope of the Api.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.Management.ApiManagement.Models.TagDescriptionContract,Microsoft.Azure.Management.ApiManagement.Models.ApiTagDescriptionCreateOrUpdateHeaders>> CreateOrUpdateWithHttpMessagesAsync (string resourceGroupName, string serviceName, string apiId, string tagDescriptionId, Microsoft.Azure.Management.ApiManagement.Models.TagDescriptionCreateParameters parameters, string ifMatch = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateOrUpdateWithHttpMessagesAsync : string * string * string * string * Microsoft.Azure.Management.ApiManagement.Models.TagDescriptionCreateParameters * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.Management.ApiManagement.Models.TagDescriptionContract, Microsoft.Azure.Management.ApiManagement.Models.ApiTagDescriptionCreateOrUpdateHeaders>>

Public Function CreateOrUpdateWithHttpMessagesAsync (resourceGroupName As String, serviceName As String, apiId As String, tagDescriptionId As String, parameters As TagDescriptionCreateParameters, Optional ifMatch As String = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse(Of TagDescriptionContract, ApiTagDescriptionCreateOrUpdateHeaders))

Parameters

resourceGroupName

String

The name of the resource group.

serviceName

String

The name of the API Management service.

apiId

String

API revision identifier. Must be unique in the current API Management service instance. Non-current revision has ;rev=n as a suffix where n is the revision number.

tagDescriptionId

String

Tag description identifier. Used when creating tagDescription for API/Tag association. Based on API and Tag names.

parameters

TagDescriptionCreateParameters

Create parameters.

ifMatch

String

ETag of the Entity. Not required when creating an entity, but required when updating an entity.

customHeaders

Dictionary<String,List<String>>

The headers that will be added to request.

cancellationToken

CancellationToken

The cancellation token.

Returns

Task<AzureOperationResponse<TagDescriptionContract,ApiTagDescriptionCreateOrUpdateHeaders>>

Exceptions

ErrorResponseException

Thrown when the operation returned an invalid status code

SerializationException

Thrown when unable to deserialize the response

ValidationException

Thrown when a required parameter is null