Get Ip Space
Retrieves the specified IP Space.
Request
URI
GET
https://{api_host}/cloudapi/1.0.0/ipSpaces/{ipSpaceId}
COPY
Path Parameters
string
ipSpaceId
Required
ipSpaceId
Responses
200
Returns
IpSpace
of type(s)
application/json;version=39.1
This response body class contains all of the following:
InlineIpSpace1
{
"status": {},
"id": "urn:vcloud:ipSpace:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "string",
"description": "string",
"type": "string",
"orgRef": {
"name": "string",
"id": "string"
},
"utilization": {
"floatingIPs": {
"totalCount": "string",
"allocatedCount": "string",
"usedCount": "string",
"unusedCount": "string",
"allocatedPercentage": "number",
"usedPercentage": "number"
},
"ipPrefixes": {
"prefixLengthUtilizations": [
{
"prefixLength": 0,
"totalCount": 0,
"allocatedCount": 0
}
]
}
},
"ipSpaceRanges": {
"ipRanges": [
{
"id": "string",
"startIpAddress": "string",
"endIpAddress": "string",
"totalIpCount": "string",
"allocatedIpCount": "string",
"allocatedIpPercentage": "number"
}
],
"defaultFloatingIpQuota": 0
},
"ipSpacePrefixes": [
{
"ipPrefixSequence": [
{
"id": "string",
"startingPrefixIpAddress": "string",
"prefixLength": 0,
"totalPrefixCount": 0,
"allocatedPrefixCount": 0,
"allocatedPrefixPercentage": "number"
}
],
"defaultQuotaForPrefixLength": 0
}
],
"ipSpaceInternalScope": [
"string"
],
"ipSpaceExternalScope": "string",
"routeAdvertisementEnabled": false,
"defaultGatewayServiceConfig": {
"enableDefaultSnatRuleCreation": false,
"enableDefaultNoSnatRuleCreation": false,
"enableDefaultFirewallRuleCreation": false
},
"canManageQuota": false
}
Code Samples
COPY
curl -H 'Authorization: <value>' https://{api_host}/cloudapi/1.0.0/ipSpaces/{ipSpaceId}
Availability
Added in 37.1
Ip Spaces Operations
POST
Apply Ip Space Default Edge Gateway Services
GET
Get Ip Space Summaries
POST
Create Ip Space
GET
Get Floating Ip Suggestions
GET
Get Ip Prefix Suggestions
GET
Get Ip Prefix Sequences
GET
Get Ip Space
PUT
Update Ip Space
DELETE
Delete Ip Space
POST
Allocate
GET
Get Ip Space Ip Allocations
GET
Get Ip Space Ip Allocation
PUT
Update Ip Space Ip Allocation
DELETE
Delete Ip Space Ip Allocation
POST
Apply Ip Space Default Provider Gateway Services