package job
Get desktop application:
View/edit binary Protocol Buffers messages
service FrameInterface
job.proto:21rpc AddRenderPartition (, )
job.proto:23Add a render partition to the frame.
message
job.proto:810FRAME ---- AddRenderPartition
optional frame = 1
string host = 2
int32 threads = 3
int32 max_cores = 4
int64 max_memory = 5
int64 max_gpu_memory = 6
string username = 7
int32 max_gpus = 8
message
job.proto:821optional render_partition = 1
rpc CreateDependencyOnFrame (, )
job.proto:26Sets up and returns a FrameOnFrame dependency.
message
job.proto:826CreateDependencyOnFrame
optional frame = 1
optional depend_on_frame = 2
message
job.proto:831optional depend = 1
rpc CreateDependencyOnJob (, )
job.proto:29Sets up and returns a FrameOnJob dependency.
message
job.proto:836CreateDependencyOnJob
optional frame = 1
optional job = 2
message
job.proto:841optional depend = 1
rpc CreateDependencyOnLayer (, )
job.proto:32Sets up and returns a FrameOnLayer dependency.
message
job.proto:846CreateDependencyOnLayer
optional frame = 1
optional layer = 2
message
job.proto:851optional depend = 1
rpc DropDepends (, )
job.proto:35Drops every dependendy that is causing this frame not to run.
message
job.proto:856DropDepends
optional frame = 1
depend.DependTarget target = 2
message
job.proto:861(message has no fields)
rpc Eat (, )
job.proto:38Eating a frame will stop rendering and will not try to coninue processing the frame.
message
job.proto:864Eat
optional frame = 1
message
job.proto:868(message has no fields)
rpc FindFrame (, )
job.proto:41Finds a frame in a pending job based on the job, layer, and frame number.
message
job.proto:871FindFrame
string job = 1
string layer = 2
int32 frame = 3
message
job.proto:877optional frame = 1
rpc GetFrame (, )
job.proto:44Get a frame from its unique id
message
job.proto:882GetFrame
string id = 1
message
job.proto:886optional frame = 1
rpc GetFrames (, )
job.proto:47Get a frame from search criteria
message
job.proto:891GetFrames
string job = 1
optional r = 2
message
job.proto:896optional frames = 1
rpc GetWhatDependsOnThis (, )
job.proto:50Returns a list of dependencies setup to depend on this frame.
message
job.proto:901GetWhatDependsOnThis
optional frame = 1
message
job.proto:905optional depends = 1
rpc GetWhatThisDependsOn (, )
job.proto:53Returns a list of dependencies that this frame depends on.
message
job.proto:910GetWhatThisDependsOn
optional frame = 1
message
job.proto:914optional depends = 1
rpc Kill (, )
job.proto:56Kills the frame if it is running
message
job.proto:919Kill
optional frame = 1
string username = 2
string pid = 3
string host_kill = 4
string reason = 5
message
job.proto:927(message has no fields)
rpc MarkAsDepend (, )
job.proto:60Will recount the number of active dependencies on the frame and put it back into the Depend state if that count is greater than 0.
message
job.proto:930MarkAsDepend
optional frame = 1
message
job.proto:934(message has no fields)
rpc MarkAsWaiting (, )
job.proto:64Changes the frame's dependency count to 0, which will put the frame into the waiting state. Retrying the frame will put it back into the waiting state.
message
job.proto:937MarkAsWaiting
optional frame = 1
message
job.proto:941(message has no fields)
rpc Retry (, )
job.proto:67Retries the frame by setting it as waiting
message
job.proto:944Retry
optional frame = 1
message
job.proto:948(message has no fields)
rpc SetCheckpointState (, )
job.proto:71Updates the state of the frame's checkpoint status. If the checkpoint status is complete, then the frame's checkpointCoreSeconds is updated with the amount of render time that was checkpointed.
message
job.proto:951SetCheckpointState
optional frame = 1
CheckpointState state = 2
message
job.proto:956(message has no fields)
Set a frame's state display override
message
job.proto:1808optional frame = 1
optional override = 2
message
job.proto:1813(message has no fields)
Get a frame's state display overrides
message
job.proto:1815optional frame = 1
message
job.proto:1819optional overrides = 1
service GroupInterface
job.proto:80rpc CreateSubGroup (, )
job.proto:82Create a new sub group of the given name
message
job.proto:961GROUP ---- CreateSubGroup
optional group = 1
string name = 2
message
job.proto:966optional group = 1
rpc Delete (, )
job.proto:85Delete the provided group
message
job.proto:971Delete
optional group = 1
message
job.proto:975(message has no fields)
rpc FindGroup (, )
job.proto:88Finds a group by show name and group
message
job.proto:978FindGroup
string show = 1
string name = 2
message
job.proto:983optional group = 1
rpc GetGroup (, )
job.proto:91Gets a group by its id
message
job.proto:988GetGroup
string id = 1
message
job.proto:992optional group = 1
rpc GetGroups (, )
job.proto:94Get child groups of the provided group
message
job.proto:997GetGroups
optional group = 1
message
job.proto:1001optional groups = 1
rpc GetJobs (, )
job.proto:97Get Jobs of the provided group
message
job.proto:1006GetJobs
optional group = 1
message
job.proto:1010optional jobs = 1
rpc ReparentGroups (, )
job.proto:100Reparent the provided groups to the provided group
message
job.proto:1015ReparentGroups
optional group = 1
optional groups = 2
message
job.proto:1020(message has no fields)
rpc ReparentJobs (, )
job.proto:103Reparent the provided jobs to the provided group
message
job.proto:1023ReparentJobs
optional group = 1
optional jobs = 2
message
job.proto:1028(message has no fields)
rpc SetDefaultJobMaxCores (, )
job.proto:106Set the Default Job Max Core values to all in the provided group
message
job.proto:1031SetDefJobMaxCores
optional group = 1
float max_cores = 2
message
job.proto:1036(message has no fields)
rpc SetDefaultJobMinCores (, )
job.proto:109Set the Default Job Min Core values to all in the provided group
message
job.proto:1039SetDefJobMinCores
optional group = 1
float min_cores = 2
message
job.proto:1044(message has no fields)
rpc SetDefaultJobMaxGpus (, )
job.proto:112Set the Default Job Max Gpu values to all in the provided group
message
job.proto:1047SetDefaultJobMaxGpus
optional group = 1
int32 max_gpus = 2
message
job.proto:1052(message has no fields)
rpc SetDefaultJobMinGpus (, )
job.proto:115Set the Default Job Min Gpu values to all in the provided group
message
job.proto:1055SetDefaultJobMinGpus
optional group = 1
int32 min_gpus = 2
message
job.proto:1060(message has no fields)
rpc SetDefaultJobPriority (, )
job.proto:118Set the Default Job Priority values to all in the provided group
message
job.proto:1063SetDefJobPriority
optional group = 1
int32 priority = 2
message
job.proto:1068(message has no fields)
rpc SetDepartment (, )
job.proto:121Set the department associated with the provided group
message
job.proto:1071SetDept
optional group = 1
string dept = 2
message
job.proto:1076(message has no fields)
rpc SetGroup (, )
job.proto:124Set the provided groups parent group
message
job.proto:1079SetGroup
optional group = 1
optional parent_group = 2
message
job.proto:1084(message has no fields)
rpc SetMaxCores (, )
job.proto:127Set the group's Max Cores value
message
job.proto:1087SetMaxCores
optional group = 1
float max_cores = 2
message
job.proto:1092(message has no fields)
rpc SetMinCores (, )
job.proto:130Set the groups Min Cores values
message
job.proto:1095SetMinCores
optional group = 1
float min_cores = 2
message
job.proto:1100(message has no fields)
rpc SetMaxGpus (, )
job.proto:133Set the group's Max Gpu value
message
job.proto:1103SetMaxGpus
optional group = 1
int32 max_gpus = 2
message
job.proto:1108(message has no fields)
rpc SetMinGpus (, )
job.proto:136Set the groups Min Gpu values
message
job.proto:1111SetMinGpus
optional group = 1
int32 min_gpus = 2
message
job.proto:1116(message has no fields)
rpc SetName (, )
job.proto:139Set the groups name
message
job.proto:1119SetName
optional group = 1
string name = 2
message
job.proto:1124(message has no fields)
service JobInterface
job.proto:142rpc AddComment (, )
job.proto:144Add a comment on this job
message
job.proto:1128JOB ---- AddComment
optional job = 1
optional new_comment = 2
message
job.proto:1133(message has no fields)
rpc AddRenderPartition (, )
job.proto:148Add a render partition to the local host. This partition will run frames on the specified job.
message
job.proto:1136AddRenderPartition
optional job = 1
string host = 2
int32 threads = 3
int32 max_cores = 4
int64 max_memory = 5
int64 max_gpu_memory = 6
string username = 7
int32 max_gpus = 8
message
job.proto:1147optional render_partition = 1
rpc AddSubscriber (, )
job.proto:152Adds a subscriber to a job. When the job is finished, subscriber receives email with notification
message
job.proto:1152AddSubscriber
optional job = 1
string subscriber = 2
message
job.proto:1157(message has no fields)
rpc CreateDependencyOnFrame (, )
job.proto:155Setup and retunrn a JobOnFrame dependency
message
job.proto:1160CreateDependencyOnFrame
optional job = 1
optional frame = 2
message
job.proto:1165optional depend = 1
rpc CreateDependencyOnJob (, )
job.proto:158Setup and return a JobOnJob dependency
message
job.proto:1170CreateDependencyOnJob
optional job = 1
optional on_job = 2
message
job.proto:1175optional depend = 1
rpc CreateDependencyOnLayer (, )
job.proto:161Setup and retunrn a JobOnLayer dependency
message
job.proto:1180CreateDependencyOnLayer
optional job = 1
optional layer = 2
message
job.proto:1185optional depend = 1
rpc DropDepends (, )
job.proto:166Drops all external dependencies for the job. This means that the internal depend structure will be maintained, but everything that depends on another job will be dropped.
message
job.proto:1190DropDepends
optional job = 1
depend.DependTarget target = 2
message
job.proto:1195(message has no fields)
rpc EatFrames (, )
job.proto:169Eats all frames that match the FrameSearchCriteria
message
job.proto:1198EatFrames
optional job = 1
optional req = 2
message
job.proto:1203(message has no fields)
rpc FindJob (, )
job.proto:172Finds a pending job using the job name
message
job.proto:1206FindJob
string name = 1
message
job.proto:1210optional job = 1
rpc GetComments (, )
job.proto:175Get the comments for this job
message
job.proto:1215GetComments
optional job = 1
message
job.proto:1219optional comments = 1
rpc GetCurrent (, )
job.proto:178Get the job details
message
job.proto:1224GetCurrent
optional job = 1
message
job.proto:1228optional job = 1
rpc GetDepends (, )
job.proto:181Returns a list of all dependencies that this job is involved with
message
job.proto:1233GetDepends
optional job = 1
message
job.proto:1237optional depends = 1
rpc GetFrames (, )
job.proto:184Returns all frame objects that match FrameSearchCriteria
message
job.proto:1242GetFrames
optional job = 1
optional req = 2
message
job.proto:1247optional frames = 1
rpc GetJob (, )
job.proto:187Finds a pending job using the job name
message
job.proto:1252GetJob
string id = 1
message
job.proto:1256optional job = 1
rpc GetJobs (, )
job.proto:190Returns a list of jobs based on specified criteria
message
job.proto:1261GetJobs
optional r = 1
message
job.proto:1265optional jobs = 1
rpc GetJobNames (, )
job.proto:193Returns a sequence of job names using search criteria
message
job.proto:1270GetJobNames
optional r = 1
message
job.proto:1275repeated string names = 1
rpc GetLayers (, )
job.proto:196Returns all layer objects
message
job.proto:1280GetLayers
optional job = 1
message
job.proto:1284optional layers = 1
rpc GetUpdatedFrames (, )
job.proto:207Returns a UpdatedFrameCheckResult which contains updated state information for frames that have changed since the last update time as well as the current state of the job. If the user is filtering by layer, passing an array of layer proxies will limit the updates to specific layers. At most, your going to get 1 update per running frame every minute due to memory usage.
message
job.proto:1289GetUpdatedFrames
optional job = 1
int32 last_check = 2
optional layer_filter = 3
message
job.proto:1295JobState state = 1
int32 server_time = 2
optional updated_frames = 3
rpc GetWhatDependsOnThis (, )
job.proto:214Returns a list of dependencies setup to depend on this job. This includes all types of depends, not just OnJob dependencies. This will not return any frame on frame dependencies that are part of a FrameByFrame depend. It will return a single element that represents the entire dependency.
message
job.proto:1302GetWhatDependsOnThis
optional job = 1
message
job.proto:1306optional depends = 1
rpc GetWhatThisDependsOn (, )
job.proto:217Returns a list of dependencies that this frame depends on.
message
job.proto:1311GetWhatThisDependsOn
optional job = 1
message
job.proto:1315optional depends = 1
rpc IsJobPending (, )
job.proto:220Returns true if the job is in the pending state the cue.
message
job.proto:1320IsJobPending
string name = 1
message
job.proto:1324bool value = 1
rpc Kill (, )
job.proto:224Kill the job. This puts the job into the Finished State All running frames are killed, all depends satisfied.
message
job.proto:1329Kill
optional job = 1
string username = 2
string pid = 3
string host_kill = 4
string reason = 5
message
job.proto:1337(message has no fields)
rpc KillFrames (, )
job.proto:227Kills all frames that match the FrameSearchCriteria
message
job.proto:1340KillFrames
optional job = 1
optional req = 2
string username = 3
string pid = 4
string host_kill = 5
string reason = 6
message
job.proto:1349(message has no fields)
rpc LaunchSpecAndWait (, )
job.proto:231Launches a job spec and returns an array of launched jobs. Waits for jobs to be committed to DB. This might time out before jobs are launched.
message
job.proto:1361LaunchSpecAndWait
string spec = 1
message
job.proto:1365optional jobs = 1
rpc LaunchSpec (, )
job.proto:235Launches as a job spec and returns an array of job names that are being launched. This method returns immediately after basic checks. The job could fail to launch of a DB error occurs but that is rare.
message
job.proto:1352LaunchSpec
string spec = 1
message
job.proto:1356repeated string names = 1
rpc MarkAsWaiting (, )
job.proto:238Updates the matching frames from the Depend state to the waiting state
message
job.proto:1370MarkAsWaiting
optional job = 1
optional req = 2
message
job.proto:1375(message has no fields)
rpc MarkDoneFrames (, )
job.proto:241Drops any dependency that requires any frame that matches the FrameSearchCriteria
message
job.proto:1378MarkDoneFrames
optional job = 1
optional req = 2
message
job.proto:1383(message has no fields)
rpc Pause (, )
job.proto:244Pauses the job, which means it no longer gets procs
message
job.proto:1386Pause
optional job = 1
message
job.proto:1390(message has no fields)
rpc ReorderFrames (, )
job.proto:247Reorders the specified frame range on this job
message
job.proto:1393ReorderFrames
optional job = 1
string range = 2
Order order = 3
message
job.proto:1399(message has no fields)
rpc Resume (, )
job.proto:250Resumes a paused job
message
job.proto:1402Resume
optional job = 1
message
job.proto:1406(message has no fields)
rpc RetryFrames (, )
job.proto:253Retries all frames that match the FrameSearchCriteria
message
job.proto:1409RetryFrames
optional job = 1
optional req = 2
message
job.proto:1414(message has no fields)
rpc RunFilters (, )
job.proto:256Rerun filters for this job
message
job.proto:1417RunFilters
optional job = 1
message
job.proto:1421(message has no fields)
rpc SetAutoEat (, )
job.proto:259If set to true, a frame that would have turned dead, will become eaten
message
job.proto:1424SetAutoEat
optional job = 1
bool value = 2
message
job.proto:1429(message has no fields)
rpc SetGroup (, )
job.proto:262Move the job into the specified group
message
job.proto:1432SetGroup
optional job = 1
string group_id = 2
message
job.proto:1437(message has no fields)
rpc SetMaxCores (, )
job.proto:265Sets the maximum number of procs that can run on this job
message
job.proto:1440SetMaxCores
optional job = 1
float val = 2
message
job.proto:1445(message has no fields)
rpc SetMaxRetries (, )
job.proto:270Sets the default maximum number of frame retries for the job. One a frame has retried this many times it will automatically go to the dead state. The default upper limit on this is 16 retries.
message
job.proto:1456SetMaxRetries
optional job = 1
int32 max_retries = 2
message
job.proto:1461(message has no fields)
rpc SetMinCores (, )
job.proto:273Sets the minimum number of procs that can run on this job
message
job.proto:1464SetMinCores
optional job = 1
float val = 2
message
job.proto:1469(message has no fields)
rpc SetMaxGpus (, )
job.proto:276Sets the maximum number of Gpu that can run on this job
message
job.proto:1448SetMaxGpus
optional job = 1
int32 val = 2
message
job.proto:1453(message has no fields)
rpc SetMinGpus (, )
job.proto:279Sets the minimum number of Gpu that can run on this job
message
job.proto:1472SetMinGpus
optional job = 1
int32 val = 2
message
job.proto:1477(message has no fields)
rpc SetPriority (, )
job.proto:282Sets the job priority
message
job.proto:1480SetPriority
optional job = 1
int32 val = 2
message
job.proto:1485(message has no fields)
rpc ShutdownIfCompleted (, )
job.proto:286Shutdown the job if it is completed. This is a workaround for when Cuebot failed to shutdown a job due to database access error.
message
job.proto:1488ShutdownIfCompleted
optional job = 1
message
job.proto:1492(message has no fields)
rpc StaggerFrames (, )
job.proto:289Staggers the specified frame range
message
job.proto:1495StaggerFrames
optional job = 1
string range = 2
int32 stagger = 3
message
job.proto:1501(message has no fields)
service LayerInterface
job.proto:292rpc AddLimit (, )
job.proto:294Add Limit to the Layer
message
job.proto:1506LAYER ---- AddLimit
optional layer = 1
string limit_id = 2
message
job.proto:1511(message has no fields)
rpc AddRenderPartition (, )
job.proto:297Add RenderPartition to Layer
message
job.proto:1514AddRenderPartion
optional layer = 1
string host = 2
int32 threads = 3
int32 max_cores = 4
int64 max_memory = 5
int64 max_gpu_memory = 6
string username = 7
int32 max_gpus = 8
message
job.proto:1525optional render_partition = 1
rpc CreateDependencyOnFrame (, )
job.proto:300Setup and return a LayerOnFrame dependency
message
job.proto:1530CreateDependencyOnFrame
optional layer = 1
optional frame = 2
message
job.proto:1535optional depend = 1
rpc CreateDependencyOnJob (, )
job.proto:303Setup and return a LayerOnJob dependency
message
job.proto:1540CreateDependencyOnJob
optional layer = 1
optional job = 2
message
job.proto:1545optional depend = 1
rpc CreateDependencyOnLayer (, )
job.proto:306Setup and return a LayerOnLayer dependency
message
job.proto:1550CreateDependencyOnLayer
optional layer = 1
optional depend_on_layer = 2
message
job.proto:1555optional depend = 1
Setup and return a FrameByFrame dependency
message
job.proto:1560CreateFrameByFrameDependency
optional layer = 1
optional depend_layer = 2
bool any_frame = 3
message
job.proto:1566optional depend = 1
rpc DropDepends (, )
job.proto:312Drops every dependency that is causing this layer not to run.
message
job.proto:1571DropDepends
optional layer = 1
depend.DependTarget target = 2
message
job.proto:1576(message has no fields)
rpc DropLimit (, )
job.proto:315Drop the limit from the specified layer.
message
job.proto:1579DropLimit
optional layer = 1
string limit_id = 2
message
job.proto:1584(message has no fields)
rpc EatFrames (, )
job.proto:318Eat the Frames of this Layer
message
job.proto:1587EatFrames
optional layer = 1
message
job.proto:1591(message has no fields)
rpc EnableMemoryOptimizer (, )
job.proto:321When disabled, This will stop Cuebot from lowering the amount of memory required for a given layer.
message
job.proto:1594EnableMemoryOptimizer
optional layer = 1
bool value = 2
message
job.proto:1599(message has no fields)
rpc FindLayer (, )
job.proto:324Finds a layer in a pending job based the job and layer name
message
job.proto:1602FindLayer
string job = 1
string layer = 2
message
job.proto:1607optional layer = 1
rpc GetFrames (, )
job.proto:327Get the frames that match the FrameSearchCriteria
message
job.proto:1612GetFrames
optional layer = 1
optional s = 2
message
job.proto:1617optional frames = 1
rpc GetLayer (, )
job.proto:330Finds a layer in a pending job from its unique ID
message
job.proto:1622GetLayer
string id = 1
message
job.proto:1626optional layer = 1
rpc GetLimits (, )
job.proto:333Return a list of the limits on the specified layer.
message
job.proto:1631GetLayer
optional layer = 1
message
job.proto:1635repeated limits = 1
rpc GetOutputPaths (, )
job.proto:336Return a list of all registered output paths.
message
job.proto:1640GetOutputPaths
optional layer = 1
message
job.proto:1644repeated string output_paths = 1
rpc GetWhatThisDependsOn (, )
job.proto:339Returns a list of dependencies that this frame depends on.
message
job.proto:1658GetWhatThisDependsOn
optional layer = 1
message
job.proto:1662optional depends = 1
rpc GetWhatDependsOnThis (, )
job.proto:344Returns a list of dependencies setup to depend on this layer. This includes all types of depends, not just OnLayer dependencies. This will not return any frame on frame dependencies that are part of a FrameByFrame depend. It will return a single element that represents the entire dependency.
message
job.proto:1649GetWhatDependsOnThis
optional layer = 1
message
job.proto:1653optional depends = 1
rpc KillFrames (, )
job.proto:347Kill Frames associated with this layer
message
job.proto:1667KillFrames
optional layer = 1
string username = 2
string pid = 3
string host_kill = 4
string reason = 5
message
job.proto:1675(message has no fields)
rpc MarkdoneFrames (, )
job.proto:350Mark the frames of this layer done
message
job.proto:1678MarkdoneFrames
optional layer = 1
message
job.proto:1682(message has no fields)
rpc RegisterOutputPath (, )
job.proto:353Register an output with the given layer. The output paths are sent in the opencue email.
message
job.proto:1692RegisterOutputPath
optional layer = 1
string spec = 2
message
job.proto:1697(message has no fields)
rpc ReorderFrames (, )
job.proto:356Reorders the specified frame range on this job.
message
job.proto:1700ReorderFrames
optional layer = 1
string range = 2
Order order = 3
message
job.proto:1706(message has no fields)
rpc RetryFrames (, )
job.proto:359Retry the Frames of this Layer
message
job.proto:1685RetryFrames
optional layer = 1
message
job.proto:1689(message has no fields)
rpc SetMaxCores (, )
job.proto:363The maximum number of cores to run on a given frame within this layer. Fractional core values are not allowed with this setting.
message
job.proto:1709SetMaxCores
optional layer = 1
float cores = 2
message
job.proto:1714(message has no fields)
rpc SetMinCores (, )
job.proto:366Set the Min Cores for this layer
message
job.proto:1717SetMinCores
optional layer = 1
float cores = 2
message
job.proto:1722(message has no fields)
rpc SetMaxGpus (, )
job.proto:369The maximum number of Gpu to run on a given frame within this layer.
message
job.proto:1734SetMaxGpus
optional layer = 1
int32 max_gpus = 2
message
job.proto:1739(message has no fields)
rpc SetMinGpus (, )
job.proto:372Set the Min Gpus for this layer
message
job.proto:1742SetMinGpus
optional layer = 1
int32 min_gpus = 2
message
job.proto:1747(message has no fields)
rpc SetMinGpuMemory (, )
job.proto:375Set the Min gpu memory value for the layer
message
job.proto:1750SetMinGpuMemory
optional layer = 1
int64 gpu_memory = 2
message
job.proto:1755(message has no fields)
rpc SetMinGpu (, )
job.proto:378[Deprecated] Set the Min gpu memory value for the layer
message
job.proto:1725[Deprecated] SetMinGpu
optional layer = 1
int64 gpu = 2
message
job.proto:1731[Deprecated]
(message has no fields)
rpc SetMinMemory (, )
job.proto:381Set the Min Memory value for the layer
message
job.proto:1758SetMinMemory
optional layer = 1
int64 memory = 2
message
job.proto:1763(message has no fields)
rpc SetTags (, )
job.proto:384Set tags on the layer
message
job.proto:1766SetTags
optional layer = 1
repeated string tags = 2
message
job.proto:1771(message has no fields)
rpc SetThreadable (, )
job.proto:387Set whether the layer is threadable or not
message
job.proto:1774SetThreadable
optional layer = 1
bool threadable = 2
message
job.proto:1779(message has no fields)
rpc SetTimeout (, )
job.proto:390Set whether the timeout for frames in the layer
message
job.proto:1782SetTimeout
optional layer = 1
int32 timeout = 2
message
job.proto:1787(message has no fields)
rpc SetTimeoutLLU (, )
job.proto:393Set whether the LLU timeout for frames in the layer
message
job.proto:1790SetTimeoutLLU
optional layer = 1
int32 timeout_llu = 2
message
job.proto:1795(message has no fields)
rpc StaggerFrames (, )
job.proto:396Staggers the specified frame range.
message
job.proto:1799StaggerFrames
optional layer = 1
string range = 2
int32 stagger = 3
message
job.proto:1805(message has no fields)
Define the possible checkpoint states for a frame.
Used in: ,
DISABLED = 0
ENABLED = 1
COPYING = 2
COMPLETE = 3
message
job.proto:499FRAME ----
Used in: , , , , , , , , , , , , , , , , , , , ,
string id = 1
string name = 2
string layer_name = 3
int32 number = 4
FrameState state = 5
int32 retry_count = 6
int32 exit_status = 7
int32 dispatch_order = 8
int32 start_time = 9
int32 stop_time = 10
int64 max_rss = 11
int64 used_memory = 12
int64 reserved_memory = 13
int64 reserved_gpu_memory = 14
string last_resource = 15
CheckpointState checkpoint_state = 16
int32 checkpoint_count = 17
int32 total_core_time = 18
int32 llu_time = 19
int32 total_gpu_time = 20
int64 max_gpu_memory = 21
int64 used_gpu_memory = 22
optional frame_state_display_override = 23
These frame exit status values are used to trigger special dispatcher behavior. They are greater than 255 so they don't collide with any real exit status values used by applications running on the cue.
SUCCESS = 0
The frame was a success
FAILED_LAUNCH = 256
The frame should be automatically retried
SKIP_RETRY = 286
Retries should not be incremented
message
job.proto:526Object for frame searching
Used in: , , , , , , ,
repeated string ids = 1
repeated string frames = 2
repeated string layers = 3
optional states = 4
string frame_range = 5
string memory_range = 6
string duration_range = 7
int32 page = 8
int32 limit = 9
int32 change_date = 10
int32 max_results = 11
int32 offset = 12
bool include_finished = 13
message
job.proto:543A sequence of Frames
Used in: , ,
repeated frames = 1
Defines the possible states of a frame.
Used in: , , ,
WAITING = 0
Ok to be dispatched
SETUP = 1
Reserved to be dispatched
RUNNING = 2
Running on a render proc
SUCCEEDED = 3
Frame completed successfully
DEPEND = 4
Frame is waiting on a dependency
DEAD = 5
Frame is dead,which means it has died N times
EATEN = 6
Frame is eaten, acts like the frame has succeeded
CHECKPOINT = 7
Frame is checkpointing
message
job.proto:482Object to contain an override of the frame's display settings
Used in: , , ,
FrameState state = 1
the FrameState to override
string text = 2
the text to use
optional color = 3
RGB color to use e.g. 255,0,0
message
job.proto:486Used in:
int32 red = 1
int32 green = 2
int32 blue = 3
message
job.proto:494Used in:
repeated overrides = 1
message
job.proto:548A sequence of FrameStates
Used in:
repeated FrameState frame_states = 1
message
job.proto:586GROUP ----
Used in: , , , , , , , , , , , , , , , , , , , , , , , ,
string id = 1
string name = 2
string department = 3
int32 default_job_priority = 4
float default_job_min_cores = 5
float default_job_max_cores = 6
float min_cores = 7
float max_cores = 8
int32 level = 9
string parent_id = 10
optional group_stats = 11
float default_job_min_gpus = 12
float default_job_max_gpus = 13
float min_gpus = 14
float max_gpus = 15
message
job.proto:604Used in: , ,
repeated groups = 1
message
job.proto:608Used in: ,
int32 running_frames = 1
int32 dead_frames = 2
int32 depend_frames = 3
int32 waiting_frames = 4
int32 pending_jobs = 5
float reserved_cores = 6
float reserved_gpus = 7
message
job.proto:619JOB ----
Used in: , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , ,
string id = 1
JobState state = 2
string name = 3
string shot = 4
string show = 5
string user = 6
string group = 7
string facility = 8
string os = 9
oneof uid_optional
int32 uid = 10
int32 priority = 11
float min_cores = 12
float max_cores = 13
string log_dir = 14
bool is_paused = 15
bool has_comment = 16
bool auto_eat = 17
int32 start_time = 18
int32 stop_time = 19
optional job_stats = 20
float min_gpus = 21
float max_gpus = 22
string loki_url = 23
message
job.proto:648Use to filter the job search. Please note that by searching for non-pending jobs, the output is limited to 200 jobs
Used in: ,
repeated string ids = 1
repeated string jobs = 2
repeated string regex = 3
repeated string substr = 4
repeated string users = 5
repeated string shots = 6
repeated string shows = 7
bool include_finished = 8
message
job.proto:659Used in: , , , , , ,
repeated jobs = 1
Defines the possible states of a job.
Used in: , , ,
PENDING = 0
Job is running
FINISHED = 1
The job has completed
STARTUP = 2
The job is in the process of starting up
SHUTDOWN = 3
The job is in the process of shutting down
POSTED = 4
The job is a post job and is waiting to go pending
message
job.proto:663Used in: ,
int32 total_layers = 1
int32 total_frames = 2
int32 waiting_frames = 3
int32 running_frames = 4
int32 dead_frames = 5
int32 eaten_frames = 6
int32 depend_frames = 7
int32 succeeded_frames = 8
int32 pending_frames = 9
int32 avg_frame_sec = 10
int32 high_frame_sec = 11
int32 avg_core_sec = 12
int64 rendered_frame_count = 13
int64 failed_frame_count = 14
int64 remaining_core_sec = 15
int64 total_core_sec = 16
int64 rendered_core_sec = 17
int64 failed_core_sec = 18
int64 max_rss = 19
float reserved_cores = 20
int64 total_gpu_sec = 21
int64 rendered_gpu_sec = 22
int64 failed_gpu_sec = 23
float reserved_gpus = 24
int64 max_gpu_memory = 25
message
job.proto:692LAYER ----
Used in: , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , ,
string id = 1
string name = 2
string range = 3
repeated string tags = 4
float min_cores = 5
float max_cores = 6
bool is_threadable = 7
int64 min_memory = 8
int64 min_gpu_memory = 9
int32 chunk_size = 10
int32 dispatch_order = 11
LayerType type = 12
repeated string services = 13
An array of services that are being run on all frames within this layer.
bool memory_optimizer_enabled = 14
True if the memory optimizer is enabled. Disabling the optimizer will stop Cuebot from lowering memory.
optional layer_stats = 15
string parent_id = 16
repeated string limits = 17
int32 timeout = 18
int32 timeout_llu = 19
float min_gpus = 20
float max_gpus = 21
string command = 22
message
job.proto:719Used in: ,
repeated layers = 1
message
job.proto:723Used in:
int32 total_frames = 1
int32 waiting_frames = 2
int32 running_frames = 3
int32 dead_frames = 4
int32 eaten_frames = 5
int32 depend_frames = 6
int32 succeeded_frames = 7
int32 pending_frames = 8
int32 avg_frame_sec = 9
int32 low_frame_sec = 10
int32 high_frame_sec = 11
int32 avg_core_sec = 12
int64 rendered_frame_count = 13
int64 failed_frame_count = 14
int64 remaining_core_sec = 15
int64 total_core_sec = 16
int64 rendered_core_sec = 17
int64 failed_core_sec = 18
int64 max_rss = 19
float reserved_cores = 20
int64 total_gpu_sec = 21
int64 rendered_gpu_sec = 22
int64 failed_gpu_sec = 23
float reserved_gpus = 24
int64 max_gpu_memory = 25
The LayerType determines the type of the layer. A proc will not run frames from different layers UNLESS the layer type is PreProcess or PostProcess. This gives us the ability to run all the preprocesses on one proc and all the post processes on one proc. There is no specific dispatch order for layer types. You will need to setup dependencies.
Used in:
PRE = 0
POST = 1
RENDER = 2
UTIL = 3
message
job.proto:752NestedGroup ---
Used in: , ,
string id = 1
string name = 2
string department = 3
int32 default_job_priority = 4
float default_job_min_cores = 5
float default_job_max_cores = 6
float min_cores = 7
float max_cores = 8
int32 level = 9
optional parent = 10
optional groups = 11
repeated string jobs = 12
optional stats = 13
float default_job_min_gpus = 14
float default_job_max_gpus = 15
float min_gpus = 16
float max_gpus = 17
message
job.proto:772Used in:
repeated nested_groups = 1
message
job.proto:777NESTED JOB ----
string id = 1
JobState state = 2
string name = 3
string shot = 4
string show = 5
string user = 6
string group = 7
string facility = 8
string os = 9
oneof uid_optional
int32 uid = 10
int32 priority = 11
float min_cores = 12
float max_cores = 13
string log_dir = 14
bool is_paused = 15
bool has_comment = 16
bool auto_eat = 17
int32 start_time = 18
int32 stop_time = 19
optional parent = 20
optional stats = 21
float min_gpus = 22
float max_gpus = 23
enum Order
job.proto:469Used for reordering frames.
Used in: ,
FIRST = 0
Moves frames to the lowest dispatch order
LAST = 1
Moves frames to the last dispatch order
REVERSE = 2
Reverses the dispatch order
message
job.proto:555A struct containing properties for all the elements of a frame that can change except for the ID which is there for indexing purposes.
Used in:
string id = 1
FrameState state = 2
int32 retry_count = 3
int32 exit_status = 4
int32 start_time = 5
int32 stop_time = 6
int64 max_rss = 7
int64 used_memory = 8
string last_resource = 9
int32 llu_time = 10
int64 max_gpu_memory = 11
int64 used_gpu_memory = 12
optional frame_state_display_override = 13
message
job.proto:579The result of an updated frame check. The job state is included so tools that are just monitoring frames can stop monitoring them once the job state changes to Finished.
JobState state = 1
int32 server_time = 2
optional updated_frames = 3
message
job.proto:571Used in: ,
repeated updated_frames = 1