Documentation API Docs Domain Management EnableSingleDomainService

EnableSingleDomainService

Update time: 2026-08-14 11:27:16

Applicable Products

Content Acceleration,Dynamic Web Acceleration,Media Acceleration VoD,Media Acceleration Live Broadcast

API Description

Enable an accelerated domain with a state of "disabled" and provide accelerated service with an existing configuration.

  • API URL: https://api.atomile.com/api/domain/*/enable
  • Method: PUT
  • Limit Description: When the accelerated domain name is enabled, the domain name's "enabled" state changes to "true". If the service order status for the domain name is incorrect or the domain name is in an illegal state, the interface cannot be invoked properly to enable the accelerated domain name.

Call frequency

Single user trigger frequency: 300/5min

Request parameter(s)

Path Params

NameDescription
*domainInteger
Domain name or Domain ID

Response parameter(s)

Response Header

NameDescription
x-cnc-request-idString
Uniquely identified id for querying tasks per request (for all API)

Body Params

NameDescription
codeString
Error code, which appears when HTTPStatus is not 202, represents the error type of the current request call
messageString
Response information, success when successful

Error code

Error code(code)Description(message)HTTP statusSemantic
NoSuchDomainThe specified domain name does not exist.400The specified domain name does not exist.
ForbiddenDomain name has been deleted403Domain name has been deleted
DomainNotDisabledThe domain name is enabled and cannot be enabled again.409The domain name is enabled and cannot be enabled again.
DomainCanNotEnableDomain name cannot be enabled409Domain name cannot be enabled
WRONG_OPERATORThe author cannot operate the domain name400The author cannot operate the domain name
NULL_DOMAIN_NAMENo domain name400No domain name
PARAM_INVALIDParameter {0} null or illegal400Parameter {0} null or illegal
CustomerNoOwnDomaincustomer not own domain name[{0}]400customer not own domain name[{0}]
InvalidParameterNo domain was specified.400No domain was specified.
DOMAIN_EXCEEDS_ENABLE_VALIDITY_PERIODThe domain has been disabled for a long time, and the historical configuration may not work. To avoid the risk, please delete the domain first, then recreate a new one. Domain Names:{0}400The domain has been disabled for a long time, and the historical configuration may not work. To avoid the risk, please delete the domain first, then recreate a new one. Domain Names:{0}

Example

JSON
XML
JSON
Request example
Copy Copy success
#!/bin/bash
username="example_username"
apiKey="example_apiKey"
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://{@apiDomain}/api/domain/123344/enable" \
-X "PUT" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json"
Response example
Copy Copy success
HTTP/1.1 202 Accepted
Date: Fri, 17 May 2017 06:33:26 GMT
Content-Type: application/json;charset=utf-8
x-cnc-request-id:c54cbbb4-19fe-407a-930c-3988b62ed2fd
 {"message":"success"}