Click or drag to resize
IDnsServiceCloneDomainAsync Method
This API is preliminary and subject to change.
Clones a domain registered in the DNS service, optionally cloning its subdomains as well.

Namespace: net.openstack.Providers.Rackspace
Assembly: openstacknet (in openstacknet.dll) Version: 1.7.7+Branch.master.Sha.25d803f397c8693c2c13777ef6675f796f520f2c
Syntax
Task<DnsJob<DnsDomains>> CloneDomainAsync(
	DomainId domainId,
	string cloneName,
	Nullable<bool> cloneSubdomains,
	Nullable<bool> modifyRecordData,
	Nullable<bool> modifyEmailAddress,
	Nullable<bool> modifyComment,
	AsyncCompletionOption completionOption,
	CancellationToken cancellationToken,
	IProgress<DnsJob<DnsDomains>> progress
)

Parameters

domainId
Type: net.openstack.Providers.Rackspace.Objects.DnsDomainId
The domain ID. This is obtained from DnsDomain.Id.
cloneName
Type: SystemString
The name of the new (cloned) domain.
cloneSubdomains
Type: SystemNullableBoolean
to recursively clone subdomains; otherwise, to only clone the top-level domain and its records. Cloned subdomain configurations are modified the same way that cloned top-level domain configurations are modified. If this is , a provider-specific default value is used.
modifyRecordData
Type: SystemNullableBoolean
to replace occurrences of the reference domain name with the new domain name in comments on the cloned (new) domain. If this is , a provider-specific default value is used.
modifyEmailAddress
Type: SystemNullableBoolean
to replace occurrences of the reference domain name with the new domain name in email addresses on the cloned (new) domain. If this is , a provider-specific default value is used.
modifyComment
Type: SystemNullableBoolean
true to replace occurrences of the reference domain name with the new domain name in data fields (of records) on the cloned (new) domain. Does not affect NS records. If this is , a provider-specific default value is used.
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: SystemIProgressDnsJobDnsDomains
An optional callback object to receive progress notifications, if completionOption is RequestCompleted. If this is , no progress notifications are sent.

Return Value

Type: TaskDnsJobDnsDomains
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 DnsDomains object containing the details of the cloned (new) domains.
  • Error: In this case the Error property provides additional information about the error which occurred during the asynchronous server operation.
Exceptions
ExceptionCondition
ArgumentNullException If domainId is .

-or-

If cloneName is .

ArgumentException If cloneName is empty.

-or-

If completionOption is not a valid AsyncCompletionOption.

WebExceptionIf the REST request does not return successfully.
Version Information

.NET Framework

Supported in: 4.5

openstack.net

Supported in: 1.6, 1.5, 1.4
See Also