Ringkasan IP Address Management API

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

Untuk menggunakan IPAM API, sebaiknya gunakan gdcloud CLI, atau panggil API secara langsung menggunakan kubectl CLI. 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 discovery

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

Endpoint API untuk IPAM API zona dan global masing-masing 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 discovery 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 zona:

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