發起 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字元集進行編碼。