接入地址
对象存储网络:oos-cn-cloudtrail.ctyunapi.cn,对象存储网络2:oos-cn2-cloudtrail.ctyunapi.cn,香港精品网和香港普通网:oos-cnhk-cloudtrail.ctyunapi.cn。
通信协议
为了保证通信的安全性,操作跟踪仅支持HTTPS。
HTTP请求方法
操作跟踪支持HTTP POST请求方法发送请求。
请求参数
每个请求都需要指定如下信息:
- 每个操作接口都需要包含的公共请求参数。
- 操作接口所特有的请求参数。
本节主要描述公共请求参数和请求结果。
说明在后续提到具体操作跟踪API时,举例中都会有公共请求头 、 公共响应头 ,但是不对其进行描述和解释。
公共请求头
在每个请求中,都需要携带公共参数和对应的接口参数。公共请求参数如表所示:
名称 描述 是否必须 Host 操作跟踪访问域名。
对象存储网络:oos-cn-cloudtrail.ctyunapi.cn。
对象存储网络2:oos-cn2-cloudtrail.ctyunapi.cn。
香港精品网和香港普通网:oos-cnhk-cloudtrail.ctyunapi.cn。
是 Authorization V4请求头签名。
类型:字符串
是 X-Amz-Date 日期和时间格式必须遵循ISO 8601标准,并且必须使用“yyyyMMddT HHmmssZ”格式进行格式化。例如,如果日期和时间是“08/01/2018 15:32:41.982-700”,则必须首先将其转换为UTC(协调世界时),然后提交为“20180801T083241Z”。 是 X-Amz-Target 操作跟踪请求目标,格式为cn.ctyunapi.oos-cn-cloudtrail.v20131101.CloudTrail_20131101.Target。
例如创建操作跟踪的请求为:
X-Amz-Target:cn.ctyunapi.oos-cn-cloudtrail.v20131101.CloudTrail_20131101.CreateTrail
是 Content-Type 请求内容类型。
类型:字符串
取值:application/json。
是 Connection 客户端与OOS服务器之间的连接状态。
取值:
keep-alive:长连接,请求结束后继续保持连接。
close:短连接,请求结束后关闭连接。
默认值为:keep-alive。
否
公共响应头
每个操作跟踪API响应结果中都会包含公共响应头。
名称 描述 x-amz-request-id 服务端生成的用于标识请求的ID。 Content-Type 响应内容类型。 Date 响应日期。 Server 服务器名。 Connection 客户端与OOS服务器之间的连接状态。
如果请求时Connection值为keep-alive,请求结束后继续保持连接,不返回此响应头。
如果请求时Connection值为close,请求结束后关闭连接,返回此响应头Connection: close。