CloudShell Version: 2023.3 GA
Guide Version: 1.0

This article relates to the New Job Scheduling, which provides enhanced performance and support for different testing frameworks. For the original Job Scheduling, see Job Scheduling.

Start adhoc suite execution

Description

Runs an adhoc suite execution. Adhoc suites are created on-the-fly for the execution and cannot be edited, deleted nor rerun.

HTTP method

POST

Request

Headers

Example header format:

Authorization: Basic <authorization token returned from the login method>

Content-Type: application/json

Parameter	Description/Comments
space_name	CloudShell domain in which the suite will be executed. (string)

Request body

Suite details. The parameters of the adhoc suite execution method include:

Parameter	Description/Comments
name	Name of the suite execution. (string)
description	Optional description for the suite execution. (string)
testTypeName	Type of tests to run. (string) Currently, the value to use is "Robot".
jobs:
	name: Job's name. (string)
	description: Option description for the job. (string)
	durationBufferInMinutes: Job's execution buffer, in minutes. (Numeric)
	blueprint: Blueprint attached to the job. name: Blueprint's name. (string) inputs: Published global inputs defined in the job's blueprint. name: global input's name. (string) value: Global input's value. (string)
	abstractRequirements: Published requirements in the blueprint's abstract resources. type: Type of abstract requirement. (string) There are two options: "Quantity" when specifying the number of abstract resources to select. "Attribute" for any other attribute requirement. resource: Name of the abstract resource. (string) name: Name of the abstract requirement. Specify "Quantity" to indicate the number of abstract resources to select. value: Requirement's value. (string, numeric for Quantity)
	additionalInputs: Published additional inputs in the blueprint's abstract resources. resource: Name of the abstract resource. (string) name: Name of the additional info. (string) value: Additional info's value. (string)
	serviceInputs: Published inputs belonging to services in the blueprint. resource: Name of the service. (string) name: Name of the service input. (string) value: Service input's value. (string)
tests:
	name: Name of the test. (string)
	path: Path to the test's containing folder. (string)
	durationInMinutes: Test's duration in minutes. (Numeric)
	inputs: Test's inputs. name: Input's name. (string) value: Input's value. (string)
	repositoryName: Name of the online repository containing the test. For example: "GitHub"

Request example

{
	"name": "my ad hoc robot execution",
	"description": "string",
	"testTypeName": "Robot",
	"jobs": [
		{
			"name": "job 1",
			"description": "string",
			"durationBufferInMinutes": 3,
			"blueprint": {
				"name": "my blueprint",
				"inputs": [
				{
            "name": "Sandbox number",
            "value": "4"
			}],
				"abstractRequirements": [
				{
            "type": "Quantity",
            "resource": "DUT resource",
            "name": "Quantity",
            "value": "1"
          }],
				"additionalInputs": [{
            "resource": "DUT resource",
            "name": "Firmware version",
            "value": "1.00.2"
          }],
				"serviceInputs": [{
            "resource": "Controller service",
            "name": "Service.Address",
            "value": "192.168.45.112"
          }]
			},
			"tests": [
				{
					"name": "run-traffic.robot",
					"path": "Traffic tests",
					"durationInMinutes": 1,
					"inputs": [
						{
							"name": "Additional CMD Parameters",
							"value": ""
						}
					],
					"repositoryName": "GitHub"
				}
			]
		}
	]
}

Response

Response summary

Parameter	Description/Comments
id	Suite execution id. (guid)