ipv6_ranges

Creates, updates, deletes, gets or lists an ipv6_ranges resource.

Overview

Name	ipv6_ranges
Type	Resource
Id	linode.networking.ipv6_ranges

Fields

The following fields are returned by SELECT queries:

get_ipv6_range

Returns IPv6 range information.

Name	Datatype	Description
is_bgp	boolean	Read-only Whether this IPv6 range is shared.
linodes	array	Read-only A list of Linodes targeted by this IPv6 range. Includes Linodes with IP sharing.
prefix	integer	The prefix length of the address. The total number of addresses that can be assigned from this range is calculated as 2<sup>(128 - prefix length)</sup>.
range	string	Read-only The IPv6 address of this range. (example: 2600:3c01::)
region	string	Read-only The region for this range of IPv6 addresses. (example: us-east)

get_ipv6_ranges

The IPv6 ranges on your Account.

Name	Datatype	Description
data	array
page	integer	Read-only The current page.
pages	integer	Read-only The total number of pages.
results	integer	Read-only The total number of results.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_ipv6_range	select			View IPv6 range information. Learn more... Learn more...
get_ipv6_ranges	select		page, page_size	Displays the IPv6 ranges on your Account. - An IPv6 range is a /64 or /56 block of IPv6 addresses routed to a single Linode in a given region. - Your Linode is responsible for routing individual addresses in the range, or handling traffic for all the addresses in the range. - Run the Create an IPv6 range operation to add a /64 or /56 block of IPv6 addresses to your account. Learn more... Learn more...
post_ipv6_range	insert	data__prefix_length		Creates an IPv6 Range and assigns it based on the provided Linode or route target IPv6 SLAAC address. See the ipv6 property when running the Get a Linode operation to view a Linode's IPv6 SLAAC address. - Either linode_id or route_target is required in a request. - linode_id and route_target are mutually exclusive. Submitting values for both properties in a request results in an error. - Upon a successful request, an IPv6 range is created in the region that corresponds to the provided linode_id or route_target. - Your Linode is responsible for routing individual addresses in the range, or handling traffic for all the addresses in the range. - Run the Assign IP addresses operation to re-assign IPv6 Ranges to your Linodes. > 📘 > > - A Linode can only have one IPv6 range targeting its SLAAC address. > - An account can only have one IPv6 range in each region. > - Open a support ticket to request expansion of these restrictions. Learn more... Learn more...
delete_ipv6_range	delete			Removes this IPv6 range from your account and disconnects the range from any assigned Linodes. > 📘 > > You can't delete shared IPv6 ranges. Contact Customer Support for assistance. Learn more... Learn more...

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.

Name	Datatype	Description
page	integer	The page of a collection to return.
page_size	integer	The number of items to return per page.

SELECT examples

get_ipv6_range

View IPv6 range information.

Learn more...

Learn more...

SELECT
is_bgp,
linodes,
prefix,
range,
region
FROM linode.networking.ipv6_ranges;

get_ipv6_ranges

Displays the IPv6 ranges on your Account.

- An IPv6 range is a /64 or /56 block of IPv6 addresses routed to a single Linode in a given region.

- Your Linode is responsible for routing individual addresses in the range, or handling traffic for all the addresses in the range.

- Run the Create an IPv6 range operation to add a /64 or /56 block of IPv6 addresses to your account.

Learn more...

Learn more...

SELECT
data,
page,
pages,
results
FROM linode.networking.ipv6_ranges
WHERE page = '{{ page }}'
AND page_size = '{{ page_size }}';

INSERT examples

post_ipv6_range

Creates an IPv6 Range and assigns it based on the provided Linode or route target IPv6 SLAAC address. See the ipv6 property when running the Get a Linode operation to view a Linode's IPv6 SLAAC address.

- Either linode_id or route_target is required in a request.
- linode_id and route_target are mutually exclusive. Submitting values for both properties in a request results in an error.
- Upon a successful request, an IPv6 range is created in the region that corresponds to the provided linode_id or route_target.
- Your Linode is responsible for routing individual addresses in the range, or handling traffic for all the addresses in the range.
- Run the Assign IP addresses operation to re-assign IPv6 Ranges to your Linodes.

> 📘
>
> - A Linode can only have one IPv6 range targeting its SLAAC address.
> - An account can only have one IPv6 range in each region.
> - Open a support ticket to request expansion of these restrictions.

Learn more...

Learn more...

INSERT INTO linode.networking.ipv6_ranges (
data__linode_id,
data__prefix_length,
data__route_target
)
SELECT 
{{ linode_id }},
{{ prefix_length }} --required,
'{{ route_target }}'
RETURNING
range,
route_target
;

Manifest

# Description fields are for documentation purposes
- name: ipv6_ranges
  props:
    - name: linode_id
      value: integer
      description: >
        The ID of the Linode to assign this range to. The SLAAC address for the provided Linode is used as the range's `route_target`.

- __Required__ if `route_target` is omitted from the request.

- Mutually exclusive with `route_target`. Submitting values for both properties in a request results in an error.
        
    - name: prefix_length
      value: integer
      description: >
        The prefix length of the IPv6 range.
        
      valid_values: ['56', '64']
    - name: route_target
      value: string
      description: >
        The IPv6 SLAAC address to assign this range to.

- __Required__ if `linode_id` is omitted from the request.

- Mutually exclusive with `linode_id`. Submitting values for both properties in a request results in an error.

> 📘
>
> You need to omit the `/128` prefix length of the SLAAC address when using this property.
        

DELETE examples

delete_ipv6_range

Removes this IPv6 range from your account and disconnects the range from any assigned Linodes.

> 📘
>
> You can't delete shared IPv6 ranges. Contact Customer Support for assistance.

Learn more...

Learn more...

DELETE FROM linode.networking.ipv6_ranges;