详情页标题前

腾讯云对象存储生命周期

• 腾讯云
详情页1

简介

本文档提供关于生命周期的 API 概览以及 SDK 示例代码。

API 操作名 操作描述
PUT Bucket lifecycle 设置生命周期 设置存储桶的生命周期管理的配置
GET Bucket lifecycle 查询生命周期 查询存储桶生命周期管理的配置
DELETE Bucket lifecycle 删除生命周期 删除存储桶生命周期管理的配置

设置生命周期

功能说明

设置指定存储桶的生命周期配置信息（PUT Bucket lifecycle）。

请求示例

示例一：上传30天后，当前版本沉降至低频存储。

cos.putBucketLifecycle({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */    Rules: [{        "ID": "1",        "Status": "Enabled",        "Filter": {},        "Transition": {            "Days": "30",            "StorageClass": "STANDARD_IA"        }    }],}, function(err, data) {    console.log(err || data);});

示例二：指定目录前缀dir/，上传90天后，当前版本沉降至归档存储。

cos.putBucketLifecycle({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */    Rules: [{        "ID": "2",        "Filter": {            "Prefix": "dir/",        },        "Status": "Enabled",        "Transition": {            "Days": "90",            "StorageClass": "ARCHIVE"        }    }],}, function(err, data) {    console.log(err || data);});

示例三：上传180天后，清理过期文件删除标记。

cos.putBucketLifecycle({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */    Rules: [{        "ID": "3",        "Status": "Enabled",        "Filter": {},        "Expiration": {            "Days": "180"        }    }],}, function(err, data) {    console.log(err || data);});

示例四：上传30天后，删除碎片。

cos.putBucketLifecycle({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */    Rules: [{        "ID": "4",        "Status": "Enabled",        "Filter": {},        "AbortIncompleteMultipartUpload": {            "DaysAfterInitiation": "30"        }    }],}, function(err, data) {    console.log(err || data);});

示例五：历史版本生成30天后沉降至归档存储。

cos.putBucketLifecycle({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */    Rules: [{        "ID": "5",        "Status": "Enabled",        "Filter": {},        "NoncurrentVersionTransition": {            "NoncurrentDays": "30",            "StorageClass": 'ARCHIVE'        }    }],}, function(err, data) {    console.log(err || data);});

参数说明

参数名称 描述 类型 是否必填
Bucket 设置生命周期的存储桶，格式：BucketName-APPID String 是
Region 存储桶所在地域，枚举值请参见 地域和访问域名 String 是
Rules 指定生命周期规则列表 ObjectArray 是
– ID 规则的唯一标识 ID String 是
– Status 规则的开启状态，枚举值：Enabled、Disabled String 是
– Filter 指定过滤条件 Object 是
– – Prefix 规则要匹配上的对象键前缀 String 否
– Transition 规则转换属性，表示对象存储级别何时转换为 Standard_IA 或 Archive Object 否
– – Days 指明规则对应的动作在对象最后的修改日期过后多少天执行，该字段有效值是非负整数，最大支持3650天 Number 是
– – StorageClass 表示规则对应的动作执行后变更对象的存储级别，枚举值：STANDARD、STANDARD_IA、ARCHIVE，默认值：STANDARD String 是
– NoncurrentVersionTransition 指明历史版本对象转换属性 ObjectArray 否
– – NoncurrentDays 指明历史版本对象在该值确定的生效天数后进行转换 Number 是
– – StorageClass 表示规则对应的动作执行后变更对象的存储级别，枚举值：STANDARD、STANDARD_IA、ARCHIVE String 是
– Expiration 规则过期属性 Object 否
– – ExpiredObjectDeleteMarker 删除过期对象删除标记，枚举值 true，false，与 Days 不可并存 Boolean 是
– – Days 指明规则对应的动作在对象最后的修改日期过后多少天进行删除操作，与 ExpiredObjectDeleteMarker 不可并存 Number 是
– AbortIncompleteMultipartUpload 表示删除碎片 Object 否
– – DaysAfterInitiation 碎片在该值所确定的生效天数后被删除，按文件上传时间开始算，必须为正整数 Number 是

回调函数说明

function(err, data) { ... }
参数名 描述 类型
err 请求发生错误时返回的对象，包括网络错误和业务错误，如果请求成功则为空，详情请参见 错误码 文档 Object
– statusCode 请求返回的 HTTP 状态码，例如200、403、404等 Number
– headers 请求返回的头部信息 Object
data 请求成功时返回的对象，如果请求发生错误，则为空 Object
– statusCode 请求返回的 HTTP 状态码，例如200、403、404等 Number
– headers 请求返回的头部信息 Object

查询生命周期

功能说明

GET Bucket lifecycle 接口可以查询存储桶生命周期管理的配置。

请求示例

cos.getBucketLifecycle({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */}, function(err, data) {    console.log(err || data);});

返回示例

{    "Rules": [{        "ID": "1",        "Filter": "",        "Status": "Enabled",        "Transition": {            "Days": "30",            "StorageClass": "STANDARD_IA"        }    }, {        "ID": "2",        "Filter": {            "Prefix": "dir/"        },        "Status": "Enabled",        "Transition": {            "Days": "90",            "StorageClass": "ARCHIVE"        }    }, {        "ID": "3",        "Filter": "",        "Status": "Enabled",        "Expiration": {            "Days": "180"        }    }, {        "ID": "4",        "Filter": "",        "Status": "Enabled",        "AbortIncompleteMultipartUpload": {            "DaysAfterInitiation": "30"        }    }, {        "ID": "5",        "Filter": "",        "Status": "Enabled",        "NoncurrentVersionTransition:": {            "NoncurrentDays": "30",            "StorageClass": "ARCHIVE"        }    }],    "statusCode": 200,    "headers": {}}

参数说明

参数名称 描述 类型 是否必填
Bucket 查询生命周期的存储桶，格式：BucketName-APPID String 是
Region 存储桶所在地域，枚举值请参见 地域和访问域名 String 是

回调函数说明

function(err, data) { ... }
参数名 参数描述 类型
err 请求发生错误时返回的对象，包括网络错误和业务错误，如果请求成功则为空，详情请参见 错误码 文档 Object
– statusCode 请求返回的 HTTP 状态码，例如200、403、404等 Number
– headers 请求返回的头部信息 Object
data 请求成功时返回的对象，如果请求发生错误，则为空 Object
– statusCode 请求返回的 HTTP 状态码，例如200、403、404等 Number
– headers 请求返回的头部信息 Object
– Rules 指定生命周期规则列表 ObjectArray
– – ID 规则的唯一标识 ID String
– – Status 规则的开启状态，枚举值：Enabled、Disabled String
– – Filter 指定过滤条件 Object
– – – Prefix 规则要匹配上的对象键前缀 String
– – Transition 规则转换属性，表示对象存储级别何时转换为 Standard_IA 或 Archive ObjectArray
– – – Days 指明规则对应的动作在对象最后的修改日期过后多少天执行，该字段有效值是非负整数，最大支持3650天 Number
– – – StorageClass 表示规则对应的动作执行后变更对象的存储类型，枚举值：STANDARD、STANDARD_IA、ARCHIVE String
– – NoncurrentVersionTransition 指明历史版本对象转换属性 ObjectArray
– – – NoncurrentDays 指明历史版本对象在该值确定的生效天数后进行转换 Number
– – – StorageClass 表示规则对应的动作执行后变更对象的存储级别，枚举值：STANDARD、STANDARD_IA、ARCHIVE String
– – Expiration 规则过期属性 Object
– – – ExpiredObjectDeleteMarker 删除过期对象删除标记，枚举值 true，false，与 Days 不可并存 Boolean
– – – Days 指明规则对应的动作在对象最后的修改日期过后多少天进行删除操作，与 ExpiredObjectDeleteMarker 不可并存 Number
– – AbortIncompleteMultipartUpload 表示删除碎片 Object
– – – DaysAfterInitiation 碎片在该值所确定的生效天数后被删除，按文件上传时间开始算，必须为正整数 Number

删除生命周期

功能说明

DELETE Bucket lifecycle 接口可以删除存储桶生命周期管理的配置。

请求示例

cos.deleteBucketLifecycle({    Bucket: 'examplebucket-1250000000', /* 必须 */    Region: 'COS_REGION',     /* 存储桶所在地域，必须字段 */}, function(err, data) {    console.log(err || data);});

参数说明

参数名称 描述 类型 是否必填
Bucket 被删除生命周期配置的存储桶，格式：BucketName-APPID String 是
Region 存储桶所在地域，枚举值请参见 地域和访问域名 String 是

回调函数说明

function(err, data) { ... }
参数名称 描述 类型
err 请求发生错误时返回的对象，包括网络错误和业务错误，如果请求成功则为空，详情请参见 错误码 文档 Object
– statusCode 请求返回的 HTTP 状态码，例如200、403、404等 Number
– headers 请求返回的头部信息 Object
data 请求成功时返回的对象，如果请求发生错误，则为空 Object
– statusCode 请求返回的 HTTP 状态码，例如200、403、404等 Number
– headers 请求返回的头部信息 Object



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠

转转请注明出处：https://www.yunxiaoer.com/146114.html

赞 (0)
0
上一篇 2023年12月9日
下一篇 2023年12月9日
详情页2

相关推荐

  • 腾讯云对象存储音频审核

    简介 本文档提供音频审核相关的 API 概览以及 SDK 示例代码。注意 该功能需要 COS Python SDK v5 1.9.10 及以上版本。如果当前您的COS Python SDK v5版本低于1.9.10，请升级版本。 API 操作描述 提交音频审核任务 用于提交一个音频审核任务。 查询音频审核任务结果 用来查询指定的音频审核任务。 提交音频审核任…

    腾讯云 2023年12月9日
  • 腾讯云轻量应用服务器使用 VNC 方式登录 Linux 实例云小二 腾讯云

    腾讯云轻量应用服务器使用 VNC 方式登录 Linux 实例云小二

    操作场景 VNC 登录是腾讯云为用户提供的一种通过 Web 浏览器远程连接实例的方式。在没有安装或者无法使用远程登录客户端，以及通过其他方式均无法登录的情况下，用户可以通过 VNC 登录连接到实例，观察实例状态，并进行基本的管理操作。 使用限制 VNC 暂时不支持中文输入法以及文件的上传、下载。VNC 登录实例时，需要使用主流浏览器，例如 Chrome，Fi…

    2023年12月9日
  • 腾讯云对象存储开启全球加速 腾讯云

    腾讯云对象存储开启全球加速

    简介 您可以通过对象存储（Cloud Object Storage，COS）控制台为您的存储桶开启全球加速功能，实现全球各地用户快速访问您的存储桶，提升您的业务访问成功率和业务稳定性。全球加速功能可以加速您的上传和下载，关于全球加速的更多信息，请参见 全球加速概述 和 内网全球加速。 操作步骤 1. 登录 对象存储控制台。2. 在左侧导航栏中，单击存储桶列表…

    2023年12月9日
  • 函数计算中，FC和API gateway适配的问题，那么在API网关应该怎样连接FC3.0呢？-云小二-阿里云 阿里云

    函数计算中，FC和API gateway适配的问题，那么在API网关应该怎样连接FC3.0呢？-云小二-阿里云

    函数计算中，FC和API gateway适配的问题，API网关在自定义后端的时候，如果选择FC，那么必须指定服务名，如下图但是根据FC3.0的公告，新的FC已经没有服务的概念了那么在API网关应该怎样连接FC3.0呢？ 以下为热心网友提供的参考意见 在 API Gateway 中连接 FC3.0，您可以按照以下步骤进行操作： 创建一个新的 API Gatew…

    2024年1月3日
  • 信息流广告，信息流部分建议宽度830px，只针对默认列表样式，顺序随机

  • 阿里云对象存储OSSC下载文件概述-云淘科技

    OSS C SDK提供了丰富的文件下载方式： 下载到本地文件 下载到本地内存 范围下载 断点续传下载 下载过程中，您还可以通过进度条功能查看下载进度。文件下载的完整代码，请参见GitHub。 内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家阿里云企业补贴进行中： 马上申请腾讯云限时活动1折起，即将结束： 马上收藏同尘科技为腾讯云授权服务中心。 购…

    阿里云对象存储 2023年12月10日

联系我们

400-800-8888

在线咨询： QQ交谈

邮件：admin@example.com

工作时间：周一至周五，9:30-18:30，节假日休息

关注微信
本站为广大会员提供阿里云、腾讯云、华为云、百度云等一线大厂的购买，续费优惠，保证底价，买贵退差。