文档

MinIO 自定义资源定义

MinIO Operator 会安装一个 Custom Resource Definition (CRD),用于描述 MinIO Tenant 对象。 Operator 使用该 CRD 在 Kubernetes 集群中对 Tenant 资源进行配置和管理。

本页提供 CRD 参考文档,用于自定义由 Operator 部署的 Tenant。 本文档默认读者已熟悉其中引用的 Kubernetes 概念、工具和流程。

Operator CRD v2 参考

Package v2 - 本页提供 MinIO Operator Operator CRD v2 Reference CRD 的自动生成快速参考。 如需更完整的 MinIO Operator CRD 文档,请参阅 MinIO Kubernetes Documentation

Operator CRD v2 Reference API 随 MinIO Operator v4.0.0 一同发布。 MinIO Operator 会自动将使用 /v1 API 的现有租户转换为 /v2

Bucket

Bucket 描述默认创建的存储桶。

字段 说明

name string

region string

objectLock boolean

CertificateConfig

CertificateConfig (certConfig) 定义了在创建租户过程中由 Operator 自动生成的 TLS 证书的控制属性。 如果 spec.autoCert: false,这些字段不会生效。

字段 说明

commonName string

可选

与自动生成的 TLS 证书关联的 CommonNameCN 属性。

organizationName string array

可选

指定一个或多个与自动生成 TLS 证书关联的 OrganizationNameO 属性。

dnsNames string array

可选

指定一个或多个与自动生成 TLS 证书关联的 x.509 Subject Alternative Names (SAN)。MinIO Server Pod 会根据请求的主机名使用 SNI 判断应返回哪个证书。

CertificateStatus

CertificateStatus 用于跟踪由 Operator 管理的所有证书。

字段 说明

autoCertEnabled boolean

AutoCertEnabled 用于记录我们是否已知该租户启用了 autocert。

customCertificates CustomCertificates

提供手动添加到 Operator 的 clientminiominioCAs 自定义 TLS 证书的信息。

CustomCertificateConfig

CustomCertificateConfig (customCertificateConfig) 提供在创建租户过程中 手动添加到 Operator 的 TLS 证书相关属性。 如果不存在自定义 TLS 证书,这些字段不包含数据。

字段 说明

certName string

可选

输出与手动提供的 TLS 证书关联的一个或多个 CertName 属性。

domains string array

可选

输出与手动提供的 TLS 证书关联的一个或多个 Domains 属性。

expiry string

可选

输出与手动提供的 TLS 证书关联的一个或多个 Expiry 属性。

expiresIn string

可选

输出与手动提供的 TLS 证书关联的一个或多个 ExpiresIn 属性。

serialNo string

可选

输出与手动提供的 TLS 证书关联的一个或多个 SerialNo 属性。

CustomCertificates

CustomCertificates (customCertificates) 提供在创建租户过程中 手动添加到 Operator 的 TLS 证书分组。 如果不存在自定义 TLS 证书,这些字段不包含数据。

字段 说明

client CustomCertificateConfig array

可选

客户端

minio CustomCertificateConfig array

可选

MinIO

minioCAs CustomCertificateConfig array

可选

证书颁发机构

ExposeServices

ExposeServices (exposeServices) 定义 MinIO 对象存储和 Console 服务的暴露方式。

字段 说明

minio boolean

可选

指示 Operator 暴露 MinIO 服务。默认为 false

console boolean

可选

指示 Operator 暴露 MinIO Console 服务。默认为 false

Features

Features (features) - 描述要在 MinIO 租户中启用或禁用哪些 MinIO 功能的对象。

字段 说明

bucketDNS boolean

可选

指定 true 以允许客户端使用 DNS 路径 <bucket>.minio.default.svc.cluster.local 访问存储桶。默认为 false

domains TenantDomains

可选

指定用于访问 MinIO 和 Console 的域名列表。

enableSFTP boolean

可选

以启用 SFTP 支持的方式启动 minio server。

HealthStatus (string)

HealthStatus 表示租户是否处于健康、服务降级或离线状态。

KESConfig

KESConfig (kes) 定义作为 MinIO 租户一部分部署的 MinIO Key Encryption Service (KES) StatefulSet 配置。 KES 支持使用外部密钥管理服务 (KMS) 对对象执行服务端加密。

字段 说明

replicas integer

可选

指定要在租户中部署的 KES Pod 副本数量。 默认为 2

image string

可选

imagePullPolicy PullPolicy

可选

MinIO Docker 镜像的拉取策略。可指定以下值:

  • Always

  • Never

  • IfNotPresent(默认)

详细信息请参阅 Kubernetes 文档:https://kubernetes.io/docs/concepts/containers/images#updating-images

serviceAccountName string

可选

用于运行作为租户一部分创建的 MinIO KES Pod 的 Kubernetes Service Account

kesSecret LocalObjectReference

必填

指定一个包含环境变量的 Kubernetes opaque secret,用于设置 MinIO KES 服务。

示例请参阅 MinIO Operator console-secret.yaml

externalCertSecret LocalCertificateReference

可选

为租户中的每个 MinIO KES Pod 启用带 SNI 支持的 TLS。 如果省略 externalCertSecret spec.requestAutoCert 设置为 false, 则 MinIO KES Pod 会在 未启用 TLS 的情况下部署。

指定一个 Kubernetes TLS secret。MinIO Operator 会将指定证书复制到租户中的每个 MinIO Pod。 当 MinIO Pod/Service 响应 TLS 连接请求时,会使用 SNI 选择 subjectAlternativeName 匹配的证书。

指定一个包含以下字段的对象:

  • - name - 包含 TLS 证书的 Kubernetes secret 名称。

  • - type - 指定 kubernetes.io/tls

有关为 MinIO 租户配置 TLS 的示例和更完整文档, 请参阅 MinIO Operator CRD 参考。

clientCertSecret LocalCertificateReference

可选

指定一个包含自定义根证书颁发机构和 x.509 证书的 Kubernetes TLS secret,用于与外部 Key Management Service (例如 Hashicorp Vault)执行 mTLS 认证。

指定一个包含以下字段的对象:

  • - name - 包含证书颁发机构和 x.509 证书的 Kubernetes secret 名称。

  • - type - 指定 kubernetes.io/tls

gcpCredentialSecretName string

可选

指定 KES 用于向 GCP key store 进行身份验证的 GCP 默认凭证

gcpWorkloadIdentityPool string

可选

指定 workload identity pool 名称(生成 service account token 时必需)

annotations object (keys:string, values:string)

可选

如果提供,则将这些 annotations 用于 KES 对象元数据注解。

labels object (keys:string, values:string)

可选

如果提供,则将这些 labels 用于 KES 对象元数据标签。

resources ResourceRequirements

可选

用于在 MinIO 租户中指定 CPU 和内存 resource allocations 或限制的对象规范。

nodeSelector object (keys:string, values:string)

可选

Operator 在选择要部署 MinIO KES Pod 的节点时应用的筛选条件。 Operator 仅会选择标签与指定 selector 匹配的节点。

更多信息请参阅 Kubernetes 文档中的 Assigning Pods to Nodes

tolerations Toleration array

可选

指定一个或多个要应用到 MinIO KES Pod 的 Kubernetes tolerations

affinity Affinity

可选

为 KES Pod 指定 node affinity、pod affinity 和 pod anti-affinity。

topologySpreadConstraints TopologySpreadConstraint array

可选

指定一个或多个要应用到 MinIO 池中部署 Pod 的 Kubernetes Topology Spread Constraints

keyName string

可选

如果提供,则将其用作 KES 在 KMS 后端创建的密钥名称。

securityContext PodSecurityContext

指定 MinIO KES Pod 的 Security Context。 Operator 仅支持以下 Pod 安全字段:

  • fsGroup

  • fsGroupChangePolicy

  • runAsGroup

  • runAsNonRoot

  • runAsUser

  • seLinuxOptions

containerSecurityContext SecurityContext

指定 MinIO KES Pod 的 Security Context

env EnvVar array

可选

如果提供,MinIO Operator 在部署 KES 资源时会添加指定的环境变量。

LocalCertificateReference

LocalCertificateReference (externalCertSecret, externalCaCertSecret,clientCertSecret) 包含一个 Kubernetes secret, 其中存放用于在 MinIO 租户中启用 TLS 的 TLS 证书或证书颁发机构文件。

字段 说明

name string

必填

包含 TLS 证书或证书颁发机构文件的 Kubernetes secret 名称。

type string

必填

Kubernetes secret 的类型。指定 kubernetes.io/tls

Logging

Logging 描述 MinIO 租户的日志记录。

字段 说明

json boolean

anonymous boolean

quiet boolean

Pool

Pool (pools) 定义租户上的一个 MinIO server pool。 每个 pool 由一组 MinIO server Pod 组成, 这些 Pod 通过“池化”其存储资源来支持对象存储和检索请求。 每个 server pool 都独立于其他 pool, 并支持对 MinIO 租户中可用存储资源进行水平扩展。

有关 pools 对象的示例和更完整文档,请参阅 MinIO Operator CRD 参考。

字段 说明

name string

必填 指定 pool 名称。 如果省略此字段,Operator 会自动生成 pool 名称。

servers integer

必填

要在该 pool 中部署的 MinIO server Pod 数量。最小值为 2

MinIO Operator 要求每个 pool 至少有 4 个卷。 具体来说, pools.servers X pools.volumesPerServer 的结果必须大于 4

volumesPerServer integer

必填

为该 pool 中每个 MinIO server Pod 生成的 Persistent Volume Claim 数量。

MinIO Operator 要求每个 pool 至少有 4 个卷。 具体来说, pools.servers X pools.volumesPerServer 的结果必须大于 4

volumeClaimTemplate PersistentVolumeClaim

必填

指定 MinIO Operator 为 MinIO 租户生成 Persistent Volume Claim 时使用的配置选项。

resources ResourceRequirements

可选

用于在 MinIO 租户中指定 CPU 和内存 resource allocations 或限制的对象规范。

nodeSelector object (keys:string, values:string)

可选

Operator 在选择要在哪些节点部署该 pool Pod 时应用的筛选条件。 Operator 仅会选择标签与指定 selector 匹配的节点。

更多信息请参阅 Kubernetes 文档中的 Assigning Pods to Nodes

affinity Affinity

可选

为 MinIO pool 中的 Pod 指定 node affinity、pod affinity 和 pod anti-affinity。

tolerations Toleration array

可选

指定一个或多个要应用到 MinIO pool 中部署 Pod 的 Kubernetes tolerations

topologySpreadConstraints TopologySpreadConstraint array

可选

指定一个或多个要应用到 MinIO pool 中部署 Pod 的 Kubernetes Topology Spread Constraints

securityContext PodSecurityContext

可选

指定 pool 中 Pod 的 Security Context。 Operator 仅支持以下 Pod 安全字段:

  • fsGroup

  • fsGroupChangePolicy

  • runAsGroup

  • runAsNonRoot

  • runAsUser

containerSecurityContext SecurityContext

指定 pool 中容器的 Security Context。 Operator 仅支持以下容器安全字段:

  • runAsGroup

  • runAsNonRoot

  • runAsUser

annotations object (keys:string, values:string)

可选

指定要追加到 Pool 的自定义 labels 和 annotations。 可选

如果提供,则将这些 annotations 用于 Pool 对象元数据注解 (StatefulSet 和 Pod 模板)。

labels object (keys:string, values:string)

可选

如果提供,则将这些 labels 用于 Pool 对象元数据标签 (StatefulSet 和 Pod 模板)。

runtimeClassName string

可选

如果提供,StatefulSet 中的每个 Pod 都将使用指定的 RuntimeClassName 运行。 更多信息请参阅 https://kubernetes.io/docs/concepts/containers/runtime-class/

PoolState (string)

PoolState 表示 pool 的状态。

PoolStatus

PoolStatus 用于跟踪所有 pool 及其当前状态。

字段 说明

ssName string

state PoolState

legacySecurityContext boolean

LegacySecurityContext 表示旧版 SecurityContext。它表示该 pool 创建于 v4.2.3 之前, 当时我们引入了默认的非 root securityContext, 因此应继续在不设置 Security Context 的情况下运行此 pool。

PoolsMetadata

PoolsMetadata (poolsMetadata) 为 MinIO pool statefulset / pod 定义自定义 labels 和 annotations。

字段 说明

labels object (keys:string, values:string)

可选

如果提供,则将这些 labels 追加到 MinIO statefulset / pod。

annotations object (keys:string, values:string)

可选

如果提供,则将这些 annotations 追加到 MinIO statefulset / pod。

ServiceMetadata

ServiceMetadata (serviceMetadata) 为 MinIO Object Storage 服务 和/或 MinIO Console 服务定义自定义 labels 和 annotations。

字段 说明

minioServiceLabels object (keys:string, values:string)

可选

如果提供,则将这些 labels 追加到 MinIO 服务。

minioServiceAnnotations object (keys:string, values:string)

可选

如果提供,则将这些 annotations 追加到 MinIO 服务。

consoleServiceLabels object (keys:string, values:string)

可选

如果提供,则将这些 labels 追加到 Console 服务。

consoleServiceAnnotations object (keys:string, values:string)

可选

如果提供,则将这些 annotations 追加到 Console 服务。

kesServiceLabels object (keys:string, values:string)

可选

如果提供,则将这些 labels 追加到 KES 服务。

kesServiceAnnotations object (keys:string, values:string)

可选

如果提供,则将这些 annotations 追加到 KES 服务。

SideCars

SideCars (sidecars) 定义了一个容器列表, Operator 会将其附加到 pool 中的每个 MinIO server Pod。

字段 说明

containers Container array

可选

要在 Pod 内运行的容器列表。

volumeClaimTemplates PersistentVolumeClaim array

可选

volumeClaimTemplates 是 Pod 允许引用的 claim 列表。 StatefulSet controller 负责以保持 Pod 身份的方式将网络身份映射到 claim。 该列表中的每个 claim 都必须在模板中的某个容器里至少有一个同名的 volumeMount 与之匹配。对于同名项,此列表中的 claim 优先于模板中的任意 volume。

volumes Volume array

可选

可由该 Pod 所属容器挂载的 volume 列表。 更多信息:https://kubernetes.io/docs/concepts/storage/volumes

resources ResourceRequirements

可选

sidecar 的资源配置;如果设置,initcontainer 也会使用该配置。

Tenant

Tenant 是一个 Kubernetes object 对象,用于描述 MinIO 租户。

字段 说明

apiVersion string

Operator CRD v2 Reference

kind string

Tenant

metadata ObjectMeta

metadata 字段请参阅 Kubernetes API 文档。

scheduler TenantScheduler

spec TenantSpec

必填

MinIO 租户对象的根字段。

TenantDomains

TenantDomains (domains) - 用于从 Kubernetes 集群外部访问租户的域名列表。 这只会为列出的域名配置 MinIO,但仍需要额外的外部 DNS 配置。 如果使用了 schema 和端口,列出的域名应包含它们,例如 https://minio.domain.com:8123

字段 说明

minio string array

MinIO 使用的域名列表。 这将启用对象存储的 DNS 风格访问方式, 其中存储桶名称会从域名中的子域推导出来。

console string

用于暴露 MinIO Console 的域名。 这会在通过浏览器访问时为 MinIO 配置重定向。 如果 Console 通过子路径暴露,域名中也应包含该子路径,例如 https://console.domain.com:8123/subpath/

TenantScheduler

TenantScheduler (scheduler) - 描述用于部署 MinIO 租户的 Kubernetes Scheduler 的对象。

字段 说明

name string

可选

指定用于调度 Tenant Pod 的 Kubernetes scheduler 名称。

TenantSpec

TenantSpec (spec) 定义 MinIO 租户对象的配置。

以下参数特指作为 MinIO Operator v4.0.0 一部分引入的 Operator CRD v2 Reference MinIO CRD API spec 定义。

有关该对象的更完整文档,请参阅 MinIO Kubernetes Documentation

字段 说明

pools Pool array

必填

描述部署在 MinIO 租户中的各个 MinIO server pool 的对象数组。 每个 pool 由一组 MinIO server Pod 组成,这些 Pod 通过汇聚其存储资源来支持对象存储和检索请求。 每个 server pool 都独立于其他 pool,并支持在 MinIO 租户中横向扩展可用存储资源。

MinIO 租户 specpools 数组 必须 至少包含 一个 元素。

有关 pools 对象的示例和更完整文档, 请参阅 MinIO Operator CRD 参考。

image string

可选

imagePullSecret LocalObjectReference

可选

指定从私有 Docker 仓库拉取镜像时使用的 Secret。

podManagementPolicy PodManagementPolicyType

可选

StatefulSet 创建 Pod 时使用的 Pod 管理策略。

env EnvVar array

可选

如果提供,MinIO Operator 在部署租户资源时会添加指定的环境变量。

externalCertSecret LocalCertificateReference array

可选

为租户中的每个 MinIO Pod 启用带 SNI 支持的 TLS。 如果省略 externalCertSecret requestAutoCert 设置为 false, 则 MinIO 租户会在 未启用 TLS 的情况下部署。

指定一个 Kubernetes TLS secret 数组。MinIO Operator 会将指定证书复制到租户中的每个 MinIO server Pod。当 MinIO Pod/Service 响应 TLS 连接请求时,会使用 SNI 选择 subjectAlternativeName 匹配的证书。

externalCertSecret 数组中的每个元素都是一个包含以下字段的对象:

  • - name - 包含 TLS 证书的 Kubernetes secret 名称。

  • - type - 指定 kubernetes.io/tls

有关为 MinIO 租户配置 TLS 的示例和更完整文档, 请参阅 MinIO Operator CRD 参考。

externalCaCertSecret LocalCertificateReference array

可选

允许 MinIO server Pod 验证由 Pod 信任存储之外的证书颁发机构签发的客户端 TLS 证书。

指定一个 Kubernetes TLS secret 数组。MinIO Operator 会将指定证书复制到租户中的每个 MinIO server Pod。

externalCertSecret 数组中的每个元素都是一个包含以下字段的对象:

  • - name - 包含证书颁发机构的 Kubernetes secret 名称。

  • - type - 指定 kubernetes.io/tls.

有关为 MinIO 租户配置 TLS 的示例和更完整文档, 请参阅 MinIO Operator CRD 参考。

externalClientCertSecret LocalCertificateReference

可选

在 MinIO 租户 Pod 与 MinIO KES 之间启用 mTLS 认证。 要启用 MinIO 租户与 MinIO KES 之间的连通性,此项为 必填

指定一个 Kubernetes TLS secret。MinIO Operator 会将指定证书复制到租户中的每个 MinIO server Pod。该 secret 必须 包含以下字段:

  • name - 包含 TLS 证书的 Kubernetes secret 名称。

  • type - 指定 kubernetes.io/tls

指定的证书 必须 对应 KES server 上的一个身份。 有关 KES 身份的更多信息,请参阅 KES Wiki

如果使用 MinIO Operator 部署 KES,请将该证书的哈希值作为 kes 对象规范的一部分。

有关为 MinIO 租户配置 TLS 的示例和更完整文档, 请参阅 MinIO Operator CRD 参考。

externalClientCertSecrets LocalCertificateReference array

可选

支持将额外客户端证书挂载到 MinIO 租户 Pod 中。 多个客户端证书将按以下目录结构挂载:

  • certs

  • * client-0

  • * * client.crt

  • * * client.key

  • * client-1

  • * * client.crt

  • * * client.key

  • * * client-2

  • * client.crt

  • * * client.key

指定一个 Kubernetes TLS secret。MinIO Operator 会将指定证书复制到租户中的每个 MinIO server Pod,之后可通过环境变量引用。该 secret 必须 包含以下字段:

  • name - 包含 TLS 证书的 Kubernetes secret 名称。

  • type - 指定 kubernetes.io/tls

mountPath string

可选

MinIO 卷(PV)的挂载路径。默认值为 /export

subPath string

可选

挂载路径内的子路径。这是 MinIO 存储数据的目录。 默认值为 ""(空)。

requestAutoCert boolean

可选

启用使用 基于 Kubernetes 的 TLS 证书生成 与签发机制,为 MinIO 租户中的 Pod 和 Service 生成并签发证书。

  • 指定 true 以显式启用自动证书生成(默认)。

  • 指定 false 以禁用自动证书生成。

如果 requestAutoCert 设置为 false 省略了 externalCertSecret, 则 MinIO 租户会在 未启用 TLS 的情况下部署。

有关为 MinIO 租户配置 TLS 的示例和更完整文档, 请参阅 MinIO Operator CRD 参考。

certExpiryAlertThreshold integer

CertExpiryAlertThreshold 表示在触发证书即将过期告警前,最少需要剩余的天数。

liveness Probe

用于容器存活性检查的 Liveness Probe。 如果探测失败,容器会重启。

readiness Probe

用于容器就绪性检查的 Readiness Probe。 如果探测失败,容器会从服务端点中移除。

startup Probe

Startup Probe 允许为 Pod 启动配置最长宽限期, 在此之前不会开始向其路由流量。

lifecycle Lifecycle

容器的 Lifecycle hook。

features Features

可启用或禁用与 S3 相关的功能,例如 bucketDNS 等。

certConfig CertificateConfig

可选

启用为 Operator 自动生成的所有 TLS 证书设置 CommonNameOrganizationdnsName 属性。 如果 requestAutoCertfalse, 则配置该对象不会生效。

kes KESConfig

可选

指示 MinIO Operator 使用指定配置部署 MinIO Key Encryption Service (KES)。 MinIO KES 支持在 MinIO 租户上对对象执行服务端加密。

prometheusOperator boolean

可选

指示 MinIO Operator 使用 Prometheus Operator。

租户的 scrape 配置会添加到由 prometheus-operator 管理的 Prometheus 中。

serviceAccountName string

可选

用于运行作为租户一部分创建的 MinIO Pod 的 Kubernetes Service Account

priorityClassName string

可选

指示 Pod 的优先级,即其相对于集群中其他 Pod 的重要程度。 这仅应用于 MinIO Pod。

更完整的文档请参阅 Kubernetes 的 Priority Class 文档

imagePullPolicy PullPolicy

可选

MinIO Docker 镜像的拉取策略。可指定以下值:

  • Always

  • Never

  • IfNotPresent(默认)

详细信息请参阅 Kubernetes 文档:https://kubernetes.io/docs/concepts/containers/images#updating-images

sideCars SideCars

可选

作为 sidecar 随租户中每个 MinIO Pod 一同运行的容器列表。

exposeServices ExposeServices

可选

指示 Operator 暴露 MinIO 和/或 Console 服务。

serviceMetadata ServiceMetadata

可选

指定要追加到 MinIO 服务和/或 Console 服务的自定义 labels 和 annotations。

poolsMetadata PoolsMetadata

可选

指定要追加到所有 pool StatefulSet 和 Pod 的自定义 labels 和 annotations。

users LocalObjectReference array

可选

一个用于在租户置备期间生成 MinIO 用户的 Kubernetes opaque secret 数组。

数组中的每个元素都是一个由键值对 name: <string> 组成的对象, 其中 <string> 引用一个 Kubernetes opaque secret。

每个被引用的 Kubernetes secret 都必须包含以下字段:

  • CONSOLE_ACCESS_KEY - MinIO 用户的“用户名”

  • CONSOLE_SECRET_KEY - MinIO 用户的“密码”

Operator 默认会为每个用户分配 consoleAdmin policy。 Tenant 启动后,你可以修改分配给它的 policy。

buckets Bucket array

可选

在创建新租户时创建存储桶。 如果给定名称的存储桶已存在,则跳过。

logging Logging

可选

为 MinIO 租户启用 JSON 和 Anonymous 日志。

configuration LocalObjectReference

可选

指定一个包含额外环境变量配置的 Secret,供 MinIO pool 使用。 该 Secret 应包含一个名为 config.env 的键, 其中包含 MinIO+ 的所有导出环境变量。

initContainers Container array

可选

向 StatefulSet 添加自定义 initContainer。

additionalVolumes Volume array

可选

如果提供,StatefulSet 将附加这些 volume。 你应为对应的 volume 和 volumeMount 设置规则。 Operator 不会验证这些规则,最终结果以 Kubernetes 为准。

additionalVolumeMounts VolumeMount array

可选

如果提供,StatefulSet 将附加这些 volume mount。 你应为对应的 volume 和 volumeMount 设置规则。 Operator 不会验证这些规则,最终结果以 Kubernetes 为准。

TenantUsage

TenantUsage 是关于租户使用量和容量的指标。

字段 说明

capacity integer

该租户的可用容量,单位为字节。

rawCapacity integer

该租户的原始容量,单位为字节。

usage integer

由 MinIO 管理的数据量,单位为字节。

rawUsage integer

磁盘上的原始使用量,单位为字节。

tiers TierUsage array

Tiers 包含租户中各个 tier 的使用情况。

TierUsage

TierUsage 表示租户配置的某个 tier 的使用情况。

字段 说明

Name string

tier 名称。

Type string

tier 类型。

totalSize integer

该 tier 的总使用量。