KRM API artifactregistry.gdc.goog/v1

artifactregistry.gdc.goog/v1

包含 Artifact Registry 组的 API 架构定义。

BackupConfig

表示一种内部消息类型，用于定义从此备份方案创建备份的配置。

显示在： - HarborInstanceBackupPlanSpec - HarborInstanceBackupSpec

字段	说明
backupRepository 字符串	用于标识相应 BackupPlan 资源的辅助存储空间的 BackupRepository 资源的名称。
backupScope BackupScope	备份的资源选择范围。

BackupPlanState

底层类型： string 备份方案可能处于的各种状态。

来源： - HarborInstanceBackupPlanStatus

BackupRepositoryState

底层类型： string 备份代码库可能处于的各种状态。

来源： - HarborInstanceBackupRepositoryStatus

BackupScope

定义要备份的 Harbor 实例。

来源： - BackupConfig

字段	说明
harborInstance 字符串	要在同一命名空间中备份的 Harbor 实例名称。

BackupState

底层类型： string 备份可能处于的各种状态。

来源： - HarborInstanceBackupStatus

HarborInstance

表示 Harbor 容器注册表的实例。

来源： - HarborInstanceList

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstance
metadata ObjectMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
spec HarborInstanceSpec	Harbor 实例的所需状态。
status HarborInstanceStatus	最近观察到的 Harbor 实例的状态。

HarborInstanceBackup

定义了 HarborInstance 的 Backup API 的架构。

来源： - HarborInstanceBackupList

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceBackup
metadata ObjectMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
spec HarborInstanceBackupSpec	备份的所需状态。
status HarborInstanceBackupStatus	最近观察到的备份状态。

HarborInstanceBackupList

表示 Harbor 实例的备份集合。

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceBackupList
metadata ListMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
items HarborInstanceBackup 数组

HarborInstanceBackupPlan

定义了 HarborInstance 的 BackupPlan API 的架构。

来源： - HarborInstanceBackupPlanList

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceBackupPlan
metadata ObjectMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
spec HarborInstanceBackupPlanSpec	备份方案的所需状态。
status HarborInstanceBackupPlanStatus	最近观察到的备份方案的状态。

HarborInstanceBackupPlanList

表示 Harbor 实例的备份方案集合。

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceBackupPlanList
metadata ListMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
items HarborInstanceBackupPlan 数组

HarborInstanceBackupPlanSpec

定义备份方案的期望状态。

来源： - HarborInstanceBackupPlan

字段	说明
backupSchedule 时间安排	相应备份方案下的预定备份创建。
backupConfig BackupConfig	相应备份方案的备份配置。
retentionPolicy RetentionPolicy	根据此方案创建的备份的生命周期。
description 字符串	相应备份方案的用户指定描述性字符串。

HarborInstanceBackupPlanStatus

定义观察到的备份方案状态。

来源： - HarborInstanceBackupPlan

字段	说明
lastBackupTime 时间	最近执行的备份的时间戳。
nextBackupTime 时间	下一个预定备份的时间戳。
conditions 条件数组	条件：- 就绪：备份方案的就绪状态，协调嵌入式对象时出现的任何错误都会在此处显示。
state BackupPlanState	备份方案的当前状态。
reason 字符串	备份方案处于当前状态的原因的直观易懂的说明。

HarborInstanceBackupReference

HarborInstanceBackupReference 表示对 HarborInstanceBackup 的备份引用。

来源： - HarborInstanceStatus

字段	说明
name 字符串	name 在命名空间中是唯一的，用于引用 HarborInstanceBackup 资源。
namespace 字符串	命名空间定义了 HarborInstanceBackup 名称必须在其中具有唯一性的空间。

HarborInstanceBackupRepository

表示 Harbor 实例的备份代码库实例。

来源： - HarborInstanceBackupRepositoryList

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceBackupRepository
metadata ObjectMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
spec HarborInstanceBackupRepositorySpec	备份代码库的所需状态。
status HarborInstanceBackupRepositoryStatus	最近观察到的备份库的状态。

HarborInstanceBackupRepositoryList

表示 Harbor 实例的备份代码库集合。

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceBackupRepositoryList
metadata ListMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
items HarborInstanceBackupRepository 数组

HarborInstanceBackupRepositorySpec

定义 Harbor 备份存储库的期望状态。

来源： - HarborInstanceBackupRepository

字段	说明
secretReference SecretReference	用于访问 S3 存储桶的访问密钥的引用。Secret 应包含 S3 访问权限授予流程中的 2 个数据：- access-key-id - access-key
endpoint 字符串	用于访问 Harbor 备份代码库的端点。对于 Google Private Cloud，这是提供对租户项目访问权限的 S3 端点。
region 字符串	相应存储桶的给定端点所在的区域。
bucket 字符串	用于上传备份的端点中的存储桶。
description 字符串	相应备份存储库的用户指定描述性字符串。

HarborInstanceBackupRepositoryStatus

定义 Harbor 备份存储库的观测状态。

来源： - HarborInstanceBackupRepository

字段	说明
conditions 条件数组	条件：- Ready：备份仓库的就绪状态，协调嵌入式对象时出现的任何错误都会在此处显示。
state BackupRepositoryState	备份存储库的当前状态。
reason 字符串	备份资源库处于当前状态的人类可读说明。

HarborInstanceBackupSpec

定义备份的期望状态。

来源： - HarborInstanceBackup

字段	说明
backupPlanName 字符串	创建此备份时所依据的备份方案的名称。
backupConfig BackupConfig	备份的配置。此字段应：1. 由用户明确设置为手动自定义备份。2. 如果是自动预定备份或手动备份，则不设置，但会填充 backupPlanName。备份协调器将从备份方案中获取配置。
description 字符串	备份的可选字符串说明。此字段对功能没有影响。
manual 布尔值	指定备份资源是否是手动创建的。如果为 True，则表示相应备份是手动创建的；如果为 False，则表示相应备份是根据备份方案时间表自动创建的。
retainDays 整数	此备份的保留天数，之后系统会自动删除该备份。此值根据备份的 create_time 计算得出。如果未指定此字段或将其设置为 0，则表示不会自动删除备份。对于根据备份时间表自动创建的备份，此字段会被分配 BackupPlan.RetentionPolicy.backup_retain_days 的值。对于手动创建且未指定此字段的备份，服务会分配 BackupPlan.RetentionPolicy.backup_retain_days 的值。默认值为 0。

HarborInstanceBackupStatus

定义观察到的备份状态。

来源： - HarborInstanceBackup

字段	说明
state BackupState	备份的当前状态。
reason 字符串	有关备份为何处于当前状态的人类可读说明。
createTime 时间	相应备份资源创建时的时间戳。可以与 RFC 3339 进行相互转换。
completeTime 时间	备份的完成时间。
retainExpireTime 时间	自动删除备份的时间。这是一个仅输出字段，通过 create_time 和 retain_days 的组合值进行计算，会在备份的 retain_days 字段更新时进行相应更新。
totalSizeBytes 整数	备份的总大小（以字节为单位）。
registrySizeBytes 整数	数据传输服务处理的注册表备份的总大小（以字节为单位）。
databaseSizeBytes 整数	由 Dbcluster 导出处理的数据库备份的总大小（以字节为单位）。
exportSubDirectory 字符串	附加到数据库导出位置的子目录。在恢复期间运行导入时，系统会使用此参数。

HarborInstanceList

表示 Harbor 容器注册表实例的集合。

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceList
metadata ListMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
items HarborInstance 数组

HarborInstanceProject

表示 Harbor 实例中的 Harbor 项目。 自定义资源会建立项目必须存在的预期。 命名空间是指 Harbor 实例及其 Harbor 项目所属的 GDCH 项目名称。

来源： - HarborInstanceProjectList

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceProject
metadata ObjectMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
spec HarborInstanceProjectSpec
status HarborInstanceProjectStatus

HarborInstanceProjectList

包含 HarborInstanceProject 资源的列表。

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceProjectList
metadata ListMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
items HarborInstanceProject 数组

HarborInstanceProjectSpec

定义 HarborProject 对象的规范或预期状态。

来源： - HarborInstanceProject

字段	说明
projectName 字符串	港口项目的名称。必须符合 Harbor 的命名规则。
harborInstanceRef LocalObjectReference	相应 Harbor 项目所属的 Harbor 实例。
creatorSubject 主题	创建 Harbor 项目的用户或群组以及正文将被授予第一个 Harbor 项目管理员身份，以便在 Harbor 界面中管理 Harbor 项目并向更多用户授予访问权限。目前仅代表个人用户。
autoScan 布尔值	项目是否会在推送时自动扫描图片。如果未指定，则默认为 false。

HarborInstanceProjectStatus

定义 HarborInstanceProject 对象的观测状态。

来源： - HarborInstanceProject

字段	说明
conditions 条件数组	条件包括 ProjectCreated、ProjectDeleted 和 ProjectSubjectAssigned。ProjectCreated 表示在 Harbor 实例中创建的 Harbor 项目的状态为 true 或 false。ProjectDeleted 表示 Harbor 项目在 Harbor 实例中被删除，状态为 true 或 false。ProjectSubjectAssigned 表示启动自定义资源创建的用户或群组被授予 Harbor 中的第一个 Harbor 管理员角色，状态为 true 或 false。

HarborInstanceRestore

定义了 HarborInstance 的 Restore API 的架构。

来源： - HarborInstanceRestoreList

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceRestore
metadata ObjectMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
spec HarborInstanceRestoreSpec	恢复的预期状态。
status HarborInstanceRestoreStatus	最近观察到的恢复状态。

HarborInstanceRestoreList

表示 HaaS 实例的恢复集合。

字段	说明
apiVersion 字符串	artifactregistry.gdc.goog/v1
kind 字符串	HarborInstanceRestoreList
metadata ListMeta	如需了解 metadata 的字段，请参阅 Kubernetes API 文档。
items HarborInstanceRestore 数组

HarborInstanceRestoreReference

HarborInstanceRestoreReference 表示对 HarborInstanceRestore 的恢复引用。

来源： - HarborInstanceSpec

字段	说明
name 字符串	name 在命名空间中是唯一的，用于引用 HarborInstanceRestore 资源。
namespace 字符串	命名空间定义了 HarborInstanceRestore 名称必须在其中具有唯一性的空间。

HarborInstanceRestoreSpec

定义恢复的期望状态。

来源： - HarborInstanceRestore

字段	说明
backupName 字符串	相应 Harbor 实例备份资源的完整名称，此恢复资源用于从中进行恢复。
description 字符串	备份的可选说明。这不会影响功能。

HarborInstanceRestoreStatus

定义观察到的恢复状态。

来源： - HarborInstanceRestore

字段	说明
state RestoreState	恢复的当前状态。
stateReason 字符串	有关恢复处于当前状态的原因的人类可读说明。
startTime 时间	恢复流程的创建时间。
completeTime 时间	恢复流程的结束时间。

HarborInstanceSpec

表示 Harbor 实例的规范或所需状态。

来源： - HarborInstance

字段	说明
restoreRef HarborInstanceRestoreReference	相应实例所恢复到的恢复资源的引用。该字段由恢复协调填充，一经创建便不可变。

HarborInstanceStatus

表示 Harbor 实例的当前状态。

来源： - HarborInstance

字段	说明
conditions 条件数组	HarborInstance 的当前状态。“就绪”状态表示 HarborInstance 已准备就绪。
version 字符串	Harbor 实例的版本。
url 字符串	Harbor 实例的 Web 界面网址。
restoreTime 时间	如果实例不是通过恢复流程创建的，则与恢复相关的状态将为空。相应实例的恢复时间戳。
restoreBackupReference HarborInstanceBackupReference	相应实例所恢复自的备份资源的引用。
errorStatus ErrorStatus	ErrorStatus 包含最近的错误，并附带观测时间。
timeSinceLastReady 时间	TimeSinceLastReady 用于记录自上次 HarborInstance 准备就绪以来的时间。

RestoreState

基础类型： string

来源： - HarborInstanceRestoreStatus

RetentionPolicy

定义一项政策，用于确定何时自动删除根据此备份方案创建的备份、方案级备份保留天数下限，以及用于禁止任何政策更新的锁定。

来源： - HarborInstanceBackupPlanSpec

字段	说明
backupRetainDays 整数	服务将在多少天后删除备份。如果指定了该值，则在此备份方案下创建的备份会在达到 create_time 后的 backup_retain_days 时自动删除。如果未指定，则根据此备份方案创建的备份不会自动删除。更新此字段不会影响其下的现有备份。成功更新后创建的备份会自动沿用新值。

时间表

表示定义 cron 调度的内部消息类型。

来源： - HarborInstanceBackupPlanSpec

字段	说明
cronSchedule 字符串	执行操作所依据的 Cron 字符串时间表。
paused 布尔值	指定已调度的操作是暂停还是未暂停。如果设置为 True，则系统会暂停相应已安排的操作，并且不会创建任何自动备份。默认为 False。