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.RackspaceAssembly: 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
)
Function CloneDomainAsync (
domainId As DomainId,
cloneName As String,
cloneSubdomains As Nullable(Of Boolean),
modifyRecordData As Nullable(Of Boolean),
modifyEmailAddress As Nullable(Of Boolean),
modifyComment As Nullable(Of Boolean),
completionOption As AsyncCompletionOption,
cancellationToken As CancellationToken,
progress As IProgress(Of DnsJob(Of DnsDomains))
) As Task(Of DnsJob(Of DnsDomains))
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
)
abstract CloneDomainAsync :
domainId : DomainId *
cloneName : string *
cloneSubdomains : Nullable<bool> *
modifyRecordData : Nullable<bool> *
modifyEmailAddress : Nullable<bool> *
modifyComment : Nullable<bool> *
completionOption : AsyncCompletionOption *
cancellationToken : CancellationToken *
progress : IProgress<DnsJob<DnsDomains>> -> Task<DnsJob<DnsDomains>>
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 Version Information .NET Framework
Supported in: 4.5
openstack.net
Supported in: 1.6, 1.5, 1.4
See Also