You need to enable JavaScript to run this app.
导航
DescribeTrails - 列出跟踪列表
最近更新时间:2025.01.02 11:06:56首次发布时间:2025.01.02 11:06:56

列出跟踪列表

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

DescribeTrails

要执行的操作,取值:DescribeTrails。

Version
String

2018-01-01

API的版本,取值:2018-01-01。

TrailNames.N
Array of String

trail-test

跟踪名

IncludeOrganizationTrail
Integer

1

是否展示组织跟踪

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
Trails
Array of Object

[]

跟踪

请求示例

POST /?Action=DescribeTrails&Version=2018-01-01 HTTP/1.1
Host: volcengineapi.byted.org
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
X-Date: 20241217T023531Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241217/cn-beijing/cloud_trail/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

IncludeOrganizationTrail=1&TrailNames.1=test1

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241217103627068028081057DF7CF2",
    "Action": "DescribeTrails",
    "Version": "2018-01-01",
    "Service": "cloud_trail",
    "Region": "cn-beijing"
  },
  "Result": {
    "Trails": [
      {
        "EventRW": "All",
        "EventSources": [
          "iam"
        ],
        "TrailName": "test1",
        "LatestDeliveryError": "failed to put logs",
        "StopLoggingTime": "20241201T1000Z",
        "StartLoggingTime": "20241210T1000Z",
        "LoggingStatus": "Enable",
        "CreatorID": 2100000001,
        "OrganizationID": 70832982180,
        "TrailType": 0,
        "LatestDeliveryTime": "20241217T1100Z",
        "TosBucketRegion": "cn-beijing",
        "TosBucketName": "test-trail-1",
        "TosKeyPrefix": "",
        "TlsProjectRegion": "cn-beijing",
        "TlsProjectName": "trail-test",
        "TlsTopicName": "trail-test-1",
        "CreatedTime": "20241201T1000Z",
        "UpdatedTime": "20241217T1100Z"
      }
    ]
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
SiteDoesNotMatch
The site does not match the identity.
400
InvalidParameter
The parameter '%s' is invalid.
400
InvalidTrailName
The specified trail name '%s' is invalid.
403
AccessDenied
You have no permission for this action.
500
ServiceFailure
The requested service failed due to an unknown error.