×

规格

属性 类型 描述

apiVersion

字符串

APIVersion定义了对象的此表示形式的版本化模式。服务器应将识别的模式转换为最新的内部值,并可能拒绝无法识别的值。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

字符串

Kind是一个字符串值,表示此对象表示的REST资源。服务器可以从客户端提交请求的端点推断出这一点。无法更新。采用驼峰式大小写。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

标准对象的元数据。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

对象

迁移的规范。

status

对象

迁移的状态。

.spec

描述

迁移的规范。

类型

对象

必需
  • resource

属性 类型 描述

continueToken

字符串

在列表选项中使用的令牌,用于获取要迁移的对象的下一块数据。当.status.conditions指示迁移“正在运行”时,用户可以使用此令牌检查迁移的进度。

resource

对象

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

.spec.resource

描述

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

类型

对象

属性 类型 描述

group

字符串

组的名称。

resource

字符串

资源的名称。

version

字符串

版本的名称。

.status

描述

迁移的状态。

类型

对象

属性 类型 描述

conditions

数组

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

conditions[]

对象

描述特定时间点迁移的状态。

.status.conditions

描述

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

类型

数组

.status.conditions[]

描述

描述特定时间点迁移的状态。

类型

对象

必需
  • status

  • type

属性 类型 描述

lastUpdateTime

字符串

上次更新此条件的时间。

message

字符串

指示转换详细信息的人类可读消息。

reason

字符串

条件上次转换的原因。

status

字符串

条件的状态,True、False、Unknown之一。

type

字符串

条件的类型。

API端点

提供以下API端点

  • /apis/migration.k8s.io/v1alpha1/storageversionmigrations

    • DELETE:删除StorageVersionMigration集合

    • GET:列出StorageVersionMigration类型的对象

    • POST:创建一个StorageVersionMigration

  • /apis/migration.k8s.io/v1alpha1/storageversionmigrations/{name}

    • DELETE:删除一个StorageVersionMigration

    • GET:读取指定的StorageVersionMigration

    • PATCH:部分更新指定的StorageVersionMigration

    • PUT:替换指定的StorageVersionMigration

  • /apis/migration.k8s.io/v1alpha1/storageversionmigrations/{name}/status

    • GET:读取指定StorageVersionMigration的状态

    • PATCH:部分更新指定StorageVersionMigration的状态

    • PUT:替换指定 StorageVersionMigration 的状态

/apis/migration.k8s.io/v1alpha1/storageversionmigrations

HTTP 方法

DELETE

描述

删除 StorageVersionMigration 集合

表 1. HTTP 响应
HTTP 代码 响应体

200 - OK

Status 模式

401 - 未授权

HTTP 方法

GET

描述

列出 StorageVersionMigration 对象

表 2. HTTP 响应
HTTP 代码 响应体

200 - OK

StorageVersionMigrationList 模式

401 - 未授权

HTTP 方法

POST

描述

创建 StorageVersionMigration

表 3. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这都将通过标准警告响应头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

表 4. 请求体参数
参数 类型 描述

body

StorageVersionMigration 模式

表 5. HTTP 响应
HTTP 代码 响应体

200 - OK

StorageVersionMigration 模式

201 - 已创建

StorageVersionMigration 模式

202 - 已接受

StorageVersionMigration 模式

401 - 未授权

/apis/migration.k8s.io/v1alpha1/storageversionmigrations/{name}

表 6. 全局路径参数
参数 类型 描述

name

字符串

StorageVersionMigration 的名称

HTTP 方法

DELETE

描述

删除 StorageVersionMigration

表 7. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

表 8. HTTP 响应
HTTP 代码 响应体

200 - OK

Status 模式

202 - 已接受

Status 模式

401 - 未授权

HTTP 方法

GET

描述

读取指定的 StorageVersionMigration

表 9. HTTP 响应
HTTP 代码 响应体

200 - OK

StorageVersionMigration 模式

401 - 未授权

HTTP 方法

PATCH

描述

部分更新指定的 StorageVersionMigration

表 10. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这都将通过标准警告响应头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

表 11. HTTP 响应
HTTP 代码 响应体

200 - OK

StorageVersionMigration 模式

401 - 未授权

HTTP 方法

PUT

描述

替换指定的 StorageVersionMigration

表 12. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这都将通过标准警告响应头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

表 13. 请求体参数
参数 类型 描述

body

StorageVersionMigration 模式

表 14. HTTP 响应
HTTP 代码 响应体

200 - OK

StorageVersionMigration 模式

201 - 已创建

StorageVersionMigration 模式

401 - 未授权

/apis/migration.k8s.io/v1alpha1/storageversionmigrations/{name}/status

表 15. 全局路径参数
参数 类型 描述

name

字符串

StorageVersionMigration 的名称

HTTP 方法

GET

描述

读取指定 StorageVersionMigration 的状态

表 16. HTTP 响应
HTTP 代码 响应体

200 - OK

StorageVersionMigration 模式

401 - 未授权

HTTP 方法

PATCH

描述

部分更新指定 StorageVersionMigration 的状态

表 17. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这都将通过标准警告响应头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

表 18. HTTP 响应
HTTP 代码 响应体

200 - OK

StorageVersionMigration 模式

401 - 未授权

HTTP 方法

PUT

描述

替换指定 StorageVersionMigration 的状态

表 19. 查询参数
参数 类型 描述

dryRun

字符串

如果存在,则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。有效值为:- All:将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为:- Ignore:这将忽略从对象中静默删除的任何未知字段,并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn:对于从对象中删除的每个未知字段以及遇到的每个重复字段,这都将通过标准警告响应头发送警告。如果没有任何其他错误,请求仍将成功,并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict:如果任何未知字段将从对象中删除,或者存在任何重复字段,这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

表 20. 请求体参数
参数 类型 描述

body

StorageVersionMigration 模式

表 21. HTTP 响应
HTTP 代码 响应体

200 - OK

StorageVersionMigration 模式

201 - 已创建

StorageVersionMigration 模式

401 - 未授权