Disable DynamicURL of a record

Description

Disable the DynamicURL of a given record part from the Dynamic DNS service.

Note: This function is available only for A and AAAA record types.


 Parameters

Name Data Type Status Description
auth-id or sub-auth-id or sub-auth-user Integer Required Authentication parameter
auth-password String Required Authentication parameter
domain-name String Required The name of the domain the record belongs to.
record-id Integer Required The ID of the record you want to disable the DynamicURL of. You can get the record with List records.

Returns: Array with the disabled host and the DynamicURL.


Errors

When the authenctication of API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

In case the credentials of API sub user are invalid, the following status and statusDescription will be returned:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect sub-auth-id, sub-auth-user or auth-password."}

When invalid or non-existant domain-name is entered, the following status will be returned:

{"status":"Failed","statusDescription":"Missing domain-name"}

If incorrect value is entered for record-id, the following status will be returned:.

{"status":"Failed","statusDescription":"Invalid record-id param."}

Note: These are example errors in JSON format.


 Example

URL JSON: https://api.cloudns.net/dns/disable-dynamic-url.json
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-id=1235813
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-id=1235813

URL XML: https://api.cloudns.net/dns/disable-dynamic-url.xml
POST/GET:
auth-id=0&auth-password=password&domain-name=domain.com&record-id=1235813
sub-auth-id=0&auth-password=password&domain-name=domain.com&record-id=1235813


Last modified: 2020-01-13
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more