renamed API urls

Author: liamsi

core/proto/monitor_v1_types/monitor_v1_types.pb.go

@@ -23,9 +23,13 @@ import "trillian.proto";
 
 // GetMonitoringRequest contains the input parameters of the GetMonitoring APIs.
 message GetMonitoringRequest {
-  // start specifies the start epoch number from which monitoring results will
-  // be returned (ranging from [start, latestObserved] and starting at 1).
-  int64 start = 1;
+  // epoch specifies the for which the monitoring results will
+  // be returned (epochs start at 1).
+  int64 epoch = 1;
+
+  // ktURL is the URL of the keytransparency server for which the monitoring
+  // result will be returned.
+  string kt_URL = 2;
 }
 
 message GetMonitoringResponse {

core/proto/monitor_v1_types/monitor_v1_types.proto

@@ -72,7 +72,7 @@ func (s *Server) GetSignedMapRoot(ctx context.Context, in *mopb.GetMonitoringReq
 // mutations from the previous to the current epoch it won't sign the map root
 // and additional data will be provided to reproduce the failure.
 func (s *Server) GetSignedMapRootByRevision(ctx context.Context, in *mopb.GetMonitoringRequest) (*mopb.GetMonitoringResponse, error) {
-	return s.getResponseByRevision(in.GetStart())
+	return s.getResponseByRevision(in.GetEpoch())
 }
 
 func (s *Server) getResponseByRevision(epoch int64) (*mopb.GetMonitoringResponse, error) {

impl/monitor/server.go

@@ -28,8 +28,8 @@ import "google/api/annotations.proto";
 //
 // - Signed Map Roots can be collected using the GetSignedMapRoot APIs.
 // - Monitor resources are named:
-//   - /v1/map/roots/*
-//   - /v1/map/roots:latest
+//   - /v1/monitor/{kt-url}/map/results/{epoch}
+//   - /v1/monitor/{kt-url}/map/results:latest
 //
 service MonitorService {
   // GetSignedMapRoot returns the latest valid signed map root the monitor
@@ -42,7 +42,7 @@ service MonitorService {
   // additional data will be provided to reproduce the failure.
   rpc GetSignedMapRoot(monitor.v1.types.GetMonitoringRequest)
     returns (monitor.v1.types.GetMonitoringResponse) {
-    option (google.api.http) = { get: "/v1/map/roots:latest" };
+    option (google.api.http) = { get: "/v1/monitor/{kt_URL}/map/results:latest" };
   }
 
   // GetSignedMapRootByRevision works similar to GetSignedMapRoot but returns
@@ -54,7 +54,7 @@ service MonitorService {
   // and additional data will be provided to reproduce the failure.
   rpc GetSignedMapRootByRevision(monitor.v1.types.GetMonitoringRequest)
     returns(monitor.v1.types.GetMonitoringResponse) {
-    option (google.api.http) = { get: "/v1/map/roots/{start}" };
+    option (google.api.http) = { get: "/v1/monitor/{kt_URL}/map/results/{epoch}" };
   }
 }