Target an existing image and replicate it to another compute region.

📘

As part of our limited promotional period, image replicas are free of charge until November 1, 2025. After this date, replicas will be subject to our standard monthly rate of $0.10/GB. When replicas become billable, your monthly charge will be calculated using the value returned in total_size, divided by 100. Learn more.

• This is only available in a region that supports Object Storage, which stores the replicated image. Run the List regions operation to review a region's capabilities.

• To replicate an image, it needs to have a status of available. Run the List images operation to view an image's status.

• To also keep the target image in its original compute region, you need to include that region in the request's data. If you leave it out, the API removes the image from that region. Run the Get an image operation to see the regions where an image currently exists.

• You can't include an empty array to delete all images. You need to provide at least one compute region where the image is available. Use the Delete an image operation.

Permissions and scopes

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

• Identity and access permissions. Your user needs a role with these permissions. Learn more.

  • Permissions: replicate_image

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

  • Scopes: images:read_write

CLI

linode-cli images replicate private/12345 \
  --regions "us-mia" \
  --regions "us-east"

Learn more