调用CLI命令创建Logstore。
注意事项
在使用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。
- 本页导读 (1)
- 注意事项
- 命令格式
- 命令参数
- 命令示例
- 相关文档