storj.io/minio@v0.0.0-20230509071714-0cbc90f649b1/docs/zh_CN/bucket/retention/README.md (about)

     1  # 对象锁定指南 [![Slack](https://slack.min.io/slack?type=svg)](https://slack.min.io)
     2  
     3  MinIO服务器允许针对特定的对象一次写入，多次读取 (WORM),或者通过使用默认的对象锁定配置设置存储桶，该配置将默认的保留模式和保留期限应用于所有对象。这将使存储桶中的对象不可改变，也就是说，直到存储桶的对象锁定配置或对象保留中指定的时间到期后，才允许删除版本。
     4  
     5  对象锁定要求在创建存储桶时启用锁定，而且还会自动在存储桶上启用版本控制。此外，可以在存储桶上配置默认保留期限和保留模式，以应用于该存储桶中创建的对象。
     6  
     7  和保留期限无关，一个对象也可以被依法保留。依法保留的对象将一直有效（不可变），直到通过API调用删除依法保留为止。
     8  
     9  ## 开始使用
    10  
    11  ### 1. 前置条件
    12  
    13  - 安装 MinIO - [MinIO快速入门指南](https://docs.min.io/cn/minio-quickstart-guide)
    14  - 安装 `awscli` - [Installing AWS Command Line Interface](https://docs.aws.amazon.com/zh_cn/cli/latest/userguide/cli-chap-install.html)
    15  
    16  ### 2. 设置存储桶WORM配置
    17  
    18  通过设置对象锁定配置可以启用存储桶的一次写入，多次读取 (WORM)模式。此配置将应用于存储桶中的现有对象和新对象。下面的例子设置了`Governance`模式，并且`mybucket`里的所有对象自创建时起，保留一天的时间。
    19  
    20  ```sh
    21  $ awscli s3api put-object-lock-configuration --bucket mybucket --object-lock-configuration 'ObjectLockEnabled=\"Enabled\",Rule={DefaultRetention={Mode=\"GOVERNANCE\",Days=1}}'
    22  ```
    23  
    24  ### 设置对象锁定
    25  
    26  PutObject API 可以通过`x-amz-object-lock-mode`和`x-amz-object-lock-retain-until-date`请求头设置每一个对象的保留模式和保留期限。这要比存储桶上设置的对象锁定配置优先级高。
    27  
    28  ```sh
    29  aws s3api put-object --bucket testbucket --key lockme --object-lock-mode GOVERNANCE --object-lock-retain-until-date "2019-11-20"  --body /etc/issue
    30  ```
    31  
    32  请参阅 https://docs.aws.amazon.com/zh_cn/AmazonS3/latest/dev/object-lock-overview.html 以获取有关对象锁定、governance bypass所需权限的AWS S3规范。
    33  
    34  ### 设置依法保留对象
    35  
    36  PutObject API 可以通过 `x-amz-object-lock-legal-hold` 请求头设置依法保留.
    37  
    38  ```sh
    39  aws s3api put-object --bucket testbucket --key legalhold --object-lock-legal-hold-status ON --body /etc/issue
    40  ```
    41  
    42  请参阅 https://docs.aws.amazon.com/zh_cn/AmazonS3/latest/dev/object-lock-overview.html 以获取有关对象锁定、指定依法保留所需的权限。
    43  
    44  ## 概念
    45  - 如果一个对象被依法保留,除非明确删除各个版本ID的依法保留，否则无法删除该对象。 DeleteObjectVersion() 会失败。
    46  - 在 `Compliance` 模式中, 在各个版本ID的保留期限到期之前，任何人都无法删除对象。如果用户具有必需的governance bypass权限，则可以在`Compliance`模式下延长对象的保留期限。
    47  - 一旦在一个存储桶上设置对象锁定设置后
    48    - 新对象会自动继承存储桶对象锁定配置的保留设置
    49    - 上传对象时可以选择是否设置保留头信息
    50    - 会对对象调用PutObjectRetention API
    51  - 如果不需要系统时间来设置保留日期，则可以将*MINIO_NTP_SERVER*环境变量设置为远程NTP server endpoint。
    52  - **对象锁定功能仅在纠删码和分布式纠删码模式下可用**。
    53  
    54  ## 进一步探索
    55  
    56  - [使用`mc`](https://docs.min.io/cn/minio-client-quickstart-guide)
    57  - [使用`aws-cli`](https://docs.min.io/cn/aws-cli-with-minio)
    58  - [使用`s3cmd`](https://docs.min.io/cn/s3cmd-with-minio)
    59  - [使用`minio-go`](https://docs.min.io/cn/golang-client-quickstart-guide)
    60  - [MinIO文档](https://docs.min.io/cn)