Get a virtual network by its identifier
GET/v1/projects/:projectId/zones/:zoneName/virtualnetworks/:virtualNetworkId
Return Virtual Network resource with its identifier (in the path).
Request
Path Parameters
Project Identifier
Zone name
Virtual network Identifier
Header Parameters
Your SIU token if you use this API through Orange Developer.
Bearer access token authentication if you use this API through Orange Developer or Orange Developer Inside.
Your SIU Id if you use this API through Orange Developer Inside.
Responses
- 200
- 400
- 401
- 403
- 404
- 405
- 500
- 503
Ok
- application/json
- Schema
- Example (auto)
Schema
- creating: resource creation in progress
- updating: resource update in progress
- deleting: resource deletion in progress
- active: resource created/updated successfully
- error: resource in error because the last creation/update/deletion failed
Id of the Virtual Network.
HREF of the Virtual Network.
Name of the Virtual Network. Must be unique within the project for a zone. Cannot be updated.
Possible values: <= 40 characters
, Value must match regular expression [A-Za-z0-9-]
Description of the Virtual Network
tags object
Date when the Virtual Network was created.
Date when the Virtual Network was last modified.
User name (CUID or SIUID) associated with the last modification request (creation, update or deletion).
Provisioning state of the resource. Possible state:
Possible values: [creating
, updating
, deleting
, active
, error
]
vpns object[]
subnets object[]required
hostRoutes object[]
Network routes that are pushed on the vrouter. In a general case, this option is used in combination with host routes. NB: impact service if routes are removed.
routingPolicyRefs object[]
{
"id": "string",
"hRef": "string",
"name": "string",
"description": "string",
"tags": {},
"createdDate": "string",
"lastModifiedDate": "string",
"lastRequesterId": "string",
"provisioningState": "creating",
"vpns": [
{
"vpnName": "string",
"vnRole": "any-to-any"
}
],
"subnets": [
{
"subnet": "string",
"enableDhcp": true,
"allocateIpAddressFromStart": true,
"dnsPrimary": "string",
"dnsSecondary": "string",
"allocationPools": [
{
"start": "string",
"end": "string"
}
],
"hostRoutes": [
{
"prefix": "string",
"nextHop": "string"
}
],
"gatewayIpAddress": "string",
"serviceIpAddress": "string"
}
],
"hostRoutes": [
{
"prefix": "string",
"nextHop": "string"
}
],
"networkRoutes": [
{
"prefix": "string",
"nextHop": "string",
"communityTags": [
"string"
]
}
],
"routingPolicyRefs": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"hRef": "string"
}
]
}
Bad Request
Request is not valid
- application/json
- Schema
- Example (auto)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Unauthorized
Credentials are missing
- application/json
- Schema
- Example (auto)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Forbidden
Valid credentials but not enough privileges to perform the operation
- application/json
- Schema
- Example (auto)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Not Found
Unknown resource or service
- application/json
- Schema
- Example (auto)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Method Not Allowed
Operation is not valid according to the state of the resource
- application/json
- Schema
- Example (auto)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Internal Server Error
Unexpected error, please contact support
- application/json
- Schema
- Example (auto)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Service Unavailable
Service probably in maintenance. Please retry later.
- application/json
- Schema
- Example (auto)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
- curl
- python
- go
- nodejs
- php
- java
- CURL
curl -L '/v1/projects/:projectId/zones/:zoneName/virtualnetworks/:virtualNetworkId' \
-H 'Accept: application/json'