List Operation

Summary

List all visible Operations.

Type

  • List

Synchronous/Asynchronous

  • Synchronous

Request

HTTP Request Method

  • GET

HTTP Request Path

{api_endpoint}/v1.0/operations

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 operation

optional

resource_id

Query

String

Hyph-uuid

ID of the resource

optional

resource_type

Query

String

String(0-255)

Type of the resource

optional

request_id

Query

String

Hyph-uuid

A request_id to identify requests.

optional

request_type

Query

String

String(0-255)

Type of request

optional

status

Query

String

String(0-255)

Status of phase

optional

tenant_id

Query

String

Non-Hyph-uuid

Tenant ID of the owner (UUID)

optional

no_deleted

Query

Boolean

If no_deleted is true, operation of deleted VNA is not displayed.

optional

false

latest

Query

Boolean

If latest is true, only the most recent operation of each VNA is displayed.

optional

false

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

{
  "operations": [
    {
      "id": "<id>",
      "resource_id": "<resource_id>",
      "resource_type": "<resource_type>",
      "request_id": "<request_id>",
      "request_type": "<request_type>",
      "request_body": "<request_body>",
      "status": "<status>",
      "reception_datetime": "<reception_datetime>",
      "commit_datetime": "<commit_datetime>",
      "warning" : "<warning>",
      "error": "<error>",
      "tenant_id": "<tenant_id>"
    }
  ]
}

Parameters

Response Parameters

item

datatype

format

description

operations

Array<Object>

-

id

String

Hyph-uuid

It identifies a operation uniquely.

resource_id

String

Hyph-uuid

It identifies a resource uniquely.

resource_type

String

String(0-255)

Type of resource

request_id

String

Hyph-uuid

A request_id to identify requests.

request_type

String

String(0-255)

Type of request

request_body

Object

-

Stored the request body when executing API.

status

String

String(0-255)

Status of phase

reception_datetime

String

Date

Reception datetime of the executed API. Time zone is represented as UTC.

commit_datetime

String

Date

Commit datetime of the executed API. Time zone is represented as UTC.

warning

String

Mediumtext

The warning message of operation that has been stopped or failed.

error

String

Mediumtext

The error message of operation that has been stopped or failed.

tenant_id

String

Non-Hyph-uuid

Tenant ID of the owner (UUID)

Sample Request and Response

Sample API Request

Request URI

https://{api_endpoint}/v1.0/operations

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

{
  "operations": [
    {
      "id": "75aab8db-8632-42b4-af2f-06b5820798ef",
      "resource_id": "a80c1728-cc0c-11e6-8080-525400060300",
      "resource_type": "ECL::VirtualNetworkAppliance::VSRX",
      "request_id": "",
      "request_type": "Create",
      "request_body": {
        "virtual_network_appliance": {
          "name": "virtual_network_appliance_name",
          "description": "virtual_network_appliance_name_description",
          "default_gateway": "192.168.0.1",
          "availability_zone": "zone1-groupa",
          "virtual_network_appliance_plan_id": "b0cdb8c5-aaf0-48eb-81ac-f211b54da53c",
          "tenant_id": "13572f6f42a74d2b82f7099f78d0393a",
          "tags": {},
          "interfaces": {
            {
              "interface_1": {
                "name": "interface_name",
                "network_id": "0967afc2-73a8-4c1f-869a-54c3b07dc199",
                "tags": {},
                "fixed_ips": [
                  {
                    "ip_address": "192.168.0.100"
                  }
                ]
              }
            }
          }
        }
      },
      "status": "Complete",
      "reception_datetime": "2017-11-27 21:35:38",
      "commit_datetime": "2017-11-27 21:46:21",
      "warning" : null,
      "error": null,
      "tenant_id": "13572f6f42a74d2b82f7099f78d0393a"
    }
  ]
}

Example Error Message

HTTP Request

GET /v1.0/operations 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"
}