StorageVersionMigration v1beta1

StorageVersionMigration 表示将存储的数据迁移至最新存储版本的迁移任务。

apiVersion: storagemigration.k8s.io/v1beta1

import "k8s.io/api/storagemigration/v1beta1"

StorageVersionMigration

StorageVersionMigration 表示将存储的数据迁移至最新存储版本的迁移任务。


StorageVersionMigrationSpec

存储版本迁移的规范。


  • resource (GroupResource), 必需

    正在迁移的资源。迁移器向提供该资源的端点发送请求。不可变。

    GroupResource 指定了一个组(Group)和一个资源(Resource),但不强制指定版本。这对于在查找阶段识别概念非常有用,且无需使用部分有效的类型。

    • resource.group (string), 必需

    • resource.resource (string), 必需

StorageVersionMigrationStatus

存储版本迁移的状态。


  • conditions ([]Condition)

    Patch 策略:在键 type 上合并

    映射:在合并期间将保留键类型上的唯一值

    关于迁移当前状态的最新可用观察结果。

    Condition 包含此 API 资源当前状态的一个方面的详细信息。

    • conditions.lastTransitionTime (Time), required

      lastTransitionTime 是条件从一个状态过渡到另一个状态的最后时间。这应该是在底层条件发生变化时的时间。如果不知道,则使用 API 字段发生变化的时间是可以接受的。

      Time 是 time.Time 的包装器,支持正确地编组到 YAML 和 JSON。为时间包提供的许多工厂方法提供包装器。

    • conditions.message (string), required

      message 是一个人类可读的消息,指示过渡的详细信息。这可能是一个空字符串。

    • conditions.reason (string), required

      reason 包含一个程序化标识符,指示条件上次转换的原因。特定条件类型的生产者可以为此字段定义期望值和含义,以及这些值是否被视为保证的 API。该值应为 CamelCase 字符串。此字段不能为空。

    • conditions.status (string), required

      条件的 status,可以是 True、False 或 Unknown。

    • conditions.type (string), required

      条件的类型,采用 CamelCase 格式或 foo.example.com/CamelCase 格式。

    • conditions.observedGeneration (int64)

      observedGeneration 表示设置该条件时所依据的 .metadata.generation。例如,如果 .metadata.generation 当前为 12,但 .status.conditions[x].observedGeneration 为 9,则该条件相对于实例的当前状态已过时。

  • resourceVersion (string)

    用于与 GC 缓存比较以执行迁移的 ResourceVersion。这是 kube-controller-manager 首次观察到此 StorageVersionMigration 资源时,给定组、版本和资源的当前资源版本。

StorageVersionMigrationList

StorageVersionMigrationList 是存储版本迁移的集合。


操作


get 读取指定的 StorageVersionMigration

HTTP 请求

GET /apis/storagemigration.k8s.io/v1beta1/storageversionmigrations/{name}

Parameters

  • name (在路径中): string, 必需

    StorageVersionMigration 的名称

  • pretty (在查询中): string

    pretty

响应

200 (StorageVersionMigration): OK

401: 未授权

get 读取指定 StorageVersionMigration 的状态

HTTP 请求

GET /apis/storagemigration.k8s.io/v1beta1/storageversionmigrations/{name}/status

Parameters

  • name (在路径中): string, 必需

    StorageVersionMigration 的名称

  • pretty (在查询中): string

    pretty

响应

200 (StorageVersionMigration): OK

401: 未授权

list 列出或监视 StorageVersionMigration 类型的对象

HTTP 请求

GET /apis/storagemigration.k8s.io/v1beta1/storageversionmigrations

Parameters

响应

200 (StorageVersionMigrationList): OK

401: 未授权

create 创建一个 StorageVersionMigration

HTTP 请求

POST /apis/storagemigration.k8s.io/v1beta1/storageversionmigrations

Parameters

响应

200 (StorageVersionMigration): OK

201 (StorageVersionMigration): 已创建

202 (StorageVersionMigration): 已接受

401: 未授权

update 替换指定的 StorageVersionMigration

HTTP 请求

PUT /apis/storagemigration.k8s.io/v1beta1/storageversionmigrations/{name}

Parameters

响应

200 (StorageVersionMigration): OK

201 (StorageVersionMigration): 已创建

401: 未授权

update 替换指定 StorageVersionMigration 的状态

HTTP 请求

PUT /apis/storagemigration.k8s.io/v1beta1/storageversionmigrations/{name}/status

Parameters

响应

200 (StorageVersionMigration): OK

201 (StorageVersionMigration): 已创建

401: 未授权

patch 部分更新指定的 StorageVersionMigration

HTTP 请求

PATCH /apis/storagemigration.k8s.io/v1beta1/storageversionmigrations/{name}

Parameters

  • name (在路径中): string, 必需

    StorageVersionMigration 的名称

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (StorageVersionMigration): OK

201 (StorageVersionMigration): 已创建

401: 未授权

patch 部分更新指定 StorageVersionMigration 的状态

HTTP 请求

PATCH /apis/storagemigration.k8s.io/v1beta1/storageversionmigrations/{name}/status

Parameters

  • name (在路径中): string, 必需

    StorageVersionMigration 的名称

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (StorageVersionMigration): OK

201 (StorageVersionMigration): 已创建

401: 未授权

delete 删除一个 StorageVersionMigration

HTTP 请求

DELETE /apis/storagemigration.k8s.io/v1beta1/storageversionmigrations/{name}

Parameters

响应

200 (Status): 确定

202 (Status): 已接受

401: 未授权

deletecollection 删除 StorageVersionMigration 的集合

HTTP 请求

DELETE /apis/storagemigration.k8s.io/v1beta1/storageversionmigrations

Parameters

响应

200 (Status): 确定

401: 未授权


最后修改时间 2025 年 12 月 21 日 下午 5:37 PST: 更新 v1.35 的资源文档 (85b57273c5)

本页面是自动生成的。

如果您打算报告此页面的问题,请在您的问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。