List Virtual Network Appliance Plan¶
Summary¶
List all visible Virtual Network Appliance Plans.
Type¶
List
Synchronous/Asynchronous¶
Synchronous
Request¶
HTTP Request Method¶
GET
HTTP Request Path¶
{api_endpoint}/v1.0/virtual_network_appliance_plans
HTTP Request Header¶
Content-Type: application/json
Accept: application/json
X-Auth-Token: <token_id>
注釈
Field names in HTTP request header are case-insensitive.
HTTP Request Body¶
Parameters¶
name |
style |
datatype |
format |
description |
required/optional |
default value |
action for invalid parameter |
response code for invalid parameter |
---|---|---|---|---|---|---|---|---|
token_id |
Header |
String |
Non-Hyph-uuid |
keystone authentication token |
required |
Terminate |
401 |
|
id |
Query |
String |
Hyph-uuid |
ID of the Virtual Network Appliance Plan |
optional |
|||
name |
Query |
String |
String(0-255) |
Name of the Virtual Network Appliance Plan |
optional |
|||
description |
Query |
String |
String(0-255) |
Description of the Virtual Network Appliance Plan |
optional |
|||
appliance_type |
Query |
String |
String(0-255) |
Type of appliance |
optional |
|||
version |
Query |
String |
String(0-255) |
Version of the Virtual Network Appliance Plan |
optional |
|||
flavor |
Query |
String |
String(0-255) |
Nova flavor |
optional |
|||
number_of_interfaces |
Query |
Integer |
Integer(0-255) |
Number of Interfaces |
optional |
|||
enabled |
Query |
Boolean |
- |
Is user allowed to create new firewalls with this plan. |
optional |
|||
max_number_of_aap |
Query |
Integer |
Integer(0-255) |
Max Number of allowed_address_pairs |
optional |
|||
details |
Query |
Boolean |
- |
If details is false, availability_zones is not displayed. |
optional |
true |
||
availability_zone |
Query |
String |
- |
Availability_zones of the Virtual Network Appliance Plan |
optional |
|||
availability_zone.available |
Query |
Boolean |
- |
Display only the Virtual Network Appliance Plan including available=X in the array of availability_zones and stores only the availability_zone including available=X in the array of availability_zones. |
optional |
Response¶
Response Header¶
Format¶
HTTP/1.1 <response_code> <message> (ex. 200 OK)
<response_code>: see "HTTP Responses" section
<message>: message based on the response code
Response Body¶
Format¶
{
"virtual_network_appliance_plans": [
{
"id": "<id>",
"name": "<name>",
"description": "<description>",
"appliance_type": "<appliance_type>",
"version": "<version>",
"flavor": "<flavor>",
"number_of_interfaces" : "<number_of_interfaces>",
"enabled": "<enabled>",
"max_number_of_aap": "<max_number_of_aap>",
"licenses": [
{
"license_type": "<license_type>"
}
],
"availability_zones": [
{
"availability_zone": "<availability_zone>",
"available": "<available>",
"rank": "<rank>"
}
]
}
]
}
Parameters¶
item |
datatype |
format |
description |
virtual_network_appliance_plans |
Array<Object> |
- |
|
id |
String |
Hyph-uuid |
It identifies a Virtual Network Appliance Plan uniquely. |
name |
String |
String(0-255) |
Name of the Virtual Network Appliance Plan |
description |
String |
String(0-255) |
Description of the Virtual Network Appliance Plan |
appliance_type |
String |
String(0-255) |
Type of appliance |
version |
String |
String(0-255) |
Version of the Virtual Network Appliance Plan |
flavor |
String |
String(0-255) |
Nova flavor |
number_of_interfaces |
Integer |
Integer(0-255) |
Number of Interfaces |
enabled |
Boolean |
- |
Is user allowed to create new firewalls with this plan. |
max_number_of_aap |
Integer |
Integer(0-255) |
Max Number of allowed_address_pairs |
licenses |
Array<Object> |
- |
|
license_type |
String |
String(0-255) |
Type of license |
availability_zones |
Array<Object> |
- |
|
availability_zone |
String |
String(0-255) |
Availability_zones of the Virtual Network Appliance Plan |
available |
Boolean |
- |
Availability_zones availability |
rank |
Integer |
Integer(0-255) |
The rank is displayed in the order of decreasing the quantity of Virtual Network Appliance resources. |
Sample Request and Response¶
Sample API Request¶
Request URI¶
https://{api_endpoint}/v1.0/virtual_network_appliance_plans
Request Header¶
Content-Type: application/json
Accept: application/json
X-Auth-Token: 69105c889f824efdafb56af224208ad4
Request Body¶
This operation does not send a request body.
Sample API Response¶
Response Header¶
HTTP/1.1 200 OK
Response Body¶
{
"virtual_network_appliance_plans": [
{
"id": "37556569-87f2-4699-b5ff-bf38e7cbf8a7",
"name": "virtual_network_appliance_plans_name",
"description": "virtual_network_appliance_plans_description",
"appliance_type": "ECL::VirtualNetworkAppliance::VSRX",
"version": "",
"flavor": "2CPU-8GB",
"number_of_interfaces": 8,
"enabled": true,
"max_number_of_aap": 1,
"licenses": [
{
"license_type": "STD"
}
],
"availability_zones": [
{
"availability_zone": "zone1_groupa",
"available": true,
"rank": 1
},
{
"availability_zone": "zone1_groupb",
"available": false,
"rank": 2
}
]
}
]
}
Example Error Message¶
HTTP Request¶
GET /v1.0/virtual_network_appliance_plans HTTP/1.1
User-Agent: curl/7.51.0
Host: 10.1.131.140
Accept:application/json
X-Auth-Token:4e54395a12b740d585d74190ba4eb14b
Content-Type: application/json
HTTP Response¶
HTTP/1.1 500 Internal Server Error
Server: nginx
Date: Wed, 07 Feb 2018 06:49:20 GMT
Content-Type: application/json
Content-Length: 40
Connection: keep-alive
{
"cause": "Internal Server Error"
}