Skip to main content
Calico Cloud documentation

IPAM configuration

An IPAM configuration resource (IPAMConfiguration) represents global IPAM configuration options.

Sample YAML

apiVersion: projectcalico.org/v3
kind: IPAMConfiguration
metadata:
name: default
spec:
strictAffinity: false
maxBlocksPerHost: 4
kubeVirtVMAddressPersistence: Disabled

IPAM configuration definition

Metadata

FieldDescriptionAccepted ValuesSchema
nameUnique name to describe this resource instance. Required.defaultstring

The resource is a singleton which must have the name default.

Spec

FieldDescriptionAccepted ValuesSchemaDefault
strictAffinityWhen StrictAffinity is true, borrowing IP addresses is not allowed.true, falseboolfalse
maxBlocksPerHostThe max number of blocks that can be affine to each host.0 - max(int32)int20
kubeVirtVMAddressPersistenceControls whether KubeVirt VMs retain persistent IP addresses across lifecycle events such as restart or migration. Requires KubeVirt.Enabled, DisabledstringDisabled

Supported operations

Datastore typeCreateDeleteUpdateGet/List
etcdv3YesYesYesYes
Kubernetes API serverYesYesYesYes