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

Input 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 Code

Response Codes
response code condition
200 OK
401 unauthorized
500 Internal Server Error

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

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