ApiManagementGatewayHostnameConfigurationCollection.CreateOrUpdateAsync Method

Definition

Namespace:

Azure.ResourceManager.ApiManagement

Assembly:

Azure.ResourceManager.ApiManagement.dll

Package:

Azure.ResourceManager.ApiManagement v1.2.0

Source:

ApiManagementGatewayHostnameConfigurationCollection.cs

Creates of updates hostname configuration for a Gateway.

• Request Path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/hostnameConfigurations/{hcId}
• Operation Id: GatewayHostnameConfiguration_CreateOrUpdate
• Default Api Version: 2023-03-01-preview
• Resource: ApiManagementGatewayHostnameConfigurationResource

public virtual System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.ApiManagement.ApiManagementGatewayHostnameConfigurationResource>> CreateOrUpdateAsync (Azure.WaitUntil waitUntil, string hcId, Azure.ResourceManager.ApiManagement.ApiManagementGatewayHostnameConfigurationData data, Azure.ETag? ifMatch = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.ApiManagement.ApiManagementGatewayHostnameConfigurationData * Nullable<Azure.ETag> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.ApiManagement.ApiManagementGatewayHostnameConfigurationResource>>
override this.CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.ApiManagement.ApiManagementGatewayHostnameConfigurationData * Nullable<Azure.ETag> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.ApiManagement.ApiManagementGatewayHostnameConfigurationResource>>

Public Overridable Function CreateOrUpdateAsync (waitUntil As WaitUntil, hcId As String, data As ApiManagementGatewayHostnameConfigurationData, Optional ifMatch As Nullable(Of ETag) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ArmOperation(Of ApiManagementGatewayHostnameConfigurationResource))

Parameters

waitUntil

WaitUntil

Completed if the method should wait to return until the long-running operation has completed on the service; Started if it should return after starting the operation. For more information on long-running operations, please see Azure.Core Long-Running Operation samples.

hcId

String

Gateway hostname configuration identifier. Must be unique in the scope of parent Gateway entity.

data

ApiManagementGatewayHostnameConfigurationData

The ApiManagementGatewayHostnameConfigurationData to use.

ifMatch

Nullable<ETag>

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

cancellationToken

CancellationToken

The cancellation token to use.

Returns

Task<ArmOperation<ApiManagementGatewayHostnameConfigurationResource>>

Exceptions

ArgumentException

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

ArgumentNullException

hcId or data is null.