UpdateLogStore - 更新LogStore_日志服务(SLS)-阿里云帮助中心

更新Logstore的属性信息。

接口说明

更新 Logstore 前需要先使用 GetLogStore 获取 Logstore 的原配置，在此基础上修改后，作为参数传入到 UpdateLogStore 中。
请求语法中的 Host 由 Project 名称和日志服务 Endpoint 构成，您需要在 Host 中指定 Project。
已创建并获取 AccessKey。更多信息，请参见访问密钥。

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

已明确您查询日志所属的 Project 名称、所属地域、Logstore 名称等信息。如何查询，请参见管理 Project和管理 Logstore。

鉴权资源

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

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

调试

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

调试

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
log:UpdateLogStore	Write	LogStore acs:log:{#regionId}:{#accountId}:project/{#project}/logstore/{#logstore}	log:TLSVersion log:Encrypted	无

请求语法

PUT /logstores/{logstore}

请求参数

名称	类型	必填	描述	示例值
project	string	是	Project 名称。	ali-test-project
logstore	string	是	Logstore 名称。	test-logstore
body	object	是	请求体参数。
logstoreName	string	是	Logstore 名称。	test-logstore
shardCount	integer	否	Shard 分区个数。说明该接口不支持更新分区个数。只能通过 SplitShard 或 MergeShards 接口修改分区个数。	2
ttl	integer	是	数据的保存时间，单位为天。取值范围为 1~3650。如果配置为 3650，表示永久保存。	30
encrypt_conf	EncryptConf	否	加密配置数据结构。
autoSplit	boolean	否	是否自动分裂 Shard。 true：自动分裂 Shard。 false：不自动分裂 Shard。	true
enable_tracking	boolean	否	是否开启 WebTracking 功能。默认值为 false。 true：开启 WebTracking。 false：不开启 WebTracking。	false
appendMeta	boolean	否	是否记录外网 IP 地址功能。默认值为 false。 true：记录外网 IP 地址。 false：不记录外网 IP 地址。	false
maxSplitShard	integer	否	自动分裂时最大的 Shard 个数，最小值是 1，最大值是 256。说明当 autoSplit 为 true 时必须指定。	64
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
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 不存在。
404	LogStoreNotExist	Logstore does not exist.	Logstore 不存在。
500	InternalServerError	Specified Server Error Message.	内部服务调用错误。

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