ServiceCIDR

ServiceCIDR 使用 CIDR 格式定义了 IP 地址范围（例如

apiVersion: networking.k8s.io/v1

import "k8s.io/api/networking/v1"

ServiceCIDR

ServiceCIDR 使用 CIDR 格式定义了一段 IP 地址范围（例如 192.168.0.0/24 或 2001:db2::/64）。此范围用于为 Service 对象分配 ClusterIPs。

ServiceCIDRSpec

ServiceCIDRSpec 定义了用户希望用来为 Service 分配 ClusterIP 的 CIDR 范围。

  • cidrs ([]string)

    原子性：将在合并期间被替换

    CIDRs 定义了用于分配 Service Cluster IP 的 IP 块，采用 CIDR 记法（例如 "192.168.0.0/24" 或 "2001:db8::/64"）。最多允许两个 CIDR，每个 IP 家族一个。此字段不可变。

ServiceCIDRStatus

ServiceCIDRStatus 描述了 ServiceCIDR 的当前状态。

  • conditions ([]Condition)

    Patch 策略：在键 type 上合并

    Map：合并期间将保留键 type 上的唯一值

    conditions 包含一个 metav1.Condition 数组，描述 ServiceCIDR 的状态。当前服务状态

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

    • conditions.lastTransitionTime (Time)，必需

      lastTransitionTime 是状况从一个状态转换到另一个状态的上次时间。这应该是底层状况发生变化的时间。如果未知，则使用 API 字段发生变化的时间也是可以接受的。

      Time 是 time.Time 的一个包装器，支持正确地 marshaling 到 YAML 和 JSON。它提供了 time 包中许多工厂方法的包装器。

    • conditions.message (string)，必需

      message 是一个人类可读的消息，指示关于转换的详细信息。这可能是一个空字符串。

    • conditions.reason (string)，必需

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

    • conditions.status (string)，必需

      状况的状态，为 True, False, Unknown 之一。

    • conditions.type (string)，必需

      状况的类型，采用 CamelCase 或 foo.example.com/CamelCase 格式。

    • conditions.observedGeneration (int64)

      observedGeneration 表示状况所基于的 .metadata.generation。例如，如果 .metadata.generation 当前为 12，但 .status.conditions[x].observedGeneration 为 9，则状况与实例的当前状态不一致。

ServiceCIDRList

ServiceCIDRList 包含 ServiceCIDR 对象的列表。

操作

get 读取指定的 ServiceCIDR

HTTP 请求

GET /apis/networking.k8s.io/v1/servicecidrs/{name}

参数

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

    ServiceCIDR 的名称

  • pretty (在查询中): string

    pretty

响应

200 (ServiceCIDR): OK

401: 未经授权

get 读取指定的 ServiceCIDR 的状态

HTTP 请求

GET /apis/networking.k8s.io/v1/servicecidrs/{name}/status

参数

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

    ServiceCIDR 的名称

  • pretty (在查询中): string

    pretty

响应

200 (ServiceCIDR): OK

401: 未经授权

list 列出或监控 ServiceCIDR 类型的对象

HTTP 请求

GET /apis/networking.k8s.io/v1/servicecidrs

参数

响应

200 (ServiceCIDRList): OK

401: 未经授权

create 创建 ServiceCIDR

HTTP 请求

POST /apis/networking.k8s.io/v1/servicecidrs

参数

响应

200 (ServiceCIDR): OK

201 (ServiceCIDR): 已创建

202 (ServiceCIDR): 已接受

401: 未经授权

update 替换指定的 ServiceCIDR

HTTP 请求

PUT /apis/networking.k8s.io/v1/servicecidrs/{name}

参数

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

    ServiceCIDR 的名称

  • body: ServiceCIDR，必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (ServiceCIDR): OK

201 (ServiceCIDR): 已创建

401: 未经授权

update 替换指定的 ServiceCIDR 的状态

HTTP 请求

PUT /apis/networking.k8s.io/v1/servicecidrs/{name}/status

参数

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

    ServiceCIDR 的名称

  • body: ServiceCIDR，必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (ServiceCIDR): OK

201 (ServiceCIDR): 已创建

401: 未经授权

patch 部分更新指定的 ServiceCIDR

HTTP 请求

PATCH /apis/networking.k8s.io/v1/servicecidrs/{name}

参数

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

    ServiceCIDR 的名称

  • body: Patch，必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (ServiceCIDR): OK

201 (ServiceCIDR): 已创建

401: 未经授权

patch 部分更新指定的 ServiceCIDR 的状态

HTTP 请求

PATCH /apis/networking.k8s.io/v1/servicecidrs/{name}/status

参数

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

    ServiceCIDR 的名称

  • body: Patch，必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (在查询中): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (ServiceCIDR): OK

201 (ServiceCIDR): 已创建

401: 未经授权

delete 删除 ServiceCIDR

HTTP 请求

DELETE /apis/networking.k8s.io/v1/servicecidrs/{name}

参数

响应

200 (Status): OK

202 (Status): 已接受

401: 未经授权

deletecollection 删除 ServiceCIDR 集合

HTTP 请求

DELETE /apis/networking.k8s.io/v1/servicecidrs

参数

响应

200 (Status): OK

401: 未经授权

本页面是自动生成的。

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

最后修改时间 2025 年 4 月 24 日太平洋标准时间上午 9:14：v1.33 的 Markdown API 参考 (b84ec30bbb)