使用CreateLogStore创建LogStore-日志服务-阿里云

创建 LogStore。

接口说明

请求语法中的 Host 由 Project 名称和日志服务 Endpoint 构成，您需要在 Host 中指定 Project。
已创建并获取 AccessKey。更多信息，请参见访问密钥。

阿里云账号 AccessKey 拥有所有 API 的访问权限，风险很高。强烈建议您创建并使用 RAM 用户进行 API 访问或日常运维。RAM 用户需具备操作日志服务资源的权限。具体操作，请参见创建 RAM 用户及授权。

已明确您查询日志所属的 Project 名称、所属地域等信息。如何查询，请参见管理 Project。
一个 Project 中，最多创建 200 个 Logstore。
当日志保存时间达到您所设置的数据保存时间后，日志将被删除。

鉴权资源

下表列出了 API 对应的授权信息。您可以在 RAM 权限策略语句的 Action 元素中添加该信息，用于为 RAM 用户或 RAM 角色授予调用此 API 的权限。

动作（Action）	授权策略中的资源描述方式（Resource）
`log:CreateLogStore`	`acs:log:{#regionId}:{#accountId}:project/{#ProjectName}/logstore/{#LogstoreName}`

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

log:CreateLogStore

create

*LogStore

acs:log:{#regionId}:{#accountId}:project/{#project}/logstore/{#logstoreName}

log:TLSVersion
log:Encrypted

无

请求语法

POST /logstores HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
project	string	是	Project 名称。	ali-test-project
body	object	是	请求参数。
logstoreName	string	是	Logstore 名称。其命名规则如下：同一个 Project 下，Logstore 名称不可重复。只能包括小写字母、数字、短划线（-）和下划线（_）。必须以小写字母或者数字开头和结尾。长度为 2-63 字符。	my-logstore
shardCount	integer	是	Shard 分区个数。说明该接口不支持更新 Shard 个数。只能通过 SplitShard 或 MergeShards 接口修改 Shard 个数。	2
ttl	integer	是	数据的保存时间，单位为天。取值范围为 1~3650。如果配置为 3650，表示永久保存。	1
encrypt_conf	EncryptConf	否	加密配置数据结构，包含参数`enable`、 `encrypt_type`、 `user_cmk_info`。更多信息，请参见EncryptConf 。
autoSplit	boolean	否	是否自动分裂 Shard。 true：自动分裂 Shard。 false：不自动分裂 Shard。	true
enable_tracking	boolean	否	是否开启 WebTracking 功能。默认值为 false。 true：开启 WebTracking。 false：不开启 WebTracking。	false
maxSplitShard	integer	否	自动分裂时最大的 Shard 个数，最小值是 1，最大值是 256。说明当 autoSplit 参数为 true 时必须设置。	64
appendMeta	boolean	否	是否记录外网 IP 地址和日志接收时间。默认值为 false。 true：开启记录外网 IP 和日志接收时间功能，开启后日志服务自动把日志来源设备的公网 IP 地址和日志到达服务端的时间添加到日志的 Tag 字段中。 false：不开启记录外网 IP 和日志接收时间功能。	false
telemetryType	string	否	可观测数据类型。取值包括： None：日志数据。默认为日志数据。 Metrics：时序数据。	None
hot_ttl	integer	否	数据在 Logstore 热存储层中的存储时间。单位：天，最小为 7，最大不能超过 ttl 的值，取值为-1 代表保存时间 ttl 内全是热存储。当数据的存储时间超过您所配置的热存储层数据保存时间后，数据将转为低频存储。更多信息，请参见智能冷热分层存储。	60
mode	string	否	日志服务提供标准型（Standard）和查询型（Query）两种类型的 Logstore。 standard：支持日志服务一站式数据分析功能，适用于实时监控、交互式分析以及构建完整的可观测性系统等场景。 query：支持高性能查询，索引流量费用约为 Standard 的一半，但不支持 SQL 分析，适用于数据量大、存储周期长（周、月级别以上）、无日志分析的场景。	standard
infrequentAccessTTL	integer	否	低频存储。没有最少存储时间要求，至少保存 30 天转归档存储。	30
processorId	string	否	IngestProcessor ID
shardingPolicy	ShardingPolicy	否

返回参数

名称

类型

描述

示例值

当前API暂无返回参数

示例

正常返回示例

JSON格式

{}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。