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"
}