本文列举了容器服务Kubernetes版的API的公共请求参数和公共返回参数信息。
公共请求参数
公共请求参数是用于标识目标API、用户身份、签名等通用信息的参数,每次发起API请求时均需要携带这些参数。
公共请求参数应作为HTTP请求的消息头(header)携带在请求中,具体取值如下:
名称 | 是否必须 | 描述 |
x-acs-action | 是 | API的名称。关于取值,请参见API概览。 |
x-acs-version | 是 | API版本,格式为YYYY-MM-DD。示例:2018-01-01。 |
x-acs-signature-nonce | 否 | 唯一随机数,用于防止网络重放攻击。您在不同请求间要使用不同的随机数值。 |
x-acs-signature-method | 非匿名请求必须 | 签名方式,目前支持: HMAC-SHA1。 |
Authorization | 非匿名请求必须 | 用于验证请求合法性的认证信息,格式为acs AccessKeyId:Signature :
|
Date | 是 | HTTP 1.1协议中规定的GMT 时间,例如:Tue 9 Apr 2019 07:35:29 GMT。 |
Accept | 否 | 客户端需要的返回值类型,取值范围:application/json(推荐)application/xml(默认值)。 |
Content-MD5 | 否 | HTTP请求正文的128-bit MD5散列值转换成BASE64编码的结果。 |
请求示例
说明 以下请求示例中携带在请求URL中的请求参数为了便于展示未进行编码,在实际发送请求时,URL中的请求参数必须经过URL编码。
- 请求示例-GET
GET https://demo-product.aliyuncs.com/path?foo1=bar1&foo2=bar2 HTTP/1.1 Authorization: acs DemoAccessKey:31nTIpResD/0C8gb+ChUeuvsxlw= Host: demo-product.aliyuncs.com Date: Thu, 17 Nov 2018 18:49:58 GMT Accept: application/json x-acs-action: demoAction x-acs-version: 2018-01-01 x-acs-signature-nonce: 51284580-614a-11eb-8a9b-9dcfec8d61b7 x-acs-signature-method: HMAC-SHA1
- 请求示例-POST(application/json)
POST https://demo-product.aliyuncs.com/path?foo=bar HTTP/1.1 Authorization: acs DemoAccessKey:31nTIpResD/0C8gb+ChUeuvsxlw= Host: demo-product.aliyuncs.com Date: Thu, 17 Nov 2018 18:49:58 GMT Accept: application/json Content-Type: application/json; charset=utf-8 Content-Length: 135 Content-MD5: MACiECZtnLiNkNS1v5ZCAA=1 x-acs-action: demoAction x-acs-version: 2018-01-01 x-acs-signature-nonce: 51284580-614a-11eb-8a9b-9dcfec8d61b7 x-acs-signature-method: HMAC-SHA1 {"demoKey":"demoValue", ... }
公共返回参数
每次接口调用请求,无论成功与否,系统都会返回一个唯一识别码RequestId。调用API服务后返回数据采用统一格式。返回的HTTP状态码为2xx
,代表调用成功;返回的HTTP状态码为4xx
或5xx
,代表调用失败。
XML示例
|
| 4C467B38-3910-447D-87BC-AC049166F216
|
JSON示例
{
"RequestId": "4C467B38-3910-447D-87BC-AC049166F216"
/* 返回结果数据 */
}
内容没看懂? 不太想学习?想快速解决? 有偿解决: 联系专家
阿里云企业补贴进行中: 马上申请
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利:同意关联,立享优惠
转转请注明出处:https://www.yunxiaoer.com/171553.html