release/endpointlocation: Update endpointlocation.v1

XXX_SKIP_CHECK_BREAKING

Change-Id: I760040f8cae23e4e37c704a3d9eb7b270526f236

arista/endpointlocation.v1/endpointlocation-changelog.yaml

@@ -10,7 +10,6 @@ Changes:
     - date: 2020-04-09
       description: Initial revision
       version: 1.0.0
-      cvaas: true
     - date: 2020-04-24
       description: Added MacType and changed learnedTs to protobuf timestamp
       version: 1.0.1
@@ -74,5 +73,14 @@ Changes:
     - date: 2023-04-24
       description: Added MAC_TYPE_SOFTWARE_LEARNED_DYNAMIC to correspond with softwareLearnedDynamicMac type in MAC tables
       version: 1.8.0
+    - date: 2023-04-24
+      description: Added EXPLANATION_ACCESS_PORT to schema
+      version: 1.8.1
       onprem: true
       cvaas: true
+    - date: 2024-03-28
+      description: Update Available APIs
+      version: 1.8.2
+      onprem: true
+      cvaas: true
+

arista/endpointlocation.v1/endpointlocation.proto

@@ -6,7 +6,7 @@ syntax = "proto3";
 
 package arista.endpointlocation.v1;
 
-option go_package = "arista/resources/arista/endpointlocation.v1;endpointlocation";
+option go_package = "github.com/aristanetworks/cloudvision-go/api/arista/endpointlocation.v1;endpointlocation";
 
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
@@ -190,6 +190,8 @@ enum Explanation {
     // EXPLANATION_WIRELESS_CONNECTION indicates a direct connection from a wireless access
     // point in the device inventory to a wireless client.
     EXPLANATION_WIRELESS_CONNECTION = 10;
+    // EXPLANATION_ACCESS_PORT indicates that a location is an access port.
+    EXPLANATION_ACCESS_PORT = 11;
 }
 
 // ExplanationList is a list of Explanation.

arista/endpointlocation.v1/services.gen.proto

@@ -9,12 +9,27 @@
 syntax = "proto3";
 
 package arista.endpointlocation.v1;
-option go_package = "arista/resources/arista/endpointlocation.v1;endpointlocation";
+option go_package = "github.com/aristanetworks/cloudvision-go/api/arista/endpointlocation.v1;endpointlocation";
 
 import "arista/endpointlocation.v1/endpointlocation.proto";
 import "arista/time/time.proto";
 import "arista/subscriptions/subscriptions.proto";
 import "google/protobuf/timestamp.proto";
+import "google/protobuf/wrappers.proto";
+
+message MetaResponse {
+	// Time holds the timestamp of the last item included in the metadata calculation.
+	google.protobuf.Timestamp time = 1;
+
+	// 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.
+	arista.subscriptions.Operation type = 2;
+
+	// Count is the number of items present under the conditions of the request.
+	google.protobuf.UInt32Value count = 3;
+};
 
 message EndpointLocationRequest {
 	// Key uniquely identifies a EndpointLocation instance to retrieve.
@@ -38,6 +53,27 @@ message EndpointLocationResponse {
 	google.protobuf.Timestamp time = 2;
 };
 
+message EndpointLocationSomeRequest {
+	repeated EndpointLocationKey keys = 1;
+
+	// 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.
+	google.protobuf.Timestamp time = 2;
+};
+
+message EndpointLocationSomeResponse {
+	// 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.
+	EndpointLocation value = 1;
+
+	// Error is an optional field.
+	// It should be filled when there is an error in the GetSome process.
+	google.protobuf.StringValue error = 2;
+	google.protobuf.Timestamp time = 3;
+};
+
 message EndpointLocationStreamRequest {
 	// PartialEqFilter provides a way to server-side filter a GetAll/Subscribe.
 	// This requires all provided fields to be equal to the response.
@@ -82,6 +118,9 @@ message EndpointLocationStreamResponse {
 
 service EndpointLocationService {
 	rpc GetOne (EndpointLocationRequest) returns (EndpointLocationResponse);
+	rpc GetSome (EndpointLocationSomeRequest) returns (stream EndpointLocationSomeResponse);
 	rpc GetAll (EndpointLocationStreamRequest) returns (stream EndpointLocationStreamResponse);
 	rpc Subscribe (EndpointLocationStreamRequest) returns (stream EndpointLocationStreamResponse);
+	rpc GetMeta (EndpointLocationStreamRequest) returns (MetaResponse);
+	rpc SubscribeMeta (EndpointLocationStreamRequest) returns (stream MetaResponse);
 }