sled-agent: add doc comments to RoT endpoints

Author: luqmana

…sled-agent/sled-agent-19.0.0-222a99.json …sled-agent/sled-agent-19.0.0-c56f15.jsonopenapi/sled-agent/sled-agent-19.0.0-222a99.json renamed to openapi/sled-agent/sled-agent-19.0.0-c56f15.json openapi/sled-agent/sled-agent-19.0.0-222a99.json renamed to openapi/sled-agent/sled-agent-19.0.0-c56f15.json

@@ -512,6 +512,7 @@
     },
     "/rot/{rot}/attest": {
       "post": {
+        "summary": "Return attestation over recorded measurments and nonce from the RoT.",
         "operationId": "rot_attest",
         "parameters": [
           {
@@ -556,6 +557,7 @@
     },
     "/rot/{rot}/certificate-chain": {
       "get": {
+        "summary": "Return the certificate chain for the attestation signer from the RoT.",
         "operationId": "rot_certificate_chain",
         "parameters": [
           {
@@ -590,6 +592,7 @@
     },
     "/rot/{rot}/measurement-log": {
       "get": {
+        "summary": "Return the set of measurments recorded by the RoT.",
         "operationId": "rot_measurement_log",
         "parameters": [
           {

openapi/sled-agent/sled-agent-latest.json

@@ -1 +1 @@
-sled-agent-19.0.0-222a99.json
+sled-agent-19.0.0-c56f15.json

sled-agent/api/src/lib.rs

@@ -1376,6 +1376,7 @@ pub trait SledAgentApi {
         path_params: Path<latest::attached_subnet::VmmSubnetPathParam>,
     ) -> Result<HttpResponseDeleted, HttpError>;
 
+    /// Return the set of measurments recorded by the RoT.
     #[endpoint {
         method = GET,
         path = "/rot/{rot}/measurement-log",
@@ -1386,6 +1387,7 @@ pub trait SledAgentApi {
         path_params: Path<latest::rot::RotPathParams>,
     ) -> Result<HttpResponseOk<latest::rot::MeasurementLog>, HttpError>;
 
+    /// Return the certificate chain for the attestation signer from the RoT.
     #[endpoint {
         method = GET,
         path = "/rot/{rot}/certificate-chain",
@@ -1396,6 +1398,7 @@ pub trait SledAgentApi {
         path_params: Path<latest::rot::RotPathParams>,
     ) -> Result<HttpResponseOk<latest::rot::CertificateChain>, HttpError>;
 
+    /// Return attestation over recorded measurments and nonce from the RoT.
     #[endpoint {
         method = POST,
         path = "/rot/{rot}/attest",