This topic describes the request parameters, response parameters, and common error
codes that are required for all API operations of Dedicated Host (DDH).
Common request parameters
key-test
The AccessKey ID provided to you by Alibaba Cloud. AccessKey pairs are used to call
API operations. Usernames and passwords are used to log on to the Elastic Compute
Service (ECS) console.
For more information, see
Obtain an AccessKey pair
.
15215528852396
A unique, random number used to prevent replay attacks. You must use different numbers
for different requests.
Timestamp
String
2018-01-01T12:00:00Z
The timestamp of the request.
Specify the time in the
ISO 8601
standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
The timestamp of the request, for example,
2018-01-01T12:00:00Z
.
2014-05-26
The version number of the API. The value must be in the YYYY-MM-DD format. Set the
value to 2014-05-26.
Format
String
The format in which to return the response. Valid values: json and xml.
Default value: xml.
Sample requests:
https://ecs.aliyuncs.com/?Action=AllocateDedicatedHosts
&Format=xml
&Version=2014-05-26
&Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&AccessKeyId=key-test
&Timestamp=2018-01-01T12:00:00Z
Common response parameters
Responses can be returned in either the JSON or XML format. You can specify the response
format in the request. The default response format is XML. Every response returns
a unique
RequestID regardless of whether the call is successful.
A 2xx status code indicates a successful call.
A 4xx or 5xx status code indicates a failed call.
Sample responses
XML format <?xml version="1.0" encoding="utf-8"?>
<!--Result Root Node-->
<Interface Name+Response>
<!--Return Request Tag-->
<RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
<!--Return Result Data-->
<Interface Name+Response>
JSON format {
"RequestId":"4C467B38-3910-447D-87BC-AC049166F216"
/*Return Result Data*/
IllegalTimestamp
The input parameter "Timestamp" that is mandatory for processing this request is not
supplied.
IncompleteSignature
The request signature does not conform to Aliyun standards.
InsufficientBalance
Your account does not have enough balance.
InvalidAccessKeyId.NotFound
The specified Access Key ID does not exist.
InvalidOwner
OwnerId and OwnerAccount can't be used at one API access.
InvalidOwnerAccount
The specified OwnerAccount is not valid.
InvalidOwnerId
The specified OwnerId is not valid.
InvalidParamater
The specified parameter "SignatureMethod" is not valid.
InvalidParamater
The specified parameter "SignatureVersion" is not valid.
InvalidParameter
The specified parameter is not valid.
InvalidParameter
The specified parameter "Action or Version" is not valid.
InvalidParameter.IsNull
The required parameter must be not null.
MissingParameter
The input parameter "Action" that is mandatory for processing this request is not
supplied.
MissingParameter
The input parameter "AccessKeyId" that is mandatory for processing this request is
not supplied.
MissingParameter
The input parameter "Signature" that is mandatory for processing the request is not
supplied.
MissingParameter
The input parameter "TimeStamp" that is mandatory for processing this request is not
supplied.
MissingParameter
The input parameter "Version" that is mandatory for processing this request is not
supplied.
SignatureNonceUsed
The request signature nonce has been used.
Throttling
You have made too many requests within a short time; your request is denied due to
request throttling.
UnsupportedParameter
The parameters is unsupported.
UnknownError
The request processing has failed due to some unknown error.
ChargeTypeViolation
The operation is not permitted due to charge type of the instance.
Forbidden.AccessKeyDisabled
The Access Key is disabled.
Forbidden.NotSupportRAM
This action does not support accessed by RAM mode.
Forbidden.RAM
User not authorized to operate on the specified resource, or this API doesn't support
Forbidden.RiskControl
This operation is forbidden by Aliyun RiskControl system.
Forbidden.SubUser
The specified action is not available for you.
Forbidden.Unauthorized
User not authorized to operate on the specified resource.
InvalidAccount.NotFound
The specified Account does not exist.
InvalidAction
Specified action is not valid.
InvalidIdempotenceParameter.Mismatch
The specified parameters are different from before.
InvalidParameter.OwnerAccount
OwnerAccount is Invalid.
InvalidParameter.ResourceOwnerAccount
ResourceOwnerAccount is Invalid.
LastTokenProcessing
The last token request is processing.
MissingParameter
The input parameter OwnerId,OwnerAccount that is mandatory for processing this request
is not supplied.
RealNameAuthenticationError
Your account has not passed the real-name authentication yet.
UnsupportedHTTPMethod
This http method is not supported.
InvalidDiskId.NotFound
The specified DiskId does not exist.
InvalidImageId.NotFound
The specified ImageId does not exist.
InvalidInstanceId.NotFound
The specified InstanceId does not exist.
InvalidRegionId.NotFound
The specified RegionId does not exist.
InvalidSecurityGroupId.NotFound
The specified SecurityGroupId does not exist.
InvalidSnapshotId.NotFound
The specified SnapshotId does not exist.
OperationConflict
Request was denied due to conflict with a previous request.
InternalError
The request processing has failed due to some unknown error, exception or failure.
ServiceUnavailable
The request has failed due to a temporary failure of the server.
ServiceUnavailable.RegionMaintaining
System maintenance is in progress on the selected region, please wait a few minutes
before trying again.
