AdminTemp is a prelimiary set of administration tasks. It’s called “Temp”
because we do not yet know the best way to represent admin tasks; it’s
possible that this will be entirely replaced in later versions of this API.
If this message proves to be sufficient, it will be renamed in the alpha or
beta release of this API.
Describes a blob of binary content with its digest.
A bot session represents the state of a bot while in continuous contact with
the server for a period of time. The session includes information about the
worker - that is, the worker (the physical or virtual hardware) is
considered to be a property of the bot (the software agent running on that
hardware), which is the reverse of real life, but more natural from the point
of the view of this API, which communicates solely with the bot and not
directly with the underlying worker.
DEPRECATED - use CommandResult instead.
Describes the actual outputs from the task.
DEPRECATED - use CommandResult instead.
Can be used as part of CompleteRequest.metadata, or are part of a more
sophisticated message.
All information about the execution of a command, suitable for providing as
the Bots interface’s Lease.result
field.
Describes a shell-style task to execute, suitable for providing as the Bots
interface’s Lease.payload
field.
Request message for CreateBotSession.
Any device, including computers, phones, accelerators (e.g. GPUs), etc. All
names must be unique.
The CommandTask and CommandResult messages assume the existence of a service
that can serve blobs of content, identified by a hash and size known as a
“digest.” The method by which these blobs may be retrieved is not specified
here, but a model implementation is in the Remote Execution API’s
“ContentAddressibleStorage” interface.
The contents of a directory. Similar to the equivalent message in the Remote
Execution API.
The metadata for a directory. Similar to the equivalent message in the Remote
Execution API.
The metadata for a file. Similar to the equivalent message in the Remote
Execution API.
A Lease is a lease that the scheduler has assigned to this bot. If the bot
notices (by UpdateBotSession) that it has any leases in the PENDING state, it
should call UpdateBotSession to put the leases into the ACTIVE state and
start executing their assignments.
Request message for UpdateBotSession.
Describes a worker, which is a list of one or more devices and the
connections between them. A device could be a computer, a phone, or even an
accelerator like a GPU; it’s up to the farm administrator to decide how to
model their farm. For example, if a farm only has one type of GPU, the GPU
could be modelled as a “has_gpu” property on its host computer; if it has
many subproperties itself, it might be better to model it as a separate
device.