状态

Status 是那些不返回其他对象的调用的返回值。

import "k8s.io/apimachinery/pkg/apis/meta/v1"

Status 是那些不返回其他对象的调用的返回值。


  • apiVersion (string)

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

  • code (int32)

    此状态建议的 HTTP 返回码,如果未设置则为 0。

  • details (StatusDetails)

    与原因相关的扩展数据。每个原因都可能定义其自己的扩展详细信息。此字段是可选的,并且返回的数据不保证符合除原因类型所定义以外的任何模式。

    StatusDetails 是一组附加属性,服务器可以设置这些属性以提供有关响应的额外信息。Status 对象的 Reason 字段定义了将要设置哪些属性。客户端必须忽略与每个属性定义的类型不匹配的字段,并应假设任何属性都可能是空的、无效的或未定义的。

    • details.causes ([]StatusCause)

      原子:将在合并期间被替换

      Causes 数组包含了与 StatusReason 失败相关的更多详细信息。并非所有的 StatusReason 都能提供详细的原因。

      StatusCause 提供了有关 api.Status 失败的更多信息,包括遇到多个错误的情况。

      • details.causes.field (string)

        导致此错误的资源字段,按其 JSON 序列化命名。可以包括用于嵌套属性的点号和后缀表示法。数组是从零开始索引的。由于字段可能存在多个错误,字段可能会在原因数组中多次出现。可选。

        示例:"name" - 当前资源上的 "name" 字段;"items[0].name" - "items" 中第一个数组条目上的 "name" 字段。

      • details.causes.message (string)

        对错误原因的人类可读描述。该字段可以按原样呈现给阅读者。

      • details.causes.reason (string)

        对错误原因的机器可读描述。如果此值为空,则无可用的信息。

    • details.group (string)

      与状态 StatusReason 关联的资源的 group 属性。

    • details.kind (string)

      与状态 StatusReason 关联的资源的 kind 属性。在某些操作中,可能与请求的资源 Kind 不同。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

    • details.name (string)

      与状态 StatusReason 关联的资源的 name 属性(当存在可以描述的单个名称时)。

    • details.retryAfterSeconds (int32)

      如果指定,则为应重试操作前的秒数。某些错误可能表明客户端必须采取替代操作——对于这些错误,此字段可能表明在采取替代操作之前需要等待的时间。

    • details.uid (string)

      资源的 UID。(当存在可以描述的单个资源时)。更多信息:https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names#uids

  • kind (string)

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

  • message (string)

    对此操作状态的人类可读描述。

  • metadata (ListMeta)

    标准列表元数据。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

  • reason (string)

    对此操作处于“失败 (Failure)”状态原因的机器可读描述。如果此值为空,则无可用的信息。Reason 阐明了 HTTP 状态码,但不会覆盖它。

  • status (string)

    操作的状态。可选值:“Success” 或 “Failure”。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status


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

本页面是自动生成的。

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