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

请求参数

名称
描述
是否必须
TrailNameList
指定跟踪的名称列表。可以指定一个或多个跟踪的名称。
类型：字符串
取值：3~128个字符：
可以包含ASCII字母（a-z，A-Z），数字（0-9），句点（.），下划线（_）或短划线（-）。
必须以字母或数字开头，以字母或数字结尾。
不能是IP地址格式（例如：192.168.5.4）。
不能包含相邻句点（.）、下划线（_）、短划线（-）任意组合。如不能包含类似点点（..）,点下划线（._）的组合。
说明
如果名称列表为空{"TrailNameList":[]}，则返回所有跟踪。
如果指定的任一trail名称不存在，则不返回此trail。
如果指定的所有trail名称都不存在，则返回空列表，即{"trailList":[]}。
否

响应结果

请求示例

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

POST / HTTP/1.1
Authorization: signatureValue
x-amz-date: 20260514T072909Z
x-amz-content-sha256: UNSIGNED-PAYLOAD
X-Amz-Target: cn.ctyunapi.oos-cn-cloudtrail.v20131101.CloudTrail_20131101.DescribeTrails
Content-Type: application/json
Content-Length: 99 
Host: oos-cn-cloudtrail.ctyunapi.cn

{
    "TrailNameList": [
        "test_cloud_trail",
        "test1",
        "test2"
    ]
}

响应示例

HTTP/1.1 200 OK
x-amz-request-id: 4cda730e201549bf
Content-Type: application/json;charset=UTF-8
Content-Length: 414
Date: Thu, 14 May 2026 07:29:09 GMT
Server: CTYUN

{
    "trailList": [
        {
            "S3KeyPrefix": "auditlog",
            "S3BucketName": "example-bucket",
            "Name": "test_cloud_trail",
            "TrailARN": "arn:ctyun:cloudtrail::32fefj64y54gc:trail/test_cloud_trail"
        },
        {
            "S3BucketName": "example-bucket",
            "Name": "test1",
            "TrailARN": "arn:ctyun:cloudtrail::32fefj64y54gc:trail/test1"
        },
        {
            "S3KeyPrefix": "test2",
            "S3BucketName": "example-bucket",
            "Name": "test2",
            "TrailARN": "arn:ctyun:cloudtrail::32fefj64y54gc:trail/test2"
        }
    ]
}