Patch a job by ID

patch/compute-ops-mgmt/v1beta3/jobs/{id}

Updates an existing job

URI PATH PREFIX RENAME

This API now supports the URI path prefix /compute-ops-mgmt which used to be /compute-ops. The old prefix will continue to be supported to allow for a smooth transition. The Guide contains more information about this change.

SecurityBearer
Request
path Parameters
id
required
string <uuid>

Unique Job identifier

header Parameters
Content-Type
required
string

Content-Type header must designate 'application/merge-patch+json' in order for the request to be performed.

Value: "application/merge-patch+json"
Tenant-Acid
string <uuid>

Tenant-Acid header can be used by an MSP workspace to make API calls on behalf of their tenant by specifying the tenant's application customer ID.

In order to make such an API call, the Bearer token must belong to an MSP workspace and this header value must be the application customer ID of a tenant within the MSP workspace. Use the /compute-ops-mgmt/v1beta1/accounts API to determine the application customer IDs for your tenant accounts.

Request Body schema: application/merge-patch+json
required

Job update data

state
string

New state for the job (currently only Complete or Error is supported)

Enum: "COMPLETE" "ERROR"
object

Additional input (optional) for the job

Responses
200

Job data

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

406

Not acceptable

412

Precondition failed

415

Unsupported media type

500

Internal server error

Request samples
application/merge-patch+json
{
  • "state": "COMPLETE",
  • "input": {
    }
}
Response samples
application/json
{
  • "id": "2500759c-b7dd-4c68-ab7e-6b644bcf4b9c",
  • "parentJobId": "284f3b7a-7a17-4f0a-9b40-a51bc887c7d0",
  • "type": "compute-ops-mgmt/job",
  • "resourceUri": "/compute-ops-mgmt/v1beta3/jobs/2500759c-b7dd-4c68-ab7e-6b644bcf4b9c",
  • "name": "FirmwareUpdate.New",
  • "generation": 9,
  • "deleteOnComplete": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "jobTemplateUri": "/compute-ops-mgmt/v1beta2/job-templates/fd54a96c-cabc-42e3-aee3-374a2d009dba",
  • "associatedResourceUri": "/compute-ops-mgmt/v1beta2/servers/744674-N19+8899744674319686",
  • "resource": {
    },
  • "data": {
    },
  • "jobParams": {
    },
  • "results": {
    },
  • "state": "PENDING",
  • "resultCode": { },
  • "status": "string",
  • "statusDetails": { }
}