本頁面由 Cloud Translation API 翻譯而成。

KRM API ipam.gdc.goog/v1

ipam.gdc.goog/v1

包含 IP 位址管理(IPAM) API 群組的 API 結構定義。

CIDREntry

代表 CIDR 項目，並識別 IP 版本。

顯示位置： - NetworkStatus

欄位	說明
`version` IPFamily	項目的 IP 位址版本。
`cidr` 字串	項目的 CIDR。

NetworkSpec

內含設定 Subnet 網路功能的資訊。

出現位置： - SubnetSpec

欄位	說明
`enableGateway` boolean	指定是否必須為子網路指派閘道 IP 位址。
`enableVLANID` boolean	指定是否必須為子網路指派 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 的狀態。