CreateLogStore - 创建LogStore_日志服务(SLS)-阿里云帮助中心

创建 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 名称不可重复。只能包括小写字母、数字、短划线（-）和下划线（_）。必须以小写字母或者数字开头和结尾。长度为 3-63 字符。	my-logstore
shardCount	integer	是	Shard 分区个数。说明该接口不支持更新 Shard 个数。只能通过 SplitShard 或 MergeShards 接口修改 Shard 个数。	2
ttl	integer	是	数据的保存时间，单位为天。取值范围为 1~3000。如果配置为 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 地址和日志接收时间。 false：不记录公网 IP 地址和日志接收时间。	false
telemetryType	string	否	可观测数据类型。取值包括： None：日志数据。默认为日志数据。 Metrics：时序数据。	None
hot_ttl	integer	否	数据在 Logstore 热存储层中的存储时间，最少为 7 天。单位：天，取值范围：7~3000。当数据的存储时间超过您所配置的热存储层数据保存时间后，数据将转为低频存储。更多信息，请参见智能冷热分层存储。	60
mode	string	否	日志服务提供标准型（Standard）和查询型（Query）两种类型的 Logstore。 standard：支持日志服务一站式数据分析功能，适用于实时监控、交互式分析以及构建完整的可观测性系统等场景。 query：支持高性能查询，索引流量费用约为 Standard 的一半，但不支持 SQL 分析，适用于数据量大、存储周期长（周、月级别以上）、无日志分析的场景。	standard
infrequentAccessTTL	integer	否	低频存储。没有最少存储时间要求，至少保存 30 天转归档存储。	30

返回参数

名称	类型	描述	示例值
headers	object
Server	string	服务器名称。	nginx
Content-Type	string	响应内容类型。类型支持 application/json、application/x-protobuf 两种类型。	application/json
Content-Length	string	响应内容长度。	0
Connection	string	是否长链接。取值包括： close：不是长链接，则每个 HTTP 请求都会重新建立 TCP 连接。 keep-alive：长链接，TCP 连接建立后保持连接状态，节省连接所需时间和带宽。	close
Date	string	当前返回响应的时间。	Sun, 27 May 2018 08:25:04 GMT
x-log-requestid	string	服务端产生的标示，该请求的唯一 ID。	5B0A6B60BB6EE39764D458B5

示例

正常返回示例

JSON格式

{}

错误码

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

HttpStatusCode	ErrorCode	ErrorMessage	错误码描述
404	ProjectNotExist	Project does not exist.	Project 不存在。
400	LogstoreAlreadyExist	Logstore already exists.	Logstore 已存在。
400	LogStoreInfoInvalid	Logstore info is invalid	Logstore 信息无效。
400	ProjectQuotaExceed	Project Quota Exceed.	超过 Project 限额。
500	InternalServerError	Specified Server Error Message.	内部服务调用错误。

更多信息，请参见通用错误码。