KRM API 对象。gdc.goog/v1

object.gdc.goog/v1

包含对象存储 v1 API 组的 API 架构定义。

存储桶

定义了 Buckets API 的架构。

来源: - BucketList

字段 说明
apiVersion 字符串 object.gdc.goog/v1
kind 字符串 Bucket
metadata ObjectMeta 如需了解 metadata 的字段,请参阅 Kubernetes API 文档。
spec BucketSpec
status BucketStatus

BucketInfo

定义 BucketInfo API 的架构。

来源: - BucketInfoList

字段 说明
apiVersion 字符串 object.gdc.goog/v1
kind 字符串 BucketInfo
metadata ObjectMeta 如需了解 metadata 的字段,请参阅 Kubernetes API 文档。
spec BucketInfoSpec
status BucketInfoStatus

BucketInfoList

包含 BucketInfo 的列表。

字段 说明
apiVersion 字符串 object.gdc.goog/v1
kind 字符串 BucketInfoList
metadata ListMeta 如需了解 metadata 的字段,请参阅 Kubernetes API 文档。
items BucketInfo 数组

BucketInfoSpec

BucketInfoSpec 定义 BucketInfo 资源的期望状态。

来源: - BucketInfo

字段 说明
description 字符串 存储桶内容的说明。
storageClass ObjectStorageClass 定义了需要访问数据的频率。可用选项包括 StandardNearlineStandard 适合频繁访问的热数据,例如网站、流式视频和移动应用。它适用于至少可存储 30 天的数据。Nearline 适合至少可存储 60 天的数据,包括数据备份和长尾多媒体内容。
bucketPolicy GlobalBucketPolicy 定义了存储桶资源的政策。如果未指定,则应用默认政策。
location 字符串 定义了存储桶中的对象数据所在的物理位置。如果未指定,则默认为创建相应存储桶的位置。
bucketName 字符串 已配置存储桶的非命名空间名称。在本地工具和库中使用时,此变量用于指代相应存储桶。
zonalEndpoints 字符串数组 存储桶可访问的可用区级 DNS 端点。如果需要自定义故障切换,请使用这些端点。
globalEndpoint 字符串 全球端点,可将流量动态路由到包含相应存储桶数据的任何可用区。如果需要自动故障切换,请使用此端点。
region 字符串 存储桶所在的区域。
encryption EncryptionStatus 相应存储桶的加密状态。
allowDegradedWrites 布尔值 仅用于同步存储分区。确定是否应因某个复制可用区不可用而将 S3 操作恢复为异步复制。这样可以防止同步存储分区在其中一个复制区域出现故障时变为只读。如果为空,则默认为 false。

BucketInfoStatus

定义观察到的 BucketInfo 状态。

来源: - BucketInfo

字段 说明
conditions 条件数组

BucketList

包含一个 Bucket 列表。

字段 说明
apiVersion 字符串 object.gdc.goog/v1
kind 字符串 BucketList
metadata ListMeta 如需了解 metadata 的字段,请参阅 Kubernetes API 文档。
items 存储分区数组

BucketPolicy

定义相应存储分区的政策。

来源: - BucketSpec

字段 说明
lockingPolicy LockingPolicy 对象锁定政策。如果设置了此属性,则会启用对象版本控制,并且存储桶中存储的所有对象都将受此政策的约束。在锁定过期之前,无法删除已锁定的对象。只能在创建存储桶时启用,之后无法停用。如果未启用,对象锁定和版本控制功能将被停用,并且无法启用。
corsPolicy CorsPolicy 为存储桶设置的自定义 CORS 政策的用户政策。如果需要在存储分区上添加 CORS 政策,则必须启用 CorsPolicy。否则,存储桶将仅具有默认的界面控制台 CORS 政策。创建存储桶后,您可以随时添加或修改 CorsPolicy。
lifecyclePolicy LifecyclePolicy 为存储桶设置的自定义生命周期政策的用户政策。创建存储桶后,您可以随时添加、修改或移除 LifecyclePolicy。

BucketSpec

BucketSpec 定义 Bucket 资源的期望状态。

来源: - 存储分区

字段 说明
description 字符串 存储桶内容的说明。
storageClass ObjectStorageClass 定义了需要访问数据的频率。可用选项包括 StandardNearlineStandard 适合频繁访问的热数据,例如网站、流式视频和移动应用。它适用于至少可存储 30 天的数据。Nearline 适合至少可存储 60 天的数据,包括数据备份和长尾多媒体内容。
bucketPolicy BucketPolicy 定义了存储桶资源的政策。如果未指定,则应用默认政策。
location 字符串 定义了存储桶中的对象数据所在的物理位置。如果未指定,则默认为创建相应存储桶的位置。

BucketStatus

定义观察到的 Bucket 状态。

来源: - 存储分区

字段 说明
fullyQualifiedName 字符串 已配置的存储桶的名称。在使用外部工具和库时,此名称用于指代相应存储桶。
conditions 条件数组 指定相应存储桶的状态。支持的条件包括 BucketReady。如果 BucketReady 为 True,则表示相应存储桶已完成配置,可以正常使用。
endpoint 字符串 存储桶可访问的 DNS 端点。
region 字符串 存储桶所在的区域。
encryption EncryptionStatus 相应存储桶的加密状态。
errorStatus ErrorStatus ErrorStatus 包含最近的错误,并附带观测时间。

CorsPolicy

定义在存储桶上设置自定义 CORS 政策的策略。

来源: - BucketPolicy - GlobalBucketPolicy

字段 说明
enableCorsPolicy 布尔值 定义用户是否希望自定义政策对相应存储桶生效。如果为 true,系统将读取在 CorsDetail 中定义的自定义政策。否则,即使设置了自定义政策,也不会使用 CorsDetail。
corsDetail CorsRule 数组 正在设置的自定义 CORS 政策的详细信息。

CorsRule

定义与 CORS 规则相关的信息。

来源: - CorsPolicy

字段 说明
allowedHeaders 字符串数组 Access-Control-Request-Headers 标头中指定的标头。
allowedMethods 字符串数组 允许的来源可以执行的 HTTP 方法。
allowedOrigins 字符串数组 可以访问相应存储桶的来源。
exposeHeaders 字符串数组 响应中可访问的标头。
id 字符串 规则的唯一标识符。该值不得超过 255 个字符。

EncryptionStatus

EncryptionStatus 定义了相应存储桶的加密状态。

显示在: - BucketInfoSpec - BucketStatus

字段 说明
type EncryptionType 定义要用于相应存储桶的加密类型。可用的选项包括:- CMEK - 客户管理的加密密钥,用于创建以 HSM 为根的 KMS 支持的密钥,客户需要为此付费。 客户可以通过 KMS 访问和管理这些密钥。
keyRef ObjectReference KeyRef 引用用作默认密钥的密钥,以加密存储桶中的对象。

GlobalBucketPolicy

定义相应存储分区的政策。

来源: - BucketInfoSpec

字段 说明
corsPolicy CorsPolicy 为存储桶设置的自定义 CORS 政策的用户政策。如果需要在存储分区上添加 CORS 政策,则必须启用 CorsPolicy。否则,存储桶将仅具有默认的界面控制台 CORS 政策。创建存储桶后,您可以随时添加或修改 CorsPolicy。
lifecyclePolicy LifecyclePolicy 为存储桶设置的自定义生命周期政策的用户政策。创建存储桶后,您可以随时添加、修改或移除 LifecyclePolicy。

LifecycleExpiration

来源: - LifecycleRule

字段 说明
date 时间 应删除对象的具体日期。
days 整数 相应对象受相应规则约束的天数。

LifecycleNoncurrentExpiration

来源: - LifecycleRule

字段 说明
noncurrentDays 整数 对象成为非当前版本后,生命周期规则采取相应操作之前的天数。

LifecyclePolicy

来源: - BucketPolicy - GlobalBucketPolicy

字段 说明
enable 布尔值 定义用户是否希望在存储桶上启用自定义生命周期政策。
lifecycleRules LifecycleRule 数组 包含一条或多条生命周期配置规则,这些规则可以对存储桶中的对象执行过期操作。

LifecycleRule

来源: - LifecyclePolicy

字段 说明
id 字符串 规则的唯一标识符。值不能超过 255 个字符。
status LifecycleRuleStatus 生命周期规则的状态。指明相应规则是否会采取行动。状态可以随时更改,只有“已启用”的规则才会生效。
expiration LifecycleExpiration 当前版本中对象的过期行为。应提供 Expiration 和/或 NoncurrentExpiration。没有过期行为的规则会被忽略。
noncurrentExpiration LifecycleNoncurrentExpiration 非当前对象的过期行为。
filter LifecycleRuleFilter 过滤规则。空过滤条件表示该规则适用于存储桶中的所有对象。

LifecycleRuleFilter

定义可针对生命周期规则设置的过滤条件。

来源: - LifecycleRule

字段 说明
prefixFilter 字符串 匹配具有所提供前缀的对象。空字符串前缀表示应用于存储桶中的所有对象。
tagFilters 标记数组 匹配具有所提供标记的对象。对象上的标记必须与键和值完全匹配。

LifecycleRuleStatus

基础类型string

来源: - LifecycleRule

LockingPolicy

定义锁定相应存储分区对象的策略。

来源: - BucketPolicy

字段 说明
defaultObjectRetentionDays 整数 指定每个对象的所有版本将保留的最短天数。在保留期限内,无法删除对象。如果存储桶包含任何对象,也无法删除。如果未指定,则不会设置默认的对象保留期限。可以在创建后进行修改,但更改只会对新对象和版本生效。现有对象和版本仍将使用之前的值。

标记

定义可供生命周期过滤器使用的对象的标记。

来源: - LifecycleRuleFilter

字段 说明
key 字符串
value 字符串