阿里云E-MapReduce-API手册-D_可编辑.docxVIP

E-MapReduce

OpenAPI

E-MapReduce/OpenAPI

E-MapReduce/OpenAPI

PAGE10

PAGE10

OpenAPI

调用说明

#请求结构

服务地址

通信协议

支持通过HTTP或HTTPS通道进行请求通信。为了获得更高的安全性，推荐您使用HTTPS通道发送请求。

请求方法

支持HTTPGET方法发送请求，这种方式下请求参数需要包含在请求的URL中。

请求参数

每个请求都需要指定要执行的操作，即Action参数（例如CreateDatabase），以及每个操作都需要包含的公共请求参数和指定操作所特有的请求参数。

字符编码

请求及返回结果都使用UTF-8字符集进行编码。

#公共参数

公共请求参数

公共请求参数是指每个接口都需要使用到的请求参数。

参数列表

名称

类型

是否必须

描述

Format

String

否

返回值的类型，支持JSON与XML。默认为XML

Version

String

是

API版本号，为日期形式：YYYY-MM-

DD，本版本对应为2014-08-15

AccessKeyId

String

是

阿里云颁发给用户的访问服务所用的密钥ID

Signature

String

是

签名结果串，关于签名的计算方法，请参见签名机制。

SignatureMethod

string

是

签名方式，目前支持HMAC-SHA1

Timestamp

String

是

请求的时间戳。日期格式按照ISO8601标准表示，并需要使用UTC时间。格式为

：YYYY-MM-

DDThh:mm:ssZ;例如

，2013-08-15T12:00:00Z（为北

京时间2013年8月15日20点0分0秒）

SignatureVersion

String

是

签名算法版本，目前版本是1.0

SignatureNonce

String

是

唯一随机数，用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值

/?Format=json

/

?Format=jsonVersion=2016-01-10

Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3DSignatureMethod=HMAC-SHA1SignatureNonce=15215528852396SignatureVersion=1.0

AccessKeyId=key-testOwnerIdTimestamp=2014-10-10T12:00:00Z

Timestamp=2014-10-10T12:00:00Z

公共返回参数

用户发送的每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码RequestId给用户。

示例

成功结果

{RequestId:4C467B38-3910-447D-87BC-AC049166F216,/*

{

RequestId:4C467B38-3910-447D-87BC-AC049166F216,

/*返回结果数据*/

}

错误结果

调用接口出错后，将不会返回结果数据。调用方可根据附表错误代码表来定位错误原因。当调用出错时

{RequestId:7463B73D-35CC-4D19-A010-6B8D65D242EF,HostId:,Code:UnsupportedOperation,Message:Thespecifiedactionisnotsupported.}，HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。另外还包含一个全局唯一的请求ID：RequestId和一个您该次请求访问的站点ID：HostId。在调用方找不到错误原因，可以

{

RequestId:7463B73D-35CC-4D19-A010-6B8D65D242EF,

HostId:,Code:UnsupportedOperation,

Message:Thespecifiedactionisnotsupported.

}

公共错误码

参考ECS公共错误码

#签名机制

ECS服务会对每个访问的请求进行身份验证，所以无论使用HTTP还是HTTPS协议提交请求，都需要在请求中包含签名（Signature）信息。ECS通过使用AccessKeyID和AccessKeySecret进行对称加密的方法来验证请求的发送者身份。AccessKeyID和AccessKeySecret由阿里云官方颁发给访问者（可以通过阿里云官方网站申请和管理），其中AccessKeyID用于标识访问者的身份；AccessK