IDnsService.AddRecordsAsync Method

IDnsServiceAddRecordsAsync Method

This API is preliminary and subject to change.

Adds records to a domain 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<DnsRecordsList>> AddRecordsAsync(
	DomainId domainId,
	IEnumerable<DnsDomainRecordConfiguration> recordConfigurations,
	AsyncCompletionOption completionOption,
	CancellationToken cancellationToken,
	IProgress<DnsJob<DnsRecordsList>> progress
)

Function AddRecordsAsync ( 
	domainId As DomainId,
	recordConfigurations As IEnumerable(Of DnsDomainRecordConfiguration),
	completionOption As AsyncCompletionOption,
	cancellationToken As CancellationToken,
	progress As IProgress(Of DnsJob(Of DnsRecordsList))
) As Task(Of DnsJob(Of DnsRecordsList))

Task<DnsJob<DnsRecordsList^>^>^ AddRecordsAsync(
	DomainId^ domainId, 
	IEnumerable<DnsDomainRecordConfiguration^>^ recordConfigurations, 
	AsyncCompletionOption completionOption, 
	CancellationToken cancellationToken, 
	IProgress<DnsJob<DnsRecordsList^>^>^ progress
)

abstract AddRecordsAsync : 
        domainId : DomainId * 
        recordConfigurations : IEnumerable<DnsDomainRecordConfiguration> * 
        completionOption : AsyncCompletionOption * 
        cancellationToken : CancellationToken * 
        progress : IProgress<DnsJob<DnsRecordsList>> -> Task<DnsJob<DnsRecordsList>>

Parameters

domainId: Type: net.openstack.Providers.Rackspace.Objects.DnsDomainId
The domain ID. This is obtained from DnsDomain.Id.
recordConfigurations: Type: System.Collections.GenericIEnumerableDnsDomainRecordConfiguration
A collection of DnsDomainRecordConfiguration objects describing the records to add.
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: SystemIProgressDnsJobDnsRecordsList
An optional callback object to receive progress notifications, if completionOption is RequestCompleted. If this is , no progress notifications are sent.

Return Value

Type: TaskDnsJobDnsRecordsList
A Task object representing the asynchronous operation. When the task completes successfully, the Result property will return a DnsJobTResponse object describing the asynchronous server operation. If completionOption is RequestCompleted, the job will additionally be in one of the following states.

Completed: In this case the Response property contains a DnsRecordsList object containing the details of the added records.
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 domainId is . -or- If recordConfigurations is .
ArgumentException	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 domainId is .

-or-

If recordConfigurations is .

ArgumentException

If recordConfigurations contains any values.

-or-

If completionOption is not a valid AsyncCompletionOption.

WebException

If the REST request does not return successfully.