Querying the Outputs of a Completed Hosted Workflow Job

When the status from the job query indicates a completed job, ie: you receive a response of:

{
    "status": "completed",
    "state": "succeeded",
    "progress": 100
}

the job details may be retrieved.

To retrieve details about a specific job, the job identifier along with the workflow identifier are used in the following GET query:

https://api.cloud.telestream.net/vantage-cloud-port/v2.0/workflows/c29dde60e746f2bcf48876b311829da5/workflow-jobs/82971554f9dde5e0d91878124c08c9db

10781078

The job details provide information about the job and any outputs which were
created:

{

    "id": "82971554f9dde5e0d91878124c08c9db",
    "name": "Test API",
    "inputs": 
    {
        "sources": 
        {
            "Original": "https://johnkoctopus.s3-us-west-1.amazonaws.com/demo1.mpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJJUCSYT27AMWGFZQ/20200408/us-west-1/s3/aws4_request&X-Amz-Date=20200408T123537Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=88cc727ffb81561dc8650c2f07f66f56c4ee062e299ef8197925e591610538c0"
        },
        "variables": 
        {
            "Video Height": "360",
            "Video Width": "640"
        }
    },

    "storage_references": {
        "9dff864e-045c-4b58-8cb1-12221bd89c6b": {
            "store_id": "240f042bfc4bee58a965c7d79e17c45c",
            "folder_offset": "/folder1/project1/"
        }
    },

    "progress": 100,
    "state": "succeeded",
    "status": "completed",
    "action_jobs": 
    [
        {
            "id": "9e5659a4ac0784be5551cc540dbdfc1e",
            "action_name": "IPTV",
            "state": "succeeded",
            "status": "completed",
            "progress": 100,
            "inputs": 
            [
                {
                    "id": "4073d2c93434f0ad8f7194856cce670a",
                    "name": "Original",
                    "url": "https://johnkoctopus.s3-us-west-1.amazonaws.com/demo1.mpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJJUCSYT27AMWGFZQ/20200408/us-west-1/s3/aws4_request&X-Amz-Date=20200408T123537Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=88cc727ffb81561dc8650c2f07f66f56c4ee062e299ef8197925e591610538c0",
                    "duration": 30000,
                    "file_size": 30158984
                }
            ],

            "outputs":
            [
                {
                    "id": "ac870f507d93945e1ccfcae5fd09b38b",
                    "name": "cloudTransportStreamOutput",
                    "remote_path": "/folder1/project1/",
                    "duration": 30030,
                    "file_size": 73077860,
                    "files": 
                    [
                        "demo1.ts"
                    ]
                }
            ],

            "store_id": "240f042bfc4bee58a965c7d79e17c45c",
            "created_at": "2020-04-10T17:02:01.766665Z",
            "updated_at": "2020-04-10T17:05:47.249575Z",
            "started_processing_at": "2020-04-10T17:05:33.788055Z",
            "finished_processing_at": "2020-04-10T17:05:44.402181Z",
            "error_class": "",
            "error_message": ""
        }
    ],

    "workflow_version": 0,
    "created_at": "2020-04-10T17:01:48.090967Z",
    "updated_at": "2020-04-10T17:05:54.376076Z"
}

The details for a given job allows a user to infer the location of each output
generated by a particular action within the workflow.

The workflow above had a single action (the IPTV Flip) present. The following
sub-section of JSON from the workflow details provides the information about
what what was emitted by the action (the ‘output’).

560560

The most important aspects of the OUTPUT section are highlighted in green above.

The information above indicates that the output file: demo1.ts was created in
the folder structure: /folder1/project1/ within the Telestream Cloud store
identified by store ID: 240f042bfc4bee58a965c7d79e17c45c

The Store with this ID was previously created for Telestream Cloud (earlier);
and browsing to this object store (in a utility such as Cyberduck) allows the
bucket and folder structure/file to be verified:

11341134

Did this page help you?