Présentation de l'API IP Address Management

L'API IP Address Management (IPAM) utilise des ressources personnalisées Kubernetes et s'appuie sur le modèle de ressources Kubernetes (KRM). Il gère l'attribution d'adresses IP dans un déploiement d'appliance Google Distributed Cloud (GDC) sous air gap.

Pour utiliser l'API IPAM, nous vous recommandons d'utiliser la gdcloud CLI ou d'appeler l'API directement à l'aide de la CLI kubectl. Si votre application doit utiliser vos propres bibliothèques pour appeler cette API, utilisez les exemples suivants et la définition complète de l'API pour créer vos requêtes.

Point de terminaison du service et document de découverte

L'URL suivante est le point de terminaison de l'API KRM IPAM :

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

Remplacez MANAGEMENT_API_SERVER_ENDPOINT par le point de terminaison du serveur de l'API Management.

À l'aide de la commande kubectl proxy, vous pouvez accéder à cette URL dans votre navigateur ou avec un outil tel que curl pour obtenir le document de découverte de l'API IPAM. La commande kubectl proxy ouvre un proxy vers le serveur d'API Kubernetes sur votre machine locale. Une fois cette commande exécutée, vous pouvez accéder au document à l'URL suivante : http://127.0.0.1:8001/apis/ipam.gdc.goog/v1.

Exemples de ressources personnalisées

Voici un exemple d'objet 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