IDnsService.UpdatePtrRecordsAsync Method

IDnsServiceUpdatePtrRecordsAsync Method

This API is preliminary and subject to change.

Update reverse DNS records for a cloud resource in the DNS service.

Namespace: net.openstack.Providers.Rackspace
Assembly: openstacknet (in openstacknet.dll) Version: 1.7.7+Branch.master.Sha.25d803f397c8693c2c13777ef6675f796f520f2c

Syntax

C++

Copy

Task<DnsJob> UpdatePtrRecordsAsync(
	string serviceName,
	Uri deviceResourceUri,
	IEnumerable<DnsDomainRecordUpdateConfiguration> recordConfigurations,
	AsyncCompletionOption completionOption,
	CancellationToken cancellationToken,
	IProgress<DnsJob> progress
)

Function UpdatePtrRecordsAsync ( 
	serviceName As String,
	deviceResourceUri As Uri,
	recordConfigurations As IEnumerable(Of DnsDomainRecordUpdateConfiguration),
	completionOption As AsyncCompletionOption,
	cancellationToken As CancellationToken,
	progress As IProgress(Of DnsJob)
) As Task(Of DnsJob)

Task<DnsJob^>^ UpdatePtrRecordsAsync(
	String^ serviceName, 
	Uri^ deviceResourceUri, 
	IEnumerable<DnsDomainRecordUpdateConfiguration^>^ recordConfigurations, 
	AsyncCompletionOption completionOption, 
	CancellationToken cancellationToken, 
	IProgress<DnsJob^>^ progress
)

abstract UpdatePtrRecordsAsync : 
        serviceName : string * 
        deviceResourceUri : Uri * 
        recordConfigurations : IEnumerable<DnsDomainRecordUpdateConfiguration> * 
        completionOption : AsyncCompletionOption * 
        cancellationToken : CancellationToken * 
        progress : IProgress<DnsJob> -> Task<DnsJob>

Parameters

serviceName: Type: SystemString
The name of the service which owns the cloud resource. This is obtained from Name.
deviceResourceUri: Type: SystemUri
The absolute URI of the cloud resource.
recordConfigurations: Type: System.Collections.GenericIEnumerableDnsDomainRecordUpdateConfiguration
A collection of DnsDomainRecordUpdateConfiguration objects describing the updates to apply to domain records.
completionOption: Type: net.openstack.CoreAsyncCompletionOption
Specifies when the Task representing the asynchronous server operation should be considered complete.
cancellationToken: Type: System.ThreadingCancellationToken
The CancellationToken that the task will observe.
progress: Type: SystemIProgressDnsJob
An optional callback object to receive progress notifications, if completionOption is RequestCompleted. If this is , no progress notifications are sent.

Return Value

Type: TaskDnsJob
A Task object representing the asynchronous operation. If completionOption is RequestCompleted, the job will additionally be in one of the following states.

Completed
Error: In this case the Error property provides additional information about the error which occurred during the asynchronous server operation.

Exceptions

Exception	Condition
ArgumentNullException	If serviceName is . -or- If deviceResourceUri is . -or- If recordConfigurations is .
ArgumentException	If serviceName is empty. -or- If recordConfigurations contains any values. -or- If completionOption is not a valid AsyncCompletionOption.
WebException	If the REST request does not return successfully.

Exception

Condition

ArgumentNullException

If serviceName is .

-or-

If deviceResourceUri is .

-or-

If recordConfigurations is .

ArgumentException

If serviceName is empty.

-or-

If recordConfigurations contains any values.