Networking

Configure IP Sharing

post
https://api.linode.com/v4/networking/ipv4/share

Configure shared IPs. A shared IP may be brought up on a Linode other than the one it lists in its response. This can be used to allow one Linode to begin serving requests should another become unresponsive.

Authorizations

Personal Access Token
OAuth: ( ips:read_writelinodes:read_write)

Request Body Schema

ips
Required
array

A list of IPs that will be shared with this Linode. When this is finished, the given Linode will be able to bring up these addresses in addition to the Linodes that these addresses belong to. You must have access to all of these addresses and they must be in the same Region as the Linode.

linode_id
Required
integer

The ID of the Linode that the addresses will be shared with.

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X POST -d '{
      "linode_id": 123,
      "ips": [
        "12.34.56.78"
      ]
    }' \
    https://api.linode.com/v4/networking/ipv4/share

Response Samples

{}

Responses

200: Sharing configured successfully.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.