1. Introduction

This is the REST API documentation for Genie version 4.1.1-SNAPSHOT. Here you will find specific details of how to invoke the Genie REST API and what you can expect as return values.

For more Genie information see the website.
For high level information and installation instructions please see the reference guide.
For a demo of this version of Genie please see demo guide.

2. Assumptions

This documentation assumes a basic knowledge of how REST APIs work. If you don’t know things like HTTP verbs see websites like this one.

3. HATEOAS

A lot of the API’s return application/hal+json as a content type. This is a superset of JSON built to support HATEOAS (Hypermedia as the Engine of Application State). Rather than re-writing what HATEOAS is see this great write up on the Spring Website about it.

HATEOAS has several ways to represent the state in return payloads. Genie uses HAL. You can find documentation about it here or here.

4. Security

All of this documentation assumes security is disabled for Genie. If your installation has security enabled the REST APIs will be secured via OAuth2 or x509 certs or both.

These are the currently supported API security mechanisms but others could be plugged in. We’ll only talk about OAuth2 here for now until another implementation is done.

4.1. OAuth2

If OAuth2 is enabled you’ll need to send your JWT you got back from your provider along with your API request. This is accomplished by setting your Authorization header to a value of Bearer {your token here}.

4.2. x509

If your admin has security Genie using client and server certificates mechanisms you’ll need to send your client certificate along with your request.

Something like curl --cert {your cert} {genie endpoint}

5. Resources

This section contains the documentation for various resources sent to and from the various Genie APIs. Note their structure and fields, particularly what is marked optional. Optional means when you submit one of these resources to Genie you don’t need to set that field. Genie either doesn’t require it or if it does, as is the case with ID’s, it will create one if you don’t provide it. When you get a resource all fields Genie has stored will be returned.

5.1. Application

Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

type

String

The type of application this is (e.g. hadoop, presto, spark). Can be used to group.

true

status

String

The status of the application. Options: [ACTIVE, DEPRECATED, INACTIVE]

Must not be null

false

dependencies

Array

The dependencies for the application

true

5.2. Cluster

Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

status

String

The status of the cluster. Options: [UP, OUT_OF_SERVICE, TERMINATED]

Must not be null

false

dependencies

Array

The dependencies for the cluster

true

5.3. Command

Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

status

String

The status of the command. Options: [ACTIVE, DEPRECATED, INACTIVE]

Must not be null

false

executable

String

The executable to run on the Genie node when this command is used. e.g. /usr/bin/hadoop

Must not be empty. Size must be between 0 and 1024 inclusive

false

executableAndArguments

Array

The executable and arguments to run on the Genie node when this command is used. e.g. /usr/bin/hadoop

Must not be empty

false

checkDelay

Number

The amount of time (in milliseconds) to delay between checks of the jobs using this command

Must be at least 1

false

memory

Number

The default amount of memory (in MB) that should be allocated for instances of this command client

Must be at least 1

true

dependencies

Array

The dependencies for the command

true

clusterCriteria

Array

The priority ordered list of criteria to resolve clusters that this command can run jobs on

true

5.4. Job Request

Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

commandArgs

String

Any arguments to append to the command executable when the job is run

Size must be between 0 and 10000 inclusive

true

clusterCriterias

Array

List of cluster criteria’s for which a match will be attempted with register cluster tags. Each set of tags within a given cluster criteria must have at least one non-blank (e.g. ' ', ' ', null) tag.

Must not be empty

false

commandCriteria

Array

Set of tags which will attempt to match against the commands linked to selected cluster. There must be at least one non-blank (e.g. ' ', ' ', null) criteria within the set

Must not be empty

false

group

String

A group that the job should be run under on the linux system

Size must be between 0 and 255 inclusive

true

disableLogArchival

Boolean

If you want to disable backing up job output files set this to true. Default: false

true

email

String

If you want e-mail notification on job completion enter address here

Must be a well-formed email address. Size must be between 0 and 255 inclusive

true

cpu

Number

For future use. Currently has no impact.

Must be at least 1

true

memory

Number

The amount of memory (in MB) desired for job client. Cannot exceed configured max.

Must be at least 1

true

timeout

Number

The timeout (in seconds) after which job will be killed by system, system setting used if not set

Must be at least 1

true

configs

Array

URI’s of configuration files which will be downloaded into job working directory at runtime

true

dependencies

Array

URI’s of dependency files which will be downloaded into job working directory at runtime

true

applications

Array

Complete list of application ids if power user wishes to override selected command defaults

true

grouping

String

The grouping of the job relative to other jobs. e.g. scheduler job name

true

groupingInstance

String

The grouping instance of the job relative to other jobs. e.g. scheduler job run

true

5.5. Job

Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

commandArgs

String

Any arguments to append to the command executable when the job is run

Size must be between 0 and 10000 inclusive

true

status

String

The status of the job. Options: [RESERVED, RESOLVED, ACCEPTED, CLAIMED, INIT, RUNNING, SUCCEEDED, KILLED, FAILED, INVALID]

Must not be null

false

statusMsg

String

The status message of the job

Size must be between 0 and 255 inclusive

true

started

String

The time (UTC ISO8601 with millis) the job was started

true

finished

String

The time (UTC ISO8601 with millis) the job finished

true

archiveLocation

String

The URI where the working directory zip was stored

Size must be between 0 and 1024 inclusive

true

clusterName

String

The name of the cluster the job was run on if it’s been determined

Size must be between 0 and 255 inclusive

true

commandName

String

The name of the command the job was run with if it’s been determined

Size must be between 0 and 255 inclusive

true

runtime

String

Runtime of the job in ISO8601 duration format

Must not be null

true

grouping

String

The grouping of the job relative to other jobs. e.g. scheduler job name

true

groupingInstance

String

The grouping instance of the job relative to other jobs. e.g. scheduler job run

true

5.6. Job Execution

Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

hostName

String

The host name of the Genie node responsible for the job

Size must be between 1 and 1024 inclusive

false

processId

Number

The id of the job client process on the Genie node

true

checkDelay

Number

The amount of time in milliseconds between checks of the job status by Genie

Must be at least 1

true

timeout

String

The date (UTC ISO8601 with millis) when the job will be killed by Genie due to timeout

true

exitCode

Number

The job client process exit code after the job is done

true

memory

Number

The amount of memory (in MB) allocated to the job client

Must be at least 1

true

archiveStatus

String

The archival status of the job directory

true

launcherExt

Object

JSON object that contains metadata specific to the launcher implementation for the job

true

5.7. Job Metadata

Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

clientHost

String

The host name of the client that submitted the job to Genie

true

userAgent

String

The user agent string that was passed to Genie on job request

true

numAttachments

Number

The number of attachments sent to Genie with the job request

true

totalSizeOfAttachments

Number

The total size of all attachments sent to Genie with the job request. In bytes.

true

stdOutSize

Number

The final size of the stdout file after a job is completed. In bytes.

true

stdErrSize

Number

The final size of the stderr file after a job is completed. In bytes.

true

5.8. Criterion

Path Type Description Constraints Optional

id

String

The unique identifier a resource needs to have to match this criterion

true

name

String

The name a resource needs to have to match this criterion

true

version

String

The version a resource needs to have to match this criterion

true

status

String

The status a resource needs to have to match this criterion

true

tags

Array

The set of tags a resource needs to have to match this criterion

true

6. Jobs API

6.1. Submit a Job

6.1.1. Description

The main API in Genie. Submitting a job to be run.

There are two different ways to submit a job to Genie. Both go to the same endpoint but you can simply send a JSON payload if you have no attachments. This means setting your content type to application/json. If you do have attachments you want to send with your job request you need to set the content type to multipart/form-data and post the request that way. Examples are below.

6.1.2. Endpoint

POST /api/v3/jobs

The id in this example is optional. If you include one Genie will use it. If not it will provide one. If you provide one it must be unique.
This Example is without attachments

6.1.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters

None

Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

commandArgs

String

Any arguments to append to the command executable when the job is run

Size must be between 0 and 10000 inclusive

true

clusterCriterias

Array

List of cluster criteria’s for which a match will be attempted with register cluster tags. Each set of tags within a given cluster criteria must have at least one non-blank (e.g. ' ', ' ', null) tag.

Must not be empty

false

commandCriteria

Array

Set of tags which will attempt to match against the commands linked to selected cluster. There must be at least one non-blank (e.g. ' ', ' ', null) criteria within the set

Must not be empty

false

group

String

A group that the job should be run under on the linux system

Size must be between 0 and 255 inclusive

true

disableLogArchival

Boolean

If you want to disable backing up job output files set this to true. Default: false

true

email

String

If you want e-mail notification on job completion enter address here

Must be a well-formed email address. Size must be between 0 and 255 inclusive

true

cpu

Number

For future use. Currently has no impact.

Must be at least 1

true

memory

Number

The amount of memory (in MB) desired for job client. Cannot exceed configured max.

Must be at least 1

true

timeout

Number

The timeout (in seconds) after which job will be killed by system, system setting used if not set

Must be at least 1

true

configs

Array

URI’s of configuration files which will be downloaded into job working directory at runtime

true

dependencies

Array

URI’s of dependency files which will be downloaded into job working directory at runtime

true

applications

Array

Complete list of application ids if power user wishes to override selected command defaults

true

grouping

String

The grouping of the job relative to other jobs. e.g. scheduler job name

true

groupingInstance

String

The grouping instance of the job relative to other jobs. e.g. scheduler job run

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "1.0",
  "user" : "genie",
  "name" : "List * ... Directories bash job",
  "description" : "Genie 3 Test Job",
  "metadata" : {
    "schedulerJobName" : "93eea3f3-dd2b-4de0-bd04-761032b6b9f6",
    "schedulerRunId" : "46889d1d-ecf5-4f8a-8c46-28b09d0406df"
  },
  "tags" : [ "aTag", "zTag" ],
  "configs" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/config1" ],
  "dependencies" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/dep1" ],
  "setupFile" : "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/jobsetupfile",
  "commandArgs" : "-c 'sleep 5 && echo hello world'",
  "clusterCriterias" : [ {
    "tags" : [ "localhost" ]
  } ],
  "commandCriteria" : [ "bash" ],
  "group" : null,
  "disableLogArchival" : false,
  "email" : null,
  "cpu" : null,
  "memory" : null,
  "timeout" : null,
  "applications" : [ ],
  "grouping" : "Workflow.Foo",
  "groupingInstance" : "Workflow.Foo_Step.Blah-2020021919:12:34.000_1"
}'
HTTPie
$ echo '{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "1.0",
  "user" : "genie",
  "name" : "List * ... Directories bash job",
  "description" : "Genie 3 Test Job",
  "metadata" : {
    "schedulerJobName" : "93eea3f3-dd2b-4de0-bd04-761032b6b9f6",
    "schedulerRunId" : "46889d1d-ecf5-4f8a-8c46-28b09d0406df"
  },
  "tags" : [ "aTag", "zTag" ],
  "configs" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/config1" ],
  "dependencies" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/dep1" ],
  "setupFile" : "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/jobsetupfile",
  "commandArgs" : "-c 'sleep 5 && echo hello world'",
  "clusterCriterias" : [ {
    "tags" : [ "localhost" ]
  } ],
  "commandCriteria" : [ "bash" ],
  "group" : null,
  "disableLogArchival" : false,
  "email" : null,
  "cpu" : null,
  "memory" : null,
  "timeout" : null,
  "applications" : [ ],
  "grouping" : "Workflow.Foo",
  "groupingInstance" : "Workflow.Foo_Step.Blah-2020021919:12:34.000_1"
}' | http POST 'https://genie.example.com/api/v3/jobs' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers
Name Description

Location

The URI
Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/jobs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 1332

{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "1.0",
  "user" : "genie",
  "name" : "List * ... Directories bash job",
  "description" : "Genie 3 Test Job",
  "metadata" : {
    "schedulerJobName" : "93eea3f3-dd2b-4de0-bd04-761032b6b9f6",
    "schedulerRunId" : "46889d1d-ecf5-4f8a-8c46-28b09d0406df"
  },
  "tags" : [ "aTag", "zTag" ],
  "configs" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/config1" ],
  "dependencies" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/dep1" ],
  "setupFile" : "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/jobsetupfile",
  "commandArgs" : "-c 'sleep 5 && echo hello world'",
  "clusterCriterias" : [ {
    "tags" : [ "localhost" ]
  } ],
  "commandCriteria" : [ "bash" ],
  "group" : null,
  "disableLogArchival" : false,
  "email" : null,
  "cpu" : null,
  "memory" : null,
  "timeout" : null,
  "applications" : [ ],
  "grouping" : "Workflow.Foo",
  "groupingInstance" : "Workflow.Foo_Step.Blah-2020021919:12:34.000_1"
}
Response
HTTP/1.1 202 Accepted
Location: https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c
Date: Tue, 18 Jan 2022 23:05:55 GMT
Keep-Alive: timeout=60
Connection: keep-alive
This example is with attachments

6.1.4. API Docs

Request Documentation
Headers
Name Description

Content-Type

multipart/form-data
Path Parameters

None

Query Parameters

None

Payload Fields
Part Description

request

The job request JSON. Content type must be application/json for part

attachment

An attachment file. There can be multiple. Type should be octet-stream
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs' -i -X POST \
    -H 'Content-Type: multipart/form-data; boundary="MR2G8rA7P-NtjSoUn6OAqRjPvLXxEbxyn7NmTFI"' \
    -F 'request=@file;type=application/json' \
    -F 'attachment=@query.sql;type=application/octet-stream' \
    -F 'attachment=@query2.sql;type=application/octet-stream'
HTTPie
$ http --form POST 'https://genie.example.com/api/v3/jobs' \
    'request'@'file' \
    'attachment'@'query.sql' \
    'attachment'@'query2.sql'
Response Documentation
Headers
Name Description

Location

The URI
Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/jobs HTTP/1.1
Content-Type: multipart/form-data; boundary="MR2G8rA7P-NtjSoUn6OAqRjPvLXxEbxyn7NmTFI"; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Host: genie.example.com

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=request; filename=file
Content-Type: application/json

{"id":null,"created":null,"updated":null,"version":"1.0","user":"genie","name":"List * ... Directories bash job","description":"Genie 3 Test Job","metadata":null,"tags":[],"configs":[],"dependencies":[],"setupFile":"file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/jobsetupfile","commandArgs":"-c 'sleep 5 && echo hello world'","clusterCriterias":[{"tags":["localhost"]}],"commandCriteria":["bash"],"group":null,"disableLogArchival":true,"email":null,"cpu":null,"memory":null,"timeout":null,"applications":[],"grouping":null,"groupingInstance":null}
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=attachment; filename=query.sql
Content-Type: application/octet-stream

--
--
--  Copyright 2018 Netflix, Inc.
--
--     Licensed under the Apache License, Version 2.0 (the "License");
--     you may not use this file except in compliance with the License.
--     You may obtain a copy of the License at
--
--         https://genie.example.com/licenses/LICENSE-2.0
--
--     Unless required by applicable law or agreed to in writing, software
--     distributed under the License is distributed on an "AS IS" BASIS,
--     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
--     See the License for the specific language governing permissions and
--     limitations under the License.
--
--
select * from myTable;

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=attachment; filename=query2.sql
Content-Type: application/octet-stream

--
--
--  Copyright 2018 Netflix, Inc.
--
--     Licensed under the Apache License, Version 2.0 (the "License");
--     you may not use this file except in compliance with the License.
--     You may obtain a copy of the License at
--
--         https://genie.example.com/licenses/LICENSE-2.0
--
--     Unless required by applicable law or agreed to in writing, software
--     distributed under the License is distributed on an "AS IS" BASIS,
--     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
--     See the License for the specific language governing permissions and
--     limitations under the License.
--
--
SELECT * FROM your_table JOIN my_table ON your_table.id = my_table.id WHERE x > 50;

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
Response
HTTP/1.1 202 Accepted
Location: https://genie.example.com/api/v3/jobs/8e39d819-e679-44c0-a504-b1aaed3afb6f
Date: Tue, 18 Jan 2022 23:06:36 GMT
Keep-Alive: timeout=60
Connection: keep-alive

6.2. Find Jobs

6.2.1. Description

Search for jobs using query parameters.

6.2.2. Endpoint

GET /api/v3/jobs

6.2.3. API Docs

Request Documentation
Headers

None

Path Parameters

None

Query Parameters
Parameter Description

page

The page number to get. Default to 0.

size

The size of the page to get. Default to 64.

sort

The fields to sort the results by. Defaults to 'updated,desc'.

id

The id of the jobs to find. Use % symbol for regex like search.

name

The name of the jobs to find. Use % symbol for regex like search.

user

The user of the jobs to find. Use % symbol for regex like search.

status

The status(es) of the jobs to find. Can have multiple. Options: [RESERVED, RESOLVED, ACCEPTED, CLAIMED, INIT, RUNNING, SUCCEEDED, KILLED, FAILED, INVALID]

tag

The tag(s) of the jobs to find. Can have multiple.

clusterName

The name of the cluster on which the jobs ran. Use % symbol for regex like search.

clusterId

The id of the cluster on which the jobs ran.

commandName

The name of the command which was executed by the job. Use % symbol for regex like search.

commandId

The id of the command which was executed by the job.

minStarted

The minimum started time of the job in milliseconds since epoch. (inclusive)

maxStarted

The maximum started time of the job in milliseconds since epoch. (exclusive)

minFinished

The minimum finished time of the job in milliseconds since epoch. (inclusive)

maxFinished

The maximum finished time of the job in milliseconds since epoch. (exclusive)

grouping

The grouping the job should be a member of. Use % symbol for regex like search.

groupingInstance

The grouping instance the job should be a member of. Use % symbol for regex like search.
Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs?user=genie' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs?user=genie'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

_links

Object

Links to other resources.

false

page

Object

The result page information.

false

page.size

Number

The number of elements in this page result.

false

page.totalElements

Number

The total number of elements this search result could return.

false

page.totalPages

Number

The total number of pages there could be at the current page size.

false

page.number

Number

The current page number.

false

_embedded.jobSearchResultList

Array

The found jobs.

false
HATEOAS Links
Relation Description

self

The current search

first

The first page for this search

prev

The previous page for this search

next

The next page for this search

last

The last page for this search
HTTP Messages
Request
GET /api/v3/jobs?user=genie HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:06:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 946

{
  "_embedded" : {
    "jobSearchResultList" : [ {
      "id" : "8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c",
      "name" : "List * ... Directories bash job",
      "user" : "genie",
      "status" : "SUCCEEDED",
      "started" : "2022-01-18T23:06:06.152Z",
      "finished" : "2022-01-18T23:06:11.272Z",
      "clusterName" : "Local laptop",
      "commandName" : "Unix Bash command",
      "runtime" : "PT5.12S",
      "_links" : {
        "self" : {
          "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/jobs?user=genie{&id,name,status,tag,clusterName,clusterId,commandName,commandId,minStarted,maxStarted,minFinished,maxFinished,grouping,groupingInstance}",
      "templated" : true
    }
  },
  "page" : {
    "size" : 10,
    "totalElements" : 1,
    "totalPages" : 1,
    "number" : 0
  }
}

6.3. Get a Job

6.3.1. Description

Get metadata about a specific job.

6.3.2. Endpoint

GET /api/v3/jobs/{id}

6.3.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 1. /api/v3/jobs/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

commandArgs

String

Any arguments to append to the command executable when the job is run

Size must be between 0 and 10000 inclusive

true

status

String

The status of the job. Options: [RESERVED, RESOLVED, ACCEPTED, CLAIMED, INIT, RUNNING, SUCCEEDED, KILLED, FAILED, INVALID]

Must not be null

false

statusMsg

String

The status message of the job

Size must be between 0 and 255 inclusive

true

started

String

The time (UTC ISO8601 with millis) the job was started

true

finished

String

The time (UTC ISO8601 with millis) the job finished

true

archiveLocation

String

The URI where the working directory zip was stored

Size must be between 0 and 1024 inclusive

true

clusterName

String

The name of the cluster the job was run on if it’s been determined

Size must be between 0 and 255 inclusive

true

commandName

String

The name of the command the job was run with if it’s been determined

Size must be between 0 and 255 inclusive

true

runtime

String

Runtime of the job in ISO8601 duration format

Must not be null

true

grouping

String

The grouping of the job relative to other jobs. e.g. scheduler job name

true

groupingInstance

String

The grouping instance of the job relative to other jobs. e.g. scheduler job run

true
HATEOAS Links
Relation Description

self

URI for this job

request

The request that kicked off this job

execution

The job execution information for this job

metadata

The job metadata information for this job

output

The output URI for the job

status

The current status of the job

cluster

The cluster this job ran on

command

The command this job executed

applications

The applications this job used
HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:06:11 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 2086

{
  "id" : "8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c",
  "created" : "2022-01-18T23:05:55.936Z",
  "updated" : "2022-01-18T23:06:11.408Z",
  "version" : "1.0",
  "user" : "genie",
  "name" : "List * ... Directories bash job",
  "description" : "Genie 3 Test Job",
  "metadata" : {
    "schedulerJobName" : "93eea3f3-dd2b-4de0-bd04-761032b6b9f6",
    "schedulerRunId" : "46889d1d-ecf5-4f8a-8c46-28b09d0406df"
  },
  "tags" : [ "aTag", "zTag" ],
  "status" : "SUCCEEDED",
  "statusMsg" : "Job finished successfully.",
  "started" : "2022-01-18T23:06:06.152Z",
  "finished" : "2022-01-18T23:06:11.272Z",
  "archiveLocation" : "file:///tmp/genie/archives/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c",
  "clusterName" : "Local laptop",
  "commandName" : "Unix Bash command",
  "runtime" : "PT5.12S",
  "commandArgs" : "-c 'sleep 5 && echo hello world'",
  "grouping" : "Workflow.Foo",
  "groupingInstance" : "Workflow.Foo_Step.Blah-2020021919:12:34.000_1",
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c"
    },
    "output" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output"
    },
    "request" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/request"
    },
    "execution" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/execution"
    },
    "metadata" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/metadata"
    },
    "status" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/status"
    },
    "cluster" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/cluster"
    },
    "command" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/command"
    },
    "applications" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/applications"
    }
  }
}

6.4. Kill a Job

6.4.1. Description

Request for a job to be killed.

6.4.2. Endpoint

DELETE /api/v3/jobs/{id}

6.4.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 2. /api/v3/jobs/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/39a84515-be4b-4c5b-9c32-d78b06cd11bd' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/jobs/39a84515-be4b-4c5b-9c32-d78b06cd11bd'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/jobs/39a84515-be4b-4c5b-9c32-d78b06cd11bd HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 202 Accepted
Date: Tue, 18 Jan 2022 23:05:54 GMT
Keep-Alive: timeout=60
Connection: keep-alive

6.5. Get Job Status

6.5.1. Description

Get the current status of a job.

6.5.2. Endpoint

GET /api/v3/jobs/{id}/status

6.5.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 3. /api/v3/jobs/{id}/status
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/status' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/status'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

status

String

The job status. One of: [RESERVED, RESOLVED, ACCEPTED, CLAIMED, INIT, RUNNING, SUCCEEDED, KILLED, FAILED, INVALID]

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/status HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:06:11 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 28

{
  "status" : "SUCCEEDED"
}

6.6. Get Contents From the Job Working Directory

6.6.1. Description

This API acts as a file browser for the remote working directory of your job. You can request endpoints and if it is a directory you will be shown the contents of the directory and be able to navigate. If the endpoint points to a file it will return the file.

6.6.2. Endpoint

GET /api/v3/jobs/{id}/output/{path}**

6.6.3. Getting a directory as JSON

This is the default behavior for directories if no Accept header is present

6.6.4. API Docs

Request Documentation
Headers
Name Description

Accept

application/json
Path Parameters
Table 4. /api/v3/jobs/{id}/output/{filePath}
Parameter Description

id

The resource id

filePath

The path to the directory to get
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/' -i -X GET \
    -H 'Accept: application/json'
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/' \
    'Accept:application/json'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

parent

Object

Information about the parent of this directory

true

parent.name

String

The name of the parent directory

true

parent.url

String

The url to get the parent

true

parent.size

Number

The size of the parent in bytes

true

parent.lastModified

String

The last time the parent was modified in ISO8601 UTC with milliseconds included

true

directories

Array

All the subdirectories of this directory

false

directories[].name

String

The name of the directory

false

directories[].url

String

The url to get the directory

false

directories[].size

Number

The size of the directory in bytes

false

directories[].lastModified

String

The last time the directory was modified in ISO8601 UTC with milliseconds included

false

files

Array

All the files in this directory

false

files[].name

String

The name of the file

false

files[].url

String

The url to get the file

false

files[].size

Number

The size of the file in bytes

false

files[].lastModified

String

The last time the file was modified in ISO8601 UTC with milliseconds included

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/ HTTP/1.1
Accept: application/json
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1480
Date: Tue, 18 Jan 2022 23:06:11 GMT
Keep-Alive: timeout=60
Connection: keep-alive

{
  "parent" : null,
  "directories" : [ {
    "name" : "genie/",
    "url" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/genie",
    "size" : 4096,
    "lastModified" : "2022-01-18T23:06:06.054458Z"
  } ],
  "files" : [ {
    "name" : "config1",
    "url" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/config1",
    "size" : 0,
    "lastModified" : "2022-01-18T23:06:05.458458Z"
  }, {
    "name" : "dep1",
    "url" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/dep1",
    "size" : 0,
    "lastModified" : "2022-01-18T23:06:05.446458Z"
  }, {
    "name" : "genie_setup.sh",
    "url" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/genie_setup.sh",
    "size" : 0,
    "lastModified" : "2022-01-18T23:06:05.442458Z"
  }, {
    "name" : "run",
    "url" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/run",
    "size" : 3828,
    "lastModified" : "2022-01-18T23:06:05.390458Z"
  }, {
    "name" : "stderr",
    "url" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/stderr",
    "size" : 0,
    "lastModified" : "2022-01-18T23:06:06.034458Z"
  }, {
    "name" : "stdout",
    "url" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/stdout",
    "size" : 12,
    "lastModified" : "2022-01-18T23:06:11.078458Z"
  } ]
}

6.6.5. Getting a directory as HTML

This would happen automatically if you called from browser due to browser default accept header

6.6.6. API Docs

Request Documentation
Headers
Name Description

Accept

text/html
Path Parameters
Table 5. /api/v3/jobs/{id}/output/{filePath}
Parameter Description

id

The resource id

filePath

The path to the directory to get
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/' -i -X GET \
    -H 'Accept: text/html'
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/' \
    'Accept:text/html'
Response Documentation
Headers
Name Description

Content-Type

text/html
Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/ HTTP/1.1
Accept: text/html
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: text/html;charset=UTF-8
Content-Length: 2729
Date: Tue, 18 Jan 2022 23:06:12 GMT
Keep-Alive: timeout=60
Connection: keep-alive

<!DOCTYPE html><html><head><title>8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c</title><style type="text/css"><!--body {font-family:Tahoma,Arial,sans-serif;} h1, h2, h3, b {color:white;background-color:#525D76;} h1 {font-size:22px;} h2 {font-size:16px;} h3 {font-size:14px;} p {font-size:12px;} a {color:black;} .line {height:1px;background-color:#525D76;border:none;}--></style> </head><body><h1>8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c</h1><HR size="1" noshade="noshade"><table width="100%" cellspacing="0" cellpadding="5" align="center"><tr><td align="left"><font size="+1"><strong>Filename</strong></font></td><td align="right"><font size="+1"><strong>Size</strong></font></td><td align="right"><font size="+1"><strong>Last Modified</strong></font></td></tr><tr bgcolor="#eeeeee"><td align="left">&nbsp;&nbsp;<a href="https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/genie"><tt>genie/</tt></a></td><td align="right"><tt>-</tt></td><td align="right"><tt>Tue, 18 Jan 2022 23:06:06 GMT</tt></td></tr><tr><td align="left">&nbsp;&nbsp;<a href="https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/config1"><tt>config1</tt></a></td><td align="right"><tt>0 bytes</tt></td><td align="right"><tt>Tue, 18 Jan 2022 23:06:05 GMT</tt></td></tr><tr bgcolor="#eeeeee"><td align="left">&nbsp;&nbsp;<a href="https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/dep1"><tt>dep1</tt></a></td><td align="right"><tt>0 bytes</tt></td><td align="right"><tt>Tue, 18 Jan 2022 23:06:05 GMT</tt></td></tr><tr><td align="left">&nbsp;&nbsp;<a href="https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/genie_setup.sh"><tt>genie_setup.sh</tt></a></td><td align="right"><tt>0 bytes</tt></td><td align="right"><tt>Tue, 18 Jan 2022 23:06:05 GMT</tt></td></tr><tr bgcolor="#eeeeee"><td align="left">&nbsp;&nbsp;<a href="https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/run"><tt>run</tt></a></td><td align="right"><tt>3 KB</tt></td><td align="right"><tt>Tue, 18 Jan 2022 23:06:05 GMT</tt></td></tr><tr><td align="left">&nbsp;&nbsp;<a href="https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/stderr"><tt>stderr</tt></a></td><td align="right"><tt>0 bytes</tt></td><td align="right"><tt>Tue, 18 Jan 2022 23:06:06 GMT</tt></td></tr><tr bgcolor="#eeeeee"><td align="left">&nbsp;&nbsp;<a href="https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/stdout"><tt>stdout</tt></a></td><td align="right"><tt>12 bytes</tt></td><td align="right"><tt>Tue, 18 Jan 2022 23:06:11 GMT</tt></td></tr></table><HR size="1" noshade="noshade"><h3>Apache Tomcat/9.0.54</h3></body></html>

6.6.7. Getting a file

6.6.8. API Docs

Request Documentation
Headers
Name Description

Accept

/
Path Parameters
Table 6. /api/v3/jobs/{id}/output/{filePath}
Parameter Description

id

The resource id

filePath

The path to the file to get
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/run' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/run'
Response Documentation
Headers
Name Description

Content-Type

The content type of the file being returned
Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output/run HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Last-Modified: Tue, 18 Jan 2022 23:06:05 GMT
Accept-Ranges: bytes
Content-Type: text/plain;charset=UTF-8
Content-Length: 3828
Date: Tue, 18 Jan 2022 23:06:12 GMT
Keep-Alive: timeout=60
Connection: keep-alive

#!/usr/bin/env bash

#
# Generated by Genie for job: 8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c
#

# Error out if any command fails
set -o errexit
# Error out if any command in a pipeline fails
set -o pipefail
# Error out if unknown variable is used
set -o nounset
# Save original stdout and stderr in fd 6 and 7
exec 6>&1
exec 7>&2


# Trap exit signals to ensure children processes are dead before returning
function handle_kill_request {
    echo "Handling $1 signal" >&2
    # Update trap
    trap wait SIGTERM SIGINT SIGHUP
    # Send SIGTERM to all children
    pkill -P $$ || true
    for ((iteration=1; iteration < 30; iteration++))
    {
        if pkill -0 -P $$ &> /dev/null;
        then
            echo "Waiting for children to terminate" >&2
            sleep 1
        else
            echo "All children terminated" >&2
            exit 1
        fi
    }
    # Reaching this point means the children did not die. Kill with SIGKILL
    echo "Terminating all children with SIGKILL" >&2
    pkill -9 -P $$
}
trap 'handle_kill_request SIGTERM' SIGTERM
trap 'handle_kill_request SIGINT' SIGINT
trap 'handle_kill_request SIGHUP' SIGHUP

# Locally-generated environment variables

export GENIE_JOB_DIR="/tmp/genie/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c"

export GENIE_APPLICATION_DIR="${GENIE_JOB_DIR}/genie/applications"

export GENIE_COMMAND_DIR="${GENIE_JOB_DIR}/genie/command/cmd1"

export GENIE_CLUSTER_DIR="${GENIE_JOB_DIR}/genie/cluster/cluster1"

export __GENIE_SETUP_LOG_FILE="${GENIE_JOB_DIR}/genie/logs/setup.log"

export __GENIE_ENVIRONMENT_DUMP_FILE="${GENIE_JOB_DIR}/genie/logs/env.log"

export __GENIE_SETUP_ERROR_MARKER_FILE="${GENIE_JOB_DIR}/genie/setup_failed.txt"


# Mark the beginnig of the setup by creating a marker file
echo "The job script failed during setup. See ${__GENIE_SETUP_LOG_FILE} for details" > ${__GENIE_SETUP_ERROR_MARKER_FILE}

# During setup, redirect stdout and stderr of this script to a log file
exec > ${__GENIE_SETUP_LOG_FILE}
exec 2>&1

echo "Setup start: $(date '+%Y-%m-%d %H:%M:%S')"

# Server-provided environment variables

export GENIE_CLUSTER_ID="cluster1"

export GENIE_CLUSTER_NAME="Local laptop"

export GENIE_CLUSTER_TAGS="localhost"

export GENIE_COMMAND_ID="cmd1"

export GENIE_COMMAND_NAME="Unix Bash command"

export GENIE_COMMAND_TAGS="bash"

export GENIE_JOB_GROUPING="Workflow.Foo"

export GENIE_JOB_GROUPING_INSTANCE="Workflow.Foo_Step.Blah-2020021919:12:34.000_1"

export GENIE_JOB_ID="8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c"

export GENIE_JOB_MEMORY="1024"

export GENIE_JOB_NAME="List * ... Directories bash job"

export GENIE_JOB_TAGS="aTag,zTag"

export GENIE_REQUESTED_CLUSTER_TAGS="[[localhost]]"

export GENIE_REQUESTED_CLUSTER_TAGS_0="localhost"

export GENIE_REQUESTED_COMMAND_TAGS="bash"

export GENIE_USER="genie"

export GENIE_USER_GROUP=""

export GENIE_VERSION="4"


echo "Sourcing setup script for cluster cluster1"
source ${GENIE_JOB_DIR}/genie/cluster/cluster1/genie_setup.sh

echo "Sourcing setup script for application app1"
source ${GENIE_JOB_DIR}/genie/applications/app1/genie_setup.sh

echo "Sourcing setup script for application app2"
source ${GENIE_JOB_DIR}/genie/applications/app2/genie_setup.sh

echo "Sourcing setup script for command cmd1"
source ${GENIE_JOB_DIR}/genie/command/cmd1/genie_setup.sh

echo "Sourcing setup script for job 8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c"
source ${GENIE_JOB_DIR}/genie_setup.sh


echo "Setup end: $(date '+%Y-%m-%d %H:%M:%S')"

# Setup completed successfully, delete marker file
rm ${__GENIE_SETUP_ERROR_MARKER_FILE}

# Restore the original stdout and stderr. Close fd 6 and 7
exec 1>&6 6>&-
exec 2>&7 7>&-

# Dump environment post-setup
env | grep -E --regex='.*' | sort > ${__GENIE_ENVIRONMENT_DUMP_FILE}

# Launch the command
/bin/bash -c 'sleep 5 && echo hello world' <&0 &
wait %1
exit $?

6.7. Get a Job Request

6.7.1. Description

Get the original request which spawned the job.

6.7.2. Endpoint

GET /api/v3/jobs/{id}/request

6.7.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 7. /api/v3/jobs/{id}/request
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/request' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/request'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

commandArgs

String

Any arguments to append to the command executable when the job is run

Size must be between 0 and 10000 inclusive

true

clusterCriterias

Array

List of cluster criteria’s for which a match will be attempted with register cluster tags. Each set of tags within a given cluster criteria must have at least one non-blank (e.g. ' ', ' ', null) tag.

Must not be empty

false

commandCriteria

Array

Set of tags which will attempt to match against the commands linked to selected cluster. There must be at least one non-blank (e.g. ' ', ' ', null) criteria within the set

Must not be empty

false

group

String

A group that the job should be run under on the linux system

Size must be between 0 and 255 inclusive

true

disableLogArchival

Boolean

If you want to disable backing up job output files set this to true. Default: false

true

email

String

If you want e-mail notification on job completion enter address here

Must be a well-formed email address. Size must be between 0 and 255 inclusive

true

cpu

Number

For future use. Currently has no impact.

Must be at least 1

true

memory

Number

The amount of memory (in MB) desired for job client. Cannot exceed configured max.

Must be at least 1

true

timeout

Number

The timeout (in seconds) after which job will be killed by system, system setting used if not set

Must be at least 1

true

configs

Array

URI’s of configuration files which will be downloaded into job working directory at runtime

true

dependencies

Array

URI’s of dependency files which will be downloaded into job working directory at runtime

true

applications

Array

Complete list of application ids if power user wishes to override selected command defaults

true

grouping

String

The grouping of the job relative to other jobs. e.g. scheduler job name

true

groupingInstance

String

The grouping instance of the job relative to other jobs. e.g. scheduler job run

true
HATEOAS Links
Relation Description

self

URI for this job request

job

The job that resulted from this request

execution

The job execution that resulted from this request

metadata

The job metadata information for this job

output

The output URI for the job

status

The current status of the job
HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/request HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:06:12 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 2166

{
  "id" : "8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c",
  "created" : "2022-01-18T23:05:55.936Z",
  "updated" : "2022-01-18T23:06:11.408Z",
  "version" : "1.0",
  "user" : "genie",
  "name" : "List * ... Directories bash job",
  "description" : "Genie 3 Test Job",
  "metadata" : {
    "schedulerJobName" : "93eea3f3-dd2b-4de0-bd04-761032b6b9f6",
    "schedulerRunId" : "46889d1d-ecf5-4f8a-8c46-28b09d0406df"
  },
  "tags" : [ "aTag", "zTag" ],
  "configs" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/config1" ],
  "dependencies" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/dep1" ],
  "setupFile" : "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/job/jobsetupfile",
  "commandArgs" : "-c 'sleep 5 && echo hello world'",
  "clusterCriterias" : [ {
    "tags" : [ "localhost" ]
  } ],
  "commandCriteria" : [ "bash" ],
  "group" : null,
  "disableLogArchival" : false,
  "email" : null,
  "cpu" : null,
  "memory" : null,
  "timeout" : null,
  "applications" : [ ],
  "grouping" : "Workflow.Foo",
  "groupingInstance" : "Workflow.Foo_Step.Blah-2020021919:12:34.000_1",
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/request"
    },
    "job" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c"
    },
    "execution" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/execution"
    },
    "output" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output"
    },
    "status" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/status"
    },
    "metadata" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/metadata"
    }
  }
}

6.8. Get a Job Execution

6.8.1. Description

Get metadata about a job execution. Information like where a job was run, its process exit code, etc.

6.8.2. Endpoint

GET /api/v3/jobs/{id}/execution

6.8.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 8. /api/v3/jobs/{id}/execution
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/execution' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/execution'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

hostName

String

The host name of the Genie node responsible for the job

Size must be between 1 and 1024 inclusive

false

processId

Number

The id of the job client process on the Genie node

true

checkDelay

Number

The amount of time in milliseconds between checks of the job status by Genie

Must be at least 1

true

timeout

String

The date (UTC ISO8601 with millis) when the job will be killed by Genie due to timeout

true

exitCode

Number

The job client process exit code after the job is done

true

memory

Number

The amount of memory (in MB) allocated to the job client

Must be at least 1

true

archiveStatus

String

The archival status of the job directory

true

launcherExt

Object

JSON object that contains metadata specific to the launcher implementation for the job

true
HATEOAS Links
Relation Description

self

URI for this job execution

job

The job associated with this execution

request

The job request that spawned this execution

metadata

The job metadata information for this job

output

The output URI for the job

status

The current status of the job
HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/execution HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:06:12 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 1227

{
  "id" : "8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c",
  "created" : "2022-01-18T23:05:55.936Z",
  "updated" : "2022-01-18T23:06:11.408Z",
  "hostName" : "localhost",
  "processId" : null,
  "checkDelay" : null,
  "timeout" : "2022-01-25T23:06:06.152Z",
  "exitCode" : null,
  "memory" : 1024,
  "archiveStatus" : "ARCHIVED",
  "launcherExt" : {
    "launcherClass" : "com.netflix.genie.web.agent.launchers.impl.LocalAgentLauncherImpl",
    "sourceHostname" : "localhost"
  },
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/execution"
    },
    "job" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c"
    },
    "request" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/request"
    },
    "output" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output"
    },
    "status" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/status"
    },
    "metadata" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/metadata"
    }
  }
}

6.9. Get Job Metadata

6.9.1. Description

Get metadata about a job beyond core information. Information like where a job was submitted from, how large its output files were, etc.

6.9.2. Endpoint

GET /api/v3/jobs/{id}/metadata

6.9.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 9. /api/v3/jobs/{id}/metadata
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/metadata' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/metadata'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

clientHost

String

The host name of the client that submitted the job to Genie

true

userAgent

String

The user agent string that was passed to Genie on job request

true

numAttachments

Number

The number of attachments sent to Genie with the job request

true

totalSizeOfAttachments

Number

The total size of all attachments sent to Genie with the job request. In bytes.

true

stdOutSize

Number

The final size of the stdout file after a job is completed. In bytes.

true

stdErrSize

Number

The final size of the stderr file after a job is completed. In bytes.

true
HATEOAS Links
Relation Description

self

URI for this job metadata

job

The job associated with this execution

request

The job request that spawned this execution

execution

The job execution information for this job

output

The output URI for the job

status

The current status of the job
HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/metadata HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:06:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 1083

{
  "id" : "8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c",
  "created" : "2022-01-18T23:05:55.936Z",
  "updated" : "2022-01-18T23:06:11.408Z",
  "clientHost" : "127.0.0.1",
  "userAgent" : "Apache-HttpClient/4.5.13 (Java/1.8.0_292)",
  "numAttachments" : 0,
  "totalSizeOfAttachments" : 0,
  "stdOutSize" : null,
  "stdErrSize" : null,
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/metadata"
    },
    "job" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c"
    },
    "request" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/request"
    },
    "output" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/output"
    },
    "status" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/status"
    },
    "execution" : {
      "href" : "https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/execution"
    }
  }
}

6.10. Get the Cluster a Job Ran On

6.10.1. Description

Get the metadata about the cluster which was selected to run the job based on the cluster and command criteria in the job request.

6.10.2. Endpoint

GET /api/v3/jobs/{id}/cluster

6.10.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 10. /api/v3/jobs/{id}/cluster
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/cluster' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/cluster'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

status

String

The status of the cluster. Options: [UP, OUT_OF_SERVICE, TERMINATED]

Must not be null

false

dependencies

Array

The dependencies for the cluster

true
HATEOAS Links
Relation Description

self

URI for this cluster

commands

Get all the commands this cluster can use
HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/cluster HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:06:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 1490

{
  "id" : "cluster1",
  "created" : "2022-01-18T23:05:55.838Z",
  "updated" : "2022-01-18T23:05:55.838Z",
  "version" : "1.0",
  "user" : "genie",
  "name" : "Local laptop",
  "description" : null,
  "metadata" : null,
  "tags" : [ "localhost", "genie.id:cluster1", "genie.name:Local laptop" ],
  "configs" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cluster1/config1", "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cluster1/config2" ],
  "dependencies" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cluster1/dep1", "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cluster1/dep2" ],
  "setupFile" : "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cluster1/setupfile",
  "status" : "UP",
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/clusters/cluster1"
    },
    "commands" : {
      "href" : "https://genie.example.com/api/v3/clusters/cluster1/commands{?status}",
      "templated" : true
    }
  }
}

6.11. Get the Command a Job Executed

6.11.1. Description

Get the metadata about the command which was selected to be executed by the job based on the cluster and command criteria in the job request.

6.11.2. Endpoint

GET /api/v3/jobs/{id}/command

6.11.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 11. /api/v3/jobs/{id}/command
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/command' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/command'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

status

String

The status of the command. Options: [ACTIVE, DEPRECATED, INACTIVE]

Must not be null

false

executable

String

The executable to run on the Genie node when this command is used. e.g. /usr/bin/hadoop

Must not be empty. Size must be between 0 and 1024 inclusive

false

executableAndArguments

Array

The executable and arguments to run on the Genie node when this command is used. e.g. /usr/bin/hadoop

Must not be empty

false

checkDelay

Number

The amount of time (in milliseconds) to delay between checks of the jobs using this command

Must be at least 1

false

memory

Number

The default amount of memory (in MB) that should be allocated for instances of this command client

Must be at least 1

true

dependencies

Array

The dependencies for the command

true

clusterCriteria

Array

The priority ordered list of criteria to resolve clusters that this command can run jobs on

true
HATEOAS Links
Relation Description

self

URI for this command

applications

Get all the applications this command depends on

clusters

Get all clusters this command is available on
HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/command HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:06:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 2011

{
  "id" : "cmd1",
  "created" : "2022-01-18T23:05:55.872Z",
  "updated" : "2022-01-18T23:05:55.900Z",
  "version" : "1.0",
  "user" : "genie",
  "name" : "Unix Bash command",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:Unix Bash command", "bash", "genie.id:cmd1" ],
  "configs" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cmd1/config2", "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cmd1/GB18030.txt", "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cmd1/config1" ],
  "dependencies" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cluster1/dep1", "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cluster1/dep2" ],
  "setupFile" : "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/cmd1/setupfile",
  "status" : "ACTIVE",
  "executable" : "/bin/bash",
  "executableAndArguments" : [ "/bin/bash" ],
  "checkDelay" : 250,
  "memory" : null,
  "clusterCriteria" : [ {
    "id" : null,
    "name" : null,
    "version" : null,
    "status" : null,
    "tags" : [ "localhost" ]
  } ],
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/commands/cmd1"
    },
    "applications" : {
      "href" : "https://genie.example.com/api/v3/commands/cmd1/applications"
    },
    "clusters" : {
      "href" : "https://genie.example.com/api/v3/commands/cmd1/clusters{?status}",
      "templated" : true
    }
  }
}

6.12. Get the Applications a Job Command Used

6.12.1. Description

Get the list of applications that were used by the command selected by job to execute.

6.12.2. Endpoint

GET /api/v3/jobs/{id}/applications

6.12.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 12. /api/v3/jobs/{id}/applications
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/applications' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/applications'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

[]

Array

The applications for the job

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/jobs/8c5cd77f-eda5-4244-a30f-d2aacb5b2e6c/applications HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:06:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 2904

[ {
  "id" : "app1",
  "created" : "2022-01-18T23:05:55.787Z",
  "updated" : "2022-01-18T23:05:55.787Z",
  "version" : "1.0",
  "user" : "genie",
  "name" : "Application 1",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.id:app1", "genie.name:Application 1" ],
  "configs" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/app1/config1", "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/app1/config2" ],
  "dependencies" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/app1/dep2", "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/app1/dep1" ],
  "setupFile" : "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/app1/setupfile",
  "status" : "ACTIVE",
  "type" : null,
  "links" : [ {
    "rel" : "self",
    "href" : "https://genie.example.com/api/v3/applications/app1"
  }, {
    "rel" : "commands",
    "href" : "https://genie.example.com/api/v3/applications/app1/commands{?status}"
  } ]
}, {
  "id" : "app2",
  "created" : "2022-01-18T23:05:55.810Z",
  "updated" : "2022-01-18T23:05:55.810Z",
  "version" : "1.0",
  "user" : "genie",
  "name" : "Application 2",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.id:app2", "genie.name:Application 2" ],
  "configs" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/app2/config1", "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/app2/config2" ],
  "dependencies" : [ "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/app2/dep1", "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/app2/dep2" ],
  "setupFile" : "file:/home/travis/build/Netflix/genie/genie-web/build/resources/integTest/com/netflix/genie/web/apis/rest/v3/controllers/JobRestControllerIntegrationTests/app2/setupfile",
  "status" : "ACTIVE",
  "type" : null,
  "links" : [ {
    "rel" : "self",
    "href" : "https://genie.example.com/api/v3/applications/app2"
  }, {
    "rel" : "commands",
    "href" : "https://genie.example.com/api/v3/applications/app2/commands{?status}"
  } ]
} ]

7. Applications API

7.1. Create an Application

7.1.1. Description

Create a new application in the system.

7.1.2. Endpoint

POST /api/v3/applications

The id in this example is optional. If you include one Genie will use it. If not it will provide one. If you provide one it must be unique.

7.1.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters

None

Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

type

String

The type of application this is (e.g. hadoop, presto, spark). Can be used to group.

true

status

String

The status of the application. Options: [ACTIVE, DEPRECATED, INACTIVE]

Must not be null

false

dependencies

Array

The dependencies for the application

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "1.5.1",
  "user" : "genie",
  "name" : "spark",
  "description" : "Spark for Genie",
  "metadata" : null,
  "tags" : [ "type:spark", "ver:1.5.1" ],
  "configs" : [ "s3://mybucket/spark/1.5.1/spark-env.sh" ],
  "dependencies" : [ "s3://mybucket/spark/1.5.1/spark.tar.gz" ],
  "setupFile" : "s3://mybucket/spark/1.5.1/setupBase-spark.sh",
  "status" : "ACTIVE",
  "type" : "spark"
}'
HTTPie
$ echo '{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "1.5.1",
  "user" : "genie",
  "name" : "spark",
  "description" : "Spark for Genie",
  "metadata" : null,
  "tags" : [ "type:spark", "ver:1.5.1" ],
  "configs" : [ "s3://mybucket/spark/1.5.1/spark-env.sh" ],
  "dependencies" : [ "s3://mybucket/spark/1.5.1/spark.tar.gz" ],
  "setupFile" : "s3://mybucket/spark/1.5.1/setupBase-spark.sh",
  "status" : "ACTIVE",
  "type" : "spark"
}' | http POST 'https://genie.example.com/api/v3/applications' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers
Name Description

Location

The URI
Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/applications HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 452

{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "1.5.1",
  "user" : "genie",
  "name" : "spark",
  "description" : "Spark for Genie",
  "metadata" : null,
  "tags" : [ "type:spark", "ver:1.5.1" ],
  "configs" : [ "s3://mybucket/spark/1.5.1/spark-env.sh" ],
  "dependencies" : [ "s3://mybucket/spark/1.5.1/spark.tar.gz" ],
  "setupFile" : "s3://mybucket/spark/1.5.1/setupBase-spark.sh",
  "status" : "ACTIVE",
  "type" : "spark"
}
Response
HTTP/1.1 201 Created
Location: https://genie.example.com/api/v3/applications/fdd9be4b-2554-4e85-9f48-c657a0866aeb
Date: Tue, 18 Jan 2022 23:05:25 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.2. Get an Application

7.2.1. Description

Get the metadata about an application in the system.

7.2.2. Endpoint

GET /api/v3/applications/{id}

7.2.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 13. /api/v3/applications/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/fdd9be4b-2554-4e85-9f48-c657a0866aeb' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/applications/fdd9be4b-2554-4e85-9f48-c657a0866aeb'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

type

String

The type of application this is (e.g. hadoop, presto, spark). Can be used to group.

true

status

String

The status of the application. Options: [ACTIVE, DEPRECATED, INACTIVE]

Must not be null

false

dependencies

Array

The dependencies for the application

true
HATEOAS Links
Relation Description

self

URI for this application

commands

Get all the commands using this application
HTTP Messages
Request
GET /api/v3/applications/fdd9be4b-2554-4e85-9f48-c657a0866aeb HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:25 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 910

{
  "id" : "fdd9be4b-2554-4e85-9f48-c657a0866aeb",
  "created" : "2022-01-18T23:05:25.584Z",
  "updated" : "2022-01-18T23:05:25.584Z",
  "version" : "1.5.1",
  "user" : "genie",
  "name" : "spark",
  "description" : "Spark for Genie",
  "metadata" : null,
  "tags" : [ "type:spark", "genie.id:fdd9be4b-2554-4e85-9f48-c657a0866aeb", "ver:1.5.1", "genie.name:spark" ],
  "configs" : [ "s3://mybucket/spark/1.5.1/spark-env.sh" ],
  "dependencies" : [ "s3://mybucket/spark/1.5.1/spark.tar.gz" ],
  "setupFile" : "s3://mybucket/spark/1.5.1/setupBase-spark.sh",
  "status" : "ACTIVE",
  "type" : "spark",
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/applications/fdd9be4b-2554-4e85-9f48-c657a0866aeb"
    },
    "commands" : {
      "href" : "https://genie.example.com/api/v3/applications/fdd9be4b-2554-4e85-9f48-c657a0866aeb/commands{?status}",
      "templated" : true
    }
  }
}

7.3. Find Applications

7.3.1. Description

Find applications using various query parameters.

7.3.2. Endpoint

GET /api/v3/applications

7.3.3. API Docs

Request Documentation
Headers

None

Path Parameters

None

Query Parameters
Parameter Description

page

The page number to get. Default to 0.

size

The size of the page to get. Default to 64.

sort

The fields to sort the results by. Defaults to 'updated,desc'.

name

The name of the applications to find. Use % to perform a regex like query

user

The user of the applications to find. Use % to perform a regex like query

status

The status(es) of the applications to find. Can have multiple. Options: [ACTIVE, DEPRECATED, INACTIVE]

tag

The tag(s) of the applications to find. Can have multiple.

type

The type of the applications to find. Use % to perform a regex like query
Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications?status=ACTIVE&status=DEPRECATED&status=%5BACTIVE%2C+DEPRECATED%5D' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/applications?status=ACTIVE&status=DEPRECATED&status=%5BACTIVE%2C+DEPRECATED%5D'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

_links

Object

Links to other resources.

false

page

Object

The result page information.

false

page.size

Number

The number of elements in this page result.

false

page.totalElements

Number

The total number of elements this search result could return.

false

page.totalPages

Number

The total number of pages there could be at the current page size.

false

page.number

Number

The current page number.

false

_embedded.applicationList

Array

The found applications.

false
HATEOAS Links
Relation Description

self

The current search

first

The first page for this search

prev

The previous page for this search

next

The next page for this search

last

The last page for this search
HTTP Messages
Request
GET /api/v3/applications?status=ACTIVE&status=DEPRECATED&status=%5BACTIVE%2C+DEPRECATED%5D HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:23 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 6406

{
  "_embedded" : {
    "applicationList" : [ {
      "id" : "6ddad5b8-6210-46f3-9588-e5c477be8017",
      "created" : "2022-01-18T23:05:23.308Z",
      "updated" : "2022-01-18T23:05:23.308Z",
      "version" : "1.0.0",
      "user" : "genieUser7",
      "name" : "hive",
      "description" : "Hive 1.0.0 for Genie",
      "metadata" : null,
      "tags" : [ "type:hive", "genie.name:hive", "ver:1.0.0", "genie.id:6ddad5b8-6210-46f3-9588-e5c477be8017" ],
      "configs" : [ "s3://mybucket/hive/hive-env.sh", "s3://mybucket/hive/hive-log4j.properties" ],
      "dependencies" : [ "s3://mybucket/hive/hive-1.0.0.tar.gz" ],
      "setupFile" : "s3://mybucket/hive/setupBase-hive.sh",
      "status" : "ACTIVE",
      "type" : "hive",
      "_links" : {
        "self" : {
          "href" : "https://genie.example.com/api/v3/applications/6ddad5b8-6210-46f3-9588-e5c477be8017"
        },
        "commands" : {
          "href" : "https://genie.example.com/api/v3/applications/6ddad5b8-6210-46f3-9588-e5c477be8017/commands{?status}",
          "templated" : true
        }
      }
    }, {
      "id" : "0baa9780-dbab-4382-9841-b7dd4d53d523",
      "created" : "2022-01-18T23:05:23.258Z",
      "updated" : "2022-01-18T23:05:23.258Z",
      "version" : "0.4.0",
      "user" : "genieUser6",
      "name" : "spark",
      "description" : "Pig 0.15.0 for Genie",
      "metadata" : null,
      "tags" : [ "ver:0.15.0", "type:pig", "genie.id:0baa9780-dbab-4382-9841-b7dd4d53d523", "genie.name:spark" ],
      "configs" : [ "s3://mybucket/pig/pig.properties" ],
      "dependencies" : [ "s3://mybucket/pig/pig-0.15.0.tar.gz" ],
      "setupFile" : "s3://mybucket/pig/setupBase-pig.sh",
      "status" : "ACTIVE",
      "type" : "pig",
      "_links" : {
        "self" : {
          "href" : "https://genie.example.com/api/v3/applications/0baa9780-dbab-4382-9841-b7dd4d53d523"
        },
        "commands" : {
          "href" : "https://genie.example.com/api/v3/applications/0baa9780-dbab-4382-9841-b7dd4d53d523/commands{?status}",
          "templated" : true
        }
      }
    }, {
      "id" : "63159780-37f2-431b-9c9d-a8330e325c61",
      "created" : "2022-01-18T23:05:23.227Z",
      "updated" : "2022-01-18T23:05:23.227Z",
      "version" : "1.3.1",
      "user" : "genieUser5",
      "name" : "spark",
      "description" : "Spark 1.3.1 for Genie",
      "metadata" : null,
      "tags" : [ "type:spark", "genie.id:63159780-37f2-431b-9c9d-a8330e325c61", "ver:1.3.1", "genie.name:spark" ],
      "configs" : [ "s3://mybucket/spark/spark-env.sh" ],
      "dependencies" : [ "s3://mybucket/spark/spark-1.3.1.tar.gz" ],
      "setupFile" : "s3://mybucket/spark/setupBase-spark.sh",
      "status" : "DEPRECATED",
      "type" : "spark",
      "_links" : {
        "self" : {
          "href" : "https://genie.example.com/api/v3/applications/63159780-37f2-431b-9c9d-a8330e325c61"
        },
        "commands" : {
          "href" : "https://genie.example.com/api/v3/applications/63159780-37f2-431b-9c9d-a8330e325c61/commands{?status}",
          "templated" : true
        }
      }
    }, {
      "id" : "a808dda8-74d6-4f6d-96a1-56d25a82dae6",
      "created" : "2022-01-18T23:05:23.199Z",
      "updated" : "2022-01-18T23:05:23.199Z",
      "version" : "1.4.0",
      "user" : "genieUser4",
      "name" : "spark",
      "description" : "Spark 1.4.0 for Genie",
      "metadata" : null,
      "tags" : [ "type:spark", "ver:1.4.0", "genie.name:spark", "genie.id:a808dda8-74d6-4f6d-96a1-56d25a82dae6" ],
      "configs" : [ "s3://mybucket/spark/spark-env.sh" ],
      "dependencies" : [ "s3://mybucket/spark/spark-1.4.0.tar.gz" ],
      "setupFile" : "s3://mybucket/spark/setupBase-spark.sh",
      "status" : "DEPRECATED",
      "type" : "spark",
      "_links" : {
        "self" : {
          "href" : "https://genie.example.com/api/v3/applications/a808dda8-74d6-4f6d-96a1-56d25a82dae6"
        },
        "commands" : {
          "href" : "https://genie.example.com/api/v3/applications/a808dda8-74d6-4f6d-96a1-56d25a82dae6/commands{?status}",
          "templated" : true
        }
      }
    }, {
      "id" : "4e23f98a-7177-42f1-99e2-9a8f8d952403",
      "created" : "2022-01-18T23:05:23.141Z",
      "updated" : "2022-01-18T23:05:23.141Z",
      "version" : "1.5.0",
      "user" : "genieUser2",
      "name" : "spark",
      "description" : "Spark 1.5.0 for Genie",
      "metadata" : null,
      "tags" : [ "type:spark", "ver:1.5.0", "genie.id:4e23f98a-7177-42f1-99e2-9a8f8d952403", "genie.name:spark" ],
      "configs" : [ "s3://mybucket/spark/spark-env.sh" ],
      "dependencies" : [ "s3://mybucket/spark/spark-1.5.0.tar.gz" ],
      "setupFile" : "s3://mybucket/spark/setupBase-spark.sh",
      "status" : "ACTIVE",
      "type" : "spark",
      "_links" : {
        "self" : {
          "href" : "https://genie.example.com/api/v3/applications/4e23f98a-7177-42f1-99e2-9a8f8d952403"
        },
        "commands" : {
          "href" : "https://genie.example.com/api/v3/applications/4e23f98a-7177-42f1-99e2-9a8f8d952403/commands{?status}",
          "templated" : true
        }
      }
    }, {
      "id" : "5bea8743-1b3b-437d-807c-124b0c57d487",
      "created" : "2022-01-18T23:05:23.094Z",
      "updated" : "2022-01-18T23:05:23.094Z",
      "version" : "1.5.1",
      "user" : "genieUser1",
      "name" : "spark",
      "description" : "Spark 1.5.1 for Genie",
      "metadata" : null,
      "tags" : [ "genie.id:5bea8743-1b3b-437d-807c-124b0c57d487", "type:spark", "ver:1.5.1", "genie.name:spark" ],
      "configs" : [ "s3://mybucket/spark/spark-env.sh" ],
      "dependencies" : [ "s3://mybucket/spark/spark-1.5.1.tar.gz" ],
      "setupFile" : "s3://mybucket/spark/setupBase-spark.sh",
      "status" : "ACTIVE",
      "type" : "spark",
      "_links" : {
        "self" : {
          "href" : "https://genie.example.com/api/v3/applications/5bea8743-1b3b-437d-807c-124b0c57d487"
        },
        "commands" : {
          "href" : "https://genie.example.com/api/v3/applications/5bea8743-1b3b-437d-807c-124b0c57d487/commands{?status}",
          "templated" : true
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/applications?status=ACTIVE&status=DEPRECATED{&name,user,tag,type}",
      "templated" : true
    }
  },
  "page" : {
    "size" : 10,
    "totalElements" : 6,
    "totalPages" : 1,
    "number" : 0
  }
}

7.4. Update an Entire Application

7.4.1. Description

Update the metadata about an application. This method does a complete replace of the resource. Usual flow is to call to get the most recent state then update what you want and call this API with the result.

For more fine grained control call the PATCH API.

7.4.2. Endpoint

PUT /api/v3/applications/{id}

7.4.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 14. /api/v3/applications/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

type

String

The type of application this is (e.g. hadoop, presto, spark). Can be used to group.

true

status

String

The status of the application. Options: [ACTIVE, DEPRECATED, INACTIVE]

Must not be null

false

dependencies

Array

The dependencies for the application

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "id" : "3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4",
  "created" : "2022-01-18T23:05:26.675Z",
  "updated" : "2022-01-18T23:05:26.675Z",
  "version" : "1.5.1",
  "user" : "genie",
  "name" : "spark",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:spark", "genie.id:3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "INACTIVE",
  "type" : null
}'
HTTPie
$ echo '{
  "id" : "3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4",
  "created" : "2022-01-18T23:05:26.675Z",
  "updated" : "2022-01-18T23:05:26.675Z",
  "version" : "1.5.1",
  "user" : "genie",
  "name" : "spark",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:spark", "genie.id:3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "INACTIVE",
  "type" : null
}' | http PUT 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4 HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 508

{
  "id" : "3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4",
  "created" : "2022-01-18T23:05:26.675Z",
  "updated" : "2022-01-18T23:05:26.675Z",
  "version" : "1.5.1",
  "user" : "genie",
  "name" : "spark",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:spark", "genie.id:3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "INACTIVE",
  "type" : null
}
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:26 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.5. Update Parts of an Application

7.5.1. Description

Update the metadata about an application using JSON Patch. This will ONLY update the fields you request be changed.

For more information about JSON Patch RFC see the website.

7.5.2. Endpoint

PATCH /api/v3/applications/{id}

7.5.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 15. /api/v3/applications/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of patches to apply

false

[].op

String

Patch operation to perform.

add, remove, replace, copy, move, test

false

[].path

String

The json path to operate on. e.g. /user

false

[].from

String

The json path to move or copy from. e.g. /user

true

[].value

String

The json value to put at the path for an add, replace or test

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4' -i -X PATCH \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ {
  "op" : "replace",
  "path" : "/user",
  "value" : "20904484-2650-41ca-9ce6-0eb1157ee1df"
} ]'
HTTPie
$ echo '[ {
  "op" : "replace",
  "path" : "/user",
  "value" : "20904484-2650-41ca-9ce6-0eb1157ee1df"
} ]' | http PATCH 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PATCH /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4 HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 98

[ {
  "op" : "replace",
  "path" : "/user",
  "value" : "20904484-2650-41ca-9ce6-0eb1157ee1df"
} ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:22 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.6. Delete All Applications

7.6.1. Description

Delete all the applications currently stored in the system.

7.6.2. Endpoint

DELETE /api/v3/applications

7.6.3. API Docs

Request Documentation
Headers

None

Path Parameters

None

Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/applications'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/applications HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:26 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.7. Delete an Application

7.7.1. Description

Delete an application currently configured in the system.

7.7.2. Endpoint

DELETE /api/v3/applications/{id}

7.7.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 16. /api/v3/applications/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/4fcd70ba-549a-4578-b351-519ec3b285a5' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/applications/4fcd70ba-549a-4578-b351-519ec3b285a5'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/applications/4fcd70ba-549a-4578-b351-519ec3b285a5 HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:26 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.8. Get Configs for Application

7.8.1. Description

Get the configuration file locations for an application.

7.8.2. Endpoint

GET /api/v3/applications/{id}/configs

7.8.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 17. /api/v3/applications/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of configuration file locations

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 82

[ "d09dab5f-875c-449c-87f4-9c1ec54697dd", "89192930-78b0-4ded-9d10-f869fbb0dbf0" ]

7.9. Add Configs to Application

7.9.1. Description

Add configuration file locations to an existing application. Configurations are stored as a set so any duplicates will be ignored.

7.9.2. Endpoint

POST /api/v3/applications/{id}/configs

7.9.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 18. /api/v3/applications/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of configuration file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "d09dab5f-875c-449c-87f4-9c1ec54697dd", "89192930-78b0-4ded-9d10-f869fbb0dbf0" ]'
HTTPie
$ echo '[ "d09dab5f-875c-449c-87f4-9c1ec54697dd", "89192930-78b0-4ded-9d10-f869fbb0dbf0" ]' | http POST 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "d09dab5f-875c-449c-87f4-9c1ec54697dd", "89192930-78b0-4ded-9d10-f869fbb0dbf0" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.10. Update Configs for an Application

7.10.1. Description

Update the configuration file locations for an existing application. Stored as a set so duplicates are ignored.

7.10.2. Endpoint

PUT /api/v3/applications/{id}/configs

7.10.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 19. /api/v3/applications/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of configuration file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "7661c458-3695-47e4-bc0a-61152599a7e4" ]'
HTTPie
$ echo '[ "7661c458-3695-47e4-bc0a-61152599a7e4" ]' | http PUT 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 42

[ "7661c458-3695-47e4-bc0a-61152599a7e4" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:26 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.11. Remove All Configs From an Application

7.11.1. Description

Remove all the configuration file locations for an existing application.

7.11.2. Endpoint

DELETE /api/v3/applications/{id}/configs

7.11.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 20. /api/v3/applications/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/configs HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.12. Get Dependencies For an Application

7.12.1. Description

Get the dependency file locations for an application.

7.12.2. Endpoint

GET /api/v3/applications/{id}/dependencies

7.12.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 21. /api/v3/applications/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of dependency file locations

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:25 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 82

[ "2efefb41-534c-4d44-b5c8-e569e4310c68", "cc6b3b05-df40-426d-ac6d-2eeddb976bac" ]

7.13. Add Dependencies to Application

7.13.1. Description

Add dependency file locations to an existing application. Stored as a set so all duplicates are ignored.

7.13.2. Endpoint

POST /api/v3/applications/{id}/dependencies

7.13.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 22. /api/v3/applications/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of dependency file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "2efefb41-534c-4d44-b5c8-e569e4310c68", "cc6b3b05-df40-426d-ac6d-2eeddb976bac" ]'
HTTPie
$ echo '[ "2efefb41-534c-4d44-b5c8-e569e4310c68", "cc6b3b05-df40-426d-ac6d-2eeddb976bac" ]' | http POST 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "2efefb41-534c-4d44-b5c8-e569e4310c68", "cc6b3b05-df40-426d-ac6d-2eeddb976bac" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:25 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.14. Update Dependencies for an Application

7.14.1. Description

Update the dependency file locations for an existing application

7.14.2. Endpoint

PUT /api/v3/applications/{id}/dependencies

7.14.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 23. /api/v3/applications/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of dependency file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "71284d38-2b8f-44a4-bdbc-9e343053ff22" ]'
HTTPie
$ echo '[ "71284d38-2b8f-44a4-bdbc-9e343053ff22" ]' | http PUT 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 42

[ "71284d38-2b8f-44a4-bdbc-9e343053ff22" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.15. Remove All Dependencies From an Application

7.15.1. Description

Remove all the dependency file locations for an existing application.

7.15.2. Endpoint

DELETE /api/v3/applications/{id}/dependencies

7.15.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 24. /api/v3/applications/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/dependencies HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.16. Get Tags For an Application

7.16.1. Description

Get the tags for an application.

7.16.2. Endpoint

GET /api/v3/applications/{id}/tags

7.16.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 25. /api/v3/applications/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of tags

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:25 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 188

[ "501d42ff-aba9-44db-82a6-83fcde14036b", "5c646832-1100-4c10-adcc-164420793bb4", "genie.name:spark", "genie.id:3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4" ]

7.17. Add Tags to Application

7.17.1. Description

Add tags to an existing application. Stored as a set so all duplicates are ignored.

genie.id:{id} and genie.name:{name} tags are automatically added by the service.

7.17.2. Endpoint

POST /api/v3/applications/{id}/tags

7.17.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 26. /api/v3/applications/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of tags

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "5c646832-1100-4c10-adcc-164420793bb4", "501d42ff-aba9-44db-82a6-83fcde14036b" ]'
HTTPie
$ echo '[ "5c646832-1100-4c10-adcc-164420793bb4", "501d42ff-aba9-44db-82a6-83fcde14036b" ]' | http POST 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "5c646832-1100-4c10-adcc-164420793bb4", "501d42ff-aba9-44db-82a6-83fcde14036b" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:25 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.18. Update Tags for an Application

7.18.1. Description

Update the tags for an existing application.

The genie.id:{id} and genie.name:{name} tags can’t be removed. They will automatically be added back by the system.

7.18.2. Endpoint

PUT /api/v3/applications/{id}/tags

7.18.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 27. /api/v3/applications/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of tags

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "37dbaeac-e13c-44f4-90f3-773e54e0bdd4" ]'
HTTPie
$ echo '[ "37dbaeac-e13c-44f4-90f3-773e54e0bdd4" ]' | http PUT 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 42

[ "37dbaeac-e13c-44f4-90f3-773e54e0bdd4" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:25 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.19. Remove All Tags From Application

7.19.1. Description

Remove all the tags for an existing application

The genie.id:{id} and genie.name:{name} tags will NOT be removed by this operation

7.19.2. Endpoint

DELETE /api/v3/applications/{id}/tags

7.19.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 28. /api/v3/applications/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.20. Remove Tag From Application

7.20.1. Description

Remove a tag from an existing application.

You can’t remove the genie.id:{id} and genie.name:{name} tags. They will just be added back by the system

7.20.2. Endpoint

DELETE /api/v3/applications/{id}/tags/{tag}

7.20.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 29. /api/v3/applications/{id}/tags/{tag}
Parameter Description

id

The resource id

tag

The tag to remove
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags/bfbc0388-811f-4372-8d19-20945d7866e6' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags/bfbc0388-811f-4372-8d19-20945d7866e6'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/tags/bfbc0388-811f-4372-8d19-20945d7866e6 HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:24 GMT
Keep-Alive: timeout=60
Connection: keep-alive

7.21. Get the Commands that Use an Application

7.21.1. Description

Search the commands that use the given application.

7.21.2. Endpoint

GET /api/v3/applications/{id}/commands

7.21.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 30. /api/v3/applications/{id}/commands
Parameter Description

id

The resource id
Query Parameters
Parameter Description

status

The status of commands to search for
Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/commands?status=ACTIVE&status=INACTIVE&status=%5BACTIVE%2C+INACTIVE%5D' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/commands?status=ACTIVE&status=INACTIVE&status=%5BACTIVE%2C+INACTIVE%5D'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

[]

Array

The list of commands found

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/applications/3301865e-a245-4794-895c-4b317f7223b1.2e3cd8e5-aacc-4667-b52d-95ff1a26cba4/commands?status=ACTIVE&status=INACTIVE&status=%5BACTIVE%2C+INACTIVE%5D HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 1100

[ {
  "id" : "f83c5811-99dd-4ffb-b8cb-9dcc6b12db30",
  "created" : "2022-01-18T23:05:27.228Z",
  "updated" : "2022-01-18T23:05:27.309Z",
  "version" : "f59f16ef-48e4-4876-b90d-abd1e47f84ae",
  "user" : "f59f16ef-48e4-4876-b90d-abd1e47f84ae",
  "name" : "f59f16ef-48e4-4876-b90d-abd1e47f84ae",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:f59f16ef-48e4-4876-b90d-abd1e47f84ae", "genie.id:f83c5811-99dd-4ffb-b8cb-9dcc6b12db30" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "ACTIVE",
  "executable" : "bash",
  "executableAndArguments" : [ "bash" ],
  "checkDelay" : 1000,
  "memory" : null,
  "clusterCriteria" : [ ],
  "links" : [ {
    "rel" : "self",
    "href" : "https://genie.example.com/api/v3/commands/f83c5811-99dd-4ffb-b8cb-9dcc6b12db30"
  }, {
    "rel" : "applications",
    "href" : "https://genie.example.com/api/v3/commands/f83c5811-99dd-4ffb-b8cb-9dcc6b12db30/applications"
  }, {
    "rel" : "clusters",
    "href" : "https://genie.example.com/api/v3/commands/f83c5811-99dd-4ffb-b8cb-9dcc6b12db30/clusters{?status}"
  } ]
} ]

8. Clusters API

8.1. Create a Cluster

8.1.1. Description

Create a new cluster in the system.

8.1.2. Endpoint

POST /api/v3/clusters

The id in this example is optional. If you include one Genie will use it. If not it will provide one. If you provide one it must be unique.

8.1.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters

None

Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

status

String

The status of the cluster. Options: [UP, OUT_OF_SERVICE, TERMINATED]

Must not be null

false

dependencies

Array

The dependencies for the cluster

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "2.7.1",
  "user" : "genie",
  "name" : "h2prod",
  "description" : null,
  "metadata" : null,
  "tags" : [ ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "UP"
}'
HTTPie
$ echo '{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "2.7.1",
  "user" : "genie",
  "name" : "h2prod",
  "description" : null,
  "metadata" : null,
  "tags" : [ ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "UP"
}' | http POST 'https://genie.example.com/api/v3/clusters' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers
Name Description

Location

The URI
Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/clusters HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 266

{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "2.7.1",
  "user" : "genie",
  "name" : "h2prod",
  "description" : null,
  "metadata" : null,
  "tags" : [ ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "UP"
}
Response
HTTP/1.1 201 Created
Location: https://genie.example.com/api/v3/clusters/e38b840a-f87d-4983-9cee-e4bc7d19e400
Date: Tue, 18 Jan 2022 23:05:11 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.2. Get a Cluster

8.2.1. Description

Get the metadata about a cluster in the system.

8.2.2. Endpoint

GET /api/v3/clusters/{id}

8.2.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 31. /api/v3/clusters/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/e38b840a-f87d-4983-9cee-e4bc7d19e400' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/clusters/e38b840a-f87d-4983-9cee-e4bc7d19e400'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

status

String

The status of the cluster. Options: [UP, OUT_OF_SERVICE, TERMINATED]

Must not be null

false

dependencies

Array

The dependencies for the cluster

true
HATEOAS Links
Relation Description

self

URI for this cluster

commands

Get all the commands this cluster can use
HTTP Messages
Request
GET /api/v3/clusters/e38b840a-f87d-4983-9cee-e4bc7d19e400 HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:11 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 716

{
  "id" : "e38b840a-f87d-4983-9cee-e4bc7d19e400",
  "created" : "2022-01-18T23:05:11.717Z",
  "updated" : "2022-01-18T23:05:11.717Z",
  "version" : "2.7.1",
  "user" : "genie",
  "name" : "h2prod",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.id:e38b840a-f87d-4983-9cee-e4bc7d19e400", "genie.name:h2prod" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "UP",
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/clusters/e38b840a-f87d-4983-9cee-e4bc7d19e400"
    },
    "commands" : {
      "href" : "https://genie.example.com/api/v3/clusters/e38b840a-f87d-4983-9cee-e4bc7d19e400/commands{?status}",
      "templated" : true
    }
  }
}

8.3. Find Clusters

8.3.1. Description

Find clusters using various query parameters.

8.3.2. Endpoint

GET /api/v3/clusters

8.3.3. API Docs

Request Documentation
Headers

None

Path Parameters

None

Query Parameters
Parameter Description

page

The page number to get. Default to 0.

size

The size of the page to get. Default to 64.

sort

The fields to sort the results by. Defaults to 'updated,desc'.

name

The name of the clusters to find. Use % to perform a regex like query

status

The status(es) of the clusters to find. Can have multiple. Options: [UP, OUT_OF_SERVICE, TERMINATED]

tag

The tag(s) of the clusters to find. Can have multiple.

minUpdateTime

The minimum time (in milliseconds from epoch UTC) that the cluster(s) were updated at.

maxUpdateTime

The maximum time (in milliseconds from epoch UTC) that the cluster(s) were updated at.
Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters?tag=genie.id%3A887a32f0-ec17-48ec-9c07-19749f3f575f' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/clusters?tag=genie.id%3A887a32f0-ec17-48ec-9c07-19749f3f575f'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

_links

Object

Links to other resources.

false

page

Object

The result page information.

false

page.size

Number

The number of elements in this page result.

false

page.totalElements

Number

The total number of elements this search result could return.

false

page.totalPages

Number

The total number of pages there could be at the current page size.

false

page.number

Number

The current page number.

false

_embedded.clusterList

Array

The found clusters.

false
HATEOAS Links
Relation Description

self

The current search

first

The first page for this search

prev

The previous page for this search

next

The next page for this search

last

The last page for this search
HTTP Messages
Request
GET /api/v3/clusters?tag=genie.id%3A887a32f0-ec17-48ec-9c07-19749f3f575f HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:20 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 1296

{
  "_embedded" : {
    "clusterList" : [ {
      "id" : "887a32f0-ec17-48ec-9c07-19749f3f575f",
      "created" : "2022-01-18T23:05:17.978Z",
      "updated" : "2022-01-18T23:05:17.978Z",
      "version" : "72e4f845-2a78-4f10-9bd4-5dad07dbce5f",
      "user" : "b61805c9-9796-48fa-9d30-3e4612326187",
      "name" : "d5464eff-50b9-40f3-9c4f-3abeb8ba7de6",
      "description" : null,
      "metadata" : null,
      "tags" : [ "genie.name:d5464eff-50b9-40f3-9c4f-3abeb8ba7de6", "genie.id:887a32f0-ec17-48ec-9c07-19749f3f575f" ],
      "configs" : [ ],
      "dependencies" : [ ],
      "setupFile" : null,
      "status" : "UP",
      "_links" : {
        "self" : {
          "href" : "https://genie.example.com/api/v3/clusters/887a32f0-ec17-48ec-9c07-19749f3f575f"
        },
        "commands" : {
          "href" : "https://genie.example.com/api/v3/clusters/887a32f0-ec17-48ec-9c07-19749f3f575f/commands{?status}",
          "templated" : true
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/clusters?tag=genie.id:887a32f0-ec17-48ec-9c07-19749f3f575f{&name,status,minUpdateTime,maxUpdateTime}",
      "templated" : true
    }
  },
  "page" : {
    "size" : 1,
    "totalElements" : 1,
    "totalPages" : 1,
    "number" : 0
  }
}

8.4. Update an Entire Cluster

8.4.1. Description

Update the metadata about a cluster. This method does a complete replace of the resource. Usual flow is to call to get the most recent state then update what you want and call this API with the result.

For more fine grained control call the PATCH API.

8.4.2. Endpoint

PUT /api/v3/clusters/{id}

8.4.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 32. /api/v3/clusters/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

status

String

The status of the cluster. Options: [UP, OUT_OF_SERVICE, TERMINATED]

Must not be null

false

dependencies

Array

The dependencies for the cluster

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "id" : "4e822800-a4b3-4cc9-bd15-eecb449707c4",
  "created" : "2022-01-18T23:05:21.557Z",
  "updated" : "2022-01-18T23:05:21.557Z",
  "version" : "2.7.1",
  "user" : "genie",
  "name" : "h2prod",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:h2prod", "genie.id:4e822800-a4b3-4cc9-bd15-eecb449707c4" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "OUT_OF_SERVICE"
}'
HTTPie
$ echo '{
  "id" : "4e822800-a4b3-4cc9-bd15-eecb449707c4",
  "created" : "2022-01-18T23:05:21.557Z",
  "updated" : "2022-01-18T23:05:21.557Z",
  "version" : "2.7.1",
  "user" : "genie",
  "name" : "h2prod",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:h2prod", "genie.id:4e822800-a4b3-4cc9-bd15-eecb449707c4" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "OUT_OF_SERVICE"
}' | http PUT 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4 HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 425

{
  "id" : "4e822800-a4b3-4cc9-bd15-eecb449707c4",
  "created" : "2022-01-18T23:05:21.557Z",
  "updated" : "2022-01-18T23:05:21.557Z",
  "version" : "2.7.1",
  "user" : "genie",
  "name" : "h2prod",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:h2prod", "genie.id:4e822800-a4b3-4cc9-bd15-eecb449707c4" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "OUT_OF_SERVICE"
}
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:21 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.5. Update Parts of a Cluster

8.5.1. Description

Update the metadata about a cluster using JSON Patch. This will ONLY update the fields you request be changed.

For more information about JSON Patch RFC see the website.

8.5.2. Endpoint

PATCH /api/v3/clusters/{id}

8.5.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 33. /api/v3/clusters/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of patches to apply

false

[].op

String

Patch operation to perform.

add, remove, replace, copy, move, test

false

[].path

String

The json path to operate on. e.g. /user

false

[].from

String

The json path to move or copy from. e.g. /user

true

[].value

String

The json value to put at the path for an add, replace or test

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4' -i -X PATCH \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ {
  "op" : "replace",
  "path" : "/name",
  "value" : "379f7520-588f-407b-87b2-0cfd767d0810"
} ]'
HTTPie
$ echo '[ {
  "op" : "replace",
  "path" : "/name",
  "value" : "379f7520-588f-407b-87b2-0cfd767d0810"
} ]' | http PATCH 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PATCH /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4 HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 98

[ {
  "op" : "replace",
  "path" : "/name",
  "value" : "379f7520-588f-407b-87b2-0cfd767d0810"
} ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:22 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.6. Delete All Clusters

8.6.1. Description

Delete all the clusters currently stored in the system.

You won’t be able to delete any cluster that has run any job that is still in the system to maintain the ability for users to look up information about their job (where it ran, etc)

8.6.2. Endpoint

DELETE /api/v3/clusters

8.6.3. API Docs

Request Documentation
Headers

None

Path Parameters

None

Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/clusters'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/clusters HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:21 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.7. Delete a Cluster

8.7.1. Description

Delete a cluster currently configured in the system.

You won’t be able to delete a cluster that has run any job that is still in the system to maintain the ability for users to look up information about their job (where it ran, etc)

8.7.2. Endpoint

DELETE /api/v3/clusters/{id}

8.7.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 34. /api/v3/clusters/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/cf07e3ff-f8de-4d78-bc2d-71fdd7b6ac58' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/clusters/cf07e3ff-f8de-4d78-bc2d-71fdd7b6ac58'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/clusters/cf07e3ff-f8de-4d78-bc2d-71fdd7b6ac58 HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:09 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.8. Get Configs for Cluster

8.8.1. Description

Get the configuration file locations for a cluster.

8.8.2. Endpoint

GET /api/v3/clusters/{id}/configs

8.8.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 35. /api/v3/clusters/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of configuration file locations

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:14 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 82

[ "954866e3-3afe-4bf0-b1d9-2f8f15348e70", "d9de7470-ee9a-4d61-b03f-b0dbfc792f0a" ]

8.9. Add Configs to Cluster

8.9.1. Description

Add configuration file locations to an existing cluster.

Configurations are stored as a set so any duplicates will be ignored.

8.9.2. Endpoint

POST /api/v3/clusters/{id}/configs

8.9.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 36. /api/v3/clusters/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of configuration file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "954866e3-3afe-4bf0-b1d9-2f8f15348e70", "d9de7470-ee9a-4d61-b03f-b0dbfc792f0a" ]'
HTTPie
$ echo '[ "954866e3-3afe-4bf0-b1d9-2f8f15348e70", "d9de7470-ee9a-4d61-b03f-b0dbfc792f0a" ]' | http POST 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "954866e3-3afe-4bf0-b1d9-2f8f15348e70", "d9de7470-ee9a-4d61-b03f-b0dbfc792f0a" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:14 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.10. Update Configs for a Cluster

8.10.1. Description

Update the configuration file locations for an existing cluster. Stored as a set so duplicates are ignored.

8.10.2. Endpoint

PUT /api/v3/clusters/{id}/configs

8.10.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 37. /api/v3/clusters/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of configuration file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "47cfef7e-9ac8-44e1-aee0-39ca2dd447ff" ]'
HTTPie
$ echo '[ "47cfef7e-9ac8-44e1-aee0-39ca2dd447ff" ]' | http PUT 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 42

[ "47cfef7e-9ac8-44e1-aee0-39ca2dd447ff" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:21 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.11. Remove All Configs From a Cluster

8.11.1. Description

Remove all the configuration file locations for an existing cluster.

8.11.2. Endpoint

DELETE /api/v3/clusters/{id}/configs

8.11.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 38. /api/v3/clusters/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:12 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.12. Get Dependencies For an Cluster

8.12.1. Description

Get the dependency file locations for a cluster.

8.12.2. Endpoint

GET /api/v3/clusters/{id}/dependencies

8.12.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 39. /api/v3/clusters/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/dependencies' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/dependencies'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of dependency file locations

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/dependencies HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:14 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 82

[ "75a5b861-675d-4b53-af41-2c8598ab71f3", "0dd5b130-8d16-4032-bfef-54d38ea4b3e1" ]

8.13. Add Dependencies to Cluster

8.13.1. Description

Add dependency file locations to an existing cluster. Stored as a set so all duplicates are ignored.

8.13.2. Endpoint

POST /api/v3/clusters/{id}/dependencies

8.13.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 40. /api/v3/clusters/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of dependency file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/dependencies' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "75a5b861-675d-4b53-af41-2c8598ab71f3", "0dd5b130-8d16-4032-bfef-54d38ea4b3e1" ]'
HTTPie
$ echo '[ "75a5b861-675d-4b53-af41-2c8598ab71f3", "0dd5b130-8d16-4032-bfef-54d38ea4b3e1" ]' | http POST 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/dependencies' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/dependencies HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "75a5b861-675d-4b53-af41-2c8598ab71f3", "0dd5b130-8d16-4032-bfef-54d38ea4b3e1" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:14 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.14. Update Dependencies for an Cluster

8.14.1. Description

Update the dependency file locations for an existing cluster

8.14.2. Endpoint

PUT /api/v3/clusters/{id}/dependencies

8.14.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 41. /api/v3/clusters/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of dependency file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "5bd2682f-537b-45b0-8631-44c23931601c" ]'
HTTPie
$ echo '[ "5bd2682f-537b-45b0-8631-44c23931601c" ]' | http PUT 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/configs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 42

[ "5bd2682f-537b-45b0-8631-44c23931601c" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:21 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.15. Remove All Dependencies From an Cluster

8.15.1. Description

Remove all the dependency file locations for an existing cluster.

8.15.2. Endpoint

DELETE /api/v3/clusters/{id}/dependencies

8.15.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 42. /api/v3/clusters/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/dependencies' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/dependencies'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/dependencies HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:14 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.16. Get Tags For a Cluster

8.16.1. Description

Get the tags for a cluster.

8.16.2. Endpoint

GET /api/v3/clusters/{id}/tags

8.16.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 43. /api/v3/clusters/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of tags

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:22 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 152

[ "30682d8d-859d-4ad8-bcb9-8a63c57c520b", "b8dcc9ce-3bbe-48e1-a31b-830030277f04", "genie.name:h2prod", "genie.id:4e822800-a4b3-4cc9-bd15-eecb449707c4" ]

8.17. Add Tags to Cluster

8.17.1. Description

Add tags to an existing cluster. Stored as a set so all duplicates are ignored.

genie.id:{id} and genie.name:{name} tags are automatically added by the service.

8.17.2. Endpoint

POST /api/v3/clusters/{id}/tags

8.17.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 44. /api/v3/clusters/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of tags

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "30682d8d-859d-4ad8-bcb9-8a63c57c520b", "b8dcc9ce-3bbe-48e1-a31b-830030277f04" ]'
HTTPie
$ echo '[ "30682d8d-859d-4ad8-bcb9-8a63c57c520b", "b8dcc9ce-3bbe-48e1-a31b-830030277f04" ]' | http POST 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "30682d8d-859d-4ad8-bcb9-8a63c57c520b", "b8dcc9ce-3bbe-48e1-a31b-830030277f04" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:22 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.18. Update Tags for a Cluster

8.18.1. Description

Update the tags for an existing cluster.

The genie.id:{id} and genie.name:{name} tags can’t be removed. They will automatically be added back by the system.

8.18.2. Endpoint

PUT /api/v3/clusters/{id}/tags

8.18.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 45. /api/v3/clusters/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of tags

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "262e6a80-b59c-49e8-a3fd-3c57f77837a3" ]'
HTTPie
$ echo '[ "262e6a80-b59c-49e8-a3fd-3c57f77837a3" ]' | http PUT 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 42

[ "262e6a80-b59c-49e8-a3fd-3c57f77837a3" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:21 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.19. Remove All Tags From Cluster

8.19.1. Description

Remove all the tags for an existing cluster

The genie.id:{id} and genie.name:{name} tags will NOT be removed by this operation

8.19.2. Endpoint

DELETE /api/v3/clusters/{id}/tags

8.19.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 46. /api/v3/clusters/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:12 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.20. Remove Tag From Cluster

8.20.1. Description

Remove a tag from an existing cluster.

You can’t remove the genie.id:{id} and genie.name:{name} tags. They will just be added back by the system

8.20.2. Endpoint

DELETE /api/v3/clusters/{id}/tags/{tag}

8.20.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 47. /api/v3/clusters/{id}/tags/{tag}
Parameter Description

id

The resource id

tag

The tag to remove
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags/a0a91eb9-12b8-4d9b-8951-592b83c911d0' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags/a0a91eb9-12b8-4d9b-8951-592b83c911d0'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/tags/a0a91eb9-12b8-4d9b-8951-592b83c911d0 HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:21 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.21. Add Commands to a Cluster

Deprecated
As of Genie 4.0.0 commands are no longer hard linked to clusters, instead they are dynamically linked by resolving a command’s cluster criteria against the current set of UP clusters. This API is now a no-op.

8.21.1. Endpoint

POST /api/v3/clusters/{id}/commands

8.21.2. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 48. /api/v3/clusters/{id}/commands
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of command ids (in preferred order) to append to the existing list of commands

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "87681e0e-1e72-4499-b421-e0730bf9292b", "3750b9f0-4e86-4a95-9a0c-fe3af3da5194" ]'
HTTPie
$ echo '[ "87681e0e-1e72-4499-b421-e0730bf9292b", "3750b9f0-4e86-4a95-9a0c-fe3af3da5194" ]' | http POST 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "87681e0e-1e72-4499-b421-e0730bf9292b", "3750b9f0-4e86-4a95-9a0c-fe3af3da5194" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.22. Get the Commands for a Cluster

Deprecated
As of Genie 4.0.0 commands are no longer hard linked to clusters, instead they are dynamically linked by resolving a command’s cluster criteria against the current set of UP clusters. This API is now a no-op.

8.22.1. Endpoint

GET /api/v3/clusters/{id}/commands

8.22.2. API Docs

Request Documentation
Headers

None

Path Parameters
Table 49. /api/v3/clusters/{id}/commands
Parameter Description

id

The resource id
Query Parameters
Parameter Description

status

The status of commands to search for
Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands?status=ACTIVE' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands?status=ACTIVE'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands?status=ACTIVE HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:05:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 3

[ ]

8.23. Set Commands for a Cluster

Deprecated
As of Genie 4.0.0 commands are no longer hard linked to clusters, instead they are dynamically linked by resolving a command’s cluster criteria against the current set of UP clusters. This API is now a no-op.

8.23.1. Endpoint

PUT /api/v3/clusters/{id}/commands

8.23.2. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 50. /api/v3/clusters/{id}/commands
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of command ids (in preferred order) to replace the existing list of commands

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "a101e97e-883a-4b80-8c0d-9d31f19a3623", "bfa11584-912a-4f12-b6b6-58f8b0ade66e" ]'
HTTPie
$ echo '[ "a101e97e-883a-4b80-8c0d-9d31f19a3623", "bfa11584-912a-4f12-b6b6-58f8b0ade66e" ]' | http PUT 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "a101e97e-883a-4b80-8c0d-9d31f19a3623", "bfa11584-912a-4f12-b6b6-58f8b0ade66e" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.24. Remove All Commands From a Cluster

Deprecated
As of Genie 4.0.0 commands are no longer hard linked to clusters, instead they are dynamically linked by resolving a command’s cluster criteria against the current set of UP clusters. This API is now a no-op.

8.24.1. Endpoint

DELETE /api/v3/clusters/{id}/commands

8.24.2. API Docs

Request Documentation
Headers

None

Path Parameters
Table 51. /api/v3/clusters/{id}/commands
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive

8.25. Remove A Single Command From a Cluster

Deprecated
As of Genie 4.0.0 commands are no longer hard linked to clusters, instead they are dynamically linked by resolving a command’s cluster criteria against the current set of UP clusters. This API is now a no-op.

8.25.1. Endpoint

DELETE /api/v3/clusters/{id}/commands/{commandId}

8.25.2. API Docs

Request Documentation
Headers

None

Path Parameters
Table 52. /api/v3/clusters/{id}/commands/{commandId}
Parameter Description

id

The resource id

commandId

The id of the command to remove
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands/12632f2a-5cdc-4d53-859a-cb6fca4c22af' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands/12632f2a-5cdc-4d53-859a-cb6fca4c22af'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/clusters/4e822800-a4b3-4cc9-bd15-eecb449707c4/commands/12632f2a-5cdc-4d53-859a-cb6fca4c22af HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:05:13 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9. Commands API

9.1. Create a Command

9.1.1. Description

Create a new command in the system.

9.1.2. Endpoint

POST /api/v3/commands

The id in this example is optional. If you include one Genie will use it. If not it will provide one. If you provide one it must be unique.

9.1.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters

None

Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

status

String

The status of the command. Options: [ACTIVE, DEPRECATED, INACTIVE]

Must not be null

false

executable

String

The executable to run on the Genie node when this command is used. e.g. /usr/bin/hadoop

Must not be empty. Size must be between 0 and 1024 inclusive

false

executableAndArguments

Array

The executable and arguments to run on the Genie node when this command is used. e.g. /usr/bin/hadoop

Must not be empty

false

checkDelay

Number

The amount of time (in milliseconds) to delay between checks of the jobs using this command

Must be at least 1

false

memory

Number

The default amount of memory (in MB) that should be allocated for instances of this command client

Must be at least 1

true

dependencies

Array

The dependencies for the command

true

clusterCriteria

Array

The priority ordered list of criteria to resolve clusters that this command can run jobs on

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "1.0.0",
  "user" : "genie",
  "name" : "hive",
  "description" : "Hive command v1.0.0",
  "metadata" : null,
  "tags" : [ "tag:bar", "tag:foo" ],
  "configs" : [ "s3:///path/to/config-foo", "s3:///path/to/config-bar" ],
  "dependencies" : [ "/path/to/file/foo", "/path/to/file/bar" ],
  "setupFile" : null,
  "status" : "ACTIVE",
  "executable" : "/apps/hive/bin/hive",
  "executableAndArguments" : [ "/apps/hive/bin/hive" ],
  "checkDelay" : 10000,
  "memory" : 1024,
  "clusterCriteria" : [ {
    "id" : "3774a01f-2a15-4440-a521-4b2db8820b63",
    "name" : null,
    "version" : null,
    "status" : null,
    "tags" : [ "44f15b6b-9718-4d9b-81e8-3d5bbd38a61b", "34dfb8a7-d2dc-45dc-8f90-c4bf28747d8d" ]
  }, {
    "id" : "a606528f-468f-41b5-8b4a-33895b8c7a02",
    "name" : "prod",
    "version" : "1.0.0",
    "status" : "UP",
    "tags" : [ "05ff443e-9ee3-4c21-81c4-b91bbd8a166c", "6b33cad6-2ab4-465c-a0ee-2c9aa516dd42", "e5738809-2c51-4190-b4b5-4a3d059ba591" ]
  } ]
}'
HTTPie
$ echo '{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "1.0.0",
  "user" : "genie",
  "name" : "hive",
  "description" : "Hive command v1.0.0",
  "metadata" : null,
  "tags" : [ "tag:bar", "tag:foo" ],
  "configs" : [ "s3:///path/to/config-foo", "s3:///path/to/config-bar" ],
  "dependencies" : [ "/path/to/file/foo", "/path/to/file/bar" ],
  "setupFile" : null,
  "status" : "ACTIVE",
  "executable" : "/apps/hive/bin/hive",
  "executableAndArguments" : [ "/apps/hive/bin/hive" ],
  "checkDelay" : 10000,
  "memory" : 1024,
  "clusterCriteria" : [ {
    "id" : "3774a01f-2a15-4440-a521-4b2db8820b63",
    "name" : null,
    "version" : null,
    "status" : null,
    "tags" : [ "44f15b6b-9718-4d9b-81e8-3d5bbd38a61b", "34dfb8a7-d2dc-45dc-8f90-c4bf28747d8d" ]
  }, {
    "id" : "a606528f-468f-41b5-8b4a-33895b8c7a02",
    "name" : "prod",
    "version" : "1.0.0",
    "status" : "UP",
    "tags" : [ "05ff443e-9ee3-4c21-81c4-b91bbd8a166c", "6b33cad6-2ab4-465c-a0ee-2c9aa516dd42", "e5738809-2c51-4190-b4b5-4a3d059ba591" ]
  } ]
}' | http POST 'https://genie.example.com/api/v3/commands' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers
Name Description

Location

The URI
Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/commands HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 1044

{
  "id" : null,
  "created" : null,
  "updated" : null,
  "version" : "1.0.0",
  "user" : "genie",
  "name" : "hive",
  "description" : "Hive command v1.0.0",
  "metadata" : null,
  "tags" : [ "tag:bar", "tag:foo" ],
  "configs" : [ "s3:///path/to/config-foo", "s3:///path/to/config-bar" ],
  "dependencies" : [ "/path/to/file/foo", "/path/to/file/bar" ],
  "setupFile" : null,
  "status" : "ACTIVE",
  "executable" : "/apps/hive/bin/hive",
  "executableAndArguments" : [ "/apps/hive/bin/hive" ],
  "checkDelay" : 10000,
  "memory" : 1024,
  "clusterCriteria" : [ {
    "id" : "3774a01f-2a15-4440-a521-4b2db8820b63",
    "name" : null,
    "version" : null,
    "status" : null,
    "tags" : [ "44f15b6b-9718-4d9b-81e8-3d5bbd38a61b", "34dfb8a7-d2dc-45dc-8f90-c4bf28747d8d" ]
  }, {
    "id" : "a606528f-468f-41b5-8b4a-33895b8c7a02",
    "name" : "prod",
    "version" : "1.0.0",
    "status" : "UP",
    "tags" : [ "05ff443e-9ee3-4c21-81c4-b91bbd8a166c", "6b33cad6-2ab4-465c-a0ee-2c9aa516dd42", "e5738809-2c51-4190-b4b5-4a3d059ba591" ]
  } ]
}
Response
HTTP/1.1 201 Created
Location: https://genie.example.com/api/v3/commands/d5d6899a-f20b-4492-8526-b89f9a3e4dbd
Date: Tue, 18 Jan 2022 23:07:29 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.2. Get a Command

9.2.1. Description

Get the metadata about a command in the system.

9.2.2. Endpoint

GET /api/v3/commands/{id}

9.2.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 53. /api/v3/commands/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/d5d6899a-f20b-4492-8526-b89f9a3e4dbd' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/commands/d5d6899a-f20b-4492-8526-b89f9a3e4dbd'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

status

String

The status of the command. Options: [ACTIVE, DEPRECATED, INACTIVE]

Must not be null

false

executable

String

The executable to run on the Genie node when this command is used. e.g. /usr/bin/hadoop

Must not be empty. Size must be between 0 and 1024 inclusive

false

executableAndArguments

Array

The executable and arguments to run on the Genie node when this command is used. e.g. /usr/bin/hadoop

Must not be empty

false

checkDelay

Number

The amount of time (in milliseconds) to delay between checks of the jobs using this command

Must be at least 1

false

memory

Number

The default amount of memory (in MB) that should be allocated for instances of this command client

Must be at least 1

true

dependencies

Array

The dependencies for the command

true

clusterCriteria

Array

The priority ordered list of criteria to resolve clusters that this command can run jobs on

true
HATEOAS Links
Relation Description

self

URI for this command

applications

Get all the applications this command depends on

clusters

Get all clusters this command is available on
HTTP Messages
Request
GET /api/v3/commands/d5d6899a-f20b-4492-8526-b89f9a3e4dbd HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:07:29 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 1632

{
  "id" : "d5d6899a-f20b-4492-8526-b89f9a3e4dbd",
  "created" : "2022-01-18T23:07:29.465Z",
  "updated" : "2022-01-18T23:07:29.465Z",
  "version" : "1.0.0",
  "user" : "genie",
  "name" : "hive",
  "description" : "Hive command v1.0.0",
  "metadata" : null,
  "tags" : [ "tag:bar", "genie.id:d5d6899a-f20b-4492-8526-b89f9a3e4dbd", "tag:foo", "genie.name:hive" ],
  "configs" : [ "s3:///path/to/config-foo", "s3:///path/to/config-bar" ],
  "dependencies" : [ "/path/to/file/foo", "/path/to/file/bar" ],
  "setupFile" : null,
  "status" : "ACTIVE",
  "executable" : "/apps/hive/bin/hive",
  "executableAndArguments" : [ "/apps/hive/bin/hive" ],
  "checkDelay" : 10000,
  "memory" : 1024,
  "clusterCriteria" : [ {
    "id" : "3774a01f-2a15-4440-a521-4b2db8820b63",
    "name" : null,
    "version" : null,
    "status" : null,
    "tags" : [ "44f15b6b-9718-4d9b-81e8-3d5bbd38a61b", "34dfb8a7-d2dc-45dc-8f90-c4bf28747d8d" ]
  }, {
    "id" : "a606528f-468f-41b5-8b4a-33895b8c7a02",
    "name" : "prod",
    "version" : "1.0.0",
    "status" : "UP",
    "tags" : [ "05ff443e-9ee3-4c21-81c4-b91bbd8a166c", "6b33cad6-2ab4-465c-a0ee-2c9aa516dd42", "e5738809-2c51-4190-b4b5-4a3d059ba591" ]
  } ],
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/commands/d5d6899a-f20b-4492-8526-b89f9a3e4dbd"
    },
    "applications" : {
      "href" : "https://genie.example.com/api/v3/commands/d5d6899a-f20b-4492-8526-b89f9a3e4dbd/applications"
    },
    "clusters" : {
      "href" : "https://genie.example.com/api/v3/commands/d5d6899a-f20b-4492-8526-b89f9a3e4dbd/clusters{?status}",
      "templated" : true
    }
  }
}

9.3. Find Commands

9.3.1. Description

Find commands using various query parameters.

9.3.2. Endpoint

GET /api/v3/commands

9.3.3. API Docs

Request Documentation
Headers

None

Path Parameters

None

Query Parameters
Parameter Description

page

The page number to get. Default to 0.

size

The size of the page to get. Default to 64.

sort

The fields to sort the results by. Defaults to 'updated,desc'.

name

The name of the commands to find. Use % to perform a regex like query

user

The user of the commands to find. Use % to perform a regex like query

status

The status(es) of the commands to find. Can have multiple. Options: [ACTIVE, DEPRECATED, INACTIVE]

tag

The tag(s) of the commands to find. Can have multiple.
Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands?status=ACTIVE&status=INACTIVE&status=%5BACTIVE%2C+INACTIVE%5D' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/commands?status=ACTIVE&status=INACTIVE&status=%5BACTIVE%2C+INACTIVE%5D'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

_links

Object

Links to other resources.

false

page

Object

The result page information.

false

page.size

Number

The number of elements in this page result.

false

page.totalElements

Number

The total number of elements this search result could return.

false

page.totalPages

Number

The total number of pages there could be at the current page size.

false

page.number

Number

The current page number.

false

_embedded.commandList

Array

The found commands.

false
HATEOAS Links
Relation Description

self

The current search

first

The first page for this search

prev

The previous page for this search

next

The next page for this search

last

The last page for this search
HTTP Messages
Request
GET /api/v3/commands?status=ACTIVE&status=INACTIVE&status=%5BACTIVE%2C+INACTIVE%5D HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:07:26 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 2867

{
  "_embedded" : {
    "commandList" : [ {
      "id" : "d3e52dc0-52d6-4d95-8a71-37714d3c99be",
      "created" : "2022-01-18T23:07:26.820Z",
      "updated" : "2022-01-18T23:07:26.820Z",
      "version" : "efee5ab3-60ea-4391-8bb3-1ca76f91a928",
      "user" : "ade8055b-ea0e-4571-b951-a5b3698c5cd5",
      "name" : "a96077c6-ec28-46b0-b25a-ffc5a3fac21a",
      "description" : null,
      "metadata" : null,
      "tags" : [ "genie.name:a96077c6-ec28-46b0-b25a-ffc5a3fac21a", "genie.id:d3e52dc0-52d6-4d95-8a71-37714d3c99be" ],
      "configs" : [ ],
      "dependencies" : [ ],
      "setupFile" : null,
      "status" : "INACTIVE",
      "executable" : "/apps/hive/bin/hive",
      "executableAndArguments" : [ "/apps/hive/bin/hive" ],
      "checkDelay" : 10000,
      "memory" : null,
      "clusterCriteria" : [ ],
      "_links" : {
        "self" : {
          "href" : "https://genie.example.com/api/v3/commands/d3e52dc0-52d6-4d95-8a71-37714d3c99be"
        },
        "applications" : {
          "href" : "https://genie.example.com/api/v3/commands/d3e52dc0-52d6-4d95-8a71-37714d3c99be/applications"
        },
        "clusters" : {
          "href" : "https://genie.example.com/api/v3/commands/d3e52dc0-52d6-4d95-8a71-37714d3c99be/clusters{?status}",
          "templated" : true
        }
      }
    }, {
      "id" : "95a0f09b-6a9c-44be-b4d4-dc45fb0c79b4",
      "created" : "2022-01-18T23:07:24.793Z",
      "updated" : "2022-01-18T23:07:24.793Z",
      "version" : "f3cfa892-9149-4e78-b48e-9f5fa95f98dc",
      "user" : "803ce791-723c-4640-8a35-0d44b738a17f",
      "name" : "76a4da9d-ead3-4839-b360-4c36430b4bc3",
      "description" : null,
      "metadata" : null,
      "tags" : [ "genie.name:76a4da9d-ead3-4839-b360-4c36430b4bc3", "genie.id:95a0f09b-6a9c-44be-b4d4-dc45fb0c79b4" ],
      "configs" : [ ],
      "dependencies" : [ ],
      "setupFile" : null,
      "status" : "ACTIVE",
      "executable" : "/apps/hive/bin/hive",
      "executableAndArguments" : [ "/apps/hive/bin/hive" ],
      "checkDelay" : 10000,
      "memory" : null,
      "clusterCriteria" : [ ],
      "_links" : {
        "self" : {
          "href" : "https://genie.example.com/api/v3/commands/95a0f09b-6a9c-44be-b4d4-dc45fb0c79b4"
        },
        "applications" : {
          "href" : "https://genie.example.com/api/v3/commands/95a0f09b-6a9c-44be-b4d4-dc45fb0c79b4/applications"
        },
        "clusters" : {
          "href" : "https://genie.example.com/api/v3/commands/95a0f09b-6a9c-44be-b4d4-dc45fb0c79b4/clusters{?status}",
          "templated" : true
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://genie.example.com/api/v3/commands?status=ACTIVE&status=INACTIVE{&name,user,tag}",
      "templated" : true
    }
  },
  "page" : {
    "size" : 64,
    "totalElements" : 2,
    "totalPages" : 1,
    "number" : 0
  }
}

9.4. Update an Entire Command

9.4.1. Description

Update the metadata about a command. This method does a complete replace of the resource. Usual flow is to call to get the most recent state then update what you want and call this API with the result.

For more fine grained control call the PATCH API.

9.4.2. Endpoint

PUT /api/v3/commands/{id}

9.4.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 54. /api/v3/commands/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

description

String

Any description

Size must be between 0 and 1000 inclusive

true

metadata

Object

Any semi-structured metadata. Must be valid JSON

true

tags

Array

The tags

true

setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

configs

Array

Any configuration files needed for the resource

true

status

String

The status of the command. Options: [ACTIVE, DEPRECATED, INACTIVE]

Must not be null

false

executable

String

The executable to run on the Genie node when this command is used. e.g. /usr/bin/hadoop

Must not be empty. Size must be between 0 and 1024 inclusive

false

executableAndArguments

Array

The executable and arguments to run on the Genie node when this command is used. e.g. /usr/bin/hadoop

Must not be empty

false

checkDelay

Number

The amount of time (in milliseconds) to delay between checks of the jobs using this command

Must be at least 1

false

memory

Number

The default amount of memory (in MB) that should be allocated for instances of this command client

Must be at least 1

true

dependencies

Array

The dependencies for the command

true

clusterCriteria

Array

The priority ordered list of criteria to resolve clusters that this command can run jobs on

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "id" : "0e511439-ddc5-4a43-865a-30b8c617c9c0",
  "created" : "2022-01-18T23:07:30.636Z",
  "updated" : "2022-01-18T23:07:30.636Z",
  "version" : "1.0.0",
  "user" : "genie",
  "name" : "hive",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:hive", "genie.id:0e511439-ddc5-4a43-865a-30b8c617c9c0" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "INACTIVE",
  "executable" : "/apps/hive/bin/hive",
  "executableAndArguments" : [ "/apps/hive/bin/hive" ],
  "checkDelay" : 10000,
  "memory" : null,
  "clusterCriteria" : [ ]
}'
HTTPie
$ echo '{
  "id" : "0e511439-ddc5-4a43-865a-30b8c617c9c0",
  "created" : "2022-01-18T23:07:30.636Z",
  "updated" : "2022-01-18T23:07:30.636Z",
  "version" : "1.0.0",
  "user" : "genie",
  "name" : "hive",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:hive", "genie.id:0e511439-ddc5-4a43-865a-30b8c617c9c0" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "INACTIVE",
  "executable" : "/apps/hive/bin/hive",
  "executableAndArguments" : [ "/apps/hive/bin/hive" ],
  "checkDelay" : 10000,
  "memory" : null,
  "clusterCriteria" : [ ]
}' | http PUT 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0 HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 581

{
  "id" : "0e511439-ddc5-4a43-865a-30b8c617c9c0",
  "created" : "2022-01-18T23:07:30.636Z",
  "updated" : "2022-01-18T23:07:30.636Z",
  "version" : "1.0.0",
  "user" : "genie",
  "name" : "hive",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:hive", "genie.id:0e511439-ddc5-4a43-865a-30b8c617c9c0" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "INACTIVE",
  "executable" : "/apps/hive/bin/hive",
  "executableAndArguments" : [ "/apps/hive/bin/hive" ],
  "checkDelay" : 10000,
  "memory" : null,
  "clusterCriteria" : [ ]
}
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:30 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.5. Update Parts of a Command

9.5.1. Description

Update the metadata about a command using JSON Patch. This will ONLY update the fields you request be changed.

For more information about JSON Patch RFC see the website.

9.5.2. Endpoint

PATCH /api/v3/commands/{id}

9.5.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 55. /api/v3/commands/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of patches to apply

false

[].op

String

Patch operation to perform.

add, remove, replace, copy, move, test

false

[].path

String

The json path to operate on. e.g. /user

false

[].from

String

The json path to move or copy from. e.g. /user

true

[].value

String

The json value to put at the path for an add, replace or test

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0' -i -X PATCH \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ {
  "op" : "replace",
  "path" : "/name",
  "value" : "4e8db1b2-e0b4-46dd-ade5-7b2923dce551"
} ]'
HTTPie
$ echo '[ {
  "op" : "replace",
  "path" : "/name",
  "value" : "4e8db1b2-e0b4-46dd-ade5-7b2923dce551"
} ]' | http PATCH 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PATCH /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0 HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 98

[ {
  "op" : "replace",
  "path" : "/name",
  "value" : "4e8db1b2-e0b4-46dd-ade5-7b2923dce551"
} ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:31 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.6. Delete All Commands

9.6.1. Description

Delete all the commands currently stored in the system.

You won’t be able to delete any command that has been used by any job that is still in the system to maintain the ability for users to look up information about their job (where it ran, what it ran, etc)

9.6.2. Endpoint

DELETE /api/v3/commands

9.6.3. API Docs

Request Documentation
Headers

None

Path Parameters

None

Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/commands'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/commands HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:26 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.7. Delete a Command

9.7.1. Description

Delete a command currently configured in the system.

You won’t be able to delete a command that has been used by any job that is still in the system to maintain the ability for users to look up information about their job (where it ran, what it ran, etc)

9.7.2. Endpoint

DELETE /api/v3/commands/{id}

9.7.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 56. /api/v3/commands/{id}
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/11b20712-800a-4384-9e92-1f98460f1245' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/commands/11b20712-800a-4384-9e92-1f98460f1245'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/commands/11b20712-800a-4384-9e92-1f98460f1245 HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:24 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.8. Get Configs for Command

9.8.1. Description

Get the configuration file locations for a command.

9.8.2. Endpoint

GET /api/v3/commands/{id}/configs

9.8.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 57. /api/v3/commands/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of configuration file locations

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:07:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 82

[ "dfb7affc-039f-40f3-86a3-bb0069f3d366", "dea93a94-fcd6-4528-8159-5e3e855298c4" ]

9.9. Add Configs to Command

9.9.1. Description

Add configuration file locations to an existing command.

Configurations are stored as a set so any duplicates will be ignored.

9.9.2. Endpoint

POST /api/v3/commands/{id}/configs

9.9.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 58. /api/v3/commands/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of configuration file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "dfb7affc-039f-40f3-86a3-bb0069f3d366", "dea93a94-fcd6-4528-8159-5e3e855298c4" ]'
HTTPie
$ echo '[ "dfb7affc-039f-40f3-86a3-bb0069f3d366", "dea93a94-fcd6-4528-8159-5e3e855298c4" ]' | http POST 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "dfb7affc-039f-40f3-86a3-bb0069f3d366", "dea93a94-fcd6-4528-8159-5e3e855298c4" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.10. Update Configs for a Command

9.10.1. Description

Update the configuration file locations for an existing command. Stored as a set so duplicates are ignored.

9.10.2. Endpoint

PUT /api/v3/commands/{id}/configs

9.10.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 59. /api/v3/commands/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of configuration file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "5e430631-58eb-46d2-89dc-c713b640fdfb" ]'
HTTPie
$ echo '[ "5e430631-58eb-46d2-89dc-c713b640fdfb" ]' | http PUT 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 42

[ "5e430631-58eb-46d2-89dc-c713b640fdfb" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:30 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.11. Remove All Configs From a Command

9.11.1. Description

Remove all the configuration file locations for an existing command.

9.11.2. Endpoint

DELETE /api/v3/commands/{id}/configs

9.11.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 60. /api/v3/commands/{id}/configs
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/configs HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:24 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.12. Get Dependencies For an Command

9.12.1. Description

Get the dependency file locations for an command.

9.12.2. Endpoint

GET /api/v3/commands/{id}/dependencies

9.12.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 61. /api/v3/commands/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of dependency file locations

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:07:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 82

[ "2e6ef6f5-1954-4a3f-9118-622049c8d5de", "3424ec25-8c43-4eea-a8c2-f5ec48044857" ]

9.13. Add Dependencies to Command

9.13.1. Description

Add dependency file locations to an existing command. Stored as a set so all duplicates are ignored.

9.13.2. Endpoint

POST /api/v3/commands/{id}/dependencies

9.13.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 62. /api/v3/commands/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of dependency file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "2e6ef6f5-1954-4a3f-9118-622049c8d5de", "3424ec25-8c43-4eea-a8c2-f5ec48044857" ]'
HTTPie
$ echo '[ "2e6ef6f5-1954-4a3f-9118-622049c8d5de", "3424ec25-8c43-4eea-a8c2-f5ec48044857" ]' | http POST 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "2e6ef6f5-1954-4a3f-9118-622049c8d5de", "3424ec25-8c43-4eea-a8c2-f5ec48044857" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.14. Update Dependencies for an Command

9.14.1. Description

Update the dependency file locations for an existing command

9.14.2. Endpoint

PUT /api/v3/commands/{id}/dependencies

9.14.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 63. /api/v3/commands/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of dependency file locations

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "dcd1dfec-03a7-473d-b474-3524e72c0756" ]'
HTTPie
$ echo '[ "dcd1dfec-03a7-473d-b474-3524e72c0756" ]' | http PUT 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 42

[ "dcd1dfec-03a7-473d-b474-3524e72c0756" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:29 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.15. Remove All Dependencies From an Command

9.15.1. Description

Remove all the dependency file locations for an existing command.

9.15.2. Endpoint

DELETE /api/v3/commands/{id}/dependencies

9.15.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 64. /api/v3/commands/{id}/dependencies
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/dependencies HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.16. Get Tags For a Command

9.16.1. Description

Get the tags for a command.

9.16.2. Endpoint

GET /api/v3/commands/{id}/tags

9.16.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 65. /api/v3/commands/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of tags

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:07:30 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 150

[ "genie.name:hive", "genie.id:0e511439-ddc5-4a43-865a-30b8c617c9c0", "ec7d86d1-166e-4a43-9d22-6700b3b971c6", "ac5b3edb-5835-4f5c-bc59-111b670ff2d4" ]

9.17. Add Tags to Command

9.17.1. Description

Add tags to an existing command. Stored as a set so all duplicates are ignored.

genie.id:{id} and genie.name:{name} tags are automatically added by the service.

9.17.2. Endpoint

POST /api/v3/commands/{id}/tags

9.17.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 66. /api/v3/commands/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of tags

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "ec7d86d1-166e-4a43-9d22-6700b3b971c6", "ac5b3edb-5835-4f5c-bc59-111b670ff2d4" ]'
HTTPie
$ echo '[ "ec7d86d1-166e-4a43-9d22-6700b3b971c6", "ac5b3edb-5835-4f5c-bc59-111b670ff2d4" ]' | http POST 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "ec7d86d1-166e-4a43-9d22-6700b3b971c6", "ac5b3edb-5835-4f5c-bc59-111b670ff2d4" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:30 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.18. Update Tags for a Command

9.18.1. Description

Update the tags for an existing command.

The genie.id:{id} and genie.name:{name} tags can’t be removed. They will automatically be added back by the system.

9.18.2. Endpoint

PUT /api/v3/commands/{id}/tags

9.18.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 67. /api/v3/commands/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of tags

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "5b771a39-b187-4901-a8d8-7637c013b337" ]'
HTTPie
$ echo '[ "5b771a39-b187-4901-a8d8-7637c013b337" ]' | http PUT 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 42

[ "5b771a39-b187-4901-a8d8-7637c013b337" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:30 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.19. Remove All Tags From Command

9.19.1. Description

Remove all the tags for an existing command

The genie.id:{id} and genie.name:{name} tags will NOT be removed by this operation

9.19.2. Endpoint

DELETE /api/v3/commands/{id}/tags

9.19.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 68. /api/v3/commands/{id}/tags
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:24 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.20. Remove Tag From Command

9.20.1. Description

Remove a tag from an existing command.

You can’t remove the genie.id:{id} and genie.name:{name} tags. They will just be added back by the system

9.20.2. Endpoint

DELETE /api/v3/commands/{id}/tags/{tag}

9.20.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 69. /api/v3/commands/{id}/tags/{tag}
Parameter Description

id

The resource id

tag

The tag to remove
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags/1361a896-ce96-4539-9365-534b282c6586' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags/1361a896-ce96-4539-9365-534b282c6586'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/tags/1361a896-ce96-4539-9365-534b282c6586 HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:30 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.21. Add Applications to a Command

9.21.1. Description

Add new applications (as array of their ID’s) to the existing set of applications the command depends on

The applications for the ID’s must already exist in the system

9.21.2. Endpoint

POST /api/v3/commands/{id}/applications

9.21.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 70. /api/v3/commands/{id}/applications
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of application ids to add to existing set of applications

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "50c7fff5-220f-4b50-87f2-29bf03d974f8", "b2f03331-13fa-4b2b-a3ad-688290f446a1" ]'
HTTPie
$ echo '[ "50c7fff5-220f-4b50-87f2-29bf03d974f8", "b2f03331-13fa-4b2b-a3ad-688290f446a1" ]' | http POST 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "50c7fff5-220f-4b50-87f2-29bf03d974f8", "b2f03331-13fa-4b2b-a3ad-688290f446a1" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:26 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.22. Get the Applications for a Command

9.22.1. Description

Get the applications the command currently depends on. These are the applications that will be installed at runtime when a job is run with the given command

9.22.2. Endpoint

GET /api/v3/commands/{id}/applications

9.22.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 71. /api/v3/commands/{id}/applications
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

[]

Array

The set of applications this command depends on

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:07:26 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 2540

[ {
  "id" : "50c7fff5-220f-4b50-87f2-29bf03d974f8",
  "created" : "2022-01-18T23:07:27.558Z",
  "updated" : "2022-01-18T23:07:27.558Z",
  "version" : "c0eec480-2490-40c0-a2d4-2fa5789de772",
  "user" : "c0eec480-2490-40c0-a2d4-2fa5789de772",
  "name" : "c0eec480-2490-40c0-a2d4-2fa5789de772",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:c0eec480-2490-40c0-a2d4-2fa5789de772", "genie.id:50c7fff5-220f-4b50-87f2-29bf03d974f8" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "ACTIVE",
  "type" : null,
  "links" : [ {
    "rel" : "self",
    "href" : "https://genie.example.com/api/v3/applications/50c7fff5-220f-4b50-87f2-29bf03d974f8"
  }, {
    "rel" : "commands",
    "href" : "https://genie.example.com/api/v3/applications/50c7fff5-220f-4b50-87f2-29bf03d974f8/commands{?status}"
  } ]
}, {
  "id" : "b2f03331-13fa-4b2b-a3ad-688290f446a1",
  "created" : "2022-01-18T23:07:27.566Z",
  "updated" : "2022-01-18T23:07:27.566Z",
  "version" : "c0eec480-2490-40c0-a2d4-2fa5789de772",
  "user" : "c0eec480-2490-40c0-a2d4-2fa5789de772",
  "name" : "c0eec480-2490-40c0-a2d4-2fa5789de772",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:c0eec480-2490-40c0-a2d4-2fa5789de772", "genie.id:b2f03331-13fa-4b2b-a3ad-688290f446a1" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "ACTIVE",
  "type" : null,
  "links" : [ {
    "rel" : "self",
    "href" : "https://genie.example.com/api/v3/applications/b2f03331-13fa-4b2b-a3ad-688290f446a1"
  }, {
    "rel" : "commands",
    "href" : "https://genie.example.com/api/v3/applications/b2f03331-13fa-4b2b-a3ad-688290f446a1/commands{?status}"
  } ]
}, {
  "id" : "a59f814f-e4b5-444d-8b96-aa21aa98bc59",
  "created" : "2022-01-18T23:07:27.774Z",
  "updated" : "2022-01-18T23:07:27.774Z",
  "version" : "c0eec480-2490-40c0-a2d4-2fa5789de772",
  "user" : "c0eec480-2490-40c0-a2d4-2fa5789de772",
  "name" : "c0eec480-2490-40c0-a2d4-2fa5789de772",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:c0eec480-2490-40c0-a2d4-2fa5789de772", "genie.id:a59f814f-e4b5-444d-8b96-aa21aa98bc59" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "ACTIVE",
  "type" : null,
  "links" : [ {
    "rel" : "self",
    "href" : "https://genie.example.com/api/v3/applications/a59f814f-e4b5-444d-8b96-aa21aa98bc59"
  }, {
    "rel" : "commands",
    "href" : "https://genie.example.com/api/v3/applications/a59f814f-e4b5-444d-8b96-aa21aa98bc59/commands{?status}"
  } ]
} ]

9.23. Set Applications for a Command

9.23.1. Description

Set the applications (as array of their ID’s) that are dependencies of the command.

The applications with the ID’s must already exist in the system

9.23.2. Endpoint

PUT /api/v3/commands/{id}/applications

9.23.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 72. /api/v3/commands/{id}/applications
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

Array of application ids to replace the existing set of applications with

false
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ "1441460e-2ceb-41fa-94c1-925af4b1dc47", "e5b65026-123b-4b72-a9a3-a1c1218715bb" ]'
HTTPie
$ echo '[ "1441460e-2ceb-41fa-94c1-925af4b1dc47", "e5b65026-123b-4b72-a9a3-a1c1218715bb" ]' | http PUT 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 82

[ "1441460e-2ceb-41fa-94c1-925af4b1dc47", "e5b65026-123b-4b72-a9a3-a1c1218715bb" ]
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:30 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.24. Remove All Applications From a Command

9.24.1. Description

Remove all the applications currently set as dependencies of the command

This does NOT delete the application(s) from the system just unlinks them

9.24.2. Endpoint

DELETE /api/v3/commands/{id}/applications

9.24.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 73. /api/v3/commands/{id}/applications
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:31 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.25. Remove A Single Application From a Command

9.25.1. Description

Remove the identified application as a dependency of the command.

This does NOT delete the application from the system just un-links it

9.25.2. Endpoint

DELETE /api/v3/commands/{id}/applications/{applicationId}

9.25.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 74. /api/v3/commands/{id}/applications/{applicationId}
Parameter Description

id

The resource id

applicationId

The id of the application to remove
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications/44fe3677-67f7-4b99-a9d8-614dbbecb982' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications/44fe3677-67f7-4b99-a9d8-614dbbecb982'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/commands/0e511439-ddc5-4a43-865a-30b8c617c9c0/applications/44fe3677-67f7-4b99-a9d8-614dbbecb982 HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 204 No Content
Date: Tue, 18 Jan 2022 23:07:31 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.26. Get the Clusters that Have Command Available

9.26.1. Description

Search the clusters that the given command is linked to.

9.26.2. Endpoint

GET /api/v3/commands/{id}/clusters

9.26.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 75. /api/v3/commands/{id}/clusters
Parameter Description

id

The resource id
Query Parameters
Parameter Description

status

The status of clusters to search for
Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/0b7625a7-1f8c-4e83-bf37-2df14ce48734/clusters?status=UP' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/commands/0b7625a7-1f8c-4e83-bf37-2df14ce48734/clusters?status=UP'
Response Documentation
Headers
Name Description

Content-Type

application/hal+json
Payload Fields
Path Type Description Constraints Optional

[]

Array

The list of clusters found

false
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/commands/0b7625a7-1f8c-4e83-bf37-2df14ce48734/clusters?status=UP HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:07:29 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 819

[ {
  "id" : "d4065dc5-74db-4d5a-8111-2b8241d0d2e8",
  "created" : "2022-01-18T23:07:29.058Z",
  "updated" : "2022-01-18T23:07:29.058Z",
  "version" : "5a9c08a5-6aed-4f9c-9b01-47c6f427718b",
  "user" : "5a9c08a5-6aed-4f9c-9b01-47c6f427718b",
  "name" : "5a9c08a5-6aed-4f9c-9b01-47c6f427718b",
  "description" : null,
  "metadata" : null,
  "tags" : [ "genie.name:5a9c08a5-6aed-4f9c-9b01-47c6f427718b", "genie.id:d4065dc5-74db-4d5a-8111-2b8241d0d2e8" ],
  "configs" : [ ],
  "dependencies" : [ ],
  "setupFile" : null,
  "status" : "UP",
  "links" : [ {
    "rel" : "self",
    "href" : "https://genie.example.com/api/v3/clusters/d4065dc5-74db-4d5a-8111-2b8241d0d2e8"
  }, {
    "rel" : "commands",
    "href" : "https://genie.example.com/api/v3/clusters/d4065dc5-74db-4d5a-8111-2b8241d0d2e8/commands{?status}"
  } ]
} ]

9.27. Get the Cluster Criteria for a Command

9.27.1. Description

Get the priority ordered list of criteria associated with this command that say what attributes a cluster needs to have in order for this command to work on that cluster.

9.27.2. Endpoint

GET /api/v3/commands/{id}/clusterCriteria

9.27.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 76. /api/v3/commands/{id}/clusterCriteria
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/ab9df4ed-ec75-4b92-9446-cb208efcb21d/clusterCriteria' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/commands/ab9df4ed-ec75-4b92-9446-cb208efcb21d/clusterCriteria'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

A priority ordered list of criteria

true

[].id

String

The unique identifier a resource needs to have to match this criterion

true

[].name

String

The name a resource needs to have to match this criterion

true

[].version

String

The version a resource needs to have to match this criterion

true

[].status

String

The status a resource needs to have to match this criterion

true

[].tags

Array

The set of tags a resource needs to have to match this criterion

true
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/commands/ab9df4ed-ec75-4b92-9446-cb208efcb21d/clusterCriteria HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:07:30 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 455

[ {
  "id" : "3774a01f-2a15-4440-a521-4b2db8820b63",
  "name" : null,
  "version" : null,
  "status" : null,
  "tags" : [ "44f15b6b-9718-4d9b-81e8-3d5bbd38a61b", "34dfb8a7-d2dc-45dc-8f90-c4bf28747d8d" ]
}, {
  "id" : "a606528f-468f-41b5-8b4a-33895b8c7a02",
  "name" : "prod",
  "version" : "1.0.0",
  "status" : "UP",
  "tags" : [ "05ff443e-9ee3-4c21-81c4-b91bbd8a166c", "6b33cad6-2ab4-465c-a0ee-2c9aa516dd42", "e5738809-2c51-4190-b4b5-4a3d059ba591" ]
} ]

9.28. Remove all the Cluster Criteria From a Command

9.28.1. Description

Remove all the existing cluster criteria from a given command.

9.28.2. Endpoint

DELETE /api/v3/commands/{id}/clusterCriteria

9.28.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 77. /api/v3/commands/{id}/clusterCriteria
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/2c3c73cd-dc16-4aac-905a-311d9e547659/clusterCriteria' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/commands/2c3c73cd-dc16-4aac-905a-311d9e547659/clusterCriteria'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/commands/2c3c73cd-dc16-4aac-905a-311d9e547659/clusterCriteria HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Date: Tue, 18 Jan 2022 23:07:24 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.29. Add a New Cluster Criterion For Command

9.29.1. Description

Add a new cluster criterion to the existing list of cluster criterion for the given command. The new criterion will have the lowest priority of all the criterion.

9.29.2. Endpoint

POST /api/v3/commands/{id}/clusterCriteria

9.29.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 78. /api/v3/commands/{id}/clusterCriteria
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

id

String

The unique identifier a resource needs to have to match this criterion

true

name

String

The name a resource needs to have to match this criterion

true

version

String

The version a resource needs to have to match this criterion

true

status

String

The status a resource needs to have to match this criterion

true

tags

Array

The set of tags a resource needs to have to match this criterion

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/8e22f762-3c93-4d6f-836d-22823f4d4eaa/clusterCriteria' -i -X POST \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "id" : "f616ade3-309b-43bc-b47a-503baf4dab15",
  "name" : "adhocCluster",
  "version" : "3.0.0",
  "status" : "UP",
  "tags" : [ "sched:adhoc", "type:yarn" ]
}'
HTTPie
$ echo '{
  "id" : "f616ade3-309b-43bc-b47a-503baf4dab15",
  "name" : "adhocCluster",
  "version" : "3.0.0",
  "status" : "UP",
  "tags" : [ "sched:adhoc", "type:yarn" ]
}' | http POST 'https://genie.example.com/api/v3/commands/8e22f762-3c93-4d6f-836d-22823f4d4eaa/clusterCriteria' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
POST /api/v3/commands/8e22f762-3c93-4d6f-836d-22823f4d4eaa/clusterCriteria HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 163

{
  "id" : "f616ade3-309b-43bc-b47a-503baf4dab15",
  "name" : "adhocCluster",
  "version" : "3.0.0",
  "status" : "UP",
  "tags" : [ "sched:adhoc", "type:yarn" ]
}
Response
HTTP/1.1 200 OK
Date: Tue, 18 Jan 2022 23:07:30 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.30. Set Cluster Criteria For Command

9.30.1. Description

Replace the existing cluster criteria for a command with a new list. The criterion are added to the command in the same order they are passed to the service. This is the priority order they will be evaluated in.

9.30.2. Endpoint

PUT /api/v3/commands/{id}/clusterCriteria

9.30.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 79. /api/v3/commands/{id}/clusterCriteria
Parameter Description

id

The resource id
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

[]

Array

A priority ordered list of criteria

true

[].id

String

The unique identifier a resource needs to have to match this criterion

true

[].name

String

The name a resource needs to have to match this criterion

true

[].version

String

The version a resource needs to have to match this criterion

true

[].status

String

The status a resource needs to have to match this criterion

true

[].tags

Array

The set of tags a resource needs to have to match this criterion

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/5c427ccc-35c9-434e-b84c-982033678376/clusterCriteria' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ {
  "id" : "b6b46f0c-68b7-4257-a984-8def730118e5",
  "name" : null,
  "version" : null,
  "status" : null,
  "tags" : [ ]
}, {
  "id" : null,
  "name" : null,
  "version" : "82a35752-0e6f-4d22-805f-5096331acaff",
  "status" : null,
  "tags" : [ ]
}, {
  "id" : null,
  "name" : "d9d581e6-ae9c-4bec-9496-9cf4085d8900",
  "version" : null,
  "status" : null,
  "tags" : [ ]
} ]'
HTTPie
$ echo '[ {
  "id" : "b6b46f0c-68b7-4257-a984-8def730118e5",
  "name" : null,
  "version" : null,
  "status" : null,
  "tags" : [ ]
}, {
  "id" : null,
  "name" : null,
  "version" : "82a35752-0e6f-4d22-805f-5096331acaff",
  "status" : null,
  "tags" : [ ]
}, {
  "id" : null,
  "name" : "d9d581e6-ae9c-4bec-9496-9cf4085d8900",
  "version" : null,
  "status" : null,
  "tags" : [ ]
} ]' | http PUT 'https://genie.example.com/api/v3/commands/5c427ccc-35c9-434e-b84c-982033678376/clusterCriteria' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/commands/5c427ccc-35c9-434e-b84c-982033678376/clusterCriteria HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 377

[ {
  "id" : "b6b46f0c-68b7-4257-a984-8def730118e5",
  "name" : null,
  "version" : null,
  "status" : null,
  "tags" : [ ]
}, {
  "id" : null,
  "name" : null,
  "version" : "82a35752-0e6f-4d22-805f-5096331acaff",
  "status" : null,
  "tags" : [ ]
}, {
  "id" : null,
  "name" : "d9d581e6-ae9c-4bec-9496-9cf4085d8900",
  "version" : null,
  "status" : null,
  "tags" : [ ]
} ]
Response
HTTP/1.1 200 OK
Date: Tue, 18 Jan 2022 23:07:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.31. Insert a New Cluster Criterion For Command

9.31.1. Description

Add a new Criterion to the existing list of cluster criteria for the command identified by id. The priority is the place in the list this new criterion should be placed. A value of 0 indicates it should be placed at the front of the list with the highest possible priority. 1 would be second in the list etc. If priority is > the current size of the cluster criteria list this new criterion will be placed at the end as the lowest priority item. Priority must be >= 0.

9.31.2. Endpoint

PUT /api/v3/commands/{id}/clusterCriteria/{priority}

9.31.3. API Docs

Request Documentation
Headers
Name Description

Content-Type

application/json
Path Parameters
Table 80. /api/v3/commands/{id}/clusterCriteria/{priority}
Parameter Description

id

The resource id

priority

Priority of the criterion to insert
Query Parameters

None

Payload Fields
Path Type Description Constraints Optional

id

String

The unique identifier a resource needs to have to match this criterion

true

name

String

The name a resource needs to have to match this criterion

true

version

String

The version a resource needs to have to match this criterion

true

status

String

The status a resource needs to have to match this criterion

true

tags

Array

The set of tags a resource needs to have to match this criterion

true
Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/62c82312-bba2-4662-b165-58dab0760ed5/clusterCriteria/1' -i -X PUT \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "id" : "fb21ffc8-47b0-4a72-a8fe-473aa817df18",
  "name" : "insightCluster",
  "version" : "4.0.0",
  "status" : "OUT_OF_SERVICE",
  "tags" : [ "type:presto", "sched:insights" ]
}'
HTTPie
$ echo '{
  "id" : "fb21ffc8-47b0-4a72-a8fe-473aa817df18",
  "name" : "insightCluster",
  "version" : "4.0.0",
  "status" : "OUT_OF_SERVICE",
  "tags" : [ "type:presto", "sched:insights" ]
}' | http PUT 'https://genie.example.com/api/v3/commands/62c82312-bba2-4662-b165-58dab0760ed5/clusterCriteria/1' \
    'Content-Type:application/json; charset=UTF-8'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
PUT /api/v3/commands/62c82312-bba2-4662-b165-58dab0760ed5/clusterCriteria/1 HTTP/1.1
Content-Type: application/json; charset=UTF-8
Host: genie.example.com
Content-Length: 182

{
  "id" : "fb21ffc8-47b0-4a72-a8fe-473aa817df18",
  "name" : "insightCluster",
  "version" : "4.0.0",
  "status" : "OUT_OF_SERVICE",
  "tags" : [ "type:presto", "sched:insights" ]
}
Response
HTTP/1.1 200 OK
Date: Tue, 18 Jan 2022 23:07:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.32. Remove the Cluster Criterion From a Command

9.32.1. Description

Remove the Criterion with the given priority from the current list of cluster criteria associated with the command identified by id. A value of 0 for priority will result in the first element in the list being removed, 1 the second element and so on.

0 ⇐ priority < current criteria length

9.32.2. Endpoint

DELETE /api/v3/commands/{id}/clusterCriteria/{priority}

9.32.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 81. /api/v3/commands/{id}/clusterCriteria/{priority}
Parameter Description

id

The resource id

priority

Priority of the criterion to insert
Query Parameters

None

Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/d593c57f-d884-48e8-9cc6-4daf66e579bc/clusterCriteria/1' -i -X DELETE
HTTPie
$ http DELETE 'https://genie.example.com/api/v3/commands/d593c57f-d884-48e8-9cc6-4daf66e579bc/clusterCriteria/1'
Response Documentation
Headers

None

Payload Fields

None

HATEOAS Links

None

HTTP Messages
Request
DELETE /api/v3/commands/d593c57f-d884-48e8-9cc6-4daf66e579bc/clusterCriteria/1 HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Date: Tue, 18 Jan 2022 23:07:27 GMT
Keep-Alive: timeout=60
Connection: keep-alive

9.33. Resolve Clusters for Command Cluster Criteria

9.33.1. Description

For a given Command resolve the Clusters which each of the Commands clusterCriteria would resolve if they were evaluated against the current contents of the database.

9.33.2. Endpoint

GET /api/v3/commands/{id}/resolvedClusters

9.33.3. API Docs

Request Documentation
Headers

None

Path Parameters
Table 82. /api/v3/commands/{id}/resolvedClusters
Parameter Description

id

The resource id
Query Parameters
Parameter Description

addDefaultStatus

Whether the system should add the default cluster status to the criteria. Default: true
Payload Fields

None

Request Examples
cURL
$ curl 'https://genie.example.com/api/v3/commands/d2cbbd04-a23e-4dce-b6bf-85abdf40893f/resolvedClusters' -i -X GET
HTTPie
$ http GET 'https://genie.example.com/api/v3/commands/d2cbbd04-a23e-4dce-b6bf-85abdf40893f/resolvedClusters'
Response Documentation
Headers
Name Description

Content-Type

application/json
Payload Fields
Path Type Description Constraints Optional

[]

Array

The list of criterion and associated resolved clusters

true

[].criterion

Object

The criterion that was evaluated to yield the resources

false

[].resources

Array

The resources that were resolved by evaluating the criterion

false

[].criterion.id

String

The unique identifier a resource needs to have to match this criterion

true

[].criterion.name

String

The name a resource needs to have to match this criterion

true

[].criterion.version

String

The version a resource needs to have to match this criterion

true

[].criterion.status

String

The status a resource needs to have to match this criterion

true

[].criterion.tags

Array

The set of tags a resource needs to have to match this criterion

true

[].resources[].id

String

The id. If not set the system will set one.

Size must be between 0 and 255 inclusive

true

[].resources[].created

String

The UTC time of creation. Set by system. ISO8601 format including milliseconds.

true

[].resources[].updated

String

The UTC time of last update. Set by system. ISO8601 format including milliseconds.

true

[].resources[].name

String

The name

Must not be empty. Size must be between 0 and 255 inclusive

false

[].resources[].user

String

The user

Must not be empty. Size must be between 0 and 255 inclusive

false

[].resources[].version

String

The version

Must not be empty. Size must be between 0 and 255 inclusive

false

[].resources[].description

String

Any description

Size must be between 0 and 1000 inclusive

true

[].resources[].metadata

Object

Any semi-structured metadata. Must be valid JSON

true

[].resources[].tags

Array

The tags

true

[].resources[].setupFile

String

A location for any setup that needs to be done when installing

Size must be between 0 and 1024 inclusive

true

[].resources[].configs

Array

Any configuration files needed for the resource

true

[].resources[].status

String

The status of the cluster. Options: [UP, OUT_OF_SERVICE, TERMINATED]

Must not be null

false

[].resources[].dependencies

Array

The dependencies for the cluster

true
HATEOAS Links

None

HTTP Messages
Request
GET /api/v3/commands/d2cbbd04-a23e-4dce-b6bf-85abdf40893f/resolvedClusters HTTP/1.1
Host: genie.example.com
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Transfer-Encoding: chunked
Date: Tue, 18 Jan 2022 23:07:30 GMT
Keep-Alive: timeout=60
Connection: keep-alive
Content-Length: 4132

[ {
  "criterion" : {
    "id" : "0eb1574f-0cfc-402c-90ad-dd6eb86d4c8a",
    "name" : null,
    "version" : null,
    "status" : null,
    "tags" : [ ]
  },
  "resources" : [ {
    "id" : "0eb1574f-0cfc-402c-90ad-dd6eb86d4c8a",
    "created" : "2022-01-18T23:07:30.494Z",
    "updated" : "2022-01-18T23:07:30.494Z",
    "version" : "f59b583b-7ad8-40cb-8e65-5bc2538f5993",
    "user" : "408fe71b-0524-4d65-8e6d-0293d83e6771",
    "name" : "d12d244d-2fd2-4cee-a138-ec81de21a8a2",
    "description" : null,
    "metadata" : null,
    "tags" : [ "08d365d8-f055-45a2-9eea-a4abd0a4e893", "0a9d8834-c350-46d5-a9aa-3db20e961be5", "genie.name:d12d244d-2fd2-4cee-a138-ec81de21a8a2", "genie.id:0eb1574f-0cfc-402c-90ad-dd6eb86d4c8a" ],
    "configs" : [ ],
    "dependencies" : [ ],
    "setupFile" : null,
    "status" : "UP"
  } ]
}, {
  "criterion" : {
    "id" : null,
    "name" : "d12d244d-2fd2-4cee-a138-ec81de21a8a2",
    "version" : null,
    "status" : null,
    "tags" : [ ]
  },
  "resources" : [ {
    "id" : "0eb1574f-0cfc-402c-90ad-dd6eb86d4c8a",
    "created" : "2022-01-18T23:07:30.494Z",
    "updated" : "2022-01-18T23:07:30.494Z",
    "version" : "f59b583b-7ad8-40cb-8e65-5bc2538f5993",
    "user" : "408fe71b-0524-4d65-8e6d-0293d83e6771",
    "name" : "d12d244d-2fd2-4cee-a138-ec81de21a8a2",
    "description" : null,
    "metadata" : null,
    "tags" : [ "08d365d8-f055-45a2-9eea-a4abd0a4e893", "0a9d8834-c350-46d5-a9aa-3db20e961be5", "genie.name:d12d244d-2fd2-4cee-a138-ec81de21a8a2", "genie.id:0eb1574f-0cfc-402c-90ad-dd6eb86d4c8a" ],
    "configs" : [ ],
    "dependencies" : [ ],
    "setupFile" : null,
    "status" : "UP"
  }, {
    "id" : "68085e1d-d392-46b7-b3e0-425bbded4170",
    "created" : "2022-01-18T23:07:30.503Z",
    "updated" : "2022-01-18T23:07:30.503Z",
    "version" : "f59b583b-7ad8-40cb-8e65-5bc2538f5993",
    "user" : "408fe71b-0524-4d65-8e6d-0293d83e6771",
    "name" : "d12d244d-2fd2-4cee-a138-ec81de21a8a2",
    "description" : null,
    "metadata" : null,
    "tags" : [ "08d365d8-f055-45a2-9eea-a4abd0a4e893", "0a9d8834-c350-46d5-a9aa-3db20e961be5", "genie.name:d12d244d-2fd2-4cee-a138-ec81de21a8a2", "genie.id:68085e1d-d392-46b7-b3e0-425bbded4170" ],
    "configs" : [ ],
    "dependencies" : [ ],
    "setupFile" : null,
    "status" : "UP"
  } ]
}, {
  "criterion" : {
    "id" : null,
    "name" : null,
    "version" : "190de78c-e7cf-4982-b37e-d79398f20953",
    "status" : null,
    "tags" : [ ]
  },
  "resources" : [ {
    "id" : "39c95e0d-49ae-4cfd-bd12-d861668f0460",
    "created" : "2022-01-18T23:07:30.511Z",
    "updated" : "2022-01-18T23:07:30.511Z",
    "version" : "190de78c-e7cf-4982-b37e-d79398f20953",
    "user" : "a414a542-958f-4579-b993-3612f8a04e45",
    "name" : "9c959a4c-28f1-44a3-8a78-a3d90f1f6167",
    "description" : null,
    "metadata" : null,
    "tags" : [ "genie.id:39c95e0d-49ae-4cfd-bd12-d861668f0460", "143c6bb7-6514-4a16-ad6a-4aa35d53e09e", "93c607c9-9c7c-4b8e-9f29-471c738eae8a", "genie.name:9c959a4c-28f1-44a3-8a78-a3d90f1f6167" ],
    "configs" : [ ],
    "dependencies" : [ ],
    "setupFile" : null,
    "status" : "UP"
  } ]
}, {
  "criterion" : {
    "id" : null,
    "name" : null,
    "version" : null,
    "status" : "TERMINATED",
    "tags" : [ ]
  },
  "resources" : [ ]
}, {
  "criterion" : {
    "id" : null,
    "name" : null,
    "version" : null,
    "status" : null,
    "tags" : [ "143c6bb7-6514-4a16-ad6a-4aa35d53e09e", "93c607c9-9c7c-4b8e-9f29-471c738eae8a" ]
  },
  "resources" : [ {
    "id" : "39c95e0d-49ae-4cfd-bd12-d861668f0460",
    "created" : "2022-01-18T23:07:30.511Z",
    "updated" : "2022-01-18T23:07:30.511Z",
    "version" : "190de78c-e7cf-4982-b37e-d79398f20953",
    "user" : "a414a542-958f-4579-b993-3612f8a04e45",
    "name" : "9c959a4c-28f1-44a3-8a78-a3d90f1f6167",
    "description" : null,
    "metadata" : null,
    "tags" : [ "genie.id:39c95e0d-49ae-4cfd-bd12-d861668f0460", "143c6bb7-6514-4a16-ad6a-4aa35d53e09e", "93c607c9-9c7c-4b8e-9f29-471c738eae8a", "genie.name:9c959a4c-28f1-44a3-8a78-a3d90f1f6167" ],
    "configs" : [ ],
    "dependencies" : [ ],
    "setupFile" : null,
    "status" : "UP"
  } ]
} ]