On this page

Function
Calling Method
URI
Request Parameters
Response Parameters
Example Requests
Example Responses
SDK Sample Code
Status Codes
Error Codes

Show all

Help Center/ Log Tank Service/ API Reference/ APIs/ Log Management/ Querying Structured Logs (Log Analysis)

Querying Structured Logs (Log Analysis)

Updated on 2025-04-30 GMT+08:00

Online Debugging

CLI Examples

View PDF

Function

This API is used to use SQL statements to query structured logs in a specified log stream (Log Analysis tab page).

NOTE:

For details about the regions that support the query function on the Log Analysis tab page, see section "Log Visualization" in the User Guide. The number of data aggregation results does not exceed 10 billion. Only data generated in the last 30 days can be analyzed using SQL statements.

Calling Method

For details, see Calling APIs.

URI

POST /v2/{project_id}/streams/{log_stream_id}/struct-content/query

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Parameter description: Project ID. For details about how to obtain it, see Obtaining the Project ID, Account ID, Log Group ID, and Log Stream ID. Constraints: N/A. Value range: N/A. Default value: N/A.
log_stream_id	Yes	String	Parameter description: Log stream ID. For details about how to obtain it, see Obtaining the Project ID, Account ID, Log Group ID, and Log Stream ID. Constraints: N/A. Value range: N/A. Default value: N/A.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Parameter description: User token obtained from IAM. For details about how to obtain it, see Obtaining a User Token. Constraints: N/A. Value range: N/A. Default value: N/A.
Content-Type	Yes	String	Parameter description: Set this parameter to application/json;charset=UTF-8. Constraints: N/A. Value range: N/A. Default value: N/A.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
query	Yes	String	Parameter description: SQL statement. Constraints: N/A. Value range: N/A. Default value: N/A.
format	Yes	String	Parameter description: Query result format. Constraints: N/A. Value range: N/A. Default value: The value must be k-v and defaults to k-v.
time_range	Yes	TimeRange object	Parameter description: Query time range. Constraints: The end time must be later than the start time. The maximum time range is 30 days. If you specify a time range that exceeds the log retention period set for the log stream, the intersection of the time range and the log retention period is queried by default. Value range: N/A. Default value: N/A.
whether_to_rows	No	Boolean	Parameter description: Whether the returned data is in the line format. Constraints: N/A. Value range: N/A. Default value: false

**Table 4** TimeRange
Parameter	Mandatory	Type	Description
sql_time_zone	No	String	Parameter description: Time zone. Constraints: N/A. Value range: You can specify a time zone in the following formats: -0800, -08:00, America/Los_Angeles, or UTC. Default value: UTC
start_time	Yes	Long	Parameter description: UTC start time of the search window (in milliseconds). Constraints: N/A. Value range: The value must be greater than 0. If the value is less than the log stream's minimum log retention period, the value will be set to that minimum log retention period by default. Default value: N/A.
end_time	Yes	Long	Parameter description: UTC end time of the search window (in milliseconds). Constraints: N/A. Value range: Greater than 0 Default value: N/A.
start_time_gt	No	Boolean	Parameter description: Whether the start time is included in the search window. Constraints: N/A. Value range: N/A. Default value: false
end_time_lt	No	Boolean	Parameter description: Whether the end time is included in the search window. Constraints: N/A. Value range: N/A. Default value: false

Response Parameters

Status code: 200

The request is successful.

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Parameter description: Error code. Value range: N/A.
error_msg	String	Parameter description: Error message. Value range: N/A.

Status code: 500

**Table 6** Response body parameters
Parameter	Type	Description
error_code	String	Parameter description: Error code. Value range: N/A.
error_msg	String	Parameter description: Error message. Value range: N/A.

Example Requests

When query is set to select *:

POST https://{endpoint}/v2/{project_id}/streams/{log_stream_id}/struct-content/query

{
  "query" : "select *",
  "format" : "k-v",
  "time_range" : {
    "sql_time_zone" : "UTC",
    "start_time" : 1613806109000,
    "end_time" : 1613806110000,
    "start_time_gt" : false,
    "end_time_lt" : false
  }
}

When query is set to select count(test3) as mycount, sum(test4) as mysum:

POST https://{endpoint}/v2/{project_id}/streams/{log_stream_id}/struct-content/query

{
  "query" : "select count(test3) as mycount, sum(test4) as mysum",
  "format" : "k-v",
  "time_range" : {
    "sql_time_zone" : "UTC",
    "start_time" : 1613806109000,
    "end_time" : 1613806110000,
    "start_time_gt" : false,
    "end_time_lt" : false
  }
}

When query is set to select count(test3), sum(test4) group by(test1):

POST https://{endpoint}/v2/{project_id}/streams/{log_stream_id}/struct-content/query

{
  "query" : "select count(test3), sum(test4) group by(test1)",
  "format" : "k-v",
  "time_range" : {
    "sql_time_zone" : "UTC",
    "start_time" : 1613806109000,
    "end_time" : 1613806110000,
    "start_time_gt" : false,
    "end_time_lt" : false
  }
}

When whether_to_rows is set to true:

POST https://{endpoint}/v2/{project_id}/streams/{log_stream_id}/struct-content/query

{
  "query" : "select count(test3), sum(test4) group by(test1)",
  "format" : "k-v",
  "time_range" : {
    "sql_time_zone" : "UTC",
    "start_time" : 1613806109000,
    "end_time" : 1613806110000,
    "start_time_gt" : false,
    "end_time_lt" : false
  },
  "whether_to_rows" : true
}

Example Responses

Status code: 200

The request is successful.

{
  "pv" : [ 90 ]
}

Status code: 400

Invalid request. Modify the request based on the description in error_msg before a retry.

{
  "error_code" : "LTS.2022",
  "error_msg" : "Column 'aa' not found in any table"
}

Status code: 500

The server has received the request but encountered an internal error.

{
  "error_code" : "LTS.0010",
  "error_msg" : "Internal Server Error"
}

SDK Sample Code

The SDK sample code is as follows.

Java
Python
Go
More

When query is set to select *:

        
         
           
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.lts.v2.region.LtsRegion;
import com.huaweicloud.sdk.lts.v2.*;
import com.huaweicloud.sdk.lts.v2.model.*;


public class ListStructuredLogsWithTimeRangeSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        LtsClient client = LtsClient.newBuilder()
                .withCredential(auth)
                .withRegion(LtsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListStructuredLogsWithTimeRangeRequest request = new ListStructuredLogsWithTimeRangeRequest();
        request.withLogStreamId("{log_stream_id}");
        QueryLtsStructLogParamsNew body = new QueryLtsStructLogParamsNew();
        TimeRange timeRangebody = new TimeRange();
        timeRangebody.withSqlTimeZone("UTC")
            .withStartTime(1613806109000L)
            .withEndTime(1613806110000L)
            .withStartTimeGt(false)
            .withEndTimeLt(false);
        body.withTimeRange(timeRangebody);
        body.withFormat("k-v");
        body.withQuery("select *");
        request.withBody(body);
        try {
            ListStructuredLogsWithTimeRangeResponse response = client.listStructuredLogsWithTimeRange(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        
       

When query is set to select count(test3) as mycount, sum(test4) as mysum:

        
         
           
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.lts.v2.region.LtsRegion;
import com.huaweicloud.sdk.lts.v2.*;
import com.huaweicloud.sdk.lts.v2.model.*;


public class ListStructuredLogsWithTimeRangeSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        LtsClient client = LtsClient.newBuilder()
                .withCredential(auth)
                .withRegion(LtsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListStructuredLogsWithTimeRangeRequest request = new ListStructuredLogsWithTimeRangeRequest();
        request.withLogStreamId("{log_stream_id}");
        QueryLtsStructLogParamsNew body = new QueryLtsStructLogParamsNew();
        TimeRange timeRangebody = new TimeRange();
        timeRangebody.withSqlTimeZone("UTC")
            .withStartTime(1613806109000L)
            .withEndTime(1613806110000L)
            .withStartTimeGt(false)
            .withEndTimeLt(false);
        body.withTimeRange(timeRangebody);
        body.withFormat("k-v");
        body.withQuery("select count(test3) as mycount, sum(test4) as mysum");
        request.withBody(body);
        try {
            ListStructuredLogsWithTimeRangeResponse response = client.listStructuredLogsWithTimeRange(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        
       

When query is set to select count(test3), sum(test4) group by(test1):

        
         
           
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.lts.v2.region.LtsRegion;
import com.huaweicloud.sdk.lts.v2.*;
import com.huaweicloud.sdk.lts.v2.model.*;


public class ListStructuredLogsWithTimeRangeSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        LtsClient client = LtsClient.newBuilder()
                .withCredential(auth)
                .withRegion(LtsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListStructuredLogsWithTimeRangeRequest request = new ListStructuredLogsWithTimeRangeRequest();
        request.withLogStreamId("{log_stream_id}");
        QueryLtsStructLogParamsNew body = new QueryLtsStructLogParamsNew();
        TimeRange timeRangebody = new TimeRange();
        timeRangebody.withSqlTimeZone("UTC")
            .withStartTime(1613806109000L)
            .withEndTime(1613806110000L)
            .withStartTimeGt(false)
            .withEndTimeLt(false);
        body.withTimeRange(timeRangebody);
        body.withFormat("k-v");
        body.withQuery("select count(test3), sum(test4) group by(test1)");
        request.withBody(body);
        try {
            ListStructuredLogsWithTimeRangeResponse response = client.listStructuredLogsWithTimeRange(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        
       

When whether_to_rows is set to true:

        
         
           
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.lts.v2.region.LtsRegion;
import com.huaweicloud.sdk.lts.v2.*;
import com.huaweicloud.sdk.lts.v2.model.*;


public class ListStructuredLogsWithTimeRangeSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        LtsClient client = LtsClient.newBuilder()
                .withCredential(auth)
                .withRegion(LtsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListStructuredLogsWithTimeRangeRequest request = new ListStructuredLogsWithTimeRangeRequest();
        request.withLogStreamId("{log_stream_id}");
        QueryLtsStructLogParamsNew body = new QueryLtsStructLogParamsNew();
        TimeRange timeRangebody = new TimeRange();
        timeRangebody.withSqlTimeZone("UTC")
            .withStartTime(1613806109000L)
            .withEndTime(1613806110000L)
            .withStartTimeGt(false)
            .withEndTimeLt(false);
        body.withWhetherToRows(true);
        body.withTimeRange(timeRangebody);
        body.withFormat("k-v");
        body.withQuery("select count(test3), sum(test4) group by(test1)");
        request.withBody(body);
        try {
            ListStructuredLogsWithTimeRangeResponse response = client.listStructuredLogsWithTimeRange(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        
       

When query is set to select *:

        
         
           
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdklts.v2.region.lts_region import LtsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdklts.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = LtsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(LtsRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListStructuredLogsWithTimeRangeRequest()
        request.log_stream_id = "{log_stream_id}"
        timeRangebody = TimeRange(
            sql_time_zone="UTC",
            start_time=1613806109000,
            end_time=1613806110000,
            start_time_gt=False,
            end_time_lt=False
        )
        request.body = QueryLtsStructLogParamsNew(
            time_range=timeRangebody,
            format="k-v",
            query="select *"
        )
        response = client.list_structured_logs_with_time_range(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        
       

When query is set to select count(test3) as mycount, sum(test4) as mysum:

        
         
           
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdklts.v2.region.lts_region import LtsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdklts.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = LtsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(LtsRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListStructuredLogsWithTimeRangeRequest()
        request.log_stream_id = "{log_stream_id}"
        timeRangebody = TimeRange(
            sql_time_zone="UTC",
            start_time=1613806109000,
            end_time=1613806110000,
            start_time_gt=False,
            end_time_lt=False
        )
        request.body = QueryLtsStructLogParamsNew(
            time_range=timeRangebody,
            format="k-v",
            query="select count(test3) as mycount, sum(test4) as mysum"
        )
        response = client.list_structured_logs_with_time_range(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        
       

When query is set to select count(test3), sum(test4) group by(test1):

        
         
           
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdklts.v2.region.lts_region import LtsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdklts.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = LtsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(LtsRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListStructuredLogsWithTimeRangeRequest()
        request.log_stream_id = "{log_stream_id}"
        timeRangebody = TimeRange(
            sql_time_zone="UTC",
            start_time=1613806109000,
            end_time=1613806110000,
            start_time_gt=False,
            end_time_lt=False
        )
        request.body = QueryLtsStructLogParamsNew(
            time_range=timeRangebody,
            format="k-v",
            query="select count(test3), sum(test4) group by(test1)"
        )
        response = client.list_structured_logs_with_time_range(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        
       

When whether_to_rows is set to true:

        
         
           
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdklts.v2.region.lts_region import LtsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdklts.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = LtsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(LtsRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListStructuredLogsWithTimeRangeRequest()
        request.log_stream_id = "{log_stream_id}"
        timeRangebody = TimeRange(
            sql_time_zone="UTC",
            start_time=1613806109000,
            end_time=1613806110000,
            start_time_gt=False,
            end_time_lt=False
        )
        request.body = QueryLtsStructLogParamsNew(
            whether_to_rows=True,
            time_range=timeRangebody,
            format="k-v",
            query="select count(test3), sum(test4) group by(test1)"
        )
        response = client.list_structured_logs_with_time_range(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        
       

When query is set to select *:

        
         
           
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    lts "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := lts.NewLtsClient(
        lts.LtsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListStructuredLogsWithTimeRangeRequest{}
	request.LogStreamId = "{log_stream_id}"
	sqlTimeZoneTimeRange:= "UTC"
	startTimeGtTimeRange:= false
	endTimeLtTimeRange:= false
	timeRangebody := &model.TimeRange{
		SqlTimeZone: &sqlTimeZoneTimeRange,
		StartTime: int64(1613806109000),
		EndTime: int64(1613806110000),
		StartTimeGt: &startTimeGtTimeRange,
		EndTimeLt: &endTimeLtTimeRange,
	}
	request.Body = &model.QueryLtsStructLogParamsNew{
		TimeRange: timeRangebody,
		Format: "k-v",
		Query: "select *",
	}
	response, err := client.ListStructuredLogsWithTimeRange(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        
       

When query is set to select count(test3) as mycount, sum(test4) as mysum:

        
         
           
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    lts "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := lts.NewLtsClient(
        lts.LtsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListStructuredLogsWithTimeRangeRequest{}
	request.LogStreamId = "{log_stream_id}"
	sqlTimeZoneTimeRange:= "UTC"
	startTimeGtTimeRange:= false
	endTimeLtTimeRange:= false
	timeRangebody := &model.TimeRange{
		SqlTimeZone: &sqlTimeZoneTimeRange,
		StartTime: int64(1613806109000),
		EndTime: int64(1613806110000),
		StartTimeGt: &startTimeGtTimeRange,
		EndTimeLt: &endTimeLtTimeRange,
	}
	request.Body = &model.QueryLtsStructLogParamsNew{
		TimeRange: timeRangebody,
		Format: "k-v",
		Query: "select count(test3) as mycount, sum(test4) as mysum",
	}
	response, err := client.ListStructuredLogsWithTimeRange(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        
       

When query is set to select count(test3), sum(test4) group by(test1):

        
         
           
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    lts "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := lts.NewLtsClient(
        lts.LtsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListStructuredLogsWithTimeRangeRequest{}
	request.LogStreamId = "{log_stream_id}"
	sqlTimeZoneTimeRange:= "UTC"
	startTimeGtTimeRange:= false
	endTimeLtTimeRange:= false
	timeRangebody := &model.TimeRange{
		SqlTimeZone: &sqlTimeZoneTimeRange,
		StartTime: int64(1613806109000),
		EndTime: int64(1613806110000),
		StartTimeGt: &startTimeGtTimeRange,
		EndTimeLt: &endTimeLtTimeRange,
	}
	request.Body = &model.QueryLtsStructLogParamsNew{
		TimeRange: timeRangebody,
		Format: "k-v",
		Query: "select count(test3), sum(test4) group by(test1)",
	}
	response, err := client.ListStructuredLogsWithTimeRange(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        
       

When whether_to_rows is set to true:

        
         
           
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    lts "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := lts.NewLtsClient(
        lts.LtsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListStructuredLogsWithTimeRangeRequest{}
	request.LogStreamId = "{log_stream_id}"
	sqlTimeZoneTimeRange:= "UTC"
	startTimeGtTimeRange:= false
	endTimeLtTimeRange:= false
	timeRangebody := &model.TimeRange{
		SqlTimeZone: &sqlTimeZoneTimeRange,
		StartTime: int64(1613806109000),
		EndTime: int64(1613806110000),
		StartTimeGt: &startTimeGtTimeRange,
		EndTimeLt: &endTimeLtTimeRange,
	}
	whetherToRowsQueryLtsStructLogParamsNew:= true
	request.Body = &model.QueryLtsStructLogParamsNew{
		WhetherToRows: &whetherToRowsQueryLtsStructLogParamsNew,
		TimeRange: timeRangebody,
		Format: "k-v",
		Query: "select count(test3), sum(test4) group by(test1)",
	}
	response, err := client.ListStructuredLogsWithTimeRange(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        
       

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

When query is set to select *:

        
         
           
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.lts.v2.region.LtsRegion;
import com.huaweicloud.sdk.lts.v2.*;
import com.huaweicloud.sdk.lts.v2.model.*;


public class ListStructuredLogsWithTimeRangeSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        LtsClient client = LtsClient.newBuilder()
                .withCredential(auth)
                .withRegion(LtsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListStructuredLogsWithTimeRangeRequest request = new ListStructuredLogsWithTimeRangeRequest();
        request.withLogStreamId("{log_stream_id}");
        QueryLtsStructLogParamsNew body = new QueryLtsStructLogParamsNew();
        TimeRange timeRangebody = new TimeRange();
        timeRangebody.withSqlTimeZone("UTC")
            .withStartTime(1613806109000L)
            .withEndTime(1613806110000L)
            .withStartTimeGt(false)
            .withEndTimeLt(false);
        body.withTimeRange(timeRangebody);
        body.withFormat("k-v");
        body.withQuery("select *");
        request.withBody(body);
        try {
            ListStructuredLogsWithTimeRangeResponse response = client.listStructuredLogsWithTimeRange(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        
       

When query is set to select count(test3) as mycount, sum(test4) as mysum:

        
         
           
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.lts.v2.region.LtsRegion;
import com.huaweicloud.sdk.lts.v2.*;
import com.huaweicloud.sdk.lts.v2.model.*;


public class ListStructuredLogsWithTimeRangeSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        LtsClient client = LtsClient.newBuilder()
                .withCredential(auth)
                .withRegion(LtsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListStructuredLogsWithTimeRangeRequest request = new ListStructuredLogsWithTimeRangeRequest();
        request.withLogStreamId("{log_stream_id}");
        QueryLtsStructLogParamsNew body = new QueryLtsStructLogParamsNew();
        TimeRange timeRangebody = new TimeRange();
        timeRangebody.withSqlTimeZone("UTC")
            .withStartTime(1613806109000L)
            .withEndTime(1613806110000L)
            .withStartTimeGt(false)
            .withEndTimeLt(false);
        body.withTimeRange(timeRangebody);
        body.withFormat("k-v");
        body.withQuery("select count(test3) as mycount, sum(test4) as mysum");
        request.withBody(body);
        try {
            ListStructuredLogsWithTimeRangeResponse response = client.listStructuredLogsWithTimeRange(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        
       

When query is set to select count(test3), sum(test4) group by(test1):

        
         
           
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.lts.v2.region.LtsRegion;
import com.huaweicloud.sdk.lts.v2.*;
import com.huaweicloud.sdk.lts.v2.model.*;


public class ListStructuredLogsWithTimeRangeSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        LtsClient client = LtsClient.newBuilder()
                .withCredential(auth)
                .withRegion(LtsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListStructuredLogsWithTimeRangeRequest request = new ListStructuredLogsWithTimeRangeRequest();
        request.withLogStreamId("{log_stream_id}");
        QueryLtsStructLogParamsNew body = new QueryLtsStructLogParamsNew();
        TimeRange timeRangebody = new TimeRange();
        timeRangebody.withSqlTimeZone("UTC")
            .withStartTime(1613806109000L)
            .withEndTime(1613806110000L)
            .withStartTimeGt(false)
            .withEndTimeLt(false);
        body.withTimeRange(timeRangebody);
        body.withFormat("k-v");
        body.withQuery("select count(test3), sum(test4) group by(test1)");
        request.withBody(body);
        try {
            ListStructuredLogsWithTimeRangeResponse response = client.listStructuredLogsWithTimeRange(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        
       

When whether_to_rows is set to true:

        
         
           
           package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.lts.v2.region.LtsRegion;
import com.huaweicloud.sdk.lts.v2.*;
import com.huaweicloud.sdk.lts.v2.model.*;


public class ListStructuredLogsWithTimeRangeSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        LtsClient client = LtsClient.newBuilder()
                .withCredential(auth)
                .withRegion(LtsRegion.valueOf("<YOUR REGION>"))
                .build();
        ListStructuredLogsWithTimeRangeRequest request = new ListStructuredLogsWithTimeRangeRequest();
        request.withLogStreamId("{log_stream_id}");
        QueryLtsStructLogParamsNew body = new QueryLtsStructLogParamsNew();
        TimeRange timeRangebody = new TimeRange();
        timeRangebody.withSqlTimeZone("UTC")
            .withStartTime(1613806109000L)
            .withEndTime(1613806110000L)
            .withStartTimeGt(false)
            .withEndTimeLt(false);
        body.withWhetherToRows(true);
        body.withTimeRange(timeRangebody);
        body.withFormat("k-v");
        body.withQuery("select count(test3), sum(test4) group by(test1)");
        request.withBody(body);
        try {
            ListStructuredLogsWithTimeRangeResponse response = client.listStructuredLogsWithTimeRange(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

          

        
       

When query is set to select *:

        
         
           
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdklts.v2.region.lts_region import LtsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdklts.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = LtsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(LtsRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListStructuredLogsWithTimeRangeRequest()
        request.log_stream_id = "{log_stream_id}"
        timeRangebody = TimeRange(
            sql_time_zone="UTC",
            start_time=1613806109000,
            end_time=1613806110000,
            start_time_gt=False,
            end_time_lt=False
        )
        request.body = QueryLtsStructLogParamsNew(
            time_range=timeRangebody,
            format="k-v",
            query="select *"
        )
        response = client.list_structured_logs_with_time_range(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        
       

When query is set to select count(test3) as mycount, sum(test4) as mysum:

        
         
           
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdklts.v2.region.lts_region import LtsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdklts.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = LtsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(LtsRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListStructuredLogsWithTimeRangeRequest()
        request.log_stream_id = "{log_stream_id}"
        timeRangebody = TimeRange(
            sql_time_zone="UTC",
            start_time=1613806109000,
            end_time=1613806110000,
            start_time_gt=False,
            end_time_lt=False
        )
        request.body = QueryLtsStructLogParamsNew(
            time_range=timeRangebody,
            format="k-v",
            query="select count(test3) as mycount, sum(test4) as mysum"
        )
        response = client.list_structured_logs_with_time_range(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        
       

When query is set to select count(test3), sum(test4) group by(test1):

        
         
           
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdklts.v2.region.lts_region import LtsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdklts.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = LtsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(LtsRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListStructuredLogsWithTimeRangeRequest()
        request.log_stream_id = "{log_stream_id}"
        timeRangebody = TimeRange(
            sql_time_zone="UTC",
            start_time=1613806109000,
            end_time=1613806110000,
            start_time_gt=False,
            end_time_lt=False
        )
        request.body = QueryLtsStructLogParamsNew(
            time_range=timeRangebody,
            format="k-v",
            query="select count(test3), sum(test4) group by(test1)"
        )
        response = client.list_structured_logs_with_time_range(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        
       

When whether_to_rows is set to true:

        
         
           
           # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdklts.v2.region.lts_region import LtsRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdklts.v2 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = LtsClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(LtsRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ListStructuredLogsWithTimeRangeRequest()
        request.log_stream_id = "{log_stream_id}"
        timeRangebody = TimeRange(
            sql_time_zone="UTC",
            start_time=1613806109000,
            end_time=1613806110000,
            start_time_gt=False,
            end_time_lt=False
        )
        request.body = QueryLtsStructLogParamsNew(
            whether_to_rows=True,
            time_range=timeRangebody,
            format="k-v",
            query="select count(test3), sum(test4) group by(test1)"
        )
        response = client.list_structured_logs_with_time_range(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

          

        
       

When query is set to select *:

        
         
           
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    lts "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := lts.NewLtsClient(
        lts.LtsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListStructuredLogsWithTimeRangeRequest{}
	request.LogStreamId = "{log_stream_id}"
	sqlTimeZoneTimeRange:= "UTC"
	startTimeGtTimeRange:= false
	endTimeLtTimeRange:= false
	timeRangebody := &model.TimeRange{
		SqlTimeZone: &sqlTimeZoneTimeRange,
		StartTime: int64(1613806109000),
		EndTime: int64(1613806110000),
		StartTimeGt: &startTimeGtTimeRange,
		EndTimeLt: &endTimeLtTimeRange,
	}
	request.Body = &model.QueryLtsStructLogParamsNew{
		TimeRange: timeRangebody,
		Format: "k-v",
		Query: "select *",
	}
	response, err := client.ListStructuredLogsWithTimeRange(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        
       

When query is set to select count(test3) as mycount, sum(test4) as mysum:

        
         
           
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    lts "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := lts.NewLtsClient(
        lts.LtsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListStructuredLogsWithTimeRangeRequest{}
	request.LogStreamId = "{log_stream_id}"
	sqlTimeZoneTimeRange:= "UTC"
	startTimeGtTimeRange:= false
	endTimeLtTimeRange:= false
	timeRangebody := &model.TimeRange{
		SqlTimeZone: &sqlTimeZoneTimeRange,
		StartTime: int64(1613806109000),
		EndTime: int64(1613806110000),
		StartTimeGt: &startTimeGtTimeRange,
		EndTimeLt: &endTimeLtTimeRange,
	}
	request.Body = &model.QueryLtsStructLogParamsNew{
		TimeRange: timeRangebody,
		Format: "k-v",
		Query: "select count(test3) as mycount, sum(test4) as mysum",
	}
	response, err := client.ListStructuredLogsWithTimeRange(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        
       

When query is set to select count(test3), sum(test4) group by(test1):

        
         
           
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    lts "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := lts.NewLtsClient(
        lts.LtsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListStructuredLogsWithTimeRangeRequest{}
	request.LogStreamId = "{log_stream_id}"
	sqlTimeZoneTimeRange:= "UTC"
	startTimeGtTimeRange:= false
	endTimeLtTimeRange:= false
	timeRangebody := &model.TimeRange{
		SqlTimeZone: &sqlTimeZoneTimeRange,
		StartTime: int64(1613806109000),
		EndTime: int64(1613806110000),
		StartTimeGt: &startTimeGtTimeRange,
		EndTimeLt: &endTimeLtTimeRange,
	}
	request.Body = &model.QueryLtsStructLogParamsNew{
		TimeRange: timeRangebody,
		Format: "k-v",
		Query: "select count(test3), sum(test4) group by(test1)",
	}
	response, err := client.ListStructuredLogsWithTimeRange(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        
       

When whether_to_rows is set to true:

        
         
           
           package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    lts "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/lts/v2/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := lts.NewLtsClient(
        lts.LtsClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.ListStructuredLogsWithTimeRangeRequest{}
	request.LogStreamId = "{log_stream_id}"
	sqlTimeZoneTimeRange:= "UTC"
	startTimeGtTimeRange:= false
	endTimeLtTimeRange:= false
	timeRangebody := &model.TimeRange{
		SqlTimeZone: &sqlTimeZoneTimeRange,
		StartTime: int64(1613806109000),
		EndTime: int64(1613806110000),
		StartTimeGt: &startTimeGtTimeRange,
		EndTimeLt: &endTimeLtTimeRange,
	}
	whetherToRowsQueryLtsStructLogParamsNew:= true
	request.Body = &model.QueryLtsStructLogParamsNew{
		WhetherToRows: &whetherToRowsQueryLtsStructLogParamsNew,
		TimeRange: timeRangebody,
		Format: "k-v",
		Query: "select count(test3), sum(test4) group by(test1)",
	}
	response, err := client.ListStructuredLogsWithTimeRange(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

          

        
       

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

Status Codes


Status Code	Description
200	The request is successful.
400	Invalid request. Modify the request based on the description in error_msg before a retry.
500	The server has received the request but encountered an internal error.