全部产品
阿里云办公

请求结构

更新时间:2018-11-05 11:24:05

发起 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字符集进行编码。