转换桶和对象的存储类别

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在桶列表中，选择待修改存储类别的桶，并单击右侧操作栏的“修改存储类别”。
3. 选择存储类别，单击“确定”。

图1 手动修改桶存储类别

设置桶默认存储类型

命名结构

• Windows操作系统

  obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

• macOS/Linux操作系统

  ./obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

• 以Windows操作系统为例，运行obsutil chattri obs://bucket-test -acl=private，修改桶的访问策略为私有读写。

  obsutil chattri obs://bucket-test -acl=private
  
  Set the acl of bucket [bucket-test] to [private] successfully, request id [04050000016836C5DA6FB21F14A2A0C0]

参数说明

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在桶列表单击待操作的桶，进入“对象”页面。
3. 如果需要修改的对象存储类别为归档或深度归档存储，请先执行恢复操作，详细操作步骤参见恢复归档存储和深度归档存储对象。
4. 修改对象存储类别支持单个修改和批量修改。
   1. 单个修改：在对象列表中，选择待修改存储类别的对象，并单击右侧操作栏的“更多>修改存储类别”如图2所示。
      图2 单个修改对象存储类别
      
   2. 批量修改：在对象列表中，勾选待修改存储类别的对象，并单击上方的“更多>修改存储类别”按钮，如图3所示。
      

      批量修改对象存储类别当前部分区域支持，请以管理控制台实际情况为准。

      图3 批量修改对象存储类别
      

5. 选择存储类别，单击“确定”，如图4所示。
   图4 选择对象存储类别
   

OBS有2个API接口支持手动转换对象存储类别的方式：

如果要修改对象的原有存储类别是归档存储或者深度归档存储，那么都需要先调用恢复归档存储和深度归档存储对象接口完成恢复后，才能转换对象的存储类别。

• 修改对象元数据（添加x-obs-storage-class头域设置）
• 复制对象（添加x-obs-storage-class头域设置），在桶的多版本控制开启时，OBS将会为新复制生成的对象自动生成唯一的版本ID。在未开启或暂停多版本控制的桶中，新复制生成的对象会覆盖原有对象。

1. 登录OBS Browser+。
2. 选中待修改对象所在的桶，进入对象页面。
3. 如果需要修改的对象存储类别为归档或深度归档存储，请右键单击选中待修改的对象，单击“恢复对象”，恢复完成后继续执行4。
4. 右键单击选中待修改的对象，单击“修改存储类别”。
5. 选择目标存储类别，然后单击“确认”。

obsutil支持通过修对象属性的方式修改对象存储类别。

如果要对象的存储类别是归档或者深度归档存储，那么需要恢复对象后，才能转换对象的存储类别。恢复对象的命令请参见恢复对象。

• Windows操作系统
  • 设置单个对象属性

    obsutil chattri obs://bucket/key [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • 批量设置对象属性

    obsutil chattri obs://bucket[/key] -r [-f] [-v] [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

• macOS/Linux操作系统
  • 设置单个对象属性

    ./obsutil chattri obs://bucket/key [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • 批量设置对象属性

    ./obsutil chattri obs://bucket[/key] -r [-f] [-v] [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

• 以Windows操作系统为例，运行obsutil chattri obs://bucket-test/key -acl=public-read，设置对象的访问策略为公共读。

  obsutil chattri obs://bucket-test/key -acl=public-read
  
  Set the acl of object [key] in the bucket [bucket-test] to [public-read] successfully, request id [04050000016836DDFA73B2B5320E2651]

• 以Windows操作系统为例，运行obsutil chattri obs://bucket-test -r -f -acl=public-read，批量设置桶内所有对象的访问策略为公共读。

  obsutil chattri obs://bucket-test -r -f -acl=public-read
  
  [------------------------------------------------] 100.00% tps:155.15 5/5 233ms
  Succeed count is:   5         Failed count is:    0
  Metrics [max cost:177 ms, min cost:53 ms, average cost:102.40 ms, average tps:20.41]
  Task id is: 9d7f73ff-f747-4fdd-9b2a-815ba2dc3b07

参数说明

<AccessControlPolicy>
    <Owner>
        <ID>ownerid</ID>
    </Owner>
    <AccessControlList>
        <Grant>
            <Grantee>
                <ID>userid</ID>
            </Grantee>
            <Permission>[WRITE|WRITE_ACP|READ|READ_ACP|FULL_CONTROL]</Permission>
        </Grant>
        <Grant>
            <Grantee>
                <Canned>Everyone</Canned>
            </Grantee>
            <Permission>[WRITE|WRITE_ACP|READ|READ_ACP|FULL_CONTROL]</Permission>
        </Grant>
    </AccessControlList>
</AccessControlPolicy>

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在OBS管理控制台桶列表中，单击待操作的桶，进入“对象”页面。
3. 在左侧导航栏，单击“概览”，进入“概览”页面。
4. 在“基础配置”区域下，单击“生命周期规则”卡片，系统跳转至“生命周期规则”界面。

   或您可以直接在左侧导航栏单击“基础配置>生命周期规则”，进入“生命周期规则”界面。

5. 单击“创建”，系统弹出如图6所示对话框。
   图6 创建生命周期规则
   

6. 配置生命周期管理规则。
   基本信息：

   • “状态”：选中“启用”，启用本条生命周期规则。
   • “规则名称”：用于识别不同的生命周期配置，其长度需不超过255字符。
   • “前缀”：可选。
     • 填写前缀：满足该前缀的对象将受生命周期规则管理，输入的对象前缀不能包括\:*?"<>|特殊字符，不能以/开头，不能两个/相邻。
     • 未填写前缀：桶内所有对象都将受生命周期规则管理。

   

   • 当按前缀配置时，如果指定的前缀名与某条已配置的生命周期规则指定的前缀名存在包含关系，OBS会将两条规则视为同一条，而禁止您配置本条规则。例如，系统中已存在指定前缀名为“abc”的规则，则不允许再配置指定前缀以“abc”字段开头的规则。
   • 如果已存在按前缀配置的生命周期规则，则不允许再新增配置到整个桶的规则。

   当前版本或历史版本：

   • 如果桶开启过“多版本控制”，配置界面可见“当前版本”和“历史版本”。

     “历史版本”配置项默认不展示，只有当桶开启过“多版本控制”，即多版本控制状态为“已启用”或“暂停”时才会展示。

   

   • “当前版本”与“历史版本”是针对“多版本控制”而言的。如果开启了“多版本控制”功能，同名的对象上传到同一路径下时，则会产生不同的版本号。最新版本的对象称之为“当前版本”，历史时间上传的对象称之为“历史版本”。当前版本和历史版本的详细介绍请参见多版本控制。
   • “当前版本”与“历史版本”至少配置一个，也可以两个版本同时配置。
   • 转换为低频访问存储天数：指定在对象最后一次更新后多少天，受规则影响的对象将转换为低频访问存储。至少设置为30天。
   • 转换为归档存储天数：指定在对象最后一次更新后多少天，受规则影响的对象将转换为归档存储。如果同时设置转换为低频访问存储和转换为归档存储，则转换为归档存储的时间要比转换为低频访问存储的时间至少长30天。如果单独设置转换为归档存储，则没有时间限制。
   • 转换为深度归档存储天数：指定在对象最后一次更新后多少天，受规则影响的对象将转换为深度归档存储。如果同时设置转换为低频访问存储和转换为深度归档存储，则转换为深度归档存储的时间要比转换为低频访问存储的时间至少长30天。如果同时设置转换为归档存储和转换为深度归档存储，则转换为深度归档存储的时间要比转换为归档存储的时间至少长90天。如果单独设置转换为深度归档存储，则没有时间限制。
   • 对象过期删除天数：指定在对象最后一次更新后多少天，受规则影响的对象将过期并自动被OBS删除。过期时间必须大于前两个转换时间的最大值，且必须为整数。
   • 碎片过期删除天数：指定桶内碎片在产生后多少天自动删除。
   例如，您于2015年1月7日在OBS中存储了以下几个文件：

   • log/test1.log
   • log/test2.log
   • doc/example.doc
   • doc/good.txt
   您于2015年1月10日在OBS中存储了以下几个文件：

   • log/clientlog.log
   • log/serverlog.log
   • doc/work.doc
   • doc/travel.txt

   如果您在2015年1月10日设置前缀为“log”的对象，过期删除的时间设置为一天，可能出现如下情况：

   • 1月7日上传的两个对象“log/test1.log”和“log/test2.log”，会在最近一次系统自动扫描后被删除，可能在1月10日当天，也可能在1月11日，这取决于系统的下一次扫描在何时进行。
   • 1月10日上传的两个对象“log/clientlog.log”和“log/serverlog.log”，每下一次系统扫描均会判断距上一次对象更新是否已满一天。如果已满一天，则在本次扫描时删除；如果未满一天，则会等到下次扫描再判断，直到满一天时删除，一般可能在1月11日或1月12日删除。

   如果您在某天设置前缀为“log”的对象，转换为低频访问存储的时间设置为30天，转换为归档存储的时间设置为60天，过期删除的时间设置为100天，OBS将会在“log/clientlog.log”、“log/serverlog.log”、“log/test1.log”和“log/test2.log”这四个对象上传满30天后转换为低频访问存储，满60天后转换为归档存储，满100天后自动删除。

   

   对象上传后，系统会将下一个UTC零点作为对象存储的起始时间开始计算生命周期。生命周期规则执行最长耗时24小时。因此，存储类别的转换以及过期被删除可能会存在延时，且一般不会超过48小时。配置生命周期规则后，如果期间修改了生命周期配置，会重新计算生效时间。

7. 单击“确定”，完成生命周期规则配置。

设置桶的生命周期

1. 登录OBS Browser+。
2. 选中待配置的桶，单击“更多 > 生命周期规则”，如图7所示。
   图7 生命周期规则
   

3. 在“生命周期规则”窗口中单击“创建”，如图8所示。
   图8 创建生命周期规则
   

4. 配置生命周期规则。
   • 状态：勾选“启用”，启用本条生命周期规则。
   • 规则名称：用于识别不同的生命周期配置，其长度需不超过255字符。
   • 策略：可根据对象名前缀进行匹配，满足该前缀的对象将受生命周期规则管理。也可将生命周期规则配置到整个桶，则桶内所有对象都将受生命周期规则管理。
   

   • 当按前缀配置时，如果指定的前缀名与某条已配置的生命周期规则指定的前缀名存在包含关系，OBS会将两条规则视为同一条，而禁止您配置本条规则。例如，系统中已存在指定前缀名为“abc”的规则，则不允许再配置指定前缀包含“abc”字段的规则。
   • 如果已存在按前缀配置的生命周期规则，则不允许再新增配置到整个桶的规则。
   • 如果已存在配置到整个桶的生命周期规则，则不允许再新增按前缀配置的规则，此时界面的“创建”按钮会变成灰色，表示不可操作。
   • 您可以指定在对象最后一次更新后多少天，受规则影响的对象将转换为低频访问存储、归档存储或者过期并自动被OBS删除。
     • 转换为低频访问存储：即您可以指定在对象最后一次更新后多少天，受规则影响的对象将转换为低频访问存储。
     • 转换为归档存储：即您可以指定在对象最后一次更新后多少天，受规则影响的对象将转换为归档存储。
     • 过期删除：可指定对象多少天后过期被自动删除，也可指定在具体某一天之后删除匹配规则的对象。

   例如，您于2022年1月7日在OBS中存储了以下几个文件：

   • log/test1.log
   • log/test2.log
   • doc/example.doc
   • doc/good.txt

   您又于2022年1月10日在OBS中存储了以下几个文件：

   • log/clientlog.log
   • log/serverlog.log
   • doc/work.doc
   • doc/travel.txt

     在2022年1月10日设置前缀为“log/”的对象，过期时间设置为一天，OBS将会在2022年1月12日自动删除“log/clientlog.log”、“log/serverlog.log”、“log/test1.log”和“log/test2.log”这四个对象。

     在今天设置前缀为“log”的对象，转换为低频访问存储的时间设置为30天，转换为归档存储的时间设置为60天，过期删除的时间设置为100天，OBS将会第31天将“log/clientlog.log”、“log/serverlog.log”、“log/test1.log”和“log/test2.log”这四个对象转换为低频访问存储，第61天后转换为归档存储，第101天后自动删除这些对象。

5. 在“生命周期管理”对话框中单击“确认”，保存当前的生命周期规则。