列出跟踪列表
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
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 | |
400 | InvalidParameter | |
400 | InvalidTrailName | |
403 | AccessDenied | |
500 | ServiceFailure |