All Products
Document Center

Log Service:get_cursor_time

Last Updated:Oct 26, 2023

Queries the server time based on a cursor.

Request syntax

aliyunlog log get_cursor_time --project_name=<value> --logstore_name=<value> --shard_id=<value> --cursor=<value> [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

Request parameters

The following table describes the required and specific parameters of the get_cursor_time command.
--project_nameStringYesaliyun-test-projectThe name of the project.
--logstore_nameStringYeslogstroe-aThe name of the Logstore.
--shard_idStringYes0The ID of the shard.
--cursorStringYesMTYxNDc1MDAyNzM3MzIwNTcxNA==The cursor that is used to query a timestamp.
For information about the global parameters of the Log Service command-line interface (CLI), see Global parameters.


  • Sample requests
    Use the default account to query the server time based on a cursor. Run the following command:
    aliyunlog log get_cursor_time --project_name="aliyun-test-project" --logstore_name="logstore-a" --shard_id=0 --cursor="MTYxNDc1MDAyNzM3MzIwNTcxNA=="
  • Sample responses
    {"cursor_time": 1620037252}

Error codes

If an error message is returned, fix the error based on the error codes of the related API operation. For more information, see Error codes of GetCursorTime.

API reference