DnsDSRecordCollection.CreateOrUpdateAsync Method

Definition

Namespace:

Azure.ResourceManager.Dns

Assembly:

Azure.ResourceManager.Dns.dll

Package:

Azure.ResourceManager.Dns v1.2.0-beta.2

Source:

DnsDSRecordCollection.cs

Creates or updates a record set within a DNS zone. Record sets of type SOA can be updated but not created (they are created when the DNS zone is created).

• Request Path: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}/{recordType}/{relativeRecordSetName}
• Operation Id: RecordSets_CreateOrUpdate

public virtual System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Dns.DnsDSRecordResource>> CreateOrUpdateAsync (Azure.WaitUntil waitUntil, string relativeRecordSetName, Azure.ResourceManager.Dns.DnsDSRecordData data, Azure.ETag? ifMatch = default, string ifNoneMatch = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.Dns.DnsDSRecordData * Nullable<Azure.ETag> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Dns.DnsDSRecordResource>>
override this.CreateOrUpdateAsync : Azure.WaitUntil * string * Azure.ResourceManager.Dns.DnsDSRecordData * Nullable<Azure.ETag> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.ResourceManager.ArmOperation<Azure.ResourceManager.Dns.DnsDSRecordResource>>

Public Overridable Function CreateOrUpdateAsync (waitUntil As WaitUntil, relativeRecordSetName As String, data As DnsDSRecordData, Optional ifMatch As Nullable(Of ETag) = Nothing, Optional ifNoneMatch As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ArmOperation(Of DnsDSRecordResource))

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.

relativeRecordSetName

String

The name of the record set, relative to the name of the zone.

data

DnsDSRecordData

Parameters supplied to the CreateOrUpdate operation.

ifMatch

Nullable<ETag>

The etag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen etag value to prevent accidentally overwriting any concurrent changes.

ifNoneMatch

String

Set to '*' to allow a new record set to be created, but to prevent updating an existing record set. Other values will be ignored.

cancellationToken

CancellationToken

The cancellation token to use.

Returns

Task<ArmOperation<DnsDSRecordResource>>

Exceptions

ArgumentNullException

relativeRecordSetName or data is null.