上云无忧 > 文档中心 > 天翼云对象存储(OOS经典版)I型操作跟踪API DescribeTrails
对象存储
天翼云对象存储(OOS经典版)I型操作跟踪API DescribeTrails

文档简介:
此操作用来获取操作跟踪的设置信息。 请求参数 名称 描述 是否必填 TrailNameList 指定跟踪的名称列表。可以指定一个或多个跟踪的名称。
*产品来源:中国电信天翼云。免费试用 咨询热线:400-826-7010,为您提供专业的售前咨询,让您快速了解云产品,助您轻松上云! 微信咨询
  免费试用、价格特惠

DescribeTrails


此操作用来获取操作跟踪的设置信息。

  • 请求参数

名称

描述

是否必填

TrailNameList

指定跟踪的名称列表。可以指定一个或多个跟踪的名称。

类型:字符串。

取值3~128位字符串。

  • 可以包含ASCII字母(a-z,A-Z),数字(0-9),句点(.),下划线(_)或短划线(-);

  • 必须以字母或数字开头,以字母或数字结尾;

  • 不能是IP地址格式(例如:192.168.5.4);

  • 不能包含相邻句点(.)、下划线(_)、短划线(-)任意组合。如不能包含类似点点(..),点下划线(._)的组合。

说明:

  • 如果名称列表为空,则返回所有跟踪;

  • 如果指定的任一trail名称不存在,则不返回此trail;

  • 如果指定的所有trail名称都不存在,则返回空列表,即{"trailList":[]}。

  • 响应结果

名称

描述

Name

跟踪的名称。

S3BucketName

OOS Bucket名称。

S3KeyPrefix

跟踪日志的名称前缀。

TrailARN

跟踪的ARN。

 

  • 请求示例

获取名称为test_cloud_trail的跟踪设置信息。

POST   / HTTP/1.1

Host:oos-cn-cloudtrail.ctyunapi.cn

Authorization:signatureValue

X-Amz-Date:date

X-Amz-Target:cn.ctyunapi.oos-cn-cloudtrail.v20131101.CloudTrail_20131101.DescribeTrails

Content-Type:application/json

 

{"TrailNameList":["test_cloud_trail"]}

 

  • 返回示例

HTTP/1.1 200 OK

x-amz-request-id:570a1b70a73f4b3c

Content-Type:application/json;charset=UTF-8

Content-Length:325

Date:Fri, 19 Apr 2019 07:33:39   GMT

Server:CTYUN

 

{"trailList":[{"Name":"test_cloud_trail","S3BucketName":"test_bucket","TrailARN":"arn:ctyun:cloudtrail::10rc2arpn6306:trail/test_cloud_trail"}]}

相似文档
  • 此操作用来获取跟踪状态信息。 请求参数 名称 描述 是否必填 Name 指定跟踪的名称。 类型:字符串。 取值:3~128位字符串。 可以包含ASCII字母(a-z,A-Z),数字(0-9),句点(.),下划线(_)或短划线(-);
  • 此操作用来配置跟踪的管理事件筛选器。 默认情况下,未设置管理事件筛选器的跟踪,会记录所有的管理事件,每个跟踪最多创建1个管理事件筛选器。 请求参数 名称 描述 是否必填 TrailName 指定跟踪的名称。 类型:字符串。 取值:3~128位字符串。 可以包含ASCII字母(a-z,A-Z),数字(0-9),句点(.),下划线(_)或短划线(-); 必须以字母或数字开头,以字母或数字结尾; 不能是IP地址格式(例如:92.168.5.4);
  • 此操作用来查看管理事件筛选器的设置信息。 请求参数 名称 描述 是否必填 TrailName 跟踪的名称。 类型:字符串。 取值:3~128位字符串。 可以包含ASCII字母(a-z,A-Z),数字(0-9),句点(.),下划线(_)或短划线(-); 必须以字母或数字开头,以字母或数字结尾; 不能是IP地址格式(例如:192.168.5.4); 不能包含相邻句点(.)、下划线(_)、短划线(-)任意组合。如不能包含类似点点(..),点下划线(._)的组合。 是
  • 此操作用来更新跟踪设置参数,包括跟踪日志数据保存的OOS Bucket、跟踪日志前缀等。 说明: 更新跟踪时,无需暂停跟踪; 如果S3BucketName和S3KeyPrefix都未指定,该操作不起作用,但是不报错,返回200 OK。 请求参数 名称 描述 是否必填 Name 跟踪的名称。 类型:字符串型。 取值:3~128位字符串。
  • 此操作用来开启跟踪。 说明:使用CreateTrail创建跟踪后,跟踪默认是关闭状态,需要调用StartLogging开启跟踪。 请求参数 名称 描述 是否必填 Name 跟踪的名称。 类型:字符串。 取值:3~128位字符串。
官方微信
联系客服
400-826-7010
7x24小时客服热线
分享
  • QQ好友
  • QQ空间
  • 微信
  • 微博
返回顶部