此页面由 Cloud Translation API 翻译。

KRM API ipam.gdc.goog/v1

ipam.gdc.goog/v1

包含 IP 地址管理(IPAM) API 组的 API 架构定义。

CIDREntry

表示已确定 IP 版本的 CIDR 条目。

字段	说明
`version` IPFamily	条目的 IP 地址版本。
`cidr` 字符串	相应条目的 CIDR。

NetworkSpec

包含用于为 Subnet 设置网络功能的信息。

来源： - SubnetSpec

字段	说明
`enableGateway` 布尔值	指定是否必须为子网分配网关 IP 地址。
`enableVLANID` 布尔值	指定是否必须为子网分配 VLAN ID。
`staticVLANID` 整数	专用 VLAN ID。如果定义了此字段，则 `VLANID` 字段必须为 `true`。

NetworkStatus

包含网络配置的分配结果。

来源： - SubnetStatus

字段	说明
`vlanID` 整数	为子网获取的 VLAN ID。
`gateways` CIDREntry 数组	为子网获取的网关 IP 地址。如果子网是单栈子网，则列表中必须只有一个 IPv4/IPv6 IP 地址。如果子网是双栈，则列表中必须包含一个 IPv4 地址和一个 IPv6 IP 地址。

子网

表示区域 Subnet 的请求和分配信息。

来源： - SubnetList

字段	说明
`apiVersion` 字符串	`ipam.gdc.goog/v1`
`kind` 字符串	`Subnet`
`metadata` ObjectMeta	如需了解 `metadata` 的字段，请参阅 Kubernetes API 文档。
`spec` SubnetSpec
`status` SubnetStatus

SubnetAllocation

包含 Subnet 的单个 IP 版本（IPv4/IPv6）的 CIDR 分配结果。

来源： - SubnetStatus

字段	说明
`cidr` 字符串	分配给子网的 CIDR。
`availableCIDRs` 字符串数组	排除子网子项使用的 CIDR 后剩余的 CIDR。

SubnetList

表示 Subnet 资源的集合。

字段	说明
`apiVersion` 字符串	`ipam.gdc.goog/v1`
`kind` 字符串	`SubnetList`
`metadata` ListMeta	如需了解 `metadata` 的字段，请参阅 Kubernetes API 文档。
`items` 子网数组

SubnetReference

包含用于引用单个 Subnet 的信息。

显示在： - SubnetSpec - SubnetStatus

字段	说明
`name` 字符串
`namespace` 字符串	所引用子网的命名空间。如果它在规范中使用，则命名空间可以留空，这意味着被引用的子网与引用它的对象位于同一命名空间中。

SubnetRequest

包含单个 IP 地址版本 (IPv4/IPv6) 的 IP 地址声明信息。

来源： - SubnetSpec

字段	说明
`cidr` 字符串	要分配的 CIDR。获取专用 CIDR 时，必须指定此字段。
`prefixLength` 整数	所需 CIDR 的前缀长度。如果对要分配的 CIDR 没有具体要求，则可以指定此字段。如果 CIDR 和前缀均留空，则请求默认获取 /32(IPv4) 或 /128(IPv6) 随机 CIDR。

SubnetSpec

定义 Subnet 的规范。

显示在： - 子网

字段	说明
`type` SubnetType	在 IPAM 树架构的上下文中，子网的类型。
`ipv4Request` SubnetRequest	用于获取 IPv4 CIDR 的请求详细信息。
`ipv6Request` SubnetRequest	用于获取 IPv6 CIDR 的请求详细信息。
`parentReference` SubnetReference	对相应子网的父级的引用。如果指定了父级，此子网将从父级获取分配的 IP。如果存在父级，则必须提供父级名称。仅当父级与此子网位于同一命名空间中时，才能省略父级的命名空间。
`networkSpec` NetworkSpec	设置网络配置所需的规范。如果 `Subnet` 不涉及网络，则此字段应为空。

SubnetStatus

定义 Subnet 的状态。