9.4.5 Execution of a service
Function
Executes the specified service.
Execution permissions
Admin role, Develop role, Modify role, Submit role
API version
v1
Request format
POST http://host:port/Automation/version/objects/Services/id/actions/submit/invoke
The following shows the structure of the request body.
{ "name" : "submit", "href" : "http://host:port/Automation/version/objects/Services/id/actions/submit/invoke", "method" : "POST", "parameters" : [ {...} ] }
The following table describes the objects that can be specified as parameters (member) in the schema of a request.
Function |
Resource name |
Number |
Description |
---|---|---|---|
Schedule |
Schedule |
1 |
Execution schedule of the service |
List of property values |
PropertyValue |
0 to n |
Input property for the service |
The following describes the properties that can be specified for the above objects. The following members can be specified for properties regardless of when the service is executed (Now, Later, or Recurring).
Resource name |
Member name |
Number |
---|---|---|
Schedule |
name |
1 |
description |
1 |
|
scheduleType |
1 |
|
PropertyValue |
keyName |
0 to n |
value |
0 to n |
If the timing of service execution is Now or Recurring, the following members can be specified for the property.
Resource name |
Member name |
Number |
Whether the property can be specified |
---|---|---|---|
Schedule |
scheduledStartTime |
1 |
Can be specified when Later is set. |
recurrenceInterval |
1 |
Can be specified when Recurring is set. |
|
recurrenceDayOfWeek |
1 |
||
recurrenceDayOfMonth |
1 |
||
recurrenceLastDayOfMonth |
1 |
||
recurrenceStartDate |
1 |
||
recurrenceTime |
1 |
Status code
The following table describes the various status codes that can be returned as the response to a request.
Status code |
Message |
Description |
---|---|---|
201 |
Created |
Processing has been successfully completed. |
400 |
Bad Request |
The argument is invalid. |
401 |
Unauthorized |
The user does not have login permission. |
403 |
Forbidden |
The user does not have a permission for executing the service. |
404 |
Not found |
The user does not have a permission for acquiring the service, or the service does not exist. |
412 |
Precondition failed |
The server is not available. |
500 |
Server-side error |
A server processing error occurred. |
Response schema
The following shows the structure of the response body for a request.
{ "instanceId" : "instance-id", "created" : "created-date-and-time", "updated" : "updated-date-and-time", "completed" : "completed-date-and-time", "state" : "state", "affectedResources" : [ {...} ] }
The following table describes the objects that can be output as affectedResources (member).
Output |
Resource name |
Number |
Description |
---|---|---|---|
Link to the created schedule |
String |
1 |
Link to the created resource for schedule functionality (Schedules) |
Link to the created task |
String |
1 |
Link to the created resource for task functionality (Tasks) |
Usage example
In the following example, the API executes the service whose instanceID is 2015.
Request header: POST /Automation/v1/objects/Services/2015/actions/submit/invoke HTTP/1.1 Host:10.196.184.238:22015 Accept:application/json Accept-Language: ja Content-Type: application/json Content-Length: 811 Authorization: Basic c3lzdGVtOm1hbmFnZXI= User-Agent: useragent1 Response header: HTTP/1.1 200 OK Date: Mon, 14 Jul 2014 11:45:34 GMT Server: Cosminexus HTTP Server Access-Control-Expose-Headers: WWW-Authenticate WWW-Authenticate: HSSO 9745c5e76461cc6c3e6946e3f7bfe84c8732ac5_V0300 Access-Control-Allow-Origin: * Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS Access-Control-Allow-Credentials: true Cache-Control: no-cache Transfer-Encoding: chunked Content-Type: application/json Response body: { "instanceID" : "3d9069ca-444f-4757-b0c5-a57ddd7d44cf", "created" : "2014-07-14T04:45:35.293-0700", "updated" : "2014-07-14T04:45:35.293-0700", "completed" : "2014-07-14T04:45:35.293-0700", "state" : "success", "affectedResource" : [ "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2025", "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026" ] }
Related toped