diff --git a/content/zh-cn/docs/reference/kubernetes-api/workload-resources/pod-v1.md b/content/zh-cn/docs/reference/kubernetes-api/workload-resources/pod-v1.md index 37084be4bb9fe..33076376e056f 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/workload-resources/pod-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/workload-resources/pod-v1.md @@ -201,6 +201,7 @@ PodSpec 是对 Pod 的描述。 + **PodOS 定义一个 Pod 的操作系统参数。** - **topologySpreadConstraints.matchLabelKeys** ([]string) @@ -554,8 +556,11 @@ PodSpec 是对 Pod 的描述。 matchLabelKeys 是一组 Pod 标签键，用于通过计算 Pod 分布方式来选择 Pod。 新 Pod 标签中不存在的键将被忽略。这些键用于从新来的 Pod 标签中查找值，这些键值标签与 labelSelector 进行逻辑与运算， - 通过计算 Pod 的分布方式来选择现有 Pod 的组。新来的 Pod 标签中不存在的键将被忽略。 - null 或空的列表意味着仅与 labelSelector 匹配。 + 通过计算 Pod 的分布方式来选择现有 Pod 的组。matchLabelKeys 和 labelSelector + 中禁止存在相同的键。未设置 labelSelector 时无法设置 matchLabelKeys。 + 新来的 Pod 标签中不存在的键将被忽略。null 或空的列表意味着仅与 labelSelector 匹配。 + + 这是一个 Beta 字段，需要启用 MatchLabelKeysInPodTopologySpread 特性门控（默认启用）。 - **restartPolicy** (string) - Pod 内所有容器的重启策略。`Always`、`OnFailure`、`Never` 之一。默认为 `Always`。更多信息： + Pod 内所有容器的重启策略。`Always`、`OnFailure`、`Never` 之一。 + 在某些情况下，可能只允许这些值的一个子集。默认为 `Always`。更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy + 不属于此 Pod 但与此名称重名的现有 ResourceClaim 不会被用于此 Pod， 以避免错误地使用不相关的资源。Pod 的调度和启动动作会因此而被阻塞， 直到不相关的 ResourceClaim 被删除。 @@ -1360,6 +1367,7 @@ PodSpec 是对 Pod 的描述。 + 此字段是不可变更的，创建 ResourceClaim 后控制平面不会对相应的 ResourceClaim 进行任何更改。 schedulingGates 是一个不透明的值列表，如果指定，将阻止调度 Pod。 - 更多信息，请参阅：https://git.k8s.io/enhancements/keps/sig-scheduling/3521-pod-scheduling-readiness。 + 如果 schedulingGates 不为空，则 Pod 将保持 SchedulingGated 状态，调度程序将不会尝试调度 Pod。 + + SchedulingGates 只能在 Pod 创建时设置，并且只能在创建之后删除。 - 此特性为 Alpha 级别，需要通过 PodSchedulingReadiness 特性门控启用。 + 此特性为 Beta 特性，需要通过 PodSchedulingReadiness 特性门控启用。 - PodSchedulingGate 与 Pod 相关联以保护其调度。 + + **PodSchedulingGate 与 Pod 相关联以保护其调度。** - **schedulingGates.name** (string)，必需 @@ -1999,26 +2012,26 @@ A single application container that you want to run within a pod. - **resources.claims** ([]ResourceClaim) - **set：合并期间将保留唯一值** + **映射：键 `name` 的唯一值将在合并过程中保留** claims 列出此容器使用的资源名称，资源名称在 `spec.resourceClaims` 中定义。 这是一个 Alpha 特性字段，需要启用 DynamicResourceAllocation 功能门控开启此特性。 - 此字段不可变更。 + 此字段不可变更，只能在容器级别设置。 - **resources.limits** (map[string]}}">Quantity) @@ -2054,9 +2067,47 @@ A single application container that you want to run within a pod. - **resources.requests** (map[string]}}">Quantity) requests 描述所需的最小计算资源量。如果容器省略了 requests，但明确设定了 limits， - 则 requests 默认值为 limits 值，否则为实现定义的值。更多信息： + 则 requests 默认值为 limits 值，否则为实现定义的值。请求不能超过限制。更多信息： https://kubernetes.io/zh-cn/docs/concepts/configuration/manage-resources-containers/ + +- **resizePolicy** ([]ContainerResizePolicy) + + **原子性: 将在合并期间被替换** + + 容器的资源调整策略。 + + + + **ContainerResizePolicy 表示容器的资源大小调整策略** + + - **resizePolicy.resourceName** (string), 必需 + + 该资源调整策略适用的资源名称。支持的值：cpu、memory。 + + + + - **resizePolicy.restartPolicy** (string), 必需 + + 重启策略，会在调整指定资源大小时使用该策略。如果未指定，则默认为 NotRequired。 + @@ -2989,7 +3040,45 @@ EphemeralContainer 是一个临时容器，你可以将其添加到现有 Pod name 必须与 Pod 中的 persistentVolumeClaim 的名称匹配。 +- **resizePolicy** ([]ContainerResizePolicy) + + **原子性: 将在合并期间被替换** + + 容器的资源调整策略。 + + + + **ContainerResizePolicy 表示容器的资源大小调整策略** + + - **resizePolicy.resourceName** (string), 必需 + + 该资源调整策略适用的资源名称。支持的值：cpu、memory。 + + + + - **resizePolicy.restartPolicy** (string), 必需 + + 重启策略，会在调整指定资源大小时使用该策略。如果未指定，则默认为 NotRequired。 + + ### 生命周期 @@ -3457,26 +3546,26 @@ EphemeralContainer 是一个临时容器，你可以将其添加到现有 Pod - **resources.claims** ([]ResourceClaim) - **set：合并期间将保留唯一值** + **映射：键 `name` 的唯一值将在合并过程中保留** claims 列出了此容器使用的资源名称，资源名称在 `spec.resourceClaims` 中定义。 这是一个 Alpha 特性字段，需要启用 DynamicResourceAllocation 功能门控开启此特性。 - 此字段不可变更。 + 此字段不可变更，只能在容器级别设置。 + **ResourceClaim 引用 `PodSpec.ResourceClaims` 中的一项。** - **resources.claims.name** (string)，必需 @@ -3507,13 +3597,13 @@ EphemeralContainer 是一个临时容器，你可以将其添加到现有 Pod - **resources.requests** （map[string]}}">Quantity） requests 描述所需的最小计算资源量。如果对容器省略了 requests，则默认其资源请求值为 limits - （如果已显式指定）的值，否则为实现定义的值。更多信息： + （如果已显式指定）的值，否则为实现定义的值。请求不能超过限制。更多信息： https://kubernetes.io/zh-cn/docs/concepts/configuration/manage-resources-containers/ + **IntOrString 是一种可以保存 int32 或字符串值的类型。在 JSON 或 YAML 编组和解组中使用时， 会生成或使用内部类型。例如，这允许你拥有一个可以接受名称或数字的 JSON 字段。** @@ -4491,11 +4582,11 @@ Probe describes a health check to be performed against a container to determine - **grpc** （GRPCAction） - GRPC 指定涉及 GRPC 端口的操作。这是一个 Beta 字段，需要启用 GRPCContainerProbe 特性门控。 + GRPC 指定涉及 GRPC 端口的操作。 @@ -4595,6 +4686,7 @@ PodStatus 表示有关 Pod 状态的信息。状态内容可能会滞后于系 + 更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/pods/pod-lifecycle#pod-phase @@ -4750,12 +4842,12 @@ PodStatus 表示有关 Pod 状态的信息。状态内容可能会滞后于系 - **qosClass** （string） 根据资源要求分配给 Pod 的服务质量 (QOS) 分类。有关可用的 QOS 类，请参阅 PodQOSClass 类型。 - 更多信息： https://git.k8s.io/community/contributors/design-proposals/node/resource-qos.md + 更多信息： https://kubernetes.io/zh-cn/docs/concepts/workloads/pods/pod-qos/#quality-of-service-classes + + *ContainerStatus contains details for the current status of this container.* +--> +- **containerStatuses** （[]ContainerStatus） - - **initContainerStatuses.name** (string)，必需 + 清单中的每个容器状态在该列表中都有一个条目。更多信息： + https://kubernetes.io/zh-cn/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status - 此字段值必须是 DNS_LABEL。Pod 中的每个容器都必须具有唯一的名称。无法更新。 + **ContainerStatus 包含此容器当前状态的详细信息。** + + +- **ephemeralContainerStatuses** （[]ContainerStatus） - +- **resize** (string) - Container's ID in the format '\://\'. - --> + Pod 容器所需的资源大小调整状态。如果没有待处理的资源调整大小，则它为空。 + 对容器资源的任何更改都会自动将其设置为"建议"值。 - - **initContainerStatuses.imageID** (string)，必需 +## PodList {#PodList} - 容器镜像的镜像 ID。 + +PodList 是 Pod 的列表。 - - **initContainerStatuses.containerID** （string） +
- 格式为 `://` 的容器 ID。 + +- **items** （[]}}">Pod），必需 - Details about the container's current condition. + Pod 列表。更多信息： + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md - - *ContainerState holds a possible state of container. Only one of its members may be specified. If none of them is specified, the default one is ContainerStateWaiting.* - --> + +- **apiVersion** （string） - 有关容器当前状况的详细信息。 + apiVersion 定义对象表示的版本化模式。服务器应将已识别的模式转换为最新的内部值， + 并可能拒绝无法识别的值。更多信息： + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources - ContainerState 中保存容器的可能状态。只能设置其成员之一。如果其中所有字段都未设置， - 则默认为 ContainerStateWaiting。 + +- **kind**（string） - Details about a running container + kind 是一个字符串值，表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出资源类别。 + 无法更新。采用驼峰式命名。更多信息： + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - - *ContainerStateRunning is a running state of a container.* - --> + +- **metadata** （}}">ListMeta） - 有关正在运行的容器的详细信息。 + 标准的列表元数据。更多信息： + https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - **ContainerStateRunning 是容器的运行状态。** + +## 操作 {#Operations} - +### `get` 读取指定的 Pod - - *Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.* - --> + +#### HTTP 请求 - - **initContainerStatuses.state.running.startedAt** （Time） +GET /api/v1/namespaces/{namespace}/pods/{name} - 容器上次（重新）启动的时间。 + +#### 参数 - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 + + }}">namespace - - **initContainerStatuses.state.terminated** （ContainerStateTerminated） +- **pretty** (*in query*): string - 有关已终止容器的详细信息。 + }}">pretty +--> +- **name** (**路径参数**): string，必需 - **ContainerStateTerminated 是容器的终止状态。** + Pod 的名称 - + }}">pretty - - **initContainerStatuses.state.terminated.containerID** （string） + +#### 响应 - 容器的 ID，格式为 `"<类型>://"`。 +200 (}}">Pod): OK - - **initContainerStatuses.state.terminated.exitCode** （int32），必需 +401: Unauthorized - 容器上次终止时的退出状态 + +### `get` 读取指定 Pod 的 ephemeralcontainers - +#### HTTP 请求 - Time at which previous execution of the container started +GET /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers - - *Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.* - --> + +#### 参数 - - **initContainerStatuses.state.terminated.startedAt** （Time） + + }}">pretty +--> +- **name** (**路径参数**): string，必需 - - **initContainerStatuses.state.terminated.finishedAt** （Time） + Pod 的名称 - 容器上次终止的时间。 +- **namespace** (**路径参数**): string，必需 - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 + }}">namespace - +#### 响应 - (brief) reason from the last termination of the container +200 (}}">Pod): OK - - **initContainerStatuses.state.terminated.signal** (int32) +401: Unauthorized - Signal from the last termination of the container - --> + - - **initContainerStatuses.state.terminated.message** （string） +### `get` 读取指定 Pod 的日志 - 有关容器上次终止的消息。 + +#### HTTP 请求 - - **initContainerStatuses.state.terminated.reason** （string） +GET /api/v1/namespaces/{namespace}/pods/{name}/log - 容器最后一次终止的（简要）原因。 + +#### 参数 - - **initContainerStatuses.state.terminated.signal** （int32） + + }}">namespace - - **initContainerStatuses.state.waiting** （ContainerStateWaiting） - 有关等待状态容器的详细信息。 +- **container** (*in query*): string - **容器状态等待是容器的等待状态。** + The container for which to stream logs. Defaults to only container if there is one container in the pod. +--> +- **name** (**路径参数**): string，必需 - +- **container** (**查询参数**): string - - **initContainerStatuses.state.waiting.message** （string） + 为其流式传输日志的容器。如果 Pod 中有一个容器，则默认为仅容器。 - 有关容器尚未运行的原因的消息。 + +- **follow** (**查询参数**)：boolean - - *ContainerState holds a possible state of container. Only one of its members may be specified. If none of them is specified, the default one is ContainerStateWaiting.* - --> + 跟踪 Pod 的日志流。默认为 false。 - - **initContainerStatuses.lastState** （ContainerState） +- **insecureSkipTLSVerifyBackend** (**查询参数**)：boolean - 有关容器上次终止状况的详细信息。 + `insecureSkipTLSVerifyBackend` 表示 API 服务器不应确认它所连接的后端的服务证书的有效性。 + 这将使 API 服务器和后端之间的 HTTPS 连接不安全。 + 这意味着 API 服务器无法验证它接收到的日志数据是否来自真正的 kubelet。 + 如果 kubelet 配置为验证 API 服务器的 TLS 凭据，这并不意味着与真实 kubelet + 的连接容易受到中间人攻击（例如，攻击者无法拦截来自真实 kubelet 的实际日志数据）。 - ContainerState 保存容器的可能状态。只能设置其成员之一。如果未设置任何成员， - 则默认为 ContainerStateWaiting。 + - - - **initContainerStatuses.lastState.running** （ContainerStateRunning） - - 有关正在运行的容器的详细信息 - - **ContainerStateRunning 是容器的运行状态。** - - - - - **initContainerStatuses.lastState.running.startedAt** （Time） - - 容器上次（重新）启动的时间 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **initContainerStatuses.lastState.terminated** （ContainerStateTerminated） - - 有关已终止容器的详细信息。 - - **ContainerStateTerminated 是容器的终止状态。** - - - - - **initContainerStatuses.lastState.terminated.containerID** （string） - - 容器的 ID，格式为 `"<类型>://"`。 - - - **initContainerStatuses.lastState.terminated.exitCode** （int32），必需 - - 容器上次终止的退出状态码。 - - - - - **initContainerStatuses.lastState.terminated.startedAt** （Time） - - 容器上次执行的开始时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **initContainerStatuses.lastState.terminated.finishedAt** （Time） - - 容器上次终止的时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **initContainerStatuses.lastState.terminated.message** （string） - - 有关容器上次终止的消息。 - - - **initContainerStatuses.lastState.terminated.reason** （string） - - 容器最后一次终止的（简要）原因。 - - - **initContainerStatuses.lastState.terminated.signal** （int32） - - 容器最后一次终止的信号。 - - - - - **initContainerStatuses.lastState.waiting** （ContainerStateWaiting） - - 有关等待状态的容器的详细信息。 - - **ContainerStateWaiting 是容器的等待状态。** - - - - - **initContainerStatuses.lastState.waiting.message** （string） - - 关于容器尚未运行的原因的消息。 - - - **initContainerStatuses.lastState.waiting.reason** （string） - - 容器尚未运行的（简要）原因。 - - - - - **initContainerStatuses.ready** （boolean），必需 - - 指定容器是否已通过其就绪态探测。 - - - **initContainerStatuses.restartCount** （int32），必需 - - 容器重新启动的次数。 - - - - - **initContainerStatuses.started** （boolean） - - 指定容器是否已通过其启动探测。初始化为 false，在 startupProbe 成功之后变为 true。 - 在容器重新启动时，或者如果 kubelet 暂时失去状态时重置为 false。 - 在未定义启动探测器时始终为 true。 - - -- **containerStatuses** （[]ContainerStatus） - - 该列表中针对清单中的每个容器都有一个条目。更多信息： - https://kubernetes.io/zh-cn/docs/concepts/workloads/pods/pod-lifecycle#pod-and-container-status - - **ContainerStatus 包含此容器当前状态的详细信息。** - - - - - **containerStatuses.name**（string），必需 - - 此字段必须是一个 DNS_LABEL。Pod 中的每个容器都必须具有唯一的名称。无法更新。 - - - **containerStatuses.image** （string），必需 - - 容器正在运行的镜像。更多信息： - https://kubernetes.io/zh-cn/docs/concepts/containers/images。 - - - - - **containerStatuses.imageID** （string），必需 - - 容器镜像的镜像 ID。 - - - **containerStatuses.containerID** （string） - - 容器的 ID，格式为 `"<类型>://"`。 - - - - - **containerStatuses.state** （ContainerState） - - 有关容器当前状况的详细信息。 - - ContainerStatuses 保存容器的可能状态。只能设置其中一个成员。如果所有成员都未设置， - 则默认为 ContainerStateWaiting。 - - - - - **containerStatuses.state.running** （ContainerStateRunning） - - 有关正在运行的容器的详细信息。 - - **ContainerStateRunning 是容器的运行状态。** - - - - - **containerStatuses.state.running.startedAt** （Time） - - 容器上次（重新）启动的时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **containerStatuses.state.terminated** （ContainerStateTerminated） - - 有关已终止容器的详细信息。 - - **ContainerStateTerminated 是容器的终止状态。** - - - - - **containerStatuses.state.terminated.containerID** （string） - - 容器的 ID，格式为 `"<类型>://"`。 - - - **containerStatuses.state.terminated.exitCode** （int32），必需 - - 容器上次终止的退出状态码。 - - - - - **containerStatuses.state.terminated.startedAt** （Time） - - 容器上次执行的开始时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **containerStatuses.state.terminated.finishedAt** （Time） - - 容器上次终止的时间。 - - **Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。** - - - - - **containerStatuses.state.terminated.message** （string） - - 有关容器上次终止的消息。 - - - **containerStatuses.state.terminated.reason** （string） - - 容器最后一次终止的（简要）原因 - - - **containerStatuses.state.terminated.signal** （int32） - - 容器最后一次终止的信号。 - - - - - **containerStatuses.state.waiting** （ContainerStateWaiting） - - 有关等待容器的详细信息。 - - **ContainerStateWaiting 是容器的等待状态。** - - - - - **containerStatuses.state.waiting.message** （string） - - 关于容器尚未运行的原因的消息。 - - - **containerStatuses.state.waiting.reason** （string） - - 容器尚未运行的（简要）原因。 - - - - - **containerStatuses.lastState** （ContainerState） - - 有关容器上次终止状况的详细信息。 - - 容器状态保存容器的可能状态。只能设置一个成员。如果所有成员都未设置， - 则默认为 ContainerStateWaiting。 - - - - - **containerStatuses.lastState.running** （ContainerStateRunning） - - 有关正在运行的容器的详细信息。 - - **ContainerStateRunning 是容器的运行状态。** - - - - - **containerStatuses.lastState.running.startedAt** （Time） - - 容器上次（重新）启动的时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **containerStatuses.lastState.terminated** （ContainerStateTerminated） - - 有关已终止容器的详细信息。 - - **ContainerStateTerminated 是容器的终止状态。** - - - - - **containerStatuses.lastState.terminated.containerID** （string） - - 格式为 `://` 的容器 ID。 - - - **containerStatuses.lastState.terminated.exitCode** (int32)，必需 - - 容器最后终止的退出状态码。 - - - - - **containerStatuses.lastState.terminated.startedAt** （Time） - - 容器上次执行时的开始时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **containerStatuses.lastState.terminated.finishedAt** （Time） - - 容器上次终止的时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **containerStatuses.lastState.terminated.message** （string） - - 关于容器上次终止的消息。 - - - **containerStatuses.lastState.terminated.reason** （string） - - 容器上次终止的（简要）原因 - - - **containerStatuses.lastState.terminated.signal** （int32） - - 容器上次终止的信号。 - - - - - **containerStatuses.lastState.waiting** （ContainerStateWaiting） - - 有关等待容器的详细信息。 - - **ContainerStateWaiting 是容器的等待状态。** - - - - - **containerStatuses.lastState.waiting.message** （string） - - 关于容器尚未运行的原因的消息。 - - - **containerStatuses.lastState.waiting.reason** （string） - - 容器尚未运行的（简要）原因。 - - - - - **containerStatuses.ready** (boolean)，必需 - - 指定容器是否已通过其就绪态探针。 - - - **containerStatuses.restartCount** (int32)，必需 - - 容器重启的次数。 - - - - - **containerStatuses.started** （boolean） - - 指定容器是否已通过其启动探针探测。初始化为 false，startupProbe 被认为成功后变为 true。 - 当容器重新启动或 kubelet 暂时丢失状态时重置为 false。 - 未定义启动探针时始终为 true。 - - -- **ephemeralContainerStatuses** （[]ContainerStatus） - - 已在此 Pod 中运行的任何临时容器的状态。 - - - **ContainerStatus 包含此容器当前状态的详细信息。** - - - - - **ephemeralContainerStatuses.name** (string)，必需 - - 字段值必须是 DNS_LABEL。Pod 中的每个容器都必须具有唯一的名称。无法更新。 - - - **ephemeralContainerStatuses.image** (string)，必需 - - 容器正在运行的镜像。更多信息： - https://kubernetes.io/zh-cn/docs/concepts/containers/images。 - - - - - **ephemeralContainerStatuses.imageID** (string)，必需 - - 容器镜像的镜像 ID。 - - - **ephemeralContainerStatuses.containerID** （string） - - 格式为 `://` 的容器 ID。 - - - - **ephemeralContainerStatuses.state** （ContainerState） - - 有关容器当前状况的详细信息。 - - ContainerState 保存容器的可能状态。只能设置其中一个成员。如果所有成员都未设置， - 则默认为 ContainerStateWaiting。 - - - - - **ephemeralContainerStatuses.state.running** （ContainerStateRunning） - - 有关正在运行的容器的详细信息 - - **ContainerStateRunning 是容器的运行状态。** - - - - - **ephemeralContainerStatuses.state.running.startedAt** （Time） - - 容器上次（重新）启动的时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **ephemeralContainerStatuses.state.terminated** （ContainerStateTerminated） - - 有关已终止容器的详细信息。 - - **ContainerStateTerminated 是容器的终止状态。** - - - - - **ephemeralContainerStatuses.state.terminated.containerID** （string） - - 格式为 `://` 的容器 ID。 - - - **ephemeralContainerStatuses.state.terminated.exitCode** (int32)，必需 - - 容器上次终止的退出状态码。 - - - - - **ephemeralContainerStatuses.state.terminated.startedAt** （Time） - - 容器上次执行的开始时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **ephemeralContainerStatuses.state.terminated.finishat** （Time） - - 容器上次终止的时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **ephemeralContainerStatuses.state.terminated.message** （string） - - 关于容器上次终止的消息。 - - - **ephemeralContainerStatuses.state.terminated.reason** （string） - - 容器上次终止的（简要）原因 - - - **ephemeralContainerStatuses.state.terminated.signal** （int32） - - 容器上次终止的信号 - - - - - **ephemeralContainerStatuses.state.waiting** （ContainerStateWaiting） - - 有关等待容器的详细信息。 - - **ContainerStateWaiting 是容器的等待状态。** - - - - - **ephemeralContainerStatuses.state.waiting.message** （string） - - 关于容器尚未运行的原因的消息。 - - - **ephemeralContainerStatuses.state.waiting.reason** （string） - - 容器尚未运行的（简要）原因。 - - - - **ephemeralContainerStatuses.lastState** （ContainerState） - - 有关容器的上次终止状况的详细信息。 - - ContainerState 保存容器的可能状态。只能设置其中一个成员。如果所有成员都未设置， - 则默认为 `ContainerStateWaiting`。 - - - - - **ephemeralContainerStatuses.lastState.running** （ContainerStateRunning） - - 有关正在运行的容器的详细信息。 - - **ContainerStateRunning 是容器的运行状态。** - - - - - **ephemeralContainerStatuses.lastState.running.startedAt** （Time） - - 容器上次（重新）启动的时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **ephemeralContainerStatuses.lastState.terminated** （ContainerStateTerminated） - - 有关已终止容器的详细信息。 - - **`ContainerStateTerminated` 是容器的终止状态。** - - - - - **ephemeralContainerStatuses.lastState.terminated.containerID** （string） - - 格式为 `://` 的容器 ID。 - - - **ephemeralContainerStatuses.lastState.terminated.exitCode** (int32)，必需 - - 容器上次终止时的退出状态码。 - - - - - **ephemeralContainerStatuses.lastState.terminated.startedAt** （Time） - - 容器上次执行的开始时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **ephemeralContainerStatuses.lastState.terminated.finishedAt** （Time） - - 容器上次终止的时间。 - - Time 是 `time.Time` 的包装器，支持正确编组为 YAML 和 JSON。 - time 包所提供的许多工厂方法都有包装器。 - - - - - **ephemeralContainerStatuses.lastState.terminated.message** （string） - - 关于容器上次终止的消息。 - - - **ephemeralContainerStatuses.lastState.terminated.reason** （string） - - 容器上次终止的（简要）原因。 - - - **ephemeralContainerStatuses.lastState.terminated.signal** （int32） - - 容器上次终止的信号。 - - - - - **ephemeralContainerStatuses.lastState.waiting** （ContainerStateWaiting） - - 有关等待状态容器的详细信息。 - - **ContainerStateWaiting 是容器的等待状态。** - - - - - **ephemeralContainerStatuses.lastState.waiting.message** （string） - - 关于容器尚未运行的原因的消息。 - - - **ephemeralContainerStatuses.lastState.waiting.reason** （string） - - 容器尚未运行的（简要）原因。 - - - - - **ephemeralContainerStatuses.ready** （boolean），必需 - - 指定容器是否已通过其就绪态探测。 - - - **ephemeralContainerStatuses.restartCount** （int32），必需 - - 容器重新启动的次数。 - - - - - **ephemeralContainerStatuses.started** （boolean） - - 指定容器是否已通过其启动探测。初始化为 false，在 startProbe 成功之后变为 true。 - 在容器重新启动时或者 kubelet 暂时失去状态时重置为 false。 - 在未定义 startupProbe 时始终为 true。 - -## PodList {#PodList} - - -PodList 是 Pod 的列表。 - -
- - -- **items** （[]}}">Pod），必需 - - Pod 列表。更多信息： - https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md - - -- **apiVersion** （string） - - apiVersion 定义对象表示的版本化模式。服务器应将已识别的模式转换为最新的内部值， - 并可能拒绝无法识别的值。更多信息： - https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources - - -- **kind**（string） - - kind 是一个字符串值，表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出资源类别。 - 无法更新。采用驼峰式命名。更多信息： - https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - - -- **metadata** （}}">ListMeta） - - 标准的列表元数据。更多信息： - https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds - - -## 操作 {#Operations} - -
- - -### `get` 读取指定的 Pod - - -#### HTTP 请求 - -GET /api/v1/namespaces/{namespace}/pods/{name} - - -#### 参数 - - -- **name** (**路径参数**): string，必需 - - Pod 的名称 - -- **namespace** (**路径参数**): string，必需 - - }}">namespace - -- **pretty** (**查询参数**): string - - }}">pretty - - -#### 响应 - -200 (}}">Pod): OK - -401: Unauthorized - - -### `get` 读取指定 Pod 的 ephemeralcontainers - - -#### HTTP 请求 - -GET /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers - - -#### 参数 - - -- **name** (**路径参数**): string，必需 - - Pod 的名称 - -- **namespace** (**路径参数**): string，必需 - - }}">namespace - -- **pretty** (**查询参数**): string - - }}">pretty - - -#### 响应 - -200 (}}">Pod): OK - -401: Unauthorized - - - -### `get` 读取指定 Pod 的日志 - - -#### HTTP 请求 - -GET /api/v1/namespaces/{namespace}/pods/{name}/log - - -#### 参数 - - -- **name** (**路径参数**): string，必需 - - Pod 的名称。 - -- **namespace** (**路径参数**): string，必需 - - }}">namespace - -- **container** (**查询参数**): string - - 为其流式传输日志的容器。如果 Pod 中有一个容器，则默认为仅容器。 - - -- **follow** (**查询参数**)：boolean - - 跟踪 Pod 的日志流。默认为 false。 - -- **insecureSkipTLSVerifyBackend** (**查询参数**)：boolean - - `insecureSkipTLSVerifyBackend` 表示 API 服务器不应确认它所连接的后端的服务证书的有效性。 - 这将使 API 服务器和后端之间的 HTTPS 连接不安全。 - 这意味着 API 服务器无法验证它接收到的日志数据是否来自真正的 kubelet。 - 如果 kubelet 配置为验证 API 服务器的 TLS 凭据，这并不意味着与真实 kubelet - 的连接容易受到中间人攻击（例如，攻击者无法拦截来自真实 kubelet 的实际日志数据）。 - - @@ -6465,6 +5342,10 @@ GET /api/v1/namespaces/{namespace}/pods }}">resourceVersionMatch +- **sendInitialEvents** (*in query*): boolean + + }}">sendInitialEvents + - **timeoutSeconds** (*in query*): integer }}">timeoutSeconds @@ -6477,6 +5358,10 @@ GET /api/v1/namespaces/{namespace}/pods }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + - **timeoutSeconds** (**查询参数**): integer }}">timeoutSeconds @@ -6572,6 +5457,10 @@ GET /api/v1/pods - **resourceVersionMatch** (*in query*): string }}">resourceVersionMatch + +- **sendInitialEvents** (*in query*): boolean + + }}">sendInitialEvents --> - **resourceVersion** (**查询参数**): string @@ -6581,6 +5470,10 @@ GET /api/v1/pods }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents + - **resourceVersion** (**查询参数**): string @@ -7410,6 +6307,10 @@ DELETE /api/v1/namespaces/{namespace}/pods }}">resourceVersionMatch +- **sendInitialEvents** (**查询参数**): boolean + + }}">sendInitialEvents +