Queries a cursor based on a specified point in time.
Request syntax
aliyunlog log get_cursor --project_name=<value> --logstore_name=<value> --shard_id=<value> --start_time=<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 command.
Parameter | Type | Required | Example | Description |
--project_name | String | Yes | aliyun-test-project | The name of the project. |
--logstore_name | String | Yes | logstroe-a | The name of the Logstore. |
--shard_id | String | Yes | 0 | The ID of the shard. |
--start_time | String | Yes | begin | The time when the query starts. Valid values:
|
For information about the global parameters of the Log Service command-line interface (CLI), see Global parameters.
Examples
Sample requests
Use the default account to query the start cursor of a shard whose ID is 0 in a Logstore named logstore-a. Run the following command:
aliyunlog log get_cursor --project_name="aliyun-test-project" --logstore_name="logstore-a" --shard_id=0 --start_time="begin"Sample responses
{"cursor": "MTYxNDc1MDAyNzM3MzIwNTcxNA=="}
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.