IP 地址管理 API 概览

IP 地址管理 (IPAM) API 使用 Kubernetes 自定义资源，并依赖于 Kubernetes 资源模型 (KRM)。它用于管理 Google Distributed Cloud (GDC) 经过网闸隔离的设备部署中的 IP 地址分配。

如需使用 IPAM API，我们建议您使用 gdcloud CLI，或使用 kubectl CLI 直接调用该 API。如果您的应用需要使用自己的库来调用此 API，请使用以下示例和完整的 API 定义来构建请求。

服务端点和发现文档

以下网址是 IPAM KRM API 的 API 端点：

https://MANAGEMENT_API_SERVER_ENDPOINT/apis/ipam.gdc.goog/v1

将 MANAGEMENT_API_SERVER_ENDPOINT 替换为 Management API 服务器的端点。

使用 kubectl proxy 命令，您可以在浏览器中或使用 curl 等工具访问该网址，以获取 IPAM API 的发现文档。kubectl proxy 命令会在本地机器上打开一个指向 Kubernetes API 服务器的代理。该命令运行后，您可以通过以下网址访问文档：http://127.0.0.1:8001/apis/ipam.gdc.goog/v1。

自定义资源示例

以下是 Subnet 对象的示例：

apiVersion: ipam.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/overlay-network-type: External
    ipam.gdc.goog/category-type: ExternalOverlayNetwork
  name: test-subnet
  namespace: root
spec:
  type: Root
  ipv4Request:
    cidr: 10.0.0.0/16
  networkSpec:
    staticVLANID: 100
    enableVLANID: true
    enableGateway: true