Assigns a set of IPv4 addresses and IPv6 ranges to Linodes within a single region. This operation lets you swap, shuffle, or reorganize IP addresses among your Linodes, and assign reserved IPs that aren't currently assigned to specific Linode instances.

The following restrictions apply:

• All addresses must be an IPv4 address or an IPv6 range you can access in the specified region. This includes unassigned reserved IP addresses belonging to your account.
• If you specify a reserved IP, it must be reserved in your account. Assigning an unassigned reserved IP moves the IP from your account's general pool and becomes an assigned resource tied to a specific Linode interface. Using a reserved IP that you don't own results in a 400 error.
• You can't swap an assigned reserved IP with a newly created ephemeral IP using this operation. To convert or toggle the status of an IP, use the Update an IP address's RDNS and reserved setting operation.
• All Linodes need to have at least one public IPv4 address assigned.
• Linodes that use Linode interfaces can't be assigned a private IPv4 address.
• Linodes that use configuration profile interfaces may have a maximum of one assigned private IPv4 address.
• Linodes are restricted to one assigned IPv6 range.
• Shared IP addresses can't be swapped between Linodes.

Open a support ticket to request additional IPv4 addresses or IPv6 ranges beyond standard account limits.

📘

Removing an IP address that has been set as a Managed Linode's ssh.ip causes the Managed Linode's SSH access settings to reset to their default values.

To view and configure Managed Linode SSH settings, use the following operations:

• Get a Linode's managed settings
• Update a Linode's managed settings

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

• OAuth scopes. Your user needs these scopes assigned. Learn more.

  • Scopes: ips:read_write, linodes:read_write

CLI

linode-cli networking ip-assign \
  --region us-east \
  --assignments.address 192.0.2.1 \
  --assignments.linode_id 123 \
  --assignments.address 2001:db8:3c4d:15::/64 \
  --assignments.linode_id 234

Learn more