Skip to main content
Version: v1.0.0

action.v1

Version: 1.5.0

Available Services

    ActionArgConfigService

    ActionConfigService

    ActionRunConfigService

    ActionRunService

    ActionService

Top

arista/action.v1/action.proto

Action

Action is the state model of an action.

Field NameTypeDescription
keyActionKey

key uniquely identifies the action.

coreActionCore

core contains some common attributes (state/config) of the action.

auditActionAudit

audit contains meta information about the action.

languageActionLanguage

language specifies the language of the action body, if applicable.

bodygoogle.protobuf.StringValue

body contains the action code (script), if applicable.

ActionArgConfig

ActionArgConfig is the model for the definition of static arguments

Field NameTypeDescription
keyActionKey

key uniquely identifies the action to which the arguments apply.

static_argsActionArgValues

static_args contains the arguments that are to be applied to all subsequent runs

of the action. Argument names and values must adhere to the ActionSchema static_args.

When retrieving values of the arguments that had been set, but which are defined as

hidden in ActionSchema static_args, fake hardcoded values are returned instead

of the real values.

ActionArgDefinition

ActionArgDefinition is the definition of an argument (static or dynamic).

Field NameTypeDescription
requiredgoogle.protobuf.BoolValue

required indicates that this argument must always be set when calling the action.

defaultActionArgValue

default is the default value for this argument. If set to null, there is no default

value.

descriptiongoogle.protobuf.StringValue

description is a user-friendly description of the argument.

hiddengoogle.protobuf.BoolValue

hidden can be set to true to indicate that the value of this argument can be set, but not

retrieved from this API.

ActionArgValue

ActionArgValue contains the value of one argument of an action.

Field NameTypeDescription
valuegoogle.protobuf.StringValue

value is the string value to set the argument for runtime.

ActionArgValues

ActionArgValues contains the values of the arguments of an action.

Field NameTypeDescription
valuesActionArgValues.ValuesEntry[...]

values is a map of arg name to value.

ActionArgValues.ValuesEntry

Field NameTypeDescription
keystring

valueActionArgValue

ActionAudit

ActionAudit contains additional information for the Action state model.

Field NameTypeDescription
created_atgoogle.protobuf.Timestamp

created_at records the time when the action was originally created.

created_bygoogle.protobuf.StringValue

created_by records the user who created the action.

last_modified_atgoogle.protobuf.Timestamp

last_modified_at records the time when the action was most recently modified.

last_modified_bygoogle.protobuf.StringValue

last_modified_by records the user who most recently modified the action.

from_packagegoogle.protobuf.StringValue

from_package indicates that this action was created by a package, and can only be modified

by the packaging service.

ActionConfig

ActionConfig is the config of an action. Unimplemented for builtin actions

Field NameTypeDescription
keyActionKey

key uniquely identifies the action.

coreActionCore

core contains some common attributes (state/config) of the action.

languageActionLanguage

language specifies the language of the action body, if applicable.

bodygoogle.protobuf.StringValue

body contains the action code (script), if applicable.

ActionCore

ActionCore contains the core fields of an action.

Field NameTypeDescription
namegoogle.protobuf.StringValue

name is the user-friendly name of the action.

typeActionType

type is the specific type of the action.

descriptiongoogle.protobuf.StringValue

description is a user-friendly description of the action.

static_argsActionSchema

static_args defines arguments which can be permanently changed for subsequent runs

of this action (set ActionArgConfig to accomplish that). The names of arguments in

static_args cannot also appear in dynamic_args.

dynamic_argsActionSchema

dynamic_args defines arguments which are scoped to a specific run of the action.

The names of arguments in dynamic_args cannot also appear in static_args.

ActionKey

ActionKey is the model key of an action.

Field NameTypeDescription
idgoogle.protobuf.StringValue

id uniquely identifies the action. Although chosen by the caller, it is recommended

to be a random UUID.

ActionRun

ActionRun is the state of a single run (single execution) of an action.

Field NameTypeDescription
keyActionRunKey

key uniquely identifies the ActionRun and the corresponding ActionRunConfig.

action_idgoogle.protobuf.StringValue

action_id uniquely identifies the Action being run.

created_atgoogle.protobuf.Timestamp

created_at records the time when the action run has been requested.

created_bygoogle.protobuf.StringValue

created_by records the user who requested the action execution.

finished_atgoogle.protobuf.Timestamp

finished_at records the time when the action finished running.

is_finishedgoogle.protobuf.BoolValue

is_finished is true only when the action has finished running and the fields code,

output, error, and finished_at are assigned their final values.

codegoogle.protobuf.Int32Value

code contains the exit code of the action.

The code may be ignored if error is empty or nil.

outputgoogle.protobuf.StringValue

output contains the output produced by the action, truncated to the first 100,000 bytes.

errorgoogle.protobuf.StringValue

error contains a failure description for unsuccessful runs, either caused by the body

or by the execution environment.

Often it is a python traceback which contains multiple newline characters.

Maximum size is 100,000 bytes.

ActionRunConfig

ActionRunConfig is the configuration of a single execution of an action. Creating a record under a new key triggers a run. Attempting to set again an existing entry is an error.

Field NameTypeDescription
keyActionRunKey

key uniquely identifies the ActionRunConfig and the corresponding ActionRun.

action_idgoogle.protobuf.StringValue

action_id uniquely identifies the Action being run.

dynamic_argsActionArgValues

dynamic_args contains the values of dynamic arguments defined for the action.

ActionRunKey

ActionRunKey is the model key that can uniquely identify an action run.

Field NameTypeDescription
run_idgoogle.protobuf.StringValue

run_id uniquely identifies an action run

ActionSchema

ActionSchema is the schema of an action. Corresponds to the definition of multiple arguments.

Field NameTypeDescription
valuesActionSchema.ValuesEntry[...]

values is a map of argument name to its defintion.

ActionSchema.ValuesEntry

Field NameTypeDescription
keystring

valueActionArgDefinition

ActionLanguage

ActionLanguage is the language of an action.

NameNumberDescription
ACTION_LANGUAGE_UNSPECIFIED0

ACTION_LANGUAGE_UNSPECIFIED is the default value for this type.

ACTION_LANGUAGE_PYTHON_21

ACTION_LANGUAGE_PYTHON_2 indicates that the action body follows Python 2.x syntax.

ACTION_LANGUAGE_PYTHON_32

ACTION_LANGUAGE_PYTHON_3 indicates that the action body follows Python 3.x syntax.

ACTION_LANGUAGE_GO_TEMPLATE3

ACTION_LANGUAGE_GO_TEMPLATE indicates that the action body is a Go language template

(e.g. as used in ZTP).

ActionType

ActionType is the type of an action.

NameNumberDescription
ACTION_TYPE_UNSPECIFIED0

ACTION_TYPE_UNSPECIFIED is the default value for this type.

ACTION_TYPE_CHANGECONTROL_CUSTOM1

ACTION_TYPE_CHANGECONTROL_CUSTOM indicates a scripted action that can be used as part of

a change control.

ACTION_TYPE_CHANGECONTROL_BUILT_IN2

ACTION_TYPE_CHANGECONTROL_BUILT_IN indicates a built-in action with no scripted component

which can be used as part of a change control.

ACTION_TYPE_STUDIO_AUTOFILL3

ACTION_TYPE_STUDIO_AUTOFILL is an action which can be bound to an input in a studio.

ACTION_TYPE_PACKAGING_INSTALL_HOOK4

ACTION_TYPE_PACKAGING_INSTALL_HOOK is a type of Action which can run during package lifecycle

events (e.g. pre-install or post-uninstall) to handle any migration or configuration changes

that need to happen for a Package to be (un)installed successfully.

ACTION_TYPE_ZTP_BOOTSTRAP5

ACTION_TYPE_ZTP_BOOTSTRAP is a type of Action which can be used to bootstrap a device.

ACTION_TYPE_STUDIO_BUILD_HOOK6

ACTION_TYPE_STUDIO_BUILD_HOOK is a type of Action which can run at various points in a

workspace build pipeline (e.g. workspace pre-build, studio pre-render), facilitating

customization of the workspace build beyond the standard process. Build hooks in a given

stage can express dependencies on each other which allows ordering of the actions' execution.

For ACTION_TYPE_STUDIO_BUILD_HOOK each hook invocation will provide the following

arguments:

* WorkspaceID (mandatory): the ID of the Workspace

* StudioID (optional, if running in the context of a Studio): the ID of the Studio

Top

arista/action.v1/services.gen.proto

ActionArgConfigDeleteAllRequest

Field NameTypeDescription
partial_eq_filterActionArgConfig[...]

PartialEqFilter provides a way to server-side filter a DeleteAll.

This requires all provided fields to be equal to the response.

A filtered DeleteAll will use GetAll with filter to find things to delete.

ActionArgConfigDeleteAllResponse

Field NameTypeDescription
typefmp.DeleteError

This describes the class of delete error.

A DeleteAllResponse is only sent when there is an error.

errorgoogle.protobuf.StringValue

This indicates the error message from the delete failure.

keyActionKey

This is the key of the ActionArgConfig instance that failed to be deleted.

timegoogle.protobuf.Timestamp

Time indicates the (UTC) timestamp when the key was being deleted.

ActionArgConfigDeleteRequest

Field NameTypeDescription
keyActionKey

Key indicates which ActionArgConfig instance to remove.

This field must always be set.

ActionArgConfigDeleteResponse

Field NameTypeDescription
keyActionKey

Key echoes back the key of the deleted ActionArgConfig instance.

timegoogle.protobuf.Timestamp

Time indicates the (UTC) timestamp at which the system recognizes the

deletion. The only guarantees made about this timestamp are:

- it is after the time the request was received

- a time-ranged query with StartTime==DeletedAt will not include this instance.

ActionArgConfigDeleteSomeRequest

Field NameTypeDescription
keysActionKey[...]

key contains a list of ActionArgConfig keys to delete

ActionArgConfigDeleteSomeResponse

ActionArgConfigDeleteSomeResponse is only sent when there is an error.

Field NameTypeDescription
keyActionKey

errorstring

ActionArgConfigRequest

Field NameTypeDescription
keyActionKey

Key uniquely identifies a ActionArgConfig instance to retrieve.

This value must be populated.

timegoogle.protobuf.Timestamp

Time indicates the time for which you are interested in the data.

If no time is given, the server will use the time at which it makes the request.

ActionArgConfigResponse

Field NameTypeDescription
valueActionArgConfig

Value is the value requested.

This structure will be fully-populated as it exists in the datastore. If

optional fields were not given at creation, these fields will be empty or

set to default values.

timegoogle.protobuf.Timestamp

Time carries the (UTC) timestamp of the last-modification of the

ActionArgConfig instance in this response.

ActionArgConfigSetRequest

Field NameTypeDescription
valueActionArgConfig

ActionArgConfig carries the value to set into the datastore.

See the documentation on the ActionArgConfig struct for which fields are required.

ActionArgConfigSetResponse

Field NameTypeDescription
valueActionArgConfig

Value carries all the values given in the ActionArgConfigSetRequest as well

as any server-generated values.

timegoogle.protobuf.Timestamp

Time indicates the (UTC) timestamp at which the system recognizes the

creation. The only guarantees made about this timestamp are:

- it is after the time the request was received

- a time-ranged query with StartTime==CreatedAt will include this instance.

ActionArgConfigSetSomeRequest

Field NameTypeDescription
valuesActionArgConfig[...]

value contains a list of ActionArgConfig values to write.

It is possible to provide more values than can fit within either:

- the maxiumum send size of the client

- the maximum receive size of the server

If this error occurs you must reduce the number of values sent.

See gRPC "maximum message size" documentation for more information.

ActionArgConfigSetSomeResponse

Field NameTypeDescription
keyActionKey

errorstring

ActionArgConfigSomeRequest

Field NameTypeDescription
keysActionKey[...]

timegoogle.protobuf.Timestamp

Time indicates the time for which you are interested in the data.

If no time is given, the server will use the time at which it makes the request.

ActionArgConfigSomeResponse

Field NameTypeDescription
valueActionArgConfig

Value is the value requested.

This structure will be fully-populated as it exists in the datastore. If

optional fields were not given at creation, these fields will be empty or

set to default values.

errorgoogle.protobuf.StringValue

Error is an optional field.

It should be filled when there is an error in the GetSome process.

timegoogle.protobuf.Timestamp

ActionArgConfigStreamRequest

Field NameTypeDescription
partial_eq_filterActionArgConfig[...]

PartialEqFilter provides a way to server-side filter a GetAll/Subscribe.

This requires all provided fields to be equal to the response.

While transparent to users, this field also allows services to optimize internal

subscriptions if filter(s) are sufficiently specific.

timearista.time.TimeBounds

TimeRange allows limiting response data to within a specified time window.

If this field is populated, at least one of the two time fields are required.

For GetAll, the fields start and end can be used as follows:

* end: Returns the state of each ActionArgConfig at end.

* Each ActionArgConfig response is fully-specified (all fields set).

* start: Returns the state of each ActionArgConfig at start, followed by updates until now.

* Each ActionArgConfig response at start is fully-specified, but updates may be partial.

* start and end: Returns the state of each ActionArgConfig at start, followed by updates

until end.

* Each ActionArgConfig response at start is fully-specified, but updates until end may

be partial.

This field is not allowed in the Subscribe RPC.

ActionArgConfigStreamResponse

Field NameTypeDescription
valueActionArgConfig

Value is a value deemed relevant to the initiating request.

This structure will always have its key-field populated. Which other fields are

populated, and why, depends on the value of Operation and what triggered this notification.

timegoogle.protobuf.Timestamp

Time holds the timestamp of this ActionArgConfig's last modification.

typearista.subscriptions.Operation

Operation indicates how the ActionArgConfig value in this response should be considered.

Under non-subscribe requests, this value should always be INITIAL. In a subscription,

once all initial data is streamed and the client begins to receive modification updates,

you should not see INITIAL again.

ActionConfigDeleteAllRequest

Field NameTypeDescription
partial_eq_filterActionConfig[...]

PartialEqFilter provides a way to server-side filter a DeleteAll.

This requires all provided fields to be equal to the response.

A filtered DeleteAll will use GetAll with filter to find things to delete.

ActionConfigDeleteAllResponse

Field NameTypeDescription
typefmp.DeleteError

This describes the class of delete error.

A DeleteAllResponse is only sent when there is an error.

errorgoogle.protobuf.StringValue

This indicates the error message from the delete failure.

keyActionKey

This is the key of the ActionConfig instance that failed to be deleted.

timegoogle.protobuf.Timestamp

Time indicates the (UTC) timestamp when the key was being deleted.

ActionConfigDeleteRequest

Field NameTypeDescription
keyActionKey

Key indicates which ActionConfig instance to remove.

This field must always be set.

ActionConfigDeleteResponse

Field NameTypeDescription
keyActionKey

Key echoes back the key of the deleted ActionConfig instance.

timegoogle.protobuf.Timestamp

Time indicates the (UTC) timestamp at which the system recognizes the

deletion. The only guarantees made about this timestamp are:

- it is after the time the request was received

- a time-ranged query with StartTime==DeletedAt will not include this instance.

ActionConfigDeleteSomeRequest

Field NameTypeDescription
keysActionKey[...]

key contains a list of ActionConfig keys to delete

ActionConfigDeleteSomeResponse

ActionConfigDeleteSomeResponse is only sent when there is an error.

Field NameTypeDescription
keyActionKey

errorstring

ActionConfigRequest

Field NameTypeDescription
keyActionKey

Key uniquely identifies a ActionConfig instance to retrieve.

This value must be populated.

timegoogle.protobuf.Timestamp

Time indicates the time for which you are interested in the data.

If no time is given, the server will use the time at which it makes the request.

ActionConfigResponse

Field NameTypeDescription
valueActionConfig

Value is the value requested.

This structure will be fully-populated as it exists in the datastore. If

optional fields were not given at creation, these fields will be empty or

set to default values.

timegoogle.protobuf.Timestamp

Time carries the (UTC) timestamp of the last-modification of the

ActionConfig instance in this response.

ActionConfigSetRequest

Field NameTypeDescription
valueActionConfig

ActionConfig carries the value to set into the datastore.

See the documentation on the ActionConfig struct for which fields are required.

ActionConfigSetResponse

Field NameTypeDescription
valueActionConfig

Value carries all the values given in the ActionConfigSetRequest as well

as any server-generated values.

timegoogle.protobuf.Timestamp

Time indicates the (UTC) timestamp at which the system recognizes the

creation. The only guarantees made about this timestamp are:

- it is after the time the request was received

- a time-ranged query with StartTime==CreatedAt will include this instance.

ActionConfigSetSomeRequest

Field NameTypeDescription
valuesActionConfig[...]

value contains a list of ActionConfig values to write.

It is possible to provide more values than can fit within either:

- the maxiumum send size of the client

- the maximum receive size of the server

If this error occurs you must reduce the number of values sent.

See gRPC "maximum message size" documentation for more information.

ActionConfigSetSomeResponse

Field NameTypeDescription
keyActionKey

errorstring

ActionConfigSomeRequest

Field NameTypeDescription
keysActionKey[...]

timegoogle.protobuf.Timestamp

Time indicates the time for which you are interested in the data.

If no time is given, the server will use the time at which it makes the request.

ActionConfigSomeResponse

Field NameTypeDescription
valueActionConfig

Value is the value requested.

This structure will be fully-populated as it exists in the datastore. If

optional fields were not given at creation, these fields will be empty or

set to default values.

errorgoogle.protobuf.StringValue

Error is an optional field.

It should be filled when there is an error in the GetSome process.

timegoogle.protobuf.Timestamp

ActionConfigStreamRequest

Field NameTypeDescription
partial_eq_filterActionConfig[...]

PartialEqFilter provides a way to server-side filter a GetAll/Subscribe.

This requires all provided fields to be equal to the response.

While transparent to users, this field also allows services to optimize internal

subscriptions if filter(s) are sufficiently specific.

timearista.time.TimeBounds

TimeRange allows limiting response data to within a specified time window.

If this field is populated, at least one of the two time fields are required.

For GetAll, the fields start and end can be used as follows:

* end: Returns the state of each ActionConfig at end.

* Each ActionConfig response is fully-specified (all fields set).

* start: Returns the state of each ActionConfig at start, followed by updates until now.

* Each ActionConfig response at start is fully-specified, but updates may be partial.

* start and end: Returns the state of each ActionConfig at start, followed by updates

until end.

* Each ActionConfig response at start is fully-specified, but updates until end may

be partial.

This field is not allowed in the Subscribe RPC.

ActionConfigStreamResponse

Field NameTypeDescription
valueActionConfig

Value is a value deemed relevant to the initiating request.

This structure will always have its key-field populated. Which other fields are

populated, and why, depends on the value of Operation and what triggered this notification.

timegoogle.protobuf.Timestamp

Time holds the timestamp of this ActionConfig's last modification.

typearista.subscriptions.Operation

Operation indicates how the ActionConfig value in this response should be considered.

Under non-subscribe requests, this value should always be INITIAL. In a subscription,

once all initial data is streamed and the client begins to receive modification updates,

you should not see INITIAL again.

ActionRequest

Field NameTypeDescription
keyActionKey

Key uniquely identifies a Action instance to retrieve.

This value must be populated.

timegoogle.protobuf.Timestamp

Time indicates the time for which you are interested in the data.

If no time is given, the server will use the time at which it makes the request.

ActionResponse

Field NameTypeDescription
valueAction

Value is the value requested.

This structure will be fully-populated as it exists in the datastore. If

optional fields were not given at creation, these fields will be empty or

set to default values.

timegoogle.protobuf.Timestamp

Time carries the (UTC) timestamp of the last-modification of the

Action instance in this response.

ActionRunConfigDeleteAllRequest

Field NameTypeDescription
partial_eq_filterActionRunConfig[...]

PartialEqFilter provides a way to server-side filter a DeleteAll.

This requires all provided fields to be equal to the response.

A filtered DeleteAll will use GetAll with filter to find things to delete.

ActionRunConfigDeleteAllResponse

Field NameTypeDescription
typefmp.DeleteError

This describes the class of delete error.

A DeleteAllResponse is only sent when there is an error.

errorgoogle.protobuf.StringValue

This indicates the error message from the delete failure.

keyActionRunKey

This is the key of the ActionRunConfig instance that failed to be deleted.

timegoogle.protobuf.Timestamp

Time indicates the (UTC) timestamp when the key was being deleted.

ActionRunConfigDeleteRequest

Field NameTypeDescription
keyActionRunKey

Key indicates which ActionRunConfig instance to remove.

This field must always be set.

ActionRunConfigDeleteResponse

Field NameTypeDescription
keyActionRunKey

Key echoes back the key of the deleted ActionRunConfig instance.

timegoogle.protobuf.Timestamp

Time indicates the (UTC) timestamp at which the system recognizes the

deletion. The only guarantees made about this timestamp are:

- it is after the time the request was received

- a time-ranged query with StartTime==DeletedAt will not include this instance.

ActionRunConfigDeleteSomeRequest

Field NameTypeDescription
keysActionRunKey[...]

key contains a list of ActionRunConfig keys to delete

ActionRunConfigDeleteSomeResponse

ActionRunConfigDeleteSomeResponse is only sent when there is an error.

Field NameTypeDescription
keyActionRunKey

errorstring

ActionRunConfigRequest

Field NameTypeDescription
keyActionRunKey

Key uniquely identifies a ActionRunConfig instance to retrieve.

This value must be populated.

timegoogle.protobuf.Timestamp

Time indicates the time for which you are interested in the data.

If no time is given, the server will use the time at which it makes the request.

ActionRunConfigResponse

Field NameTypeDescription
valueActionRunConfig

Value is the value requested.

This structure will be fully-populated as it exists in the datastore. If

optional fields were not given at creation, these fields will be empty or

set to default values.

timegoogle.protobuf.Timestamp

Time carries the (UTC) timestamp of the last-modification of the

ActionRunConfig instance in this response.

ActionRunConfigSetRequest

Field NameTypeDescription
valueActionRunConfig

ActionRunConfig carries the value to set into the datastore.

See the documentation on the ActionRunConfig struct for which fields are required.

ActionRunConfigSetResponse

Field NameTypeDescription
valueActionRunConfig

Value carries all the values given in the ActionRunConfigSetRequest as well

as any server-generated values.

timegoogle.protobuf.Timestamp

Time indicates the (UTC) timestamp at which the system recognizes the

creation. The only guarantees made about this timestamp are:

- it is after the time the request was received

- a time-ranged query with StartTime==CreatedAt will include this instance.

ActionRunConfigSetSomeRequest

Field NameTypeDescription
valuesActionRunConfig[...]

value contains a list of ActionRunConfig values to write.

It is possible to provide more values than can fit within either:

- the maxiumum send size of the client

- the maximum receive size of the server

If this error occurs you must reduce the number of values sent.

See gRPC "maximum message size" documentation for more information.

ActionRunConfigSetSomeResponse

Field NameTypeDescription
keyActionRunKey

errorstring

ActionRunConfigSomeRequest

Field NameTypeDescription
keysActionRunKey[...]

timegoogle.protobuf.Timestamp

Time indicates the time for which you are interested in the data.

If no time is given, the server will use the time at which it makes the request.

ActionRunConfigSomeResponse

Field NameTypeDescription
valueActionRunConfig

Value is the value requested.

This structure will be fully-populated as it exists in the datastore. If

optional fields were not given at creation, these fields will be empty or

set to default values.

errorgoogle.protobuf.StringValue

Error is an optional field.

It should be filled when there is an error in the GetSome process.

timegoogle.protobuf.Timestamp

ActionRunConfigStreamRequest

Field NameTypeDescription
partial_eq_filterActionRunConfig[...]

PartialEqFilter provides a way to server-side filter a GetAll/Subscribe.

This requires all provided fields to be equal to the response.

While transparent to users, this field also allows services to optimize internal

subscriptions if filter(s) are sufficiently specific.

timearista.time.TimeBounds

TimeRange allows limiting response data to within a specified time window.

If this field is populated, at least one of the two time fields are required.

For GetAll, the fields start and end can be used as follows:

* end: Returns the state of each ActionRunConfig at end.

* Each ActionRunConfig response is fully-specified (all fields set).

* start: Returns the state of each ActionRunConfig at start, followed by updates until now.

* Each ActionRunConfig response at start is fully-specified, but updates may be partial.

* start and end: Returns the state of each ActionRunConfig at start, followed by updates

until end.

* Each ActionRunConfig response at start is fully-specified, but updates until end may

be partial.

This field is not allowed in the Subscribe RPC.

ActionRunConfigStreamResponse

Field NameTypeDescription
valueActionRunConfig

Value is a value deemed relevant to the initiating request.

This structure will always have its key-field populated. Which other fields are

populated, and why, depends on the value of Operation and what triggered this notification.

timegoogle.protobuf.Timestamp

Time holds the timestamp of this ActionRunConfig's last modification.

typearista.subscriptions.Operation

Operation indicates how the ActionRunConfig value in this response should be considered.

Under non-subscribe requests, this value should always be INITIAL. In a subscription,

once all initial data is streamed and the client begins to receive modification updates,

you should not see INITIAL again.

ActionRunRequest

Field NameTypeDescription
keyActionRunKey

Key uniquely identifies a ActionRun instance to retrieve.

This value must be populated.

timegoogle.protobuf.Timestamp

Time indicates the time for which you are interested in the data.

If no time is given, the server will use the time at which it makes the request.

ActionRunResponse

Field NameTypeDescription
valueActionRun

Value is the value requested.

This structure will be fully-populated as it exists in the datastore. If

optional fields were not given at creation, these fields will be empty or

set to default values.

timegoogle.protobuf.Timestamp

Time carries the (UTC) timestamp of the last-modification of the

ActionRun instance in this response.

ActionRunSomeRequest

Field NameTypeDescription
keysActionRunKey[...]

timegoogle.protobuf.Timestamp

Time indicates the time for which you are interested in the data.

If no time is given, the server will use the time at which it makes the request.

ActionRunSomeResponse

Field NameTypeDescription
valueActionRun

Value is the value requested.

This structure will be fully-populated as it exists in the datastore. If

optional fields were not given at creation, these fields will be empty or

set to default values.

errorgoogle.protobuf.StringValue

Error is an optional field.

It should be filled when there is an error in the GetSome process.

timegoogle.protobuf.Timestamp

ActionRunStreamRequest

Field NameTypeDescription
partial_eq_filterActionRun[...]

PartialEqFilter provides a way to server-side filter a GetAll/Subscribe.

This requires all provided fields to be equal to the response.

While transparent to users, this field also allows services to optimize internal

subscriptions if filter(s) are sufficiently specific.

timearista.time.TimeBounds

TimeRange allows limiting response data to within a specified time window.

If this field is populated, at least one of the two time fields are required.

For GetAll, the fields start and end can be used as follows:

* end: Returns the state of each ActionRun at end.

* Each ActionRun response is fully-specified (all fields set).

* start: Returns the state of each ActionRun at start, followed by updates until now.

* Each ActionRun response at start is fully-specified, but updates may be partial.

* start and end: Returns the state of each ActionRun at start, followed by updates

until end.

* Each ActionRun response at start is fully-specified, but updates until end may

be partial.

This field is not allowed in the Subscribe RPC.

ActionRunStreamResponse

Field NameTypeDescription
valueActionRun

Value is a value deemed relevant to the initiating request.

This structure will always have its key-field populated. Which other fields are

populated, and why, depends on the value of Operation and what triggered this notification.

timegoogle.protobuf.Timestamp

Time holds the timestamp of this ActionRun's last modification.

typearista.subscriptions.Operation

Operation indicates how the ActionRun value in this response should be considered.

Under non-subscribe requests, this value should always be INITIAL. In a subscription,

once all initial data is streamed and the client begins to receive modification updates,

you should not see INITIAL again.

ActionSomeRequest

Field NameTypeDescription
keysActionKey[...]

timegoogle.protobuf.Timestamp

Time indicates the time for which you are interested in the data.

If no time is given, the server will use the time at which it makes the request.

ActionSomeResponse

Field NameTypeDescription
valueAction

Value is the value requested.

This structure will be fully-populated as it exists in the datastore. If

optional fields were not given at creation, these fields will be empty or

set to default values.

errorgoogle.protobuf.StringValue

Error is an optional field.

It should be filled when there is an error in the GetSome process.

timegoogle.protobuf.Timestamp

ActionStreamRequest

Field NameTypeDescription
partial_eq_filterAction[...]

PartialEqFilter provides a way to server-side filter a GetAll/Subscribe.

This requires all provided fields to be equal to the response.

While transparent to users, this field also allows services to optimize internal

subscriptions if filter(s) are sufficiently specific.

timearista.time.TimeBounds

TimeRange allows limiting response data to within a specified time window.

If this field is populated, at least one of the two time fields are required.

For GetAll, the fields start and end can be used as follows:

* end: Returns the state of each Action at end.

* Each Action response is fully-specified (all fields set).

* start: Returns the state of each Action at start, followed by updates until now.

* Each Action response at start is fully-specified, but updates may be partial.

* start and end: Returns the state of each Action at start, followed by updates

until end.

* Each Action response at start is fully-specified, but updates until end may

be partial.

This field is not allowed in the Subscribe RPC.

ActionStreamResponse

Field NameTypeDescription
valueAction

Value is a value deemed relevant to the initiating request.

This structure will always have its key-field populated. Which other fields are

populated, and why, depends on the value of Operation and what triggered this notification.

timegoogle.protobuf.Timestamp

Time holds the timestamp of this Action's last modification.

typearista.subscriptions.Operation

Operation indicates how the Action value in this response should be considered.

Under non-subscribe requests, this value should always be INITIAL. In a subscription,

once all initial data is streamed and the client begins to receive modification updates,

you should not see INITIAL again.

MetaResponse

Field NameTypeDescription
timegoogle.protobuf.Timestamp

Time holds the timestamp of the last item included in the metadata calculation.

typearista.subscriptions.Operation

Operation indicates how the value in this response should be considered.

Under non-subscribe requests, this value should always be INITIAL. In a subscription,

once all initial data is streamed and the client begins to receive modification updates,

you should not see INITIAL again.

countgoogle.protobuf.UInt32Value

Count is the number of items present under the conditions of the request.

ActionArgConfigService

Method NameRequest TypeResponse TypeDescription
GetOneActionArgConfigRequestActionArgConfigResponse

GetSomeActionArgConfigSomeRequestActionArgConfigSomeResponse stream

GetAllActionArgConfigStreamRequestActionArgConfigStreamResponse stream

SubscribeActionArgConfigStreamRequestActionArgConfigStreamResponse stream

GetMetaActionArgConfigStreamRequestMetaResponse

SubscribeMetaActionArgConfigStreamRequestMetaResponse stream

SetActionArgConfigSetRequestActionArgConfigSetResponse

SetSomeActionArgConfigSetSomeRequestActionArgConfigSetSomeResponse stream

DeleteActionArgConfigDeleteRequestActionArgConfigDeleteResponse

DeleteSomeActionArgConfigDeleteSomeRequestActionArgConfigDeleteSomeResponse stream

DeleteAllActionArgConfigDeleteAllRequestActionArgConfigDeleteAllResponse stream

ActionConfigService

Method NameRequest TypeResponse TypeDescription
GetOneActionConfigRequestActionConfigResponse

GetSomeActionConfigSomeRequestActionConfigSomeResponse stream

GetAllActionConfigStreamRequestActionConfigStreamResponse stream

SubscribeActionConfigStreamRequestActionConfigStreamResponse stream

GetMetaActionConfigStreamRequestMetaResponse

SubscribeMetaActionConfigStreamRequestMetaResponse stream

SetActionConfigSetRequestActionConfigSetResponse

SetSomeActionConfigSetSomeRequestActionConfigSetSomeResponse stream

DeleteActionConfigDeleteRequestActionConfigDeleteResponse

DeleteSomeActionConfigDeleteSomeRequestActionConfigDeleteSomeResponse stream

DeleteAllActionConfigDeleteAllRequestActionConfigDeleteAllResponse stream

ActionRunConfigService

Method NameRequest TypeResponse TypeDescription
GetOneActionRunConfigRequestActionRunConfigResponse

GetSomeActionRunConfigSomeRequestActionRunConfigSomeResponse stream

GetAllActionRunConfigStreamRequestActionRunConfigStreamResponse stream

SubscribeActionRunConfigStreamRequestActionRunConfigStreamResponse stream

GetMetaActionRunConfigStreamRequestMetaResponse

SubscribeMetaActionRunConfigStreamRequestMetaResponse stream

SetActionRunConfigSetRequestActionRunConfigSetResponse

SetSomeActionRunConfigSetSomeRequestActionRunConfigSetSomeResponse stream

DeleteActionRunConfigDeleteRequestActionRunConfigDeleteResponse

DeleteSomeActionRunConfigDeleteSomeRequestActionRunConfigDeleteSomeResponse stream

DeleteAllActionRunConfigDeleteAllRequestActionRunConfigDeleteAllResponse stream

ActionRunService

Method NameRequest TypeResponse TypeDescription
GetOneActionRunRequestActionRunResponse

GetSomeActionRunSomeRequestActionRunSomeResponse stream

GetAllActionRunStreamRequestActionRunStreamResponse stream

SubscribeActionRunStreamRequestActionRunStreamResponse stream

GetMetaActionRunStreamRequestMetaResponse

SubscribeMetaActionRunStreamRequestMetaResponse stream

ActionService

Method NameRequest TypeResponse TypeDescription
GetOneActionRequestActionResponse

GetSomeActionSomeRequestActionSomeResponse stream

GetAllActionStreamRequestActionStreamResponse stream

SubscribeActionStreamRequestActionStreamResponse stream

GetMetaActionStreamRequestMetaResponse

SubscribeMetaActionStreamRequestMetaResponse stream