Skip to main content

byoip_prefix_resources

Creates, updates, deletes, gets or lists a byoip_prefix_resources resource.

Overview

Namebyoip_prefix_resources
TypeResource
Iddigitalocean.network.byoip_prefix_resources

Fields

The following fields are returned by SELECT queries:

List of IP addresses assigned to resources (such as Droplets) in a BYOIP prefix

NameDatatypeDescription
idinteger (int64)Unique identifier for the allocation
assigned_atstring (date-time)Time when the allocation was assigned (example: 2025-06-25T12:00:00Z)
byoipstringThe BYOIP prefix UUID (example: f47ac10b-58cc-4372-a567-0e02b2c3d479)
regionstringRegion where the allocation is made (example: nyc3)
resourcestringThe resource associated with the allocation (example: do:droplet:fa3c10b-58cc-4372-a567-0e02b2c3d479)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
byoip_prefixes_list_resourcesselectbyoip_prefix_uuidper_page, pageTo list resources associated with BYOIP prefixes, send a GET request to /v2/byoip_prefixes/{byoip_prefix_uuid}/ips.

A successful response will return a list of resources associated with the specified BYOIP prefix.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
byoip_prefix_uuidstring (uuid)The unique identifier for the BYOIP Prefix. (example: f47ac10b-58cc-4372-a567-0e02b2c3d479)
pageintegerWhich 'page' of paginated results to return. (example: 1)
per_pageintegerNumber of items returned per page (example: 2)

SELECT examples

To list resources associated with BYOIP prefixes, send a GET request to /v2/byoip_prefixes/{byoip_prefix_uuid}/ips.

A successful response will return a list of resources associated with the specified BYOIP prefix.

SELECT
id,
assigned_at,
byoip,
region,
resource
FROM digitalocean.network.byoip_prefix_resources
WHERE byoip_prefix_uuid = '{{ byoip_prefix_uuid }}' -- required
AND per_page = '{{ per_page }}'
AND page = '{{ page }}';