阿里云-操作审计API参考手册-D

《阿里云-操作审计API参考手册-D》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、操作审计API参考手册操作审计/API参考手册API参考手册简介欢迎使用阿里云ActionTrail产品/服务。用户可以使用本文档介绍的API对ActionTrail服务进行相关操作。请确保在使用这些接口前，已充分了解了ActionTrail产品说明、使用协议。术语表术语中文说明Account账户这里是指主账户，有时称为root-accountRAM-UserRAM用户这里是指RAM中的一个用户AK(AccessKey)访问密钥访问密钥由AccessKeyID和AccessKeySecret组成，用于云服务API请

2、求的身份认证Event操作事件用户通过阿里云控制台或SDK发起的API操作都可能触发一个事件业务限制资源规格限制说明字段说明Name长度大于等于6并且小于36，首字符为大小写字符，剩余字符可为大小写字母、数字、-以及_OssBucketName只能包括小写字母，数字，短横线（-），必须以小写字母或者数字开头，长度必须在3-63字节之间。从OSSBUCEKT命名规范同步过来OssKeyPrefix长度大于等于6并且小于32，首字符为大小写字符，剩余字符可为大小写字母、数字、-、/以及_在接口说明部分，凡出现对参数可选

3、值、可用规格方面与官网上给出的资源规格限制发生矛盾时，均以官网上给出的值为准。22操作审计/API参考手册API概览实例相关接口API描述CreateTrail创建TrailDescribeTrails检索TrailGetTrailStatus查询Trail状态StartLogging开启TrailStopLogging关闭TrailUpdateTrail更新TrailDeleteTrail删除Trail调用方式调用方式对API接口调用是通过向API的服务端地址发送HTTPGET请求，并按照接口说明在请求中加入相应

4、请求参数来完成的；根据请求的处理情况，系统会返回处理结果。1.请求结构2.公共参数3.返回结果4.签名机制请求结构服务地址ActionTrail的控制台接入地址为：actiontrail.console.aliyun.com22邮件推送/API参考手册ActionTrailAPI的接入地址为：actiontrail.[Region].aliyuncs.com，其中[Region]为所属region，当前仅支持cn-hangzhou通信协议支持通过HTTP或HTTPS通道进行请求通信。为了获得更高的安全性，推荐您使用

5、HTTPS通道发送请求。请求方法支持HTTPGET方法发送请求，这种方式下请求参数需要包含在请求的URL中。请求参数每个请求都需要指定要执行的操作，即Action参数（例如CreateTrail），以及每个操作都需要包含的公共请求参数和指定操作所特有的请求参数。字符编码请求及返回结果都使用UTF-8字符集进行编码。公共参数公共请求参数公共请求参数是指每个接口都需要使用到的请求参数。名称类型是否必须描述FormatString否返回值的类型，当前仅仅支持JSONVersionString是API版本号，为日期形式：Y

6、YYY-MM-DD，本版本对应为2015-09-28AccessKeyIdString是阿里云颁发给用户的访问服务所用的密钥IDSignatureString是签名结果串，关于签名的计算方法，请参见签名机制SignatureMethodString是签名方式，目前支持HMAC-SHA122Eclipse插件/最佳实践TimestampString是请求的时间戳。日期格式按照ISO8601标准表示，并需要使用UTC时间。格式为YYYY-MM-DDThh:mm:ssZ例如，2014-05-26T12:00:00Z（为北

7、京时间2013年1月10日20点0分0秒）SignatureVersionString是签名算法版本，目前版本是1.0SignatureNonceString是唯一随机数，用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值http://actiontrail.cn-hangzhou.aliyuncs.com/actiontrail?SignatureVersion=1.0&OssBucketName=yuanchuang&Name=CreateTest&Format=JSON&Timestamp=2015-

8、12-01T07%3A04%3A33Z&Signature=iyEsE7vgGUWop7Term5HM48wzJU%3D&AccessKeyId=QzW2ySCTkbq9C21M&SignatureMethod=HMAC-SHA1&Version=2015-09-28&RoleName=aliyunactiontraildefaultrole&Action=