Ringkasan IP Address Management API

IP Address Management (IPAM) API menggunakan resource kustom Kubernetes dan mengandalkan Model Resource Kubernetes (KRM). Layanan ini mengelola alokasi alamat IP di seluruh deployment air gap Google Distributed Cloud (GDC).

Untuk menggunakan IPAM API, sebaiknya gunakan gcloud CLI, atau panggil API secara langsung menggunakan CLI kubectl. Jika aplikasi Anda perlu menggunakan library Anda sendiri untuk memanggil API ini, gunakan contoh berikut dan definisi API lengkap untuk membuat permintaan Anda:

Endpoint layanan dan dokumen penemuan

IPAM API disediakan dalam dua paket, bergantung pada deployment zonal atau deployment global.

Endpoint API untuk API IPAM zonal dan global adalah sebagai berikut:

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

Variabel MANAGEMENT_API_SERVER_ENDPOINT adalah endpoint server Management API.

Dengan menggunakan perintah kubectl proxy, Anda dapat mengakses URL tersebut di browser atau dengan alat seperti curl untuk mendapatkan dokumen penemuan untuk IPAM API. Perintah kubectl proxy membuka proxy ke server Kubernetes API di komputer lokal Anda. Setelah perintah tersebut berjalan, Anda dapat mengakses dokumen di URL berikut:

  • http://127.0.0.1:8001/apis/ipam.gdc.goog/v1
  • http://127.0.0.1:8001/apis/ipam.global.gdc.goog/v1

Contoh resource kustom

Berikut adalah contoh objek Subnet zonal:

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

Berikut adalah contoh objek Subnet global untuk CIDR root VPC default:

apiVersion: ipam.global.gdc.goog/v1
kind: Subnet
metadata:
  labels:
    ipam.gdc.goog/vpc: default-vpc
    ipam.gdc.goog/usage: network-root-range
  name: default-vpc-root-cidr
  namespace: platform
spec:
  ipv4Request:
    cidr: 10.200.0.0/23
  type: Root