All Products
Search
Document Center

Simple Log Service:Global parameters

Last Updated:Aug 27, 2026

After you configure global parameters for the Simple Log Service (SLS) command-line interface (CLI), you do not need to specify them each time you run a command. The SLS CLI uses the configured values to process requests by default. This topic describes the common global parameters of the SLS CLI.

For information about how to configure global parameters, see Configure CLI.

Parameter

Type

Required

Example value

Description

--access-id

String

No

LTAI****************

The AccessKey ID of your Alibaba Cloud access key. Replace the value with the actual AccessKey ID. For information about how to obtain an AccessKey ID, see access key.

--access-key

String

No

yourAccessKeySecret

The AccessKey secret of your Alibaba Cloud access key. Replace the value with the actual AccessKey secret. For information about how to obtain an AccessKey secret, see access key.

--sts-token

String

No

None

The Security Token Service (STS) token. For information about how to obtain an STS token, see Use an STS token to access Simple Log Service resources across accounts.

--region-endpoint

String

No

cn-hangzhou.log.aliyuncs.com

The endpoint used to access SLS. For information about how to obtain an endpoint, see service endpoint.

--client-name

String

No

test

The name of the client that sends the request. The client name determines which account is used to perform the operation.

--format-output

String

No

json

The output format. Valid values:

  • json: formats the output in JSON.

  • no_escape: returns non-English characters as raw characters without escaping them.

To apply both values, separate them with a comma. For example, if you specify --format-output=json,no_escape, the output is formatted in JSON and non-English characters are not escaped.

--jmes-filter

String

No

--jmes-filter="join('\n', map(&to_string(@), @))"

A JMESPath expression that filters the returned log data.

--decode-output

String

No

utf8

If the stored log data is binary data, this parameter specifies the encoding used to decode the data. Supported encodings:

  • utf8: decodes the data by using UTF-8. This is the default value.

  • latin1: decodes the data by using Latin-1.

  • gbk: decodes the data by using GBK.

--profile

String

No

akProfile

Authenticates the account by using the credentials configured in the Alibaba Cloud CLI configuration file .aliyun/config.json.