调用GetTrailStatus接口查询跟踪的状态。

本文将提供一个示例,为您查询单账号跟踪trail-test的状态。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetTrailStatus

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

Name String trail-test

跟踪名称。

长度为6~36个字符,必须以英文字母开头,可包含英文字母、数字、短划线(-)和下划线(_)。

说明 同一账号内跟踪名称不可重复。
IsOrganizationTrail Boolean false

是否查询多账号跟踪状态,取值:

  • true:查询多账号跟踪状态。
  • false(默认值):查单账号跟踪状态。

关于公共请求参数的详情,请参见公共参数

返回数据

名称 类型 示例值 描述
RequestId String 8067369B-B923-4D26-85BC-61BF33922505

请求ID。

StartLoggingTime String 2021-02-24T09:19:44Z

最近一次开启跟踪的时间。

LatestDeliveryError String write sls failed, exception: the parent of sub user must be project owner, itemscount: 1

最近一次行为跟踪异常的日志信息。

StopLoggingTime String 2021-02-25T09:19:44Z

最近一次停止跟踪的时间。

IsLogging Boolean true

是否开启日志记录,取值:

  • true:开启。
  • false:关闭。
LatestDeliveryTime String 2021-02-26T09:19:44Z

最近一次成功记录行为的时间。

LatestDeliveryLogServiceError String write sls failed, exception: the parent of sub user must be project owner, itemscount: 1

最近一次投递日志服务的错误信息。

LatestDeliveryLogServiceTime String 2021-02-26T09:19:44Z

最近一次成功投递日志服务的时间。

OssBucketStatus Boolean true

OSS Bucket是否可用,取值:

  • true:可用。
  • false:不可用。
SlsLogStoreStatus Boolean true

SLS Logstore是否可用,取值:

  • true:可用。
  • false:不可用。

示例

请求示例

http(s)://[Endpoint]/?Action=GetTrailStatus
&Name=trail-test
&IsOrganizationTrail=false
&公共请求参数

正常返回示例

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7FA636C6-AEE2-4827-A398-F08F708B9A3D",
  "StartLoggingTime" : "2021-02-24T09:19:44Z",
  "OssBucketStatus" : false,
  "SlsLogStoreStatus" : true,
  "IsLogging" : true
}

错误码

HttpCode 错误码 错误信息 描述
404 TrailNotFoundException The specified Trail does not exist. 指定的跟踪不存在。

访问错误中心查看更多错误码。