调用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 8FFD2DE7-74F0-4582-A4CB-BF6523FEF06C

请求ID。

StartLoggingTime String 2021-03-31T04:06:41Z

用户上一次开启该跟踪的时间。

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

最后一次行为追踪异常的日志信息。

StopLoggingTime String 2021-04-02T02:36:56Z

用户上一次停止该跟踪的时间。

IsLogging Boolean false

是否开启日志记录。

LatestDeliveryTime String 1547792223000

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

示例

请求示例

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

正常返回示例

XML格式

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

<GetTrailStatusResponse>
    <RequestId>8FFD2DE7-74F0-4582-A4CB-BF6523FEF06C</RequestId>
    <StartLoggingTime>2021-03-31T04:06:41Z</StartLoggingTime>
    <LatestDeliveryError>write sls failed, exception: the parent of sub user must be project owner, itemscount: 1</LatestDeliveryError>
    <StopLoggingTime>2021-04-02T02:36:56Z</StopLoggingTime>
    <IsLogging>false</IsLogging>
</GetTrailStatusResponse>

JSON格式

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

{
  "RequestId" : "8FFD2DE7-74F0-4582-A4CB-BF6523FEF06C",
  "StartLoggingTime" : "2021-03-31T04:06:41Z",
  "LatestDeliveryError" : "write sls failed, exception: the parent of sub user must be project owner, itemscount: 1",
  "StopLoggingTime" : "2021-04-02T02:36:56Z",
  "IsLogging" : false
}

错误码

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

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