feat(assets): add GetGridpool RPC and associated request/response messages

- Introduced GetGridpool RPC to fetch details of a specific gridpool.
- Added GetGridpoolRequest and GetGridpoolResponse messages for handling the request and response data.
- Updated proto imports to include gridpool definitions.

Signed-off-by: Richard Sandoval <rsandovaldev@gmail.com>

Author: sandovalrr

RELEASE_NOTES.md

@@ -9,4 +9,6 @@
 
 ## New Features
 
+- Add the `GetGridpool` RPC to the `PlatformAssets` service.
+
 

proto/frequenz/api/assets/v1/assets.proto

@@ -14,6 +14,7 @@ syntax = "proto3";
 
 package frequenz.api.assets.v1;
 
+import "frequenz/api/common/v1alpha8/gridpool/gridpool.proto";
 import "frequenz/api/common/v1alpha8/microgrid/electrical_components/electrical_components.proto";
 import "frequenz/api/common/v1alpha8/microgrid/microgrid.proto";
 
@@ -33,6 +34,9 @@ service PlatformAssets {
   rpc ListMicrogridElectricalComponentConnections(
     ListMicrogridElectricalComponentConnectionsRequest
   ) returns (ListMicrogridElectricalComponentConnectionsResponse);
+
+  // Returns details of a specific gridpool.
+  rpc GetGridpool(GetGridpoolRequest) returns (GetGridpoolResponse);
 }
 
 // GetMicrogridRequest is the input parameter for fetching details
@@ -118,3 +122,20 @@ message ListMicrogridElectricalComponentConnectionsResponse {
   // Contains the list of connections that match the filtering criteria.
   repeated frequenz.api.common.v1alpha8.microgrid.electrical_components.ElectricalComponentConnection connections =2;
 }
+
+
+// GetGridpoolRequest is the input parameter for fetching details
+// given a specific gridpool.
+message GetGridpoolRequest {
+  // The unique identifier of the gridpool for which to fetch details.
+  uint64 gridpool_id = 1;
+}
+
+// GetGridpoolResponse is the response for fetching details
+// given a specific gridpool.
+message GetGridpoolResponse {
+  // Details of the requested gridpool.
+  frequenz.api.common.v1alpha8.gridpool.Gridpool gridpool = 1;
+  // List of microgrids in the gridpool.
+  repeated frequenz.api.common.v1alpha8.microgrid.Microgrid microgrids = 2;
+}