mc ilm tier update

支持的 S3 服务

mc ilm tier 仅 支持以下兼容 S3 的服务作为对象分层的远程目标：

• MinIO

• Amazon S3

• Google Cloud Storage

• Azure Blob Storage

所需权限

MinIO 要求在你创建生命周期管理规则的存储桶范围内，具备以下权限。

• s3:PutLifecycleConfiguration

• s3:GetLifecycleConfiguration

MinIO 还要求在集群上具备以下管理权限，以便为对象过渡生命周期管理规则创建远程层：

• admin:SetTier

• admin:ListTier

例如，以下策略授予在集群中任意存储桶上配置对象过渡生命周期管理规则的权限：

{
   "Version": "2012-10-17",
   "Statement": [
      {
            "Action": [
               "admin:SetTier",
               "admin:ListTier"
            ],
            "Effect": "Allow",
            "Sid": "EnableRemoteTierManagement"
      },
      {
            "Action": [
               "s3:PutLifecycleConfiguration",
               "s3:GetLifecycleConfiguration"
            ],
            "Resource": [
                        "arn:aws:s3:::*"
            ],
            "Effect": "Allow",
            "Sid": "EnableLifecycleManagementRules"
      }
   ]
}

{
   "Version": "2012-10-17",
   "Statement": [
      {
            "Action": [
               "s3:ListBucket"
            ],
            "Effect": "Allow",
            "Resource": [
               "arn:aws:s3:::MyDestinationBucket"
            ],
            "Sid": ""
      },
      {
            "Action": [
               "s3:GetObject",
               "s3:PutObject",
               "s3:DeleteObject"
            ],
            "Effect": "Allow",
            "Resource": [
               "arn:aws:s3:::MyDestinationBucket/*"
            ],
            "Sid": ""
      }
   ]
}

参数

该命令接受以下参数：

TARGET

Required

已配置 MinIO 部署的 alias。

TIER_NAME

Required

命令要修改的远程层名称。 该值对应于创建远程层时指定的 mc ilm tier add TIER_NAME。

--access-key

Optional

远程 S3 或 MinIO 层上某个用户的 access key。 该用户必须具备在远程存储桶或存储桶前缀上执行 read/write/list/delete 操作的权限。

此选项仅适用于 TIER_TYPE 为 s3 或 minio 的远程存储层。 对其他 TIER_TYPE，此选项无效。

--secret-key

Optional

远程 s3 或 minio 层上某个用户的 secret key。

此选项仅适用于 TIER_TYPE 为 s3 或 minio 的远程存储层。 对其他 TIER_TYPE，此选项无效。

--use-aws-role

Optional

使用本地已配置的 AWS Role 的访问权限。

此选项仅在 TIER_TYPE 为 s3 或 minio 时适用。 对其他 TIER_TYPE 值，此选项无效。

--account-key

Optional

远程 Azure 层上某个用户的 account key。

Azure 层类型必填。

使用此选项轮换与远程层关联的 --account-name 的凭证。

此选项仅适用于 TIER_TYPE 为 azure 的远程存储层。 对其他登录类型，此选项无效。

--az-sp-tenant-id

Optional

New in version mc: RELEASE.2024-07-03T20-17-25Z

Azure service principal account 的 Directory ID。

此选项仅适用于 TIER_TYPE 为 azure 的远程存储层。 对其他登录类型，此选项无效。

--az-sp-client-id

Optional

New in version mc: RELEASE.2024-07-03T20-17-25Z

Azure service principal account 的 Client ID。

需要 --az-sp-client-secret。

此选项仅适用于 TIER_TYPE 为 azure 的远程存储层。 对其他登录类型，此选项无效。

--az-sp-client-secret

Optional

New in version mc: RELEASE.2024-07-03T20-17-25Z

Azure service principal account 的 secret。

需要 --az-sp-client-id。

此选项仅适用于 TIER_TYPE 为 azure 的远程存储层。 对其他登录类型，此选项无效。

--credentials-file

Optional

Google Cloud Storage 层类型必填。

远程 GCS 层上某个用户的凭证文件。 该用户必须具备在远程存储桶或存储桶前缀上执行 read/write/list/delete 操作的权限。

此选项仅适用于 TIER_TYPE 为 gcs 的远程存储层。 对其他登录类型，此选项无效。

全局标志

此命令支持 全局标志 中的任意选项。

轮换 S3 远程层凭证

以下示例更新 myminio 部署上名为 S3TIER 的 S3 远程层凭证。

mc ilm tier update myminio S3TIER --access-key ACCESS_KEY --secret-key SECRET_KEY

• 将 S3TIER 替换为你的 Amazon Simple Storage Solution 层名称。

• 将 ACCESS_KEY 替换为你的 S3 存储更新后的 access key。

• 将 SECRET_KEY 替换为上面提供的 access key 对应的更新后 secret key。

轮换 Azure Blob Storage 远程层凭证

以下示例更新 myminio 部署上名为 AXTIER 的 Azure 远程层凭证。

mc ilm tier update myminio AZTIER --account-key ACCOUNT-KEY

• 将 AZTIER 替换为你的 Azure 层名称。

• 将 ACCOUNT-KEY 替换为你的 Azure 存储更新后的密钥。

轮换 Google Cloud Storage 远程层凭证

以下示例更新 myminio 部署上名为 GCSTIER 的 Google Cloud Storage 远程层凭证。

 mc ilm tier update myminio GCSTIER --credentials-file /path/to/credentials.json

• 将 GCSTIER 替换为你的 Google Cloud Storage 层名称。

• 将 /path/to/credentials.json 替换为用于访问远程存储的更新后凭证文件路径。

S3 兼容性

mc 命令行工具以兼容 AWS S3 API 为目标构建，并针对 MinIO 和 AWS S3 进行了测试，以验证预期的功能与行为。

对于其他 S3 兼容服务，MinIO 不提供任何保证，因为这些服务的 S3 API 实现未知， 因此不在支持范围内。虽然 mc 命令 可能 仍能按文档说明工作，但此类 用法需要你自行承担风险。