Share an IP Address

Verb	URI				Description
PUT	/servers/`id`/ips/public/`address`				Share an IP address to the specified server

Normal Response Code(s): 202

Error Response Code(s): cloudServersFault (400, 500), serviceUnavailable (503), unauthorized (401), badRequest (400), badMediaType(415), itemNotFound (404), overLimit (413)

Status Transition:	`ACTIVE` `SHARE_IP` `ACTIVE` (if configureServer is true)
	`ACTIVE` `SHARE_IP_NO_CONFIG` `ACTIVE`

This operation shares an IP from an existing server in the specified shared IP group to another specified server in the same group. By default, the operation modifies cloud network restrictions to allow IP traffic for the given IP to/from the server specified, but does not bind the IP to the server itself. A heartbeat facility (e.g. keepalived) can then be used within the servers to perform health checks and manage IP failover. If the configureServer attribute is set to true, the server is configured with the new address, though the address is not enabled. Note that configuring the server does require a reboot.

Example 4.17. Share IP Request: XML

<?xml version="1.0" encoding="UTF-8"?>

<shareIp xmlns="http://docs.rackspacecloud.com/servers/api/v1.0" 
	 sharedIpGroupId="1234" configureServer="true" />

Example 4.18. Share IP Response: JSON

{
    "shareIp" : {
        "sharedIpGroupId" : 1234,
        "configureServer" : true
    }
}

This operation does not return a response body.

Legal notices