调用CLI命令创建Logstore。
注意事项
在使用CLI命令之前，您需要注意以下事项：
已开通日志服务。具体操作，请参见如何开始使用日志服务？。
已安装日志服务CLI，并完成配置。具体操作，请参见安装CLI和配置CLI。
已创建日志服务Project。具体操作，请参见create_project。
命令格式
aliyunlog log create_logstore --project_name=<value> --logstore_name=<value> [--ttl=<value>] [--shard_count=<value>] [--enable_tracking=<value>] [--append_meta=<value>] [--auto_split=<value>] [--max_split_shard=<value>] [--preserve_storage=<value>] [--encrypt_conf=<value>] [--telemetry_type=<value>] [--hot_ttl=<value>] [--mode=<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>] [--profile=<value>]命令参数
该命令的必选和特有参数描述如下。
参数名称 | 数值类型 | 是否必选 | 示例值 | 描述 |
--project_name | String | 是 | aliyun-test-project | Project名称：项目（Project）是日志服务的资源管理单元，是进行多用户隔离与访问控制的主要边界。更多信息，请参见管理Project。 |
--logstore_name | String | 是 | logstore-a | Logstore名称在Project中全局唯一，且创建后不可修改。 其命名规则如下：
|
--ttl | Integer | 否 | 30 | 数据保存时间，单位为天。取值范围：1~3650，如果配置为3650，表示永久保存。当设置的保存期限到达时，日志将被删除。 数据保存时间（ttl）是以下三部分时间的总和：
|
--shard_count | Integer | 否 | 2 | 分区（Shard）数量。取值范围为1~10。更多信息，请参见Shard范围。 |
--enable_tracking | Boolean | 否 | true | 是否开启WebTracking功能。
|
--append_meta | Boolean | 否 | false | 是否开启记录外网IP地址功能。
|
--auto_split | Boolean | 否 | true | 是否自动分裂Shard功能。
|
--max_split_shard | Integer | 否 | 64 | 自动分裂Shard时的最大分裂数。取值范围为1~256。当--auto_split参数为true时必须设置。 |
--encrypt_conf | String | 否 | 无 | 加密配置数据结构。 更多信息，请参见EncryptConf。 |
--telemetry_type | String | 否 | None | 可观测数据类型。取值包括：
重要 此参数创建后不可修改。 |
--hot_ttl | Integer | 否 | 60 | 数据在Logstore热存储层中的存储时间，单位为天。最小为7，最大不能超过ttl的值，取值为 当数据的存储时间超过您所配置的热存储层数据保存时间后，数据将转为低频存储。关于热存储、低频存储、归档存储的概念和转换流程，请参见管理智能存储分层。
|
--mode | String | 否 | standard | 日志服务提供Standard（标准型）和Query（查询型）两种类型的Logstore。
更多信息，请参见Logstore类型对比。 |
关于该命令的全局参数，请参见全局参数。
命令示例
使用默认账号创建logstore-a。
命令示例
aliyunlog log create_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a"返回示例
命令执行成功后，无响应消息。您可以执行如下命令查询Logstore详细信息。
aliyunlog log get_logstore --project_name="aliyun-test-project" --logstore_name="logstore-a" --format-output=json
使用指定账号test，创建一个名为logstore-b的Logstore。
命令示例
aliyunlog log create_logstore --project_name="aliyun-test-project" --logstore_name="logstore-b" --client-name="test"返回示例
命令执行成功后，无响应消息。您可以执行如下命令查询Logstore详细信息。
aliyunlog log get_logstore --project_name="aliyun-test-project" --logstore_name="logstore-b" --client-name="test" --format-output=json返回结果如下：
{ "appendMeta": false, "archiveSeconds": 0, "autoSplit": true, "createTime": 1719280391, "enable_tracking": false, "lastModifyTime": 1719282255, "logstoreName": "logstore-b", "maxSplitShard": 64, "mode": "standard", "productType": "", "resourceQuota": { "storage": { "preserved": -1, "used": 0 } }, "shardCount": 5, "telemetryType": "", "ttl": 30 }
相关文档
在调用API接口过程中，若服务端返回结果中包含错误信息，则表示调用API接口失败。您可以参考API错误码对照表查找对应的解决方法。更多信息，请参见API错误处理对照表。
日志服务除自研的SDK外，还支持公共的阿里云SDK，关于阿里云SDK的使用方式，请参见日志服务_SDK中心-阿里云OpenAPI开发者门户。
关于该API接口的详细信息，请参见CreateLogStore。
日志服务提供基于Java SDK和Python SDK的管理Logstore示例代码。更多信息，请参见使用Java SDK管理日志库Logstore和使用Python SDK管理日志库Logstore。