请求结构

发起 API 请求的 URL 由不同参数拼凑而成,有固定的请求结构。URL 中包含如下:

  • 服务地址

  • 通讯协议

  • 请求方法

  • 公共头参数

  • 每个 API 的特有参数

每篇 API 文档均给出了 URL 请求示例供您参考,我们并没有编码这些 URL 示例,您需要在发起请求前自行编码。如果你使用 SDK 来发起 API 请求,您只需要设置一些公共参数和 API 的具体参数,SDK 会自动会编码。

服务地址

服务入口是访问与管理用户资源的 URL。它和阿里云区域(Region)紧密相关。目前 BatchCompute 已经在多个阿里云 Region 下部署服务,各个 Region 公网服务入口分别是:

地域

服务入口

华北1 (青岛)

batchcompute.cn-qingdao.aliyuncs.com

华北2 (北京)

batchcompute.cn-beijing.aliyuncs.com

华东1 (杭州)

batchcompute.cn-hangzhou.aliyuncs.com

华东2 (上海)

batchcompute.cn-shanghai.aliyuncs.com

华北3 (张家口)

batchcompute.cn-zhangjiakou.aliyuncs.com

华北5 (呼和浩特)

batchcompute.cn-huhehaote.aliyuncs.com

华南1 (深圳)

batchcompute.cn-shenzhen.aliyuncs.com

亚太东南1 (新加坡)

batchcompute.ap-southeast-1.aliyuncs.com

美国西部1 (硅谷)

batchcompute.us-west-1.aliyuncs.com

美国东部1 (弗吉尼亚)

batchcompute.us-east-1.aliyuncs.com

欧洲中部1 (法兰克福)

batchcompute.eu-central-1.aliyuncs.com

通信协议

支持通过 HTTP / HTTPS 通道进行请求通信。

请求方法

每个 API 使用 GET、PUT、POST、DELETE 这四种方法之一,参阅各个 API 的说明。

请求参数

每个 API 都需要包含的公共请求参数和指定操作所特有的请求参数,参阅各个 API 的说明。

字符编码

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