ApiCollection.CreateOrUpdate Method

Definition

Namespace:

Azure.ResourceManager.ApiManagement

Assembly:

Azure.ResourceManager.ApiManagement.dll

Package:

Azure.ResourceManager.ApiManagement v1.1.0

Source:

ApiCollection.cs

Creates new or updates existing specified API of the API Management service instance.

• Request Path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}
• Operation Id: Api_CreateOrUpdate
• Default Api Version: 2021-08-01
• Resource: ApiResource

public virtual Azure.ResourceManager.ArmOperation<Azure.ResourceManager.ApiManagement.ApiResource> CreateOrUpdate (Azure.WaitUntil waitUntil, string apiId, Azure.ResourceManager.ApiManagement.Models.ApiCreateOrUpdateContent content, Azure.ETag? ifMatch = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateOrUpdate : Azure.WaitUntil * string * Azure.ResourceManager.ApiManagement.Models.ApiCreateOrUpdateContent * Nullable<Azure.ETag> * System.Threading.CancellationToken -> Azure.ResourceManager.ArmOperation<Azure.ResourceManager.ApiManagement.ApiResource>
override this.CreateOrUpdate : Azure.WaitUntil * string * Azure.ResourceManager.ApiManagement.Models.ApiCreateOrUpdateContent * Nullable<Azure.ETag> * System.Threading.CancellationToken -> Azure.ResourceManager.ArmOperation<Azure.ResourceManager.ApiManagement.ApiResource>

Public Overridable Function CreateOrUpdate (waitUntil As WaitUntil, apiId As String, content As ApiCreateOrUpdateContent, Optional ifMatch As Nullable(Of ETag) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As ArmOperation(Of ApiResource)

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.

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.

content

ApiCreateOrUpdateContent

Create or update parameters.

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

ArmOperation<ApiResource>

Exceptions

ArgumentException

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

ArgumentNullException

apiId or content is null.