Create Shared IP Group

Verb URI Description
POST /shared_ip_groups Create a new shared ip group

Normal Response Code(s): 201

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

This operation creates a new shared IP group. Please note, all responses to requests for shared_ip_groups return an array of servers. However, on a create request, the shared IP group can be created empty or can be initially populated with a single server. Submitting a create request with a sharedIpGroup that contains an array of servers will generate a badRequest (400) fault.

Example 4.47. Shared IP Group Create Request: XML

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

<sharedIpGroup
    xmlns="http://docs.rackspacecloud.com/servers/api/v1.0"
	 name="Shared IP Group 1">
  <server id="422"/>
</sharedIpGroup>

Example 4.48. Shared IP Group Create Request: JSON

{
    "sharedIpGroup" : {
        "name" : "Shared IP Group 1",
        "server" : 422
    }
}

Example 4.49. Shared IP Group Create Response: XML

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

<sharedIpGroup
    xmlns="http://docs.rackspacecloud.com/servers/api/v1.0"
    id="1234" name="Shared IP Group 1">
  <servers>
    <server id="422"/>
  </servers>
</sharedIpGroup>

Example 4.50. Shared IP Group Create Response: JSON

{
    "sharedIpGroup" : {
        "id" : 1234,
        "name" : "Shared IP Group 1",
        "servers" : [422]
    }
}

Legal notices