文档首页/ 湖仓构建 LakeFormation/ API参考/ API/ Console类API/ 配置管理/ 修改实例级生命周期规则 - UpdateInstanceLifecycle
更新时间:2025-11-18 GMT+08:00
分享

修改实例级生命周期规则 - UpdateInstanceLifecycle

功能介绍

修改实例级生命周期规则,data_delete_mode表示数据的删除方式,0是直接物理删除无法恢复,1是移入回收站(lake-formation-trash-dir/table_id/)目录下,在过期删除天数前可以进行恢复,元数据的删除方式是标记删除,metadata_expiration_delete_days是元数据的过期删除天数,data_expiration_delete_days是数据的过期删除天数,数据的天数要小于等于元数据的天数,且不能设置为0。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项

URI

PUT /v1/{project_id}/instances/{instance_id}/lifecycle

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

instance_id

String

LakeFormation实例ID。创建实例时自动生成。例如:2180518f-42b8-4947-b20b-adfc53981a25。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

租户token。

表3 请求Body参数

参数

是否必选

参数类型

描述

metadata_expiration_delete_days

Integer

元数据过期删除天数,在此天数后将自动删除过期元数据。

data_delete_mode

Integer

表示数据的删除方式,0是直接物理删除无法恢复,1是移入回收站(lake-formation-trash-dir/table_id/)目录下,在过期删除天数前可以进行恢复。

data_expiration_delete_days

Integer

数据过期删除天数,在此天数后将自动删除过期数据,设置-1表示不删除过期数据,不能设置0。

响应参数

状态码:200

表4 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID,定位辅助信息。

请求示例

PUT https://{endpoint}/v1/{project_id}/instances/{instance_id}/lifecycle

{
  "metadata_expiration_delete_days" : 3,
  "data_delete_mode" : 1,
  "data_expiration_delete_days" : 3
}

响应示例

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档