18.42. Jobs Start RPC

Request starting of a job created by the Create RPC.

rpc Start (JobsStartRequest) returns (JobsStartResponse)

18.42.1. Messages

  • JobsStartRequest

  • JobsStartResponse

  • NamedValue

Copy
Copied!
            

message JobsStartRequest { message NamedValue { string name = 1; string value = 2; } RequestHeader header = 1; Identifier job_id = 2; repeated NamedValue Variables = 3; }


18.43.1. Properties

type: message

Standard RPC request header.

See RequestHeader for details.

18.43.1.2. job_id

type: message

The Job id for the job that should be started.

Required. If the identifier value is omitted from the request or does not match any known job identifier, Clara Deploy SDK will be unable to fulfill the request.

See Identifier for details.

18.43.1.2.1. Variables

type: message

Set of key/value pairs to be passed into the job as it starts. Variables passed to a job upon start are used to populate any pipeline parameter values defined by the pipeline the job is executing. Pipeline parameters are, in turn, used to complete any template placeholders present in the definition.

See NamedValue for details.

Copy
Copied!
            

message JobsStartResponse{ RequestHeader header = 1; JobState state = 2; JobStatus status = 3; }


Clara Deploy SDK Jobs service will respond to any start request with a JobsStartResponse message. Requestors can use the response message to determine the result of their request.

18.44.1. Properties

18.44.1.1. header

type: message

Standard RPC response header.

See ResponseHeader for details.

18.44.1.2. state

type: enum

Current state of the job.

See JobState for details.

18.44.1.3. status

type: enum

Current status of the job.

See JobStatus for details.

Information provided as key-value pairs to a job as it starts.

Copy
Copied!
            

message NamedValue { string name = 1; string value = 2; }


18.45.1. Properties

18.45.1.1. name

type: string

Name of the variable.

18.45.1.2. value

type: string

Value of the variable.

© Copyright 2018-2021, NVIDIA Corporation. All rights reserved. Last updated on Feb 1, 2023.