OpenShift 文档正在迁移，很快将只能在 docs.redhat.com（所有 Red Hat 产品文档的所在地）访问。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

Metal3Remediation [infrastructure.cluster.x-k8s.io/v1beta1]

规格

属性 类型 描述

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

对象

Metal3RemediationSpec定义了Metal3Remediation的期望状态。

status

对象

Metal3RemediationStatus定义了Metal3Remediation的观察状态。

.spec

描述

Metal3RemediationSpec定义了Metal3Remediation的期望状态。

类型

对象

属性 类型 描述

strategy

对象

Strategy字段定义了修复策略。

.spec.strategy

描述

Strategy字段定义了修复策略。

类型

对象

属性 类型 描述

retryLimit

整数

设置最大修复重试次数。

timeout

字符串

设置修复重试之间的超时时间。

type

字符串

修复类型。

.status

描述

Metal3RemediationStatus定义了Metal3Remediation的观察状态。

类型

对象

属性 类型 描述

lastRemediated

字符串

LastRemediated标识上次修复主机的日期时间。

phase

字符串

Phase表示机器修复的当前阶段。例如，Pending、Running、Done等。

retryCount

整数

RetryCount可在修复过程中用作计数器。该字段可以保存重启次数等。

API端点

提供以下API端点

  • /apis/infrastructure.cluster.x-k8s.io/v1beta1/metal3remediations

    • GET：列出Metal3Remediation类型的对象

  • /apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/metal3remediations

    • DELETE：删除Metal3Remediation集合

    • GET：列出Metal3Remediation类型的对象

    • POST：创建一个Metal3Remediation

  • /apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/metal3remediations/{name}

    • DELETE：删除一个Metal3Remediation

    • GET：读取指定的Metal3Remediation

    • PATCH：部分更新指定的Metal3Remediation

    • PUT：替换指定的Metal3Remediation

  • /apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/metal3remediations/{name}/status

    • GET：读取指定的Metal3Remediation的状态

    • PATCH：部分更新指定的Metal3Remediation的状态

    • PUT：替换指定的Metal3Remediation的状态

/apis/infrastructure.cluster.x-k8s.io/v1beta1/metal3remediations

HTTP方法

GET

描述

列出Metal3Remediation类型的对象

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

200 - OK

Metal3RemediationList模式

401 - 未授权

空

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/metal3remediations

HTTP方法

DELETE

描述

删除Metal3Remediation集合

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

200 - OK

Status模式

401 - 未授权

空
HTTP方法

GET

描述

列出Metal3Remediation类型的对象

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

200 - OK

Metal3RemediationList模式

401 - 未授权

空
HTTP方法

POST

描述

创建一个Metal3Remediation

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

dryRun

字符串

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

fieldValidation

字符串

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

body

Metal3Remediation模式
表6. HTTP响应
HTTP代码 响应体

200 - OK

Metal3Remediation模式

201 - 已创建

Metal3Remediation模式

202 - 已接受

Metal3Remediation模式

401 - 未授权

空

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/metal3remediations/{name}

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

name

字符串

Metal3Remediation的名称
HTTP方法

DELETE

描述

删除一个Metal3Remediation

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

dryRun

字符串

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

200 - OK

Status模式

202 - 已接受

Status模式

401 - 未授权

空
HTTP方法

GET

描述

读取指定的 Metal3Remediation

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

200 - OK

Metal3Remediation模式

401 - 未授权

空
HTTP方法

PATCH

描述

部分更新指定的 Metal3Remediation

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

dryRun

字符串

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

fieldValidation

字符串

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

200 - OK

Metal3Remediation模式

401 - 未授权

空
HTTP方法

PUT

描述

替换指定的 Metal3Remediation

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

dryRun

字符串

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

fieldValidation

字符串

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

body

Metal3Remediation模式
表 15. HTTP 响应
HTTP代码 响应体

200 - OK

Metal3Remediation模式

201 - 已创建

Metal3Remediation模式

401 - 未授权

空

/apis/infrastructure.cluster.x-k8s.io/v1beta1/namespaces/{namespace}/metal3remediations/{name}/status

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

name

字符串

Metal3Remediation的名称
HTTP方法

GET

描述

读取指定的 Metal3Remediation 的状态

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

200 - OK

Metal3Remediation模式

401 - 未授权

空
HTTP方法

PATCH

描述

部分更新指定的 Metal3Remediation 的状态

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

dryRun

字符串

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

fieldValidation

字符串

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

200 - OK

Metal3Remediation模式

401 - 未授权

空
HTTP方法

PUT

描述

替换指定的 Metal3Remediation 的状态

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

dryRun

字符串

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

fieldValidation

字符串

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

body

Metal3Remediation模式
表 22. HTTP 响应
HTTP代码 响应体

200 - OK

Metal3Remediation模式

201 - 已创建

Metal3Remediation模式

401 - 未授权

空