IP addresses in the US-West-1 data center are assigned to you automatically when your GoGrid account is created. IP addresses in US-East-1 are dynamically assigned; these IP addresses will automatically be allocated when you either add a cloud server via the customer portal or make a grid.ip.list call with datacenter set to US-East-1 (see the next section).
A common list response , filtered to return unassigned public IPs.
JSON Response
{
"list": [
{
"datacenter": {
"description": "US West 1 Datacenter",
"id": 1,
"name": "US-West-1",
"object": "option"
},
"id": 65669,
"ip": "208.113.110.132",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "208.113.110.128/255.255.255.240"
},
{
"datacenter": {
"description": "US West 1 Datacenter",
"id": 1,
"name": "US-West-1",
"object": "option"
},
"id": 65670,
"ip": "208.113.110.133",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "208.113.110.128/255.255.255.240"
},
{
"datacenter": {
"description": "US West 1 Datacenter",
"id": 1,
"name": "US-West-1",
"object": "option"
},
"id": 65674,
"ip": "208.113.110.137",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "208.113.110.128/255.255.255.240"
},
{
"datacenter": {
"description": "US West 1 Datacenter",
"id": 1,
"name": "US-West-1",
"object": "option"
},
"id": 65675,
"ip": "208.113.110.138",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "208.113.110.128/255.255.255.240"
},
{
"datacenter": {
"description": "US West 1 Datacenter",
"id": 1,
"name": "US-West-1",
"object": "option"
},
"id": 65676,
"ip": "208.113.110.139",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "208.113.110.128/255.255.255.240"
},
{
"datacenter": {
"description": "US West 1 Datacenter",
"id": 1,
"name": "US-West-1",
"object": "option"
},
"id": 65677,
"ip": "208.113.110.140",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "208.113.110.128/255.255.255.240"
},
{
"datacenter": {
"description": "US West 1 Datacenter",
"id": 1,
"name": "US-West-1",
"object": "option"
},
"id": 65678,
"ip": "208.113.110.141",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "208.113.110.128/255.255.255.240"
},
{
"datacenter": {
"description": "US West 1 Datacenter",
"id": 1,
"name": "US-West-1",
"object": "option"
},
"id": 65679,
"ip": "208.113.110.142",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "208.113.110.128/255.255.255.240"
},
{
"datacenter": {
"description": "US East 1 Datacenter",
"id": 2,
"name": "US-East-1",
"object": "option"
},
"id": 232315,
"ip": "204.51.198.74",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "204.51.198.64/255.255.255.240"
},
{
"datacenter": {
"description": "US East 1 Datacenter",
"id": 2,
"name": "US-East-1",
"object": "option"
},
"id": 232316,
"ip": "204.51.198.75",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "204.51.198.64/255.255.255.240"
},
{
"datacenter": {
"description": "US East 1 Datacenter",
"id": 2,
"name": "US-East-1",
"object": "option"
},
"id": 232317,
"ip": "204.51.198.76",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "204.51.198.64/255.255.255.240"
},
{
"datacenter": {
"description": "US East 1 Datacenter",
"id": 2,
"name": "US-East-1",
"object": "option"
},
"id": 232318,
"ip": "204.51.198.77",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "204.51.198.64/255.255.255.240"
},
{
"datacenter": {
"description": "US East 1 Datacenter",
"id": 2,
"name": "US-East-1",
"object": "option"
},
"id": 232319,
"ip": "204.51.198.78",
"object": "ip",
"public": true,
"state": {
"description": "IP is available to use",
"id": 1,
"name": "Unassigned",
"object": "option"
},
"subnet": "204.51.198.64/255.255.255.240"
}
],
"method": "/grid/ip/list",
"status": "success",
"summary": {
"numpages": 0,
"returned": 13,
"start": 0,
"total": 13
}
}
XML Response
<gogrid>
<response method="/grid/ip/list" status="success">
<summary total="13" start="0" numpages="0" returned="13"/>
<list>
<object name="ip">
<attribute name="id">65669</attribute>
<attribute name="ip">208.113.110.132</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">208.113.110.128/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">US-West-1</attribute>
<attribute name="description">US West 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">65670</attribute>
<attribute name="ip">208.113.110.133</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">208.113.110.128/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">US-West-1</attribute>
<attribute name="description">US West 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">65674</attribute>
<attribute name="ip">208.113.110.137</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">208.113.110.128/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">US-West-1</attribute>
<attribute name="description">US West 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">65675</attribute>
<attribute name="ip">208.113.110.138</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">208.113.110.128/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">US-West-1</attribute>
<attribute name="description">US West 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">65676</attribute>
<attribute name="ip">208.113.110.139</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">208.113.110.128/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">US-West-1</attribute>
<attribute name="description">US West 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">65677</attribute>
<attribute name="ip">208.113.110.140</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">208.113.110.128/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">US-West-1</attribute>
<attribute name="description">US West 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">65678</attribute>
<attribute name="ip">208.113.110.141</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">208.113.110.128/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">US-West-1</attribute>
<attribute name="description">US West 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">65679</attribute>
<attribute name="ip">208.113.110.142</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">208.113.110.128/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">US-West-1</attribute>
<attribute name="description">US West 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">232315</attribute>
<attribute name="ip">204.51.198.74</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">204.51.198.64/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">2</attribute>
<attribute name="name">US-East-1</attribute>
<attribute name="description">US East 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">232316</attribute>
<attribute name="ip">204.51.198.75</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">204.51.198.64/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">2</attribute>
<attribute name="name">US-East-1</attribute>
<attribute name="description">US East 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">232317</attribute>
<attribute name="ip">204.51.198.76</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">204.51.198.64/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">2</attribute>
<attribute name="name">US-East-1</attribute>
<attribute name="description">US East 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">232318</attribute>
<attribute name="ip">204.51.198.77</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">204.51.198.64/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">2</attribute>
<attribute name="name">US-East-1</attribute>
<attribute name="description">US East 1 Datacenter</attribute>
</object>
</attribute>
</object>
<object name="ip">
<attribute name="id">232319</attribute>
<attribute name="ip">204.51.198.78</attribute>
<attribute name="state">
<object name="option">
<attribute name="id">1</attribute>
<attribute name="name">Unassigned</attribute>
<attribute name="description">IP is available to use</attribute>
</object>
</attribute>
<attribute name="subnet">204.51.198.64/255.255.255.240</attribute>
<attribute name="public">true</attribute>
<attribute name="datacenter">
<object name="option">
<attribute name="id">2</attribute>
<attribute name="name">US-East-1</attribute>
<attribute name="description">US East 1 Datacenter</attribute>
</object>
</attribute>
</object>
</list>
</response>
</gogrid>
CSV Response
# SUCCESS, /grid/ip/list, TOTAL, 13, NUMPAGES, 0, START, 0, RETURNED, 13
# id,ip,state.id,state.name,state.description,subnet,public,datacenter.id,datacenter.name,datacenter.description
65669,208.113.110.132,1,Unassigned,IP is available to use,208.113.110.128/255.255.255.240,true,1,US-West-1,US West 1 Datacenter
65670,208.113.110.133,1,Unassigned,IP is available to use,208.113.110.128/255.255.255.240,true,1,US-West-1,US West 1 Datacenter
65674,208.113.110.137,1,Unassigned,IP is available to use,208.113.110.128/255.255.255.240,true,1,US-West-1,US West 1 Datacenter
65675,208.113.110.138,1,Unassigned,IP is available to use,208.113.110.128/255.255.255.240,true,1,US-West-1,US West 1 Datacenter
65676,208.113.110.139,1,Unassigned,IP is available to use,208.113.110.128/255.255.255.240,true,1,US-West-1,US West 1 Datacenter
65677,208.113.110.140,1,Unassigned,IP is available to use,208.113.110.128/255.255.255.240,true,1,US-West-1,US West 1 Datacenter
65678,208.113.110.141,1,Unassigned,IP is available to use,208.113.110.128/255.255.255.240,true,1,US-West-1,US West 1 Datacenter
65679,208.113.110.142,1,Unassigned,IP is available to use,208.113.110.128/255.255.255.240,true,1,US-West-1,US West 1 Datacenter
232315,204.51.198.74,1,Unassigned,IP is available to use,204.51.198.64/255.255.255.240,true,2,US-East-1,US East 1 Datacenter
232316,204.51.198.75,1,Unassigned,IP is available to use,204.51.198.64/255.255.255.240,true,2,US-East-1,US East 1 Datacenter
232317,204.51.198.76,1,Unassigned,IP is available to use,204.51.198.64/255.255.255.240,true,2,US-East-1,US East 1 Datacenter
232318,204.51.198.77,1,Unassigned,IP is available to use,204.51.198.64/255.255.255.240,true,2,US-East-1,US East 1 Datacenter
232319,204.51.198.78,1,Unassigned,IP is available to use,204.51.198.64/255.255.255.240,true,2,US-East-1,US East 1 Datacenter
Error Codes
| 400
| IllegalArgumentException
| Any problems with input parameters will generate an IllegalArgumentException.
|
| 401
| Unauthorized
| This error code will occur when the role tied to the API Key in your request has the wrong Access Controls.
|
| 403
| Authentication Failed
| This error code will occur when your request is not properly signed. Make sure your have a valid API key and secret and that you are properly generating a request signature. Ensure that the clock on the computer from which you are making the request is synchronized woth the GoGrid API Server.
|
| 404
| Not Found
| This error will occur if you have specified a method that does not exist or any other URL does not exists on the API Server.
|
| 500
| UnexpectedError
| These types of errors indicate an internal system problem. Depending on the severity of the error and whether not it is blocking your development, report the error to GoGrid support by emailing the response to apisupport@gogrid.com.
|