Get Available Bandwidths
GET/networking/vxc_bandwidths
Get a list of available bandwidths for VXC creation
Request
Query Parameters
The id
of the site you want to filter on
The cloud provider you want to filter on
The cloud region you want to filter on
Whether you want to see only local regions
Responses
200: Successful response
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
data
object[]
The id
of the site
Cloud provider
Cloud region
Whether the cloud region is local to the site or not
bandwidths
object[]
required
Bandwidth in Mbps
Currency the price is listed in
Amount the VXC will cost
The type of record being returned. This will always be vxc_bandwidth
.
meta
object
Total number of pages based on pagination settings
Total number of results
Current Page based on pagination settings (included when defaults are used.)
Number of results to return per page based on pagination settings (included when defaults are used.)
{
"data": [
{
"site_id": "string",
"cloud_provider": "string",
"cloud_region": "string",
"local": true,
"bandwidths": [
{
"bandwidth_mbps": 0,
"currency": "string",
"amount": 0
}
],
"record_type": "string"
}
],
"meta": {
"total_pages": 13,
"total_results": 13,
"page_number": 3,
"page_size": 1
}
}
401: Authentication error
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
errors
object[]
an application-specific error code, expressed as a stringified integer.
a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. Do not include punctuation in the title.
a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.
JSON pointer to the field which is causing the error.
{
"errors": [
{
"code": "10001",
"title": "error title",
"detail": "additional detail about the error",
"pointer": "/pointer/to/field"
}
]
}
403: Authorization error
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
errors
object[]
an application-specific error code, expressed as a stringified integer.
a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. Do not include punctuation in the title.
a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.
JSON pointer to the field which is causing the error.
{
"errors": [
{
"code": "10001",
"title": "error title",
"detail": "additional detail about the error",
"pointer": "/pointer/to/field"
}
]
}