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

必需

Thealias已配置的 MinIO 部署。

TIER_NAME

必需

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

--access-key

可选

远程 S3 或 MinIO 层级上用户的访问密钥。 该用户必须拥有对远程存储桶或存储桶前缀执行读/写/列表/删除操作的权限。

此选项仅适用于远程存储层级TIER_TYPE is s3 or minio此选项对其他任何情况都没有影响TIER_TYPE.

--secret-key

可选

远程用户的密钥s3 or minio层。

此选项仅适用于远程存储层级TIER_TYPE is s3 or minio此选项对其他任何情况都没有影响TIER_TYPE.

--use-aws-role

可选

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

此选项仅在以下情况下适用：TIER_TYPE is s3 or minio此选项对其他任何值均无效TIER_TYPE.

--account-key

可选

远程 Azure 层级上的用户帐户密钥。

必需对于 Azure 层级类型。

使用此选项来轮换凭据--account-name与远程层相关联。

此选项仅适用于远程存储层级TIER_TYPE is azure此选项对其他任何类型的登录都没有影响。

--az-sp-tenant-id

可选

版本 mc 中的新功能：RELEASE.2024-07-03T20-17-25Z

Azure 服务主体帐户的目录 ID。

此选项仅适用于远程存储层级TIER_TYPE is azure此选项对其他任何类型的登录都没有影响。

--az-sp-client-id

可选

版本 mc 中的新功能：RELEASE.2024-07-03T20-17-25Z

Azure 服务主体帐户的客户端 ID。

需要--az-sp-client-secret.

此选项仅适用于远程存储层级TIER_TYPE is azure此选项对其他任何类型的登录都没有影响。

--az-sp-client-secret

可选

版本 mc 中的新功能：RELEASE.2024-07-03T20-17-25Z

Azure 服务主体帐户的密钥。

需要--az-sp-client-id.

此选项仅适用于远程存储层级TIER_TYPE is azure此选项对其他任何类型的登录都没有影响。

--credentials-file

可选

必需针对 Google Cloud Storage 层级类型。

远程 GCS 层级上的用户凭据文件。 该用户必须拥有对远程存储桶或存储桶前缀执行读/写/列表/删除操作的权限。

此选项仅适用于远程存储层级TIER_TYPE is gcs此选项对其他任何类型的登录都没有影响。

全局标志

此命令支持任何全局标志.

为 S3 远程层级轮换凭据

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

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

• 替换S3TIER使用您的 Amazon Simple Storage Solution 层级的名称。

• 替换ACCESS_KEY使用更新后的 S3 存储访问密钥。

• 替换SECRET_KEY使用提供的访问密钥更新后的密钥。

为 Azure Blob 存储远程层轮换凭据

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

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

• 替换AZTIER使用您的 Azure 层级名称。

• 替换ACCOUNT-KEY使用更新后的 Azure 存储密钥。

为 Google Cloud 存储远程层轮换凭据

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

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

• 替换GCSTIER使用您的 Google Cloud Storage 层级的名称。

• 替换/path/to/credentials.json使用更新后的凭据文件路径来访问远程存储。

S3 Compatibility

Themc命令行工具专为兼容 AWS S3 API 而构建，并已通过 MinIO 和 AWS S3 测试，确保功能与行为符合预期。

MinIO 不提供对其他 S3 兼容服务的保证，因为它们的 S3 API 实现方式未知，因此不受支持。尽管mc命令可能按文档所述工作，任何此类使用风险自负。