tag.v2
Available Services
arista/tag.v2/tag.proto
Tag
Tag holds a merge-preview or the existing merged state (if the workspace ID is "") of a tag.
Field Name | Type | Description |
---|---|---|
key | TagKey | key identifies a tag. |
creator_type | CreatorType | creator_type is the creator type of the tag. |
assigned | google.protobuf.BoolValue | assigned indicates whether the tag is assigned (true) or not (false). |
TagAssignment
TagAssignment holds a merge-preview or the existing merged state (if the workspace ID is "") of an assignment between a tag and a network element.
Field Name | Type | Description |
---|---|---|
key | TagAssignmentKey | key identifies an assignment. |
tag_creator_type | CreatorType | tag_creator_type is the creator type of the tag involved in the assignment. |
TagAssignmentConfig
TagAssignmentConfig holds a configuration for an assignment between a tag and a network element. The tag assignments that belong to entities other than ELEMENT_SUB_TYPE_DEVICE will always be present in mainline only.
Field Name | Type | Description |
---|---|---|
key | TagAssignmentKey | key identifies an assignment. The special workspace ID "" for merged assignments should not be set here. |
remove | google.protobuf.BoolValue | remove indicates whether to remove (true) or add (false, unset) the assignment identified by the key if the encompassing workspace merges. |
TagAssignmentKey
TagAssignmentKey uniquely identifies an assignment between a tag and a network element.
Field Name | Type | Description |
---|---|---|
workspace_id | google.protobuf.StringValue | workspace_id is the ID of a workspace. The special ID "" identifies the location where merged assignments reside. |
element_type | ElementType | element_type is the element type of a tag. What should be set per element type: ELEMENT_TYPE_DEVICE: device_id ELEMENT_TYPE_INTERFACE: device_id, interface_id |
label | google.protobuf.StringValue | label is the label of a tag. |
value | google.protobuf.StringValue | value is the value of a tag. |
device_id | google.protobuf.StringValue | device_id identifies a device. |
interface_id | google.protobuf.StringValue | interface_id identifies an interface on a device. |
element_sub_type | ElementSubType | element_sub_type is the element sub-type of a tag. |
TagConfig
TagConfig holds a configuration for a user tag. The tags that belong to entities other than ELEMENT_SUB_TYPE_DEVICE will always be present in mainline only.
Field Name | Type | Description |
---|---|---|
key | TagKey | key identifies a tag. The special workspace ID "" for merged tags should not be set here. |
remove | google.protobuf.BoolValue | remove indicates whether to remove (true) or add (false, unset) the tag identified by the key if the encompassing workspace merges. |
TagKey
TagKey uniquely identifies a tag.
Field Name | Type | Description |
---|---|---|
workspace_id | google.protobuf.StringValue | workspace_id is the ID of a workspace. The special ID "" identifies the location where merged tags reside. |
element_type | ElementType | element_type is the category of network element to which this tag can be assigned. |
label | google.protobuf.StringValue | label is an arbitrary label. |
value | google.protobuf.StringValue | value is an arbitrary value. |
element_sub_type | ElementSubType | element_sub_type is the sub-category of network element to which this tag can be assigned. |
CreatorType
CreatorType enumerates the types of entities that can create a tag.
Name | Number | Description |
---|---|---|
CREATOR_TYPE_UNSPECIFIED | 0 | CREATOR_TYPE_UNSPECIFIED is the default value. |
CREATOR_TYPE_SYSTEM | 1 | CREATOR_TYPE_SYSTEM is used for system tags. |
CREATOR_TYPE_USER | 2 | CREATOR_TYPE_USER is used for user tags. |
CREATOR_TYPE_EXTERNAL | 3 | CREATOR_TYPE_EXTERNAL is used for tags created from external sources. For E.g., vCenter |
ElementSubType
ElementSubType enumerates the sub-types of network elements that can be associated with tags.
Name | Number | Description |
---|---|---|
ELEMENT_SUB_TYPE_UNSPECIFIED | 0 | ELEMENT_SUB_TYPE_UNSPECIFIED is the default value. |
ELEMENT_SUB_TYPE_DEVICE | 1 | ELEMENT_SUB_TYPE_DEVICE is used for EOS or third-party devices discovered via LLDP/SNMP. |
ELEMENT_SUB_TYPE_VDS | 2 | ELEMENT_SUB_TYPE_VDS is used for VMWare vSphere Distributed Switch (VDS) tags. |
ELEMENT_SUB_TYPE_WORKLOAD_SERVER | 3 | ELEMENT_SUB_TYPE_WORKLOAD_SERVER is used for workload server tags (such as VMWare ESXi host). A workload server is a server/data storage device on which the hypervisor is installed. |
ELEMENT_SUB_TYPE_VM | 4 | ELEMENT_SUB_TYPE_VM is used for VM tags. A VM is a software computer that, like a physical computer, runs an operating system and applications. |
ElementType
ElementType enumerates the types of network elements that can be associated with tags.
Name | Number | Description |
---|---|---|
ELEMENT_TYPE_UNSPECIFIED | 0 | ELEMENT_TYPE_UNSPECIFIED is the default value. |
ELEMENT_TYPE_DEVICE | 1 | ELEMENT_TYPE_DEVICE is used for device tags. |
ELEMENT_TYPE_INTERFACE | 2 | ELEMENT_TYPE_INTERFACE is used for interface tags. |
arista/tag.v2/services.gen.proto
MetaResponse
Field Name | Type | Description |
---|---|---|
time | google.protobuf.Timestamp | Time holds the timestamp of the last item included in the metadata calculation. |
type | arista.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. |
count | google.protobuf.UInt32Value | Count is the number of items present under the conditions of the request. |
TagAssignmentBatchedStreamRequest
Field Name | Type | Description |
---|---|---|
partial_eq_filter | TagAssignment[...] | 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. |
time | arista.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 TagAssignment at end. * Each TagAssignment response is fully-specified (all fields set). * start: Returns the state of each TagAssignment at start, followed by updates until now. * Each TagAssignment response at start is fully-specified, but updates may be partial. * start and end: Returns the state of each TagAssignment at start, followed by updates until end. * Each TagAssignment response at start is fully-specified, but updates until end may be partial. This field is not allowed in the Subscribe RPC. |
max_messages | google.protobuf.UInt32Value | MaxMessages limits the maximum number of messages that can be contained in one batch. MaxMessages is required to be at least 1. The maximum number of messages in a batch is min(max_messages, INTERNAL_BATCH_LIMIT) INTERNAL_BATCH_LIMIT is set based on the maximum message size. |
TagAssignmentBatchedStreamResponse
Field Name | Type | Description |
---|---|---|
responses | TagAssignmentStreamResponse[...] | Values are the values deemed relevant to the initiating request. The length of this structure is guaranteed to be between (inclusive) 1 and min(req.max_messages, INTERNAL_BATCH_LIMIT). |
TagAssignmentConfigBatchedStreamRequest
Field Name | Type | Description |
---|---|---|
partial_eq_filter | TagAssignmentConfig[...] | 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. |
time | arista.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 TagAssignmentConfig at end. * Each TagAssignmentConfig response is fully-specified (all fields set). * start: Returns the state of each TagAssignmentConfig at start, followed by updates until now. * Each TagAssignmentConfig response at start is fully-specified, but updates may be partial. * start and end: Returns the state of each TagAssignmentConfig at start, followed by updates until end. * Each TagAssignmentConfig response at start is fully-specified, but updates until end may be partial. This field is not allowed in the Subscribe RPC. |
max_messages | google.protobuf.UInt32Value | MaxMessages limits the maximum number of messages that can be contained in one batch. MaxMessages is required to be at least 1. The maximum number of messages in a batch is min(max_messages, INTERNAL_BATCH_LIMIT) INTERNAL_BATCH_LIMIT is set based on the maximum message size. |
TagAssignmentConfigBatchedStreamResponse
Field Name | Type | Description |
---|---|---|
responses | TagAssignmentConfigStreamResponse[...] | Values are the values deemed relevant to the initiating request. The length of this structure is guaranteed to be between (inclusive) 1 and min(req.max_messages, INTERNAL_BATCH_LIMIT). |
TagAssignmentConfigDeleteAllRequest
Field Name | Type | Description |
---|---|---|
partial_eq_filter | TagAssignmentConfig[...] | 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. |
TagAssignmentConfigDeleteAllResponse
Field Name | Type | Description |
---|---|---|
type | fmp.DeleteError | This describes the class of delete error. A DeleteAllResponse is only sent when there is an error. |
error | google.protobuf.StringValue | This indicates the error message from the delete failure. |
key | TagAssignmentKey | This is the key of the TagAssignmentConfig instance that failed to be deleted. |
time | google.protobuf.Timestamp | Time indicates the (UTC) timestamp when the key was being deleted. |
TagAssignmentConfigDeleteRequest
Field Name | Type | Description |
---|---|---|
key | TagAssignmentKey | Key indicates which TagAssignmentConfig instance to remove. This field must always be set. |
TagAssignmentConfigDeleteResponse
Field Name | Type | Description |
---|---|---|
key | TagAssignmentKey | Key echoes back the key of the deleted TagAssignmentConfig instance. |
time | google.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. |
TagAssignmentConfigDeleteSomeRequest
Field Name | Type | Description |
---|---|---|
keys | TagAssignmentKey[...] | key contains a list of TagAssignmentConfig keys to delete |
TagAssignmentConfigDeleteSomeResponse
TagAssignmentConfigDeleteSomeResponse is only sent when there is an error.
Field Name | Type | Description |
---|---|---|
key | TagAssignmentKey | |
error | string |
TagAssignmentConfigRequest
Field Name | Type | Description |
---|---|---|
key | TagAssignmentKey | Key uniquely identifies a TagAssignmentConfig instance to retrieve. This value must be populated. |
time | google.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. |
TagAssignmentConfigResponse
Field Name | Type | Description |
---|---|---|
value | TagAssignmentConfig | 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. |
time | google.protobuf.Timestamp | Time carries the (UTC) timestamp of the last-modification of the TagAssignmentConfig instance in this response. |
TagAssignmentConfigSetRequest
Field Name | Type | Description |
---|---|---|
value | TagAssignmentConfig | TagAssignmentConfig carries the value to set into the datastore. See the documentation on the TagAssignmentConfig struct for which fields are required. |
TagAssignmentConfigSetResponse
Field Name | Type | Description |
---|---|---|
value | TagAssignmentConfig | Value carries all the values given in the TagAssignmentConfigSetRequest as well as any server-generated values. |
time | google.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. |
TagAssignmentConfigSetSomeRequest
Field Name | Type | Description |
---|---|---|
values | TagAssignmentConfig[...] | value contains a list of TagAssignmentConfig 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. |
TagAssignmentConfigSetSomeResponse
Field Name | Type | Description |
---|---|---|
key | TagAssignmentKey | |
error | string |
TagAssignmentConfigSomeRequest
Field Name | Type | Description |
---|---|---|
keys | TagAssignmentKey[...] | |
time | google.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. |
TagAssignmentConfigSomeResponse
Field Name | Type | Description |
---|---|---|
value | TagAssignmentConfig | 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. |
error | google.protobuf.StringValue | Error is an optional field. It should be filled when there is an error in the GetSome process. |
time | google.protobuf.Timestamp |
TagAssignmentConfigStreamRequest
Field Name | Type | Description |
---|---|---|
partial_eq_filter | TagAssignmentConfig[...] | 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. |
time | arista.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 TagAssignmentConfig at end. * Each TagAssignmentConfig response is fully-specified (all fields set). * start: Returns the state of each TagAssignmentConfig at start, followed by updates until now. * Each TagAssignmentConfig response at start is fully-specified, but updates may be partial. * start and end: Returns the state of each TagAssignmentConfig at start, followed by updates until end. * Each TagAssignmentConfig response at start is fully-specified, but updates until end may be partial. This field is not allowed in the Subscribe RPC. |
TagAssignmentConfigStreamResponse
Field Name | Type | Description |
---|---|---|
value | TagAssignmentConfig | 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. |
time | google.protobuf.Timestamp | Time holds the timestamp of this TagAssignmentConfig's last modification. |
type | arista.subscriptions.Operation | Operation indicates how the TagAssignmentConfig 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. |
TagAssignmentRequest
Field Name | Type | Description |
---|---|---|
key | TagAssignmentKey | Key uniquely identifies a TagAssignment instance to retrieve. This value must be populated. |
time | google.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. |
TagAssignmentResponse
Field Name | Type | Description |
---|---|---|
value | TagAssignment | 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. |
time | google.protobuf.Timestamp | Time carries the (UTC) timestamp of the last-modification of the TagAssignment instance in this response. |
TagAssignmentSomeRequest
Field Name | Type | Description |
---|---|---|
keys | TagAssignmentKey[...] | |
time | google.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. |
TagAssignmentSomeResponse
Field Name | Type | Description |
---|---|---|
value | TagAssignment | 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. |
error | google.protobuf.StringValue | Error is an optional field. It should be filled when there is an error in the GetSome process. |
time | google.protobuf.Timestamp |
TagAssignmentStreamRequest
Field Name | Type | Description |
---|---|---|
partial_eq_filter | TagAssignment[...] | 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. |
time | arista.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 TagAssignment at end. * Each TagAssignment response is fully-specified (all fields set). * start: Returns the state of each TagAssignment at start, followed by updates until now. * Each TagAssignment response at start is fully-specified, but updates may be partial. * start and end: Returns the state of each TagAssignment at start, followed by updates until end. * Each TagAssignment response at start is fully-specified, but updates until end may be partial. This field is not allowed in the Subscribe RPC. |
TagAssignmentStreamResponse
Field Name | Type | Description |
---|---|---|
value | TagAssignment | 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. |
time | google.protobuf.Timestamp | Time holds the timestamp of this TagAssignment's last modification. |
type | arista.subscriptions.Operation | Operation indicates how the TagAssignment 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. |
TagBatchedStreamRequest
Field Name | Type | Description |
---|---|---|
partial_eq_filter | Tag[...] | 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. |
time | arista.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 Tag at end. * Each Tag response is fully-specified (all fields set). * start: Returns the state of each Tag at start, followed by updates until now. * Each Tag response at start is fully-specified, but updates may be partial. * start and end: Returns the state of each Tag at start, followed by updates until end. * Each Tag response at start is fully-specified, but updates until end may be partial. This field is not allowed in the Subscribe RPC. |
max_messages | google.protobuf.UInt32Value | MaxMessages limits the maximum number of messages that can be contained in one batch. MaxMessages is required to be at least 1. The maximum number of messages in a batch is min(max_messages, INTERNAL_BATCH_LIMIT) INTERNAL_BATCH_LIMIT is set based on the maximum message size. |
TagBatchedStreamResponse
Field Name | Type | Description |
---|---|---|
responses | TagStreamResponse[...] | Values are the values deemed relevant to the initiating request. The length of this structure is guaranteed to be between (inclusive) 1 and min(req.max_messages, INTERNAL_BATCH_LIMIT). |
TagConfigBatchedStreamRequest
Field Name | Type | Description |
---|---|---|
partial_eq_filter | TagConfig[...] | 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. |
time | arista.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 TagConfig at end. * Each TagConfig response is fully-specified (all fields set). * start: Returns the state of each TagConfig at start, followed by updates until now. * Each TagConfig response at start is fully-specified, but updates may be partial. * start and end: Returns the state of each TagConfig at start, followed by updates until end. * Each TagConfig response at start is fully-specified, but updates until end may be partial. This field is not allowed in the Subscribe RPC. |
max_messages | google.protobuf.UInt32Value | MaxMessages limits the maximum number of messages that can be contained in one batch. MaxMessages is required to be at least 1. The maximum number of messages in a batch is min(max_messages, INTERNAL_BATCH_LIMIT) INTERNAL_BATCH_LIMIT is set based on the maximum message size. |
TagConfigBatchedStreamResponse
Field Name | Type | Description |
---|---|---|
responses | TagConfigStreamResponse[...] | Values are the values deemed relevant to the initiating request. The length of this structure is guaranteed to be between (inclusive) 1 and min(req.max_messages, INTERNAL_BATCH_LIMIT). |
TagConfigDeleteAllRequest
Field Name | Type | Description |
---|---|---|
partial_eq_filter | TagConfig[...] | 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. |
TagConfigDeleteAllResponse
Field Name | Type | Description |
---|---|---|
type | fmp.DeleteError | This describes the class of delete error. A DeleteAllResponse is only sent when there is an error. |
error | google.protobuf.StringValue | This indicates the error message from the delete failure. |
key | TagKey | This is the key of the TagConfig instance that failed to be deleted. |
time | google.protobuf.Timestamp | Time indicates the (UTC) timestamp when the key was being deleted. |
TagConfigDeleteRequest
Field Name | Type | Description |
---|---|---|
key | TagKey | Key indicates which TagConfig instance to remove. This field must always be set. |
TagConfigDeleteResponse
Field Name | Type | Description |
---|---|---|
key | TagKey | Key echoes back the key of the deleted TagConfig instance. |
time | google.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. |
TagConfigDeleteSomeRequest
Field Name | Type | Description |
---|---|---|
keys | TagKey[...] | key contains a list of TagConfig keys to delete |
TagConfigDeleteSomeResponse
TagConfigDeleteSomeResponse is only sent when there is an error.
Field Name | Type | Description |
---|---|---|
key | TagKey | |
error | string |
TagConfigRequest
Field Name | Type | Description |
---|---|---|
key | TagKey | Key uniquely identifies a TagConfig instance to retrieve. This value must be populated. |
time | google.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. |
TagConfigResponse
Field Name | Type | Description |
---|---|---|
value | TagConfig | 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. |
time | google.protobuf.Timestamp | Time carries the (UTC) timestamp of the last-modification of the TagConfig instance in this response. |
TagConfigSetRequest
Field Name | Type | Description |
---|---|---|
value | TagConfig | TagConfig carries the value to set into the datastore. See the documentation on the TagConfig struct for which fields are required. |
TagConfigSetResponse
Field Name | Type | Description |
---|---|---|
value | TagConfig | Value carries all the values given in the TagConfigSetRequest as well as any server-generated values. |
time | google.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. |
TagConfigSetSomeRequest
Field Name | Type | Description |
---|---|---|
values | TagConfig[...] | value contains a list of TagConfig 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. |
TagConfigSetSomeResponse
Field Name | Type | Description |
---|---|---|
key | TagKey | |
error | string |
TagConfigSomeRequest
Field Name | Type | Description |
---|---|---|
keys | TagKey[...] | |
time | google.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. |
TagConfigSomeResponse
Field Name | Type | Description |
---|---|---|
value | TagConfig | 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. |
error | google.protobuf.StringValue | Error is an optional field. It should be filled when there is an error in the GetSome process. |
time | google.protobuf.Timestamp |
TagConfigStreamRequest
Field Name | Type | Description |
---|---|---|
partial_eq_filter | TagConfig[...] | 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. |
time | arista.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 TagConfig at end. * Each TagConfig response is fully-specified (all fields set). * start: Returns the state of each TagConfig at start, followed by updates until now. * Each TagConfig response at start is fully-specified, but updates may be partial. * start and end: Returns the state of each TagConfig at start, followed by updates until end. * Each TagConfig response at start is fully-specified, but updates until end may be partial. This field is not allowed in the Subscribe RPC. |
TagConfigStreamResponse
Field Name | Type | Description |
---|---|---|
value | TagConfig | 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. |
time | google.protobuf.Timestamp | Time holds the timestamp of this TagConfig's last modification. |
type | arista.subscriptions.Operation | Operation indicates how the TagConfig 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. |
TagRequest
Field Name | Type | Description |
---|---|---|
key | TagKey | Key uniquely identifies a Tag instance to retrieve. This value must be populated. |
time | google.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. |
TagResponse
Field Name | Type | Description |
---|---|---|
value | Tag | 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. |
time | google.protobuf.Timestamp | Time carries the (UTC) timestamp of the last-modification of the Tag instance in this response. |
TagSomeRequest
Field Name | Type | Description |
---|---|---|
keys | TagKey[...] | |
time | google.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. |
TagSomeResponse
Field Name | Type | Description |
---|---|---|
value | Tag | 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. |
error | google.protobuf.StringValue | Error is an optional field. It should be filled when there is an error in the GetSome process. |
time | google.protobuf.Timestamp |
TagStreamRequest
Field Name | Type | Description |
---|---|---|
partial_eq_filter | Tag[...] | 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. |
time | arista.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 Tag at end. * Each Tag response is fully-specified (all fields set). * start: Returns the state of each Tag at start, followed by updates until now. * Each Tag response at start is fully-specified, but updates may be partial. * start and end: Returns the state of each Tag at start, followed by updates until end. * Each Tag response at start is fully-specified, but updates until end may be partial. This field is not allowed in the Subscribe RPC. |
TagStreamResponse
Field Name | Type | Description |
---|---|---|
value | Tag | 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. |
time | google.protobuf.Timestamp | Time holds the timestamp of this Tag's last modification. |
type | arista.subscriptions.Operation | Operation indicates how the Tag 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. |
TagAssignmentConfigService
TagAssignmentService
Method Name | Request Type | Response Type | Description |
---|---|---|---|
GetOne | TagAssignmentRequest | TagAssignmentResponse | |
GetSome | TagAssignmentSomeRequest | TagAssignmentSomeResponse stream | |
GetAll | TagAssignmentStreamRequest | TagAssignmentStreamResponse stream | |
Subscribe | TagAssignmentStreamRequest | TagAssignmentStreamResponse stream | |
GetMeta | TagAssignmentStreamRequest | MetaResponse | |
SubscribeMeta | TagAssignmentStreamRequest | MetaResponse stream | |
GetAllBatched | TagAssignmentBatchedStreamRequest | TagAssignmentBatchedStreamResponse stream | |
SubscribeBatched | TagAssignmentBatchedStreamRequest | TagAssignmentBatchedStreamResponse stream |
TagConfigService
Method Name | Request Type | Response Type | Description |
---|---|---|---|
GetOne | TagConfigRequest | TagConfigResponse | |
GetSome | TagConfigSomeRequest | TagConfigSomeResponse stream | |
GetAll | TagConfigStreamRequest | TagConfigStreamResponse stream | |
Subscribe | TagConfigStreamRequest | TagConfigStreamResponse stream | |
GetMeta | TagConfigStreamRequest | MetaResponse | |
SubscribeMeta | TagConfigStreamRequest | MetaResponse stream | |
Set | TagConfigSetRequest | TagConfigSetResponse | |
SetSome | TagConfigSetSomeRequest | TagConfigSetSomeResponse stream | |
Delete | TagConfigDeleteRequest | TagConfigDeleteResponse | |
DeleteSome | TagConfigDeleteSomeRequest | TagConfigDeleteSomeResponse stream | |
DeleteAll | TagConfigDeleteAllRequest | TagConfigDeleteAllResponse stream | |
GetAllBatched | TagConfigBatchedStreamRequest | TagConfigBatchedStreamResponse stream | |
SubscribeBatched | TagConfigBatchedStreamRequest | TagConfigBatchedStreamResponse stream |
TagService
Method Name | Request Type | Response Type | Description |
---|---|---|---|
GetOne | TagRequest | TagResponse | |
GetSome | TagSomeRequest | TagSomeResponse stream | |
GetAll | TagStreamRequest | TagStreamResponse stream | |
Subscribe | TagStreamRequest | TagStreamResponse stream | |
GetMeta | TagStreamRequest | MetaResponse | |
SubscribeMeta | TagStreamRequest | MetaResponse stream | |
GetAllBatched | TagBatchedStreamRequest | TagBatchedStreamResponse stream | |
SubscribeBatched | TagBatchedStreamRequest | TagBatchedStreamResponse stream |