Get Job

GET

https://app.mk.io/api/v1/projects/:project_name/media/transforms/:transform_name/jobs/:job_name

GET

/api/v1/projects/:project_name/media/transforms/:transform_name/jobs/:job_name

curl https://app.mk.io/api/v1/projects/project_name/media/transforms/transform_name/jobs/job_name \
     -H "Authorization: Bearer <token>"

{
  "properties": {
    "input": {
      "@odata.type": "string",
      "assetName": "string",
      "end": {
        "@odata.type": "string",
        "time": "string"
      },
      "files": [
        "string"
      ],
      "label": "string",
      "start": {
        "@odata.type": "string",
        "time": "string"
      }
    },
    "outputs": [
      {
        "@odata.type": "string",
        "assetName": "string",
        "endTime": "string",
        "error": {
          "category": "Account",
          "code": "ConfigurationUnsupported",
          "message": "string",
          "retry": "DoNotRetry"
        },
        "label": "string",
        "progress": 0,
        "startTime": "string",
        "state": "Queued"
      }
    ],
    "correlationData": {},
    "created": "2024-01-15T09:30:00Z",
    "description": "string",
    "endTime": "string",
    "lastModified": "2024-01-15T09:30:00Z",
    "priority": "Normal",
    "recording": {
      "actualEndTime": "string",
      "actualStartTime": "string",
      "details": "string",
      "state": "Scheduled",
      "targetEndTime": "string",
      "targetStartTime": "string"
    },
    "startTime": "2024-01-15T09:30:00Z",
    "state": "Queued"
  },
  "id": "string",
  "name": "name",
  "systemData": {
    "createdAt": "2024-01-15T09:30:00Z",
    "createdBy": "string",
    "createdByType": "User",
    "internalId": "string",
    "lastModifiedAt": "2024-01-15T09:30:00Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  },
  "type": "string"
}

Get a Job by name.

RBAC Capability Required: ams.job.get

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_namestringRequired

transform_namestringRequired

job_namestringRequired

Response

A single Job.

propertiesobject

Properties of the job

idstringOptionalRead-only

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

namestringOptionalRead-onlyformat: "^[^\^\'<>%&:\\?/*+]+$"1-260 characters

The name of the resource

systemDataobjectOptional

Metadata pertaining to creation and last modification of the resource.

typestringOptionalRead-only

The type of the resource. E.g. "Microsoft.Media/mediaservices/assets"

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error