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