Show Operation

Summary

Show details for Operation.

Type

  • Show

Synchronous/Asynchronous

  • Synchronous

Request

HTTP Request Method

  • GET

HTTP Request Path

{api_endpoint}/v1.0/operations/{operation_id}

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
operation_id URL String Hyph-uuid ID of the operation required   Terminate 404

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
404 Not Found
500 Internal Server Error

Response Body

Format

{
  "operation": {
    "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
operation 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 It identifies a request uniquely.
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/{operation_id}

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

{
  "operation": {
    "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/{operation_id} 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"
}