> ## Documentation Index
> Fetch the complete documentation index at: https://datum-4926dda5-docs-api-reference-demo.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# IPAM

> IP address management on Datum Cloud — claims against allocatable pools and the allocations they produce.

Datum Cloud manages IP address space through the `ipam.miloapis.com` API. You submit a claim requesting a sub-prefix of a given size and family from an allocatable pool, and the system records the resulting allocation carved out of the pool. Claims and allocations are resources you create and inspect with `datumctl apply -f` and `datumctl get`.

<Warning>
  The IPAM API is **alpha** (`v1alpha1`). Fields and behavior may change in backward-incompatible ways between releases.
</Warning>

## Resources

<CardGroup cols={2}>
  <Card title="IPClaim" icon="ticket" href="/api/ipam/ipclaim">
    A request for a sub-prefix of a chosen size and IP family, satisfied from a referenced or selected pool.
  </Card>

  <Card title="IPAllocation" icon="layer-group" href="/api/ipam/ipallocation">
    A record of the CIDR carved out of an IPPool to satisfy an IPClaim.
  </Card>
</CardGroup>

**Platform-provided:** the [IPPool](/api/ipam/ippool) that a claim allocates from lives under [Platform resources](/api/platform/overview).

## How the pieces fit together

* An **IPClaim** requests a sub-prefix by IP family (`spec.ipFamily`) and size (`spec.prefixLength`), targeting an **IPPool** by reference (`spec.poolRef`) or selector (`spec.poolSelector`).
* An **IPAllocation** records the specific CIDR carved out of an **IPPool** to satisfy an **IPClaim**.

<Tip>
  Inspect the exact fields for any resource with `datumctl explain`, for example `datumctl explain ipclaims.spec` or `datumctl explain ipallocations.spec`.
</Tip>

## Learn more

* [API resources overview](/api/overview) — the resource reference landing page across all Datum Cloud services.
* [Changing resources](/datumctl/resources/changing) — how to apply, edit, and safely preview changes to these resources.