Warning
API version 1.0 is deprecated and eventually unsupported. Please use API version 2.0.
List operation¶
Summary¶
List operation history when executing the connection API .
Type¶
- Get
Target object of API¶
- operation
Synchronous/Asynchronous¶
- synchronous
Request¶
HTTP Request Method¶
- GET
HTTP Request Path¶
{api_endpoint}/v1.0/icc/operations
HTTP Request Header¶
Content-Type: application/json
Accept: application/json
X-Auth-Token: <token_id>
HTTP Request Body¶
Parameters¶
name | style | format | description | required/optional | default value | action for invalid parameter | response code for invalid parameter |
---|---|---|---|---|---|---|---|
token_id | Header | authentication token string(32) | keystone authentication token | required | Terminate | 401 | |
connection_id | Query | string(UUID) | ID of connection resource. | optional | Terminate | ||
order_type | Query | String(Create, Update, Delete) | order type. | optional | Terminate | ||
phase | Query | String(prepare_connection,approve_connection,disapprove_connection,update_connection,delete_connection) | operation phase. | optional | Terminate | ||
operation_status | Query | String(processing,complete,error) | Status of phase. | optional | Terminate | ||
latest | Query | string(true) | If use this query, the latest operation is returned. | optional | Terminate |
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":[
{
"connection_id": <connection_id>,
"order_type": <order_type>,
"phase": <phase>,
"operation_status": <operation_status>,
"reception_datetime": <reception_datetime>,
"commit_datetime": <commit_datetime>,
"request_body": {<request_body>}
}
]
}
Parameters¶
item | format | description |
operations | Array | |
connection_id | String(UUID) | It identifies connection resource uniquely. |
order_type | String(Create, Update, Delete) | order type. |
phase | String(prepare_connection,approve_connection,disapprove_connection,update_connection,delete_connection) | operation phase. |
operation_status | String(processing,complete,error) | Status of phase. |
reception_datetime | Datetime | YYYY-MM-DD HH:MM:SS |
commit_datetime | Datetime | YYYY-MM-DD HH:MM:SS |
request_body | Object | Stored the request body when executing connection API. |
Sample Request and Response¶
Sample API request¶
Request URI¶
http://{api_endpoint}/v1.0/icc/aws/connections
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": [
{
"commit_datetime": "2016-12-27 08:39:55",
"connection_id": "a80c1728-cc0c-11e6-8080-525400060300",
"operation_status": "complete",
"order_type": "Create",
"phase": "approve_connection",
"reception_datetime": "2016-12-27 08:15:41",
"request_body": {
"connection": {
"aws_account_id": "000000000000",
"bandwidth": "100",
"connected_network_address": "10.200.1.0",
"description": "hoge",
"exchange_point_id": "ef402770-c012-11e6-9751-525400060400",
"name": "hoge",
"qos_type": "Guarantee",
"tenant_id": "39852f6f42a74d2b82f7099f78d0393a"
}
}
}
]
}
Example error message¶
HTTP request¶
GET /v1.0/icc/aws/connections HTTP/1.1
User-Agent: curl/7.37.1
Host: 10.1.131.140
Content_type:application/json
Accept:application/json
X-Auth-Token:4e54395a12b740d585d74190ba4eb14b
Content-Length: 73
Content-Type: application/x-www-form-urlencoded
HTTP Response¶
HTTP/1.1 500 Internal Server Error
Server: nginx/1.8.0
Date: Mon, 28 Sep 2015 10:32:56 GMT
Content-Type: application/json; charset=UTF-8
Content-Length: 40
Connection: keep-alive
{
"cause": "Internal Server Error"
}