IP Blocks
IP blocks, their IPv4 addresses and reservations.
Endpoints
- GETRetrieve IPv4 from an IP block ●
/connectivity/ipblocks/{blockId}/ipv4Paged IPv4 addresses in a block with their assignment, filterable by address, reservation, assignment and server. - POSTAdd IPv4 addresses to an IP block
/connectivity/ipblocks/{blockId}/ipv4Add addresses to an IPv4 block, as a start to end range or as a network given by address and prefix . An address already in a block stays where it is and is… - GETRetrieve IP blocks
/connectivity/ipblocksPaged list of IPv4 and IPv6 blocks. - POSTCreate an IP block ●
/connectivity/ipblocksCreate an IPv4 or IPv6 block. name and type are enough; any field the update accepts can be sent too, so one call can create a configured, enabled block. - GETRetrieve an IP block
/connectivity/ipblocks/{blockId}One IP block by ID. - PUTUpdate an IP block ●
/connectivity/ipblocks/{blockId}Change a block's settings. Send only the fields to change, named as the block GET names them. Changing an IPv6 source prefix deletes the generated subnets and… - DELETEDelete an IP block ●
/connectivity/ipblocks/{blockId}Delete a block with its addresses or subnets, blacklist, hypervisor assignments and group memberships. Needs confirm: true ; refused while anything in it is… - GETRetrieve the hypervisors an IP block is bound to ●
/connectivity/ipblocks/{blockId}/hypervisorsThe hypervisors the block is bound to directly, with the network it uses and its allocation order on each. - GETRetrieve IPv6 subnets from an IP block ●
/connectivity/ipblocks/{blockId}/ipv6Paged generated subnets of an IPv6 block with their assignment, filterable by subnet, reservation, assignment and server. - POSTGenerate IPv6 subnets for an IP block ●
/connectivity/ipblocks/{blockId}/ipv6/generateCreate the next count subnets from the block's source prefix, skipping existing and blacklisted ones. A capped scan returns scannedTo ; send it back as after… - DELETEDelete a generated IPv6 subnet ●
/connectivity/ipblocks/{blockId}/ipv6/{subnetId}Remove one unassigned generated subnet with its addresses. The generator reuses the gap. - GETRetrieve the IPv6 blacklist of an IP block ●
/connectivity/ipblocks/{blockId}/blacklistThe subnets of an IPv6 block that are never generated or handed out. - POSTBlacklist an IPv6 subnet ●
/connectivity/ipblocks/{blockId}/blacklistKeep one subnet of an IPv6 block out of generation and allocation. Any address inside the subnet may be sent. - DELETERemove an IPv6 subnet from the blacklist ●
/connectivity/ipblocks/{blockId}/blacklist/{entryId}Allow the subnet to be generated and handed out again. - GETRetrieve IP block groups ●
/connectivity/ipblockgroupsPaged block groups with their blocks and the hypervisor networks bound to them. - POSTCreate an IP block group ●
/connectivity/ipblockgroupsCreate a block group, optionally with its first blocks. Hypervisor networks are pointed at groups through the hypervisor network endpoints. - GETRetrieve an IP block group ●
/connectivity/ipblockgroups/{groupId}One group with its blocks and the hypervisor networks bound to it. - PUTRename an IP block group ●
/connectivity/ipblockgroups/{groupId}Change the group's name. Membership is changed one block at a time through the blocks endpoints. - DELETEDelete an IP block group ●
/connectivity/ipblockgroups/{groupId}Delete a group and its memberships. Refused while a hypervisor network is bound to it. - POSTAdd an IP block to a group ●
/connectivity/ipblockgroups/{groupId}/blocksPut one block in the group. Adding a block that is already in the group answers 200 with the group unchanged, so repeating a request is safe. - DELETERemove an IP block from a group ●
/connectivity/ipblockgroups/{groupId}/blocks/{blockId}Take one block out of the group. Servers already holding addresses from the block keep them. - GETRetrieve the IP audit log ●
/connectivity/ipauditPaged history of IPv4 addresses and IPv6 subnets assigned to and released from servers, newest first. Names are as they were at the time of the event. - GETExport the IP audit log ●
/connectivity/ipaudit/exportThe same entries as the list, streamed as one download in id order with UTC timestamps: JSON, YAML or CSV. Takes the same filters. - PUTReserve/Unreserve an IPv4 address ●
/connectivity/ipv4/reserveReserve or unreserve a single IPv4 address. Reserved addresses are skipped by automatic allocation. - PUTSet or clear the MAC address of an IPv4 address ●
/connectivity/ipv4/macRecord a MAC address against an IPv4 address, or clear it with null. It replaces the interface's MAC in the configuration at the next start.