diff --git a/doc/index.html b/doc/index.html
index 85fdc036..0a161615 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -323,6 +323,10 @@ <h2>Table of Contents</h2>
                   <a href="#metalstack%2fapi%2fv2%2fpredefined_rules.proto-extensions"><span class="badge">X</span>File-level Extensions</a>
                 </li>
               
+                <li>
+                  <a href="#metalstack%2fapi%2fv2%2fpredefined_rules.proto-extensions"><span class="badge">X</span>File-level Extensions</a>
+                </li>
+              
               
             </ul>
           </li>
@@ -3253,8 +3257,16 @@ <h3 id="metalstack/api/v2/predefined_rules.proto-extensions">File-level Extensio
                 <td>all_trimmed</td>
                 <td><a href="#bool">bool</a></td>
                 <td><a href="#buf.validate.RepeatedRules">.buf.validate.RepeatedRules</a></td>
+                <td>80058954</td>
+                <td><p>All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end</p></td>
+              </tr>
+            
+              <tr>
+                <td>are_host_and_port</td>
+                <td><a href="#bool">bool</a></td>
+                <td><a href="#buf.validate.RepeatedRules">.buf.validate.RepeatedRules</a></td>
                 <td>80058953</td>
-                <td><p>All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end.</p></td>
+                <td><p>AreHostAndPort validates if a slice of strings are all in the form of &lt;ip | host&gt;:&lt;port&gt;</p></td>
               </tr>
             
               <tr>
@@ -3334,7 +3346,7 @@ <h3 id="metalstack/api/v2/predefined_rules.proto-extensions">File-level Extensio
                 <td><a href="#bool">bool</a></td>
                 <td><a href="#buf.validate.StringRules">.buf.validate.StringRules</a></td>
                 <td>80048958</td>
-                <td><p>Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end.</p></td>
+                <td><p>Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end</p></td>
               </tr>
             
           </tbody>
@@ -3562,7 +3574,7 @@ <h3 id="metalstack.api.v2.AuditServiceListResponse">AuditServiceListResponse</h3
         
       
         <h3 id="metalstack.api.v2.AuditTrace">AuditTrace</h3>
-        <p>AuditTrace is an audit trace</p>
+        <p>AuditTrace is an audit trace.</p>
 
         
           <table class="field-table">
@@ -3582,56 +3594,56 @@ <h3 id="metalstack.api.v2.AuditTrace">AuditTrace</h3>
                   <td>timestamp</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>Timestamp is the timestamp when the request arrived at the api </p></td>
+                  <td><p>Timestamp is the timestamp when the request arrived at the API </p></td>
                 </tr>
               
                 <tr>
                   <td>user</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>User is the login user who called the api method </p></td>
+                  <td><p>User is the login user who called the API method </p></td>
                 </tr>
               
                 <tr>
                   <td>tenant</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Tenant is the tenant targeted by the api call </p></td>
+                  <td><p>Tenant is the tenant targeted by the API call </p></td>
                 </tr>
               
                 <tr>
                   <td>project</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Project is the project targeted by the api call </p></td>
+                  <td><p>Project is the project targeted by the API call </p></td>
                 </tr>
               
                 <tr>
                   <td>method</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Method is the api method that was called </p></td>
+                  <td><p>Method is the API method that was called </p></td>
                 </tr>
               
                 <tr>
                   <td>body</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Body is the payload of the api call. In the request phase this contains the payload sent by the client, in the request phase it contains the payload returned by the api server </p></td>
+                  <td><p>Body is the payload of the API call. In the request phase this contains the payload sent by the client, in the response phase it contains the payload returned by the API server </p></td>
                 </tr>
               
                 <tr>
                   <td>source_ip</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Source IP contains the source ip address of the api call </p></td>
+                  <td><p>SourceIP contains the source IP address of the API call </p></td>
                 </tr>
               
                 <tr>
                   <td>result_code</td>
                   <td><a href="#int32">int32</a></td>
                   <td>optional</td>
-                  <td><p>Result Code is a status code describing the result of the api call. It is set for traces in the response phase and contains official gRPC status codes </p></td>
+                  <td><p>ResultCode is a status code describing the result of the API call. It is set for traces in the response phase and contains official gRPC status codes </p></td>
                 </tr>
               
                 <tr>
@@ -3651,7 +3663,7 @@ <h3 id="metalstack.api.v2.AuditTrace">AuditTrace</h3>
 
       
         <h3 id="metalstack.api.v2.AuditPhase">AuditPhase</h3>
-        <p>AuditPhase specifies phase of an audit trace</p>
+        <p>AuditPhase specifies the phase of an audit trace.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Name</td><td>Number</td><td>Description</td></tr>
@@ -3673,7 +3685,7 @@ <h3 id="metalstack.api.v2.AuditPhase">AuditPhase</h3>
               <tr>
                 <td>AUDIT_PHASE_RESPONSE</td>
                 <td>2</td>
-                <td><p>AUDIT_PHASE_REQUEST defines an audit trace in the response phase</p></td>
+                <td><p>AUDIT_PHASE_RESPONSE defines an audit trace in the response phase</p></td>
               </tr>
             
           </tbody>
@@ -3684,7 +3696,7 @@ <h3 id="metalstack.api.v2.AuditPhase">AuditPhase</h3>
 
       
         <h3 id="metalstack.api.v2.AuditService">AuditService</h3>
-        <p>AuditService serves audit related functions</p>
+        <p>AuditService provides audit logging operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -3695,14 +3707,14 @@ <h3 id="metalstack.api.v2.AuditService">AuditService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.AuditServiceGetRequest">AuditServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.AuditServiceGetResponse">AuditServiceGetResponse</a></td>
-                <td><p>Get an audit trace</p></td>
+                <td><p>Returns the audit trace with the specified UUID.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.AuditServiceListRequest">AuditServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.AuditServiceListResponse">AuditServiceListResponse</a></td>
-                <td><p>List audit traces</p></td>
+                <td><p>Returns the list of audit traces.</p></td>
               </tr>
             
           </tbody>
@@ -3718,7 +3730,7 @@ <h2 id="metalstack/admin/v2/audit.proto">metalstack/admin/v2/audit.proto</h2><a
 
       
         <h3 id="metalstack.admin.v2.AuditServiceGetRequest">AuditServiceGetRequest</h3>
-        <p>AuditServiceGetRequest is the request payload of a audit get request</p>
+        <p>AuditServiceGetRequest is the request payload for getting an audit trace.</p>
 
         
           <table class="field-table">
@@ -3749,7 +3761,7 @@ <h3 id="metalstack.admin.v2.AuditServiceGetRequest">AuditServiceGetRequest</h3>
         
       
         <h3 id="metalstack.admin.v2.AuditServiceGetResponse">AuditServiceGetResponse</h3>
-        <p>AuditServiceGetResponse is the response payload of a audit get request</p>
+        <p>AuditServiceGetResponse is the response payload for getting an audit trace.</p>
 
         
           <table class="field-table">
@@ -3773,7 +3785,7 @@ <h3 id="metalstack.admin.v2.AuditServiceGetResponse">AuditServiceGetResponse</h3
         
       
         <h3 id="metalstack.admin.v2.AuditServiceListRequest">AuditServiceListRequest</h3>
-        <p>AuditServiceListRequest is the request payload to list audits</p>
+        <p>AuditServiceListRequest is the request payload for listing audit traces.</p>
 
         
           <table class="field-table">
@@ -3797,7 +3809,7 @@ <h3 id="metalstack.admin.v2.AuditServiceListRequest">AuditServiceListRequest</h3
         
       
         <h3 id="metalstack.admin.v2.AuditServiceListResponse">AuditServiceListResponse</h3>
-        <p>AuditServiceListResponse is the response payload of a audit list request</p>
+        <p>AuditServiceListResponse is the response payload for listing audit traces.</p>
 
         
           <table class="field-table">
@@ -3810,7 +3822,7 @@ <h3 id="metalstack.admin.v2.AuditServiceListResponse">AuditServiceListResponse</
                   <td>traces</td>
                   <td><a href="#metalstack.api.v2.AuditTrace">metalstack.api.v2.AuditTrace</a></td>
                   <td>repeated</td>
-                  <td><p>Traces is a list of audit traces </p></td>
+                  <td><p>Traces contains the list of audit traces </p></td>
                 </tr>
               
             </tbody>
@@ -3827,7 +3839,7 @@ <h3 id="metalstack.admin.v2.AuditServiceListResponse">AuditServiceListResponse</
 
       
         <h3 id="metalstack.admin.v2.AuditService">AuditService</h3>
-        <p>AuditService serves audit related functions</p>
+        <p>AuditService provides audit logging operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -3838,14 +3850,14 @@ <h3 id="metalstack.admin.v2.AuditService">AuditService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.admin.v2.AuditServiceGetRequest">AuditServiceGetRequest</a></td>
                 <td><a href="#metalstack.admin.v2.AuditServiceGetResponse">AuditServiceGetResponse</a></td>
-                <td><p>Get an audit trace</p></td>
+                <td><p>Returns the audit trace with the specified UUID.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.AuditServiceListRequest">AuditServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.AuditServiceListResponse">AuditServiceListResponse</a></td>
-                <td><p>List all audit traces</p></td>
+                <td><p>Returns the list of all audit traces.</p></td>
               </tr>
             
           </tbody>
@@ -4691,7 +4703,7 @@ <h3 id="metalstack.api.v2.TokenType">TokenType</h3>
 
       
         <h3 id="metalstack.api.v2.TokenService">TokenService</h3>
-        <p>TokenService serves token related functions</p>
+        <p>TokenService provides token management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -4702,42 +4714,42 @@ <h3 id="metalstack.api.v2.TokenService">TokenService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.TokenServiceGetRequest">TokenServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.TokenServiceGetResponse">TokenServiceGetResponse</a></td>
-                <td><p>Get a token</p></td>
+                <td><p>Returns the token with the specified UUID.</p></td>
               </tr>
             
               <tr>
                 <td>Create</td>
                 <td><a href="#metalstack.api.v2.TokenServiceCreateRequest">TokenServiceCreateRequest</a></td>
                 <td><a href="#metalstack.api.v2.TokenServiceCreateResponse">TokenServiceCreateResponse</a></td>
-                <td><p>Create a token to authenticate against the platform, the secret will be only visible in the response.</p></td>
+                <td><p>Creates a token to authenticate against the platform, the secret will be only visible in the response.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.api.v2.TokenServiceUpdateRequest">TokenServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.api.v2.TokenServiceUpdateResponse">TokenServiceUpdateResponse</a></td>
-                <td><p>Update a token</p></td>
+                <td><p>Updates a token.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.TokenServiceListRequest">TokenServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.TokenServiceListResponse">TokenServiceListResponse</a></td>
-                <td><p>List all your tokens</p></td>
+                <td><p>Returns the list of all user tokens.</p></td>
               </tr>
             
               <tr>
                 <td>Revoke</td>
                 <td><a href="#metalstack.api.v2.TokenServiceRevokeRequest">TokenServiceRevokeRequest</a></td>
                 <td><a href="#metalstack.api.v2.TokenServiceRevokeResponse">TokenServiceRevokeResponse</a></td>
-                <td><p>Revoke a token, no further usage is possible afterwards</p></td>
+                <td><p>Revokes a token, no further usage is possible afterwards.</p></td>
               </tr>
             
               <tr>
                 <td>Refresh</td>
                 <td><a href="#metalstack.api.v2.TokenServiceRefreshRequest">TokenServiceRefreshRequest</a></td>
                 <td><a href="#metalstack.api.v2.TokenServiceRefreshResponse">TokenServiceRefreshResponse</a></td>
-                <td><p>Refresh a token, this will create a new token with the exact same permissions as the calling token contains</p></td>
+                <td><p>Refreshes a token, this will create a new token with the exact same permissions as the calling token contains.</p></td>
               </tr>
             
           </tbody>
@@ -4753,7 +4765,7 @@ <h2 id="metalstack/api/v2/version.proto">metalstack/api/v2/version.proto</h2><a
 
       
         <h3 id="metalstack.api.v2.Version">Version</h3>
-        <p>Version of the application</p>
+        <p>Version represents the version of the application.</p>
 
         
           <table class="field-table">
@@ -4798,14 +4810,14 @@ <h3 id="metalstack.api.v2.Version">Version</h3>
         
       
         <h3 id="metalstack.api.v2.VersionServiceGetRequest">VersionServiceGetRequest</h3>
-        <p>VersionServiceGetRequest is the request payload to get the version</p>
+        <p>VersionServiceGetRequest is the request payload for getting the version.</p>
 
         
 
         
       
         <h3 id="metalstack.api.v2.VersionServiceGetResponse">VersionServiceGetResponse</h3>
-        <p>VersionServiceGetResponse is the response payload with the version</p>
+        <p>VersionServiceGetResponse is the response payload for getting the version.</p>
 
         
           <table class="field-table">
@@ -4818,7 +4830,7 @@ <h3 id="metalstack.api.v2.VersionServiceGetResponse">VersionServiceGetResponse</
                   <td>version</td>
                   <td><a href="#metalstack.api.v2.Version">Version</a></td>
                   <td></td>
-                  <td><p>Version of the application </p></td>
+                  <td><p>Version contains the version of the application </p></td>
                 </tr>
               
             </tbody>
@@ -4835,7 +4847,7 @@ <h3 id="metalstack.api.v2.VersionServiceGetResponse">VersionServiceGetResponse</
 
       
         <h3 id="metalstack.api.v2.VersionService">VersionService</h3>
-        <p>VersionService serves version related functions</p>
+        <p>VersionService provides version information operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -4846,7 +4858,7 @@ <h3 id="metalstack.api.v2.VersionService">VersionService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.VersionServiceGetRequest">VersionServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.VersionServiceGetResponse">VersionServiceGetResponse</a></td>
-                <td><p>Get the version</p></td>
+                <td><p>Returns the version of the application.</p></td>
               </tr>
             
           </tbody>
@@ -5042,7 +5054,7 @@ <h2 id="metalstack/admin/v2/component.proto">metalstack/admin/v2/component.proto
 
       
         <h3 id="metalstack.admin.v2.ComponentServiceDeleteRequest">ComponentServiceDeleteRequest</h3>
-        <p>ComponentServiceGetRequest</p>
+        <p>ComponentServiceDeleteRequest is the request payload for deleting a component.</p>
 
         
           <table class="field-table">
@@ -5066,7 +5078,7 @@ <h3 id="metalstack.admin.v2.ComponentServiceDeleteRequest">ComponentServiceDelet
         
       
         <h3 id="metalstack.admin.v2.ComponentServiceDeleteResponse">ComponentServiceDeleteResponse</h3>
-        <p>ComponentServiceGetResponse</p>
+        <p>ComponentServiceDeleteResponse is the response payload for deleting a component.</p>
 
         
           <table class="field-table">
@@ -5079,7 +5091,7 @@ <h3 id="metalstack.admin.v2.ComponentServiceDeleteResponse">ComponentServiceDele
                   <td>component</td>
                   <td><a href="#metalstack.api.v2.Component">metalstack.api.v2.Component</a></td>
                   <td></td>
-                  <td><p>Component </p></td>
+                  <td><p>Component contains the deleted component </p></td>
                 </tr>
               
             </tbody>
@@ -5090,7 +5102,7 @@ <h3 id="metalstack.admin.v2.ComponentServiceDeleteResponse">ComponentServiceDele
         
       
         <h3 id="metalstack.admin.v2.ComponentServiceGetRequest">ComponentServiceGetRequest</h3>
-        <p>ComponentServiceGetRequest</p>
+        <p>ComponentServiceGetRequest is the request payload for getting a component.</p>
 
         
           <table class="field-table">
@@ -5114,7 +5126,7 @@ <h3 id="metalstack.admin.v2.ComponentServiceGetRequest">ComponentServiceGetReque
         
       
         <h3 id="metalstack.admin.v2.ComponentServiceGetResponse">ComponentServiceGetResponse</h3>
-        <p>ComponentServiceGetResponse</p>
+        <p>ComponentServiceGetResponse is the response payload for getting a component.</p>
 
         
           <table class="field-table">
@@ -5127,7 +5139,7 @@ <h3 id="metalstack.admin.v2.ComponentServiceGetResponse">ComponentServiceGetResp
                   <td>component</td>
                   <td><a href="#metalstack.api.v2.Component">metalstack.api.v2.Component</a></td>
                   <td></td>
-                  <td><p>Component </p></td>
+                  <td><p>Component contains the retrieved component </p></td>
                 </tr>
               
             </tbody>
@@ -5138,7 +5150,7 @@ <h3 id="metalstack.admin.v2.ComponentServiceGetResponse">ComponentServiceGetResp
         
       
         <h3 id="metalstack.admin.v2.ComponentServiceListRequest">ComponentServiceListRequest</h3>
-        <p>ComponentServiceListRequest</p>
+        <p>ComponentServiceListRequest is the request payload for listing components.</p>
 
         
           <table class="field-table">
@@ -5151,7 +5163,7 @@ <h3 id="metalstack.admin.v2.ComponentServiceListRequest">ComponentServiceListReq
                   <td>query</td>
                   <td><a href="#metalstack.api.v2.ComponentQuery">metalstack.api.v2.ComponentQuery</a></td>
                   <td></td>
-                  <td><p>Query components. </p></td>
+                  <td><p>Query filters components </p></td>
                 </tr>
               
             </tbody>
@@ -5162,7 +5174,7 @@ <h3 id="metalstack.admin.v2.ComponentServiceListRequest">ComponentServiceListReq
         
       
         <h3 id="metalstack.admin.v2.ComponentServiceListResponse">ComponentServiceListResponse</h3>
-        <p>ComponentServiceListResponse</p>
+        <p>ComponentServiceListResponse is the response payload for listing components.</p>
 
         
           <table class="field-table">
@@ -5175,7 +5187,7 @@ <h3 id="metalstack.admin.v2.ComponentServiceListResponse">ComponentServiceListRe
                   <td>components</td>
                   <td><a href="#metalstack.api.v2.Component">metalstack.api.v2.Component</a></td>
                   <td>repeated</td>
-                  <td><p>Components </p></td>
+                  <td><p>Components contains the list of components </p></td>
                 </tr>
               
             </tbody>
@@ -5192,7 +5204,7 @@ <h3 id="metalstack.admin.v2.ComponentServiceListResponse">ComponentServiceListRe
 
       
         <h3 id="metalstack.admin.v2.ComponentService">ComponentService</h3>
-        <p>ComponentService serves microservice related functions</p>
+        <p>ComponentService provides microservice component management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -5203,21 +5215,21 @@ <h3 id="metalstack.admin.v2.ComponentService">ComponentService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.admin.v2.ComponentServiceGetRequest">ComponentServiceGetRequest</a></td>
                 <td><a href="#metalstack.admin.v2.ComponentServiceGetResponse">ComponentServiceGetResponse</a></td>
-                <td><p>Get a single component</p></td>
+                <td><p>Returns the component with the specified UUID.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.admin.v2.ComponentServiceDeleteRequest">ComponentServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.admin.v2.ComponentServiceDeleteResponse">ComponentServiceDeleteResponse</a></td>
-                <td><p>Delete a component</p></td>
+                <td><p>Deletes the component with the specified UUID.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.ComponentServiceListRequest">ComponentServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.ComponentServiceListResponse">ComponentServiceListResponse</a></td>
-                <td><p>List all components with their status</p></td>
+                <td><p>Returns the list of all components with their status.</p></td>
               </tr>
             
           </tbody>
@@ -6043,7 +6055,7 @@ <h3 id="metalstack.api.v2.RaidLevel">RaidLevel</h3>
 
       
         <h3 id="metalstack.api.v2.FilesystemService">FilesystemService</h3>
-        <p>FilesystemService serves filesystem related functions</p>
+        <p>FilesystemService provides filesystem management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -6054,21 +6066,21 @@ <h3 id="metalstack.api.v2.FilesystemService">FilesystemService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.FilesystemServiceGetRequest">FilesystemServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.FilesystemServiceGetResponse">FilesystemServiceGetResponse</a></td>
-                <td><p>Get a filesystem</p></td>
+                <td><p>Returns the filesystem with the specified ID.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.FilesystemServiceListRequest">FilesystemServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.FilesystemServiceListResponse">FilesystemServiceListResponse</a></td>
-                <td><p>List all filesystems</p></td>
+                <td><p>Returns the list of all filesystems.</p></td>
               </tr>
             
               <tr>
                 <td>Match</td>
                 <td><a href="#metalstack.api.v2.FilesystemServiceMatchRequest">FilesystemServiceMatchRequest</a></td>
                 <td><a href="#metalstack.api.v2.FilesystemServiceMatchResponse">FilesystemServiceMatchResponse</a></td>
-                <td><p>Match a filesystems</p></td>
+                <td><p>Matches a filesystem to a size and image or machine.</p></td>
               </tr>
             
           </tbody>
@@ -6084,7 +6096,7 @@ <h2 id="metalstack/admin/v2/filesystem.proto">metalstack/admin/v2/filesystem.pro
 
       
         <h3 id="metalstack.admin.v2.FilesystemServiceCreateRequest">FilesystemServiceCreateRequest</h3>
-        <p>FilesystemServiceCreateRequest</p>
+        <p>FilesystemServiceCreateRequest is the request payload for creating a filesystem.</p>
 
         
           <table class="field-table">
@@ -6097,7 +6109,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceCreateRequest">FilesystemServiceCre
                   <td>filesystem_layout</td>
                   <td><a href="#metalstack.api.v2.FilesystemLayout">metalstack.api.v2.FilesystemLayout</a></td>
                   <td></td>
-                  <td><p>FilesystemLayout the filesystemlayout </p></td>
+                  <td><p>FilesystemLayout is the filesystem layout to create </p></td>
                 </tr>
               
             </tbody>
@@ -6108,7 +6120,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceCreateRequest">FilesystemServiceCre
         
       
         <h3 id="metalstack.admin.v2.FilesystemServiceCreateResponse">FilesystemServiceCreateResponse</h3>
-        <p>FilesystemServiceCreateResponse</p>
+        <p>FilesystemServiceCreateResponse is the response payload for creating a filesystem.</p>
 
         
           <table class="field-table">
@@ -6121,7 +6133,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceCreateResponse">FilesystemServiceCr
                   <td>filesystem_layout</td>
                   <td><a href="#metalstack.api.v2.FilesystemLayout">metalstack.api.v2.FilesystemLayout</a></td>
                   <td></td>
-                  <td><p>FilesystemLayout the filesystemlayout </p></td>
+                  <td><p>FilesystemLayout contains the created filesystem layout </p></td>
                 </tr>
               
             </tbody>
@@ -6132,7 +6144,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceCreateResponse">FilesystemServiceCr
         
       
         <h3 id="metalstack.admin.v2.FilesystemServiceDeleteRequest">FilesystemServiceDeleteRequest</h3>
-        <p>FilesystemServiceDeleteRequest</p>
+        <p>FilesystemServiceDeleteRequest is the request payload for deleting a filesystem.</p>
 
         
           <table class="field-table">
@@ -6156,7 +6168,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceDeleteRequest">FilesystemServiceDel
         
       
         <h3 id="metalstack.admin.v2.FilesystemServiceDeleteResponse">FilesystemServiceDeleteResponse</h3>
-        <p>message FilesystemServiceDeleteResponse {</p>
+        <p>FilesystemServiceDeleteResponse is the response payload for deleting a filesystem.</p>
 
         
           <table class="field-table">
@@ -6169,7 +6181,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceDeleteResponse">FilesystemServiceDe
                   <td>filesystem_layout</td>
                   <td><a href="#metalstack.api.v2.FilesystemLayout">metalstack.api.v2.FilesystemLayout</a></td>
                   <td></td>
-                  <td><p>FilesystemLayout the filesystemlayout </p></td>
+                  <td><p>FilesystemLayout contains the deleted filesystem layout </p></td>
                 </tr>
               
             </tbody>
@@ -6180,7 +6192,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceDeleteResponse">FilesystemServiceDe
         
       
         <h3 id="metalstack.admin.v2.FilesystemServiceUpdateRequest">FilesystemServiceUpdateRequest</h3>
-        <p>FilesystemServiceUpdateRequest</p>
+        <p>FilesystemServiceUpdateRequest is the request payload for updating a filesystem.</p>
 
         
           <table class="field-table">
@@ -6235,7 +6247,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceUpdateRequest">FilesystemServiceUpd
                   <td>raid</td>
                   <td><a href="#metalstack.api.v2.Raid">metalstack.api.v2.Raid</a></td>
                   <td>repeated</td>
-                  <td><p>raid arrays to create </p></td>
+                  <td><p>Raid arrays to create </p></td>
                 </tr>
               
                 <tr>
@@ -6267,7 +6279,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceUpdateRequest">FilesystemServiceUpd
         
       
         <h3 id="metalstack.admin.v2.FilesystemServiceUpdateResponse">FilesystemServiceUpdateResponse</h3>
-        <p>FilesystemServiceUpdateResponse</p>
+        <p>FilesystemServiceUpdateResponse is the response payload for updating a filesystem.</p>
 
         
           <table class="field-table">
@@ -6280,7 +6292,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceUpdateResponse">FilesystemServiceUp
                   <td>filesystem_layout</td>
                   <td><a href="#metalstack.api.v2.FilesystemLayout">metalstack.api.v2.FilesystemLayout</a></td>
                   <td></td>
-                  <td><p>FilesystemLayout the filesystemlayout </p></td>
+                  <td><p>FilesystemLayout contains the updated filesystem layout </p></td>
                 </tr>
               
             </tbody>
@@ -6297,7 +6309,7 @@ <h3 id="metalstack.admin.v2.FilesystemServiceUpdateResponse">FilesystemServiceUp
 
       
         <h3 id="metalstack.admin.v2.FilesystemService">FilesystemService</h3>
-        <p>FilesystemService serves filesystem related functions</p>
+        <p>FilesystemService provides filesystem management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -6308,21 +6320,21 @@ <h3 id="metalstack.admin.v2.FilesystemService">FilesystemService</h3>
                 <td>Create</td>
                 <td><a href="#metalstack.admin.v2.FilesystemServiceCreateRequest">FilesystemServiceCreateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.FilesystemServiceCreateResponse">FilesystemServiceCreateResponse</a></td>
-                <td><p>Create a filesystem</p></td>
+                <td><p>Creates a new filesystem.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.admin.v2.FilesystemServiceUpdateRequest">FilesystemServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.FilesystemServiceUpdateResponse">FilesystemServiceUpdateResponse</a></td>
-                <td><p>Update a filesystem</p></td>
+                <td><p>Updates a filesystem.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.admin.v2.FilesystemServiceDeleteRequest">FilesystemServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.admin.v2.FilesystemServiceDeleteResponse">FilesystemServiceDeleteResponse</a></td>
-                <td><p>Delete a filesystem</p></td>
+                <td><p>Deletes a filesystem.</p></td>
               </tr>
             
           </tbody>
@@ -6737,7 +6749,7 @@ <h3 id="metalstack.api.v2.ImageFeature">ImageFeature</h3>
 
       
         <h3 id="metalstack.api.v2.ImageService">ImageService</h3>
-        <p>ImageService serves image related functions</p>
+        <p>ImageService provides image management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -6748,21 +6760,21 @@ <h3 id="metalstack.api.v2.ImageService">ImageService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.ImageServiceGetRequest">ImageServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.ImageServiceGetResponse">ImageServiceGetResponse</a></td>
-                <td><p>Get a image</p></td>
+                <td><p>Returns the image with the specified ID.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.ImageServiceListRequest">ImageServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.ImageServiceListResponse">ImageServiceListResponse</a></td>
-                <td><p>List all images</p></td>
+                <td><p>Returns the list of all images.</p></td>
               </tr>
             
               <tr>
                 <td>Latest</td>
                 <td><a href="#metalstack.api.v2.ImageServiceLatestRequest">ImageServiceLatestRequest</a></td>
                 <td><a href="#metalstack.api.v2.ImageServiceLatestResponse">ImageServiceLatestResponse</a></td>
-                <td><p>Latest image for a specific os</p></td>
+                <td><p>Returns the latest image for a specific operating system.</p></td>
               </tr>
             
           </tbody>
@@ -6778,7 +6790,7 @@ <h2 id="metalstack/admin/v2/image.proto">metalstack/admin/v2/image.proto</h2><a
 
       
         <h3 id="metalstack.admin.v2.ImageServiceCreateRequest">ImageServiceCreateRequest</h3>
-        <p>ImageServiceCreateRequest</p>
+        <p>ImageServiceCreateRequest is the request payload for creating an image.</p>
 
         
           <table class="field-table">
@@ -6791,7 +6803,7 @@ <h3 id="metalstack.admin.v2.ImageServiceCreateRequest">ImageServiceCreateRequest
                   <td>image</td>
                   <td><a href="#metalstack.api.v2.Image">metalstack.api.v2.Image</a></td>
                   <td></td>
-                  <td><p>Image is the image </p></td>
+                  <td><p>Image is the image to create </p></td>
                 </tr>
               
             </tbody>
@@ -6802,7 +6814,7 @@ <h3 id="metalstack.admin.v2.ImageServiceCreateRequest">ImageServiceCreateRequest
         
       
         <h3 id="metalstack.admin.v2.ImageServiceCreateResponse">ImageServiceCreateResponse</h3>
-        <p>ImageServiceCreateResponse</p>
+        <p>ImageServiceCreateResponse is the response payload for creating an image.</p>
 
         
           <table class="field-table">
@@ -6815,7 +6827,7 @@ <h3 id="metalstack.admin.v2.ImageServiceCreateResponse">ImageServiceCreateRespon
                   <td>image</td>
                   <td><a href="#metalstack.api.v2.Image">metalstack.api.v2.Image</a></td>
                   <td></td>
-                  <td><p>Image is the image </p></td>
+                  <td><p>Image contains the created image </p></td>
                 </tr>
               
             </tbody>
@@ -6826,7 +6838,7 @@ <h3 id="metalstack.admin.v2.ImageServiceCreateResponse">ImageServiceCreateRespon
         
       
         <h3 id="metalstack.admin.v2.ImageServiceDeleteRequest">ImageServiceDeleteRequest</h3>
-        <p>ImageServiceDeleteRequest</p>
+        <p>ImageServiceDeleteRequest is the request payload for deleting an image.</p>
 
         
           <table class="field-table">
@@ -6850,7 +6862,7 @@ <h3 id="metalstack.admin.v2.ImageServiceDeleteRequest">ImageServiceDeleteRequest
         
       
         <h3 id="metalstack.admin.v2.ImageServiceDeleteResponse">ImageServiceDeleteResponse</h3>
-        <p>message ImageServiceDeleteResponse {</p>
+        <p>ImageServiceDeleteResponse is the response payload for deleting an image.</p>
 
         
           <table class="field-table">
@@ -6863,7 +6875,7 @@ <h3 id="metalstack.admin.v2.ImageServiceDeleteResponse">ImageServiceDeleteRespon
                   <td>image</td>
                   <td><a href="#metalstack.api.v2.Image">metalstack.api.v2.Image</a></td>
                   <td></td>
-                  <td><p>ImageLayout the imagelayout </p></td>
+                  <td><p>Image contains the deleted image </p></td>
                 </tr>
               
             </tbody>
@@ -6874,7 +6886,7 @@ <h3 id="metalstack.admin.v2.ImageServiceDeleteResponse">ImageServiceDeleteRespon
         
       
         <h3 id="metalstack.admin.v2.ImageServiceUpdateRequest">ImageServiceUpdateRequest</h3>
-        <p>ImageServiceUpdateRequest</p>
+        <p>ImageServiceUpdateRequest is the request payload for updating an image.</p>
 
         
           <table class="field-table">
@@ -6908,14 +6920,14 @@ <h3 id="metalstack.admin.v2.ImageServiceUpdateRequest">ImageServiceUpdateRequest
                   <td>name</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Name of this imageLayout </p></td>
+                  <td><p>Name of this image </p></td>
                 </tr>
               
                 <tr>
                   <td>description</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Description of this imageLayout </p></td>
+                  <td><p>Description of this image </p></td>
                 </tr>
               
                 <tr>
@@ -6947,7 +6959,7 @@ <h3 id="metalstack.admin.v2.ImageServiceUpdateRequest">ImageServiceUpdateRequest
         
       
         <h3 id="metalstack.admin.v2.ImageServiceUpdateResponse">ImageServiceUpdateResponse</h3>
-        <p>ImageServiceUpdateResponse</p>
+        <p>ImageServiceUpdateResponse is the response payload for updating an image.</p>
 
         
           <table class="field-table">
@@ -6960,7 +6972,7 @@ <h3 id="metalstack.admin.v2.ImageServiceUpdateResponse">ImageServiceUpdateRespon
                   <td>image</td>
                   <td><a href="#metalstack.api.v2.Image">metalstack.api.v2.Image</a></td>
                   <td></td>
-                  <td><p>Image is the image </p></td>
+                  <td><p>Image contains the updated image </p></td>
                 </tr>
               
             </tbody>
@@ -6971,7 +6983,7 @@ <h3 id="metalstack.admin.v2.ImageServiceUpdateResponse">ImageServiceUpdateRespon
         
       
         <h3 id="metalstack.admin.v2.ImageServiceUsageRequest">ImageServiceUsageRequest</h3>
-        <p>ImageServiceUsageRequest</p>
+        <p>ImageServiceUsageRequest is the request payload for getting image usage.</p>
 
         
           <table class="field-table">
@@ -6995,7 +7007,7 @@ <h3 id="metalstack.admin.v2.ImageServiceUsageRequest">ImageServiceUsageRequest</
         
       
         <h3 id="metalstack.admin.v2.ImageServiceUsageResponse">ImageServiceUsageResponse</h3>
-        <p>ImageServiceUsageResponse</p>
+        <p>ImageServiceUsageResponse is the response payload for getting image usage.</p>
 
         
           <table class="field-table">
@@ -7008,7 +7020,7 @@ <h3 id="metalstack.admin.v2.ImageServiceUsageResponse">ImageServiceUsageResponse
                   <td>image_usage</td>
                   <td><a href="#metalstack.api.v2.ImageUsage">metalstack.api.v2.ImageUsage</a></td>
                   <td>repeated</td>
-                  <td><p>Images with usage </p></td>
+                  <td><p>Images contains usage information </p></td>
                 </tr>
               
             </tbody>
@@ -7025,7 +7037,7 @@ <h3 id="metalstack.admin.v2.ImageServiceUsageResponse">ImageServiceUsageResponse
 
       
         <h3 id="metalstack.admin.v2.ImageService">ImageService</h3>
-        <p>ImageService serves image related functions</p>
+        <p>ImageService provides image management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -7036,28 +7048,28 @@ <h3 id="metalstack.admin.v2.ImageService">ImageService</h3>
                 <td>Create</td>
                 <td><a href="#metalstack.admin.v2.ImageServiceCreateRequest">ImageServiceCreateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.ImageServiceCreateResponse">ImageServiceCreateResponse</a></td>
-                <td><p>Create a image</p></td>
+                <td><p>Creates a new image.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.admin.v2.ImageServiceUpdateRequest">ImageServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.ImageServiceUpdateResponse">ImageServiceUpdateResponse</a></td>
-                <td><p>Update a image</p></td>
+                <td><p>Updates an image.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.admin.v2.ImageServiceDeleteRequest">ImageServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.admin.v2.ImageServiceDeleteResponse">ImageServiceDeleteResponse</a></td>
-                <td><p>Delete a image</p></td>
+                <td><p>Deletes an image.</p></td>
               </tr>
             
               <tr>
                 <td>Usage</td>
                 <td><a href="#metalstack.admin.v2.ImageServiceUsageRequest">ImageServiceUsageRequest</a></td>
                 <td><a href="#metalstack.admin.v2.ImageServiceUsageResponse">ImageServiceUsageResponse</a></td>
-                <td><p>Usage of images</p></td>
+                <td><p>Returns the usage of images.</p></td>
               </tr>
             
           </tbody>
@@ -7678,7 +7690,7 @@ <h3 id="metalstack.api.v2.IPType">IPType</h3>
 
       
         <h3 id="metalstack.api.v2.IPService">IPService</h3>
-        <p>IPService serves ip address related functions</p>
+        <p>IPService provides IP address management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -7689,35 +7701,35 @@ <h3 id="metalstack.api.v2.IPService">IPService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.IPServiceGetRequest">IPServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.IPServiceGetResponse">IPServiceGetResponse</a></td>
-                <td><p>Get a ip</p></td>
+                <td><p>Returns the IP address with the specified IP.</p></td>
               </tr>
             
               <tr>
                 <td>Create</td>
                 <td><a href="#metalstack.api.v2.IPServiceCreateRequest">IPServiceCreateRequest</a></td>
                 <td><a href="#metalstack.api.v2.IPServiceCreateResponse">IPServiceCreateResponse</a></td>
-                <td><p>Create a ip</p></td>
+                <td><p>Creates a new IP address.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.api.v2.IPServiceUpdateRequest">IPServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.api.v2.IPServiceUpdateResponse">IPServiceUpdateResponse</a></td>
-                <td><p>Update a ip</p></td>
+                <td><p>Updates an IP address.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.IPServiceListRequest">IPServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.IPServiceListResponse">IPServiceListResponse</a></td>
-                <td><p>List all ips</p></td>
+                <td><p>Returns the list of all IP addresses.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.api.v2.IPServiceDeleteRequest">IPServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.api.v2.IPServiceDeleteResponse">IPServiceDeleteResponse</a></td>
-                <td><p>Delete a ip</p></td>
+                <td><p>Deletes an IP address.</p></td>
               </tr>
             
           </tbody>
@@ -7733,7 +7745,7 @@ <h2 id="metalstack/admin/v2/ip.proto">metalstack/admin/v2/ip.proto</h2><a href="
 
       
         <h3 id="metalstack.admin.v2.IPServiceListRequest">IPServiceListRequest</h3>
-        <p>IPServiceListRequest</p>
+        <p>IPServiceListRequest is the request payload for listing IP addresses.</p>
 
         
           <table class="field-table">
@@ -7746,7 +7758,7 @@ <h3 id="metalstack.admin.v2.IPServiceListRequest">IPServiceListRequest</h3>
                   <td>query</td>
                   <td><a href="#metalstack.api.v2.IPQuery">metalstack.api.v2.IPQuery</a></td>
                   <td></td>
-                  <td><p>Query to search for one or more ips </p></td>
+                  <td><p>Query to search for IP addresses </p></td>
                 </tr>
               
             </tbody>
@@ -7757,7 +7769,7 @@ <h3 id="metalstack.admin.v2.IPServiceListRequest">IPServiceListRequest</h3>
         
       
         <h3 id="metalstack.admin.v2.IPServiceListResponse">IPServiceListResponse</h3>
-        <p>IPServiceListResponse</p>
+        <p>IPServiceListResponse is the response payload for listing IP addresses.</p>
 
         
           <table class="field-table">
@@ -7770,7 +7782,7 @@ <h3 id="metalstack.admin.v2.IPServiceListResponse">IPServiceListResponse</h3>
                   <td>ips</td>
                   <td><a href="#metalstack.api.v2.IP">metalstack.api.v2.IP</a></td>
                   <td>repeated</td>
-                  <td><p>IPs are the list of ips </p></td>
+                  <td><p>IPs contains the list of IP addresses </p></td>
                 </tr>
               
             </tbody>
@@ -7787,7 +7799,7 @@ <h3 id="metalstack.admin.v2.IPServiceListResponse">IPServiceListResponse</h3>
 
       
         <h3 id="metalstack.admin.v2.IPService">IPService</h3>
-        <p>IPService serves ip address related functions</p>
+        <p>IPService provides IP address management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -7798,7 +7810,7 @@ <h3 id="metalstack.admin.v2.IPService">IPService</h3>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.IPServiceListRequest">IPServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.IPServiceListResponse">IPServiceListResponse</a></td>
-                <td><p>List all ips</p></td>
+                <td><p>Returns the list of all IP addresses.</p></td>
               </tr>
             
           </tbody>
@@ -8719,7 +8731,7 @@ <h3 id="metalstack.api.v2.NetworkType">NetworkType</h3>
 
       
         <h3 id="metalstack.api.v2.NetworkService">NetworkService</h3>
-        <p>NetworkService serves network address related functions for end users, e.g. with project scope</p>
+        <p>NetworkService provides network management operations for end users, for example with project scope.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -8730,42 +8742,42 @@ <h3 id="metalstack.api.v2.NetworkService">NetworkService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.NetworkServiceGetRequest">NetworkServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.NetworkServiceGetResponse">NetworkServiceGetResponse</a></td>
-                <td><p>Get a network</p></td>
+                <td><p>Returns the network with the specified ID.</p></td>
               </tr>
             
               <tr>
                 <td>Create</td>
                 <td><a href="#metalstack.api.v2.NetworkServiceCreateRequest">NetworkServiceCreateRequest</a></td>
                 <td><a href="#metalstack.api.v2.NetworkServiceCreateResponse">NetworkServiceCreateResponse</a></td>
-                <td><p>Create a child network from a super network.</p></td>
+                <td><p>Creates a child network from a super network.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.api.v2.NetworkServiceUpdateRequest">NetworkServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.api.v2.NetworkServiceUpdateResponse">NetworkServiceUpdateResponse</a></td>
-                <td><p>Update a network</p></td>
+                <td><p>Updates a network.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.NetworkServiceListRequest">NetworkServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.NetworkServiceListResponse">NetworkServiceListResponse</a></td>
-                <td><p>List all project networks</p></td>
+                <td><p>Returns the list of all project networks.</p></td>
               </tr>
             
               <tr>
                 <td>ListBaseNetworks</td>
                 <td><a href="#metalstack.api.v2.NetworkServiceListBaseNetworksRequest">NetworkServiceListBaseNetworksRequest</a></td>
                 <td><a href="#metalstack.api.v2.NetworkServiceListBaseNetworksResponse">NetworkServiceListBaseNetworksResponse</a></td>
-                <td><p>ListBaseNetworks all base networks that can be used for either child network or ip allocation</p></td>
+                <td><p>ListBaseNetworks returns all base networks that can be used for either child network or IP allocation.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.api.v2.NetworkServiceDeleteRequest">NetworkServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.api.v2.NetworkServiceDeleteResponse">NetworkServiceDeleteResponse</a></td>
-                <td><p>Delete a network</p></td>
+                <td><p>Deletes a network.</p></td>
               </tr>
             
           </tbody>
@@ -9067,7 +9079,7 @@ <h3 id="metalstack.api.v2.PartitionServiceListResponse">PartitionServiceListResp
 
       
         <h3 id="metalstack.api.v2.PartitionService">PartitionService</h3>
-        <p>PartitionService serves partition address related functions</p>
+        <p>PartitionService provides partition management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -9078,14 +9090,14 @@ <h3 id="metalstack.api.v2.PartitionService">PartitionService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.PartitionServiceGetRequest">PartitionServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.PartitionServiceGetResponse">PartitionServiceGetResponse</a></td>
-                <td><p>Get a partition</p></td>
+                <td><p>Returns the partition with the specified ID.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.PartitionServiceListRequest">PartitionServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.PartitionServiceListResponse">PartitionServiceListResponse</a></td>
-                <td><p>List all partitions</p></td>
+                <td><p>Returns the list of all partitions.</p></td>
               </tr>
             
           </tbody>
@@ -9386,7 +9398,7 @@ <h3 id="metalstack.api.v2.SizeConstraintType">SizeConstraintType</h3>
 
       
         <h3 id="metalstack.api.v2.SizeService">SizeService</h3>
-        <p>SizeService serves size related functions</p>
+        <p>SizeService provides size management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -9397,14 +9409,14 @@ <h3 id="metalstack.api.v2.SizeService">SizeService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.SizeServiceGetRequest">SizeServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.SizeServiceGetResponse">SizeServiceGetResponse</a></td>
-                <td><p>Get a size</p></td>
+                <td><p>Returns the size with the specified ID.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.SizeServiceListRequest">SizeServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.SizeServiceListResponse">SizeServiceListResponse</a></td>
-                <td><p>List all sizes</p></td>
+                <td><p>Returns the list of all sizes.</p></td>
               </tr>
             
           </tbody>
@@ -12100,7 +12112,7 @@ <h3 id="metalstack.api.v2.MachineState">MachineState</h3>
 
       
         <h3 id="metalstack.api.v2.MachineService">MachineService</h3>
-        <p>MachineService serves machine related functions</p>
+        <p>MachineService provides machine lifecycle management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -12111,49 +12123,49 @@ <h3 id="metalstack.api.v2.MachineService">MachineService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.MachineServiceGetRequest">MachineServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.MachineServiceGetResponse">MachineServiceGetResponse</a></td>
-                <td><p>Get a machine</p></td>
+                <td><p>Returns the machine with the specified UUID.</p></td>
               </tr>
             
               <tr>
                 <td>Create</td>
                 <td><a href="#metalstack.api.v2.MachineServiceCreateRequest">MachineServiceCreateRequest</a></td>
                 <td><a href="#metalstack.api.v2.MachineServiceCreateResponse">MachineServiceCreateResponse</a></td>
-                <td><p>Create a machine</p></td>
+                <td><p>Creates a new machine.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.api.v2.MachineServiceUpdateRequest">MachineServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.api.v2.MachineServiceUpdateResponse">MachineServiceUpdateResponse</a></td>
-                <td><p>Update a machine</p></td>
+                <td><p>Updates a machine.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.MachineServiceListRequest">MachineServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.MachineServiceListResponse">MachineServiceListResponse</a></td>
-                <td><p>List all machines</p></td>
+                <td><p>Returns the list of all machines.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.api.v2.MachineServiceDeleteRequest">MachineServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.api.v2.MachineServiceDeleteResponse">MachineServiceDeleteResponse</a></td>
-                <td><p>Delete a machine</p></td>
+                <td><p>Deletes a machine.</p></td>
               </tr>
             
               <tr>
                 <td>BMCCommand</td>
                 <td><a href="#metalstack.api.v2.MachineServiceBMCCommandRequest">MachineServiceBMCCommandRequest</a></td>
                 <td><a href="#metalstack.api.v2.MachineServiceBMCCommandResponse">MachineServiceBMCCommandResponse</a></td>
-                <td><p>BMCCommand send a command to the bmc of a machine</p></td>
+                <td><p>BMCCommand sends a command to the BMC of a machine.</p></td>
               </tr>
             
               <tr>
                 <td>GetBMC</td>
                 <td><a href="#metalstack.api.v2.MachineServiceGetBMCRequest">MachineServiceGetBMCRequest</a></td>
                 <td><a href="#metalstack.api.v2.MachineServiceGetBMCResponse">MachineServiceGetBMCResponse</a></td>
-                <td><p>GetBMC returns the BMC details of a machine</p></td>
+                <td><p>Returns the BMC details of a machine.</p></td>
               </tr>
             
           </tbody>
@@ -12207,7 +12219,7 @@ <h3 id="metalstack.admin.v2.MachineServiceBMCCommandResponse">MachineServiceBMCC
         
       
         <h3 id="metalstack.admin.v2.MachineServiceConsolePasswordRequest">MachineServiceConsolePasswordRequest</h3>
-        <p>MachineServiceConsolePasswordRequest is the request to get the console password</p>
+        <p>MachineServiceConsolePasswordRequest is the request payload for getting the console password.</p>
 
         
           <table class="field-table">
@@ -12227,7 +12239,7 @@ <h3 id="metalstack.admin.v2.MachineServiceConsolePasswordRequest">MachineService
                   <td>reason</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Reason must be provided why access to the console is requested.
+                  <td><p>Reason must be provided why access to the console is requested
 Reason is only forwarded to an audit sink </p></td>
                 </tr>
               
@@ -12239,7 +12251,7 @@ <h3 id="metalstack.admin.v2.MachineServiceConsolePasswordRequest">MachineService
         
       
         <h3 id="metalstack.admin.v2.MachineServiceConsolePasswordResponse">MachineServiceConsolePasswordResponse</h3>
-        <p>MachineServiceConsolePasswordResponse is the response to the console password request</p>
+        <p>MachineServiceConsolePasswordResponse is the response payload for getting the console password.</p>
 
         
           <table class="field-table">
@@ -12514,7 +12526,7 @@ <h3 id="metalstack.admin.v2.MachineServiceListResponse">MachineServiceListRespon
 
       
         <h3 id="metalstack.admin.v2.MachineService">MachineService</h3>
-        <p>MachineService serves machine related functions</p>
+        <p>MachineService provides machine lifecycle management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -12525,42 +12537,42 @@ <h3 id="metalstack.admin.v2.MachineService">MachineService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.admin.v2.MachineServiceGetRequest">MachineServiceGetRequest</a></td>
                 <td><a href="#metalstack.admin.v2.MachineServiceGetResponse">MachineServiceGetResponse</a></td>
-                <td><p>Get a machine</p></td>
+                <td><p>Returns the machine with the specified UUID.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.MachineServiceListRequest">MachineServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.MachineServiceListResponse">MachineServiceListResponse</a></td>
-                <td><p>List all machines</p></td>
+                <td><p>Returns the list of all machines.</p></td>
               </tr>
             
               <tr>
                 <td>BMCCommand</td>
                 <td><a href="#metalstack.admin.v2.MachineServiceBMCCommandRequest">MachineServiceBMCCommandRequest</a></td>
                 <td><a href="#metalstack.admin.v2.MachineServiceBMCCommandResponse">MachineServiceBMCCommandResponse</a></td>
-                <td><p>BMCCommand send a command to the bmc of a machine</p></td>
+                <td><p>BMCCommand sends a command to the BMC of a machine.</p></td>
               </tr>
             
               <tr>
                 <td>GetBMC</td>
                 <td><a href="#metalstack.admin.v2.MachineServiceGetBMCRequest">MachineServiceGetBMCRequest</a></td>
                 <td><a href="#metalstack.admin.v2.MachineServiceGetBMCResponse">MachineServiceGetBMCResponse</a></td>
-                <td><p>GetBMC returns the BMC details of a machine</p></td>
+                <td><p>Returns the BMC details of a machine.</p></td>
               </tr>
             
               <tr>
                 <td>ListBMC</td>
                 <td><a href="#metalstack.admin.v2.MachineServiceListBMCRequest">MachineServiceListBMCRequest</a></td>
                 <td><a href="#metalstack.admin.v2.MachineServiceListBMCResponse">MachineServiceListBMCResponse</a></td>
-                <td><p>ListBMC returns the BMC details of many machines</p></td>
+                <td><p>ListBMC returns the BMC details of many machines.</p></td>
               </tr>
             
               <tr>
                 <td>ConsolePassword</td>
                 <td><a href="#metalstack.admin.v2.MachineServiceConsolePasswordRequest">MachineServiceConsolePasswordRequest</a></td>
                 <td><a href="#metalstack.admin.v2.MachineServiceConsolePasswordResponse">MachineServiceConsolePasswordResponse</a></td>
-                <td><p>ConsolePassword returns the password to access the serial console of the machine</p></td>
+                <td><p>GetConsolePassword returns the password to access the serial console of the machine.</p></td>
               </tr>
             
           </tbody>
@@ -12576,7 +12588,7 @@ <h2 id="metalstack/admin/v2/network.proto">metalstack/admin/v2/network.proto</h2
 
       
         <h3 id="metalstack.admin.v2.NetworkServiceCreateRequest">NetworkServiceCreateRequest</h3>
-        <p>NetworkServiceCreateRequest</p>
+        <p>NetworkServiceCreateRequest is the request payload for creating a network.</p>
 
         
           <table class="field-table">
@@ -12673,7 +12685,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceCreateRequest">NetworkServiceCreateReq
                   <td>vrf</td>
                   <td><a href="#uint32">uint32</a></td>
                   <td>optional</td>
-                  <td><p>VRF of this network has this VNI. </p></td>
+                  <td><p>VRF of this network has this VNI </p></td>
                 </tr>
               
                 <tr>
@@ -12712,7 +12724,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceCreateRequest">NetworkServiceCreateReq
         
       
         <h3 id="metalstack.admin.v2.NetworkServiceCreateResponse">NetworkServiceCreateResponse</h3>
-        <p>NetworkServiceCreateResponse is the response payload for a network create request</p>
+        <p>NetworkServiceCreateResponse is the response payload for creating a network.</p>
 
         
           <table class="field-table">
@@ -12725,7 +12737,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceCreateResponse">NetworkServiceCreateRe
                   <td>network</td>
                   <td><a href="#metalstack.api.v2.Network">metalstack.api.v2.Network</a></td>
                   <td></td>
-                  <td><p>Network the network </p></td>
+                  <td><p>Network contains the created network </p></td>
                 </tr>
               
             </tbody>
@@ -12736,7 +12748,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceCreateResponse">NetworkServiceCreateRe
         
       
         <h3 id="metalstack.admin.v2.NetworkServiceDeleteRequest">NetworkServiceDeleteRequest</h3>
-        <p>NetworkServiceDeleteRequest is the request payload for a network delete request</p>
+        <p>NetworkServiceDeleteRequest is the request payload for deleting a network.</p>
 
         
           <table class="field-table">
@@ -12760,7 +12772,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceDeleteRequest">NetworkServiceDeleteReq
         
       
         <h3 id="metalstack.admin.v2.NetworkServiceDeleteResponse">NetworkServiceDeleteResponse</h3>
-        <p>NetworkServiceCapacityResponse is the response payload for a network delete request</p>
+        <p>NetworkServiceDeleteResponse is the response payload for deleting a network.</p>
 
         
           <table class="field-table">
@@ -12773,7 +12785,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceDeleteResponse">NetworkServiceDeleteRe
                   <td>network</td>
                   <td><a href="#metalstack.api.v2.Network">metalstack.api.v2.Network</a></td>
                   <td></td>
-                  <td><p>Network the network </p></td>
+                  <td><p>Network contains the deleted network </p></td>
                 </tr>
               
             </tbody>
@@ -12784,7 +12796,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceDeleteResponse">NetworkServiceDeleteRe
         
       
         <h3 id="metalstack.admin.v2.NetworkServiceGetRequest">NetworkServiceGetRequest</h3>
-        <p>NetworkServiceGetRequest</p>
+        <p>NetworkServiceGetRequest is the request payload for getting a network.</p>
 
         
           <table class="field-table">
@@ -12808,7 +12820,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceGetRequest">NetworkServiceGetRequest</
         
       
         <h3 id="metalstack.admin.v2.NetworkServiceGetResponse">NetworkServiceGetResponse</h3>
-        <p>NetworkServiceGetResponse</p>
+        <p>NetworkServiceGetResponse is the response payload for getting a network.</p>
 
         
           <table class="field-table">
@@ -12821,7 +12833,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceGetResponse">NetworkServiceGetResponse
                   <td>network</td>
                   <td><a href="#metalstack.api.v2.Network">metalstack.api.v2.Network</a></td>
                   <td></td>
-                  <td><p>Network which was requested to get </p></td>
+                  <td><p>Network contains the requested network </p></td>
                 </tr>
               
             </tbody>
@@ -12832,7 +12844,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceGetResponse">NetworkServiceGetResponse
         
       
         <h3 id="metalstack.admin.v2.NetworkServiceListRequest">NetworkServiceListRequest</h3>
-        <p>NetworkServiceListRequest</p>
+        <p>NetworkServiceListRequest is the request payload for listing networks.</p>
 
         
           <table class="field-table">
@@ -12845,7 +12857,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceListRequest">NetworkServiceListRequest
                   <td>query</td>
                   <td><a href="#metalstack.api.v2.NetworkQuery">metalstack.api.v2.NetworkQuery</a></td>
                   <td></td>
-                  <td><p>Query which specifies which networks to return </p></td>
+                  <td><p>Query specifies which networks to return </p></td>
                 </tr>
               
             </tbody>
@@ -12856,7 +12868,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceListRequest">NetworkServiceListRequest
         
       
         <h3 id="metalstack.admin.v2.NetworkServiceListResponse">NetworkServiceListResponse</h3>
-        <p>NetworkServiceListResponse</p>
+        <p>NetworkServiceListResponse is the response payload for listing networks.</p>
 
         
           <table class="field-table">
@@ -12869,7 +12881,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceListResponse">NetworkServiceListRespon
                   <td>networks</td>
                   <td><a href="#metalstack.api.v2.Network">metalstack.api.v2.Network</a></td>
                   <td>repeated</td>
-                  <td><p>Networks are the requested networks </p></td>
+                  <td><p>Networks contains the list of networks </p></td>
                 </tr>
               
             </tbody>
@@ -12880,7 +12892,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceListResponse">NetworkServiceListRespon
         
       
         <h3 id="metalstack.admin.v2.NetworkServiceUpdateRequest">NetworkServiceUpdateRequest</h3>
-        <p>NetworkServiceUpdateRequest is the request payload for a network update request</p>
+        <p>NetworkServiceUpdateRequest is the request payload for updating a network.</p>
 
         
           <table class="field-table">
@@ -12942,7 +12954,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceUpdateRequest">NetworkServiceUpdateReq
                   <td>default_child_prefix_length</td>
                   <td><a href="#metalstack.api.v2.ChildPrefixLength">metalstack.api.v2.ChildPrefixLength</a></td>
                   <td>optional</td>
-                  <td><p>Default Child Prefix length defines the bit length of a child network created per addressfamily, of not specified during the allocate request </p></td>
+                  <td><p>Default Child Prefix length defines the bit length of a child network created per addressfamily, if not specified during the allocate request </p></td>
                 </tr>
               
                 <tr>
@@ -12970,7 +12982,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceUpdateRequest">NetworkServiceUpdateReq
                   <td>force</td>
                   <td><a href="#bool">bool</a></td>
                   <td></td>
-                  <td><p>Force update, actually only prevents accidental removal of additional_announcable_cidrs which will destroy your dataplane in fact. </p></td>
+                  <td><p>Force update, prevents accidental removal of additional_announcable_cidrs which will destroy your dataplane. </p></td>
                 </tr>
               
             </tbody>
@@ -12981,7 +12993,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceUpdateRequest">NetworkServiceUpdateReq
         
       
         <h3 id="metalstack.admin.v2.NetworkServiceUpdateResponse">NetworkServiceUpdateResponse</h3>
-        <p>NetworkServiceUpdateResponse is the response payload for a network update request</p>
+        <p>NetworkServiceUpdateResponse is the response payload for updating a network.</p>
 
         
           <table class="field-table">
@@ -12994,7 +13006,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceUpdateResponse">NetworkServiceUpdateRe
                   <td>network</td>
                   <td><a href="#metalstack.api.v2.Network">metalstack.api.v2.Network</a></td>
                   <td></td>
-                  <td><p>Network the network </p></td>
+                  <td><p>Network contains the updated network </p></td>
                 </tr>
               
             </tbody>
@@ -13011,7 +13023,7 @@ <h3 id="metalstack.admin.v2.NetworkServiceUpdateResponse">NetworkServiceUpdateRe
 
       
         <h3 id="metalstack.admin.v2.NetworkService">NetworkService</h3>
-        <p>NetworkService serves network address related functions</p>
+        <p>NetworkService provides network management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -13022,35 +13034,35 @@ <h3 id="metalstack.admin.v2.NetworkService">NetworkService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.admin.v2.NetworkServiceGetRequest">NetworkServiceGetRequest</a></td>
                 <td><a href="#metalstack.admin.v2.NetworkServiceGetResponse">NetworkServiceGetResponse</a></td>
-                <td><p>Get a network</p></td>
+                <td><p>Returns the network with the specified ID.</p></td>
               </tr>
             
               <tr>
                 <td>Create</td>
                 <td><a href="#metalstack.admin.v2.NetworkServiceCreateRequest">NetworkServiceCreateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.NetworkServiceCreateResponse">NetworkServiceCreateResponse</a></td>
-                <td><p>Create a network</p></td>
+                <td><p>Creates a new network.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.admin.v2.NetworkServiceUpdateRequest">NetworkServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.NetworkServiceUpdateResponse">NetworkServiceUpdateResponse</a></td>
-                <td><p>Update a network</p></td>
+                <td><p>Updates a network.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.admin.v2.NetworkServiceDeleteRequest">NetworkServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.admin.v2.NetworkServiceDeleteResponse">NetworkServiceDeleteResponse</a></td>
-                <td><p>Delete a network</p></td>
+                <td><p>Deletes a network.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.NetworkServiceListRequest">NetworkServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.NetworkServiceListResponse">NetworkServiceListResponse</a></td>
-                <td><p>List all networks</p></td>
+                <td><p>Returns the list of all networks.</p></td>
               </tr>
             
           </tbody>
@@ -13222,7 +13234,7 @@ <h3 id="metalstack.admin.v2.PartitionCapacity">PartitionCapacity</h3>
         
       
         <h3 id="metalstack.admin.v2.PartitionServiceCapacityRequest">PartitionServiceCapacityRequest</h3>
-        <p>PartitionServiceListRequest is the request payload for a partition capacity request</p>
+        <p>PartitionServiceCapacityRequest is the request payload for getting partition capacity.</p>
 
         
           <table class="field-table">
@@ -13356,7 +13368,7 @@ <h3 id="metalstack.admin.v2.PartitionServiceDeleteRequest">PartitionServiceDelet
         
       
         <h3 id="metalstack.admin.v2.PartitionServiceDeleteResponse">PartitionServiceDeleteResponse</h3>
-        <p>PartitionServiceCapacityResponse is the response payload for a partition delete request</p>
+        <p>PartitionServiceDeleteResponse is the response payload for deleting a partition.</p>
 
         
           <table class="field-table">
@@ -13369,7 +13381,7 @@ <h3 id="metalstack.admin.v2.PartitionServiceDeleteResponse">PartitionServiceDele
                   <td>partition</td>
                   <td><a href="#metalstack.api.v2.Partition">metalstack.api.v2.Partition</a></td>
                   <td></td>
-                  <td><p>Partition the partition </p></td>
+                  <td><p>Partition contains the deleted partition </p></td>
                 </tr>
               
             </tbody>
@@ -13380,7 +13392,7 @@ <h3 id="metalstack.admin.v2.PartitionServiceDeleteResponse">PartitionServiceDele
         
       
         <h3 id="metalstack.admin.v2.PartitionServiceUpdateRequest">PartitionServiceUpdateRequest</h3>
-        <p>PartitionServiceUpdateRequest is the request payload for a partition update request</p>
+        <p>PartitionServiceUpdateRequest is the request payload for updating a partition.</p>
 
         
           <table class="field-table">
@@ -13436,8 +13448,7 @@ <h3 id="metalstack.admin.v2.PartitionServiceUpdateRequest">PartitionServiceUpdat
                   <td><a href="#string">string</a></td>
                   <td>repeated</td>
                   <td><p>ManagementServiceAddresses defines where the management is reachable
-should be in the form &lt;ip|host&gt;:&lt;port&gt;
-FIXME validation </p></td>
+must be in the form &lt;ip|host&gt;:&lt;port&gt; </p></td>
                 </tr>
               
                 <tr>
@@ -13485,7 +13496,7 @@ <h3 id="metalstack.admin.v2.PartitionServiceUpdateResponse">PartitionServiceUpda
 
       
         <h3 id="metalstack.admin.v2.PartitionService">PartitionService</h3>
-        <p>PartitionService serves partition address related functions</p>
+        <p>PartitionService provides partition management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -13496,28 +13507,28 @@ <h3 id="metalstack.admin.v2.PartitionService">PartitionService</h3>
                 <td>Create</td>
                 <td><a href="#metalstack.admin.v2.PartitionServiceCreateRequest">PartitionServiceCreateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.PartitionServiceCreateResponse">PartitionServiceCreateResponse</a></td>
-                <td><p>Create a partition</p></td>
+                <td><p>Creates a new partition.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.admin.v2.PartitionServiceUpdateRequest">PartitionServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.PartitionServiceUpdateResponse">PartitionServiceUpdateResponse</a></td>
-                <td><p>Update a partition</p></td>
+                <td><p>Updates a partition.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.admin.v2.PartitionServiceDeleteRequest">PartitionServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.admin.v2.PartitionServiceDeleteResponse">PartitionServiceDeleteResponse</a></td>
-                <td><p>Delete a partition</p></td>
+                <td><p>Deletes a partition.</p></td>
               </tr>
             
               <tr>
                 <td>Capacity</td>
                 <td><a href="#metalstack.admin.v2.PartitionServiceCapacityRequest">PartitionServiceCapacityRequest</a></td>
                 <td><a href="#metalstack.admin.v2.PartitionServiceCapacityResponse">PartitionServiceCapacityResponse</a></td>
-                <td><p>Capacity of a partitions</p></td>
+                <td><p>Returns the capacity of a partition.</p></td>
               </tr>
             
           </tbody>
@@ -14434,7 +14445,7 @@ <h3 id="metalstack.api.v2.ProjectServiceUpdateResponse">ProjectServiceUpdateResp
 
       
         <h3 id="metalstack.api.v2.ProjectService">ProjectService</h3>
-        <p>ProjectService serves project related functions</p>
+        <p>ProjectService provides project management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -14445,14 +14456,14 @@ <h3 id="metalstack.api.v2.ProjectService">ProjectService</h3>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.ProjectServiceListRequest">ProjectServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.ProjectServiceListResponse">ProjectServiceListResponse</a></td>
-                <td><p>List all accessible projects</p></td>
+                <td><p>Returns the list of all accessible projects.</p></td>
               </tr>
             
               <tr>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.ProjectServiceGetRequest">ProjectServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.ProjectServiceGetResponse">ProjectServiceGetResponse</a></td>
-                <td><p>Get a project</p></td>
+                <td><p>Returns the project with the specified UUID.</p></td>
               </tr>
             
               <tr>
@@ -14545,7 +14556,7 @@ <h2 id="metalstack/admin/v2/project.proto">metalstack/admin/v2/project.proto</h2
 
       
         <h3 id="metalstack.admin.v2.ProjectServiceListRequest">ProjectServiceListRequest</h3>
-        <p>ProjectServiceListRequest is the request payload for the project list request</p>
+        <p>ProjectServiceListRequest is the request payload for listing projects.</p>
 
         
           <table class="field-table">
@@ -14558,14 +14569,14 @@ <h3 id="metalstack.admin.v2.ProjectServiceListRequest">ProjectServiceListRequest
                   <td>tenant</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Tenant lists only projects of this tenant </p></td>
+                  <td><p>Tenant filters projects by this tenant </p></td>
                 </tr>
               
                 <tr>
                   <td>labels</td>
                   <td><a href="#metalstack.api.v2.Labels">metalstack.api.v2.Labels</a></td>
                   <td>optional</td>
-                  <td><p>Labels lists only projects containing the given labels </p></td>
+                  <td><p>Labels filters projects containing the given labels </p></td>
                 </tr>
               
             </tbody>
@@ -14576,7 +14587,7 @@ <h3 id="metalstack.admin.v2.ProjectServiceListRequest">ProjectServiceListRequest
         
       
         <h3 id="metalstack.admin.v2.ProjectServiceListResponse">ProjectServiceListResponse</h3>
-        <p>ProjectServiceListResponse is the response payload for the project list request</p>
+        <p>ProjectServiceListResponse is the response payload for listing projects.</p>
 
         
           <table class="field-table">
@@ -14589,7 +14600,7 @@ <h3 id="metalstack.admin.v2.ProjectServiceListResponse">ProjectServiceListRespon
                   <td>projects</td>
                   <td><a href="#metalstack.api.v2.Project">metalstack.api.v2.Project</a></td>
                   <td>repeated</td>
-                  <td><p>Projects is a list of all projects </p></td>
+                  <td><p>Projects contains the list of projects </p></td>
                 </tr>
               
             </tbody>
@@ -14606,7 +14617,7 @@ <h3 id="metalstack.admin.v2.ProjectServiceListResponse">ProjectServiceListRespon
 
       
         <h3 id="metalstack.admin.v2.ProjectService">ProjectService</h3>
-        <p>ProjectService serves project related functions</p>
+        <p>ProjectService provides project management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -14617,7 +14628,7 @@ <h3 id="metalstack.admin.v2.ProjectService">ProjectService</h3>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.ProjectServiceListRequest">ProjectServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.ProjectServiceListResponse">ProjectServiceListResponse</a></td>
-                <td><p>List projects based on various filter criteria</p></td>
+                <td><p>Returns the list of projects matching the filter criteria.</p></td>
               </tr>
             
           </tbody>
@@ -14633,7 +14644,7 @@ <h2 id="metalstack/admin/v2/size.proto">metalstack/admin/v2/size.proto</h2><a hr
 
       
         <h3 id="metalstack.admin.v2.SizeServiceCreateRequest">SizeServiceCreateRequest</h3>
-        <p>SizeServiceCreateRequest is the request payload for a size create request</p>
+        <p>SizeServiceCreateRequest is the request payload for creating a size.</p>
 
         
           <table class="field-table">
@@ -14657,7 +14668,7 @@ <h3 id="metalstack.admin.v2.SizeServiceCreateRequest">SizeServiceCreateRequest</
         
       
         <h3 id="metalstack.admin.v2.SizeServiceCreateResponse">SizeServiceCreateResponse</h3>
-        <p>SizeServiceGetResponse is the response payload for a size create request</p>
+        <p>SizeServiceCreateResponse is the response payload for creating a size.</p>
 
         
           <table class="field-table">
@@ -14670,7 +14681,7 @@ <h3 id="metalstack.admin.v2.SizeServiceCreateResponse">SizeServiceCreateResponse
                   <td>size</td>
                   <td><a href="#metalstack.api.v2.Size">metalstack.api.v2.Size</a></td>
                   <td></td>
-                  <td><p>Size the size </p></td>
+                  <td><p>Size contains the created size </p></td>
                 </tr>
               
             </tbody>
@@ -14681,7 +14692,7 @@ <h3 id="metalstack.admin.v2.SizeServiceCreateResponse">SizeServiceCreateResponse
         
       
         <h3 id="metalstack.admin.v2.SizeServiceDeleteRequest">SizeServiceDeleteRequest</h3>
-        <p>SizeServiceDeleteRequest is the request payload for a size delete request</p>
+        <p>SizeServiceDeleteRequest is the request payload for deleting a size.</p>
 
         
           <table class="field-table">
@@ -14705,7 +14716,7 @@ <h3 id="metalstack.admin.v2.SizeServiceDeleteRequest">SizeServiceDeleteRequest</
         
       
         <h3 id="metalstack.admin.v2.SizeServiceDeleteResponse">SizeServiceDeleteResponse</h3>
-        <p>SizeServiceDeleteResponse is the response payload for a size delete request</p>
+        <p>SizeServiceDeleteResponse is the response payload for deleting a size.</p>
 
         
           <table class="field-table">
@@ -14718,7 +14729,7 @@ <h3 id="metalstack.admin.v2.SizeServiceDeleteResponse">SizeServiceDeleteResponse
                   <td>size</td>
                   <td><a href="#metalstack.api.v2.Size">metalstack.api.v2.Size</a></td>
                   <td></td>
-                  <td><p>Size the size </p></td>
+                  <td><p>Size contains the deleted size </p></td>
                 </tr>
               
             </tbody>
@@ -14729,7 +14740,7 @@ <h3 id="metalstack.admin.v2.SizeServiceDeleteResponse">SizeServiceDeleteResponse
         
       
         <h3 id="metalstack.admin.v2.SizeServiceUpdateRequest">SizeServiceUpdateRequest</h3>
-        <p>SizeServiceUpdateRequest is the request payload for a size update request</p>
+        <p>SizeServiceUpdateRequest is the request payload for updating a size.</p>
 
         
           <table class="field-table">
@@ -14788,7 +14799,7 @@ <h3 id="metalstack.admin.v2.SizeServiceUpdateRequest">SizeServiceUpdateRequest</
         
       
         <h3 id="metalstack.admin.v2.SizeServiceUpdateResponse">SizeServiceUpdateResponse</h3>
-        <p>SizeServiceUpdateResponse is the response payload for a size update request</p>
+        <p>SizeServiceUpdateResponse is the response payload for updating a size.</p>
 
         
           <table class="field-table">
@@ -14801,7 +14812,7 @@ <h3 id="metalstack.admin.v2.SizeServiceUpdateResponse">SizeServiceUpdateResponse
                   <td>size</td>
                   <td><a href="#metalstack.api.v2.Size">metalstack.api.v2.Size</a></td>
                   <td></td>
-                  <td><p>Size the size </p></td>
+                  <td><p>Size contains the updated size </p></td>
                 </tr>
               
             </tbody>
@@ -14818,7 +14829,7 @@ <h3 id="metalstack.admin.v2.SizeServiceUpdateResponse">SizeServiceUpdateResponse
 
       
         <h3 id="metalstack.admin.v2.SizeService">SizeService</h3>
-        <p>SizeService serves size related functions</p>
+        <p>SizeService provides size management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -14829,21 +14840,21 @@ <h3 id="metalstack.admin.v2.SizeService">SizeService</h3>
                 <td>Create</td>
                 <td><a href="#metalstack.admin.v2.SizeServiceCreateRequest">SizeServiceCreateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeServiceCreateResponse">SizeServiceCreateResponse</a></td>
-                <td><p>Create a size</p></td>
+                <td><p>Creates a new size.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.admin.v2.SizeServiceUpdateRequest">SizeServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeServiceUpdateResponse">SizeServiceUpdateResponse</a></td>
-                <td><p>Update a size</p></td>
+                <td><p>Updates a size.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.admin.v2.SizeServiceDeleteRequest">SizeServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeServiceDeleteResponse">SizeServiceDeleteResponse</a></td>
-                <td><p>Delete a size</p></td>
+                <td><p>Deletes a size.</p></td>
               </tr>
             
           </tbody>
@@ -15024,7 +15035,7 @@ <h3 id="metalstack.api.v2.SizeImageConstraintServiceTryResponse">SizeImageConstr
 
       
         <h3 id="metalstack.api.v2.SizeImageConstraintService">SizeImageConstraintService</h3>
-        <p>SizeImageConstraintService serves size and image constraint related functions</p>
+        <p>SizeImageConstraintService provides size and image constraint validation operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -15035,7 +15046,7 @@ <h3 id="metalstack.api.v2.SizeImageConstraintService">SizeImageConstraintService
                 <td>Try</td>
                 <td><a href="#metalstack.api.v2.SizeImageConstraintServiceTryRequest">SizeImageConstraintServiceTryRequest</a></td>
                 <td><a href="#metalstack.api.v2.SizeImageConstraintServiceTryResponse">SizeImageConstraintServiceTryResponse</a></td>
-                <td><p>Try if a given combination of size and image is possible</p></td>
+                <td><p>Try validates if a given combination of size and image is possible.</p></td>
               </tr>
             
           </tbody>
@@ -15051,7 +15062,7 @@ <h2 id="metalstack/admin/v2/size_imageconstraint.proto">metalstack/admin/v2/size
 
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintServiceCreateRequest">SizeImageConstraintServiceCreateRequest</h3>
-        <p>SizeImageConstraintServiceCreateRequest is the request payload for a size image constraint create request</p>
+        <p>SizeImageConstraintServiceCreateRequest is the request payload for creating a size image constraint.</p>
 
         
           <table class="field-table">
@@ -15103,7 +15114,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceCreateRequest">SizeImageCo
         
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintServiceCreateResponse">SizeImageConstraintServiceCreateResponse</h3>
-        <p>SizeImageConstraintServiceCreateResponse is the response payload for a size image constraint create request</p>
+        <p>SizeImageConstraintServiceCreateResponse is the response payload for creating a size image constraint.</p>
 
         
           <table class="field-table">
@@ -15116,7 +15127,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceCreateResponse">SizeImageC
                   <td>size_image_constraint</td>
                   <td><a href="#metalstack.api.v2.SizeImageConstraint">metalstack.api.v2.SizeImageConstraint</a></td>
                   <td></td>
-                  <td><p>SizeImageConstraint created </p></td>
+                  <td><p>SizeImageConstraint contains the created constraint </p></td>
                 </tr>
               
             </tbody>
@@ -15127,7 +15138,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceCreateResponse">SizeImageC
         
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintServiceDeleteRequest">SizeImageConstraintServiceDeleteRequest</h3>
-        <p>SizeImageConstraintServiceDeleteRequest is the request payload for a size image constraint delete request</p>
+        <p>SizeImageConstraintServiceDeleteRequest is the request payload for deleting a size image constraint.</p>
 
         
           <table class="field-table">
@@ -15151,7 +15162,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceDeleteRequest">SizeImageCo
         
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintServiceDeleteResponse">SizeImageConstraintServiceDeleteResponse</h3>
-        <p>SizeImageConstraintServiceDeleteResponse is the response payload for a size image constraint delete request</p>
+        <p>SizeImageConstraintServiceDeleteResponse is the response payload for deleting a size image constraint.</p>
 
         
           <table class="field-table">
@@ -15164,7 +15175,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceDeleteResponse">SizeImageC
                   <td>size_image_constraint</td>
                   <td><a href="#metalstack.api.v2.SizeImageConstraint">metalstack.api.v2.SizeImageConstraint</a></td>
                   <td></td>
-                  <td><p>SizeImageConstraint deleted </p></td>
+                  <td><p>SizeImageConstraint contains the deleted constraint </p></td>
                 </tr>
               
             </tbody>
@@ -15175,7 +15186,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceDeleteResponse">SizeImageC
         
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintServiceGetRequest">SizeImageConstraintServiceGetRequest</h3>
-        <p>SizeImageConstraintServiceGetRequest is the request payload for a size image constraint get request</p>
+        <p>SizeImageConstraintServiceGetRequest is the request payload for getting a size image constraint.</p>
 
         
           <table class="field-table">
@@ -15199,7 +15210,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceGetRequest">SizeImageConst
         
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintServiceGetResponse">SizeImageConstraintServiceGetResponse</h3>
-        <p>SizeImageConstraintServiceGetResponse is the response payload for a size image constraint get request</p>
+        <p>SizeImageConstraintServiceGetResponse is the response payload for getting a size image constraint.</p>
 
         
           <table class="field-table">
@@ -15212,7 +15223,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceGetResponse">SizeImageCons
                   <td>size_image_constraint</td>
                   <td><a href="#metalstack.api.v2.SizeImageConstraint">metalstack.api.v2.SizeImageConstraint</a></td>
                   <td></td>
-                  <td><p>SizeImageConstraint get </p></td>
+                  <td><p>SizeImageConstraint contains the retrieved constraint </p></td>
                 </tr>
               
             </tbody>
@@ -15223,7 +15234,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceGetResponse">SizeImageCons
         
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintServiceListRequest">SizeImageConstraintServiceListRequest</h3>
-        <p>SizeImageConstraintServiceListRequest is the request payload for a size image constraint list request</p>
+        <p>SizeImageConstraintServiceListRequest is the request payload for listing size image constraints.</p>
 
         
           <table class="field-table">
@@ -15247,7 +15258,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceListRequest">SizeImageCons
         
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintServiceListResponse">SizeImageConstraintServiceListResponse</h3>
-        <p>SizeImageConstraintServiceListResponse is the response payload for a size image constraint list request</p>
+        <p>SizeImageConstraintServiceListResponse is the response payload for listing size image constraints.</p>
 
         
           <table class="field-table">
@@ -15260,7 +15271,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceListResponse">SizeImageCon
                   <td>size_image_constraints</td>
                   <td><a href="#metalstack.api.v2.SizeImageConstraint">metalstack.api.v2.SizeImageConstraint</a></td>
                   <td>repeated</td>
-                  <td><p>SizeImageConstraints listed </p></td>
+                  <td><p>SizeImageConstraints contains the list of constraints </p></td>
                 </tr>
               
             </tbody>
@@ -15271,7 +15282,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceListResponse">SizeImageCon
         
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintServiceUpdateRequest">SizeImageConstraintServiceUpdateRequest</h3>
-        <p>SizeImageConstraintServiceUpdateRequest is the request payload for a size image constraint update request</p>
+        <p>SizeImageConstraintServiceUpdateRequest is the request payload for updating a size image constraint.</p>
 
         
           <table class="field-table">
@@ -15323,7 +15334,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceUpdateRequest">SizeImageCo
         
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintServiceUpdateResponse">SizeImageConstraintServiceUpdateResponse</h3>
-        <p>SizeImageConstraintServiceUpdateResponse is the response payload for a size image constraint update request</p>
+        <p>SizeImageConstraintServiceUpdateResponse is the response payload for updating a size image constraint.</p>
 
         
           <table class="field-table">
@@ -15336,7 +15347,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceUpdateResponse">SizeImageC
                   <td>size_image_constraint</td>
                   <td><a href="#metalstack.api.v2.SizeImageConstraint">metalstack.api.v2.SizeImageConstraint</a></td>
                   <td></td>
-                  <td><p>SizeImageConstraint updated </p></td>
+                  <td><p>SizeImageConstraint contains the updated constraint </p></td>
                 </tr>
               
             </tbody>
@@ -15353,7 +15364,7 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintServiceUpdateResponse">SizeImageC
 
       
         <h3 id="metalstack.admin.v2.SizeImageConstraintService">SizeImageConstraintService</h3>
-        <p>SizeImageConstraintService serves size and image constraint related functions</p>
+        <p>SizeImageConstraintService provides size and image constraint management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -15364,35 +15375,35 @@ <h3 id="metalstack.admin.v2.SizeImageConstraintService">SizeImageConstraintServi
                 <td>Create</td>
                 <td><a href="#metalstack.admin.v2.SizeImageConstraintServiceCreateRequest">SizeImageConstraintServiceCreateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeImageConstraintServiceCreateResponse">SizeImageConstraintServiceCreateResponse</a></td>
-                <td><p>Create a size image constraint</p></td>
+                <td><p>Creates a size image constraint.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.admin.v2.SizeImageConstraintServiceUpdateRequest">SizeImageConstraintServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeImageConstraintServiceUpdateResponse">SizeImageConstraintServiceUpdateResponse</a></td>
-                <td><p>Update a size image constraint</p></td>
+                <td><p>Updates a size image constraint.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.admin.v2.SizeImageConstraintServiceDeleteRequest">SizeImageConstraintServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeImageConstraintServiceDeleteResponse">SizeImageConstraintServiceDeleteResponse</a></td>
-                <td><p>Delete a size image constraint</p></td>
+                <td><p>Deletes a size image constraint.</p></td>
               </tr>
             
               <tr>
                 <td>Get</td>
                 <td><a href="#metalstack.admin.v2.SizeImageConstraintServiceGetRequest">SizeImageConstraintServiceGetRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeImageConstraintServiceGetResponse">SizeImageConstraintServiceGetResponse</a></td>
-                <td><p>Get a size image constraint</p></td>
+                <td><p>Returns the size image constraint with the specified size.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.SizeImageConstraintServiceListRequest">SizeImageConstraintServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeImageConstraintServiceListResponse">SizeImageConstraintServiceListResponse</a></td>
-                <td><p>List a size image constraint</p></td>
+                <td><p>Returns the list of size image constraints.</p></td>
               </tr>
             
           </tbody>
@@ -15663,7 +15674,7 @@ <h3 id="metalstack.api.v2.SizeReservationServiceListResponse">SizeReservationSer
 
       
         <h3 id="metalstack.api.v2.SizeReservationService">SizeReservationService</h3>
-        <p>SizeReservationService serves size reservation related functions</p>
+        <p>SizeReservationService provides size reservation management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -15674,14 +15685,14 @@ <h3 id="metalstack.api.v2.SizeReservationService">SizeReservationService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.SizeReservationServiceGetRequest">SizeReservationServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.SizeReservationServiceGetResponse">SizeReservationServiceGetResponse</a></td>
-                <td><p>Get a size reservation</p></td>
+                <td><p>Returns the size reservation with the specified ID.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.SizeReservationServiceListRequest">SizeReservationServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.SizeReservationServiceListResponse">SizeReservationServiceListResponse</a></td>
-                <td><p>List size reservations</p></td>
+                <td><p>Returns the list of size reservations.</p></td>
               </tr>
             
           </tbody>
@@ -15697,7 +15708,7 @@ <h2 id="metalstack/admin/v2/size_reservation.proto">metalstack/admin/v2/size_res
 
       
         <h3 id="metalstack.admin.v2.SizeReservationServiceCreateRequest">SizeReservationServiceCreateRequest</h3>
-        <p>SizeReservationServiceCreateRequest is the request payload for a size reservation create request</p>
+        <p>SizeReservationServiceCreateRequest is the request payload for creating a size reservation.</p>
 
         
           <table class="field-table">
@@ -15721,7 +15732,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceCreateRequest">SizeReservation
         
       
         <h3 id="metalstack.admin.v2.SizeReservationServiceCreateResponse">SizeReservationServiceCreateResponse</h3>
-        <p>SizeReservationServiceCreateResponse is the response payload for a size reservation create request</p>
+        <p>SizeReservationServiceCreateResponse is the response payload for creating a size reservation.</p>
 
         
           <table class="field-table">
@@ -15734,7 +15745,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceCreateResponse">SizeReservatio
                   <td>size_reservation</td>
                   <td><a href="#metalstack.api.v2.SizeReservation">metalstack.api.v2.SizeReservation</a></td>
                   <td></td>
-                  <td><p>SizeReservation the size reservation </p></td>
+                  <td><p>SizeReservation contains the created reservation </p></td>
                 </tr>
               
             </tbody>
@@ -15745,7 +15756,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceCreateResponse">SizeReservatio
         
       
         <h3 id="metalstack.admin.v2.SizeReservationServiceDeleteRequest">SizeReservationServiceDeleteRequest</h3>
-        <p>SizeReservationServiceDeleteRequest is the request payload for a size reservation delete request</p>
+        <p>SizeReservationServiceDeleteRequest is the request payload for deleting a size reservation.</p>
 
         
           <table class="field-table">
@@ -15769,7 +15780,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceDeleteRequest">SizeReservation
         
       
         <h3 id="metalstack.admin.v2.SizeReservationServiceDeleteResponse">SizeReservationServiceDeleteResponse</h3>
-        <p>SizeReservationServiceDeleteResponse is the response payload for a size reservation delete request</p>
+        <p>SizeReservationServiceDeleteResponse is the response payload for deleting a size reservation.</p>
 
         
           <table class="field-table">
@@ -15782,7 +15793,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceDeleteResponse">SizeReservatio
                   <td>size_reservation</td>
                   <td><a href="#metalstack.api.v2.SizeReservation">metalstack.api.v2.SizeReservation</a></td>
                   <td></td>
-                  <td><p>SizeReservation the size reservation </p></td>
+                  <td><p>SizeReservation contains the deleted reservation </p></td>
                 </tr>
               
             </tbody>
@@ -15793,7 +15804,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceDeleteResponse">SizeReservatio
         
       
         <h3 id="metalstack.admin.v2.SizeReservationServiceListRequest">SizeReservationServiceListRequest</h3>
-        <p>SizeReservationServiceListRequest is the request payload for a size list request</p>
+        <p>SizeReservationServiceListRequest is the request payload for listing size reservations.</p>
 
         
           <table class="field-table">
@@ -15817,7 +15828,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceListRequest">SizeReservationSe
         
       
         <h3 id="metalstack.admin.v2.SizeReservationServiceListResponse">SizeReservationServiceListResponse</h3>
-        <p>SizeReservationServiceListResponse is the response payload for a size reservation list request</p>
+        <p>SizeReservationServiceListResponse is the response payload for listing size reservations.</p>
 
         
           <table class="field-table">
@@ -15830,7 +15841,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceListResponse">SizeReservationS
                   <td>size_reservations</td>
                   <td><a href="#metalstack.api.v2.SizeReservation">metalstack.api.v2.SizeReservation</a></td>
                   <td>repeated</td>
-                  <td><p>Size reservations </p></td>
+                  <td><p>SizeReservations contains the list of reservations </p></td>
                 </tr>
               
             </tbody>
@@ -15841,7 +15852,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceListResponse">SizeReservationS
         
       
         <h3 id="metalstack.admin.v2.SizeReservationServiceUpdateRequest">SizeReservationServiceUpdateRequest</h3>
-        <p>SizeReservationServiceUpdateRequest is the request payload for a size reservation update request</p>
+        <p>SizeReservationServiceUpdateRequest is the request payload for updating a size reservation.</p>
 
         
           <table class="field-table">
@@ -15907,7 +15918,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceUpdateRequest">SizeReservation
         
       
         <h3 id="metalstack.admin.v2.SizeReservationServiceUpdateResponse">SizeReservationServiceUpdateResponse</h3>
-        <p>SizeReservationServiceUpdateResponse is the response payload for a size reservation update request</p>
+        <p>SizeReservationServiceUpdateResponse is the response payload for updating a size reservation.</p>
 
         
           <table class="field-table">
@@ -15920,7 +15931,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceUpdateResponse">SizeReservatio
                   <td>size_reservation</td>
                   <td><a href="#metalstack.api.v2.SizeReservation">metalstack.api.v2.SizeReservation</a></td>
                   <td></td>
-                  <td><p>SizeReservation the size reservation </p></td>
+                  <td><p>SizeReservation contains the updated reservation </p></td>
                 </tr>
               
             </tbody>
@@ -15937,7 +15948,7 @@ <h3 id="metalstack.admin.v2.SizeReservationServiceUpdateResponse">SizeReservatio
 
       
         <h3 id="metalstack.admin.v2.SizeReservationService">SizeReservationService</h3>
-        <p>SizeReservationService serves size reservation related functions</p>
+        <p>SizeReservationService provides size reservation management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -15948,28 +15959,28 @@ <h3 id="metalstack.admin.v2.SizeReservationService">SizeReservationService</h3>
                 <td>Create</td>
                 <td><a href="#metalstack.admin.v2.SizeReservationServiceCreateRequest">SizeReservationServiceCreateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeReservationServiceCreateResponse">SizeReservationServiceCreateResponse</a></td>
-                <td><p>Create a size reservation</p></td>
+                <td><p>Creates a new size reservation.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.admin.v2.SizeReservationServiceUpdateRequest">SizeReservationServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeReservationServiceUpdateResponse">SizeReservationServiceUpdateResponse</a></td>
-                <td><p>Update a size reservation</p></td>
+                <td><p>Updates a size reservation.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.admin.v2.SizeReservationServiceDeleteRequest">SizeReservationServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeReservationServiceDeleteResponse">SizeReservationServiceDeleteResponse</a></td>
-                <td><p>Delete a size reservation</p></td>
+                <td><p>Deletes a size reservation.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.SizeReservationServiceListRequest">SizeReservationServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SizeReservationServiceListResponse">SizeReservationServiceListResponse</a></td>
-                <td><p>List size reservations</p></td>
+                <td><p>Returns the list of size reservations.</p></td>
               </tr>
             
           </tbody>
@@ -16720,7 +16731,7 @@ <h2 id="metalstack/admin/v2/switch.proto">metalstack/admin/v2/switch.proto</h2><
 
       
         <h3 id="metalstack.admin.v2.SwitchServiceConnectedMachinesRequest">SwitchServiceConnectedMachinesRequest</h3>
-        <p>SwitchServiceConnectedMachinesRequest.</p>
+        <p>SwitchServiceConnectedMachinesRequest is the request payload for listing switches with machine connections.</p>
 
         
           <table class="field-table">
@@ -16733,14 +16744,14 @@ <h3 id="metalstack.admin.v2.SwitchServiceConnectedMachinesRequest">SwitchService
                   <td>query</td>
                   <td><a href="#metalstack.api.v2.SwitchQuery">metalstack.api.v2.SwitchQuery</a></td>
                   <td></td>
-                  <td><p>Query to filter the switch results. </p></td>
+                  <td><p>Query to filter the switch results </p></td>
                 </tr>
               
                 <tr>
                   <td>machine_query</td>
                   <td><a href="#metalstack.api.v2.MachineQuery">metalstack.api.v2.MachineQuery</a></td>
                   <td></td>
-                  <td><p>MachineQuery to filter the machine results. </p></td>
+                  <td><p>MachineQuery to filter the machine results </p></td>
                 </tr>
               
             </tbody>
@@ -16751,7 +16762,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceConnectedMachinesRequest">SwitchService
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceConnectedMachinesResponse">SwitchServiceConnectedMachinesResponse</h3>
-        <p>SwitchServiceConnectedMachinesResponse.</p>
+        <p>SwitchServiceConnectedMachinesResponse is the response payload for listing switches with machine connections.</p>
 
         
           <table class="field-table">
@@ -16764,7 +16775,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceConnectedMachinesResponse">SwitchServic
                   <td>switches_with_machines</td>
                   <td><a href="#metalstack.api.v2.SwitchWithMachines">metalstack.api.v2.SwitchWithMachines</a></td>
                   <td>repeated</td>
-                  <td><p>SwitchesWithMachines contains all switches with their machine connections. </p></td>
+                  <td><p>SwitchesWithMachines contains all switches with their machine connections </p></td>
                 </tr>
               
             </tbody>
@@ -16775,7 +16786,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceConnectedMachinesResponse">SwitchServic
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceDeleteRequest">SwitchServiceDeleteRequest</h3>
-        <p>SwitchServiceDeleteRequest.</p>
+        <p>SwitchServiceDeleteRequest is the request payload for deleting a switch.</p>
 
         
           <table class="field-table">
@@ -16788,14 +16799,14 @@ <h3 id="metalstack.admin.v2.SwitchServiceDeleteRequest">SwitchServiceDeleteReque
                   <td>id</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Id of the switch. </p></td>
+                  <td><p>Id of the switch </p></td>
                 </tr>
               
                 <tr>
                   <td>force</td>
                   <td><a href="#bool">bool</a></td>
                   <td></td>
-                  <td><p>Force will allow switch deletion despite existing machine connections. </p></td>
+                  <td><p>Force will allow switch deletion despite existing machine connections </p></td>
                 </tr>
               
             </tbody>
@@ -16806,7 +16817,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceDeleteRequest">SwitchServiceDeleteReque
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceDeleteResponse">SwitchServiceDeleteResponse</h3>
-        <p>SwitchServiceDeleteResponse.</p>
+        <p>SwitchServiceDeleteResponse is the response payload for deleting a switch.</p>
 
         
           <table class="field-table">
@@ -16819,7 +16830,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceDeleteResponse">SwitchServiceDeleteResp
                   <td>switch</td>
                   <td><a href="#metalstack.api.v2.Switch">metalstack.api.v2.Switch</a></td>
                   <td></td>
-                  <td><p>Switch that has been deleted. </p></td>
+                  <td><p>Switch contains the deleted switch </p></td>
                 </tr>
               
             </tbody>
@@ -16830,7 +16841,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceDeleteResponse">SwitchServiceDeleteResp
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceGetRequest">SwitchServiceGetRequest</h3>
-        <p>SwitchServiceGetRequest.</p>
+        <p>SwitchServiceGetRequest is the request payload for getting a switch.</p>
 
         
           <table class="field-table">
@@ -16843,7 +16854,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceGetRequest">SwitchServiceGetRequest</h3
                   <td>id</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Id of the switch to get. </p></td>
+                  <td><p>Id of the switch to get </p></td>
                 </tr>
               
             </tbody>
@@ -16854,7 +16865,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceGetRequest">SwitchServiceGetRequest</h3
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceGetResponse">SwitchServiceGetResponse</h3>
-        <p>SwitchServiceGetResponse.</p>
+        <p>SwitchServiceGetResponse is the response payload for getting a switch.</p>
 
         
           <table class="field-table">
@@ -16867,7 +16878,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceGetResponse">SwitchServiceGetResponse</
                   <td>switch</td>
                   <td><a href="#metalstack.api.v2.Switch">metalstack.api.v2.Switch</a></td>
                   <td></td>
-                  <td><p>Switch that was requested. </p></td>
+                  <td><p>Switch contains the requested switch </p></td>
                 </tr>
               
             </tbody>
@@ -16878,7 +16889,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceGetResponse">SwitchServiceGetResponse</
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceListRequest">SwitchServiceListRequest</h3>
-        <p>SwitchServiceListRequest.</p>
+        <p>SwitchServiceListRequest is the request payload for listing switches.</p>
 
         
           <table class="field-table">
@@ -16891,7 +16902,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceListRequest">SwitchServiceListRequest</
                   <td>query</td>
                   <td><a href="#metalstack.api.v2.SwitchQuery">metalstack.api.v2.SwitchQuery</a></td>
                   <td></td>
-                  <td><p>Query to filter the results. </p></td>
+                  <td><p>Query to filter the results </p></td>
                 </tr>
               
             </tbody>
@@ -16902,7 +16913,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceListRequest">SwitchServiceListRequest</
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceListResponse">SwitchServiceListResponse</h3>
-        <p>SwitchServiceListResponse.</p>
+        <p>SwitchServiceListResponse is the response payload for listing switches.</p>
 
         
           <table class="field-table">
@@ -16915,7 +16926,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceListResponse">SwitchServiceListResponse
                   <td>switches</td>
                   <td><a href="#metalstack.api.v2.Switch">metalstack.api.v2.Switch</a></td>
                   <td>repeated</td>
-                  <td><p>Switches that match the request query. </p></td>
+                  <td><p>Switches that match the request query </p></td>
                 </tr>
               
             </tbody>
@@ -16926,7 +16937,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceListResponse">SwitchServiceListResponse
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceMigrateRequest">SwitchServiceMigrateRequest</h3>
-        <p>SwitchServiceMigrateRequest.</p>
+        <p>SwitchServiceMigrateRequest is the request payload for migrating a switch.</p>
 
         
           <table class="field-table">
@@ -16939,14 +16950,14 @@ <h3 id="metalstack.admin.v2.SwitchServiceMigrateRequest">SwitchServiceMigrateReq
                   <td>old_switch</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>OldSwitch which to migrate away from. </p></td>
+                  <td><p>OldSwitch is the switch to migrate away from </p></td>
                 </tr>
               
                 <tr>
                   <td>new_switch</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>NewSwitch which to migrate to. </p></td>
+                  <td><p>NewSwitch is the switch to migrate to </p></td>
                 </tr>
               
             </tbody>
@@ -16957,7 +16968,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceMigrateRequest">SwitchServiceMigrateReq
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceMigrateResponse">SwitchServiceMigrateResponse</h3>
-        <p>SwitchServiceMigrateResponse.</p>
+        <p>SwitchServiceMigrateResponse is the response payload for migrating a switch.</p>
 
         
           <table class="field-table">
@@ -16970,7 +16981,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceMigrateResponse">SwitchServiceMigrateRe
                   <td>switch</td>
                   <td><a href="#metalstack.api.v2.Switch">metalstack.api.v2.Switch</a></td>
                   <td></td>
-                  <td><p>Switch that was migrated to. </p></td>
+                  <td><p>Switch contains the switch was migrated to </p></td>
                 </tr>
               
             </tbody>
@@ -16981,7 +16992,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceMigrateResponse">SwitchServiceMigrateRe
         
       
         <h3 id="metalstack.admin.v2.SwitchServicePortRequest">SwitchServicePortRequest</h3>
-        <p>SwitchServicePortRequest.</p>
+        <p>SwitchServicePortRequest is the request payload for setting the port status of a switch port.</p>
 
         
           <table class="field-table">
@@ -16994,21 +17005,21 @@ <h3 id="metalstack.admin.v2.SwitchServicePortRequest">SwitchServicePortRequest</
                   <td>id</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Id of the switch. </p></td>
+                  <td><p>Id of the switch </p></td>
                 </tr>
               
                 <tr>
                   <td>nic_name</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>NicName of the port whose status should be changed. </p></td>
+                  <td><p>NicName of the port whose status should be changed </p></td>
                 </tr>
               
                 <tr>
                   <td>status</td>
                   <td><a href="#metalstack.api.v2.SwitchPortStatus">metalstack.api.v2.SwitchPortStatus</a></td>
                   <td></td>
-                  <td><p>Status that the port should have. </p></td>
+                  <td><p>Status that the port should have </p></td>
                 </tr>
               
             </tbody>
@@ -17019,7 +17030,7 @@ <h3 id="metalstack.admin.v2.SwitchServicePortRequest">SwitchServicePortRequest</
         
       
         <h3 id="metalstack.admin.v2.SwitchServicePortResponse">SwitchServicePortResponse</h3>
-        <p>SwitchServicePortResponse.</p>
+        <p>SwitchServicePortResponse is the response payload for setting the port status of a switch port.</p>
 
         
           <table class="field-table">
@@ -17032,7 +17043,7 @@ <h3 id="metalstack.admin.v2.SwitchServicePortResponse">SwitchServicePortResponse
                   <td>switch</td>
                   <td><a href="#metalstack.api.v2.Switch">metalstack.api.v2.Switch</a></td>
                   <td></td>
-                  <td><p>Switch after the port status toggle.. </p></td>
+                  <td><p>Switch after the port status toggle </p></td>
                 </tr>
               
             </tbody>
@@ -17043,7 +17054,7 @@ <h3 id="metalstack.admin.v2.SwitchServicePortResponse">SwitchServicePortResponse
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceUpdateRequest">SwitchServiceUpdateRequest</h3>
-        <p>SwitchServiceUpdateRequest.</p>
+        <p>SwitchServiceUpdateRequest is the request payload for updating a switch.</p>
 
         
           <table class="field-table">
@@ -17056,71 +17067,71 @@ <h3 id="metalstack.admin.v2.SwitchServiceUpdateRequest">SwitchServiceUpdateReque
                   <td>id</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>ID of the switch. </p></td>
+                  <td><p>ID of the switch </p></td>
                 </tr>
               
                 <tr>
                   <td>update_meta</td>
                   <td><a href="#metalstack.api.v2.UpdateMeta">metalstack.api.v2.UpdateMeta</a></td>
                   <td></td>
-                  <td><p>UpdateMeta contains the timestamp and strategy to be used in this update request. </p></td>
+                  <td><p>UpdateMeta contains the timestamp and strategy to be used in this update request </p></td>
                 </tr>
               
                 <tr>
                   <td>updated_at</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>UpdatedAt is the date when this entity was updated.
-must be part of the update request to ensure optimistic locking. </p></td>
+                  <td><p>UpdatedAt is the date when this entity was updated
+Must be part of the update request to ensure optimistic locking </p></td>
                 </tr>
               
                 <tr>
                   <td>description</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Description of the switch. </p></td>
+                  <td><p>Description of the switch </p></td>
                 </tr>
               
                 <tr>
                   <td>replace_mode</td>
                   <td><a href="#metalstack.api.v2.SwitchReplaceMode">metalstack.api.v2.SwitchReplaceMode</a></td>
                   <td>optional</td>
-                  <td><p>Replace mode is used to mark a switch ready for replacement. </p></td>
+                  <td><p>ReplaceMode is used to mark a switch ready for replacement </p></td>
                 </tr>
               
                 <tr>
                   <td>management_ip</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Management IP is the switch&#39;s IP for management access. </p></td>
+                  <td><p>ManagementIp is the switch&#39;s IP for management access </p></td>
                 </tr>
               
                 <tr>
                   <td>management_user</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Management user is the user name to use for management access. </p></td>
+                  <td><p>ManagementUser is the user name to use for management access </p></td>
                 </tr>
               
                 <tr>
                   <td>console_command</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Console command is the command for accessing the switch&#39;s console. </p></td>
+                  <td><p>ConsoleCommand is the command for accessing the switch&#39;s console </p></td>
                 </tr>
               
                 <tr>
                   <td>nics</td>
                   <td><a href="#metalstack.api.v2.SwitchNic">metalstack.api.v2.SwitchNic</a></td>
                   <td>repeated</td>
-                  <td><p>Nics are the front panel ports of the switch. </p></td>
+                  <td><p>Nics are the front panel ports of the switch </p></td>
                 </tr>
               
                 <tr>
                   <td>os</td>
                   <td><a href="#metalstack.api.v2.SwitchOS">metalstack.api.v2.SwitchOS</a></td>
                   <td>optional</td>
-                  <td><p>SwitchOs is the OS running on the switch. </p></td>
+                  <td><p>SwitchOs is the OS running on the switch </p></td>
                 </tr>
               
             </tbody>
@@ -17131,7 +17142,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceUpdateRequest">SwitchServiceUpdateReque
         
       
         <h3 id="metalstack.admin.v2.SwitchServiceUpdateResponse">SwitchServiceUpdateResponse</h3>
-        <p>SwitchServiceUpdateResponse.</p>
+        <p>SwitchServiceUpdateResponse is the response payload for updating a switch.</p>
 
         
           <table class="field-table">
@@ -17144,7 +17155,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceUpdateResponse">SwitchServiceUpdateResp
                   <td>switch</td>
                   <td><a href="#metalstack.api.v2.Switch">metalstack.api.v2.Switch</a></td>
                   <td></td>
-                  <td><p>Switch that was updated. </p></td>
+                  <td><p>Switch contains the updated switch </p></td>
                 </tr>
               
             </tbody>
@@ -17161,7 +17172,7 @@ <h3 id="metalstack.admin.v2.SwitchServiceUpdateResponse">SwitchServiceUpdateResp
 
       
         <h3 id="metalstack.admin.v2.SwitchService">SwitchService</h3>
-        <p>SwitchService serves switch related functions.</p>
+        <p>SwitchService provides switch management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -17172,49 +17183,49 @@ <h3 id="metalstack.admin.v2.SwitchService">SwitchService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceGetRequest">SwitchServiceGetRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceGetResponse">SwitchServiceGetResponse</a></td>
-                <td><p>Get a switch by ID.</p></td>
+                <td><p>Returns the switch with the specified ID.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceListRequest">SwitchServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceListResponse">SwitchServiceListResponse</a></td>
-                <td><p>List switches.</p></td>
+                <td><p>Returns the list of switches.</p></td>
               </tr>
             
               <tr>
                 <td>Update</td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceUpdateRequest">SwitchServiceUpdateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceUpdateResponse">SwitchServiceUpdateResponse</a></td>
-                <td><p>Update a switch.</p></td>
+                <td><p>Updates a switch.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceDeleteRequest">SwitchServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceDeleteResponse">SwitchServiceDeleteResponse</a></td>
-                <td><p>Delete a switch.</p></td>
+                <td><p>Deletes a switch.</p></td>
               </tr>
             
               <tr>
                 <td>Migrate</td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceMigrateRequest">SwitchServiceMigrateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceMigrateResponse">SwitchServiceMigrateResponse</a></td>
-                <td><p>Migrate a switch.</p></td>
+                <td><p>Migrates a switch.</p></td>
               </tr>
             
               <tr>
                 <td>Port</td>
                 <td><a href="#metalstack.admin.v2.SwitchServicePortRequest">SwitchServicePortRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SwitchServicePortResponse">SwitchServicePortResponse</a></td>
-                <td><p>Port set the port status of a switch port.</p></td>
+                <td><p>Sets the port status of a switch port.</p></td>
               </tr>
             
               <tr>
                 <td>ConnectedMachines</td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceConnectedMachinesRequest">SwitchServiceConnectedMachinesRequest</a></td>
                 <td><a href="#metalstack.admin.v2.SwitchServiceConnectedMachinesResponse">SwitchServiceConnectedMachinesResponse</a></td>
-                <td><p>ConnectedMachines lists all switches with their machine connections.</p></td>
+                <td><p>Returns all switches with their machine connections.</p></td>
               </tr>
             
           </tbody>
@@ -17230,7 +17241,7 @@ <h2 id="metalstack/admin/v2/task.proto">metalstack/admin/v2/task.proto</h2><a hr
 
       
         <h3 id="metalstack.admin.v2.TaskInfo">TaskInfo</h3>
-        <p>TaskInfo contains details of an async task</p>
+        <p>TaskInfo contains details of an asynchronous task.</p>
 
         
           <table class="field-table">
@@ -17243,133 +17254,133 @@ <h3 id="metalstack.admin.v2.TaskInfo">TaskInfo</h3>
                   <td>id</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>ID is the identifier of the task. </p></td>
+                  <td><p>ID is the identifier of the task </p></td>
                 </tr>
               
                 <tr>
                   <td>queue</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Queue is the name of the queue in which the task belongs. </p></td>
+                  <td><p>Queue is the name of the queue in which the task belongs </p></td>
                 </tr>
               
                 <tr>
                   <td>type</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Type is the type name of the task. </p></td>
+                  <td><p>Type is the type name of the task </p></td>
                 </tr>
               
                 <tr>
                   <td>payload</td>
                   <td><a href="#bytes">bytes</a></td>
                   <td></td>
-                  <td><p>Payload is the payload data of the task. </p></td>
+                  <td><p>Payload is the payload data of the task </p></td>
                 </tr>
               
                 <tr>
                   <td>state</td>
                   <td><a href="#metalstack.admin.v2.TaskState">TaskState</a></td>
                   <td></td>
-                  <td><p>State indicates the task state. </p></td>
+                  <td><p>State indicates the task state </p></td>
                 </tr>
               
                 <tr>
                   <td>max_retry</td>
                   <td><a href="#int32">int32</a></td>
                   <td></td>
-                  <td><p>MaxRetry is the maximum number of times the task can be retried. </p></td>
+                  <td><p>MaxRetry is the maximum number of times the task can be retried </p></td>
                 </tr>
               
                 <tr>
                   <td>retried</td>
                   <td><a href="#int32">int32</a></td>
                   <td></td>
-                  <td><p>Retried is the number of times the task has retried so far. </p></td>
+                  <td><p>Retried is the number of times the task has retried so far </p></td>
                 </tr>
               
                 <tr>
                   <td>last_error</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>LastError is the error message from the last failure. </p></td>
+                  <td><p>LastError is the error message from the last failure </p></td>
                 </tr>
               
                 <tr>
                   <td>last_failed_at</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>LastFailedAt is the time time of the last failure if any.
-If the task has no failures, LastFailedAt is zero time (i.e. time.Time{}). </p></td>
+                  <td><p>LastFailedAt is the time of the last failure if any
+If the task has no failures, LastFailedAt is zero time (i.e. time.Time{}) </p></td>
                 </tr>
               
                 <tr>
                   <td>timeout</td>
                   <td><a href="#google.protobuf.Duration">google.protobuf.Duration</a></td>
                   <td></td>
-                  <td><p>Timeout is the duration the task can be processed by Handler before being retried, </p></td>
+                  <td><p>Timeout is the duration the task can be processed by Handler before being retried </p></td>
                 </tr>
               
                 <tr>
                   <td>deadline</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>Deadline is the deadline for the task. </p></td>
+                  <td><p>Deadline is the deadline for the task </p></td>
                 </tr>
               
                 <tr>
                   <td>group</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Group is the name of the group in which the task belongs.
+                  <td><p>Group is the name of the group in which the task belongs
 
 Tasks in the same queue can be grouped together by Group name and will be aggregated into one task
-by a Server processing the queue.
+by a Server processing the queue
 
-Empty string (default) indicates task does not belong to any groups, and no aggregation will be applied to the task. </p></td>
+Empty string (default) indicates task does not belong to any groups, and no aggregation will be applied to the task </p></td>
                 </tr>
               
                 <tr>
                   <td>next_process_at</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>NextProcessAt is the time the task is scheduled to be processed,
-zero if not applicable. </p></td>
+                  <td><p>NextProcessAt is the time the task is scheduled to be processed
+Zero if not applicable </p></td>
                 </tr>
               
                 <tr>
                   <td>is_orphaned</td>
                   <td><a href="#bool">bool</a></td>
                   <td></td>
-                  <td><p>IsOrphaned describes whether the task is left in active state with no worker processing it.
+                  <td><p>IsOrphaned describes whether the task is left in active state with no worker processing it
 An orphaned task indicates that the worker has crashed or experienced network failures and was not able to
-extend its lease on the task.
+extend its lease on the task
 
-This task will be recovered by running a server against the queue the task is in.
-This field is only applicable to tasks with TaskStateActive. </p></td>
+This task will be recovered by running a server against the queue the task is in
+This field is only applicable to tasks with TaskStateActive </p></td>
                 </tr>
               
                 <tr>
                   <td>retention</td>
                   <td><a href="#google.protobuf.Duration">google.protobuf.Duration</a></td>
                   <td></td>
-                  <td><p>Retention is duration of the retention period after the task is successfully processed. </p></td>
+                  <td><p>Retention is duration of the retention period after the task is successfully processed </p></td>
                 </tr>
               
                 <tr>
                   <td>completed_at</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>CompletedAt is the time when the task is processed successfully.
-Zero value (i.e. time.Time{}) indicates no value. </p></td>
+                  <td><p>CompletedAt is the time when the task is processed successfully
+Zero value (i.e. time.Time{}) indicates no value </p></td>
                 </tr>
               
                 <tr>
                   <td>result</td>
                   <td><a href="#bytes">bytes</a></td>
                   <td></td>
-                  <td><p>Result holds the result data associated with the task.
-Use ResultWriter to write result data from the Handler. </p></td>
+                  <td><p>Result holds the result data associated with the task
+Use ResultWriter to write result data from the Handler </p></td>
                 </tr>
               
             </tbody>
@@ -17380,7 +17391,7 @@ <h3 id="metalstack.admin.v2.TaskInfo">TaskInfo</h3>
         
       
         <h3 id="metalstack.admin.v2.TaskServiceDeleteRequest">TaskServiceDeleteRequest</h3>
-        <p>TaskServiceDeleteRequest is the message to a delete task request</p>
+        <p>TaskServiceDeleteRequest is the request payload for deleting a task.</p>
 
         
           <table class="field-table">
@@ -17393,14 +17404,14 @@ <h3 id="metalstack.admin.v2.TaskServiceDeleteRequest">TaskServiceDeleteRequest</
                   <td>task_id</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>TaskId to cancel </p></td>
+                  <td><p>TaskId is the identifier of the task to cancel </p></td>
                 </tr>
               
                 <tr>
                   <td>queue</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Queue where this task was scheduled to </p></td>
+                  <td><p>Queue is the queue where this task was scheduled to </p></td>
                 </tr>
               
             </tbody>
@@ -17411,14 +17422,14 @@ <h3 id="metalstack.admin.v2.TaskServiceDeleteRequest">TaskServiceDeleteRequest</
         
       
         <h3 id="metalstack.admin.v2.TaskServiceDeleteResponse">TaskServiceDeleteResponse</h3>
-        <p>TaskServiceDeleteResponse is the response to a task delete request</p>
+        <p>TaskServiceDeleteResponse is the response payload for deleting a task.</p>
 
         
 
         
       
         <h3 id="metalstack.admin.v2.TaskServiceGetRequest">TaskServiceGetRequest</h3>
-        <p>TaskServiceGetRequest is the message to a get task request</p>
+        <p>TaskServiceGetRequest is the request payload for getting a task.</p>
 
         
           <table class="field-table">
@@ -17431,14 +17442,14 @@ <h3 id="metalstack.admin.v2.TaskServiceGetRequest">TaskServiceGetRequest</h3>
                   <td>task_id</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>TaskId to get </p></td>
+                  <td><p>TaskId is the identifier of the task to get </p></td>
                 </tr>
               
                 <tr>
                   <td>queue</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Queue where this task was scheduled to </p></td>
+                  <td><p>Queue is the queue where this task was scheduled to </p></td>
                 </tr>
               
             </tbody>
@@ -17449,7 +17460,7 @@ <h3 id="metalstack.admin.v2.TaskServiceGetRequest">TaskServiceGetRequest</h3>
         
       
         <h3 id="metalstack.admin.v2.TaskServiceGetResponse">TaskServiceGetResponse</h3>
-        <p>TaskServiceGetResponse is the response to a task get request</p>
+        <p>TaskServiceGetResponse is the response payload for getting a task.</p>
 
         
           <table class="field-table">
@@ -17473,7 +17484,7 @@ <h3 id="metalstack.admin.v2.TaskServiceGetResponse">TaskServiceGetResponse</h3>
         
       
         <h3 id="metalstack.admin.v2.TaskServiceListRequest">TaskServiceListRequest</h3>
-        <p>TaskServiceListRequest is the message to a task list request</p>
+        <p>TaskServiceListRequest is the request payload for listing tasks.</p>
 
         
           <table class="field-table">
@@ -17486,22 +17497,22 @@ <h3 id="metalstack.admin.v2.TaskServiceListRequest">TaskServiceListRequest</h3>
                   <td>queue</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Queue where this tasks should be listed
-will return tasks from all queues if not specified </p></td>
+                  <td><p>Queue filters tasks by this queue
+Will return tasks from all queues if not specified </p></td>
                 </tr>
               
                 <tr>
                   <td>count</td>
                   <td><a href="#uint32">uint32</a></td>
                   <td>optional</td>
-                  <td><p>Count of tasks to return </p></td>
+                  <td><p>Count is the number of tasks to return </p></td>
                 </tr>
               
                 <tr>
                   <td>page</td>
                   <td><a href="#uint32">uint32</a></td>
                   <td>optional</td>
-                  <td><p>Page of tasks to return </p></td>
+                  <td><p>Page is the page of tasks to return </p></td>
                 </tr>
               
             </tbody>
@@ -17512,7 +17523,7 @@ <h3 id="metalstack.admin.v2.TaskServiceListRequest">TaskServiceListRequest</h3>
         
       
         <h3 id="metalstack.admin.v2.TaskServiceListResponse">TaskServiceListResponse</h3>
-        <p>TaskServiceListResponse is the response to a task list request</p>
+        <p>TaskServiceListResponse is the response payload for listing tasks.</p>
 
         
           <table class="field-table">
@@ -17525,7 +17536,7 @@ <h3 id="metalstack.admin.v2.TaskServiceListResponse">TaskServiceListResponse</h3
                   <td>tasks</td>
                   <td><a href="#metalstack.admin.v2.TaskInfo">TaskInfo</a></td>
                   <td>repeated</td>
-                  <td><p>Tasks contains the requested list of tasks </p></td>
+                  <td><p>Tasks contains the list of requested tasks </p></td>
                 </tr>
               
             </tbody>
@@ -17536,14 +17547,14 @@ <h3 id="metalstack.admin.v2.TaskServiceListResponse">TaskServiceListResponse</h3
         
       
         <h3 id="metalstack.admin.v2.TaskServiceQueuesRequest">TaskServiceQueuesRequest</h3>
-        <p>TaskServiceQueuesRequest is the message to get all queues</p>
+        <p>TaskServiceQueuesRequest is the request payload for getting all queues.</p>
 
         
 
         
       
         <h3 id="metalstack.admin.v2.TaskServiceQueuesResponse">TaskServiceQueuesResponse</h3>
-        <p>TaskServiceQueuesResponse is the response to a queues request</p>
+        <p>TaskServiceQueuesResponse is the response payload for getting all queues.</p>
 
         
           <table class="field-table">
@@ -17569,7 +17580,7 @@ <h3 id="metalstack.admin.v2.TaskServiceQueuesResponse">TaskServiceQueuesResponse
 
       
         <h3 id="metalstack.admin.v2.TaskState">TaskState</h3>
-        <p>TaskState defines the state of the task</p>
+        <p>TaskState defines the state of the task.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Name</td><td>Number</td><td>Description</td></tr>
@@ -17579,49 +17590,49 @@ <h3 id="metalstack.admin.v2.TaskState">TaskState</h3>
               <tr>
                 <td>TASK_STATE_UNSPECIFIED</td>
                 <td>0</td>
-                <td><p>TASK_STATE_UNSPECIFIED indicates a undefined state</p></td>
+                <td><p>TASK_STATE_UNSPECIFIED is not specified</p></td>
               </tr>
             
               <tr>
                 <td>TASK_STATE_ACTIVE</td>
                 <td>1</td>
-                <td><p>TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler.</p></td>
+                <td><p>TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler</p></td>
               </tr>
             
               <tr>
                 <td>TASK_STATE_PENDING</td>
                 <td>2</td>
-                <td><p>TASK_STATE_PENDING indicates that the task is ready to be processed by Handler.</p></td>
+                <td><p>TASK_STATE_PENDING indicates that the task is ready to be processed by Handler</p></td>
               </tr>
             
               <tr>
                 <td>TASK_STATE_SCHEDULED</td>
                 <td>3</td>
-                <td><p>TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future.</p></td>
+                <td><p>TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future</p></td>
               </tr>
             
               <tr>
                 <td>TASK_STATE_RETRY</td>
                 <td>4</td>
-                <td><p>TASK_STATE_RETRY indicates that the task has previously failed and scheduled to be processed some time in the future.</p></td>
+                <td><p>TASK_STATE_RETRY indicates that the task has previously failed and is scheduled to be processed some time in the future</p></td>
               </tr>
             
               <tr>
                 <td>TASK_STATE_ARCHIVED</td>
                 <td>5</td>
-                <td><p>TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes.</p></td>
+                <td><p>TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes</p></td>
               </tr>
             
               <tr>
                 <td>TASK_STATE_COMPLETED</td>
                 <td>6</td>
-                <td><p>TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires.</p></td>
+                <td><p>TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires</p></td>
               </tr>
             
               <tr>
                 <td>TASK_STATE_AGGREGATING</td>
                 <td>7</td>
-                <td><p>TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task.</p></td>
+                <td><p>TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task</p></td>
               </tr>
             
           </tbody>
@@ -17632,7 +17643,7 @@ <h3 id="metalstack.admin.v2.TaskState">TaskState</h3>
 
       
         <h3 id="metalstack.admin.v2.TaskService">TaskService</h3>
-        <p>TaskService provides services to async tasks</p>
+        <p>TaskService provides asynchronous task management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -17643,28 +17654,28 @@ <h3 id="metalstack.admin.v2.TaskService">TaskService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.admin.v2.TaskServiceGetRequest">TaskServiceGetRequest</a></td>
                 <td><a href="#metalstack.admin.v2.TaskServiceGetResponse">TaskServiceGetResponse</a></td>
-                <td><p>Get a specific task</p></td>
+                <td><p>Returns the task with the specified identifier.</p></td>
               </tr>
             
               <tr>
                 <td>Delete</td>
                 <td><a href="#metalstack.admin.v2.TaskServiceDeleteRequest">TaskServiceDeleteRequest</a></td>
                 <td><a href="#metalstack.admin.v2.TaskServiceDeleteResponse">TaskServiceDeleteResponse</a></td>
-                <td><p>Delete a specific task</p></td>
+                <td><p>Deletes the task with the specified identifier.</p></td>
               </tr>
             
               <tr>
                 <td>Queues</td>
                 <td><a href="#metalstack.admin.v2.TaskServiceQueuesRequest">TaskServiceQueuesRequest</a></td>
                 <td><a href="#metalstack.admin.v2.TaskServiceQueuesResponse">TaskServiceQueuesResponse</a></td>
-                <td><p>Queues returns all configures queues</p></td>
+                <td><p>Returns the list of all configured queues.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.TaskServiceListRequest">TaskServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.TaskServiceListResponse">TaskServiceListResponse</a></td>
-                <td><p>List list all tasks</p></td>
+                <td><p>Returns the list of all tasks.</p></td>
               </tr>
             
           </tbody>
@@ -18585,7 +18596,7 @@ <h3 id="metalstack.api.v2.TenantServiceUpdateResponse">TenantServiceUpdateRespon
 
       
         <h3 id="metalstack.api.v2.TenantService">TenantService</h3>
-        <p>TenantService serves tenant related functions</p>
+        <p>TenantService provides tenant management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -18596,14 +18607,14 @@ <h3 id="metalstack.api.v2.TenantService">TenantService</h3>
                 <td>Create</td>
                 <td><a href="#metalstack.api.v2.TenantServiceCreateRequest">TenantServiceCreateRequest</a></td>
                 <td><a href="#metalstack.api.v2.TenantServiceCreateResponse">TenantServiceCreateResponse</a></td>
-                <td><p>Create a tenant</p></td>
+                <td><p>Creates a new tenant.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.TenantServiceListRequest">TenantServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.TenantServiceListResponse">TenantServiceListResponse</a></td>
-                <td><p>List tenants</p></td>
+                <td><p>Returns the list of tenants.</p></td>
               </tr>
             
               <tr>
@@ -18696,7 +18707,7 @@ <h2 id="metalstack/admin/v2/tenant.proto">metalstack/admin/v2/tenant.proto</h2><
 
       
         <h3 id="metalstack.admin.v2.TenantServiceCreateRequest">TenantServiceCreateRequest</h3>
-        <p>TenantServiceCreateRequest is the request payload of the tenant create request</p>
+        <p>TenantServiceCreateRequest is the request payload for creating a tenant.</p>
 
         
           <table class="field-table">
@@ -18709,14 +18720,14 @@ <h3 id="metalstack.admin.v2.TenantServiceCreateRequest">TenantServiceCreateReque
                   <td>name</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Name of this tenant </p></td>
+                  <td><p>Name of the tenant </p></td>
                 </tr>
               
                 <tr>
                   <td>description</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Description of this tenant </p></td>
+                  <td><p>Description of the tenant </p></td>
                 </tr>
               
                 <tr>
@@ -18748,7 +18759,7 @@ <h3 id="metalstack.admin.v2.TenantServiceCreateRequest">TenantServiceCreateReque
         
       
         <h3 id="metalstack.admin.v2.TenantServiceCreateResponse">TenantServiceCreateResponse</h3>
-        <p>TenantServiceCreateResponse is the response payload of the tenant create request</p>
+        <p>TenantServiceCreateResponse is the response payload for creating a tenant.</p>
 
         
           <table class="field-table">
@@ -18761,7 +18772,7 @@ <h3 id="metalstack.admin.v2.TenantServiceCreateResponse">TenantServiceCreateResp
                   <td>tenant</td>
                   <td><a href="#metalstack.api.v2.Tenant">metalstack.api.v2.Tenant</a></td>
                   <td></td>
-                  <td><p>Tenant is the tenant </p></td>
+                  <td><p>Tenant contains the created tenant </p></td>
                 </tr>
               
             </tbody>
@@ -18772,7 +18783,7 @@ <h3 id="metalstack.admin.v2.TenantServiceCreateResponse">TenantServiceCreateResp
         
       
         <h3 id="metalstack.admin.v2.TenantServiceListRequest">TenantServiceListRequest</h3>
-        <p>TenantServiceListRequest is the request payload for a tenant list request</p>
+        <p>TenantServiceListRequest is the request payload for listing tenants.</p>
 
         
           <table class="field-table">
@@ -18785,14 +18796,14 @@ <h3 id="metalstack.admin.v2.TenantServiceListRequest">TenantServiceListRequest</
                   <td>login</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Login of the tenant to list </p></td>
+                  <td><p>Login filters tenants by this login </p></td>
                 </tr>
               
                 <tr>
                   <td>name</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Name of the tenant to list </p></td>
+                  <td><p>Name filters tenants by this name </p></td>
                 </tr>
               
                 <tr>
@@ -18810,7 +18821,7 @@ <h3 id="metalstack.admin.v2.TenantServiceListRequest">TenantServiceListRequest</
         
       
         <h3 id="metalstack.admin.v2.TenantServiceListResponse">TenantServiceListResponse</h3>
-        <p>TenantServiceListResponse is the response payload for a tenant list request</p>
+        <p>TenantServiceListResponse is the response payload for listing tenants.</p>
 
         
           <table class="field-table">
@@ -18823,14 +18834,14 @@ <h3 id="metalstack.admin.v2.TenantServiceListResponse">TenantServiceListResponse
                   <td>tenants</td>
                   <td><a href="#metalstack.api.v2.Tenant">metalstack.api.v2.Tenant</a></td>
                   <td>repeated</td>
-                  <td><p>Tenants are the list of tenants </p></td>
+                  <td><p>Tenants contains the list of tenants </p></td>
                 </tr>
               
                 <tr>
                   <td>next_page</td>
                   <td><a href="#uint64">uint64</a></td>
                   <td>optional</td>
-                  <td><p>NextPage is used for pagination, returns the next page to be fetched and must then be provided in the list request. </p></td>
+                  <td><p>NextPage is used for pagination, returns the next page to be fetched and must then be provided in the list request </p></td>
                 </tr>
               
             </tbody>
@@ -18847,7 +18858,7 @@ <h3 id="metalstack.admin.v2.TenantServiceListResponse">TenantServiceListResponse
 
       
         <h3 id="metalstack.admin.v2.TenantService">TenantService</h3>
-        <p>TenantService serves tenant related functions</p>
+        <p>TenantService provides tenant management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -18858,14 +18869,14 @@ <h3 id="metalstack.admin.v2.TenantService">TenantService</h3>
                 <td>Create</td>
                 <td><a href="#metalstack.admin.v2.TenantServiceCreateRequest">TenantServiceCreateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.TenantServiceCreateResponse">TenantServiceCreateResponse</a></td>
-                <td><p>Create a tenant</p></td>
+                <td><p>Creates a new tenant.</p></td>
               </tr>
             
               <tr>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.TenantServiceListRequest">TenantServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.TenantServiceListResponse">TenantServiceListResponse</a></td>
-                <td><p>List all tenants</p></td>
+                <td><p>Returns the list of all tenants.</p></td>
               </tr>
             
           </tbody>
@@ -18881,7 +18892,7 @@ <h2 id="metalstack/admin/v2/token.proto">metalstack/admin/v2/token.proto</h2><a
 
       
         <h3 id="metalstack.admin.v2.TokenServiceCreateRequest">TokenServiceCreateRequest</h3>
-        <p>TokenServiceCreateRequest is the request payload to create a token</p>
+        <p>TokenServiceCreateRequest is the request payload for creating a token.</p>
 
         
           <table class="field-table">
@@ -18912,7 +18923,7 @@ <h3 id="metalstack.admin.v2.TokenServiceCreateRequest">TokenServiceCreateRequest
         
       
         <h3 id="metalstack.admin.v2.TokenServiceCreateResponse">TokenServiceCreateResponse</h3>
-        <p>TokenServiceCreateResponse is the response payload of a token create request</p>
+        <p>TokenServiceCreateResponse is the response payload for creating a token.</p>
 
         
           <table class="field-table">
@@ -18925,14 +18936,14 @@ <h3 id="metalstack.admin.v2.TokenServiceCreateResponse">TokenServiceCreateRespon
                   <td>token</td>
                   <td><a href="#metalstack.api.v2.Token">metalstack.api.v2.Token</a></td>
                   <td></td>
-                  <td><p>Token which was created </p></td>
+                  <td><p>Token contains the created token </p></td>
                 </tr>
               
                 <tr>
                   <td>secret</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Secret is the body if the jwt token, should be used in api requests as bearer token </p></td>
+                  <td><p>Secret is the body if the JWT token, should be used in API requests as bearer token </p></td>
                 </tr>
               
             </tbody>
@@ -18943,7 +18954,7 @@ <h3 id="metalstack.admin.v2.TokenServiceCreateResponse">TokenServiceCreateRespon
         
       
         <h3 id="metalstack.admin.v2.TokenServiceListRequest">TokenServiceListRequest</h3>
-        <p>TokenServiceListRequest is the request payload for the token list request</p>
+        <p>TokenServiceListRequest is the request payload for listing tokens.</p>
 
         
           <table class="field-table">
@@ -18967,7 +18978,7 @@ <h3 id="metalstack.admin.v2.TokenServiceListRequest">TokenServiceListRequest</h3
         
       
         <h3 id="metalstack.admin.v2.TokenServiceListResponse">TokenServiceListResponse</h3>
-        <p>TokenServiceListResponse is the response payload for the token list request</p>
+        <p>TokenServiceListResponse is the response payload for listing tokens.</p>
 
         
           <table class="field-table">
@@ -18980,7 +18991,7 @@ <h3 id="metalstack.admin.v2.TokenServiceListResponse">TokenServiceListResponse</
                   <td>tokens</td>
                   <td><a href="#metalstack.api.v2.Token">metalstack.api.v2.Token</a></td>
                   <td>repeated</td>
-                  <td><p>Tokens is the list of tokens </p></td>
+                  <td><p>Tokens contains the list of tokens </p></td>
                 </tr>
               
             </tbody>
@@ -18991,7 +19002,7 @@ <h3 id="metalstack.admin.v2.TokenServiceListResponse">TokenServiceListResponse</
         
       
         <h3 id="metalstack.admin.v2.TokenServiceRevokeRequest">TokenServiceRevokeRequest</h3>
-        <p>TokenServiceRevokeRequest is the request payload for the token revoke request</p>
+        <p>TokenServiceRevokeRequest is the request payload for revoking a token.</p>
 
         
           <table class="field-table">
@@ -19022,7 +19033,7 @@ <h3 id="metalstack.admin.v2.TokenServiceRevokeRequest">TokenServiceRevokeRequest
         
       
         <h3 id="metalstack.admin.v2.TokenServiceRevokeResponse">TokenServiceRevokeResponse</h3>
-        <p>TokenServiceRevokeResponse is the response payload for the token revoke request</p>
+        <p>TokenServiceRevokeResponse is the response payload for revoking a token.</p>
 
         
 
@@ -19035,7 +19046,7 @@ <h3 id="metalstack.admin.v2.TokenServiceRevokeResponse">TokenServiceRevokeRespon
 
       
         <h3 id="metalstack.admin.v2.TokenService">TokenService</h3>
-        <p>TokenService serves token related functions</p>
+        <p>TokenService provides token management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -19046,21 +19057,21 @@ <h3 id="metalstack.admin.v2.TokenService">TokenService</h3>
                 <td>List</td>
                 <td><a href="#metalstack.admin.v2.TokenServiceListRequest">TokenServiceListRequest</a></td>
                 <td><a href="#metalstack.admin.v2.TokenServiceListResponse">TokenServiceListResponse</a></td>
-                <td><p>List tokens</p></td>
+                <td><p>Returns the list of tokens for a user.</p></td>
               </tr>
             
               <tr>
                 <td>Revoke</td>
                 <td><a href="#metalstack.admin.v2.TokenServiceRevokeRequest">TokenServiceRevokeRequest</a></td>
                 <td><a href="#metalstack.admin.v2.TokenServiceRevokeResponse">TokenServiceRevokeResponse</a></td>
-                <td><p>Revoke a token</p></td>
+                <td><p>Revokes a token.</p></td>
               </tr>
             
               <tr>
                 <td>Create</td>
                 <td><a href="#metalstack.admin.v2.TokenServiceCreateRequest">TokenServiceCreateRequest</a></td>
                 <td><a href="#metalstack.admin.v2.TokenServiceCreateResponse">TokenServiceCreateResponse</a></td>
-                <td><p>Create a token to authenticate against the platform, the secret will be only visible in the response.
+                <td><p>Creates a token to authenticate against the platform, the secret will be only visible in the response.
 This service is suitable to create tokens for other users instead of deriving users from tokens directly.</p></td>
               </tr>
             
@@ -19077,7 +19088,7 @@ <h2 id="metalstack/api/v2/vpn.proto">metalstack/api/v2/vpn.proto</h2><a href="#t
 
       
         <h3 id="metalstack.api.v2.VPNNode">VPNNode</h3>
-        <p>VPNNode is a machine connected to the vpn</p>
+        <p>VPNNode represents a machine connected to the VPN.</p>
 
         
           <table class="field-table">
@@ -19090,7 +19101,7 @@ <h3 id="metalstack.api.v2.VPNNode">VPNNode</h3>
                   <td>id</td>
                   <td><a href="#uint64">uint64</a></td>
                   <td></td>
-                  <td><p>Id of this node </p></td>
+                  <td><p>ID of this node </p></td>
                 </tr>
               
                 <tr>
@@ -19111,14 +19122,14 @@ <h3 id="metalstack.api.v2.VPNNode">VPNNode</h3>
                   <td>ip_addresses</td>
                   <td><a href="#string">string</a></td>
                   <td>repeated</td>
-                  <td><p>IPAddresses of this node in the vpn </p></td>
+                  <td><p>IPAddresses of this node in the VPN </p></td>
                 </tr>
               
                 <tr>
                   <td>last_seen</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>LastSeen timestamp when this node reached out the the control plane </p></td>
+                  <td><p>LastSeen timestamp when this node reached out to the control plane </p></td>
                 </tr>
               
                 <tr>
@@ -19150,7 +19161,7 @@ <h2 id="metalstack/admin/v2/vpn.proto">metalstack/admin/v2/vpn.proto</h2><a href
 
       
         <h3 id="metalstack.admin.v2.VPNServiceAuthKeyRequest">VPNServiceAuthKeyRequest</h3>
-        <p>VPNServiceAuthKeyRequest is the request payload for a vpn authkey request.</p>
+        <p>VPNServiceAuthKeyRequest is the request payload for generating a VPN authentication key.</p>
 
         
           <table class="field-table">
@@ -19163,29 +19174,29 @@ <h3 id="metalstack.admin.v2.VPNServiceAuthKeyRequest">VPNServiceAuthKeyRequest</
                   <td>project</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Project for which a vpn authkey should be generated. </p></td>
+                  <td><p>Project for which a VPN authentication key should be generated </p></td>
                 </tr>
               
                 <tr>
                   <td>ephemeral</td>
                   <td><a href="#bool">bool</a></td>
                   <td></td>
-                  <td><p>Ephemeral defines if the authkey should be ephemeral. </p></td>
+                  <td><p>Ephemeral defines if the authentication key should be ephemeral </p></td>
                 </tr>
               
                 <tr>
                   <td>expires</td>
                   <td><a href="#google.protobuf.Duration">google.protobuf.Duration</a></td>
                   <td></td>
-                  <td><p>Expires defines the duration after which the authkey expires. </p></td>
+                  <td><p>Expires defines the duration after which the authentication key expires </p></td>
                 </tr>
               
                 <tr>
                   <td>reason</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Reason must be provided why access to the vpn is requested
-reason is only forwarded to a audit sink </p></td>
+                  <td><p>Reason must be provided why access to the VPN is requested
+Reason is only forwarded to an audit sink </p></td>
                 </tr>
               
             </tbody>
@@ -19196,7 +19207,7 @@ <h3 id="metalstack.admin.v2.VPNServiceAuthKeyRequest">VPNServiceAuthKeyRequest</
         
       
         <h3 id="metalstack.admin.v2.VPNServiceAuthKeyResponse">VPNServiceAuthKeyResponse</h3>
-        <p>VPNServiceAuthKeyResponse is the request payload for a authkey response</p>
+        <p>VPNServiceAuthKeyResponse is the response payload for generating a VPN authentication key.</p>
 
         
           <table class="field-table">
@@ -19209,36 +19220,36 @@ <h3 id="metalstack.admin.v2.VPNServiceAuthKeyResponse">VPNServiceAuthKeyResponse
                   <td>address</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Address is the address of the vpn control plane. </p></td>
+                  <td><p>Address is the address of the VPN control plane </p></td>
                 </tr>
               
                 <tr>
                   <td>auth_key</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>AuthKey is the key to connect to the vpn at the given address.
-This key can only be seen once. </p></td>
+                  <td><p>AuthKey is the key to connect to the VPN at the given address
+This key can only be seen once </p></td>
                 </tr>
               
                 <tr>
                   <td>ephemeral</td>
                   <td><a href="#bool">bool</a></td>
                   <td></td>
-                  <td><p>Ephemeral defines if the authkey should be ephemeral. </p></td>
+                  <td><p>Ephemeral defines if the authentication key should be ephemeral </p></td>
                 </tr>
               
                 <tr>
                   <td>expires_at</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>ExpiresAt this key cannot be used after this timestamp. </p></td>
+                  <td><p>ExpiresAt this key cannot be used after this timestamp </p></td>
                 </tr>
               
                 <tr>
                   <td>created_at</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>CreatedAt this key was created at this timestamp. </p></td>
+                  <td><p>CreatedAt this key was created at this timestamp </p></td>
                 </tr>
               
             </tbody>
@@ -19249,7 +19260,7 @@ <h3 id="metalstack.admin.v2.VPNServiceAuthKeyResponse">VPNServiceAuthKeyResponse
         
       
         <h3 id="metalstack.admin.v2.VPNServiceListNodesRequest">VPNServiceListNodesRequest</h3>
-        <p>VPNServiceListNodesRequest is the request payload for a vpn list nodes request</p>
+        <p>VPNServiceListNodesRequest is the request payload for listing VPN nodes.</p>
 
         
           <table class="field-table">
@@ -19262,7 +19273,7 @@ <h3 id="metalstack.admin.v2.VPNServiceListNodesRequest">VPNServiceListNodesReque
                   <td>project</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Project if given only nodes of this user are returned </p></td>
+                  <td><p>Project filters nodes by this project </p></td>
                 </tr>
               
             </tbody>
@@ -19273,7 +19284,7 @@ <h3 id="metalstack.admin.v2.VPNServiceListNodesRequest">VPNServiceListNodesReque
         
       
         <h3 id="metalstack.admin.v2.VPNServiceListNodesResponse">VPNServiceListNodesResponse</h3>
-        <p>VPNServiceListNodesResponse is the response payload for a vpn list nodes request</p>
+        <p>VPNServiceListNodesResponse is the response payload for listing VPN nodes.</p>
 
         
           <table class="field-table">
@@ -19286,7 +19297,7 @@ <h3 id="metalstack.admin.v2.VPNServiceListNodesResponse">VPNServiceListNodesResp
                   <td>nodes</td>
                   <td><a href="#metalstack.api.v2.VPNNode">metalstack.api.v2.VPNNode</a></td>
                   <td>repeated</td>
-                  <td><p>Nodes connected to the vpn </p></td>
+                  <td><p>Nodes connected to the VPN </p></td>
                 </tr>
               
             </tbody>
@@ -19303,7 +19314,7 @@ <h3 id="metalstack.admin.v2.VPNServiceListNodesResponse">VPNServiceListNodesResp
 
       
         <h3 id="metalstack.admin.v2.VPNService">VPNService</h3>
-        <p>VPNService serves vpn related functions</p>
+        <p>VPNService provides VPN management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -19314,14 +19325,14 @@ <h3 id="metalstack.admin.v2.VPNService">VPNService</h3>
                 <td>AuthKey</td>
                 <td><a href="#metalstack.admin.v2.VPNServiceAuthKeyRequest">VPNServiceAuthKeyRequest</a></td>
                 <td><a href="#metalstack.admin.v2.VPNServiceAuthKeyResponse">VPNServiceAuthKeyResponse</a></td>
-                <td><p>AuthKey generates a authkey for a project to join a machine to the project vpn</p></td>
+                <td><p>GenerateAuthKey generates an authentication key for a project to join a machine to the project VPN.</p></td>
               </tr>
             
               <tr>
                 <td>ListNodes</td>
                 <td><a href="#metalstack.admin.v2.VPNServiceListNodesRequest">VPNServiceListNodesRequest</a></td>
                 <td><a href="#metalstack.admin.v2.VPNServiceListNodesResponse">VPNServiceListNodesResponse</a></td>
-                <td><p>ListNodes returns a list of machines actually connected to the vpn</p></td>
+                <td><p>Returns the list of machines connected to the VPN.</p></td>
               </tr>
             
           </tbody>
@@ -19337,7 +19348,7 @@ <h2 id="metalstack/api/v2/health.proto">metalstack/api/v2/health.proto</h2><a hr
 
       
         <h3 id="metalstack.api.v2.Health">Health</h3>
-        <p>Health reports the health status of all services</p>
+        <p>Health reports the health status of all services.</p>
 
         
           <table class="field-table">
@@ -19350,7 +19361,7 @@ <h3 id="metalstack.api.v2.Health">Health</h3>
                   <td>services</td>
                   <td><a href="#metalstack.api.v2.HealthStatus">HealthStatus</a></td>
                   <td>repeated</td>
-                  <td><p>Services the health of all individual services </p></td>
+                  <td><p>Services contains the health of all individual services </p></td>
                 </tr>
               
             </tbody>
@@ -19361,14 +19372,14 @@ <h3 id="metalstack.api.v2.Health">Health</h3>
         
       
         <h3 id="metalstack.api.v2.HealthServiceGetRequest">HealthServiceGetRequest</h3>
-        <p>HealthServiceGetRequest is request payload to get the health of the system</p>
+        <p>HealthServiceGetRequest is the request payload for getting the health of the system.</p>
 
         
 
         
       
         <h3 id="metalstack.api.v2.HealthServiceGetResponse">HealthServiceGetResponse</h3>
-        <p>HealthServiceGetRequest is the response payload with the health of the system</p>
+        <p>HealthServiceGetResponse is the response payload for getting the health of the system.</p>
 
         
           <table class="field-table">
@@ -19381,7 +19392,7 @@ <h3 id="metalstack.api.v2.HealthServiceGetResponse">HealthServiceGetResponse</h3
                   <td>health</td>
                   <td><a href="#metalstack.api.v2.Health">Health</a></td>
                   <td></td>
-                  <td><p>Health is the overall health of the system </p></td>
+                  <td><p>Health contains the overall health of the system </p></td>
                 </tr>
               
             </tbody>
@@ -19392,7 +19403,7 @@ <h3 id="metalstack.api.v2.HealthServiceGetResponse">HealthServiceGetResponse</h3
         
       
         <h3 id="metalstack.api.v2.HealthStatus">HealthStatus</h3>
-        <p>HealthStatus the health of one service</p>
+        <p>HealthStatus represents the health status of one service.</p>
 
         
           <table class="field-table">
@@ -19405,14 +19416,14 @@ <h3 id="metalstack.api.v2.HealthStatus">HealthStatus</h3>
                   <td>name</td>
                   <td><a href="#metalstack.api.v2.Service">Service</a></td>
                   <td></td>
-                  <td><p>Name the name of the service </p></td>
+                  <td><p>Name is the name of the service </p></td>
                 </tr>
               
                 <tr>
                   <td>status</td>
                   <td><a href="#metalstack.api.v2.ServiceStatus">ServiceStatus</a></td>
                   <td></td>
-                  <td><p>Status the status of this service </p></td>
+                  <td><p>Status is the status of this service </p></td>
                 </tr>
               
                 <tr>
@@ -19468,7 +19479,7 @@ <h3 id="metalstack.api.v2.HealthStatus.PartitionsEntry">HealthStatus.PartitionsE
         
       
         <h3 id="metalstack.api.v2.PartitionHealth">PartitionHealth</h3>
-        <p>PartitionHealth the status of a specific service in this partition</p>
+        <p>PartitionHealth represents the status of a specific service in this partition.</p>
 
         
           <table class="field-table">
@@ -19481,7 +19492,7 @@ <h3 id="metalstack.api.v2.PartitionHealth">PartitionHealth</h3>
                   <td>status</td>
                   <td><a href="#metalstack.api.v2.ServiceStatus">ServiceStatus</a></td>
                   <td></td>
-                  <td><p>Status the health status of the service in this partition </p></td>
+                  <td><p>Status is the health status of the service in this partition </p></td>
                 </tr>
               
                 <tr>
@@ -19501,7 +19512,7 @@ <h3 id="metalstack.api.v2.PartitionHealth">PartitionHealth</h3>
 
       
         <h3 id="metalstack.api.v2.Service">Service</h3>
-        <p>Service defines the service for which the healtyness is reported</p>
+        <p>Service defines the service for which the healthiness is reported.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Name</td><td>Number</td><td>Description</td></tr>
@@ -19517,19 +19528,19 @@ <h3 id="metalstack.api.v2.Service">Service</h3>
               <tr>
                 <td>SERVICE_IPAM</td>
                 <td>1</td>
-                <td><p>SERVICE_IPAM the ipam service</p></td>
+                <td><p>SERVICE_IPAM the IPAM service</p></td>
               </tr>
             
               <tr>
                 <td>SERVICE_RETHINK</td>
                 <td>2</td>
-                <td><p>SERVICE_RETHINK the rethinkdb</p></td>
+                <td><p>SERVICE_RETHINK the RethinkDB</p></td>
               </tr>
             
               <tr>
                 <td>SERVICE_MASTERDATA</td>
                 <td>3</td>
-                <td><p>SERVICE_MASTERDATA the masterdata-api</p></td>
+                <td><p>SERVICE_MASTERDATA the masterdata API</p></td>
               </tr>
             
               <tr>
@@ -19547,13 +19558,13 @@ <h3 id="metalstack.api.v2.Service">Service</h3>
               <tr>
                 <td>SERVICE_VPN</td>
                 <td>6</td>
-                <td><p>SERVICE_VPN the vpn service</p></td>
+                <td><p>SERVICE_VPN the VPN service</p></td>
               </tr>
             
               <tr>
                 <td>SERVICE_REDIS</td>
                 <td>7</td>
-                <td><p>SERVICE_REDIS the redis service</p></td>
+                <td><p>SERVICE_REDIS the Redis service</p></td>
               </tr>
             
               <tr>
@@ -19566,7 +19577,7 @@ <h3 id="metalstack.api.v2.Service">Service</h3>
         </table>
       
         <h3 id="metalstack.api.v2.ServiceStatus">ServiceStatus</h3>
-        <p>ServiceStatus defines the status of a service</p>
+        <p>ServiceStatus defines the status of a service.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Name</td><td>Number</td><td>Description</td></tr>
@@ -19594,7 +19605,7 @@ <h3 id="metalstack.api.v2.ServiceStatus">ServiceStatus</h3>
               <tr>
                 <td>SERVICE_STATUS_HEALTHY</td>
                 <td>3</td>
-                <td><p>SERVICE_STATUS_HEALTHY the service is in healthy status e.g. fully functional</p></td>
+                <td><p>SERVICE_STATUS_HEALTHY the service is in healthy status, for example fully functional</p></td>
               </tr>
             
           </tbody>
@@ -19605,7 +19616,7 @@ <h3 id="metalstack.api.v2.ServiceStatus">ServiceStatus</h3>
 
       
         <h3 id="metalstack.api.v2.HealthService">HealthService</h3>
-        <p>HealthService serves health related functions</p>
+        <p>HealthService provides health status monitoring operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -19616,7 +19627,7 @@ <h3 id="metalstack.api.v2.HealthService">HealthService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.HealthServiceGetRequest">HealthServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.HealthServiceGetResponse">HealthServiceGetResponse</a></td>
-                <td><p>Get the health of the platform</p></td>
+                <td><p>Returns the health status of the platform.</p></td>
               </tr>
             
           </tbody>
@@ -19632,14 +19643,14 @@ <h2 id="metalstack/api/v2/method.proto">metalstack/api/v2/method.proto</h2><a hr
 
       
         <h3 id="metalstack.api.v2.MethodServiceListRequest">MethodServiceListRequest</h3>
-        <p>MethodServiceListRequest is the request payload to list all public methods</p>
+        <p>MethodServiceListRequest is the request payload for listing all public methods.</p>
 
         
 
         
       
         <h3 id="metalstack.api.v2.MethodServiceListResponse">MethodServiceListResponse</h3>
-        <p>MethodServiceListResponse is the response payload with all public visible methods</p>
+        <p>MethodServiceListResponse is the response payload for listing all public methods.</p>
 
         
           <table class="field-table">
@@ -19663,14 +19674,14 @@ <h3 id="metalstack.api.v2.MethodServiceListResponse">MethodServiceListResponse</
         
       
         <h3 id="metalstack.api.v2.MethodServiceTokenScopedListRequest">MethodServiceTokenScopedListRequest</h3>
-        <p>MethodServiceTokenScopedListRequest is the request payload to list all methods callable with the token present in the request</p>
+        <p>MethodServiceTokenScopedListRequest is the request payload for listing all methods callable with the token present in the request.</p>
 
         
 
         
       
         <h3 id="metalstack.api.v2.MethodServiceTokenScopedListResponse">MethodServiceTokenScopedListResponse</h3>
-        <p>MethodServiceTokenScopedListResponse is the response payload which contains all methods which are callable with the given token</p>
+        <p>MethodServiceTokenScopedListResponse is the response payload which contains all methods which are callable with the given token.</p>
 
         
           <table class="field-table">
@@ -19683,21 +19694,21 @@ <h3 id="metalstack.api.v2.MethodServiceTokenScopedListResponse">MethodServiceTok
                   <td>permissions</td>
                   <td><a href="#metalstack.api.v2.MethodPermission">MethodPermission</a></td>
                   <td>repeated</td>
-                  <td><p>Permissions a list of methods which can be called </p></td>
+                  <td><p>Permissions contains a list of methods which can be called </p></td>
                 </tr>
               
                 <tr>
                   <td>project_roles</td>
                   <td><a href="#metalstack.api.v2.MethodServiceTokenScopedListResponse.ProjectRolesEntry">MethodServiceTokenScopedListResponse.ProjectRolesEntry</a></td>
                   <td>repeated</td>
-                  <td><p>ProjectRoles associates a project id with the corresponding role of the token owner </p></td>
+                  <td><p>ProjectRoles associates a project ID with the corresponding role of the token owner </p></td>
                 </tr>
               
                 <tr>
                   <td>tenant_roles</td>
                   <td><a href="#metalstack.api.v2.MethodServiceTokenScopedListResponse.TenantRolesEntry">MethodServiceTokenScopedListResponse.TenantRolesEntry</a></td>
                   <td>repeated</td>
-                  <td><p>TenantRoles associates a tenant id with the corresponding role of the token owner </p></td>
+                  <td><p>TenantRoles associates a tenant ID with the corresponding role of the token owner </p></td>
                 </tr>
               
                 <tr>
@@ -19828,7 +19839,7 @@ <h3 id="metalstack.api.v2.MethodServiceTokenScopedListResponse.TenantRolesEntry"
 
       
         <h3 id="metalstack.api.v2.MethodService">MethodService</h3>
-        <p>MethodService serves method related functions</p><p>methods are functions in services</p>
+        <p>MethodService provides method discovery operations.</p><p>Methods are functions in services.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -19839,14 +19850,14 @@ <h3 id="metalstack.api.v2.MethodService">MethodService</h3>
                 <td>List</td>
                 <td><a href="#metalstack.api.v2.MethodServiceListRequest">MethodServiceListRequest</a></td>
                 <td><a href="#metalstack.api.v2.MethodServiceListResponse">MethodServiceListResponse</a></td>
-                <td><p>List all public visible methods</p></td>
+                <td><p>Returns the list of all public visible methods.</p></td>
               </tr>
             
               <tr>
                 <td>TokenScopedList</td>
                 <td><a href="#metalstack.api.v2.MethodServiceTokenScopedListRequest">MethodServiceTokenScopedListRequest</a></td>
                 <td><a href="#metalstack.api.v2.MethodServiceTokenScopedListResponse">MethodServiceTokenScopedListResponse</a></td>
-                <td><p>TokenScopedList all methods callable with the token present in the request</p></td>
+                <td><p>TokenScopedList returns all methods callable with the token present in the request.</p></td>
               </tr>
             
           </tbody>
@@ -19862,7 +19873,7 @@ <h2 id="metalstack/api/v2/user.proto">metalstack/api/v2/user.proto</h2><a href="
 
       
         <h3 id="metalstack.api.v2.User">User</h3>
-        <p>User is a end user of the platform</p>
+        <p>User represents an end user of the platform.</p>
 
         
           <table class="field-table">
@@ -19875,7 +19886,7 @@ <h3 id="metalstack.api.v2.User">User</h3>
                   <td>login</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Login the login at the provider </p></td>
+                  <td><p>Login is the login at the provider </p></td>
                 </tr>
               
                 <tr>
@@ -19928,14 +19939,14 @@ <h3 id="metalstack.api.v2.User">User</h3>
         
       
         <h3 id="metalstack.api.v2.UserServiceGetRequest">UserServiceGetRequest</h3>
-        <p>UserServiceGetRequest is the request to get the user</p>
+        <p>UserServiceGetRequest is the request payload for getting the user.</p>
 
         
 
         
       
         <h3 id="metalstack.api.v2.UserServiceGetResponse">UserServiceGetResponse</h3>
-        <p>UserServiceGetResponse the response when userservice get request was called</p>
+        <p>UserServiceGetResponse is the response payload for getting the user.</p>
 
         
           <table class="field-table">
@@ -19948,7 +19959,7 @@ <h3 id="metalstack.api.v2.UserServiceGetResponse">UserServiceGetResponse</h3>
                   <td>user</td>
                   <td><a href="#metalstack.api.v2.User">User</a></td>
                   <td></td>
-                  <td><p>User is the user </p></td>
+                  <td><p>User contains the authenticated user </p></td>
                 </tr>
               
             </tbody>
@@ -19965,7 +19976,7 @@ <h3 id="metalstack.api.v2.UserServiceGetResponse">UserServiceGetResponse</h3>
 
       
         <h3 id="metalstack.api.v2.UserService">UserService</h3>
-        <p>UserService exposes rpc calls for users</p>
+        <p>UserService provides user information operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -19976,7 +19987,7 @@ <h3 id="metalstack.api.v2.UserService">UserService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.api.v2.UserServiceGetRequest">UserServiceGetRequest</a></td>
                 <td><a href="#metalstack.api.v2.UserServiceGetResponse">UserServiceGetResponse</a></td>
-                <td><p>Get a User</p></td>
+                <td><p>Returns the authenticated user.</p></td>
               </tr>
             
           </tbody>
@@ -19992,7 +20003,7 @@ <h2 id="metalstack/infra/v2/bmc.proto">metalstack/infra/v2/bmc.proto</h2><a href
 
       
         <h3 id="metalstack.infra.v2.BMCCommandDoneRequest">BMCCommandDoneRequest</h3>
-        <p>BMCCommandDoneRequest must be returned after command execution</p>
+        <p>BMCCommandDoneRequest must be returned after command execution.</p>
 
         
           <table class="field-table">
@@ -20006,7 +20017,7 @@ <h3 id="metalstack.infra.v2.BMCCommandDoneRequest">BMCCommandDoneRequest</h3>
                   <td><a href="#string">string</a></td>
                   <td></td>
                   <td><p>CommandId is a unique ID which must be sent back after execution
-it is usually in the form: &lt;machine-uuid&gt;:machine-bmc-command </p></td>
+It is usually in the form: &lt;machine-uuid&gt;:machine-bmc-command </p></td>
                 </tr>
               
                 <tr>
@@ -20024,14 +20035,14 @@ <h3 id="metalstack.infra.v2.BMCCommandDoneRequest">BMCCommandDoneRequest</h3>
         
       
         <h3 id="metalstack.infra.v2.BMCCommandDoneResponse">BMCCommandDoneResponse</h3>
-        <p>BMCCommandDoneResponse</p>
+        <p>BMCCommandDoneResponse is the response payload for BMC command completion.</p>
 
         
 
         
       
         <h3 id="metalstack.infra.v2.UpdateBMCInfoRequest">UpdateBMCInfoRequest</h3>
-        <p>UpdateBMCInfoRequest</p>
+        <p>UpdateBMCInfoRequest is the request payload for updating BMC information.</p>
 
         
           <table class="field-table">
@@ -20044,14 +20055,14 @@ <h3 id="metalstack.infra.v2.UpdateBMCInfoRequest">UpdateBMCInfoRequest</h3>
                   <td>partition</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Partition the partition id where metal-bmc wants to receive events </p></td>
+                  <td><p>Partition is the partition ID where metal-bmc wants to receive events </p></td>
                 </tr>
               
                 <tr>
                   <td>bmc_reports</td>
                   <td><a href="#metalstack.infra.v2.UpdateBMCInfoRequest.BmcReportsEntry">UpdateBMCInfoRequest.BmcReportsEntry</a></td>
                   <td>repeated</td>
-                  <td><p>BmcReports contains maps the bmc report per machine uuid </p></td>
+                  <td><p>BmcReports contains maps the BMC report per machine UUID </p></td>
                 </tr>
               
             </tbody>
@@ -20093,7 +20104,7 @@ <h3 id="metalstack.infra.v2.UpdateBMCInfoRequest.BmcReportsEntry">UpdateBMCInfoR
         
       
         <h3 id="metalstack.infra.v2.UpdateBMCInfoResponse">UpdateBMCInfoResponse</h3>
-        <p>UpdateBMCInfoResponse</p>
+        <p>UpdateBMCInfoResponse is the response payload for updating BMC information.</p>
 
         
           <table class="field-table">
@@ -20106,14 +20117,14 @@ <h3 id="metalstack.infra.v2.UpdateBMCInfoResponse">UpdateBMCInfoResponse</h3>
                   <td>updated_machines</td>
                   <td><a href="#string">string</a></td>
                   <td>repeated</td>
-                  <td><p>UpdatedMachines is a slice of machine uuids which were updated </p></td>
+                  <td><p>UpdatedMachines is a slice of machine UUIDs which were updated </p></td>
                 </tr>
               
                 <tr>
                   <td>created_machines</td>
                   <td><a href="#string">string</a></td>
                   <td>repeated</td>
-                  <td><p>CreatedMachines is a slice of machine uuids which were created </p></td>
+                  <td><p>CreatedMachines is a slice of machine UUIDs which were created </p></td>
                 </tr>
               
             </tbody>
@@ -20124,7 +20135,7 @@ <h3 id="metalstack.infra.v2.UpdateBMCInfoResponse">UpdateBMCInfoResponse</h3>
         
       
         <h3 id="metalstack.infra.v2.WaitForBMCCommandRequest">WaitForBMCCommandRequest</h3>
-        <p>WaitForBMCCommandRequest</p>
+        <p>WaitForBMCCommandRequest is the request payload for waiting for a BMC command.</p>
 
         
           <table class="field-table">
@@ -20137,7 +20148,7 @@ <h3 id="metalstack.infra.v2.WaitForBMCCommandRequest">WaitForBMCCommandRequest</
                   <td>partition</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Partition the partition id where metal-bmc wants to receive bmc commands </p></td>
+                  <td><p>Partition is the partition ID where metal-bmc wants to receive BMC commands </p></td>
                 </tr>
               
             </tbody>
@@ -20148,7 +20159,7 @@ <h3 id="metalstack.infra.v2.WaitForBMCCommandRequest">WaitForBMCCommandRequest</
         
       
         <h3 id="metalstack.infra.v2.WaitForBMCCommandResponse">WaitForBMCCommandResponse</h3>
-        <p>WaitForBMCCommandResponse</p>
+        <p>WaitForBMCCommandResponse is the response payload for waiting for a BMC command.</p>
 
         
           <table class="field-table">
@@ -20168,14 +20179,14 @@ <h3 id="metalstack.infra.v2.WaitForBMCCommandResponse">WaitForBMCCommandResponse
                   <td>bmc_command</td>
                   <td><a href="#metalstack.api.v2.MachineBMCCommand">metalstack.api.v2.MachineBMCCommand</a></td>
                   <td></td>
-                  <td><p>BmcCommand to execute against the bmc of the machine </p></td>
+                  <td><p>BmcCommand to execute against the BMC of the machine </p></td>
                 </tr>
               
                 <tr>
                   <td>machine_bmc</td>
                   <td><a href="#metalstack.api.v2.MachineBMC">metalstack.api.v2.MachineBMC</a></td>
                   <td></td>
-                  <td><p>MachineBmc contains connection details of the machine to issue the bmcCommand to </p></td>
+                  <td><p>MachineBmc contains connection details of the machine to issue the BMC command to </p></td>
                 </tr>
               
                 <tr>
@@ -20183,7 +20194,7 @@ <h3 id="metalstack.infra.v2.WaitForBMCCommandResponse">WaitForBMCCommandResponse
                   <td><a href="#string">string</a></td>
                   <td></td>
                   <td><p>CommandId is a unique ID which must be sent back after execution
-it is usually in the form: &lt;machine-uuid&gt;:machine-bmc-command:&lt;command&gt; </p></td>
+It is usually in the form: &lt;machine-uuid&gt;:machine-bmc-command:&lt;command&gt; </p></td>
                 </tr>
               
             </tbody>
@@ -20200,7 +20211,7 @@ <h3 id="metalstack.infra.v2.WaitForBMCCommandResponse">WaitForBMCCommandResponse
 
       
         <h3 id="metalstack.infra.v2.BMCService">BMCService</h3>
-        <p>BMCService serves bmc related functions</p>
+        <p>BMCService provides BMC management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -20211,21 +20222,21 @@ <h3 id="metalstack.infra.v2.BMCService">BMCService</h3>
                 <td>UpdateBMCInfo</td>
                 <td><a href="#metalstack.infra.v2.UpdateBMCInfoRequest">UpdateBMCInfoRequest</a></td>
                 <td><a href="#metalstack.infra.v2.UpdateBMCInfoResponse">UpdateBMCInfoResponse</a></td>
-                <td><p>UpdateBMCInfo</p></td>
+                <td><p>Updates BMC information.</p></td>
               </tr>
             
               <tr>
                 <td>WaitForBMCCommand</td>
                 <td><a href="#metalstack.infra.v2.WaitForBMCCommandRequest">WaitForBMCCommandRequest</a></td>
                 <td><a href="#metalstack.infra.v2.WaitForBMCCommandResponse">WaitForBMCCommandResponse</a> stream</td>
-                <td><p>WaitForBMCCommand is called by the metal-bmc and is returned with a bmc command to execute.</p></td>
+                <td><p>WaitForBMCCommand is called by the metal-bmc and returns a BMC command to execute.</p></td>
               </tr>
             
               <tr>
                 <td>BMCCommandDone</td>
                 <td><a href="#metalstack.infra.v2.BMCCommandDoneRequest">BMCCommandDoneRequest</a></td>
                 <td><a href="#metalstack.infra.v2.BMCCommandDoneResponse">BMCCommandDoneResponse</a></td>
-                <td><p>BMCCommandDone must be called from metal-bmc after the command execution</p></td>
+                <td><p>BMCCommandDone must be called from metal-bmc after the command execution.</p></td>
               </tr>
             
           </tbody>
@@ -20606,7 +20617,7 @@ <h3 id="metalstack.infra.v2.BootServiceWaitResponse">BootServiceWaitResponse</h3
 
       
         <h3 id="metalstack.infra.v2.BootService">BootService</h3>
-        <p>BootService is used for all boot related requests, either pixiecore or metal-hammer</p><p>Pixiecore</p>
+        <p>BootService provides boot-related operations for pixiecore and metal-hammer.</p><p>Pixiecore</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -20617,42 +20628,42 @@ <h3 id="metalstack.infra.v2.BootService">BootService</h3>
                 <td>Dhcp</td>
                 <td><a href="#metalstack.infra.v2.BootServiceDhcpRequest">BootServiceDhcpRequest</a></td>
                 <td><a href="#metalstack.infra.v2.BootServiceDhcpResponse">BootServiceDhcpResponse</a></td>
-                <td><p>Dhcp is the first dhcp request (option 97). A ProvisioningEventPXEBooting is fired</p></td>
+                <td><p>Dhcp handles the first DHCP request (option 97). A ProvisioningEventPXEBooting is fired.</p></td>
               </tr>
             
               <tr>
                 <td>Boot</td>
                 <td><a href="#metalstack.infra.v2.BootServiceBootRequest">BootServiceBootRequest</a></td>
                 <td><a href="#metalstack.infra.v2.BootServiceBootResponse">BootServiceBootResponse</a></td>
-                <td><p>Boot is called from pixie once the machine got the first dhcp response and ipxie asks for subsequent kernel and initrd</p></td>
+                <td><p>Boot is called from pixie once the machine got the first DHCP response and ipxe asks for subsequent kernel and initrd.</p></td>
               </tr>
             
               <tr>
                 <td>SuperUserPassword</td>
                 <td><a href="#metalstack.infra.v2.BootServiceSuperUserPasswordRequest">BootServiceSuperUserPasswordRequest</a></td>
                 <td><a href="#metalstack.infra.v2.BootServiceSuperUserPasswordResponse">BootServiceSuperUserPasswordResponse</a></td>
-                <td><p>SuperUserPassword metal-hammer takes the configured root password for the bmc from metal-apiserver and configure the bmc accordingly</p></td>
+                <td><p>SuperUserPassword returns the configured root password for the BMC.</p></td>
               </tr>
             
               <tr>
                 <td>Register</td>
                 <td><a href="#metalstack.infra.v2.BootServiceRegisterRequest">BootServiceRegisterRequest</a></td>
                 <td><a href="#metalstack.infra.v2.BootServiceRegisterResponse">BootServiceRegisterResponse</a></td>
-                <td><p>Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all gory details about that machine</p></td>
+                <td><p>Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all details about that machine.</p></td>
               </tr>
             
               <tr>
                 <td>Wait</td>
                 <td><a href="#metalstack.infra.v2.BootServiceWaitRequest">BootServiceWaitRequest</a></td>
                 <td><a href="#metalstack.infra.v2.BootServiceWaitResponse">BootServiceWaitResponse</a> stream</td>
-                <td><p>Wait is a hanging call that waits until the machine gets allocated by a user</p></td>
+                <td><p>Wait is a hanging call that waits until the machine gets allocated by a user.</p></td>
               </tr>
             
               <tr>
                 <td>InstallationSucceeded</td>
                 <td><a href="#metalstack.infra.v2.BootServiceInstallationSucceededRequest">BootServiceInstallationSucceededRequest</a></td>
                 <td><a href="#metalstack.infra.v2.BootServiceInstallationSucceededResponse">BootServiceInstallationSucceededResponse</a></td>
-                <td><p>InstallationSucceeded tells metal-apiserver installation was either successful</p></td>
+                <td><p>InstallationSucceeded tells metal-apiserver that installation was successful.</p></td>
               </tr>
             
           </tbody>
@@ -20668,7 +20679,7 @@ <h2 id="metalstack/infra/v2/component.proto">metalstack/infra/v2/component.proto
 
       
         <h3 id="metalstack.infra.v2.ComponentServicePingRequest">ComponentServicePingRequest</h3>
-        <p>ComponentServicePingRequest is sent from a microservice to report its state regularly</p>
+        <p>ComponentServicePingRequest is the request payload for pinging a microservice.</p>
 
         
           <table class="field-table">
@@ -20688,23 +20699,21 @@ <h3 id="metalstack.infra.v2.ComponentServicePingRequest">ComponentServicePingReq
                   <td>identifier</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Identifier is a unique identifier of this service, e.g. if two instance are running, this might be the pod id.
-micro_service and identifier guarantee uniqueness. </p></td>
+                  <td><p>Identifier is a unique identifier of this service, for example if two instances are running, this might be the pod ID </p></td>
                 </tr>
               
                 <tr>
                   <td>started_at</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>StartedAt is the timestamp this service was started. </p></td>
+                  <td><p>StartedAt is the timestamp this service was started </p></td>
                 </tr>
               
                 <tr>
                   <td>interval</td>
                   <td><a href="#google.protobuf.Duration">google.protobuf.Duration</a></td>
                   <td></td>
-                  <td><p>Interval at which the ping is scheduled, must be between 5 seconds and 1 hour.
-Also gets validated in the same way in go/client/ping.go. </p></td>
+                  <td><p>Interval at which the ping is scheduled, must be between 5 seconds and 1 hour </p></td>
                 </tr>
               
                 <tr>
@@ -20722,7 +20731,7 @@ <h3 id="metalstack.infra.v2.ComponentServicePingRequest">ComponentServicePingReq
         
       
         <h3 id="metalstack.infra.v2.ComponentServicePingResponse">ComponentServicePingResponse</h3>
-        <p>ComponentServicePingResponse is the response to a ping request</p>
+        <p>ComponentServicePingResponse is the response payload for pinging a microservice.</p>
 
         
 
@@ -20735,7 +20744,7 @@ <h3 id="metalstack.infra.v2.ComponentServicePingResponse">ComponentServicePingRe
 
       
         <h3 id="metalstack.infra.v2.ComponentService">ComponentService</h3>
-        <p>ComponentService serves component, e.g. microservices related functions.</p>
+        <p>ComponentService provides microservice component management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -20746,8 +20755,7 @@ <h3 id="metalstack.infra.v2.ComponentService">ComponentService</h3>
                 <td>Ping</td>
                 <td><a href="#metalstack.infra.v2.ComponentServicePingRequest">ComponentServicePingRequest</a></td>
                 <td><a href="#metalstack.infra.v2.ComponentServicePingResponse">ComponentServicePingResponse</a></td>
-                <td><p>Ping must be called from every connected microservice in a recurring manner
-to get visibility of all registered microservices.</p></td>
+                <td><p>Returns the ping response to register or report the microservice state.</p></td>
               </tr>
             
           </tbody>
@@ -20763,7 +20771,7 @@ <h2 id="metalstack/infra/v2/event.proto">metalstack/infra/v2/event.proto</h2><a
 
       
         <h3 id="metalstack.infra.v2.EventServiceSendRequest">EventServiceSendRequest</h3>
-        <p>EventServiceSendRequest.</p>
+        <p>EventServiceSendRequest is the request payload for sending provisioning events.</p>
 
         
           <table class="field-table">
@@ -20776,7 +20784,7 @@ <h3 id="metalstack.infra.v2.EventServiceSendRequest">EventServiceSendRequest</h3
                   <td>events</td>
                   <td><a href="#metalstack.infra.v2.EventServiceSendRequest.EventsEntry">EventServiceSendRequest.EventsEntry</a></td>
                   <td>repeated</td>
-                  <td><p>Events grouped by machine IDs. </p></td>
+                  <td><p>Events grouped by machine IDs </p></td>
                 </tr>
               
             </tbody>
@@ -20818,7 +20826,7 @@ <h3 id="metalstack.infra.v2.EventServiceSendRequest.EventsEntry">EventServiceSen
         
       
         <h3 id="metalstack.infra.v2.EventServiceSendResponse">EventServiceSendResponse</h3>
-        <p>EventServiceSendResponse.</p>
+        <p>EventServiceSendResponse is the response payload for sending provisioning events.</p>
 
         
           <table class="field-table">
@@ -20831,14 +20839,14 @@ <h3 id="metalstack.infra.v2.EventServiceSendResponse">EventServiceSendResponse</
                   <td>events</td>
                   <td><a href="#uint64">uint64</a></td>
                   <td></td>
-                  <td><p>Events counts the number of events successfully stored in the database. </p></td>
+                  <td><p>Events counts the number of events successfully stored in the database </p></td>
                 </tr>
               
                 <tr>
                   <td>failed</td>
                   <td><a href="#string">string</a></td>
                   <td>repeated</td>
-                  <td><p>Failed contains IDs of all machines whose events could not be stored in the database. </p></td>
+                  <td><p>Failed contains IDs of all machines whose events could not be stored in the database </p></td>
                 </tr>
               
             </tbody>
@@ -20862,21 +20870,21 @@ <h3 id="metalstack.infra.v2.MachineProvisioningEvent">MachineProvisioningEvent</
                   <td>time</td>
                   <td><a href="#google.protobuf.Timestamp">google.protobuf.Timestamp</a></td>
                   <td></td>
-                  <td><p>Time the event occurred at. </p></td>
+                  <td><p>Time the event occurred at </p></td>
                 </tr>
               
                 <tr>
                   <td>event</td>
                   <td><a href="#metalstack.infra.v2.ProvisioningEventType">ProvisioningEventType</a></td>
                   <td></td>
-                  <td><p>Event that occurred. </p></td>
+                  <td><p>Event that occurred </p></td>
                 </tr>
               
                 <tr>
                   <td>message</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Message describing the event in more detail. </p></td>
+                  <td><p>Message describes the event in more detail </p></td>
                 </tr>
               
             </tbody>
@@ -20899,73 +20907,73 @@ <h3 id="metalstack.infra.v2.ProvisioningEventType">ProvisioningEventType</h3>
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_UNSPECIFIED</td>
                 <td>0</td>
-                <td><p>PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_ALIVE</td>
                 <td>1</td>
-                <td><p>PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_CRASHED</td>
                 <td>2</td>
-                <td><p>PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine&#39;s lifecycle.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine&#39;s lifecycle</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_PXE_BOOTING</td>
                 <td>3</td>
-                <td><p>PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_PLANNED_REBOOT</td>
                 <td>4</td>
-                <td><p>PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_PREPARING</td>
                 <td>5</td>
-                <td><p>PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_REGISTERING</td>
                 <td>6</td>
-                <td><p>PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_WAITING</td>
                 <td>7</td>
-                <td><p>PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_INSTALLING</td>
                 <td>8</td>
-                <td><p>PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL</td>
                 <td>9</td>
-                <td><p>PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_PHONED_HOME</td>
                 <td>10</td>
-                <td><p>PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness</p></td>
               </tr>
             
               <tr>
                 <td>PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM</td>
                 <td>11</td>
-                <td><p>PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines.</p></td>
+                <td><p>PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines</p></td>
               </tr>
             
           </tbody>
@@ -20976,7 +20984,7 @@ <h3 id="metalstack.infra.v2.ProvisioningEventType">ProvisioningEventType</h3>
 
       
         <h3 id="metalstack.infra.v2.EventService">EventService</h3>
-        <p>EventService serves event related functions.</p>
+        <p>EventService provides machine provisioning event logging operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -20987,7 +20995,7 @@ <h3 id="metalstack.infra.v2.EventService">EventService</h3>
                 <td>Send</td>
                 <td><a href="#metalstack.infra.v2.EventServiceSendRequest">EventServiceSendRequest</a></td>
                 <td><a href="#metalstack.infra.v2.EventServiceSendResponse">EventServiceSendResponse</a></td>
-                <td><p>Send a series of machine provisioning events.</p></td>
+                <td><p>Sends a series of machine provisioning events.</p></td>
               </tr>
             
           </tbody>
@@ -21003,7 +21011,7 @@ <h2 id="metalstack/infra/v2/switch.proto">metalstack/infra/v2/switch.proto</h2><
 
       
         <h3 id="metalstack.infra.v2.SwitchServiceGetRequest">SwitchServiceGetRequest</h3>
-        <p>SwitchServiceGetRequest.</p>
+        <p>SwitchServiceGetRequest is the request payload for getting a switch.</p>
 
         
           <table class="field-table">
@@ -21016,7 +21024,7 @@ <h3 id="metalstack.infra.v2.SwitchServiceGetRequest">SwitchServiceGetRequest</h3
                   <td>id</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Id of the switch. </p></td>
+                  <td><p>Id of the switch </p></td>
                 </tr>
               
             </tbody>
@@ -21027,7 +21035,7 @@ <h3 id="metalstack.infra.v2.SwitchServiceGetRequest">SwitchServiceGetRequest</h3
         
       
         <h3 id="metalstack.infra.v2.SwitchServiceGetResponse">SwitchServiceGetResponse</h3>
-        <p>SwitchServiceGetResponse.</p>
+        <p>SwitchServiceGetResponse is the response payload for getting a switch.</p>
 
         
           <table class="field-table">
@@ -21040,7 +21048,7 @@ <h3 id="metalstack.infra.v2.SwitchServiceGetResponse">SwitchServiceGetResponse</
                   <td>switch</td>
                   <td><a href="#metalstack.api.v2.Switch">metalstack.api.v2.Switch</a></td>
                   <td></td>
-                  <td><p>Switch that was requested. </p></td>
+                  <td><p>Switch contains the requested switch </p></td>
                 </tr>
               
             </tbody>
@@ -21051,7 +21059,7 @@ <h3 id="metalstack.infra.v2.SwitchServiceGetResponse">SwitchServiceGetResponse</
         
       
         <h3 id="metalstack.infra.v2.SwitchServiceHeartbeatRequest">SwitchServiceHeartbeatRequest</h3>
-        <p>SwitchServiceHeartbeatRequest.</p>
+        <p>SwitchServiceHeartbeatRequest is the request payload for sending a switch heartbeat.</p>
 
         
           <table class="field-table">
@@ -21064,35 +21072,35 @@ <h3 id="metalstack.infra.v2.SwitchServiceHeartbeatRequest">SwitchServiceHeartbea
                   <td>id</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Id of the switch. </p></td>
+                  <td><p>Id of the switch </p></td>
                 </tr>
               
                 <tr>
                   <td>duration</td>
                   <td><a href="#google.protobuf.Duration">google.protobuf.Duration</a></td>
                   <td></td>
-                  <td><p>Duration of the sync. </p></td>
+                  <td><p>Duration of the sync </p></td>
                 </tr>
               
                 <tr>
                   <td>error</td>
                   <td><a href="#string">string</a></td>
                   <td>optional</td>
-                  <td><p>Error if any occurred during the sync. </p></td>
+                  <td><p>Error if any occurred during the sync </p></td>
                 </tr>
               
                 <tr>
                   <td>port_states</td>
                   <td><a href="#metalstack.infra.v2.SwitchServiceHeartbeatRequest.PortStatesEntry">SwitchServiceHeartbeatRequest.PortStatesEntry</a></td>
                   <td>repeated</td>
-                  <td><p>PortStates maps port identifiers to the respective port&#39;s operational state. </p></td>
+                  <td><p>PortStates maps port identifiers to the respective port&#39;s operational state </p></td>
                 </tr>
               
                 <tr>
                   <td>bgp_port_states</td>
                   <td><a href="#metalstack.infra.v2.SwitchServiceHeartbeatRequest.BgpPortStatesEntry">SwitchServiceHeartbeatRequest.BgpPortStatesEntry</a></td>
                   <td>repeated</td>
-                  <td><p>BgpPortStates maps port identifiers to the respective port&#39;s BGP state. </p></td>
+                  <td><p>BgpPortStates maps port identifiers to the respective port&#39;s BGP state </p></td>
                 </tr>
               
             </tbody>
@@ -21165,7 +21173,7 @@ <h3 id="metalstack.infra.v2.SwitchServiceHeartbeatRequest.PortStatesEntry">Switc
         
       
         <h3 id="metalstack.infra.v2.SwitchServiceHeartbeatResponse">SwitchServiceHeartbeatResponse</h3>
-        <p>SwitchServiceHeartbeatResponse.</p>
+        <p>SwitchServiceHeartbeatResponse is the response payload for sending a switch heartbeat.</p>
 
         
           <table class="field-table">
@@ -21178,21 +21186,21 @@ <h3 id="metalstack.infra.v2.SwitchServiceHeartbeatResponse">SwitchServiceHeartbe
                   <td>id</td>
                   <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>Id of the switch. </p></td>
+                  <td><p>Id of the switch </p></td>
                 </tr>
               
                 <tr>
                   <td>last_sync</td>
                   <td><a href="#metalstack.api.v2.SwitchSync">metalstack.api.v2.SwitchSync</a></td>
                   <td></td>
-                  <td><p>LastSync holds information about the last sync. </p></td>
+                  <td><p>LastSync holds information about the last sync </p></td>
                 </tr>
               
                 <tr>
                   <td>last_sync_error</td>
                   <td><a href="#metalstack.api.v2.SwitchSync">metalstack.api.v2.SwitchSync</a></td>
                   <td></td>
-                  <td><p>LastSyncError holds information about the last erroneous sync. </p></td>
+                  <td><p>LastSyncError holds information about the last erroneous sync </p></td>
                 </tr>
               
             </tbody>
@@ -21203,7 +21211,7 @@ <h3 id="metalstack.infra.v2.SwitchServiceHeartbeatResponse">SwitchServiceHeartbe
         
       
         <h3 id="metalstack.infra.v2.SwitchServiceRegisterRequest">SwitchServiceRegisterRequest</h3>
-        <p>SwitchServiceRegisterRequest.</p>
+        <p>SwitchServiceRegisterRequest is the request payload for registering a switch.</p>
 
         
           <table class="field-table">
@@ -21216,7 +21224,7 @@ <h3 id="metalstack.infra.v2.SwitchServiceRegisterRequest">SwitchServiceRegisterR
                   <td>switch</td>
                   <td><a href="#metalstack.api.v2.Switch">metalstack.api.v2.Switch</a></td>
                   <td></td>
-                  <td><p>Switch to register. </p></td>
+                  <td><p>Switch to register </p></td>
                 </tr>
               
             </tbody>
@@ -21227,7 +21235,7 @@ <h3 id="metalstack.infra.v2.SwitchServiceRegisterRequest">SwitchServiceRegisterR
         
       
         <h3 id="metalstack.infra.v2.SwitchServiceRegisterResponse">SwitchServiceRegisterResponse</h3>
-        <p>SwitchServiceRegisterResponse.</p>
+        <p>SwitchServiceRegisterResponse is the response payload for registering a switch.</p>
 
         
           <table class="field-table">
@@ -21240,7 +21248,7 @@ <h3 id="metalstack.infra.v2.SwitchServiceRegisterResponse">SwitchServiceRegister
                   <td>switch</td>
                   <td><a href="#metalstack.api.v2.Switch">metalstack.api.v2.Switch</a></td>
                   <td></td>
-                  <td><p>Switch that was registered. </p></td>
+                  <td><p>Switch contains the registered switch </p></td>
                 </tr>
               
             </tbody>
@@ -21257,7 +21265,7 @@ <h3 id="metalstack.infra.v2.SwitchServiceRegisterResponse">SwitchServiceRegister
 
       
         <h3 id="metalstack.infra.v2.SwitchService">SwitchService</h3>
-        <p>SwitchService serves switch related functions.</p>
+        <p>SwitchService provides infrastructure switch management operations.</p>
         <table class="enum-table">
           <thead>
             <tr><td>Method Name</td><td>Request Type</td><td>Response Type</td><td>Description</td></tr>
@@ -21268,21 +21276,21 @@ <h3 id="metalstack.infra.v2.SwitchService">SwitchService</h3>
                 <td>Get</td>
                 <td><a href="#metalstack.infra.v2.SwitchServiceGetRequest">SwitchServiceGetRequest</a></td>
                 <td><a href="#metalstack.infra.v2.SwitchServiceGetResponse">SwitchServiceGetResponse</a></td>
-                <td><p>Get a switch by ID.</p></td>
+                <td><p>Returns the switch with the specified ID.</p></td>
               </tr>
             
               <tr>
                 <td>Register</td>
                 <td><a href="#metalstack.infra.v2.SwitchServiceRegisterRequest">SwitchServiceRegisterRequest</a></td>
                 <td><a href="#metalstack.infra.v2.SwitchServiceRegisterResponse">SwitchServiceRegisterResponse</a></td>
-                <td><p>Register a switch.</p></td>
+                <td><p>Registers a switch.</p></td>
               </tr>
             
               <tr>
                 <td>Heartbeat</td>
                 <td><a href="#metalstack.infra.v2.SwitchServiceHeartbeatRequest">SwitchServiceHeartbeatRequest</a></td>
                 <td><a href="#metalstack.infra.v2.SwitchServiceHeartbeatResponse">SwitchServiceHeartbeatResponse</a></td>
-                <td><p>Heartbeat a switch.</p></td>
+                <td><p>Heartbeat sends a heartbeat from a switch.</p></td>
               </tr>
             
           </tbody>
diff --git a/go/metalstack/admin/v2/adminv2connect/audit.connect.go b/go/metalstack/admin/v2/adminv2connect/audit.connect.go
index e844179d..2241e2d5 100644
--- a/go/metalstack/admin/v2/adminv2connect/audit.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/audit.connect.go
@@ -41,9 +41,9 @@ const (
 
 // AuditServiceClient is a client for the metalstack.admin.v2.AuditService service.
 type AuditServiceClient interface {
-	// Get an audit trace
+	// Returns the audit trace with the specified UUID.
 	Get(context.Context, *v2.AuditServiceGetRequest) (*v2.AuditServiceGetResponse, error)
-	// List all audit traces
+	// Returns the list of all audit traces.
 	List(context.Context, *v2.AuditServiceListRequest) (*v2.AuditServiceListResponse, error)
 }
 
@@ -99,9 +99,9 @@ func (c *auditServiceClient) List(ctx context.Context, req *v2.AuditServiceListR
 
 // AuditServiceHandler is an implementation of the metalstack.admin.v2.AuditService service.
 type AuditServiceHandler interface {
-	// Get an audit trace
+	// Returns the audit trace with the specified UUID.
 	Get(context.Context, *v2.AuditServiceGetRequest) (*v2.AuditServiceGetResponse, error)
-	// List all audit traces
+	// Returns the list of all audit traces.
 	List(context.Context, *v2.AuditServiceListRequest) (*v2.AuditServiceListResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/component.connect.go b/go/metalstack/admin/v2/adminv2connect/component.connect.go
index f9e0c662..da843f1a 100644
--- a/go/metalstack/admin/v2/adminv2connect/component.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/component.connect.go
@@ -43,11 +43,11 @@ const (
 
 // ComponentServiceClient is a client for the metalstack.admin.v2.ComponentService service.
 type ComponentServiceClient interface {
-	// Get a single component
+	// Returns the component with the specified UUID.
 	Get(context.Context, *v2.ComponentServiceGetRequest) (*v2.ComponentServiceGetResponse, error)
-	// Delete a component
+	// Deletes the component with the specified UUID.
 	Delete(context.Context, *v2.ComponentServiceDeleteRequest) (*v2.ComponentServiceDeleteResponse, error)
-	// List all components with their status
+	// Returns the list of all components with their status.
 	List(context.Context, *v2.ComponentServiceListRequest) (*v2.ComponentServiceListResponse, error)
 }
 
@@ -119,11 +119,11 @@ func (c *componentServiceClient) List(ctx context.Context, req *v2.ComponentServ
 
 // ComponentServiceHandler is an implementation of the metalstack.admin.v2.ComponentService service.
 type ComponentServiceHandler interface {
-	// Get a single component
+	// Returns the component with the specified UUID.
 	Get(context.Context, *v2.ComponentServiceGetRequest) (*v2.ComponentServiceGetResponse, error)
-	// Delete a component
+	// Deletes the component with the specified UUID.
 	Delete(context.Context, *v2.ComponentServiceDeleteRequest) (*v2.ComponentServiceDeleteResponse, error)
-	// List all components with their status
+	// Returns the list of all components with their status.
 	List(context.Context, *v2.ComponentServiceListRequest) (*v2.ComponentServiceListResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/filesystem.connect.go b/go/metalstack/admin/v2/adminv2connect/filesystem.connect.go
index 2dc6583f..da067030 100644
--- a/go/metalstack/admin/v2/adminv2connect/filesystem.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/filesystem.connect.go
@@ -46,11 +46,11 @@ const (
 
 // FilesystemServiceClient is a client for the metalstack.admin.v2.FilesystemService service.
 type FilesystemServiceClient interface {
-	// Create a filesystem
+	// Creates a new filesystem.
 	Create(context.Context, *v2.FilesystemServiceCreateRequest) (*v2.FilesystemServiceCreateResponse, error)
-	// Update a filesystem
+	// Updates a filesystem.
 	Update(context.Context, *v2.FilesystemServiceUpdateRequest) (*v2.FilesystemServiceUpdateResponse, error)
-	// Delete a filesystem
+	// Deletes a filesystem.
 	Delete(context.Context, *v2.FilesystemServiceDeleteRequest) (*v2.FilesystemServiceDeleteResponse, error)
 }
 
@@ -123,11 +123,11 @@ func (c *filesystemServiceClient) Delete(ctx context.Context, req *v2.Filesystem
 // FilesystemServiceHandler is an implementation of the metalstack.admin.v2.FilesystemService
 // service.
 type FilesystemServiceHandler interface {
-	// Create a filesystem
+	// Creates a new filesystem.
 	Create(context.Context, *v2.FilesystemServiceCreateRequest) (*v2.FilesystemServiceCreateResponse, error)
-	// Update a filesystem
+	// Updates a filesystem.
 	Update(context.Context, *v2.FilesystemServiceUpdateRequest) (*v2.FilesystemServiceUpdateResponse, error)
-	// Delete a filesystem
+	// Deletes a filesystem.
 	Delete(context.Context, *v2.FilesystemServiceDeleteRequest) (*v2.FilesystemServiceDeleteResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/image.connect.go b/go/metalstack/admin/v2/adminv2connect/image.connect.go
index 5c9c1e40..321e7267 100644
--- a/go/metalstack/admin/v2/adminv2connect/image.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/image.connect.go
@@ -45,13 +45,13 @@ const (
 
 // ImageServiceClient is a client for the metalstack.admin.v2.ImageService service.
 type ImageServiceClient interface {
-	// Create a image
+	// Creates a new image.
 	Create(context.Context, *v2.ImageServiceCreateRequest) (*v2.ImageServiceCreateResponse, error)
-	// Update a image
+	// Updates an image.
 	Update(context.Context, *v2.ImageServiceUpdateRequest) (*v2.ImageServiceUpdateResponse, error)
-	// Delete a image
+	// Deletes an image.
 	Delete(context.Context, *v2.ImageServiceDeleteRequest) (*v2.ImageServiceDeleteResponse, error)
-	// Usage of images
+	// Returns the usage of images.
 	Usage(context.Context, *v2.ImageServiceUsageRequest) (*v2.ImageServiceUsageResponse, error)
 }
 
@@ -139,13 +139,13 @@ func (c *imageServiceClient) Usage(ctx context.Context, req *v2.ImageServiceUsag
 
 // ImageServiceHandler is an implementation of the metalstack.admin.v2.ImageService service.
 type ImageServiceHandler interface {
-	// Create a image
+	// Creates a new image.
 	Create(context.Context, *v2.ImageServiceCreateRequest) (*v2.ImageServiceCreateResponse, error)
-	// Update a image
+	// Updates an image.
 	Update(context.Context, *v2.ImageServiceUpdateRequest) (*v2.ImageServiceUpdateResponse, error)
-	// Delete a image
+	// Deletes an image.
 	Delete(context.Context, *v2.ImageServiceDeleteRequest) (*v2.ImageServiceDeleteResponse, error)
-	// Usage of images
+	// Returns the usage of images.
 	Usage(context.Context, *v2.ImageServiceUsageRequest) (*v2.ImageServiceUsageResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/ip.connect.go b/go/metalstack/admin/v2/adminv2connect/ip.connect.go
index 02e51cb5..ce2541e1 100644
--- a/go/metalstack/admin/v2/adminv2connect/ip.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/ip.connect.go
@@ -39,7 +39,7 @@ const (
 
 // IPServiceClient is a client for the metalstack.admin.v2.IPService service.
 type IPServiceClient interface {
-	// List all ips
+	// Returns the list of all IP addresses.
 	List(context.Context, *v2.IPServiceListRequest) (*v2.IPServiceListResponse, error)
 }
 
@@ -79,7 +79,7 @@ func (c *iPServiceClient) List(ctx context.Context, req *v2.IPServiceListRequest
 
 // IPServiceHandler is an implementation of the metalstack.admin.v2.IPService service.
 type IPServiceHandler interface {
-	// List all ips
+	// Returns the list of all IP addresses.
 	List(context.Context, *v2.IPServiceListRequest) (*v2.IPServiceListResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/machine.connect.go b/go/metalstack/admin/v2/adminv2connect/machine.connect.go
index 121b2a3a..371b2430 100644
--- a/go/metalstack/admin/v2/adminv2connect/machine.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/machine.connect.go
@@ -51,17 +51,17 @@ const (
 
 // MachineServiceClient is a client for the metalstack.admin.v2.MachineService service.
 type MachineServiceClient interface {
-	// Get a machine
+	// Returns the machine with the specified UUID.
 	Get(context.Context, *v2.MachineServiceGetRequest) (*v2.MachineServiceGetResponse, error)
-	// List all machines
+	// Returns the list of all machines.
 	List(context.Context, *v2.MachineServiceListRequest) (*v2.MachineServiceListResponse, error)
-	// BMCCommand send a command to the bmc of a machine
+	// BMCCommand sends a command to the BMC of a machine.
 	BMCCommand(context.Context, *v2.MachineServiceBMCCommandRequest) (*v2.MachineServiceBMCCommandResponse, error)
-	// GetBMC returns the BMC details of a machine
+	// Returns the BMC details of a machine.
 	GetBMC(context.Context, *v2.MachineServiceGetBMCRequest) (*v2.MachineServiceGetBMCResponse, error)
-	// ListBMC returns the BMC details of many machines
+	// ListBMC returns the BMC details of many machines.
 	ListBMC(context.Context, *v2.MachineServiceListBMCRequest) (*v2.MachineServiceListBMCResponse, error)
-	// ConsolePassword returns the password to access the serial console of the machine
+	// GetConsolePassword returns the password to access the serial console of the machine.
 	ConsolePassword(context.Context, *v2.MachineServiceConsolePasswordRequest) (*v2.MachineServiceConsolePasswordResponse, error)
 }
 
@@ -181,17 +181,17 @@ func (c *machineServiceClient) ConsolePassword(ctx context.Context, req *v2.Mach
 
 // MachineServiceHandler is an implementation of the metalstack.admin.v2.MachineService service.
 type MachineServiceHandler interface {
-	// Get a machine
+	// Returns the machine with the specified UUID.
 	Get(context.Context, *v2.MachineServiceGetRequest) (*v2.MachineServiceGetResponse, error)
-	// List all machines
+	// Returns the list of all machines.
 	List(context.Context, *v2.MachineServiceListRequest) (*v2.MachineServiceListResponse, error)
-	// BMCCommand send a command to the bmc of a machine
+	// BMCCommand sends a command to the BMC of a machine.
 	BMCCommand(context.Context, *v2.MachineServiceBMCCommandRequest) (*v2.MachineServiceBMCCommandResponse, error)
-	// GetBMC returns the BMC details of a machine
+	// Returns the BMC details of a machine.
 	GetBMC(context.Context, *v2.MachineServiceGetBMCRequest) (*v2.MachineServiceGetBMCResponse, error)
-	// ListBMC returns the BMC details of many machines
+	// ListBMC returns the BMC details of many machines.
 	ListBMC(context.Context, *v2.MachineServiceListBMCRequest) (*v2.MachineServiceListBMCResponse, error)
-	// ConsolePassword returns the password to access the serial console of the machine
+	// GetConsolePassword returns the password to access the serial console of the machine.
 	ConsolePassword(context.Context, *v2.MachineServiceConsolePasswordRequest) (*v2.MachineServiceConsolePasswordResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/network.connect.go b/go/metalstack/admin/v2/adminv2connect/network.connect.go
index 1e33c994..039d93d0 100644
--- a/go/metalstack/admin/v2/adminv2connect/network.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/network.connect.go
@@ -47,15 +47,15 @@ const (
 
 // NetworkServiceClient is a client for the metalstack.admin.v2.NetworkService service.
 type NetworkServiceClient interface {
-	// Get a network
+	// Returns the network with the specified ID.
 	Get(context.Context, *v2.NetworkServiceGetRequest) (*v2.NetworkServiceGetResponse, error)
-	// Create a network
+	// Creates a new network.
 	Create(context.Context, *v2.NetworkServiceCreateRequest) (*v2.NetworkServiceCreateResponse, error)
-	// Update a network
+	// Updates a network.
 	Update(context.Context, *v2.NetworkServiceUpdateRequest) (*v2.NetworkServiceUpdateResponse, error)
-	// Delete a network
+	// Deletes a network.
 	Delete(context.Context, *v2.NetworkServiceDeleteRequest) (*v2.NetworkServiceDeleteResponse, error)
-	// List all networks
+	// Returns the list of all networks.
 	List(context.Context, *v2.NetworkServiceListRequest) (*v2.NetworkServiceListResponse, error)
 }
 
@@ -159,15 +159,15 @@ func (c *networkServiceClient) List(ctx context.Context, req *v2.NetworkServiceL
 
 // NetworkServiceHandler is an implementation of the metalstack.admin.v2.NetworkService service.
 type NetworkServiceHandler interface {
-	// Get a network
+	// Returns the network with the specified ID.
 	Get(context.Context, *v2.NetworkServiceGetRequest) (*v2.NetworkServiceGetResponse, error)
-	// Create a network
+	// Creates a new network.
 	Create(context.Context, *v2.NetworkServiceCreateRequest) (*v2.NetworkServiceCreateResponse, error)
-	// Update a network
+	// Updates a network.
 	Update(context.Context, *v2.NetworkServiceUpdateRequest) (*v2.NetworkServiceUpdateResponse, error)
-	// Delete a network
+	// Deletes a network.
 	Delete(context.Context, *v2.NetworkServiceDeleteRequest) (*v2.NetworkServiceDeleteResponse, error)
-	// List all networks
+	// Returns the list of all networks.
 	List(context.Context, *v2.NetworkServiceListRequest) (*v2.NetworkServiceListResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/partition.connect.go b/go/metalstack/admin/v2/adminv2connect/partition.connect.go
index 28a4e8f7..1f6dcdf9 100644
--- a/go/metalstack/admin/v2/adminv2connect/partition.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/partition.connect.go
@@ -46,13 +46,13 @@ const (
 
 // PartitionServiceClient is a client for the metalstack.admin.v2.PartitionService service.
 type PartitionServiceClient interface {
-	// Create a partition
+	// Creates a new partition.
 	Create(context.Context, *v2.PartitionServiceCreateRequest) (*v2.PartitionServiceCreateResponse, error)
-	// Update a partition
+	// Updates a partition.
 	Update(context.Context, *v2.PartitionServiceUpdateRequest) (*v2.PartitionServiceUpdateResponse, error)
-	// Delete a partition
+	// Deletes a partition.
 	Delete(context.Context, *v2.PartitionServiceDeleteRequest) (*v2.PartitionServiceDeleteResponse, error)
-	// Capacity of a partitions
+	// Returns the capacity of a partition.
 	Capacity(context.Context, *v2.PartitionServiceCapacityRequest) (*v2.PartitionServiceCapacityResponse, error)
 }
 
@@ -140,13 +140,13 @@ func (c *partitionServiceClient) Capacity(ctx context.Context, req *v2.Partition
 
 // PartitionServiceHandler is an implementation of the metalstack.admin.v2.PartitionService service.
 type PartitionServiceHandler interface {
-	// Create a partition
+	// Creates a new partition.
 	Create(context.Context, *v2.PartitionServiceCreateRequest) (*v2.PartitionServiceCreateResponse, error)
-	// Update a partition
+	// Updates a partition.
 	Update(context.Context, *v2.PartitionServiceUpdateRequest) (*v2.PartitionServiceUpdateResponse, error)
-	// Delete a partition
+	// Deletes a partition.
 	Delete(context.Context, *v2.PartitionServiceDeleteRequest) (*v2.PartitionServiceDeleteResponse, error)
-	// Capacity of a partitions
+	// Returns the capacity of a partition.
 	Capacity(context.Context, *v2.PartitionServiceCapacityRequest) (*v2.PartitionServiceCapacityResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/project.connect.go b/go/metalstack/admin/v2/adminv2connect/project.connect.go
index 8dfddbc4..9d614b2f 100644
--- a/go/metalstack/admin/v2/adminv2connect/project.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/project.connect.go
@@ -39,7 +39,7 @@ const (
 
 // ProjectServiceClient is a client for the metalstack.admin.v2.ProjectService service.
 type ProjectServiceClient interface {
-	// List projects based on various filter criteria
+	// Returns the list of projects matching the filter criteria.
 	List(context.Context, *v2.ProjectServiceListRequest) (*v2.ProjectServiceListResponse, error)
 }
 
@@ -79,7 +79,7 @@ func (c *projectServiceClient) List(ctx context.Context, req *v2.ProjectServiceL
 
 // ProjectServiceHandler is an implementation of the metalstack.admin.v2.ProjectService service.
 type ProjectServiceHandler interface {
-	// List projects based on various filter criteria
+	// Returns the list of projects matching the filter criteria.
 	List(context.Context, *v2.ProjectServiceListRequest) (*v2.ProjectServiceListResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/size.connect.go b/go/metalstack/admin/v2/adminv2connect/size.connect.go
index cef7b27e..4f94d4a9 100644
--- a/go/metalstack/admin/v2/adminv2connect/size.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/size.connect.go
@@ -43,11 +43,11 @@ const (
 
 // SizeServiceClient is a client for the metalstack.admin.v2.SizeService service.
 type SizeServiceClient interface {
-	// Create a size
+	// Creates a new size.
 	Create(context.Context, *v2.SizeServiceCreateRequest) (*v2.SizeServiceCreateResponse, error)
-	// Update a size
+	// Updates a size.
 	Update(context.Context, *v2.SizeServiceUpdateRequest) (*v2.SizeServiceUpdateResponse, error)
-	// Delete a size
+	// Deletes a size.
 	Delete(context.Context, *v2.SizeServiceDeleteRequest) (*v2.SizeServiceDeleteResponse, error)
 }
 
@@ -119,11 +119,11 @@ func (c *sizeServiceClient) Delete(ctx context.Context, req *v2.SizeServiceDelet
 
 // SizeServiceHandler is an implementation of the metalstack.admin.v2.SizeService service.
 type SizeServiceHandler interface {
-	// Create a size
+	// Creates a new size.
 	Create(context.Context, *v2.SizeServiceCreateRequest) (*v2.SizeServiceCreateResponse, error)
-	// Update a size
+	// Updates a size.
 	Update(context.Context, *v2.SizeServiceUpdateRequest) (*v2.SizeServiceUpdateResponse, error)
-	// Delete a size
+	// Deletes a size.
 	Delete(context.Context, *v2.SizeServiceDeleteRequest) (*v2.SizeServiceDeleteResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/size_imageconstraint.connect.go b/go/metalstack/admin/v2/adminv2connect/size_imageconstraint.connect.go
index 2f93a493..29b12288 100644
--- a/go/metalstack/admin/v2/adminv2connect/size_imageconstraint.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/size_imageconstraint.connect.go
@@ -54,15 +54,15 @@ const (
 // SizeImageConstraintServiceClient is a client for the
 // metalstack.admin.v2.SizeImageConstraintService service.
 type SizeImageConstraintServiceClient interface {
-	// Create a size image constraint
+	// Creates a size image constraint.
 	Create(context.Context, *v2.SizeImageConstraintServiceCreateRequest) (*v2.SizeImageConstraintServiceCreateResponse, error)
-	// Update a size image constraint
+	// Updates a size image constraint.
 	Update(context.Context, *v2.SizeImageConstraintServiceUpdateRequest) (*v2.SizeImageConstraintServiceUpdateResponse, error)
-	// Delete a size image constraint
+	// Deletes a size image constraint.
 	Delete(context.Context, *v2.SizeImageConstraintServiceDeleteRequest) (*v2.SizeImageConstraintServiceDeleteResponse, error)
-	// Get a size image constraint
+	// Returns the size image constraint with the specified size.
 	Get(context.Context, *v2.SizeImageConstraintServiceGetRequest) (*v2.SizeImageConstraintServiceGetResponse, error)
-	// List a size image constraint
+	// Returns the list of size image constraints.
 	List(context.Context, *v2.SizeImageConstraintServiceListRequest) (*v2.SizeImageConstraintServiceListResponse, error)
 }
 
@@ -168,15 +168,15 @@ func (c *sizeImageConstraintServiceClient) List(ctx context.Context, req *v2.Siz
 // SizeImageConstraintServiceHandler is an implementation of the
 // metalstack.admin.v2.SizeImageConstraintService service.
 type SizeImageConstraintServiceHandler interface {
-	// Create a size image constraint
+	// Creates a size image constraint.
 	Create(context.Context, *v2.SizeImageConstraintServiceCreateRequest) (*v2.SizeImageConstraintServiceCreateResponse, error)
-	// Update a size image constraint
+	// Updates a size image constraint.
 	Update(context.Context, *v2.SizeImageConstraintServiceUpdateRequest) (*v2.SizeImageConstraintServiceUpdateResponse, error)
-	// Delete a size image constraint
+	// Deletes a size image constraint.
 	Delete(context.Context, *v2.SizeImageConstraintServiceDeleteRequest) (*v2.SizeImageConstraintServiceDeleteResponse, error)
-	// Get a size image constraint
+	// Returns the size image constraint with the specified size.
 	Get(context.Context, *v2.SizeImageConstraintServiceGetRequest) (*v2.SizeImageConstraintServiceGetResponse, error)
-	// List a size image constraint
+	// Returns the list of size image constraints.
 	List(context.Context, *v2.SizeImageConstraintServiceListRequest) (*v2.SizeImageConstraintServiceListResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/size_reservation.connect.go b/go/metalstack/admin/v2/adminv2connect/size_reservation.connect.go
index b2c99985..823544c5 100644
--- a/go/metalstack/admin/v2/adminv2connect/size_reservation.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/size_reservation.connect.go
@@ -50,13 +50,13 @@ const (
 // SizeReservationServiceClient is a client for the metalstack.admin.v2.SizeReservationService
 // service.
 type SizeReservationServiceClient interface {
-	// Create a size reservation
+	// Creates a new size reservation.
 	Create(context.Context, *v2.SizeReservationServiceCreateRequest) (*v2.SizeReservationServiceCreateResponse, error)
-	// Update a size reservation
+	// Updates a size reservation.
 	Update(context.Context, *v2.SizeReservationServiceUpdateRequest) (*v2.SizeReservationServiceUpdateResponse, error)
-	// Delete a size reservation
+	// Deletes a size reservation.
 	Delete(context.Context, *v2.SizeReservationServiceDeleteRequest) (*v2.SizeReservationServiceDeleteResponse, error)
-	// List size reservations
+	// Returns the list of size reservations.
 	List(context.Context, *v2.SizeReservationServiceListRequest) (*v2.SizeReservationServiceListResponse, error)
 }
 
@@ -145,13 +145,13 @@ func (c *sizeReservationServiceClient) List(ctx context.Context, req *v2.SizeRes
 // SizeReservationServiceHandler is an implementation of the
 // metalstack.admin.v2.SizeReservationService service.
 type SizeReservationServiceHandler interface {
-	// Create a size reservation
+	// Creates a new size reservation.
 	Create(context.Context, *v2.SizeReservationServiceCreateRequest) (*v2.SizeReservationServiceCreateResponse, error)
-	// Update a size reservation
+	// Updates a size reservation.
 	Update(context.Context, *v2.SizeReservationServiceUpdateRequest) (*v2.SizeReservationServiceUpdateResponse, error)
-	// Delete a size reservation
+	// Deletes a size reservation.
 	Delete(context.Context, *v2.SizeReservationServiceDeleteRequest) (*v2.SizeReservationServiceDeleteResponse, error)
-	// List size reservations
+	// Returns the list of size reservations.
 	List(context.Context, *v2.SizeReservationServiceListRequest) (*v2.SizeReservationServiceListResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/switch.connect.go b/go/metalstack/admin/v2/adminv2connect/switch.connect.go
index d83fc052..a44c2320 100644
--- a/go/metalstack/admin/v2/adminv2connect/switch.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/switch.connect.go
@@ -52,19 +52,19 @@ const (
 
 // SwitchServiceClient is a client for the metalstack.admin.v2.SwitchService service.
 type SwitchServiceClient interface {
-	// Get a switch by ID.
+	// Returns the switch with the specified ID.
 	Get(context.Context, *v2.SwitchServiceGetRequest) (*v2.SwitchServiceGetResponse, error)
-	// List switches.
+	// Returns the list of switches.
 	List(context.Context, *v2.SwitchServiceListRequest) (*v2.SwitchServiceListResponse, error)
-	// Update a switch.
+	// Updates a switch.
 	Update(context.Context, *v2.SwitchServiceUpdateRequest) (*v2.SwitchServiceUpdateResponse, error)
-	// Delete a switch.
+	// Deletes a switch.
 	Delete(context.Context, *v2.SwitchServiceDeleteRequest) (*v2.SwitchServiceDeleteResponse, error)
-	// Migrate a switch.
+	// Migrates a switch.
 	Migrate(context.Context, *v2.SwitchServiceMigrateRequest) (*v2.SwitchServiceMigrateResponse, error)
-	// Port set the port status of a switch port.
+	// Sets the port status of a switch port.
 	Port(context.Context, *v2.SwitchServicePortRequest) (*v2.SwitchServicePortResponse, error)
-	// ConnectedMachines lists all switches with their machine connections.
+	// Returns all switches with their machine connections.
 	ConnectedMachines(context.Context, *v2.SwitchServiceConnectedMachinesRequest) (*v2.SwitchServiceConnectedMachinesResponse, error)
 }
 
@@ -200,19 +200,19 @@ func (c *switchServiceClient) ConnectedMachines(ctx context.Context, req *v2.Swi
 
 // SwitchServiceHandler is an implementation of the metalstack.admin.v2.SwitchService service.
 type SwitchServiceHandler interface {
-	// Get a switch by ID.
+	// Returns the switch with the specified ID.
 	Get(context.Context, *v2.SwitchServiceGetRequest) (*v2.SwitchServiceGetResponse, error)
-	// List switches.
+	// Returns the list of switches.
 	List(context.Context, *v2.SwitchServiceListRequest) (*v2.SwitchServiceListResponse, error)
-	// Update a switch.
+	// Updates a switch.
 	Update(context.Context, *v2.SwitchServiceUpdateRequest) (*v2.SwitchServiceUpdateResponse, error)
-	// Delete a switch.
+	// Deletes a switch.
 	Delete(context.Context, *v2.SwitchServiceDeleteRequest) (*v2.SwitchServiceDeleteResponse, error)
-	// Migrate a switch.
+	// Migrates a switch.
 	Migrate(context.Context, *v2.SwitchServiceMigrateRequest) (*v2.SwitchServiceMigrateResponse, error)
-	// Port set the port status of a switch port.
+	// Sets the port status of a switch port.
 	Port(context.Context, *v2.SwitchServicePortRequest) (*v2.SwitchServicePortResponse, error)
-	// ConnectedMachines lists all switches with their machine connections.
+	// Returns all switches with their machine connections.
 	ConnectedMachines(context.Context, *v2.SwitchServiceConnectedMachinesRequest) (*v2.SwitchServiceConnectedMachinesResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/task.connect.go b/go/metalstack/admin/v2/adminv2connect/task.connect.go
index a39406bc..70279fca 100644
--- a/go/metalstack/admin/v2/adminv2connect/task.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/task.connect.go
@@ -45,13 +45,13 @@ const (
 
 // TaskServiceClient is a client for the metalstack.admin.v2.TaskService service.
 type TaskServiceClient interface {
-	// Get a specific task
+	// Returns the task with the specified identifier.
 	Get(context.Context, *v2.TaskServiceGetRequest) (*v2.TaskServiceGetResponse, error)
-	// Delete a specific task
+	// Deletes the task with the specified identifier.
 	Delete(context.Context, *v2.TaskServiceDeleteRequest) (*v2.TaskServiceDeleteResponse, error)
-	// Queues returns all configures queues
+	// Returns the list of all configured queues.
 	Queues(context.Context, *v2.TaskServiceQueuesRequest) (*v2.TaskServiceQueuesResponse, error)
-	// List list all tasks
+	// Returns the list of all tasks.
 	List(context.Context, *v2.TaskServiceListRequest) (*v2.TaskServiceListResponse, error)
 }
 
@@ -139,13 +139,13 @@ func (c *taskServiceClient) List(ctx context.Context, req *v2.TaskServiceListReq
 
 // TaskServiceHandler is an implementation of the metalstack.admin.v2.TaskService service.
 type TaskServiceHandler interface {
-	// Get a specific task
+	// Returns the task with the specified identifier.
 	Get(context.Context, *v2.TaskServiceGetRequest) (*v2.TaskServiceGetResponse, error)
-	// Delete a specific task
+	// Deletes the task with the specified identifier.
 	Delete(context.Context, *v2.TaskServiceDeleteRequest) (*v2.TaskServiceDeleteResponse, error)
-	// Queues returns all configures queues
+	// Returns the list of all configured queues.
 	Queues(context.Context, *v2.TaskServiceQueuesRequest) (*v2.TaskServiceQueuesResponse, error)
-	// List list all tasks
+	// Returns the list of all tasks.
 	List(context.Context, *v2.TaskServiceListRequest) (*v2.TaskServiceListResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/tenant.connect.go b/go/metalstack/admin/v2/adminv2connect/tenant.connect.go
index 200c4e61..cfdbeb06 100644
--- a/go/metalstack/admin/v2/adminv2connect/tenant.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/tenant.connect.go
@@ -41,9 +41,9 @@ const (
 
 // TenantServiceClient is a client for the metalstack.admin.v2.TenantService service.
 type TenantServiceClient interface {
-	// Create a tenant
+	// Creates a new tenant.
 	Create(context.Context, *v2.TenantServiceCreateRequest) (*v2.TenantServiceCreateResponse, error)
-	// List all tenants
+	// Returns the list of all tenants.
 	List(context.Context, *v2.TenantServiceListRequest) (*v2.TenantServiceListResponse, error)
 }
 
@@ -99,9 +99,9 @@ func (c *tenantServiceClient) List(ctx context.Context, req *v2.TenantServiceLis
 
 // TenantServiceHandler is an implementation of the metalstack.admin.v2.TenantService service.
 type TenantServiceHandler interface {
-	// Create a tenant
+	// Creates a new tenant.
 	Create(context.Context, *v2.TenantServiceCreateRequest) (*v2.TenantServiceCreateResponse, error)
-	// List all tenants
+	// Returns the list of all tenants.
 	List(context.Context, *v2.TenantServiceListRequest) (*v2.TenantServiceListResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/adminv2connect/token.connect.go b/go/metalstack/admin/v2/adminv2connect/token.connect.go
index 1b5a7753..98cf0434 100644
--- a/go/metalstack/admin/v2/adminv2connect/token.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/token.connect.go
@@ -43,11 +43,11 @@ const (
 
 // TokenServiceClient is a client for the metalstack.admin.v2.TokenService service.
 type TokenServiceClient interface {
-	// List tokens
+	// Returns the list of tokens for a user.
 	List(context.Context, *v2.TokenServiceListRequest) (*v2.TokenServiceListResponse, error)
-	// Revoke a token
+	// Revokes a token.
 	Revoke(context.Context, *v2.TokenServiceRevokeRequest) (*v2.TokenServiceRevokeResponse, error)
-	// Create a token to authenticate against the platform, the secret will be only visible in the response.
+	// Creates a token to authenticate against the platform, the secret will be only visible in the response.
 	// This service is suitable to create tokens for other users instead of deriving users from tokens directly.
 	Create(context.Context, *v2.TokenServiceCreateRequest) (*v2.TokenServiceCreateResponse, error)
 }
@@ -120,11 +120,11 @@ func (c *tokenServiceClient) Create(ctx context.Context, req *v2.TokenServiceCre
 
 // TokenServiceHandler is an implementation of the metalstack.admin.v2.TokenService service.
 type TokenServiceHandler interface {
-	// List tokens
+	// Returns the list of tokens for a user.
 	List(context.Context, *v2.TokenServiceListRequest) (*v2.TokenServiceListResponse, error)
-	// Revoke a token
+	// Revokes a token.
 	Revoke(context.Context, *v2.TokenServiceRevokeRequest) (*v2.TokenServiceRevokeResponse, error)
-	// Create a token to authenticate against the platform, the secret will be only visible in the response.
+	// Creates a token to authenticate against the platform, the secret will be only visible in the response.
 	// This service is suitable to create tokens for other users instead of deriving users from tokens directly.
 	Create(context.Context, *v2.TokenServiceCreateRequest) (*v2.TokenServiceCreateResponse, error)
 }
diff --git a/go/metalstack/admin/v2/adminv2connect/vpn.connect.go b/go/metalstack/admin/v2/adminv2connect/vpn.connect.go
index cab3f682..eec85d0b 100644
--- a/go/metalstack/admin/v2/adminv2connect/vpn.connect.go
+++ b/go/metalstack/admin/v2/adminv2connect/vpn.connect.go
@@ -41,9 +41,9 @@ const (
 
 // VPNServiceClient is a client for the metalstack.admin.v2.VPNService service.
 type VPNServiceClient interface {
-	// AuthKey generates a authkey for a project to join a machine to the project vpn
+	// GenerateAuthKey generates an authentication key for a project to join a machine to the project VPN.
 	AuthKey(context.Context, *v2.VPNServiceAuthKeyRequest) (*v2.VPNServiceAuthKeyResponse, error)
-	// ListNodes returns a list of machines actually connected to the vpn
+	// Returns the list of machines connected to the VPN.
 	ListNodes(context.Context, *v2.VPNServiceListNodesRequest) (*v2.VPNServiceListNodesResponse, error)
 }
 
@@ -99,9 +99,9 @@ func (c *vPNServiceClient) ListNodes(ctx context.Context, req *v2.VPNServiceList
 
 // VPNServiceHandler is an implementation of the metalstack.admin.v2.VPNService service.
 type VPNServiceHandler interface {
-	// AuthKey generates a authkey for a project to join a machine to the project vpn
+	// GenerateAuthKey generates an authentication key for a project to join a machine to the project VPN.
 	AuthKey(context.Context, *v2.VPNServiceAuthKeyRequest) (*v2.VPNServiceAuthKeyResponse, error)
-	// ListNodes returns a list of machines actually connected to the vpn
+	// Returns the list of machines connected to the VPN.
 	ListNodes(context.Context, *v2.VPNServiceListNodesRequest) (*v2.VPNServiceListNodesResponse, error)
 }
 
diff --git a/go/metalstack/admin/v2/audit.pb.go b/go/metalstack/admin/v2/audit.pb.go
index 0d77fa62..063c82f7 100644
--- a/go/metalstack/admin/v2/audit.pb.go
+++ b/go/metalstack/admin/v2/audit.pb.go
@@ -23,7 +23,7 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// AuditServiceListRequest is the request payload to list audits
+// AuditServiceListRequest is the request payload for listing audit traces.
 type AuditServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Query for audit traces
@@ -69,10 +69,10 @@ func (x *AuditServiceListRequest) GetQuery() *v2.AuditQuery {
 	return nil
 }
 
-// AuditServiceListResponse is the response payload of a audit list request
+// AuditServiceListResponse is the response payload for listing audit traces.
 type AuditServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Traces is a list of audit traces
+	// Traces contains the list of audit traces
 	Traces        []*v2.AuditTrace `protobuf:"bytes,1,rep,name=traces,proto3" json:"traces,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -115,7 +115,7 @@ func (x *AuditServiceListResponse) GetTraces() []*v2.AuditTrace {
 	return nil
 }
 
-// AuditServiceGetRequest is the request payload of a audit get request
+// AuditServiceGetRequest is the request payload for getting an audit trace.
 type AuditServiceGetRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Uuid of the audit trace
@@ -170,7 +170,7 @@ func (x *AuditServiceGetRequest) GetPhase() v2.AuditPhase {
 	return v2.AuditPhase(0)
 }
 
-// AuditServiceGetResponse is the response payload of a audit get request
+// AuditServiceGetResponse is the response payload for getting an audit trace.
 type AuditServiceGetResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Trace is the audit trace
diff --git a/go/metalstack/admin/v2/component.pb.go b/go/metalstack/admin/v2/component.pb.go
index 313bfe1a..106339dd 100644
--- a/go/metalstack/admin/v2/component.pb.go
+++ b/go/metalstack/admin/v2/component.pb.go
@@ -23,10 +23,10 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// ComponentServiceListRequest
+// ComponentServiceListRequest is the request payload for listing components.
 type ComponentServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Query components.
+	// Query filters components
 	Query         *v2.ComponentQuery `protobuf:"bytes,1,opt,name=query,proto3" json:"query,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -69,10 +69,10 @@ func (x *ComponentServiceListRequest) GetQuery() *v2.ComponentQuery {
 	return nil
 }
 
-// ComponentServiceListResponse
+// ComponentServiceListResponse is the response payload for listing components.
 type ComponentServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Components
+	// Components contains the list of components
 	Components    []*v2.Component `protobuf:"bytes,1,rep,name=components,proto3" json:"components,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -115,7 +115,7 @@ func (x *ComponentServiceListResponse) GetComponents() []*v2.Component {
 	return nil
 }
 
-// ComponentServiceGetRequest
+// ComponentServiceGetRequest is the request payload for getting a component.
 type ComponentServiceGetRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// UUID identifies the component to get
@@ -161,10 +161,10 @@ func (x *ComponentServiceGetRequest) GetUuid() string {
 	return ""
 }
 
-// ComponentServiceGetResponse
+// ComponentServiceGetResponse is the response payload for getting a component.
 type ComponentServiceGetResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Component
+	// Component contains the retrieved component
 	Component     *v2.Component `protobuf:"bytes,1,opt,name=component,proto3" json:"component,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -207,7 +207,7 @@ func (x *ComponentServiceGetResponse) GetComponent() *v2.Component {
 	return nil
 }
 
-// ComponentServiceGetRequest
+// ComponentServiceDeleteRequest is the request payload for deleting a component.
 type ComponentServiceDeleteRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// UUID identifies the component to delete
@@ -253,10 +253,10 @@ func (x *ComponentServiceDeleteRequest) GetUuid() string {
 	return ""
 }
 
-// ComponentServiceGetResponse
+// ComponentServiceDeleteResponse is the response payload for deleting a component.
 type ComponentServiceDeleteResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Component
+	// Component contains the deleted component
 	Component     *v2.Component `protobuf:"bytes,1,opt,name=component,proto3" json:"component,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/filesystem.pb.go b/go/metalstack/admin/v2/filesystem.pb.go
index 3b85539a..85eada55 100644
--- a/go/metalstack/admin/v2/filesystem.pb.go
+++ b/go/metalstack/admin/v2/filesystem.pb.go
@@ -23,10 +23,10 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// FilesystemServiceCreateRequest
+// FilesystemServiceCreateRequest is the request payload for creating a filesystem.
 type FilesystemServiceCreateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// FilesystemLayout the filesystemlayout
+	// FilesystemLayout is the filesystem layout to create
 	FilesystemLayout *v2.FilesystemLayout `protobuf:"bytes,1,opt,name=filesystem_layout,json=filesystemLayout,proto3" json:"filesystem_layout,omitempty"`
 	unknownFields    protoimpl.UnknownFields
 	sizeCache        protoimpl.SizeCache
@@ -69,10 +69,10 @@ func (x *FilesystemServiceCreateRequest) GetFilesystemLayout() *v2.FilesystemLay
 	return nil
 }
 
-// FilesystemServiceCreateResponse
+// FilesystemServiceCreateResponse is the response payload for creating a filesystem.
 type FilesystemServiceCreateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// FilesystemLayout the filesystemlayout
+	// FilesystemLayout contains the created filesystem layout
 	FilesystemLayout *v2.FilesystemLayout `protobuf:"bytes,1,opt,name=filesystem_layout,json=filesystemLayout,proto3" json:"filesystem_layout,omitempty"`
 	unknownFields    protoimpl.UnknownFields
 	sizeCache        protoimpl.SizeCache
@@ -115,7 +115,7 @@ func (x *FilesystemServiceCreateResponse) GetFilesystemLayout() *v2.FilesystemLa
 	return nil
 }
 
-// FilesystemServiceUpdateRequest
+// FilesystemServiceUpdateRequest is the request payload for updating a filesystem.
 type FilesystemServiceUpdateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Id of this filesystemLayout
@@ -130,7 +130,7 @@ type FilesystemServiceUpdateRequest struct {
 	Filesystems []*v2.Filesystem `protobuf:"bytes,5,rep,name=filesystems,proto3" json:"filesystems,omitempty"`
 	// Disks list of disks that belong to this layout
 	Disks []*v2.Disk `protobuf:"bytes,6,rep,name=disks,proto3" json:"disks,omitempty"`
-	// raid arrays to create
+	// Raid arrays to create
 	Raid []*v2.Raid `protobuf:"bytes,7,rep,name=raid,proto3" json:"raid,omitempty"`
 	// VolumeGroups list of volumegroups to create
 	VolumeGroups []*v2.VolumeGroup `protobuf:"bytes,8,rep,name=volume_groups,json=volumeGroups,proto3" json:"volume_groups,omitempty"`
@@ -242,10 +242,10 @@ func (x *FilesystemServiceUpdateRequest) GetConstraints() *v2.FilesystemLayoutCo
 	return nil
 }
 
-// FilesystemServiceUpdateResponse
+// FilesystemServiceUpdateResponse is the response payload for updating a filesystem.
 type FilesystemServiceUpdateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// FilesystemLayout the filesystemlayout
+	// FilesystemLayout contains the updated filesystem layout
 	FilesystemLayout *v2.FilesystemLayout `protobuf:"bytes,1,opt,name=filesystem_layout,json=filesystemLayout,proto3" json:"filesystem_layout,omitempty"`
 	unknownFields    protoimpl.UnknownFields
 	sizeCache        protoimpl.SizeCache
@@ -288,7 +288,7 @@ func (x *FilesystemServiceUpdateResponse) GetFilesystemLayout() *v2.FilesystemLa
 	return nil
 }
 
-// FilesystemServiceDeleteRequest
+// FilesystemServiceDeleteRequest is the request payload for deleting a filesystem.
 type FilesystemServiceDeleteRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// ID of the filesystem to delete
@@ -334,10 +334,10 @@ func (x *FilesystemServiceDeleteRequest) GetId() string {
 	return ""
 }
 
-// message FilesystemServiceDeleteResponse {
+// FilesystemServiceDeleteResponse is the response payload for deleting a filesystem.
 type FilesystemServiceDeleteResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// FilesystemLayout the filesystemlayout
+	// FilesystemLayout contains the deleted filesystem layout
 	FilesystemLayout *v2.FilesystemLayout `protobuf:"bytes,1,opt,name=filesystem_layout,json=filesystemLayout,proto3" json:"filesystem_layout,omitempty"`
 	unknownFields    protoimpl.UnknownFields
 	sizeCache        protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/image.pb.go b/go/metalstack/admin/v2/image.pb.go
index 2e2c8a4f..e1c987d5 100644
--- a/go/metalstack/admin/v2/image.pb.go
+++ b/go/metalstack/admin/v2/image.pb.go
@@ -24,10 +24,10 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// ImageServiceCreateRequest
+// ImageServiceCreateRequest is the request payload for creating an image.
 type ImageServiceCreateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Image is the image
+	// Image is the image to create
 	Image         *v2.Image `protobuf:"bytes,1,opt,name=image,proto3" json:"image,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -70,10 +70,10 @@ func (x *ImageServiceCreateRequest) GetImage() *v2.Image {
 	return nil
 }
 
-// ImageServiceCreateResponse
+// ImageServiceCreateResponse is the response payload for creating an image.
 type ImageServiceCreateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Image is the image
+	// Image contains the created image
 	Image         *v2.Image `protobuf:"bytes,1,opt,name=image,proto3" json:"image,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -116,7 +116,7 @@ func (x *ImageServiceCreateResponse) GetImage() *v2.Image {
 	return nil
 }
 
-// ImageServiceUpdateRequest
+// ImageServiceUpdateRequest is the request payload for updating an image.
 type ImageServiceUpdateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Id of this image
@@ -125,9 +125,9 @@ type ImageServiceUpdateRequest struct {
 	UpdateMeta *v2.UpdateMeta `protobuf:"bytes,2,opt,name=update_meta,json=updateMeta,proto3" json:"update_meta,omitempty"`
 	// URL where this image is located
 	Url *string `protobuf:"bytes,3,opt,name=url,proto3,oneof" json:"url,omitempty"`
-	// Name of this imageLayout
+	// Name of this image
 	Name *string `protobuf:"bytes,4,opt,name=name,proto3,oneof" json:"name,omitempty"`
-	// Description of this imageLayout
+	// Description of this image
 	Description *string `protobuf:"bytes,5,opt,name=description,proto3,oneof" json:"description,omitempty"`
 	// Features of this image
 	Features []v2.ImageFeature `protobuf:"varint,6,rep,packed,name=features,proto3,enum=metalstack.api.v2.ImageFeature" json:"features,omitempty"`
@@ -225,10 +225,10 @@ func (x *ImageServiceUpdateRequest) GetExpiresAt() *timestamppb.Timestamp {
 	return nil
 }
 
-// ImageServiceUpdateResponse
+// ImageServiceUpdateResponse is the response payload for updating an image.
 type ImageServiceUpdateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Image is the image
+	// Image contains the updated image
 	Image         *v2.Image `protobuf:"bytes,1,opt,name=image,proto3" json:"image,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -271,7 +271,7 @@ func (x *ImageServiceUpdateResponse) GetImage() *v2.Image {
 	return nil
 }
 
-// ImageServiceDeleteRequest
+// ImageServiceDeleteRequest is the request payload for deleting an image.
 type ImageServiceDeleteRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// ID of the image to delete
@@ -317,10 +317,10 @@ func (x *ImageServiceDeleteRequest) GetId() string {
 	return ""
 }
 
-// message ImageServiceDeleteResponse {
+// ImageServiceDeleteResponse is the response payload for deleting an image.
 type ImageServiceDeleteResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// ImageLayout the imagelayout
+	// Image contains the deleted image
 	Image         *v2.Image `protobuf:"bytes,1,opt,name=image,proto3" json:"image,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -363,7 +363,7 @@ func (x *ImageServiceDeleteResponse) GetImage() *v2.Image {
 	return nil
 }
 
-// ImageServiceUsageRequest
+// ImageServiceUsageRequest is the request payload for getting image usage.
 type ImageServiceUsageRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Query for which images the usage should be reported
@@ -409,10 +409,10 @@ func (x *ImageServiceUsageRequest) GetQuery() *v2.ImageQuery {
 	return nil
 }
 
-// ImageServiceUsageResponse
+// ImageServiceUsageResponse is the response payload for getting image usage.
 type ImageServiceUsageResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Images with usage
+	// Images contains usage information
 	ImageUsage    []*v2.ImageUsage `protobuf:"bytes,1,rep,name=image_usage,json=imageUsage,proto3" json:"image_usage,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/ip.pb.go b/go/metalstack/admin/v2/ip.pb.go
index ab24e077..9deda2f5 100644
--- a/go/metalstack/admin/v2/ip.pb.go
+++ b/go/metalstack/admin/v2/ip.pb.go
@@ -22,10 +22,10 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// IPServiceListRequest
+// IPServiceListRequest is the request payload for listing IP addresses.
 type IPServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Query to search for one or more ips
+	// Query to search for IP addresses
 	Query         *v2.IPQuery `protobuf:"bytes,1,opt,name=query,proto3" json:"query,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -68,10 +68,10 @@ func (x *IPServiceListRequest) GetQuery() *v2.IPQuery {
 	return nil
 }
 
-// IPServiceListResponse
+// IPServiceListResponse is the response payload for listing IP addresses.
 type IPServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// IPs are the list of ips
+	// IPs contains the list of IP addresses
 	Ips           []*v2.IP `protobuf:"bytes,1,rep,name=ips,proto3" json:"ips,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/machine.pb.go b/go/metalstack/admin/v2/machine.pb.go
index 5c009995..2dc25e97 100644
--- a/go/metalstack/admin/v2/machine.pb.go
+++ b/go/metalstack/admin/v2/machine.pb.go
@@ -502,12 +502,12 @@ func (x *MachineServiceListBMCResponse) GetBmcReports() map[string]*v2.MachineBM
 	return nil
 }
 
-// MachineServiceConsolePasswordRequest is the request to get the console password
+// MachineServiceConsolePasswordRequest is the request payload for getting the console password.
 type MachineServiceConsolePasswordRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// UUID of the machine to get
 	Uuid string `protobuf:"bytes,1,opt,name=uuid,proto3" json:"uuid,omitempty"`
-	// Reason must be provided why access to the console is requested.
+	// Reason must be provided why access to the console is requested
 	// Reason is only forwarded to an audit sink
 	Reason        string `protobuf:"bytes,2,opt,name=reason,proto3" json:"reason,omitempty"`
 	unknownFields protoimpl.UnknownFields
@@ -558,7 +558,7 @@ func (x *MachineServiceConsolePasswordRequest) GetReason() string {
 	return ""
 }
 
-// MachineServiceConsolePasswordResponse is the response to the console password request
+// MachineServiceConsolePasswordResponse is the response payload for getting the console password.
 type MachineServiceConsolePasswordResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// UUID of the machine to get
diff --git a/go/metalstack/admin/v2/network.pb.go b/go/metalstack/admin/v2/network.pb.go
index f0143a98..45ca1cfa 100644
--- a/go/metalstack/admin/v2/network.pb.go
+++ b/go/metalstack/admin/v2/network.pb.go
@@ -23,7 +23,7 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// NetworkServiceGetRequest
+// NetworkServiceGetRequest is the request payload for getting a network.
 type NetworkServiceGetRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// ID of the network to get
@@ -69,10 +69,10 @@ func (x *NetworkServiceGetRequest) GetId() string {
 	return ""
 }
 
-// NetworkServiceGetResponse
+// NetworkServiceGetResponse is the response payload for getting a network.
 type NetworkServiceGetResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Network which was requested to get
+	// Network contains the requested network
 	Network       *v2.Network `protobuf:"bytes,1,opt,name=network,proto3" json:"network,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -115,7 +115,7 @@ func (x *NetworkServiceGetResponse) GetNetwork() *v2.Network {
 	return nil
 }
 
-// NetworkServiceCreateRequest
+// NetworkServiceCreateRequest is the request payload for creating a network.
 type NetworkServiceCreateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Id of this network
@@ -142,7 +142,7 @@ type NetworkServiceCreateRequest struct {
 	MinChildPrefixLength *v2.ChildPrefixLength `protobuf:"bytes,11,opt,name=min_child_prefix_length,json=minChildPrefixLength,proto3" json:"min_child_prefix_length,omitempty"`
 	// NATType of this network
 	NatType *v2.NATType `protobuf:"varint,12,opt,name=nat_type,json=natType,proto3,enum=metalstack.api.v2.NATType,oneof" json:"nat_type,omitempty"`
-	// VRF of this network has this VNI.
+	// VRF of this network has this VNI
 	Vrf *uint32 `protobuf:"varint,13,opt,name=vrf,proto3,oneof" json:"vrf,omitempty"`
 	// Parent Network points to the id of the parent network if any
 	ParentNetwork *string `protobuf:"bytes,14,opt,name=parent_network,json=parentNetwork,proto3,oneof" json:"parent_network,omitempty"`
@@ -305,7 +305,7 @@ func (x *NetworkServiceCreateRequest) GetAddressFamily() v2.NetworkAddressFamily
 	return v2.NetworkAddressFamily(0)
 }
 
-// NetworkServiceUpdateRequest is the request payload for a network update request
+// NetworkServiceUpdateRequest is the request payload for updating a network.
 type NetworkServiceUpdateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Id of this network
@@ -322,7 +322,7 @@ type NetworkServiceUpdateRequest struct {
 	Prefixes []string `protobuf:"bytes,6,rep,name=prefixes,proto3" json:"prefixes,omitempty"`
 	// Destination Prefixes in this network
 	DestinationPrefixes []string `protobuf:"bytes,7,rep,name=destination_prefixes,json=destinationPrefixes,proto3" json:"destination_prefixes,omitempty"`
-	// Default Child Prefix length defines the bit length of a child network created per addressfamily, of not specified during the allocate request
+	// Default Child Prefix length defines the bit length of a child network created per addressfamily, if not specified during the allocate request
 	DefaultChildPrefixLength *v2.ChildPrefixLength `protobuf:"bytes,8,opt,name=default_child_prefix_length,json=defaultChildPrefixLength,proto3,oneof" json:"default_child_prefix_length,omitempty"`
 	// Min Child Prefix length asserts that during child network creation the requested bit length is greater or equal the min child prefix length
 	MinChildPrefixLength *v2.ChildPrefixLength `protobuf:"bytes,9,opt,name=min_child_prefix_length,json=minChildPrefixLength,proto3,oneof" json:"min_child_prefix_length,omitempty"`
@@ -330,7 +330,7 @@ type NetworkServiceUpdateRequest struct {
 	NatType *v2.NATType `protobuf:"varint,10,opt,name=nat_type,json=natType,proto3,enum=metalstack.api.v2.NATType,oneof" json:"nat_type,omitempty"`
 	// AdditionalAnnouncableCidrs will be added to the allow list on the switch which prefixes might be announced
 	AdditionalAnnouncableCidrs []string `protobuf:"bytes,11,rep,name=additional_announcable_cidrs,json=additionalAnnouncableCidrs,proto3" json:"additional_announcable_cidrs,omitempty"`
-	// Force update, actually only prevents accidental removal of additional_announcable_cidrs which will destroy your dataplane in fact.
+	// Force update, prevents accidental removal of additional_announcable_cidrs which will destroy your dataplane.
 	Force         bool `protobuf:"varint,12,opt,name=force,proto3" json:"force,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -450,7 +450,7 @@ func (x *NetworkServiceUpdateRequest) GetForce() bool {
 	return false
 }
 
-// NetworkServiceDeleteRequest is the request payload for a network delete request
+// NetworkServiceDeleteRequest is the request payload for deleting a network.
 type NetworkServiceDeleteRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// ID of the network to get
@@ -496,10 +496,10 @@ func (x *NetworkServiceDeleteRequest) GetId() string {
 	return ""
 }
 
-// NetworkServiceListRequest
+// NetworkServiceListRequest is the request payload for listing networks.
 type NetworkServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Query which specifies which networks to return
+	// Query specifies which networks to return
 	Query         *v2.NetworkQuery `protobuf:"bytes,2,opt,name=query,proto3" json:"query,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -542,10 +542,10 @@ func (x *NetworkServiceListRequest) GetQuery() *v2.NetworkQuery {
 	return nil
 }
 
-// NetworkServiceCreateResponse is the response payload for a network create request
+// NetworkServiceCreateResponse is the response payload for creating a network.
 type NetworkServiceCreateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Network the network
+	// Network contains the created network
 	Network       *v2.Network `protobuf:"bytes,1,opt,name=network,proto3" json:"network,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -588,10 +588,10 @@ func (x *NetworkServiceCreateResponse) GetNetwork() *v2.Network {
 	return nil
 }
 
-// NetworkServiceUpdateResponse is the response payload for a network update request
+// NetworkServiceUpdateResponse is the response payload for updating a network.
 type NetworkServiceUpdateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Network the network
+	// Network contains the updated network
 	Network       *v2.Network `protobuf:"bytes,1,opt,name=network,proto3" json:"network,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -634,10 +634,10 @@ func (x *NetworkServiceUpdateResponse) GetNetwork() *v2.Network {
 	return nil
 }
 
-// NetworkServiceCapacityResponse is the response payload for a network delete request
+// NetworkServiceDeleteResponse is the response payload for deleting a network.
 type NetworkServiceDeleteResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Network the network
+	// Network contains the deleted network
 	Network       *v2.Network `protobuf:"bytes,1,opt,name=network,proto3" json:"network,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -680,10 +680,10 @@ func (x *NetworkServiceDeleteResponse) GetNetwork() *v2.Network {
 	return nil
 }
 
-// NetworkServiceListResponse
+// NetworkServiceListResponse is the response payload for listing networks.
 type NetworkServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Networks are the requested networks
+	// Networks contains the list of networks
 	Networks      []*v2.Network `protobuf:"bytes,1,rep,name=networks,proto3" json:"networks,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/partition.pb.go b/go/metalstack/admin/v2/partition.pb.go
index 8e93e45e..0fdb1b37 100644
--- a/go/metalstack/admin/v2/partition.pb.go
+++ b/go/metalstack/admin/v2/partition.pb.go
@@ -69,7 +69,7 @@ func (x *PartitionServiceCreateRequest) GetPartition() *v2.Partition {
 	return nil
 }
 
-// PartitionServiceUpdateRequest is the request payload for a partition update request
+// PartitionServiceUpdateRequest is the request payload for updating a partition.
 type PartitionServiceUpdateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// ID of this partition
@@ -85,8 +85,7 @@ type PartitionServiceUpdateRequest struct {
 	// NTPServers for this partition
 	NtpServers []*v2.NTPServer `protobuf:"bytes,6,rep,name=ntp_servers,json=ntpServers,proto3" json:"ntp_servers,omitempty"`
 	// ManagementServiceAddresses defines where the management is reachable
-	// should be in the form <ip|host>:<port>
-	// FIXME validation
+	// must be in the form <ip|host>:<port>
 	MgmtServiceAddresses []string `protobuf:"bytes,7,rep,name=mgmt_service_addresses,json=mgmtServiceAddresses,proto3" json:"mgmt_service_addresses,omitempty"`
 	// Labels to update on this network
 	Labels        *v2.UpdateLabels `protobuf:"bytes,8,opt,name=labels,proto3,oneof" json:"labels,omitempty"`
@@ -318,10 +317,10 @@ func (x *PartitionServiceUpdateResponse) GetPartition() *v2.Partition {
 	return nil
 }
 
-// PartitionServiceCapacityResponse is the response payload for a partition delete request
+// PartitionServiceDeleteResponse is the response payload for deleting a partition.
 type PartitionServiceDeleteResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Partition the partition
+	// Partition contains the deleted partition
 	Partition     *v2.Partition `protobuf:"bytes,1,opt,name=partition,proto3" json:"partition,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -364,7 +363,7 @@ func (x *PartitionServiceDeleteResponse) GetPartition() *v2.Partition {
 	return nil
 }
 
-// PartitionServiceListRequest is the request payload for a partition capacity request
+// PartitionServiceCapacityRequest is the request payload for getting partition capacity.
 type PartitionServiceCapacityRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// ID of the partition to get
@@ -710,7 +709,7 @@ const file_metalstack_admin_v2_partition_proto_rawDesc = "" +
 	"\n" +
 	"#metalstack/admin/v2/partition.proto\x12\x13metalstack.admin.v2\x1a\x1bbuf/validate/validate.proto\x1a\x1emetalstack/api/v2/common.proto\x1a!metalstack/api/v2/partition.proto\x1a(metalstack/api/v2/predefined_rules.proto\"[\n" +
 	"\x1dPartitionServiceCreateRequest\x12:\n" +
-	"\tpartition\x18\x01 \x01(\v2\x1c.metalstack.api.v2.PartitionR\tpartition\"\xb7\x04\n" +
+	"\tpartition\x18\x01 \x01(\v2\x1c.metalstack.api.v2.PartitionR\tpartition\"\xc5\x04\n" +
 	"\x1dPartitionServiceUpdateRequest\x12\x1b\n" +
 	"\x02id\x18\x01 \x01(\tB\v\xbaH\br\x06г\xae\xb1\x02\x01R\x02id\x12F\n" +
 	"\vupdate_meta\x18\x02 \x01(\v2\x1d.metalstack.api.v2.UpdateMetaB\x06\xbaH\x03\xc8\x01\x01R\n" +
@@ -721,8 +720,8 @@ const file_metalstack_admin_v2_partition_proto_rawDesc = "" +
 	"dnsServers\x12G\n" +
 	"\vntp_servers\x18\x06 \x03(\v2\x1c.metalstack.api.v2.NTPServerB\b\xbaH\x05\x92\x01\x02\x10\n" +
 	"R\n" +
-	"ntpServers\x124\n" +
-	"\x16mgmt_service_addresses\x18\a \x03(\tR\x14mgmtServiceAddresses\x12<\n" +
+	"ntpServers\x12B\n" +
+	"\x16mgmt_service_addresses\x18\a \x03(\tB\f\xbaH\t\x92\x01\x06Ȥ\xb3\xb1\x02\x01R\x14mgmtServiceAddresses\x12<\n" +
 	"\x06labels\x18\b \x01(\v2\x1f.metalstack.api.v2.UpdateLabelsH\x01R\x06labels\x88\x01\x01B\x0e\n" +
 	"\f_descriptionB\t\n" +
 	"\a_labels\"<\n" +
diff --git a/go/metalstack/admin/v2/project.pb.go b/go/metalstack/admin/v2/project.pb.go
index 27f410cc..930379ff 100644
--- a/go/metalstack/admin/v2/project.pb.go
+++ b/go/metalstack/admin/v2/project.pb.go
@@ -23,12 +23,12 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// ProjectServiceListRequest is the request payload for the project list request
+// ProjectServiceListRequest is the request payload for listing projects.
 type ProjectServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Tenant lists only projects of this tenant
+	// Tenant filters projects by this tenant
 	Tenant *string `protobuf:"bytes,1,opt,name=tenant,proto3,oneof" json:"tenant,omitempty"`
-	// Labels lists only projects containing the given labels
+	// Labels filters projects containing the given labels
 	Labels        *v2.Labels `protobuf:"bytes,2,opt,name=labels,proto3,oneof" json:"labels,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -78,10 +78,10 @@ func (x *ProjectServiceListRequest) GetLabels() *v2.Labels {
 	return nil
 }
 
-// ProjectServiceListResponse is the response payload for the project list request
+// ProjectServiceListResponse is the response payload for listing projects.
 type ProjectServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Projects is a list of all projects
+	// Projects contains the list of projects
 	Projects      []*v2.Project `protobuf:"bytes,1,rep,name=projects,proto3" json:"projects,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/size.pb.go b/go/metalstack/admin/v2/size.pb.go
index 28b4f208..b0e85a18 100644
--- a/go/metalstack/admin/v2/size.pb.go
+++ b/go/metalstack/admin/v2/size.pb.go
@@ -23,7 +23,7 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// SizeServiceCreateRequest is the request payload for a size create request
+// SizeServiceCreateRequest is the request payload for creating a size.
 type SizeServiceCreateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Size is the size to create
@@ -69,10 +69,10 @@ func (x *SizeServiceCreateRequest) GetSize() *v2.Size {
 	return nil
 }
 
-// SizeServiceGetResponse is the response payload for a size create request
+// SizeServiceCreateResponse is the response payload for creating a size.
 type SizeServiceCreateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Size the size
+	// Size contains the created size
 	Size          *v2.Size `protobuf:"bytes,1,opt,name=size,proto3" json:"size,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -115,7 +115,7 @@ func (x *SizeServiceCreateResponse) GetSize() *v2.Size {
 	return nil
 }
 
-// SizeServiceUpdateRequest is the request payload for a size update request
+// SizeServiceUpdateRequest is the request payload for updating a size.
 type SizeServiceUpdateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Id of this size
@@ -206,10 +206,10 @@ func (x *SizeServiceUpdateRequest) GetLabels() *v2.UpdateLabels {
 	return nil
 }
 
-// SizeServiceUpdateResponse is the response payload for a size update request
+// SizeServiceUpdateResponse is the response payload for updating a size.
 type SizeServiceUpdateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Size the size
+	// Size contains the updated size
 	Size          *v2.Size `protobuf:"bytes,1,opt,name=size,proto3" json:"size,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -252,7 +252,7 @@ func (x *SizeServiceUpdateResponse) GetSize() *v2.Size {
 	return nil
 }
 
-// SizeServiceDeleteRequest is the request payload for a size delete request
+// SizeServiceDeleteRequest is the request payload for deleting a size.
 type SizeServiceDeleteRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// ID of the size to delete
@@ -298,10 +298,10 @@ func (x *SizeServiceDeleteRequest) GetId() string {
 	return ""
 }
 
-// SizeServiceDeleteResponse is the response payload for a size delete request
+// SizeServiceDeleteResponse is the response payload for deleting a size.
 type SizeServiceDeleteResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Size the size
+	// Size contains the deleted size
 	Size          *v2.Size `protobuf:"bytes,1,opt,name=size,proto3" json:"size,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/size_imageconstraint.pb.go b/go/metalstack/admin/v2/size_imageconstraint.pb.go
index f1cc8be8..b6bf1359 100644
--- a/go/metalstack/admin/v2/size_imageconstraint.pb.go
+++ b/go/metalstack/admin/v2/size_imageconstraint.pb.go
@@ -23,7 +23,7 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// SizeImageConstraintServiceCreateRequest is the request payload for a size image constraint create request
+// SizeImageConstraintServiceCreateRequest is the request payload for creating a size image constraint.
 type SizeImageConstraintServiceCreateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Size of the constraint
@@ -105,10 +105,10 @@ func (x *SizeImageConstraintServiceCreateRequest) GetDescription() string {
 	return ""
 }
 
-// SizeImageConstraintServiceCreateResponse is the response payload for a size image constraint create request
+// SizeImageConstraintServiceCreateResponse is the response payload for creating a size image constraint.
 type SizeImageConstraintServiceCreateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// SizeImageConstraint created
+	// SizeImageConstraint contains the created constraint
 	SizeImageConstraint *v2.SizeImageConstraint `protobuf:"bytes,1,opt,name=size_image_constraint,json=sizeImageConstraint,proto3" json:"size_image_constraint,omitempty"`
 	unknownFields       protoimpl.UnknownFields
 	sizeCache           protoimpl.SizeCache
@@ -151,7 +151,7 @@ func (x *SizeImageConstraintServiceCreateResponse) GetSizeImageConstraint() *v2.
 	return nil
 }
 
-// SizeImageConstraintServiceUpdateRequest is the request payload for a size image constraint update request
+// SizeImageConstraintServiceUpdateRequest is the request payload for updating a size image constraint.
 type SizeImageConstraintServiceUpdateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Size of the image constraint to update
@@ -233,10 +233,10 @@ func (x *SizeImageConstraintServiceUpdateRequest) GetDescription() string {
 	return ""
 }
 
-// SizeImageConstraintServiceUpdateResponse is the response payload for a size image constraint update request
+// SizeImageConstraintServiceUpdateResponse is the response payload for updating a size image constraint.
 type SizeImageConstraintServiceUpdateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// SizeImageConstraint updated
+	// SizeImageConstraint contains the updated constraint
 	SizeImageConstraint *v2.SizeImageConstraint `protobuf:"bytes,1,opt,name=size_image_constraint,json=sizeImageConstraint,proto3" json:"size_image_constraint,omitempty"`
 	unknownFields       protoimpl.UnknownFields
 	sizeCache           protoimpl.SizeCache
@@ -279,7 +279,7 @@ func (x *SizeImageConstraintServiceUpdateResponse) GetSizeImageConstraint() *v2.
 	return nil
 }
 
-// SizeImageConstraintServiceDeleteRequest is the request payload for a size image constraint delete request
+// SizeImageConstraintServiceDeleteRequest is the request payload for deleting a size image constraint.
 type SizeImageConstraintServiceDeleteRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Size of the constraint
@@ -325,10 +325,10 @@ func (x *SizeImageConstraintServiceDeleteRequest) GetSize() string {
 	return ""
 }
 
-// SizeImageConstraintServiceDeleteResponse is the response payload for a size image constraint delete request
+// SizeImageConstraintServiceDeleteResponse is the response payload for deleting a size image constraint.
 type SizeImageConstraintServiceDeleteResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// SizeImageConstraint deleted
+	// SizeImageConstraint contains the deleted constraint
 	SizeImageConstraint *v2.SizeImageConstraint `protobuf:"bytes,1,opt,name=size_image_constraint,json=sizeImageConstraint,proto3" json:"size_image_constraint,omitempty"`
 	unknownFields       protoimpl.UnknownFields
 	sizeCache           protoimpl.SizeCache
@@ -371,7 +371,7 @@ func (x *SizeImageConstraintServiceDeleteResponse) GetSizeImageConstraint() *v2.
 	return nil
 }
 
-// SizeImageConstraintServiceGetRequest is the request payload for a size image constraint get request
+// SizeImageConstraintServiceGetRequest is the request payload for getting a size image constraint.
 type SizeImageConstraintServiceGetRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Size of the constraint
@@ -417,10 +417,10 @@ func (x *SizeImageConstraintServiceGetRequest) GetSize() string {
 	return ""
 }
 
-// SizeImageConstraintServiceGetResponse is the response payload for a size image constraint get request
+// SizeImageConstraintServiceGetResponse is the response payload for getting a size image constraint.
 type SizeImageConstraintServiceGetResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// SizeImageConstraint get
+	// SizeImageConstraint contains the retrieved constraint
 	SizeImageConstraint *v2.SizeImageConstraint `protobuf:"bytes,1,opt,name=size_image_constraint,json=sizeImageConstraint,proto3" json:"size_image_constraint,omitempty"`
 	unknownFields       protoimpl.UnknownFields
 	sizeCache           protoimpl.SizeCache
@@ -463,7 +463,7 @@ func (x *SizeImageConstraintServiceGetResponse) GetSizeImageConstraint() *v2.Siz
 	return nil
 }
 
-// SizeImageConstraintServiceListRequest is the request payload for a size image constraint list request
+// SizeImageConstraintServiceListRequest is the request payload for listing size image constraints.
 type SizeImageConstraintServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Query for size image constraints
@@ -509,10 +509,10 @@ func (x *SizeImageConstraintServiceListRequest) GetQuery() *v2.SizeImageConstrai
 	return nil
 }
 
-// SizeImageConstraintServiceListResponse is the response payload for a size image constraint list request
+// SizeImageConstraintServiceListResponse is the response payload for listing size image constraints.
 type SizeImageConstraintServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// SizeImageConstraints listed
+	// SizeImageConstraints contains the list of constraints
 	SizeImageConstraints []*v2.SizeImageConstraint `protobuf:"bytes,1,rep,name=size_image_constraints,json=sizeImageConstraints,proto3" json:"size_image_constraints,omitempty"`
 	unknownFields        protoimpl.UnknownFields
 	sizeCache            protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/size_reservation.pb.go b/go/metalstack/admin/v2/size_reservation.pb.go
index d7444eca..55fbefaf 100644
--- a/go/metalstack/admin/v2/size_reservation.pb.go
+++ b/go/metalstack/admin/v2/size_reservation.pb.go
@@ -23,7 +23,7 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// SizeReservationServiceCreateRequest is the request payload for a size reservation create request
+// SizeReservationServiceCreateRequest is the request payload for creating a size reservation.
 type SizeReservationServiceCreateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// SizeReservation is the size reservation to create
@@ -69,10 +69,10 @@ func (x *SizeReservationServiceCreateRequest) GetSizeReservation() *v2.SizeReser
 	return nil
 }
 
-// SizeReservationServiceCreateResponse is the response payload for a size reservation create request
+// SizeReservationServiceCreateResponse is the response payload for creating a size reservation.
 type SizeReservationServiceCreateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// SizeReservation the size reservation
+	// SizeReservation contains the created reservation
 	SizeReservation *v2.SizeReservation `protobuf:"bytes,1,opt,name=size_reservation,json=sizeReservation,proto3" json:"size_reservation,omitempty"`
 	unknownFields   protoimpl.UnknownFields
 	sizeCache       protoimpl.SizeCache
@@ -115,7 +115,7 @@ func (x *SizeReservationServiceCreateResponse) GetSizeReservation() *v2.SizeRese
 	return nil
 }
 
-// SizeReservationServiceUpdateRequest is the request payload for a size reservation update request
+// SizeReservationServiceUpdateRequest is the request payload for updating a size reservation.
 type SizeReservationServiceUpdateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Id of this size reservation
@@ -215,10 +215,10 @@ func (x *SizeReservationServiceUpdateRequest) GetLabels() *v2.UpdateLabels {
 	return nil
 }
 
-// SizeReservationServiceUpdateResponse is the response payload for a size reservation update request
+// SizeReservationServiceUpdateResponse is the response payload for updating a size reservation.
 type SizeReservationServiceUpdateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// SizeReservation the size reservation
+	// SizeReservation contains the updated reservation
 	SizeReservation *v2.SizeReservation `protobuf:"bytes,1,opt,name=size_reservation,json=sizeReservation,proto3" json:"size_reservation,omitempty"`
 	unknownFields   protoimpl.UnknownFields
 	sizeCache       protoimpl.SizeCache
@@ -261,7 +261,7 @@ func (x *SizeReservationServiceUpdateResponse) GetSizeReservation() *v2.SizeRese
 	return nil
 }
 
-// SizeReservationServiceDeleteRequest is the request payload for a size reservation delete request
+// SizeReservationServiceDeleteRequest is the request payload for deleting a size reservation.
 type SizeReservationServiceDeleteRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// ID of the size reservation to delete
@@ -307,10 +307,10 @@ func (x *SizeReservationServiceDeleteRequest) GetId() string {
 	return ""
 }
 
-// SizeReservationServiceDeleteResponse is the response payload for a size reservation delete request
+// SizeReservationServiceDeleteResponse is the response payload for deleting a size reservation.
 type SizeReservationServiceDeleteResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// SizeReservation the size reservation
+	// SizeReservation contains the deleted reservation
 	SizeReservation *v2.SizeReservation `protobuf:"bytes,1,opt,name=size_reservation,json=sizeReservation,proto3" json:"size_reservation,omitempty"`
 	unknownFields   protoimpl.UnknownFields
 	sizeCache       protoimpl.SizeCache
@@ -353,7 +353,7 @@ func (x *SizeReservationServiceDeleteResponse) GetSizeReservation() *v2.SizeRese
 	return nil
 }
 
-// SizeReservationServiceListRequest is the request payload for a size list request
+// SizeReservationServiceListRequest is the request payload for listing size reservations.
 type SizeReservationServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Query for size reservations
@@ -399,10 +399,10 @@ func (x *SizeReservationServiceListRequest) GetQuery() *v2.SizeReservationQuery
 	return nil
 }
 
-// SizeReservationServiceListResponse is the response payload for a size reservation list request
+// SizeReservationServiceListResponse is the response payload for listing size reservations.
 type SizeReservationServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Size reservations
+	// SizeReservations contains the list of reservations
 	SizeReservations []*v2.SizeReservation `protobuf:"bytes,1,rep,name=size_reservations,json=sizeReservations,proto3" json:"size_reservations,omitempty"`
 	unknownFields    protoimpl.UnknownFields
 	sizeCache        protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/switch.pb.go b/go/metalstack/admin/v2/switch.pb.go
index c5445478..73791ca4 100644
--- a/go/metalstack/admin/v2/switch.pb.go
+++ b/go/metalstack/admin/v2/switch.pb.go
@@ -24,10 +24,10 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// SwitchServiceGetRequest.
+// SwitchServiceGetRequest is the request payload for getting a switch.
 type SwitchServiceGetRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Id of the switch to get.
+	// Id of the switch to get
 	Id            string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -70,10 +70,10 @@ func (x *SwitchServiceGetRequest) GetId() string {
 	return ""
 }
 
-// SwitchServiceGetResponse.
+// SwitchServiceGetResponse is the response payload for getting a switch.
 type SwitchServiceGetResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Switch that was requested.
+	// Switch contains the requested switch
 	Switch        *v2.Switch `protobuf:"bytes,1,opt,name=switch,proto3" json:"switch,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -116,10 +116,10 @@ func (x *SwitchServiceGetResponse) GetSwitch() *v2.Switch {
 	return nil
 }
 
-// SwitchServiceListRequest.
+// SwitchServiceListRequest is the request payload for listing switches.
 type SwitchServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Query to filter the results.
+	// Query to filter the results
 	Query         *v2.SwitchQuery `protobuf:"bytes,1,opt,name=query,proto3" json:"query,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -162,10 +162,10 @@ func (x *SwitchServiceListRequest) GetQuery() *v2.SwitchQuery {
 	return nil
 }
 
-// SwitchServiceListResponse.
+// SwitchServiceListResponse is the response payload for listing switches.
 type SwitchServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Switches that match the request query.
+	// Switches that match the request query
 	Switches      []*v2.Switch `protobuf:"bytes,1,rep,name=switches,proto3" json:"switches,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -208,29 +208,29 @@ func (x *SwitchServiceListResponse) GetSwitches() []*v2.Switch {
 	return nil
 }
 
-// SwitchServiceUpdateRequest.
+// SwitchServiceUpdateRequest is the request payload for updating a switch.
 type SwitchServiceUpdateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// ID of the switch.
+	// ID of the switch
 	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
-	// UpdateMeta contains the timestamp and strategy to be used in this update request.
+	// UpdateMeta contains the timestamp and strategy to be used in this update request
 	UpdateMeta *v2.UpdateMeta `protobuf:"bytes,2,opt,name=update_meta,json=updateMeta,proto3" json:"update_meta,omitempty"`
-	// UpdatedAt is the date when this entity was updated.
-	// must be part of the update request to ensure optimistic locking.
+	// UpdatedAt is the date when this entity was updated
+	// Must be part of the update request to ensure optimistic locking
 	UpdatedAt *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=updated_at,json=updatedAt,proto3" json:"updated_at,omitempty"`
-	// Description of the switch.
+	// Description of the switch
 	Description *string `protobuf:"bytes,4,opt,name=description,proto3,oneof" json:"description,omitempty"`
-	// Replace mode is used to mark a switch ready for replacement.
+	// ReplaceMode is used to mark a switch ready for replacement
 	ReplaceMode *v2.SwitchReplaceMode `protobuf:"varint,5,opt,name=replace_mode,json=replaceMode,proto3,enum=metalstack.api.v2.SwitchReplaceMode,oneof" json:"replace_mode,omitempty"`
-	// Management IP is the switch's IP for management access.
+	// ManagementIp is the switch's IP for management access
 	ManagementIp *string `protobuf:"bytes,6,opt,name=management_ip,json=managementIp,proto3,oneof" json:"management_ip,omitempty"`
-	// Management user is the user name to use for management access.
+	// ManagementUser is the user name to use for management access
 	ManagementUser *string `protobuf:"bytes,7,opt,name=management_user,json=managementUser,proto3,oneof" json:"management_user,omitempty"`
-	// Console command is the command for accessing the switch's console.
+	// ConsoleCommand is the command for accessing the switch's console
 	ConsoleCommand *string `protobuf:"bytes,8,opt,name=console_command,json=consoleCommand,proto3,oneof" json:"console_command,omitempty"`
-	// Nics are the front panel ports of the switch.
+	// Nics are the front panel ports of the switch
 	Nics []*v2.SwitchNic `protobuf:"bytes,9,rep,name=nics,proto3" json:"nics,omitempty"`
-	// SwitchOs is the OS running on the switch.
+	// SwitchOs is the OS running on the switch
 	Os            *v2.SwitchOS `protobuf:"bytes,10,opt,name=os,proto3,oneof" json:"os,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -336,10 +336,10 @@ func (x *SwitchServiceUpdateRequest) GetOs() *v2.SwitchOS {
 	return nil
 }
 
-// SwitchServiceUpdateResponse.
+// SwitchServiceUpdateResponse is the response payload for updating a switch.
 type SwitchServiceUpdateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Switch that was updated.
+	// Switch contains the updated switch
 	Switch        *v2.Switch `protobuf:"bytes,1,opt,name=switch,proto3" json:"switch,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -382,12 +382,12 @@ func (x *SwitchServiceUpdateResponse) GetSwitch() *v2.Switch {
 	return nil
 }
 
-// SwitchServiceDeleteRequest.
+// SwitchServiceDeleteRequest is the request payload for deleting a switch.
 type SwitchServiceDeleteRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Id of the switch.
+	// Id of the switch
 	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
-	// Force will allow switch deletion despite existing machine connections.
+	// Force will allow switch deletion despite existing machine connections
 	Force         bool `protobuf:"varint,2,opt,name=force,proto3" json:"force,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -437,10 +437,10 @@ func (x *SwitchServiceDeleteRequest) GetForce() bool {
 	return false
 }
 
-// SwitchServiceDeleteResponse.
+// SwitchServiceDeleteResponse is the response payload for deleting a switch.
 type SwitchServiceDeleteResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Switch that has been deleted.
+	// Switch contains the deleted switch
 	Switch        *v2.Switch `protobuf:"bytes,1,opt,name=switch,proto3" json:"switch,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -483,12 +483,12 @@ func (x *SwitchServiceDeleteResponse) GetSwitch() *v2.Switch {
 	return nil
 }
 
-// SwitchServiceMigrateRequest.
+// SwitchServiceMigrateRequest is the request payload for migrating a switch.
 type SwitchServiceMigrateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// OldSwitch which to migrate away from.
+	// OldSwitch is the switch to migrate away from
 	OldSwitch string `protobuf:"bytes,1,opt,name=old_switch,json=oldSwitch,proto3" json:"old_switch,omitempty"`
-	// NewSwitch which to migrate to.
+	// NewSwitch is the switch to migrate to
 	NewSwitch     string `protobuf:"bytes,2,opt,name=new_switch,json=newSwitch,proto3" json:"new_switch,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -538,10 +538,10 @@ func (x *SwitchServiceMigrateRequest) GetNewSwitch() string {
 	return ""
 }
 
-// SwitchServiceMigrateResponse.
+// SwitchServiceMigrateResponse is the response payload for migrating a switch.
 type SwitchServiceMigrateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Switch that was migrated to.
+	// Switch contains the switch was migrated to
 	Switch        *v2.Switch `protobuf:"bytes,1,opt,name=switch,proto3" json:"switch,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -584,14 +584,14 @@ func (x *SwitchServiceMigrateResponse) GetSwitch() *v2.Switch {
 	return nil
 }
 
-// SwitchServicePortRequest.
+// SwitchServicePortRequest is the request payload for setting the port status of a switch port.
 type SwitchServicePortRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Id of the switch.
+	// Id of the switch
 	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
-	// NicName of the port whose status should be changed.
+	// NicName of the port whose status should be changed
 	NicName string `protobuf:"bytes,2,opt,name=nic_name,json=nicName,proto3" json:"nic_name,omitempty"`
-	// Status that the port should have.
+	// Status that the port should have
 	Status        v2.SwitchPortStatus `protobuf:"varint,3,opt,name=status,proto3,enum=metalstack.api.v2.SwitchPortStatus" json:"status,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -648,10 +648,10 @@ func (x *SwitchServicePortRequest) GetStatus() v2.SwitchPortStatus {
 	return v2.SwitchPortStatus(0)
 }
 
-// SwitchServicePortResponse.
+// SwitchServicePortResponse is the response payload for setting the port status of a switch port.
 type SwitchServicePortResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Switch after the port status toggle..
+	// Switch after the port status toggle
 	Switch        *v2.Switch `protobuf:"bytes,1,opt,name=switch,proto3" json:"switch,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -694,12 +694,12 @@ func (x *SwitchServicePortResponse) GetSwitch() *v2.Switch {
 	return nil
 }
 
-// SwitchServiceConnectedMachinesRequest.
+// SwitchServiceConnectedMachinesRequest is the request payload for listing switches with machine connections.
 type SwitchServiceConnectedMachinesRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Query to filter the switch results.
+	// Query to filter the switch results
 	Query *v2.SwitchQuery `protobuf:"bytes,1,opt,name=query,proto3" json:"query,omitempty"`
-	// MachineQuery to filter the machine results.
+	// MachineQuery to filter the machine results
 	MachineQuery  *v2.MachineQuery `protobuf:"bytes,2,opt,name=machine_query,json=machineQuery,proto3" json:"machine_query,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -749,10 +749,10 @@ func (x *SwitchServiceConnectedMachinesRequest) GetMachineQuery() *v2.MachineQue
 	return nil
 }
 
-// SwitchServiceConnectedMachinesResponse.
+// SwitchServiceConnectedMachinesResponse is the response payload for listing switches with machine connections.
 type SwitchServiceConnectedMachinesResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// SwitchesWithMachines contains all switches with their machine connections.
+	// SwitchesWithMachines contains all switches with their machine connections
 	SwitchesWithMachines []*v2.SwitchWithMachines `protobuf:"bytes,1,rep,name=switches_with_machines,json=switchesWithMachines,proto3" json:"switches_with_machines,omitempty"`
 	unknownFields        protoimpl.UnknownFields
 	sizeCache            protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/task.pb.go b/go/metalstack/admin/v2/task.pb.go
index 7c89594d..f18c48a8 100644
--- a/go/metalstack/admin/v2/task.pb.go
+++ b/go/metalstack/admin/v2/task.pb.go
@@ -24,25 +24,25 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// TaskState defines the state of the task
+// TaskState defines the state of the task.
 type TaskState int32
 
 const (
-	// TASK_STATE_UNSPECIFIED indicates a undefined state
+	// TASK_STATE_UNSPECIFIED is not specified
 	TaskState_TASK_STATE_UNSPECIFIED TaskState = 0
-	// TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler.
+	// TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler
 	TaskState_TASK_STATE_ACTIVE TaskState = 1
-	// TASK_STATE_PENDING indicates that the task is ready to be processed by Handler.
+	// TASK_STATE_PENDING indicates that the task is ready to be processed by Handler
 	TaskState_TASK_STATE_PENDING TaskState = 2
-	// TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future.
+	// TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future
 	TaskState_TASK_STATE_SCHEDULED TaskState = 3
-	// TASK_STATE_RETRY indicates that the task has previously failed and scheduled to be processed some time in the future.
+	// TASK_STATE_RETRY indicates that the task has previously failed and is scheduled to be processed some time in the future
 	TaskState_TASK_STATE_RETRY TaskState = 4
-	// TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes.
+	// TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes
 	TaskState_TASK_STATE_ARCHIVED TaskState = 5
-	// TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires.
+	// TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires
 	TaskState_TASK_STATE_COMPLETED TaskState = 6
-	// TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task.
+	// TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task
 	TaskState_TASK_STATE_AGGREGATING TaskState = 7
 )
 
@@ -97,12 +97,12 @@ func (TaskState) EnumDescriptor() ([]byte, []int) {
 	return file_metalstack_admin_v2_task_proto_rawDescGZIP(), []int{0}
 }
 
-// TaskServiceGetRequest is the message to a get task request
+// TaskServiceGetRequest is the request payload for getting a task.
 type TaskServiceGetRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// TaskId to get
+	// TaskId is the identifier of the task to get
 	TaskId string `protobuf:"bytes,1,opt,name=task_id,json=taskId,proto3" json:"task_id,omitempty"`
-	// Queue where this task was scheduled to
+	// Queue is the queue where this task was scheduled to
 	Queue         string `protobuf:"bytes,2,opt,name=queue,proto3" json:"queue,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -152,7 +152,7 @@ func (x *TaskServiceGetRequest) GetQueue() string {
 	return ""
 }
 
-// TaskServiceGetResponse is the response to a task get request
+// TaskServiceGetResponse is the response payload for getting a task.
 type TaskServiceGetResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Task contains the task details
@@ -198,12 +198,12 @@ func (x *TaskServiceGetResponse) GetTask() *TaskInfo {
 	return nil
 }
 
-// TaskServiceDeleteRequest is the message to a delete task request
+// TaskServiceDeleteRequest is the request payload for deleting a task.
 type TaskServiceDeleteRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// TaskId to cancel
+	// TaskId is the identifier of the task to cancel
 	TaskId string `protobuf:"bytes,1,opt,name=task_id,json=taskId,proto3" json:"task_id,omitempty"`
-	// Queue where this task was scheduled to
+	// Queue is the queue where this task was scheduled to
 	Queue         string `protobuf:"bytes,2,opt,name=queue,proto3" json:"queue,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -253,7 +253,7 @@ func (x *TaskServiceDeleteRequest) GetQueue() string {
 	return ""
 }
 
-// TaskServiceDeleteResponse is the response to a task delete request
+// TaskServiceDeleteResponse is the response payload for deleting a task.
 type TaskServiceDeleteResponse struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
 	unknownFields protoimpl.UnknownFields
@@ -290,7 +290,7 @@ func (*TaskServiceDeleteResponse) Descriptor() ([]byte, []int) {
 	return file_metalstack_admin_v2_task_proto_rawDescGZIP(), []int{3}
 }
 
-// TaskServiceQueuesRequest is the message to get all queues
+// TaskServiceQueuesRequest is the request payload for getting all queues.
 type TaskServiceQueuesRequest struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
 	unknownFields protoimpl.UnknownFields
@@ -327,7 +327,7 @@ func (*TaskServiceQueuesRequest) Descriptor() ([]byte, []int) {
 	return file_metalstack_admin_v2_task_proto_rawDescGZIP(), []int{4}
 }
 
-// TaskServiceQueuesResponse is the response to a queues request
+// TaskServiceQueuesResponse is the response payload for getting all queues.
 type TaskServiceQueuesResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Queues configured for the async system
@@ -373,15 +373,15 @@ func (x *TaskServiceQueuesResponse) GetQueues() []string {
 	return nil
 }
 
-// TaskServiceListRequest is the message to a task list request
+// TaskServiceListRequest is the request payload for listing tasks.
 type TaskServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Queue where this tasks should be listed
-	// will return tasks from all queues if not specified
+	// Queue filters tasks by this queue
+	// Will return tasks from all queues if not specified
 	Queue *string `protobuf:"bytes,1,opt,name=queue,proto3,oneof" json:"queue,omitempty"`
-	// Count of tasks to return
+	// Count is the number of tasks to return
 	Count *uint32 `protobuf:"varint,2,opt,name=count,proto3,oneof" json:"count,omitempty"`
-	// Page of tasks to return
+	// Page is the page of tasks to return
 	Page          *uint32 `protobuf:"varint,3,opt,name=page,proto3,oneof" json:"page,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -438,10 +438,10 @@ func (x *TaskServiceListRequest) GetPage() uint32 {
 	return 0
 }
 
-// TaskServiceListResponse is the response to a task list request
+// TaskServiceListResponse is the response payload for listing tasks.
 type TaskServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Tasks contains the requested list of tasks
+	// Tasks contains the list of requested tasks
 	Tasks         []*TaskInfo `protobuf:"bytes,1,rep,name=tasks,proto3" json:"tasks,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -484,56 +484,56 @@ func (x *TaskServiceListResponse) GetTasks() []*TaskInfo {
 	return nil
 }
 
-// TaskInfo contains details of an async task
+// TaskInfo contains details of an asynchronous task.
 type TaskInfo struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// ID is the identifier of the task.
+	// ID is the identifier of the task
 	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
-	// Queue is the name of the queue in which the task belongs.
+	// Queue is the name of the queue in which the task belongs
 	Queue string `protobuf:"bytes,2,opt,name=queue,proto3" json:"queue,omitempty"`
-	// Type is the type name of the task.
+	// Type is the type name of the task
 	Type string `protobuf:"bytes,3,opt,name=type,proto3" json:"type,omitempty"`
-	// Payload is the payload data of the task.
+	// Payload is the payload data of the task
 	Payload []byte `protobuf:"bytes,4,opt,name=payload,proto3" json:"payload,omitempty"`
-	// State indicates the task state.
+	// State indicates the task state
 	State TaskState `protobuf:"varint,5,opt,name=state,proto3,enum=metalstack.admin.v2.TaskState" json:"state,omitempty"`
-	// MaxRetry is the maximum number of times the task can be retried.
+	// MaxRetry is the maximum number of times the task can be retried
 	MaxRetry int32 `protobuf:"varint,6,opt,name=max_retry,json=maxRetry,proto3" json:"max_retry,omitempty"`
-	// Retried is the number of times the task has retried so far.
+	// Retried is the number of times the task has retried so far
 	Retried int32 `protobuf:"varint,7,opt,name=retried,proto3" json:"retried,omitempty"`
-	// LastError is the error message from the last failure.
+	// LastError is the error message from the last failure
 	LastError string `protobuf:"bytes,8,opt,name=last_error,json=lastError,proto3" json:"last_error,omitempty"`
-	// LastFailedAt is the time time of the last failure if any.
-	// If the task has no failures, LastFailedAt is zero time (i.e. time.Time{}).
+	// LastFailedAt is the time of the last failure if any
+	// If the task has no failures, LastFailedAt is zero time (i.e. time.Time{})
 	LastFailedAt *timestamppb.Timestamp `protobuf:"bytes,9,opt,name=last_failed_at,json=lastFailedAt,proto3" json:"last_failed_at,omitempty"`
-	// Timeout is the duration the task can be processed by Handler before being retried,
+	// Timeout is the duration the task can be processed by Handler before being retried
 	Timeout *durationpb.Duration `protobuf:"bytes,10,opt,name=timeout,proto3" json:"timeout,omitempty"`
-	// Deadline is the deadline for the task.
+	// Deadline is the deadline for the task
 	Deadline *timestamppb.Timestamp `protobuf:"bytes,11,opt,name=deadline,proto3" json:"deadline,omitempty"`
-	// Group is the name of the group in which the task belongs.
+	// Group is the name of the group in which the task belongs
 	//
 	// Tasks in the same queue can be grouped together by Group name and will be aggregated into one task
-	// by a Server processing the queue.
+	// by a Server processing the queue
 	//
-	// Empty string (default) indicates task does not belong to any groups, and no aggregation will be applied to the task.
+	// Empty string (default) indicates task does not belong to any groups, and no aggregation will be applied to the task
 	Group string `protobuf:"bytes,12,opt,name=group,proto3" json:"group,omitempty"`
-	// NextProcessAt is the time the task is scheduled to be processed,
-	// zero if not applicable.
+	// NextProcessAt is the time the task is scheduled to be processed
+	// Zero if not applicable
 	NextProcessAt *timestamppb.Timestamp `protobuf:"bytes,13,opt,name=next_process_at,json=nextProcessAt,proto3" json:"next_process_at,omitempty"`
-	// IsOrphaned describes whether the task is left in active state with no worker processing it.
+	// IsOrphaned describes whether the task is left in active state with no worker processing it
 	// An orphaned task indicates that the worker has crashed or experienced network failures and was not able to
-	// extend its lease on the task.
+	// extend its lease on the task
 	//
-	// This task will be recovered by running a server against the queue the task is in.
-	// This field is only applicable to tasks with TaskStateActive.
+	// This task will be recovered by running a server against the queue the task is in
+	// This field is only applicable to tasks with TaskStateActive
 	IsOrphaned bool `protobuf:"varint,14,opt,name=is_orphaned,json=isOrphaned,proto3" json:"is_orphaned,omitempty"`
-	// Retention is duration of the retention period after the task is successfully processed.
+	// Retention is duration of the retention period after the task is successfully processed
 	Retention *durationpb.Duration `protobuf:"bytes,15,opt,name=retention,proto3" json:"retention,omitempty"`
-	// CompletedAt is the time when the task is processed successfully.
-	// Zero value (i.e. time.Time{}) indicates no value.
+	// CompletedAt is the time when the task is processed successfully
+	// Zero value (i.e. time.Time{}) indicates no value
 	CompletedAt *timestamppb.Timestamp `protobuf:"bytes,16,opt,name=completed_at,json=completedAt,proto3" json:"completed_at,omitempty"`
-	// Result holds the result data associated with the task.
-	// Use ResultWriter to write result data from the Handler.
+	// Result holds the result data associated with the task
+	// Use ResultWriter to write result data from the Handler
 	Result        []byte `protobuf:"bytes,17,opt,name=result,proto3" json:"result,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/tenant.pb.go b/go/metalstack/admin/v2/tenant.pb.go
index 03aebe2e..e7a89f13 100644
--- a/go/metalstack/admin/v2/tenant.pb.go
+++ b/go/metalstack/admin/v2/tenant.pb.go
@@ -23,12 +23,12 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// TenantServiceCreateRequest is the request payload of the tenant create request
+// TenantServiceCreateRequest is the request payload for creating a tenant.
 type TenantServiceCreateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Name of this tenant
+	// Name of the tenant
 	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
-	// Description of this tenant
+	// Description of the tenant
 	Description *string `protobuf:"bytes,2,opt,name=description,proto3,oneof" json:"description,omitempty"`
 	// Email of the tenant, if not set will be inherited from the creator
 	Email *string `protobuf:"bytes,3,opt,name=email,proto3,oneof" json:"email,omitempty"`
@@ -105,10 +105,10 @@ func (x *TenantServiceCreateRequest) GetLabels() *v2.Labels {
 	return nil
 }
 
-// TenantServiceCreateResponse is the response payload of the tenant create request
+// TenantServiceCreateResponse is the response payload for creating a tenant.
 type TenantServiceCreateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Tenant is the tenant
+	// Tenant contains the created tenant
 	Tenant        *v2.Tenant `protobuf:"bytes,1,opt,name=tenant,proto3" json:"tenant,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -151,12 +151,12 @@ func (x *TenantServiceCreateResponse) GetTenant() *v2.Tenant {
 	return nil
 }
 
-// TenantServiceListRequest is the request payload for a tenant list request
+// TenantServiceListRequest is the request payload for listing tenants.
 type TenantServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Login of the tenant to list
+	// Login filters tenants by this login
 	Login *string `protobuf:"bytes,1,opt,name=login,proto3,oneof" json:"login,omitempty"`
-	// Name of the tenant to list
+	// Name filters tenants by this name
 	Name *string `protobuf:"bytes,2,opt,name=name,proto3,oneof" json:"name,omitempty"`
 	// Paging details for the list request
 	Paging        *v2.Paging `protobuf:"bytes,3,opt,name=paging,proto3" json:"paging,omitempty"`
@@ -215,12 +215,12 @@ func (x *TenantServiceListRequest) GetPaging() *v2.Paging {
 	return nil
 }
 
-// TenantServiceListResponse is the response payload for a tenant list request
+// TenantServiceListResponse is the response payload for listing tenants.
 type TenantServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Tenants are the list of tenants
+	// Tenants contains the list of tenants
 	Tenants []*v2.Tenant `protobuf:"bytes,1,rep,name=tenants,proto3" json:"tenants,omitempty"`
-	// NextPage is used for pagination, returns the next page to be fetched and must then be provided in the list request.
+	// NextPage is used for pagination, returns the next page to be fetched and must then be provided in the list request
 	NextPage      *uint64 `protobuf:"varint,2,opt,name=next_page,json=nextPage,proto3,oneof" json:"next_page,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/token.pb.go b/go/metalstack/admin/v2/token.pb.go
index feb7991b..53fdfc05 100644
--- a/go/metalstack/admin/v2/token.pb.go
+++ b/go/metalstack/admin/v2/token.pb.go
@@ -23,7 +23,7 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// TokenServiceListRequest is the request payload for the token list request
+// TokenServiceListRequest is the request payload for listing tokens.
 type TokenServiceListRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// User is the id of the user for which the tokens should be listed
@@ -69,10 +69,10 @@ func (x *TokenServiceListRequest) GetUser() string {
 	return ""
 }
 
-// TokenServiceListResponse is the response payload for the token list request
+// TokenServiceListResponse is the response payload for listing tokens.
 type TokenServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Tokens is the list of tokens
+	// Tokens contains the list of tokens
 	Tokens        []*v2.Token `protobuf:"bytes,1,rep,name=tokens,proto3" json:"tokens,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -115,7 +115,7 @@ func (x *TokenServiceListResponse) GetTokens() []*v2.Token {
 	return nil
 }
 
-// TokenServiceRevokeRequest is the request payload for the token revoke request
+// TokenServiceRevokeRequest is the request payload for revoking a token.
 type TokenServiceRevokeRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Uuid is the uuid of the token which should be revoked
@@ -170,7 +170,7 @@ func (x *TokenServiceRevokeRequest) GetUser() string {
 	return ""
 }
 
-// TokenServiceRevokeResponse is the response payload for the token revoke request
+// TokenServiceRevokeResponse is the response payload for revoking a token.
 type TokenServiceRevokeResponse struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
 	unknownFields protoimpl.UnknownFields
@@ -207,7 +207,7 @@ func (*TokenServiceRevokeResponse) Descriptor() ([]byte, []int) {
 	return file_metalstack_admin_v2_token_proto_rawDescGZIP(), []int{3}
 }
 
-// TokenServiceCreateRequest is the request payload to create a token
+// TokenServiceCreateRequest is the request payload for creating a token.
 type TokenServiceCreateRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// User this token should be created for, if omitted, user is derived from caller
@@ -262,12 +262,12 @@ func (x *TokenServiceCreateRequest) GetTokenCreateRequest() *v2.TokenServiceCrea
 	return nil
 }
 
-// TokenServiceCreateResponse is the response payload of a token create request
+// TokenServiceCreateResponse is the response payload for creating a token.
 type TokenServiceCreateResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Token which was created
+	// Token contains the created token
 	Token *v2.Token `protobuf:"bytes,1,opt,name=token,proto3" json:"token,omitempty"`
-	// Secret is the body if the jwt token, should be used in api requests as bearer token
+	// Secret is the body if the JWT token, should be used in API requests as bearer token
 	Secret        string `protobuf:"bytes,2,opt,name=secret,proto3" json:"secret,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/admin/v2/vpn.pb.go b/go/metalstack/admin/v2/vpn.pb.go
index 84f271fd..16836a4b 100644
--- a/go/metalstack/admin/v2/vpn.pb.go
+++ b/go/metalstack/admin/v2/vpn.pb.go
@@ -25,17 +25,17 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// VPNServiceAuthKeyRequest is the request payload for a vpn authkey request.
+// VPNServiceAuthKeyRequest is the request payload for generating a VPN authentication key.
 type VPNServiceAuthKeyRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Project for which a vpn authkey should be generated.
+	// Project for which a VPN authentication key should be generated
 	Project string `protobuf:"bytes,1,opt,name=project,proto3" json:"project,omitempty"`
-	// Ephemeral defines if the authkey should be ephemeral.
+	// Ephemeral defines if the authentication key should be ephemeral
 	Ephemeral bool `protobuf:"varint,2,opt,name=ephemeral,proto3" json:"ephemeral,omitempty"`
-	// Expires defines the duration after which the authkey expires.
+	// Expires defines the duration after which the authentication key expires
 	Expires *durationpb.Duration `protobuf:"bytes,3,opt,name=expires,proto3" json:"expires,omitempty"`
-	// Reason must be provided why access to the vpn is requested
-	// reason is only forwarded to a audit sink
+	// Reason must be provided why access to the VPN is requested
+	// Reason is only forwarded to an audit sink
 	Reason        string `protobuf:"bytes,4,opt,name=reason,proto3" json:"reason,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -99,19 +99,19 @@ func (x *VPNServiceAuthKeyRequest) GetReason() string {
 	return ""
 }
 
-// VPNServiceAuthKeyResponse is the request payload for a authkey response
+// VPNServiceAuthKeyResponse is the response payload for generating a VPN authentication key.
 type VPNServiceAuthKeyResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Address is the address of the vpn control plane.
+	// Address is the address of the VPN control plane
 	Address string `protobuf:"bytes,1,opt,name=address,proto3" json:"address,omitempty"`
-	// AuthKey is the key to connect to the vpn at the given address.
-	// This key can only be seen once.
+	// AuthKey is the key to connect to the VPN at the given address
+	// This key can only be seen once
 	AuthKey string `protobuf:"bytes,2,opt,name=auth_key,json=authKey,proto3" json:"auth_key,omitempty"`
-	// Ephemeral defines if the authkey should be ephemeral.
+	// Ephemeral defines if the authentication key should be ephemeral
 	Ephemeral bool `protobuf:"varint,3,opt,name=ephemeral,proto3" json:"ephemeral,omitempty"`
-	// ExpiresAt this key cannot be used after this timestamp.
+	// ExpiresAt this key cannot be used after this timestamp
 	ExpiresAt *timestamppb.Timestamp `protobuf:"bytes,4,opt,name=expires_at,json=expiresAt,proto3" json:"expires_at,omitempty"`
-	// CreatedAt this key was created at this timestamp.
+	// CreatedAt this key was created at this timestamp
 	CreatedAt     *timestamppb.Timestamp `protobuf:"bytes,5,opt,name=created_at,json=createdAt,proto3" json:"created_at,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -182,10 +182,10 @@ func (x *VPNServiceAuthKeyResponse) GetCreatedAt() *timestamppb.Timestamp {
 	return nil
 }
 
-// VPNServiceListNodesRequest is the request payload for a vpn list nodes request
+// VPNServiceListNodesRequest is the request payload for listing VPN nodes.
 type VPNServiceListNodesRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Project if given only nodes of this user are returned
+	// Project filters nodes by this project
 	Project       *string `protobuf:"bytes,1,opt,name=project,proto3,oneof" json:"project,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -228,10 +228,10 @@ func (x *VPNServiceListNodesRequest) GetProject() string {
 	return ""
 }
 
-// VPNServiceListNodesResponse is the response payload for a vpn list nodes request
+// VPNServiceListNodesResponse is the response payload for listing VPN nodes.
 type VPNServiceListNodesResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Nodes connected to the vpn
+	// Nodes connected to the VPN
 	Nodes         []*v2.VPNNode `protobuf:"bytes,1,rep,name=nodes,proto3" json:"nodes,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/api/v2/apiv2connect/audit.connect.go b/go/metalstack/api/v2/apiv2connect/audit.connect.go
index ec0a7592..df8ceb7d 100644
--- a/go/metalstack/api/v2/apiv2connect/audit.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/audit.connect.go
@@ -41,9 +41,9 @@ const (
 
 // AuditServiceClient is a client for the metalstack.api.v2.AuditService service.
 type AuditServiceClient interface {
-	// Get an audit trace
+	// Returns the audit trace with the specified UUID.
 	Get(context.Context, *v2.AuditServiceGetRequest) (*v2.AuditServiceGetResponse, error)
-	// List audit traces
+	// Returns the list of audit traces.
 	List(context.Context, *v2.AuditServiceListRequest) (*v2.AuditServiceListResponse, error)
 }
 
@@ -99,9 +99,9 @@ func (c *auditServiceClient) List(ctx context.Context, req *v2.AuditServiceListR
 
 // AuditServiceHandler is an implementation of the metalstack.api.v2.AuditService service.
 type AuditServiceHandler interface {
-	// Get an audit trace
+	// Returns the audit trace with the specified UUID.
 	Get(context.Context, *v2.AuditServiceGetRequest) (*v2.AuditServiceGetResponse, error)
-	// List audit traces
+	// Returns the list of audit traces.
 	List(context.Context, *v2.AuditServiceListRequest) (*v2.AuditServiceListResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/filesystem.connect.go b/go/metalstack/api/v2/apiv2connect/filesystem.connect.go
index 59167218..9f0439fc 100644
--- a/go/metalstack/api/v2/apiv2connect/filesystem.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/filesystem.connect.go
@@ -43,11 +43,11 @@ const (
 
 // FilesystemServiceClient is a client for the metalstack.api.v2.FilesystemService service.
 type FilesystemServiceClient interface {
-	// Get a filesystem
+	// Returns the filesystem with the specified ID.
 	Get(context.Context, *v2.FilesystemServiceGetRequest) (*v2.FilesystemServiceGetResponse, error)
-	// List all filesystems
+	// Returns the list of all filesystems.
 	List(context.Context, *v2.FilesystemServiceListRequest) (*v2.FilesystemServiceListResponse, error)
-	// Match a filesystems
+	// Matches a filesystem to a size and image or machine.
 	Match(context.Context, *v2.FilesystemServiceMatchRequest) (*v2.FilesystemServiceMatchResponse, error)
 }
 
@@ -119,11 +119,11 @@ func (c *filesystemServiceClient) Match(ctx context.Context, req *v2.FilesystemS
 
 // FilesystemServiceHandler is an implementation of the metalstack.api.v2.FilesystemService service.
 type FilesystemServiceHandler interface {
-	// Get a filesystem
+	// Returns the filesystem with the specified ID.
 	Get(context.Context, *v2.FilesystemServiceGetRequest) (*v2.FilesystemServiceGetResponse, error)
-	// List all filesystems
+	// Returns the list of all filesystems.
 	List(context.Context, *v2.FilesystemServiceListRequest) (*v2.FilesystemServiceListResponse, error)
-	// Match a filesystems
+	// Matches a filesystem to a size and image or machine.
 	Match(context.Context, *v2.FilesystemServiceMatchRequest) (*v2.FilesystemServiceMatchResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/health.connect.go b/go/metalstack/api/v2/apiv2connect/health.connect.go
index c35167f2..b0703610 100644
--- a/go/metalstack/api/v2/apiv2connect/health.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/health.connect.go
@@ -39,7 +39,7 @@ const (
 
 // HealthServiceClient is a client for the metalstack.api.v2.HealthService service.
 type HealthServiceClient interface {
-	// Get the health of the platform
+	// Returns the health status of the platform.
 	Get(context.Context, *v2.HealthServiceGetRequest) (*v2.HealthServiceGetResponse, error)
 }
 
@@ -79,7 +79,7 @@ func (c *healthServiceClient) Get(ctx context.Context, req *v2.HealthServiceGetR
 
 // HealthServiceHandler is an implementation of the metalstack.api.v2.HealthService service.
 type HealthServiceHandler interface {
-	// Get the health of the platform
+	// Returns the health status of the platform.
 	Get(context.Context, *v2.HealthServiceGetRequest) (*v2.HealthServiceGetResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/image.connect.go b/go/metalstack/api/v2/apiv2connect/image.connect.go
index a8886fef..5a44e8a7 100644
--- a/go/metalstack/api/v2/apiv2connect/image.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/image.connect.go
@@ -43,11 +43,11 @@ const (
 
 // ImageServiceClient is a client for the metalstack.api.v2.ImageService service.
 type ImageServiceClient interface {
-	// Get a image
+	// Returns the image with the specified ID.
 	Get(context.Context, *v2.ImageServiceGetRequest) (*v2.ImageServiceGetResponse, error)
-	// List all images
+	// Returns the list of all images.
 	List(context.Context, *v2.ImageServiceListRequest) (*v2.ImageServiceListResponse, error)
-	// Latest image for a specific os
+	// Returns the latest image for a specific operating system.
 	Latest(context.Context, *v2.ImageServiceLatestRequest) (*v2.ImageServiceLatestResponse, error)
 }
 
@@ -119,11 +119,11 @@ func (c *imageServiceClient) Latest(ctx context.Context, req *v2.ImageServiceLat
 
 // ImageServiceHandler is an implementation of the metalstack.api.v2.ImageService service.
 type ImageServiceHandler interface {
-	// Get a image
+	// Returns the image with the specified ID.
 	Get(context.Context, *v2.ImageServiceGetRequest) (*v2.ImageServiceGetResponse, error)
-	// List all images
+	// Returns the list of all images.
 	List(context.Context, *v2.ImageServiceListRequest) (*v2.ImageServiceListResponse, error)
-	// Latest image for a specific os
+	// Returns the latest image for a specific operating system.
 	Latest(context.Context, *v2.ImageServiceLatestRequest) (*v2.ImageServiceLatestResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/ip.connect.go b/go/metalstack/api/v2/apiv2connect/ip.connect.go
index a9b68e95..00bb2709 100644
--- a/go/metalstack/api/v2/apiv2connect/ip.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/ip.connect.go
@@ -47,15 +47,15 @@ const (
 
 // IPServiceClient is a client for the metalstack.api.v2.IPService service.
 type IPServiceClient interface {
-	// Get a ip
+	// Returns the IP address with the specified IP.
 	Get(context.Context, *v2.IPServiceGetRequest) (*v2.IPServiceGetResponse, error)
-	// Create a ip
+	// Creates a new IP address.
 	Create(context.Context, *v2.IPServiceCreateRequest) (*v2.IPServiceCreateResponse, error)
-	// Update a ip
+	// Updates an IP address.
 	Update(context.Context, *v2.IPServiceUpdateRequest) (*v2.IPServiceUpdateResponse, error)
-	// List all ips
+	// Returns the list of all IP addresses.
 	List(context.Context, *v2.IPServiceListRequest) (*v2.IPServiceListResponse, error)
-	// Delete a ip
+	// Deletes an IP address.
 	Delete(context.Context, *v2.IPServiceDeleteRequest) (*v2.IPServiceDeleteResponse, error)
 }
 
@@ -159,15 +159,15 @@ func (c *iPServiceClient) Delete(ctx context.Context, req *v2.IPServiceDeleteReq
 
 // IPServiceHandler is an implementation of the metalstack.api.v2.IPService service.
 type IPServiceHandler interface {
-	// Get a ip
+	// Returns the IP address with the specified IP.
 	Get(context.Context, *v2.IPServiceGetRequest) (*v2.IPServiceGetResponse, error)
-	// Create a ip
+	// Creates a new IP address.
 	Create(context.Context, *v2.IPServiceCreateRequest) (*v2.IPServiceCreateResponse, error)
-	// Update a ip
+	// Updates an IP address.
 	Update(context.Context, *v2.IPServiceUpdateRequest) (*v2.IPServiceUpdateResponse, error)
-	// List all ips
+	// Returns the list of all IP addresses.
 	List(context.Context, *v2.IPServiceListRequest) (*v2.IPServiceListResponse, error)
-	// Delete a ip
+	// Deletes an IP address.
 	Delete(context.Context, *v2.IPServiceDeleteRequest) (*v2.IPServiceDeleteResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/machine.connect.go b/go/metalstack/api/v2/apiv2connect/machine.connect.go
index fa33f5f1..9674fc72 100644
--- a/go/metalstack/api/v2/apiv2connect/machine.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/machine.connect.go
@@ -52,19 +52,19 @@ const (
 
 // MachineServiceClient is a client for the metalstack.api.v2.MachineService service.
 type MachineServiceClient interface {
-	// Get a machine
+	// Returns the machine with the specified UUID.
 	Get(context.Context, *v2.MachineServiceGetRequest) (*v2.MachineServiceGetResponse, error)
-	// Create a machine
+	// Creates a new machine.
 	Create(context.Context, *v2.MachineServiceCreateRequest) (*v2.MachineServiceCreateResponse, error)
-	// Update a machine
+	// Updates a machine.
 	Update(context.Context, *v2.MachineServiceUpdateRequest) (*v2.MachineServiceUpdateResponse, error)
-	// List all machines
+	// Returns the list of all machines.
 	List(context.Context, *v2.MachineServiceListRequest) (*v2.MachineServiceListResponse, error)
-	// Delete a machine
+	// Deletes a machine.
 	Delete(context.Context, *v2.MachineServiceDeleteRequest) (*v2.MachineServiceDeleteResponse, error)
-	// BMCCommand send a command to the bmc of a machine
+	// BMCCommand sends a command to the BMC of a machine.
 	BMCCommand(context.Context, *v2.MachineServiceBMCCommandRequest) (*v2.MachineServiceBMCCommandResponse, error)
-	// GetBMC returns the BMC details of a machine
+	// Returns the BMC details of a machine.
 	GetBMC(context.Context, *v2.MachineServiceGetBMCRequest) (*v2.MachineServiceGetBMCResponse, error)
 }
 
@@ -200,19 +200,19 @@ func (c *machineServiceClient) GetBMC(ctx context.Context, req *v2.MachineServic
 
 // MachineServiceHandler is an implementation of the metalstack.api.v2.MachineService service.
 type MachineServiceHandler interface {
-	// Get a machine
+	// Returns the machine with the specified UUID.
 	Get(context.Context, *v2.MachineServiceGetRequest) (*v2.MachineServiceGetResponse, error)
-	// Create a machine
+	// Creates a new machine.
 	Create(context.Context, *v2.MachineServiceCreateRequest) (*v2.MachineServiceCreateResponse, error)
-	// Update a machine
+	// Updates a machine.
 	Update(context.Context, *v2.MachineServiceUpdateRequest) (*v2.MachineServiceUpdateResponse, error)
-	// List all machines
+	// Returns the list of all machines.
 	List(context.Context, *v2.MachineServiceListRequest) (*v2.MachineServiceListResponse, error)
-	// Delete a machine
+	// Deletes a machine.
 	Delete(context.Context, *v2.MachineServiceDeleteRequest) (*v2.MachineServiceDeleteResponse, error)
-	// BMCCommand send a command to the bmc of a machine
+	// BMCCommand sends a command to the BMC of a machine.
 	BMCCommand(context.Context, *v2.MachineServiceBMCCommandRequest) (*v2.MachineServiceBMCCommandResponse, error)
-	// GetBMC returns the BMC details of a machine
+	// Returns the BMC details of a machine.
 	GetBMC(context.Context, *v2.MachineServiceGetBMCRequest) (*v2.MachineServiceGetBMCResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/method.connect.go b/go/metalstack/api/v2/apiv2connect/method.connect.go
index 3c414892..e49be3cb 100644
--- a/go/metalstack/api/v2/apiv2connect/method.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/method.connect.go
@@ -42,9 +42,9 @@ const (
 
 // MethodServiceClient is a client for the metalstack.api.v2.MethodService service.
 type MethodServiceClient interface {
-	// List all public visible methods
+	// Returns the list of all public visible methods.
 	List(context.Context, *v2.MethodServiceListRequest) (*v2.MethodServiceListResponse, error)
-	// TokenScopedList all methods callable with the token present in the request
+	// TokenScopedList returns all methods callable with the token present in the request.
 	TokenScopedList(context.Context, *v2.MethodServiceTokenScopedListRequest) (*v2.MethodServiceTokenScopedListResponse, error)
 }
 
@@ -100,9 +100,9 @@ func (c *methodServiceClient) TokenScopedList(ctx context.Context, req *v2.Metho
 
 // MethodServiceHandler is an implementation of the metalstack.api.v2.MethodService service.
 type MethodServiceHandler interface {
-	// List all public visible methods
+	// Returns the list of all public visible methods.
 	List(context.Context, *v2.MethodServiceListRequest) (*v2.MethodServiceListResponse, error)
-	// TokenScopedList all methods callable with the token present in the request
+	// TokenScopedList returns all methods callable with the token present in the request.
 	TokenScopedList(context.Context, *v2.MethodServiceTokenScopedListRequest) (*v2.MethodServiceTokenScopedListResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/network.connect.go b/go/metalstack/api/v2/apiv2connect/network.connect.go
index 889d3615..ed05b0ea 100644
--- a/go/metalstack/api/v2/apiv2connect/network.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/network.connect.go
@@ -50,17 +50,17 @@ const (
 
 // NetworkServiceClient is a client for the metalstack.api.v2.NetworkService service.
 type NetworkServiceClient interface {
-	// Get a network
+	// Returns the network with the specified ID.
 	Get(context.Context, *v2.NetworkServiceGetRequest) (*v2.NetworkServiceGetResponse, error)
-	// Create a child network from a super network.
+	// Creates a child network from a super network.
 	Create(context.Context, *v2.NetworkServiceCreateRequest) (*v2.NetworkServiceCreateResponse, error)
-	// Update a network
+	// Updates a network.
 	Update(context.Context, *v2.NetworkServiceUpdateRequest) (*v2.NetworkServiceUpdateResponse, error)
-	// List all project networks
+	// Returns the list of all project networks.
 	List(context.Context, *v2.NetworkServiceListRequest) (*v2.NetworkServiceListResponse, error)
-	// ListBaseNetworks all base networks that can be used for either child network or ip allocation
+	// ListBaseNetworks returns all base networks that can be used for either child network or IP allocation.
 	ListBaseNetworks(context.Context, *v2.NetworkServiceListBaseNetworksRequest) (*v2.NetworkServiceListBaseNetworksResponse, error)
-	// Delete a network
+	// Deletes a network.
 	Delete(context.Context, *v2.NetworkServiceDeleteRequest) (*v2.NetworkServiceDeleteResponse, error)
 }
 
@@ -180,17 +180,17 @@ func (c *networkServiceClient) Delete(ctx context.Context, req *v2.NetworkServic
 
 // NetworkServiceHandler is an implementation of the metalstack.api.v2.NetworkService service.
 type NetworkServiceHandler interface {
-	// Get a network
+	// Returns the network with the specified ID.
 	Get(context.Context, *v2.NetworkServiceGetRequest) (*v2.NetworkServiceGetResponse, error)
-	// Create a child network from a super network.
+	// Creates a child network from a super network.
 	Create(context.Context, *v2.NetworkServiceCreateRequest) (*v2.NetworkServiceCreateResponse, error)
-	// Update a network
+	// Updates a network.
 	Update(context.Context, *v2.NetworkServiceUpdateRequest) (*v2.NetworkServiceUpdateResponse, error)
-	// List all project networks
+	// Returns the list of all project networks.
 	List(context.Context, *v2.NetworkServiceListRequest) (*v2.NetworkServiceListResponse, error)
-	// ListBaseNetworks all base networks that can be used for either child network or ip allocation
+	// ListBaseNetworks returns all base networks that can be used for either child network or IP allocation.
 	ListBaseNetworks(context.Context, *v2.NetworkServiceListBaseNetworksRequest) (*v2.NetworkServiceListBaseNetworksResponse, error)
-	// Delete a network
+	// Deletes a network.
 	Delete(context.Context, *v2.NetworkServiceDeleteRequest) (*v2.NetworkServiceDeleteResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/partition.connect.go b/go/metalstack/api/v2/apiv2connect/partition.connect.go
index 37d648d3..0899b4c8 100644
--- a/go/metalstack/api/v2/apiv2connect/partition.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/partition.connect.go
@@ -41,9 +41,9 @@ const (
 
 // PartitionServiceClient is a client for the metalstack.api.v2.PartitionService service.
 type PartitionServiceClient interface {
-	// Get a partition
+	// Returns the partition with the specified ID.
 	Get(context.Context, *v2.PartitionServiceGetRequest) (*v2.PartitionServiceGetResponse, error)
-	// List all partitions
+	// Returns the list of all partitions.
 	List(context.Context, *v2.PartitionServiceListRequest) (*v2.PartitionServiceListResponse, error)
 }
 
@@ -99,9 +99,9 @@ func (c *partitionServiceClient) List(ctx context.Context, req *v2.PartitionServ
 
 // PartitionServiceHandler is an implementation of the metalstack.api.v2.PartitionService service.
 type PartitionServiceHandler interface {
-	// Get a partition
+	// Returns the partition with the specified ID.
 	Get(context.Context, *v2.PartitionServiceGetRequest) (*v2.PartitionServiceGetResponse, error)
-	// List all partitions
+	// Returns the list of all partitions.
 	List(context.Context, *v2.PartitionServiceListRequest) (*v2.PartitionServiceListResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/project.connect.go b/go/metalstack/api/v2/apiv2connect/project.connect.go
index b76c92c6..5ef541aa 100644
--- a/go/metalstack/api/v2/apiv2connect/project.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/project.connect.go
@@ -69,9 +69,9 @@ const (
 
 // ProjectServiceClient is a client for the metalstack.api.v2.ProjectService service.
 type ProjectServiceClient interface {
-	// List all accessible projects
+	// Returns the list of all accessible projects.
 	List(context.Context, *v2.ProjectServiceListRequest) (*v2.ProjectServiceListResponse, error)
-	// Get a project
+	// Returns the project with the specified UUID.
 	Get(context.Context, *v2.ProjectServiceGetRequest) (*v2.ProjectServiceGetResponse, error)
 	// Create a project
 	Create(context.Context, *v2.ProjectServiceCreateRequest) (*v2.ProjectServiceCreateResponse, error)
@@ -325,9 +325,9 @@ func (c *projectServiceClient) InviteGet(ctx context.Context, req *v2.ProjectSer
 
 // ProjectServiceHandler is an implementation of the metalstack.api.v2.ProjectService service.
 type ProjectServiceHandler interface {
-	// List all accessible projects
+	// Returns the list of all accessible projects.
 	List(context.Context, *v2.ProjectServiceListRequest) (*v2.ProjectServiceListResponse, error)
-	// Get a project
+	// Returns the project with the specified UUID.
 	Get(context.Context, *v2.ProjectServiceGetRequest) (*v2.ProjectServiceGetResponse, error)
 	// Create a project
 	Create(context.Context, *v2.ProjectServiceCreateRequest) (*v2.ProjectServiceCreateResponse, error)
diff --git a/go/metalstack/api/v2/apiv2connect/size.connect.go b/go/metalstack/api/v2/apiv2connect/size.connect.go
index 5c95f0ec..3c77a5df 100644
--- a/go/metalstack/api/v2/apiv2connect/size.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/size.connect.go
@@ -41,9 +41,9 @@ const (
 
 // SizeServiceClient is a client for the metalstack.api.v2.SizeService service.
 type SizeServiceClient interface {
-	// Get a size
+	// Returns the size with the specified ID.
 	Get(context.Context, *v2.SizeServiceGetRequest) (*v2.SizeServiceGetResponse, error)
-	// List all sizes
+	// Returns the list of all sizes.
 	List(context.Context, *v2.SizeServiceListRequest) (*v2.SizeServiceListResponse, error)
 }
 
@@ -99,9 +99,9 @@ func (c *sizeServiceClient) List(ctx context.Context, req *v2.SizeServiceListReq
 
 // SizeServiceHandler is an implementation of the metalstack.api.v2.SizeService service.
 type SizeServiceHandler interface {
-	// Get a size
+	// Returns the size with the specified ID.
 	Get(context.Context, *v2.SizeServiceGetRequest) (*v2.SizeServiceGetResponse, error)
-	// List all sizes
+	// Returns the list of all sizes.
 	List(context.Context, *v2.SizeServiceListRequest) (*v2.SizeServiceListResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/size_imageconstraint.connect.go b/go/metalstack/api/v2/apiv2connect/size_imageconstraint.connect.go
index 5db04365..c67d7f09 100644
--- a/go/metalstack/api/v2/apiv2connect/size_imageconstraint.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/size_imageconstraint.connect.go
@@ -42,7 +42,7 @@ const (
 // SizeImageConstraintServiceClient is a client for the metalstack.api.v2.SizeImageConstraintService
 // service.
 type SizeImageConstraintServiceClient interface {
-	// Try if a given combination of size and image is possible
+	// Try validates if a given combination of size and image is possible.
 	Try(context.Context, *v2.SizeImageConstraintServiceTryRequest) (*v2.SizeImageConstraintServiceTryResponse, error)
 }
 
@@ -84,7 +84,7 @@ func (c *sizeImageConstraintServiceClient) Try(ctx context.Context, req *v2.Size
 // SizeImageConstraintServiceHandler is an implementation of the
 // metalstack.api.v2.SizeImageConstraintService service.
 type SizeImageConstraintServiceHandler interface {
-	// Try if a given combination of size and image is possible
+	// Try validates if a given combination of size and image is possible.
 	Try(context.Context, *v2.SizeImageConstraintServiceTryRequest) (*v2.SizeImageConstraintServiceTryResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/size_reservation.connect.go b/go/metalstack/api/v2/apiv2connect/size_reservation.connect.go
index 0f6ea868..39240adf 100644
--- a/go/metalstack/api/v2/apiv2connect/size_reservation.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/size_reservation.connect.go
@@ -44,9 +44,9 @@ const (
 // SizeReservationServiceClient is a client for the metalstack.api.v2.SizeReservationService
 // service.
 type SizeReservationServiceClient interface {
-	// Get a size reservation
+	// Returns the size reservation with the specified ID.
 	Get(context.Context, *v2.SizeReservationServiceGetRequest) (*v2.SizeReservationServiceGetResponse, error)
-	// List size reservations
+	// Returns the list of size reservations.
 	List(context.Context, *v2.SizeReservationServiceListRequest) (*v2.SizeReservationServiceListResponse, error)
 }
 
@@ -103,9 +103,9 @@ func (c *sizeReservationServiceClient) List(ctx context.Context, req *v2.SizeRes
 // SizeReservationServiceHandler is an implementation of the
 // metalstack.api.v2.SizeReservationService service.
 type SizeReservationServiceHandler interface {
-	// Get a size reservation
+	// Returns the size reservation with the specified ID.
 	Get(context.Context, *v2.SizeReservationServiceGetRequest) (*v2.SizeReservationServiceGetResponse, error)
-	// List size reservations
+	// Returns the list of size reservations.
 	List(context.Context, *v2.SizeReservationServiceListRequest) (*v2.SizeReservationServiceListResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/tenant.connect.go b/go/metalstack/api/v2/apiv2connect/tenant.connect.go
index ba11f8a9..6721559b 100644
--- a/go/metalstack/api/v2/apiv2connect/tenant.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/tenant.connect.go
@@ -68,9 +68,9 @@ const (
 
 // TenantServiceClient is a client for the metalstack.api.v2.TenantService service.
 type TenantServiceClient interface {
-	// Create a tenant
+	// Creates a new tenant.
 	Create(context.Context, *v2.TenantServiceCreateRequest) (*v2.TenantServiceCreateResponse, error)
-	// List tenants
+	// Returns the list of tenants.
 	List(context.Context, *v2.TenantServiceListRequest) (*v2.TenantServiceListResponse, error)
 	// Get a tenant
 	Get(context.Context, *v2.TenantServiceGetRequest) (*v2.TenantServiceGetResponse, error)
@@ -324,9 +324,9 @@ func (c *tenantServiceClient) InviteGet(ctx context.Context, req *v2.TenantServi
 
 // TenantServiceHandler is an implementation of the metalstack.api.v2.TenantService service.
 type TenantServiceHandler interface {
-	// Create a tenant
+	// Creates a new tenant.
 	Create(context.Context, *v2.TenantServiceCreateRequest) (*v2.TenantServiceCreateResponse, error)
-	// List tenants
+	// Returns the list of tenants.
 	List(context.Context, *v2.TenantServiceListRequest) (*v2.TenantServiceListResponse, error)
 	// Get a tenant
 	Get(context.Context, *v2.TenantServiceGetRequest) (*v2.TenantServiceGetResponse, error)
diff --git a/go/metalstack/api/v2/apiv2connect/token.connect.go b/go/metalstack/api/v2/apiv2connect/token.connect.go
index 1488f2e1..b5eb7d0b 100644
--- a/go/metalstack/api/v2/apiv2connect/token.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/token.connect.go
@@ -49,17 +49,17 @@ const (
 
 // TokenServiceClient is a client for the metalstack.api.v2.TokenService service.
 type TokenServiceClient interface {
-	// Get a token
+	// Returns the token with the specified UUID.
 	Get(context.Context, *v2.TokenServiceGetRequest) (*v2.TokenServiceGetResponse, error)
-	// Create a token to authenticate against the platform, the secret will be only visible in the response.
+	// Creates a token to authenticate against the platform, the secret will be only visible in the response.
 	Create(context.Context, *v2.TokenServiceCreateRequest) (*v2.TokenServiceCreateResponse, error)
-	// Update a token
+	// Updates a token.
 	Update(context.Context, *v2.TokenServiceUpdateRequest) (*v2.TokenServiceUpdateResponse, error)
-	// List all your tokens
+	// Returns the list of all user tokens.
 	List(context.Context, *v2.TokenServiceListRequest) (*v2.TokenServiceListResponse, error)
-	// Revoke a token, no further usage is possible afterwards
+	// Revokes a token, no further usage is possible afterwards.
 	Revoke(context.Context, *v2.TokenServiceRevokeRequest) (*v2.TokenServiceRevokeResponse, error)
-	// Refresh a token, this will create a new token with the exact same permissions as the calling token contains
+	// Refreshes a token, this will create a new token with the exact same permissions as the calling token contains.
 	Refresh(context.Context, *v2.TokenServiceRefreshRequest) (*v2.TokenServiceRefreshResponse, error)
 }
 
@@ -179,17 +179,17 @@ func (c *tokenServiceClient) Refresh(ctx context.Context, req *v2.TokenServiceRe
 
 // TokenServiceHandler is an implementation of the metalstack.api.v2.TokenService service.
 type TokenServiceHandler interface {
-	// Get a token
+	// Returns the token with the specified UUID.
 	Get(context.Context, *v2.TokenServiceGetRequest) (*v2.TokenServiceGetResponse, error)
-	// Create a token to authenticate against the platform, the secret will be only visible in the response.
+	// Creates a token to authenticate against the platform, the secret will be only visible in the response.
 	Create(context.Context, *v2.TokenServiceCreateRequest) (*v2.TokenServiceCreateResponse, error)
-	// Update a token
+	// Updates a token.
 	Update(context.Context, *v2.TokenServiceUpdateRequest) (*v2.TokenServiceUpdateResponse, error)
-	// List all your tokens
+	// Returns the list of all user tokens.
 	List(context.Context, *v2.TokenServiceListRequest) (*v2.TokenServiceListResponse, error)
-	// Revoke a token, no further usage is possible afterwards
+	// Revokes a token, no further usage is possible afterwards.
 	Revoke(context.Context, *v2.TokenServiceRevokeRequest) (*v2.TokenServiceRevokeResponse, error)
-	// Refresh a token, this will create a new token with the exact same permissions as the calling token contains
+	// Refreshes a token, this will create a new token with the exact same permissions as the calling token contains.
 	Refresh(context.Context, *v2.TokenServiceRefreshRequest) (*v2.TokenServiceRefreshResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/user.connect.go b/go/metalstack/api/v2/apiv2connect/user.connect.go
index 6399c994..4e862fd0 100644
--- a/go/metalstack/api/v2/apiv2connect/user.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/user.connect.go
@@ -39,7 +39,7 @@ const (
 
 // UserServiceClient is a client for the metalstack.api.v2.UserService service.
 type UserServiceClient interface {
-	// Get a User
+	// Returns the authenticated user.
 	Get(context.Context, *v2.UserServiceGetRequest) (*v2.UserServiceGetResponse, error)
 }
 
@@ -79,7 +79,7 @@ func (c *userServiceClient) Get(ctx context.Context, req *v2.UserServiceGetReque
 
 // UserServiceHandler is an implementation of the metalstack.api.v2.UserService service.
 type UserServiceHandler interface {
-	// Get a User
+	// Returns the authenticated user.
 	Get(context.Context, *v2.UserServiceGetRequest) (*v2.UserServiceGetResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/apiv2connect/version.connect.go b/go/metalstack/api/v2/apiv2connect/version.connect.go
index 3ab5ca15..cf1a81bf 100644
--- a/go/metalstack/api/v2/apiv2connect/version.connect.go
+++ b/go/metalstack/api/v2/apiv2connect/version.connect.go
@@ -39,7 +39,7 @@ const (
 
 // VersionServiceClient is a client for the metalstack.api.v2.VersionService service.
 type VersionServiceClient interface {
-	// Get the version
+	// Returns the version of the application.
 	Get(context.Context, *v2.VersionServiceGetRequest) (*v2.VersionServiceGetResponse, error)
 }
 
@@ -79,7 +79,7 @@ func (c *versionServiceClient) Get(ctx context.Context, req *v2.VersionServiceGe
 
 // VersionServiceHandler is an implementation of the metalstack.api.v2.VersionService service.
 type VersionServiceHandler interface {
-	// Get the version
+	// Returns the version of the application.
 	Get(context.Context, *v2.VersionServiceGetRequest) (*v2.VersionServiceGetResponse, error)
 }
 
diff --git a/go/metalstack/api/v2/audit.pb.go b/go/metalstack/api/v2/audit.pb.go
index 376cf788..8eed2080 100644
--- a/go/metalstack/api/v2/audit.pb.go
+++ b/go/metalstack/api/v2/audit.pb.go
@@ -23,7 +23,7 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// AuditPhase specifies phase of an audit trace
+// AuditPhase specifies the phase of an audit trace.
 type AuditPhase int32
 
 const (
@@ -31,7 +31,7 @@ const (
 	AuditPhase_AUDIT_PHASE_UNSPECIFIED AuditPhase = 0
 	// AUDIT_PHASE_REQUEST defines an audit trace in the request phase
 	AuditPhase_AUDIT_PHASE_REQUEST AuditPhase = 1
-	// AUDIT_PHASE_REQUEST defines an audit trace in the response phase
+	// AUDIT_PHASE_RESPONSE defines an audit trace in the response phase
 	AuditPhase_AUDIT_PHASE_RESPONSE AuditPhase = 2
 )
 
@@ -76,26 +76,26 @@ func (AuditPhase) EnumDescriptor() ([]byte, []int) {
 	return file_metalstack_api_v2_audit_proto_rawDescGZIP(), []int{0}
 }
 
-// AuditTrace is an audit trace
+// AuditTrace is an audit trace.
 type AuditTrace struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Uuid of the audit trace
 	Uuid string `protobuf:"bytes,1,opt,name=uuid,proto3" json:"uuid,omitempty"`
-	// Timestamp is the timestamp when the request arrived at the api
+	// Timestamp is the timestamp when the request arrived at the API
 	Timestamp *timestamppb.Timestamp `protobuf:"bytes,2,opt,name=timestamp,proto3" json:"timestamp,omitempty"`
-	// User is the login user who called the api method
+	// User is the login user who called the API method
 	User string `protobuf:"bytes,3,opt,name=user,proto3" json:"user,omitempty"`
-	// Tenant is the tenant targeted by the api call
+	// Tenant is the tenant targeted by the API call
 	Tenant string `protobuf:"bytes,4,opt,name=tenant,proto3" json:"tenant,omitempty"`
-	// Project is the project targeted by the api call
+	// Project is the project targeted by the API call
 	Project *string `protobuf:"bytes,5,opt,name=project,proto3,oneof" json:"project,omitempty"`
-	// Method is the api method that was called
+	// Method is the API method that was called
 	Method string `protobuf:"bytes,6,opt,name=method,proto3" json:"method,omitempty"`
-	// Body is the payload of the api call. In the request phase this contains the payload sent by the client, in the request phase it contains the payload returned by the api server
+	// Body is the payload of the API call. In the request phase this contains the payload sent by the client, in the response phase it contains the payload returned by the API server
 	Body *string `protobuf:"bytes,7,opt,name=body,proto3,oneof" json:"body,omitempty"`
-	// Source IP contains the source ip address of the api call
+	// SourceIP contains the source IP address of the API call
 	SourceIp string `protobuf:"bytes,8,opt,name=source_ip,json=sourceIp,proto3" json:"source_ip,omitempty"`
-	// Result Code is a status code describing the result of the api call. It is set for traces in the response phase and contains official gRPC status codes
+	// ResultCode is a status code describing the result of the API call. It is set for traces in the response phase and contains official gRPC status codes
 	ResultCode *int32 `protobuf:"varint,9,opt,name=result_code,json=resultCode,proto3,oneof" json:"result_code,omitempty"`
 	// Phase represents the phase of the audit trace
 	Phase         AuditPhase `protobuf:"varint,10,opt,name=phase,proto3,enum=metalstack.api.v2.AuditPhase" json:"phase,omitempty"`
diff --git a/go/metalstack/api/v2/health.pb.go b/go/metalstack/api/v2/health.pb.go
index a85d3b88..7b9d97ed 100644
--- a/go/metalstack/api/v2/health.pb.go
+++ b/go/metalstack/api/v2/health.pb.go
@@ -21,7 +21,7 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// ServiceStatus defines the status of a service
+// ServiceStatus defines the status of a service.
 type ServiceStatus int32
 
 const (
@@ -31,7 +31,7 @@ const (
 	ServiceStatus_SERVICE_STATUS_DEGRADED ServiceStatus = 1
 	// SERVICE_STATUS_UNHEALTHY the service is in unhealthy status, serious impact is expected
 	ServiceStatus_SERVICE_STATUS_UNHEALTHY ServiceStatus = 2
-	// SERVICE_STATUS_HEALTHY the service is in healthy status e.g. fully functional
+	// SERVICE_STATUS_HEALTHY the service is in healthy status, for example fully functional
 	ServiceStatus_SERVICE_STATUS_HEALTHY ServiceStatus = 3
 )
 
@@ -78,25 +78,25 @@ func (ServiceStatus) EnumDescriptor() ([]byte, []int) {
 	return file_metalstack_api_v2_health_proto_rawDescGZIP(), []int{0}
 }
 
-// Service defines the service for which the healtyness is reported
+// Service defines the service for which the healthiness is reported.
 type Service int32
 
 const (
 	// SERVICE_UNSPECIFIED is a unknown service
 	Service_SERVICE_UNSPECIFIED Service = 0
-	// SERVICE_IPAM the ipam service
+	// SERVICE_IPAM the IPAM service
 	Service_SERVICE_IPAM Service = 1
-	// SERVICE_RETHINK the rethinkdb
+	// SERVICE_RETHINK the RethinkDB
 	Service_SERVICE_RETHINK Service = 2
-	// SERVICE_MASTERDATA the masterdata-api
+	// SERVICE_MASTERDATA the masterdata API
 	Service_SERVICE_MASTERDATA Service = 3
 	// SERVICE_MACHINES the machine service
 	Service_SERVICE_MACHINES Service = 4
 	// SERVICE_AUDIT the auditing
 	Service_SERVICE_AUDIT Service = 5
-	// SERVICE_VPN the vpn service
+	// SERVICE_VPN the VPN service
 	Service_SERVICE_VPN Service = 6
-	// SERVICE_REDIS the redis service
+	// SERVICE_REDIS the Redis service
 	Service_SERVICE_REDIS Service = 7
 	// SERVICE_TASKS the tasks service
 	Service_SERVICE_TASKS Service = 8
@@ -155,10 +155,10 @@ func (Service) EnumDescriptor() ([]byte, []int) {
 	return file_metalstack_api_v2_health_proto_rawDescGZIP(), []int{1}
 }
 
-// Health reports the health status of all services
+// Health reports the health status of all services.
 type Health struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Services the health of all individual services
+	// Services contains the health of all individual services
 	Services      []*HealthStatus `protobuf:"bytes,1,rep,name=services,proto3" json:"services,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -201,12 +201,12 @@ func (x *Health) GetServices() []*HealthStatus {
 	return nil
 }
 
-// HealthStatus the health of one service
+// HealthStatus represents the health status of one service.
 type HealthStatus struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Name the name of the service
+	// Name is the name of the service
 	Name Service `protobuf:"varint,1,opt,name=name,proto3,enum=metalstack.api.v2.Service" json:"name,omitempty"`
-	// Status the status of this service
+	// Status is the status of this service
 	Status ServiceStatus `protobuf:"varint,2,opt,name=status,proto3,enum=metalstack.api.v2.ServiceStatus" json:"status,omitempty"`
 	// Message describes the reason for the unhealthy status if possible
 	Message string `protobuf:"bytes,3,opt,name=message,proto3" json:"message,omitempty"`
@@ -274,10 +274,10 @@ func (x *HealthStatus) GetPartitions() map[string]*PartitionHealth {
 	return nil
 }
 
-// PartitionHealth the status of a specific service in this partition
+// PartitionHealth represents the status of a specific service in this partition.
 type PartitionHealth struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Status the health status of the service in this partition
+	// Status is the health status of the service in this partition
 	Status ServiceStatus `protobuf:"varint,1,opt,name=status,proto3,enum=metalstack.api.v2.ServiceStatus" json:"status,omitempty"`
 	// Message describes the reason for the unhealthy status if possible
 	Message       string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
@@ -329,7 +329,7 @@ func (x *PartitionHealth) GetMessage() string {
 	return ""
 }
 
-// HealthServiceGetRequest is request payload to get the health of the system
+// HealthServiceGetRequest is the request payload for getting the health of the system.
 type HealthServiceGetRequest struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
 	unknownFields protoimpl.UnknownFields
@@ -366,10 +366,10 @@ func (*HealthServiceGetRequest) Descriptor() ([]byte, []int) {
 	return file_metalstack_api_v2_health_proto_rawDescGZIP(), []int{3}
 }
 
-// HealthServiceGetRequest is the response payload with the health of the system
+// HealthServiceGetResponse is the response payload for getting the health of the system.
 type HealthServiceGetResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Health is the overall health of the system
+	// Health contains the overall health of the system
 	Health        *Health `protobuf:"bytes,1,opt,name=health,proto3" json:"health,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/api/v2/machine.pb.go b/go/metalstack/api/v2/machine.pb.go
index d6024ba2..2399f65c 100644
--- a/go/metalstack/api/v2/machine.pb.go
+++ b/go/metalstack/api/v2/machine.pb.go
@@ -4252,7 +4252,7 @@ const file_metalstack_api_v2_machine_proto_rawDesc = "" +
 	"\x05image\x18\b \x01(\tB\b\xbaH\x05r\x03\x18\x80\x01R\x05image\x120\n" +
 	"\x11filesystem_layout\x18\t \x01(\tH\x03R\x10filesystemLayout\x88\x01\x01\x12?\n" +
 	"\x0fssh_public_keys\x18\n" +
-	" \x03(\tB\x17\xbaH\x14\x92\x01\x11Ȥ\xb3\xb1\x02\x01\x102\"\ar\x05\x10\x01\x18\x80@R\rsshPublicKeys\x120\n" +
+	" \x03(\tB\x17\xbaH\x14\x92\x01\x11Ф\xb3\xb1\x02\x01\x102\"\ar\x05\x10\x01\x18\x80@R\rsshPublicKeys\x120\n" +
 	"\buserdata\x18\v \x01(\tB\x0f\xbaH\fr\n" +
 	"\U00033bb1\x02\x01\x18\x80\x80\x02H\x04R\buserdata\x88\x01\x01\x121\n" +
 	"\x06labels\x18\f \x01(\v2\x19.metalstack.api.v2.LabelsR\x06labels\x12G\n" +
@@ -4282,7 +4282,7 @@ const file_metalstack_api_v2_machine_proto_rawDesc = "" +
 	"\aproject\x18\x03 \x01(\tB\b\xbaH\x05r\x03\xb0\x01\x01R\aproject\x122\n" +
 	"\vdescription\x18\x04 \x01(\tB\v\xbaH\br\x06ȳ\xae\xb1\x02\x01H\x00R\vdescription\x88\x01\x01\x12<\n" +
 	"\x06labels\x18\x05 \x01(\v2\x1f.metalstack.api.v2.UpdateLabelsH\x01R\x06labels\x88\x01\x01\x12?\n" +
-	"\x0fssh_public_keys\x18\x06 \x03(\tB\x17\xbaH\x14\x92\x01\x11Ȥ\xb3\xb1\x02\x01\x102\"\ar\x05\x10\x01\x18\x80@R\rsshPublicKeysB\x0e\n" +
+	"\x0fssh_public_keys\x18\x06 \x03(\tB\x17\xbaH\x14\x92\x01\x11Ф\xb3\xb1\x02\x01\x102\"\ar\x05\x10\x01\x18\x80@R\rsshPublicKeysB\x0e\n" +
 	"\f_descriptionB\t\n" +
 	"\a_labels\"T\n" +
 	"\x1cMachineServiceUpdateResponse\x124\n" +
@@ -4344,7 +4344,7 @@ const file_metalstack_api_v2_machine_proto_rawDesc = "" +
 	"\bnetworks\x18\t \x03(\v2!.metalstack.api.v2.MachineNetworkR\bnetworks\x12#\n" +
 	"\bhostname\x18\n" +
 	" \x01(\tB\a\xbaH\x04r\x02h\x01R\bhostname\x12?\n" +
-	"\x0fssh_public_keys\x18\v \x03(\tB\x17\xbaH\x14\x92\x01\x11Ȥ\xb3\xb1\x02\x01\x102\"\ar\x05\x10\x01\x18\x80@R\rsshPublicKeys\x12+\n" +
+	"\x0fssh_public_keys\x18\v \x03(\tB\x17\xbaH\x14\x92\x01\x11Ф\xb3\xb1\x02\x01\x102\"\ar\x05\x10\x01\x18\x80@R\rsshPublicKeys\x12+\n" +
 	"\buserdata\x18\f \x01(\tB\x0f\xbaH\fr\n" +
 	"\U00033bb1\x02\x01\x18\x80\x80\x02R\buserdata\x12[\n" +
 	"\x0fallocation_type\x18\r \x01(\x0e2(.metalstack.api.v2.MachineAllocationTypeB\b\xbaH\x05\x82\x01\x02\x10\x01R\x0eallocationType\x12G\n" +
diff --git a/go/metalstack/api/v2/method.pb.go b/go/metalstack/api/v2/method.pb.go
index f24268a7..15303aa8 100644
--- a/go/metalstack/api/v2/method.pb.go
+++ b/go/metalstack/api/v2/method.pb.go
@@ -22,7 +22,7 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// MethodServiceListRequest is the request payload to list all public methods
+// MethodServiceListRequest is the request payload for listing all public methods.
 type MethodServiceListRequest struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
 	unknownFields protoimpl.UnknownFields
@@ -59,7 +59,7 @@ func (*MethodServiceListRequest) Descriptor() ([]byte, []int) {
 	return file_metalstack_api_v2_method_proto_rawDescGZIP(), []int{0}
 }
 
-// MethodServiceListResponse is the response payload with all public visible methods
+// MethodServiceListResponse is the response payload for listing all public methods.
 type MethodServiceListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Methods is a list of methods public callable
@@ -105,7 +105,7 @@ func (x *MethodServiceListResponse) GetMethods() []string {
 	return nil
 }
 
-// MethodServiceTokenScopedListRequest is the request payload to list all methods callable with the token present in the request
+// MethodServiceTokenScopedListRequest is the request payload for listing all methods callable with the token present in the request.
 type MethodServiceTokenScopedListRequest struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
 	unknownFields protoimpl.UnknownFields
@@ -142,14 +142,14 @@ func (*MethodServiceTokenScopedListRequest) Descriptor() ([]byte, []int) {
 	return file_metalstack_api_v2_method_proto_rawDescGZIP(), []int{2}
 }
 
-// MethodServiceTokenScopedListResponse is the response payload which contains all methods which are callable with the given token
+// MethodServiceTokenScopedListResponse is the response payload which contains all methods which are callable with the given token.
 type MethodServiceTokenScopedListResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Permissions a list of methods which can be called
+	// Permissions contains a list of methods which can be called
 	Permissions []*MethodPermission `protobuf:"bytes,1,rep,name=permissions,proto3" json:"permissions,omitempty"`
-	// ProjectRoles associates a project id with the corresponding role of the token owner
+	// ProjectRoles associates a project ID with the corresponding role of the token owner
 	ProjectRoles map[string]ProjectRole `protobuf:"bytes,2,rep,name=project_roles,json=projectRoles,proto3" json:"project_roles,omitempty" protobuf_key:"bytes,1,opt,name=key" protobuf_val:"varint,2,opt,name=value,enum=metalstack.api.v2.ProjectRole"`
-	// TenantRoles associates a tenant id with the corresponding role of the token owner
+	// TenantRoles associates a tenant ID with the corresponding role of the token owner
 	TenantRoles map[string]TenantRole `protobuf:"bytes,3,rep,name=tenant_roles,json=tenantRoles,proto3" json:"tenant_roles,omitempty" protobuf_key:"bytes,1,opt,name=key" protobuf_val:"varint,2,opt,name=value,enum=metalstack.api.v2.TenantRole"`
 	// AdminRole defines the admin role of the token owner
 	AdminRole *AdminRole `protobuf:"varint,4,opt,name=admin_role,json=adminRole,proto3,enum=metalstack.api.v2.AdminRole,oneof" json:"admin_role,omitempty"`
diff --git a/go/metalstack/api/v2/partition.pb.go b/go/metalstack/api/v2/partition.pb.go
index 00856893..67d223f8 100644
--- a/go/metalstack/api/v2/partition.pb.go
+++ b/go/metalstack/api/v2/partition.pb.go
@@ -522,7 +522,7 @@ var File_metalstack_api_v2_partition_proto protoreflect.FileDescriptor
 
 const file_metalstack_api_v2_partition_proto_rawDesc = "" +
 	"\n" +
-	"!metalstack/api/v2/partition.proto\x12\x11metalstack.api.v2\x1a\x1bbuf/validate/validate.proto\x1a\x1emetalstack/api/v2/common.proto\x1a(metalstack/api/v2/predefined_rules.proto\"\xaa\x03\n" +
+	"!metalstack/api/v2/partition.proto\x12\x11metalstack.api.v2\x1a\x1bbuf/validate/validate.proto\x1a\x1emetalstack/api/v2/common.proto\x1a(metalstack/api/v2/predefined_rules.proto\"\xb8\x03\n" +
 	"\tPartition\x12\x1b\n" +
 	"\x02id\x18\x01 \x01(\tB\v\xbaH\br\x06г\xae\xb1\x02\x01R\x02id\x12+\n" +
 	"\x04meta\x18\x02 \x01(\v2\x17.metalstack.api.v2.MetaR\x04meta\x12-\n" +
@@ -532,8 +532,8 @@ const file_metalstack_api_v2_partition_proto_rawDesc = "" +
 	"dnsServers\x12G\n" +
 	"\vntp_servers\x18\x06 \x03(\v2\x1c.metalstack.api.v2.NTPServerB\b\xbaH\x05\x92\x01\x02\x10\n" +
 	"R\n" +
-	"ntpServers\x124\n" +
-	"\x16mgmt_service_addresses\x18\a \x03(\tR\x14mgmtServiceAddresses\"|\n" +
+	"ntpServers\x12B\n" +
+	"\x16mgmt_service_addresses\x18\a \x03(\tB\f\xbaH\t\x92\x01\x06Ȥ\xb3\xb1\x02\x01R\x14mgmtServiceAddresses\"|\n" +
 	"\x0ePartitionQuery\x12 \n" +
 	"\x02id\x18\x01 \x01(\tB\v\xbaH\br\x06г\xae\xb1\x02\x01H\x00R\x02id\x88\x01\x01\x126\n" +
 	"\x06labels\x18\x02 \x01(\v2\x19.metalstack.api.v2.LabelsH\x01R\x06labels\x88\x01\x01B\x05\n" +
diff --git a/go/metalstack/api/v2/predefined_rules.pb.go b/go/metalstack/api/v2/predefined_rules.pb.go
index fabce2f8..46770b2e 100644
--- a/go/metalstack/api/v2/predefined_rules.pb.go
+++ b/go/metalstack/api/v2/predefined_rules.pb.go
@@ -106,8 +106,16 @@ var file_metalstack_api_v2_predefined_rules_proto_extTypes = []protoimpl.Extensi
 		ExtendedType:  (*validate.RepeatedRules)(nil),
 		ExtensionType: (*bool)(nil),
 		Field:         80058953,
+		Name:          "metalstack.api.v2.are_host_and_port",
+		Tag:           "varint,80058953,opt,name=are_host_and_port",
+		Filename:      "metalstack/api/v2/predefined_rules.proto",
+	},
+	{
+		ExtendedType:  (*validate.RepeatedRules)(nil),
+		ExtensionType: (*bool)(nil),
+		Field:         80058954,
 		Name:          "metalstack.api.v2.all_trimmed",
-		Tag:           "varint,80058953,opt,name=all_trimmed",
+		Tag:           "varint,80058954,opt,name=all_trimmed",
 		Filename:      "metalstack/api/v2/predefined_rules.proto",
 	},
 }
@@ -142,7 +150,7 @@ var (
 	//
 	// optional bool is_ip_or_hostname = 80048957;
 	E_IsIpOrHostname = &file_metalstack_api_v2_predefined_rules_proto_extTypes[6]
-	// Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end.
+	// Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end
 	//
 	// optional bool trimmed = 80048958;
 	E_Trimmed = &file_metalstack_api_v2_predefined_rules_proto_extTypes[7]
@@ -158,10 +166,14 @@ var (
 	//
 	// optional bool ips = 80058952;
 	E_Ips = &file_metalstack_api_v2_predefined_rules_proto_extTypes[9]
-	// All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end.
+	// AreHostAndPort validates if a slice of strings are all in the form of <ip | host>:<port>
+	//
+	// optional bool are_host_and_port = 80058953;
+	E_AreHostAndPort = &file_metalstack_api_v2_predefined_rules_proto_extTypes[10]
+	// All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end
 	//
-	// optional bool all_trimmed = 80058953;
-	E_AllTrimmed = &file_metalstack_api_v2_predefined_rules_proto_extTypes[10]
+	// optional bool all_trimmed = 80058954;
+	E_AllTrimmed = &file_metalstack_api_v2_predefined_rules_proto_extTypes[11]
 )
 
 var File_metalstack_api_v2_predefined_rules_proto protoreflect.FileDescriptor
@@ -201,8 +213,11 @@ const file_metalstack_api_v2_predefined_rules_proto_rawDesc = "" +
 	"\x11repeated.prefixes\x12\x1cgiven prefixes must be valid\x1a\x1bthis.all(m, m.isIpPrefix())R\bprefixes:u\n" +
 	"\x03ips\x12\x1b.buf.validate.RepeatedRules\x18ȴ\x96& \x01(\bBC\xc2H@\n" +
 	">\n" +
-	"\frepeated.ips\x12\x17given ips must be valid\x1a\x15this.all(m, m.isIp())R\x03ips:\xba\x01\n" +
-	"\vall_trimmed\x12\x1b.buf.validate.RepeatedRules\x18ɴ\x96& \x01(\bBy\xc2Hv\n" +
+	"\frepeated.ips\x12\x17given ips must be valid\x1a\x15this.all(m, m.isIp())R\x03ips:\xe6\x01\n" +
+	"\x11are_host_and_port\x12\x1b.buf.validate.RepeatedRules\x18ɴ\x96& \x01(\bB\x9a\x01\xc2H\x96\x01\n" +
+	"\x93\x01\n" +
+	"\x1arepeated.are_host_and_port\x12Pgiven entries must all be in the form of <ip | host>:<port> but port is optional\x1a#this.all(m, m.isHostAndPort(false))R\x0eareHostAndPort:\xba\x01\n" +
+	"\vall_trimmed\x12\x1b.buf.validate.RepeatedRules\x18ʴ\x96& \x01(\bBy\xc2Hv\n" +
 	"t\n" +
 	"\x14repeated.all_trimmed\x122given values must not start or end with whitespace\x1a(this.all(m, m.trim().size() == m.size())R\n" +
 	"allTrimmedB\xca\x01\n" +
@@ -223,11 +238,12 @@ var file_metalstack_api_v2_predefined_rules_proto_depIdxs = []int32{
 	0,  // 7: metalstack.api.v2.trimmed:extendee -> buf.validate.StringRules
 	1,  // 8: metalstack.api.v2.prefixes:extendee -> buf.validate.RepeatedRules
 	1,  // 9: metalstack.api.v2.ips:extendee -> buf.validate.RepeatedRules
-	1,  // 10: metalstack.api.v2.all_trimmed:extendee -> buf.validate.RepeatedRules
-	11, // [11:11] is the sub-list for method output_type
-	11, // [11:11] is the sub-list for method input_type
-	11, // [11:11] is the sub-list for extension type_name
-	0,  // [0:11] is the sub-list for extension extendee
+	1,  // 10: metalstack.api.v2.are_host_and_port:extendee -> buf.validate.RepeatedRules
+	1,  // 11: metalstack.api.v2.all_trimmed:extendee -> buf.validate.RepeatedRules
+	12, // [12:12] is the sub-list for method output_type
+	12, // [12:12] is the sub-list for method input_type
+	12, // [12:12] is the sub-list for extension type_name
+	0,  // [0:12] is the sub-list for extension extendee
 	0,  // [0:0] is the sub-list for field type_name
 }
 
@@ -243,7 +259,7 @@ func file_metalstack_api_v2_predefined_rules_proto_init() {
 			RawDescriptor: unsafe.Slice(unsafe.StringData(file_metalstack_api_v2_predefined_rules_proto_rawDesc), len(file_metalstack_api_v2_predefined_rules_proto_rawDesc)),
 			NumEnums:      0,
 			NumMessages:   0,
-			NumExtensions: 11,
+			NumExtensions: 12,
 			NumServices:   0,
 		},
 		GoTypes:           file_metalstack_api_v2_predefined_rules_proto_goTypes,
diff --git a/go/metalstack/api/v2/user.pb.go b/go/metalstack/api/v2/user.pb.go
index 5bec46d7..ec8847fa 100644
--- a/go/metalstack/api/v2/user.pb.go
+++ b/go/metalstack/api/v2/user.pb.go
@@ -22,10 +22,10 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// User is a end user of the platform
+// User represents an end user of the platform.
 type User struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Login the login at the provider
+	// Login is the login at the provider
 	Login string `protobuf:"bytes,1,opt,name=login,proto3" json:"login,omitempty"`
 	// Name of the user
 	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
@@ -122,7 +122,7 @@ func (x *User) GetDefaultTenant() *Tenant {
 	return nil
 }
 
-// UserServiceGetRequest is the request to get the user
+// UserServiceGetRequest is the request payload for getting the user.
 type UserServiceGetRequest struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
 	unknownFields protoimpl.UnknownFields
@@ -159,10 +159,10 @@ func (*UserServiceGetRequest) Descriptor() ([]byte, []int) {
 	return file_metalstack_api_v2_user_proto_rawDescGZIP(), []int{1}
 }
 
-// UserServiceGetResponse the response when userservice get request was called
+// UserServiceGetResponse is the response payload for getting the user.
 type UserServiceGetResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// User is the user
+	// User contains the authenticated user
 	User          *User `protobuf:"bytes,1,opt,name=user,proto3" json:"user,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/api/v2/version.pb.go b/go/metalstack/api/v2/version.pb.go
index 9c7c8713..c994a555 100644
--- a/go/metalstack/api/v2/version.pb.go
+++ b/go/metalstack/api/v2/version.pb.go
@@ -22,7 +22,7 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// Version of the application
+// Version represents the version of the application.
 type Version struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Version of the application
@@ -95,7 +95,7 @@ func (x *Version) GetBuildDate() string {
 	return ""
 }
 
-// VersionServiceGetRequest is the request payload to get the version
+// VersionServiceGetRequest is the request payload for getting the version.
 type VersionServiceGetRequest struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
 	unknownFields protoimpl.UnknownFields
@@ -132,10 +132,10 @@ func (*VersionServiceGetRequest) Descriptor() ([]byte, []int) {
 	return file_metalstack_api_v2_version_proto_rawDescGZIP(), []int{1}
 }
 
-// VersionServiceGetResponse is the response payload with the version
+// VersionServiceGetResponse is the response payload for getting the version.
 type VersionServiceGetResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Version of the application
+	// Version contains the version of the application
 	Version       *Version `protobuf:"bytes,1,opt,name=version,proto3" json:"version,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/api/v2/vpn.pb.go b/go/metalstack/api/v2/vpn.pb.go
index bcd2e772..65e7f674 100644
--- a/go/metalstack/api/v2/vpn.pb.go
+++ b/go/metalstack/api/v2/vpn.pb.go
@@ -22,18 +22,18 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// VPNNode is a machine connected to the vpn
+// VPNNode represents a machine connected to the VPN.
 type VPNNode struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Id of this node
+	// ID of this node
 	Id uint64 `protobuf:"varint,1,opt,name=id,proto3" json:"id,omitempty"`
 	// Name of this node
 	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
 	// Project of this node, maps to a project
 	Project string `protobuf:"bytes,3,opt,name=project,proto3" json:"project,omitempty"`
-	// IPAddresses of this node in the vpn
+	// IPAddresses of this node in the VPN
 	IpAddresses []string `protobuf:"bytes,4,rep,name=ip_addresses,json=ipAddresses,proto3" json:"ip_addresses,omitempty"`
-	// LastSeen timestamp when this node reached out the the control plane
+	// LastSeen timestamp when this node reached out to the control plane
 	LastSeen *timestamppb.Timestamp `protobuf:"bytes,5,opt,name=last_seen,json=lastSeen,proto3" json:"last_seen,omitempty"`
 	// Online indicates if this node is online
 	Online        bool `protobuf:"varint,6,opt,name=online,proto3" json:"online,omitempty"`
diff --git a/go/metalstack/infra/v2/bmc.pb.go b/go/metalstack/infra/v2/bmc.pb.go
index 26e7bf82..1eb40d8c 100644
--- a/go/metalstack/infra/v2/bmc.pb.go
+++ b/go/metalstack/infra/v2/bmc.pb.go
@@ -23,12 +23,12 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// UpdateBMCInfoRequest
+// UpdateBMCInfoRequest is the request payload for updating BMC information.
 type UpdateBMCInfoRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Partition the partition id where metal-bmc wants to receive events
+	// Partition is the partition ID where metal-bmc wants to receive events
 	Partition string `protobuf:"bytes,1,opt,name=partition,proto3" json:"partition,omitempty"`
-	// BmcReports contains maps the bmc report per machine uuid
+	// BmcReports contains maps the BMC report per machine UUID
 	BmcReports    map[string]*v2.MachineBMCReport `protobuf:"bytes,2,rep,name=bmc_reports,json=bmcReports,proto3" json:"bmc_reports,omitempty" protobuf_key:"bytes,1,opt,name=key" protobuf_val:"bytes,2,opt,name=value"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -78,12 +78,12 @@ func (x *UpdateBMCInfoRequest) GetBmcReports() map[string]*v2.MachineBMCReport {
 	return nil
 }
 
-// UpdateBMCInfoResponse
+// UpdateBMCInfoResponse is the response payload for updating BMC information.
 type UpdateBMCInfoResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// UpdatedMachines is a slice of machine uuids which were updated
+	// UpdatedMachines is a slice of machine UUIDs which were updated
 	UpdatedMachines []string `protobuf:"bytes,1,rep,name=updated_machines,json=updatedMachines,proto3" json:"updated_machines,omitempty"`
-	// CreatedMachines is a slice of machine uuids which were created
+	// CreatedMachines is a slice of machine UUIDs which were created
 	CreatedMachines []string `protobuf:"bytes,2,rep,name=created_machines,json=createdMachines,proto3" json:"created_machines,omitempty"`
 	unknownFields   protoimpl.UnknownFields
 	sizeCache       protoimpl.SizeCache
@@ -133,10 +133,10 @@ func (x *UpdateBMCInfoResponse) GetCreatedMachines() []string {
 	return nil
 }
 
-// WaitForBMCCommandRequest
+// WaitForBMCCommandRequest is the request payload for waiting for a BMC command.
 type WaitForBMCCommandRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Partition the partition id where metal-bmc wants to receive bmc commands
+	// Partition is the partition ID where metal-bmc wants to receive BMC commands
 	Partition     string `protobuf:"bytes,1,opt,name=partition,proto3" json:"partition,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -179,17 +179,17 @@ func (x *WaitForBMCCommandRequest) GetPartition() string {
 	return ""
 }
 
-// WaitForBMCCommandResponse
+// WaitForBMCCommandResponse is the response payload for waiting for a BMC command.
 type WaitForBMCCommandResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// UUID of the machine to send the command to
 	Uuid string `protobuf:"bytes,1,opt,name=uuid,proto3" json:"uuid,omitempty"`
-	// BmcCommand to execute against the bmc of the machine
+	// BmcCommand to execute against the BMC of the machine
 	BmcCommand v2.MachineBMCCommand `protobuf:"varint,2,opt,name=bmc_command,json=bmcCommand,proto3,enum=metalstack.api.v2.MachineBMCCommand" json:"bmc_command,omitempty"`
-	// MachineBmc contains connection details of the machine to issue the bmcCommand to
+	// MachineBmc contains connection details of the machine to issue the BMC command to
 	MachineBmc *v2.MachineBMC `protobuf:"bytes,3,opt,name=machine_bmc,json=machineBmc,proto3" json:"machine_bmc,omitempty"`
 	// CommandId is a unique ID which must be sent back after execution
-	// it is usually in the form: <machine-uuid>:machine-bmc-command:<command>
+	// It is usually in the form: <machine-uuid>:machine-bmc-command:<command>
 	CommandId     string `protobuf:"bytes,4,opt,name=command_id,json=commandId,proto3" json:"command_id,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -253,11 +253,11 @@ func (x *WaitForBMCCommandResponse) GetCommandId() string {
 	return ""
 }
 
-// BMCCommandDoneRequest must be returned after command execution
+// BMCCommandDoneRequest must be returned after command execution.
 type BMCCommandDoneRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// CommandId is a unique ID which must be sent back after execution
-	// it is usually in the form: <machine-uuid>:machine-bmc-command
+	// It is usually in the form: <machine-uuid>:machine-bmc-command
 	CommandId string `protobuf:"bytes,1,opt,name=command_id,json=commandId,proto3" json:"command_id,omitempty"`
 	// Error of the command execution, nil if it was successful
 	Error         *string `protobuf:"bytes,2,opt,name=error,proto3,oneof" json:"error,omitempty"`
@@ -309,7 +309,7 @@ func (x *BMCCommandDoneRequest) GetError() string {
 	return ""
 }
 
-// BMCCommandDoneResponse
+// BMCCommandDoneResponse is the response payload for BMC command completion.
 type BMCCommandDoneResponse struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
 	unknownFields protoimpl.UnknownFields
diff --git a/go/metalstack/infra/v2/component.pb.go b/go/metalstack/infra/v2/component.pb.go
index 8214cb0b..7dffdf51 100644
--- a/go/metalstack/infra/v2/component.pb.go
+++ b/go/metalstack/infra/v2/component.pb.go
@@ -25,18 +25,16 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// ComponentServicePingRequest is sent from a microservice to report its state regularly
+// ComponentServicePingRequest is the request payload for pinging a microservice.
 type ComponentServicePingRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
 	// Type defines which service is actually pinging
 	Type v2.ComponentType `protobuf:"varint,1,opt,name=type,proto3,enum=metalstack.api.v2.ComponentType" json:"type,omitempty"`
-	// Identifier is a unique identifier of this service, e.g. if two instance are running, this might be the pod id.
-	// micro_service and identifier guarantee uniqueness.
+	// Identifier is a unique identifier of this service, for example if two instances are running, this might be the pod ID
 	Identifier string `protobuf:"bytes,2,opt,name=identifier,proto3" json:"identifier,omitempty"`
-	// StartedAt is the timestamp this service was started.
+	// StartedAt is the timestamp this service was started
 	StartedAt *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=started_at,json=startedAt,proto3" json:"started_at,omitempty"`
-	// Interval at which the ping is scheduled, must be between 5 seconds and 1 hour.
-	// Also gets validated in the same way in go/client/ping.go.
+	// Interval at which the ping is scheduled, must be between 5 seconds and 1 hour
 	Interval *durationpb.Duration `protobuf:"bytes,4,opt,name=interval,proto3" json:"interval,omitempty"`
 	// Version of this service
 	Version       *v2.Version `protobuf:"bytes,5,opt,name=version,proto3" json:"version,omitempty"`
@@ -109,7 +107,7 @@ func (x *ComponentServicePingRequest) GetVersion() *v2.Version {
 	return nil
 }
 
-// ComponentServicePingResponse is the response to a ping request
+// ComponentServicePingResponse is the response payload for pinging a microservice.
 type ComponentServicePingResponse struct {
 	state         protoimpl.MessageState `protogen:"open.v1"`
 	unknownFields protoimpl.UnknownFields
diff --git a/go/metalstack/infra/v2/event.pb.go b/go/metalstack/infra/v2/event.pb.go
index 353e7029..d83e200f 100644
--- a/go/metalstack/infra/v2/event.pb.go
+++ b/go/metalstack/infra/v2/event.pb.go
@@ -28,29 +28,29 @@ const (
 type ProvisioningEventType int32
 
 const (
-	// PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified.
+	// PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_UNSPECIFIED ProvisioningEventType = 0
-	// PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago.
+	// PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_ALIVE ProvisioningEventType = 1
-	// PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle.
+	// PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_CRASHED ProvisioningEventType = 2
-	// PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE.
+	// PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_PXE_BOOTING ProvisioningEventType = 3
-	// PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot.
+	// PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_PLANNED_REBOOT ProvisioningEventType = 4
-	// PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started.
+	// PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_PREPARING ProvisioningEventType = 5
-	// PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API.
+	// PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_REGISTERING ProvisioningEventType = 6
-	// PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation.
+	// PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_WAITING ProvisioningEventType = 7
-	// PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed.
+	// PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_INSTALLING ProvisioningEventType = 8
-	// PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS.
+	// PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL ProvisioningEventType = 9
-	// PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness.
+	// PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_PHONED_HOME ProvisioningEventType = 10
-	// PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines.
+	// PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines
 	ProvisioningEventType_PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM ProvisioningEventType = 11
 )
 
@@ -113,10 +113,10 @@ func (ProvisioningEventType) EnumDescriptor() ([]byte, []int) {
 	return file_metalstack_infra_v2_event_proto_rawDescGZIP(), []int{0}
 }
 
-// EventServiceSendRequest.
+// EventServiceSendRequest is the request payload for sending provisioning events.
 type EventServiceSendRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Events grouped by machine IDs.
+	// Events grouped by machine IDs
 	Events        map[string]*MachineProvisioningEvent `protobuf:"bytes,1,rep,name=events,proto3" json:"events,omitempty" protobuf_key:"bytes,1,opt,name=key" protobuf_val:"bytes,2,opt,name=value"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -159,12 +159,12 @@ func (x *EventServiceSendRequest) GetEvents() map[string]*MachineProvisioningEve
 	return nil
 }
 
-// EventServiceSendResponse.
+// EventServiceSendResponse is the response payload for sending provisioning events.
 type EventServiceSendResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Events counts the number of events successfully stored in the database.
+	// Events counts the number of events successfully stored in the database
 	Events uint64 `protobuf:"varint,1,opt,name=events,proto3" json:"events,omitempty"`
-	// Failed contains IDs of all machines whose events could not be stored in the database.
+	// Failed contains IDs of all machines whose events could not be stored in the database
 	Failed        []string `protobuf:"bytes,2,rep,name=failed,proto3" json:"failed,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -217,11 +217,11 @@ func (x *EventServiceSendResponse) GetFailed() []string {
 // MachineProvisioningEvent contains details about an event.
 type MachineProvisioningEvent struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Time the event occurred at.
+	// Time the event occurred at
 	Time *timestamppb.Timestamp `protobuf:"bytes,1,opt,name=time,proto3" json:"time,omitempty"`
-	// Event that occurred.
+	// Event that occurred
 	Event ProvisioningEventType `protobuf:"varint,2,opt,name=event,proto3,enum=metalstack.infra.v2.ProvisioningEventType" json:"event,omitempty"`
-	// Message describing the event in more detail.
+	// Message describes the event in more detail
 	Message       string `protobuf:"bytes,3,opt,name=message,proto3" json:"message,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/go/metalstack/infra/v2/infrav2connect/bmc.connect.go b/go/metalstack/infra/v2/infrav2connect/bmc.connect.go
index 0a2c93c0..9200e995 100644
--- a/go/metalstack/infra/v2/infrav2connect/bmc.connect.go
+++ b/go/metalstack/infra/v2/infrav2connect/bmc.connect.go
@@ -46,11 +46,11 @@ const (
 
 // BMCServiceClient is a client for the metalstack.infra.v2.BMCService service.
 type BMCServiceClient interface {
-	// UpdateBMCInfo
+	// Updates BMC information.
 	UpdateBMCInfo(context.Context, *v2.UpdateBMCInfoRequest) (*v2.UpdateBMCInfoResponse, error)
-	// WaitForBMCCommand is called by the metal-bmc and is returned with a bmc command to execute.
+	// WaitForBMCCommand is called by the metal-bmc and returns a BMC command to execute.
 	WaitForBMCCommand(context.Context, *v2.WaitForBMCCommandRequest) (*connect.ServerStreamForClient[v2.WaitForBMCCommandResponse], error)
-	// BMCCommandDone must be called from metal-bmc after the command execution
+	// BMCCommandDone must be called from metal-bmc after the command execution.
 	BMCCommandDone(context.Context, *v2.BMCCommandDoneRequest) (*v2.BMCCommandDoneResponse, error)
 }
 
@@ -118,11 +118,11 @@ func (c *bMCServiceClient) BMCCommandDone(ctx context.Context, req *v2.BMCComman
 
 // BMCServiceHandler is an implementation of the metalstack.infra.v2.BMCService service.
 type BMCServiceHandler interface {
-	// UpdateBMCInfo
+	// Updates BMC information.
 	UpdateBMCInfo(context.Context, *v2.UpdateBMCInfoRequest) (*v2.UpdateBMCInfoResponse, error)
-	// WaitForBMCCommand is called by the metal-bmc and is returned with a bmc command to execute.
+	// WaitForBMCCommand is called by the metal-bmc and returns a BMC command to execute.
 	WaitForBMCCommand(context.Context, *v2.WaitForBMCCommandRequest, *connect.ServerStream[v2.WaitForBMCCommandResponse]) error
-	// BMCCommandDone must be called from metal-bmc after the command execution
+	// BMCCommandDone must be called from metal-bmc after the command execution.
 	BMCCommandDone(context.Context, *v2.BMCCommandDoneRequest) (*v2.BMCCommandDoneResponse, error)
 }
 
diff --git a/go/metalstack/infra/v2/infrav2connect/boot.connect.go b/go/metalstack/infra/v2/infrav2connect/boot.connect.go
index 440c5234..497b49ae 100644
--- a/go/metalstack/infra/v2/infrav2connect/boot.connect.go
+++ b/go/metalstack/infra/v2/infrav2connect/boot.connect.go
@@ -51,17 +51,17 @@ const (
 
 // BootServiceClient is a client for the metalstack.infra.v2.BootService service.
 type BootServiceClient interface {
-	// Dhcp is the first dhcp request (option 97). A ProvisioningEventPXEBooting is fired
+	// Dhcp handles the first DHCP request (option 97). A ProvisioningEventPXEBooting is fired.
 	Dhcp(context.Context, *v2.BootServiceDhcpRequest) (*v2.BootServiceDhcpResponse, error)
-	// Boot is called from pixie once the machine got the first dhcp response and ipxie asks for subsequent kernel and initrd
+	// Boot is called from pixie once the machine got the first DHCP response and ipxe asks for subsequent kernel and initrd.
 	Boot(context.Context, *v2.BootServiceBootRequest) (*v2.BootServiceBootResponse, error)
-	// SuperUserPassword metal-hammer takes the configured root password for the bmc from metal-apiserver and configure the bmc accordingly
+	// SuperUserPassword returns the configured root password for the BMC.
 	SuperUserPassword(context.Context, *v2.BootServiceSuperUserPasswordRequest) (*v2.BootServiceSuperUserPasswordResponse, error)
-	// Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all gory details about that machine
+	// Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all details about that machine.
 	Register(context.Context, *v2.BootServiceRegisterRequest) (*v2.BootServiceRegisterResponse, error)
-	// Wait is a hanging call that waits until the machine gets allocated by a user
+	// Wait is a hanging call that waits until the machine gets allocated by a user.
 	Wait(context.Context, *v2.BootServiceWaitRequest) (*connect.ServerStreamForClient[v2.BootServiceWaitResponse], error)
-	// InstallationSucceeded tells metal-apiserver installation was either successful
+	// InstallationSucceeded tells metal-apiserver that installation was successful.
 	InstallationSucceeded(context.Context, *v2.BootServiceInstallationSucceededRequest) (*v2.BootServiceInstallationSucceededResponse, error)
 }
 
@@ -177,17 +177,17 @@ func (c *bootServiceClient) InstallationSucceeded(ctx context.Context, req *v2.B
 
 // BootServiceHandler is an implementation of the metalstack.infra.v2.BootService service.
 type BootServiceHandler interface {
-	// Dhcp is the first dhcp request (option 97). A ProvisioningEventPXEBooting is fired
+	// Dhcp handles the first DHCP request (option 97). A ProvisioningEventPXEBooting is fired.
 	Dhcp(context.Context, *v2.BootServiceDhcpRequest) (*v2.BootServiceDhcpResponse, error)
-	// Boot is called from pixie once the machine got the first dhcp response and ipxie asks for subsequent kernel and initrd
+	// Boot is called from pixie once the machine got the first DHCP response and ipxe asks for subsequent kernel and initrd.
 	Boot(context.Context, *v2.BootServiceBootRequest) (*v2.BootServiceBootResponse, error)
-	// SuperUserPassword metal-hammer takes the configured root password for the bmc from metal-apiserver and configure the bmc accordingly
+	// SuperUserPassword returns the configured root password for the BMC.
 	SuperUserPassword(context.Context, *v2.BootServiceSuperUserPasswordRequest) (*v2.BootServiceSuperUserPasswordResponse, error)
-	// Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all gory details about that machine
+	// Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all details about that machine.
 	Register(context.Context, *v2.BootServiceRegisterRequest) (*v2.BootServiceRegisterResponse, error)
-	// Wait is a hanging call that waits until the machine gets allocated by a user
+	// Wait is a hanging call that waits until the machine gets allocated by a user.
 	Wait(context.Context, *v2.BootServiceWaitRequest, *connect.ServerStream[v2.BootServiceWaitResponse]) error
-	// InstallationSucceeded tells metal-apiserver installation was either successful
+	// InstallationSucceeded tells metal-apiserver that installation was successful.
 	InstallationSucceeded(context.Context, *v2.BootServiceInstallationSucceededRequest) (*v2.BootServiceInstallationSucceededResponse, error)
 }
 
diff --git a/go/metalstack/infra/v2/infrav2connect/component.connect.go b/go/metalstack/infra/v2/infrav2connect/component.connect.go
index ea0dee3d..ecd34208 100644
--- a/go/metalstack/infra/v2/infrav2connect/component.connect.go
+++ b/go/metalstack/infra/v2/infrav2connect/component.connect.go
@@ -39,8 +39,7 @@ const (
 
 // ComponentServiceClient is a client for the metalstack.infra.v2.ComponentService service.
 type ComponentServiceClient interface {
-	// Ping must be called from every connected microservice in a recurring manner
-	// to get visibility of all registered microservices.
+	// Returns the ping response to register or report the microservice state.
 	Ping(context.Context, *v2.ComponentServicePingRequest) (*v2.ComponentServicePingResponse, error)
 }
 
@@ -80,8 +79,7 @@ func (c *componentServiceClient) Ping(ctx context.Context, req *v2.ComponentServ
 
 // ComponentServiceHandler is an implementation of the metalstack.infra.v2.ComponentService service.
 type ComponentServiceHandler interface {
-	// Ping must be called from every connected microservice in a recurring manner
-	// to get visibility of all registered microservices.
+	// Returns the ping response to register or report the microservice state.
 	Ping(context.Context, *v2.ComponentServicePingRequest) (*v2.ComponentServicePingResponse, error)
 }
 
diff --git a/go/metalstack/infra/v2/infrav2connect/event.connect.go b/go/metalstack/infra/v2/infrav2connect/event.connect.go
index 2deb182e..24284b51 100644
--- a/go/metalstack/infra/v2/infrav2connect/event.connect.go
+++ b/go/metalstack/infra/v2/infrav2connect/event.connect.go
@@ -39,7 +39,7 @@ const (
 
 // EventServiceClient is a client for the metalstack.infra.v2.EventService service.
 type EventServiceClient interface {
-	// Send a series of machine provisioning events.
+	// Sends a series of machine provisioning events.
 	Send(context.Context, *v2.EventServiceSendRequest) (*v2.EventServiceSendResponse, error)
 }
 
@@ -79,7 +79,7 @@ func (c *eventServiceClient) Send(ctx context.Context, req *v2.EventServiceSendR
 
 // EventServiceHandler is an implementation of the metalstack.infra.v2.EventService service.
 type EventServiceHandler interface {
-	// Send a series of machine provisioning events.
+	// Sends a series of machine provisioning events.
 	Send(context.Context, *v2.EventServiceSendRequest) (*v2.EventServiceSendResponse, error)
 }
 
diff --git a/go/metalstack/infra/v2/infrav2connect/switch.connect.go b/go/metalstack/infra/v2/infrav2connect/switch.connect.go
index ae248c4b..89020b05 100644
--- a/go/metalstack/infra/v2/infrav2connect/switch.connect.go
+++ b/go/metalstack/infra/v2/infrav2connect/switch.connect.go
@@ -43,11 +43,11 @@ const (
 
 // SwitchServiceClient is a client for the metalstack.infra.v2.SwitchService service.
 type SwitchServiceClient interface {
-	// Get a switch by ID.
+	// Returns the switch with the specified ID.
 	Get(context.Context, *v2.SwitchServiceGetRequest) (*v2.SwitchServiceGetResponse, error)
-	// Register a switch.
+	// Registers a switch.
 	Register(context.Context, *v2.SwitchServiceRegisterRequest) (*v2.SwitchServiceRegisterResponse, error)
-	// Heartbeat a switch.
+	// Heartbeat sends a heartbeat from a switch.
 	Heartbeat(context.Context, *v2.SwitchServiceHeartbeatRequest) (*v2.SwitchServiceHeartbeatResponse, error)
 }
 
@@ -119,11 +119,11 @@ func (c *switchServiceClient) Heartbeat(ctx context.Context, req *v2.SwitchServi
 
 // SwitchServiceHandler is an implementation of the metalstack.infra.v2.SwitchService service.
 type SwitchServiceHandler interface {
-	// Get a switch by ID.
+	// Returns the switch with the specified ID.
 	Get(context.Context, *v2.SwitchServiceGetRequest) (*v2.SwitchServiceGetResponse, error)
-	// Register a switch.
+	// Registers a switch.
 	Register(context.Context, *v2.SwitchServiceRegisterRequest) (*v2.SwitchServiceRegisterResponse, error)
-	// Heartbeat a switch.
+	// Heartbeat sends a heartbeat from a switch.
 	Heartbeat(context.Context, *v2.SwitchServiceHeartbeatRequest) (*v2.SwitchServiceHeartbeatResponse, error)
 }
 
diff --git a/go/metalstack/infra/v2/switch.pb.go b/go/metalstack/infra/v2/switch.pb.go
index 3d3f2057..aadc02d5 100644
--- a/go/metalstack/infra/v2/switch.pb.go
+++ b/go/metalstack/infra/v2/switch.pb.go
@@ -24,10 +24,10 @@ const (
 	_ = protoimpl.EnforceVersion(protoimpl.MaxVersion - 20)
 )
 
-// SwitchServiceGetRequest.
+// SwitchServiceGetRequest is the request payload for getting a switch.
 type SwitchServiceGetRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Id of the switch.
+	// Id of the switch
 	Id            string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -70,10 +70,10 @@ func (x *SwitchServiceGetRequest) GetId() string {
 	return ""
 }
 
-// SwitchServiceGetResponse.
+// SwitchServiceGetResponse is the response payload for getting a switch.
 type SwitchServiceGetResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Switch that was requested.
+	// Switch contains the requested switch
 	Switch        *v2.Switch `protobuf:"bytes,1,opt,name=switch,proto3" json:"switch,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -116,10 +116,10 @@ func (x *SwitchServiceGetResponse) GetSwitch() *v2.Switch {
 	return nil
 }
 
-// SwitchServiceRegisterRequest.
+// SwitchServiceRegisterRequest is the request payload for registering a switch.
 type SwitchServiceRegisterRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Switch to register.
+	// Switch to register
 	Switch        *v2.Switch `protobuf:"bytes,1,opt,name=switch,proto3" json:"switch,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -162,10 +162,10 @@ func (x *SwitchServiceRegisterRequest) GetSwitch() *v2.Switch {
 	return nil
 }
 
-// SwitchServiceRegisterResponse.
+// SwitchServiceRegisterResponse is the response payload for registering a switch.
 type SwitchServiceRegisterResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Switch that was registered.
+	// Switch contains the registered switch
 	Switch        *v2.Switch `protobuf:"bytes,1,opt,name=switch,proto3" json:"switch,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -208,18 +208,18 @@ func (x *SwitchServiceRegisterResponse) GetSwitch() *v2.Switch {
 	return nil
 }
 
-// SwitchServiceHeartbeatRequest.
+// SwitchServiceHeartbeatRequest is the request payload for sending a switch heartbeat.
 type SwitchServiceHeartbeatRequest struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Id of the switch.
+	// Id of the switch
 	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
-	// Duration of the sync.
+	// Duration of the sync
 	Duration *durationpb.Duration `protobuf:"bytes,2,opt,name=duration,proto3" json:"duration,omitempty"`
-	// Error if any occurred during the sync.
+	// Error if any occurred during the sync
 	Error *string `protobuf:"bytes,3,opt,name=error,proto3,oneof" json:"error,omitempty"`
-	// PortStates maps port identifiers to the respective port's operational state.
+	// PortStates maps port identifiers to the respective port's operational state
 	PortStates map[string]v2.SwitchPortStatus `protobuf:"bytes,4,rep,name=port_states,json=portStates,proto3" json:"port_states,omitempty" protobuf_key:"bytes,1,opt,name=key" protobuf_val:"varint,2,opt,name=value,enum=metalstack.api.v2.SwitchPortStatus"`
-	// BgpPortStates maps port identifiers to the respective port's BGP state.
+	// BgpPortStates maps port identifiers to the respective port's BGP state
 	BgpPortStates map[string]*v2.SwitchBGPPortState `protobuf:"bytes,5,rep,name=bgp_port_states,json=bgpPortStates,proto3" json:"bgp_port_states,omitempty" protobuf_key:"bytes,1,opt,name=key" protobuf_val:"bytes,2,opt,name=value"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
@@ -290,14 +290,14 @@ func (x *SwitchServiceHeartbeatRequest) GetBgpPortStates() map[string]*v2.Switch
 	return nil
 }
 
-// SwitchServiceHeartbeatResponse.
+// SwitchServiceHeartbeatResponse is the response payload for sending a switch heartbeat.
 type SwitchServiceHeartbeatResponse struct {
 	state protoimpl.MessageState `protogen:"open.v1"`
-	// Id of the switch.
+	// Id of the switch
 	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
-	// LastSync holds information about the last sync.
+	// LastSync holds information about the last sync
 	LastSync *v2.SwitchSync `protobuf:"bytes,2,opt,name=last_sync,json=lastSync,proto3" json:"last_sync,omitempty"`
-	// LastSyncError holds information about the last erroneous sync.
+	// LastSyncError holds information about the last erroneous sync
 	LastSyncError *v2.SwitchSync `protobuf:"bytes,3,opt,name=last_sync_error,json=lastSyncError,proto3" json:"last_sync_error,omitempty"`
 	unknownFields protoimpl.UnknownFields
 	sizeCache     protoimpl.SizeCache
diff --git a/js/metalstack/admin/v2/audit_pb.d.ts b/js/metalstack/admin/v2/audit_pb.d.ts
index dc15a5f3..7e0a57f5 100644
--- a/js/metalstack/admin/v2/audit_pb.d.ts
+++ b/js/metalstack/admin/v2/audit_pb.d.ts
@@ -6,7 +6,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_audit: GenFile;
 /**
- * AuditServiceListRequest is the request payload to list audits
+ * AuditServiceListRequest is the request payload for listing audit traces.
  *
  * @generated from message metalstack.admin.v2.AuditServiceListRequest
  */
@@ -24,13 +24,13 @@ export type AuditServiceListRequest = Message<"metalstack.admin.v2.AuditServiceL
  */
 export declare const AuditServiceListRequestSchema: GenMessage<AuditServiceListRequest>;
 /**
- * AuditServiceListResponse is the response payload of a audit list request
+ * AuditServiceListResponse is the response payload for listing audit traces.
  *
  * @generated from message metalstack.admin.v2.AuditServiceListResponse
  */
 export type AuditServiceListResponse = Message<"metalstack.admin.v2.AuditServiceListResponse"> & {
     /**
-     * Traces is a list of audit traces
+     * Traces contains the list of audit traces
      *
      * @generated from field: repeated metalstack.api.v2.AuditTrace traces = 1;
      */
@@ -42,7 +42,7 @@ export type AuditServiceListResponse = Message<"metalstack.admin.v2.AuditService
  */
 export declare const AuditServiceListResponseSchema: GenMessage<AuditServiceListResponse>;
 /**
- * AuditServiceGetRequest is the request payload of a audit get request
+ * AuditServiceGetRequest is the request payload for getting an audit trace.
  *
  * @generated from message metalstack.admin.v2.AuditServiceGetRequest
  */
@@ -66,7 +66,7 @@ export type AuditServiceGetRequest = Message<"metalstack.admin.v2.AuditServiceGe
  */
 export declare const AuditServiceGetRequestSchema: GenMessage<AuditServiceGetRequest>;
 /**
- * AuditServiceGetResponse is the response payload of a audit get request
+ * AuditServiceGetResponse is the response payload for getting an audit trace.
  *
  * @generated from message metalstack.admin.v2.AuditServiceGetResponse
  */
@@ -84,13 +84,13 @@ export type AuditServiceGetResponse = Message<"metalstack.admin.v2.AuditServiceG
  */
 export declare const AuditServiceGetResponseSchema: GenMessage<AuditServiceGetResponse>;
 /**
- * AuditService serves audit related functions
+ * AuditService provides audit logging operations.
  *
  * @generated from service metalstack.admin.v2.AuditService
  */
 export declare const AuditService: GenService<{
     /**
-     * Get an audit trace
+     * Returns the audit trace with the specified UUID.
      *
      * @generated from rpc metalstack.admin.v2.AuditService.Get
      */
@@ -100,7 +100,7 @@ export declare const AuditService: GenService<{
         output: typeof AuditServiceGetResponseSchema;
     };
     /**
-     * List all audit traces
+     * Returns the list of all audit traces.
      *
      * @generated from rpc metalstack.admin.v2.AuditService.List
      */
diff --git a/js/metalstack/admin/v2/audit_pb.js b/js/metalstack/admin/v2/audit_pb.js
index 6a84f276..97e10962 100644
--- a/js/metalstack/admin/v2/audit_pb.js
+++ b/js/metalstack/admin/v2/audit_pb.js
@@ -30,7 +30,7 @@ export const AuditServiceGetRequestSchema = /*@__PURE__*/ messageDesc(file_metal
  */
 export const AuditServiceGetResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_audit, 3);
 /**
- * AuditService serves audit related functions
+ * AuditService provides audit logging operations.
  *
  * @generated from service metalstack.admin.v2.AuditService
  */
diff --git a/js/metalstack/admin/v2/audit_pb.ts b/js/metalstack/admin/v2/audit_pb.ts
index d2392aaf..b999e1cf 100644
--- a/js/metalstack/admin/v2/audit_pb.ts
+++ b/js/metalstack/admin/v2/audit_pb.ts
@@ -17,7 +17,7 @@ export const file_metalstack_admin_v2_audit: GenFile = /*@__PURE__*/
   fileDesc("Ch9tZXRhbHN0YWNrL2FkbWluL3YyL2F1ZGl0LnByb3RvEhNtZXRhbHN0YWNrLmFkbWluLnYyIkcKF0F1ZGl0U2VydmljZUxpc3RSZXF1ZXN0EiwKBXF1ZXJ5GAEgASgLMh0ubWV0YWxzdGFjay5hcGkudjIuQXVkaXRRdWVyeSJJChhBdWRpdFNlcnZpY2VMaXN0UmVzcG9uc2USLQoGdHJhY2VzGAEgAygLMh0ubWV0YWxzdGFjay5hcGkudjIuQXVkaXRUcmFjZSJ3ChZBdWRpdFNlcnZpY2VHZXRSZXF1ZXN0EhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEjsKBXBoYXNlGAIgASgOMh0ubWV0YWxzdGFjay5hcGkudjIuQXVkaXRQaGFzZUIIukgFggECEAFIAIgBAUIICgZfcGhhc2UiRwoXQXVkaXRTZXJ2aWNlR2V0UmVzcG9uc2USLAoFdHJhY2UYASABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5BdWRpdFRyYWNlMuUBCgxBdWRpdFNlcnZpY2USaAoDR2V0EisubWV0YWxzdGFjay5hZG1pbi52Mi5BdWRpdFNlcnZpY2VHZXRSZXF1ZXN0GiwubWV0YWxzdGFjay5hZG1pbi52Mi5BdWRpdFNlcnZpY2VHZXRSZXNwb25zZSIG0vMYAgECEmsKBExpc3QSLC5tZXRhbHN0YWNrLmFkbWluLnYyLkF1ZGl0U2VydmljZUxpc3RSZXF1ZXN0Gi0ubWV0YWxzdGFjay5hZG1pbi52Mi5BdWRpdFNlcnZpY2VMaXN0UmVzcG9uc2UiBtLzGAIBAkLOAQoXY29tLm1ldGFsc3RhY2suYWRtaW4udjJCCkF1ZGl0UHJvdG9QAVo5Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9hZG1pbi92MjthZG1pbnYyogIDTUFYqgITTWV0YWxzdGFjay5BZG1pbi5WMsoCE01ldGFsc3RhY2tcQWRtaW5cVjLiAh9NZXRhbHN0YWNrXEFkbWluXFYyXEdQQk1ldGFkYXRh6gIVTWV0YWxzdGFjazo6QWRtaW46OlYyYgZwcm90bzM", [file_buf_validate_validate, file_metalstack_api_v2_audit, file_metalstack_api_v2_common]);
 
 /**
- * AuditServiceListRequest is the request payload to list audits
+ * AuditServiceListRequest is the request payload for listing audit traces.
  *
  * @generated from message metalstack.admin.v2.AuditServiceListRequest
  */
@@ -38,13 +38,13 @@ export const AuditServiceListRequestSchema: GenMessage<AuditServiceListRequest>
   messageDesc(file_metalstack_admin_v2_audit, 0);
 
 /**
- * AuditServiceListResponse is the response payload of a audit list request
+ * AuditServiceListResponse is the response payload for listing audit traces.
  *
  * @generated from message metalstack.admin.v2.AuditServiceListResponse
  */
 export type AuditServiceListResponse = Message<"metalstack.admin.v2.AuditServiceListResponse"> & {
   /**
-   * Traces is a list of audit traces
+   * Traces contains the list of audit traces
    *
    * @generated from field: repeated metalstack.api.v2.AuditTrace traces = 1;
    */
@@ -59,7 +59,7 @@ export const AuditServiceListResponseSchema: GenMessage<AuditServiceListResponse
   messageDesc(file_metalstack_admin_v2_audit, 1);
 
 /**
- * AuditServiceGetRequest is the request payload of a audit get request
+ * AuditServiceGetRequest is the request payload for getting an audit trace.
  *
  * @generated from message metalstack.admin.v2.AuditServiceGetRequest
  */
@@ -87,7 +87,7 @@ export const AuditServiceGetRequestSchema: GenMessage<AuditServiceGetRequest> =
   messageDesc(file_metalstack_admin_v2_audit, 2);
 
 /**
- * AuditServiceGetResponse is the response payload of a audit get request
+ * AuditServiceGetResponse is the response payload for getting an audit trace.
  *
  * @generated from message metalstack.admin.v2.AuditServiceGetResponse
  */
@@ -108,13 +108,13 @@ export const AuditServiceGetResponseSchema: GenMessage<AuditServiceGetResponse>
   messageDesc(file_metalstack_admin_v2_audit, 3);
 
 /**
- * AuditService serves audit related functions
+ * AuditService provides audit logging operations.
  *
  * @generated from service metalstack.admin.v2.AuditService
  */
 export const AuditService: GenService<{
   /**
-   * Get an audit trace
+   * Returns the audit trace with the specified UUID.
    *
    * @generated from rpc metalstack.admin.v2.AuditService.Get
    */
@@ -124,7 +124,7 @@ export const AuditService: GenService<{
     output: typeof AuditServiceGetResponseSchema;
   },
   /**
-   * List all audit traces
+   * Returns the list of all audit traces.
    *
    * @generated from rpc metalstack.admin.v2.AuditService.List
    */
diff --git a/js/metalstack/admin/v2/component_pb.d.ts b/js/metalstack/admin/v2/component_pb.d.ts
index 05299f53..94c2bbd6 100644
--- a/js/metalstack/admin/v2/component_pb.d.ts
+++ b/js/metalstack/admin/v2/component_pb.d.ts
@@ -6,13 +6,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_component: GenFile;
 /**
- * ComponentServiceListRequest
+ * ComponentServiceListRequest is the request payload for listing components.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceListRequest
  */
 export type ComponentServiceListRequest = Message<"metalstack.admin.v2.ComponentServiceListRequest"> & {
     /**
-     * Query components.
+     * Query filters components
      *
      * @generated from field: metalstack.api.v2.ComponentQuery query = 1;
      */
@@ -24,13 +24,13 @@ export type ComponentServiceListRequest = Message<"metalstack.admin.v2.Component
  */
 export declare const ComponentServiceListRequestSchema: GenMessage<ComponentServiceListRequest>;
 /**
- * ComponentServiceListResponse
+ * ComponentServiceListResponse is the response payload for listing components.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceListResponse
  */
 export type ComponentServiceListResponse = Message<"metalstack.admin.v2.ComponentServiceListResponse"> & {
     /**
-     * Components
+     * Components contains the list of components
      *
      * @generated from field: repeated metalstack.api.v2.Component components = 1;
      */
@@ -42,7 +42,7 @@ export type ComponentServiceListResponse = Message<"metalstack.admin.v2.Componen
  */
 export declare const ComponentServiceListResponseSchema: GenMessage<ComponentServiceListResponse>;
 /**
- * ComponentServiceGetRequest
+ * ComponentServiceGetRequest is the request payload for getting a component.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceGetRequest
  */
@@ -60,13 +60,13 @@ export type ComponentServiceGetRequest = Message<"metalstack.admin.v2.ComponentS
  */
 export declare const ComponentServiceGetRequestSchema: GenMessage<ComponentServiceGetRequest>;
 /**
- * ComponentServiceGetResponse
+ * ComponentServiceGetResponse is the response payload for getting a component.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceGetResponse
  */
 export type ComponentServiceGetResponse = Message<"metalstack.admin.v2.ComponentServiceGetResponse"> & {
     /**
-     * Component
+     * Component contains the retrieved component
      *
      * @generated from field: metalstack.api.v2.Component component = 1;
      */
@@ -78,7 +78,7 @@ export type ComponentServiceGetResponse = Message<"metalstack.admin.v2.Component
  */
 export declare const ComponentServiceGetResponseSchema: GenMessage<ComponentServiceGetResponse>;
 /**
- * ComponentServiceGetRequest
+ * ComponentServiceDeleteRequest is the request payload for deleting a component.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceDeleteRequest
  */
@@ -96,13 +96,13 @@ export type ComponentServiceDeleteRequest = Message<"metalstack.admin.v2.Compone
  */
 export declare const ComponentServiceDeleteRequestSchema: GenMessage<ComponentServiceDeleteRequest>;
 /**
- * ComponentServiceGetResponse
+ * ComponentServiceDeleteResponse is the response payload for deleting a component.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceDeleteResponse
  */
 export type ComponentServiceDeleteResponse = Message<"metalstack.admin.v2.ComponentServiceDeleteResponse"> & {
     /**
-     * Component
+     * Component contains the deleted component
      *
      * @generated from field: metalstack.api.v2.Component component = 1;
      */
@@ -114,13 +114,13 @@ export type ComponentServiceDeleteResponse = Message<"metalstack.admin.v2.Compon
  */
 export declare const ComponentServiceDeleteResponseSchema: GenMessage<ComponentServiceDeleteResponse>;
 /**
- * ComponentService serves microservice related functions
+ * ComponentService provides microservice component management operations.
  *
  * @generated from service metalstack.admin.v2.ComponentService
  */
 export declare const ComponentService: GenService<{
     /**
-     * Get a single component
+     * Returns the component with the specified UUID.
      *
      * @generated from rpc metalstack.admin.v2.ComponentService.Get
      */
@@ -130,7 +130,7 @@ export declare const ComponentService: GenService<{
         output: typeof ComponentServiceGetResponseSchema;
     };
     /**
-     * Delete a component
+     * Deletes the component with the specified UUID.
      *
      * @generated from rpc metalstack.admin.v2.ComponentService.Delete
      */
@@ -140,7 +140,7 @@ export declare const ComponentService: GenService<{
         output: typeof ComponentServiceDeleteResponseSchema;
     };
     /**
-     * List all components with their status
+     * Returns the list of all components with their status.
      *
      * @generated from rpc metalstack.admin.v2.ComponentService.List
      */
diff --git a/js/metalstack/admin/v2/component_pb.js b/js/metalstack/admin/v2/component_pb.js
index a65eceb2..25bd9cf8 100644
--- a/js/metalstack/admin/v2/component_pb.js
+++ b/js/metalstack/admin/v2/component_pb.js
@@ -40,7 +40,7 @@ export const ComponentServiceDeleteRequestSchema = /*@__PURE__*/ messageDesc(fil
  */
 export const ComponentServiceDeleteResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_component, 5);
 /**
- * ComponentService serves microservice related functions
+ * ComponentService provides microservice component management operations.
  *
  * @generated from service metalstack.admin.v2.ComponentService
  */
diff --git a/js/metalstack/admin/v2/component_pb.ts b/js/metalstack/admin/v2/component_pb.ts
index ae11bff2..2568184e 100644
--- a/js/metalstack/admin/v2/component_pb.ts
+++ b/js/metalstack/admin/v2/component_pb.ts
@@ -17,13 +17,13 @@ export const file_metalstack_admin_v2_component: GenFile = /*@__PURE__*/
   fileDesc("CiNtZXRhbHN0YWNrL2FkbWluL3YyL2NvbXBvbmVudC5wcm90bxITbWV0YWxzdGFjay5hZG1pbi52MiJPChtDb21wb25lbnRTZXJ2aWNlTGlzdFJlcXVlc3QSMAoFcXVlcnkYASABKAsyIS5tZXRhbHN0YWNrLmFwaS52Mi5Db21wb25lbnRRdWVyeSJQChxDb21wb25lbnRTZXJ2aWNlTGlzdFJlc3BvbnNlEjAKCmNvbXBvbmVudHMYASADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5Db21wb25lbnQiNAoaQ29tcG9uZW50U2VydmljZUdldFJlcXVlc3QSFgoEdXVpZBgBIAEoCUIIukgFcgOwAQEiTgobQ29tcG9uZW50U2VydmljZUdldFJlc3BvbnNlEi8KCWNvbXBvbmVudBgBIAEoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkNvbXBvbmVudCI3Ch1Db21wb25lbnRTZXJ2aWNlRGVsZXRlUmVxdWVzdBIWCgR1dWlkGAEgASgJQgi6SAVyA7ABASJRCh5Db21wb25lbnRTZXJ2aWNlRGVsZXRlUmVzcG9uc2USLwoJY29tcG9uZW50GAEgASgLMhwubWV0YWxzdGFjay5hcGkudjIuQ29tcG9uZW50Mv8CChBDb21wb25lbnRTZXJ2aWNlEnQKA0dldBIvLm1ldGFsc3RhY2suYWRtaW4udjIuQ29tcG9uZW50U2VydmljZUdldFJlcXVlc3QaMC5tZXRhbHN0YWNrLmFkbWluLnYyLkNvbXBvbmVudFNlcnZpY2VHZXRSZXNwb25zZSIK0vMYAgEC4PMYAhJ8CgZEZWxldGUSMi5tZXRhbHN0YWNrLmFkbWluLnYyLkNvbXBvbmVudFNlcnZpY2VEZWxldGVSZXF1ZXN0GjMubWV0YWxzdGFjay5hZG1pbi52Mi5Db21wb25lbnRTZXJ2aWNlRGVsZXRlUmVzcG9uc2UiCdLzGAEB4PMYARJ3CgRMaXN0EjAubWV0YWxzdGFjay5hZG1pbi52Mi5Db21wb25lbnRTZXJ2aWNlTGlzdFJlcXVlc3QaMS5tZXRhbHN0YWNrLmFkbWluLnYyLkNvbXBvbmVudFNlcnZpY2VMaXN0UmVzcG9uc2UiCtLzGAIBAuDzGAJC0gEKF2NvbS5tZXRhbHN0YWNrLmFkbWluLnYyQg5Db21wb25lbnRQcm90b1ABWjlnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FkbWluL3YyO2FkbWludjKiAgNNQViqAhNNZXRhbHN0YWNrLkFkbWluLlYyygITTWV0YWxzdGFja1xBZG1pblxWMuICH01ldGFsc3RhY2tcQWRtaW5cVjJcR1BCTWV0YWRhdGHqAhVNZXRhbHN0YWNrOjpBZG1pbjo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_component]);
 
 /**
- * ComponentServiceListRequest
+ * ComponentServiceListRequest is the request payload for listing components.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceListRequest
  */
 export type ComponentServiceListRequest = Message<"metalstack.admin.v2.ComponentServiceListRequest"> & {
   /**
-   * Query components.
+   * Query filters components
    *
    * @generated from field: metalstack.api.v2.ComponentQuery query = 1;
    */
@@ -38,13 +38,13 @@ export const ComponentServiceListRequestSchema: GenMessage<ComponentServiceListR
   messageDesc(file_metalstack_admin_v2_component, 0);
 
 /**
- * ComponentServiceListResponse
+ * ComponentServiceListResponse is the response payload for listing components.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceListResponse
  */
 export type ComponentServiceListResponse = Message<"metalstack.admin.v2.ComponentServiceListResponse"> & {
   /**
-   * Components
+   * Components contains the list of components
    *
    * @generated from field: repeated metalstack.api.v2.Component components = 1;
    */
@@ -59,7 +59,7 @@ export const ComponentServiceListResponseSchema: GenMessage<ComponentServiceList
   messageDesc(file_metalstack_admin_v2_component, 1);
 
 /**
- * ComponentServiceGetRequest
+ * ComponentServiceGetRequest is the request payload for getting a component.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceGetRequest
  */
@@ -80,13 +80,13 @@ export const ComponentServiceGetRequestSchema: GenMessage<ComponentServiceGetReq
   messageDesc(file_metalstack_admin_v2_component, 2);
 
 /**
- * ComponentServiceGetResponse
+ * ComponentServiceGetResponse is the response payload for getting a component.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceGetResponse
  */
 export type ComponentServiceGetResponse = Message<"metalstack.admin.v2.ComponentServiceGetResponse"> & {
   /**
-   * Component
+   * Component contains the retrieved component
    *
    * @generated from field: metalstack.api.v2.Component component = 1;
    */
@@ -101,7 +101,7 @@ export const ComponentServiceGetResponseSchema: GenMessage<ComponentServiceGetRe
   messageDesc(file_metalstack_admin_v2_component, 3);
 
 /**
- * ComponentServiceGetRequest
+ * ComponentServiceDeleteRequest is the request payload for deleting a component.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceDeleteRequest
  */
@@ -122,13 +122,13 @@ export const ComponentServiceDeleteRequestSchema: GenMessage<ComponentServiceDel
   messageDesc(file_metalstack_admin_v2_component, 4);
 
 /**
- * ComponentServiceGetResponse
+ * ComponentServiceDeleteResponse is the response payload for deleting a component.
  *
  * @generated from message metalstack.admin.v2.ComponentServiceDeleteResponse
  */
 export type ComponentServiceDeleteResponse = Message<"metalstack.admin.v2.ComponentServiceDeleteResponse"> & {
   /**
-   * Component
+   * Component contains the deleted component
    *
    * @generated from field: metalstack.api.v2.Component component = 1;
    */
@@ -143,13 +143,13 @@ export const ComponentServiceDeleteResponseSchema: GenMessage<ComponentServiceDe
   messageDesc(file_metalstack_admin_v2_component, 5);
 
 /**
- * ComponentService serves microservice related functions
+ * ComponentService provides microservice component management operations.
  *
  * @generated from service metalstack.admin.v2.ComponentService
  */
 export const ComponentService: GenService<{
   /**
-   * Get a single component
+   * Returns the component with the specified UUID.
    *
    * @generated from rpc metalstack.admin.v2.ComponentService.Get
    */
@@ -159,7 +159,7 @@ export const ComponentService: GenService<{
     output: typeof ComponentServiceGetResponseSchema;
   },
   /**
-   * Delete a component
+   * Deletes the component with the specified UUID.
    *
    * @generated from rpc metalstack.admin.v2.ComponentService.Delete
    */
@@ -169,7 +169,7 @@ export const ComponentService: GenService<{
     output: typeof ComponentServiceDeleteResponseSchema;
   },
   /**
-   * List all components with their status
+   * Returns the list of all components with their status.
    *
    * @generated from rpc metalstack.admin.v2.ComponentService.List
    */
diff --git a/js/metalstack/admin/v2/filesystem_pb.d.ts b/js/metalstack/admin/v2/filesystem_pb.d.ts
index 96d57a39..927f4b5d 100644
--- a/js/metalstack/admin/v2/filesystem_pb.d.ts
+++ b/js/metalstack/admin/v2/filesystem_pb.d.ts
@@ -7,13 +7,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_filesystem: GenFile;
 /**
- * FilesystemServiceCreateRequest
+ * FilesystemServiceCreateRequest is the request payload for creating a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceCreateRequest
  */
 export type FilesystemServiceCreateRequest = Message<"metalstack.admin.v2.FilesystemServiceCreateRequest"> & {
     /**
-     * FilesystemLayout the filesystemlayout
+     * FilesystemLayout is the filesystem layout to create
      *
      * @generated from field: metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
      */
@@ -25,13 +25,13 @@ export type FilesystemServiceCreateRequest = Message<"metalstack.admin.v2.Filesy
  */
 export declare const FilesystemServiceCreateRequestSchema: GenMessage<FilesystemServiceCreateRequest>;
 /**
- * FilesystemServiceCreateResponse
+ * FilesystemServiceCreateResponse is the response payload for creating a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceCreateResponse
  */
 export type FilesystemServiceCreateResponse = Message<"metalstack.admin.v2.FilesystemServiceCreateResponse"> & {
     /**
-     * FilesystemLayout the filesystemlayout
+     * FilesystemLayout contains the created filesystem layout
      *
      * @generated from field: metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
      */
@@ -43,7 +43,7 @@ export type FilesystemServiceCreateResponse = Message<"metalstack.admin.v2.Files
  */
 export declare const FilesystemServiceCreateResponseSchema: GenMessage<FilesystemServiceCreateResponse>;
 /**
- * FilesystemServiceUpdateRequest
+ * FilesystemServiceUpdateRequest is the request payload for updating a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceUpdateRequest
  */
@@ -85,7 +85,7 @@ export type FilesystemServiceUpdateRequest = Message<"metalstack.admin.v2.Filesy
      */
     disks: Disk[];
     /**
-     * raid arrays to create
+     * Raid arrays to create
      *
      * @generated from field: repeated metalstack.api.v2.Raid raid = 7;
      */
@@ -115,13 +115,13 @@ export type FilesystemServiceUpdateRequest = Message<"metalstack.admin.v2.Filesy
  */
 export declare const FilesystemServiceUpdateRequestSchema: GenMessage<FilesystemServiceUpdateRequest>;
 /**
- * FilesystemServiceUpdateResponse
+ * FilesystemServiceUpdateResponse is the response payload for updating a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceUpdateResponse
  */
 export type FilesystemServiceUpdateResponse = Message<"metalstack.admin.v2.FilesystemServiceUpdateResponse"> & {
     /**
-     * FilesystemLayout the filesystemlayout
+     * FilesystemLayout contains the updated filesystem layout
      *
      * @generated from field: metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
      */
@@ -133,7 +133,7 @@ export type FilesystemServiceUpdateResponse = Message<"metalstack.admin.v2.Files
  */
 export declare const FilesystemServiceUpdateResponseSchema: GenMessage<FilesystemServiceUpdateResponse>;
 /**
- * FilesystemServiceDeleteRequest
+ * FilesystemServiceDeleteRequest is the request payload for deleting a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceDeleteRequest
  */
@@ -151,13 +151,13 @@ export type FilesystemServiceDeleteRequest = Message<"metalstack.admin.v2.Filesy
  */
 export declare const FilesystemServiceDeleteRequestSchema: GenMessage<FilesystemServiceDeleteRequest>;
 /**
- * message FilesystemServiceDeleteResponse {
+ * FilesystemServiceDeleteResponse is the response payload for deleting a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceDeleteResponse
  */
 export type FilesystemServiceDeleteResponse = Message<"metalstack.admin.v2.FilesystemServiceDeleteResponse"> & {
     /**
-     * FilesystemLayout the filesystemlayout
+     * FilesystemLayout contains the deleted filesystem layout
      *
      * @generated from field: metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
      */
@@ -169,13 +169,13 @@ export type FilesystemServiceDeleteResponse = Message<"metalstack.admin.v2.Files
  */
 export declare const FilesystemServiceDeleteResponseSchema: GenMessage<FilesystemServiceDeleteResponse>;
 /**
- * FilesystemService serves filesystem related functions
+ * FilesystemService provides filesystem management operations.
  *
  * @generated from service metalstack.admin.v2.FilesystemService
  */
 export declare const FilesystemService: GenService<{
     /**
-     * Create a filesystem
+     * Creates a new filesystem.
      *
      * @generated from rpc metalstack.admin.v2.FilesystemService.Create
      */
@@ -185,7 +185,7 @@ export declare const FilesystemService: GenService<{
         output: typeof FilesystemServiceCreateResponseSchema;
     };
     /**
-     * Update a filesystem
+     * Updates a filesystem.
      *
      * @generated from rpc metalstack.admin.v2.FilesystemService.Update
      */
@@ -195,7 +195,7 @@ export declare const FilesystemService: GenService<{
         output: typeof FilesystemServiceUpdateResponseSchema;
     };
     /**
-     * Delete a filesystem
+     * Deletes a filesystem.
      *
      * @generated from rpc metalstack.admin.v2.FilesystemService.Delete
      */
diff --git a/js/metalstack/admin/v2/filesystem_pb.js b/js/metalstack/admin/v2/filesystem_pb.js
index 094f7f91..5b8c5fbc 100644
--- a/js/metalstack/admin/v2/filesystem_pb.js
+++ b/js/metalstack/admin/v2/filesystem_pb.js
@@ -41,7 +41,7 @@ export const FilesystemServiceDeleteRequestSchema = /*@__PURE__*/ messageDesc(fi
  */
 export const FilesystemServiceDeleteResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_filesystem, 5);
 /**
- * FilesystemService serves filesystem related functions
+ * FilesystemService provides filesystem management operations.
  *
  * @generated from service metalstack.admin.v2.FilesystemService
  */
diff --git a/js/metalstack/admin/v2/filesystem_pb.ts b/js/metalstack/admin/v2/filesystem_pb.ts
index e9ccab92..e242ef25 100644
--- a/js/metalstack/admin/v2/filesystem_pb.ts
+++ b/js/metalstack/admin/v2/filesystem_pb.ts
@@ -19,13 +19,13 @@ export const file_metalstack_admin_v2_filesystem: GenFile = /*@__PURE__*/
   fileDesc("CiRtZXRhbHN0YWNrL2FkbWluL3YyL2ZpbGVzeXN0ZW0ucHJvdG8SE21ldGFsc3RhY2suYWRtaW4udjIiYAoeRmlsZXN5c3RlbVNlcnZpY2VDcmVhdGVSZXF1ZXN0Ej4KEWZpbGVzeXN0ZW1fbGF5b3V0GAEgASgLMiMubWV0YWxzdGFjay5hcGkudjIuRmlsZXN5c3RlbUxheW91dCJhCh9GaWxlc3lzdGVtU2VydmljZUNyZWF0ZVJlc3BvbnNlEj4KEWZpbGVzeXN0ZW1fbGF5b3V0GAEgASgLMiMubWV0YWxzdGFjay5hcGkudjIuRmlsZXN5c3RlbUxheW91dCKPBAoeRmlsZXN5c3RlbVNlcnZpY2VVcGRhdGVSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBsCzrrECARI6Cgt1cGRhdGVfbWV0YRgCIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLlVwZGF0ZU1ldGFCBrpIA8gBARIeCgRuYW1lGAMgASgJQgu6SAhyBsCzrrECAUgAiAEBEiUKC2Rlc2NyaXB0aW9uGAQgASgJQgu6SAhyBsizrrECAUgBiAEBEjIKC2ZpbGVzeXN0ZW1zGAUgAygLMh0ubWV0YWxzdGFjay5hcGkudjIuRmlsZXN5c3RlbRImCgVkaXNrcxgGIAMoCzIXLm1ldGFsc3RhY2suYXBpLnYyLkRpc2sSJQoEcmFpZBgHIAMoCzIXLm1ldGFsc3RhY2suYXBpLnYyLlJhaWQSNQoNdm9sdW1lX2dyb3VwcxgIIAMoCzIeLm1ldGFsc3RhY2suYXBpLnYyLlZvbHVtZUdyb3VwEjkKD2xvZ2ljYWxfdm9sdW1lcxgJIAMoCzIgLm1ldGFsc3RhY2suYXBpLnYyLkxvZ2ljYWxWb2x1bWUSQwoLY29uc3RyYWludHMYCiABKAsyLi5tZXRhbHN0YWNrLmFwaS52Mi5GaWxlc3lzdGVtTGF5b3V0Q29uc3RyYWludHNCBwoFX25hbWVCDgoMX2Rlc2NyaXB0aW9uImEKH0ZpbGVzeXN0ZW1TZXJ2aWNlVXBkYXRlUmVzcG9uc2USPgoRZmlsZXN5c3RlbV9sYXlvdXQYASABKAsyIy5tZXRhbHN0YWNrLmFwaS52Mi5GaWxlc3lzdGVtTGF5b3V0IjkKHkZpbGVzeXN0ZW1TZXJ2aWNlRGVsZXRlUmVxdWVzdBIXCgJpZBgBIAEoCUILukgIcgbAs66xAgEiYQofRmlsZXN5c3RlbVNlcnZpY2VEZWxldGVSZXNwb25zZRI+ChFmaWxlc3lzdGVtX2xheW91dBgBIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLkZpbGVzeXN0ZW1MYXlvdXQykwMKEUZpbGVzeXN0ZW1TZXJ2aWNlEn4KBkNyZWF0ZRIzLm1ldGFsc3RhY2suYWRtaW4udjIuRmlsZXN5c3RlbVNlcnZpY2VDcmVhdGVSZXF1ZXN0GjQubWV0YWxzdGFjay5hZG1pbi52Mi5GaWxlc3lzdGVtU2VydmljZUNyZWF0ZVJlc3BvbnNlIgnS8xgBAeDzGAESfgoGVXBkYXRlEjMubWV0YWxzdGFjay5hZG1pbi52Mi5GaWxlc3lzdGVtU2VydmljZVVwZGF0ZVJlcXVlc3QaNC5tZXRhbHN0YWNrLmFkbWluLnYyLkZpbGVzeXN0ZW1TZXJ2aWNlVXBkYXRlUmVzcG9uc2UiCdLzGAEB4PMYARJ+CgZEZWxldGUSMy5tZXRhbHN0YWNrLmFkbWluLnYyLkZpbGVzeXN0ZW1TZXJ2aWNlRGVsZXRlUmVxdWVzdBo0Lm1ldGFsc3RhY2suYWRtaW4udjIuRmlsZXN5c3RlbVNlcnZpY2VEZWxldGVSZXNwb25zZSIJ0vMYAQHg8xgBQtMBChdjb20ubWV0YWxzdGFjay5hZG1pbi52MkIPRmlsZXN5c3RlbVByb3RvUAFaOWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYWRtaW4vdjI7YWRtaW52MqICA01BWKoCE01ldGFsc3RhY2suQWRtaW4uVjLKAhNNZXRhbHN0YWNrXEFkbWluXFYy4gIfTWV0YWxzdGFja1xBZG1pblxWMlxHUEJNZXRhZGF0YeoCFU1ldGFsc3RhY2s6OkFkbWluOjpWMmIGcHJvdG8z", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_filesystem, file_metalstack_api_v2_predefined_rules]);
 
 /**
- * FilesystemServiceCreateRequest
+ * FilesystemServiceCreateRequest is the request payload for creating a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceCreateRequest
  */
 export type FilesystemServiceCreateRequest = Message<"metalstack.admin.v2.FilesystemServiceCreateRequest"> & {
   /**
-   * FilesystemLayout the filesystemlayout
+   * FilesystemLayout is the filesystem layout to create
    *
    * @generated from field: metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
    */
@@ -40,13 +40,13 @@ export const FilesystemServiceCreateRequestSchema: GenMessage<FilesystemServiceC
   messageDesc(file_metalstack_admin_v2_filesystem, 0);
 
 /**
- * FilesystemServiceCreateResponse
+ * FilesystemServiceCreateResponse is the response payload for creating a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceCreateResponse
  */
 export type FilesystemServiceCreateResponse = Message<"metalstack.admin.v2.FilesystemServiceCreateResponse"> & {
   /**
-   * FilesystemLayout the filesystemlayout
+   * FilesystemLayout contains the created filesystem layout
    *
    * @generated from field: metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
    */
@@ -61,7 +61,7 @@ export const FilesystemServiceCreateResponseSchema: GenMessage<FilesystemService
   messageDesc(file_metalstack_admin_v2_filesystem, 1);
 
 /**
- * FilesystemServiceUpdateRequest
+ * FilesystemServiceUpdateRequest is the request payload for updating a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceUpdateRequest
  */
@@ -109,7 +109,7 @@ export type FilesystemServiceUpdateRequest = Message<"metalstack.admin.v2.Filesy
   disks: Disk[];
 
   /**
-   * raid arrays to create
+   * Raid arrays to create
    *
    * @generated from field: repeated metalstack.api.v2.Raid raid = 7;
    */
@@ -145,13 +145,13 @@ export const FilesystemServiceUpdateRequestSchema: GenMessage<FilesystemServiceU
   messageDesc(file_metalstack_admin_v2_filesystem, 2);
 
 /**
- * FilesystemServiceUpdateResponse
+ * FilesystemServiceUpdateResponse is the response payload for updating a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceUpdateResponse
  */
 export type FilesystemServiceUpdateResponse = Message<"metalstack.admin.v2.FilesystemServiceUpdateResponse"> & {
   /**
-   * FilesystemLayout the filesystemlayout
+   * FilesystemLayout contains the updated filesystem layout
    *
    * @generated from field: metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
    */
@@ -166,7 +166,7 @@ export const FilesystemServiceUpdateResponseSchema: GenMessage<FilesystemService
   messageDesc(file_metalstack_admin_v2_filesystem, 3);
 
 /**
- * FilesystemServiceDeleteRequest
+ * FilesystemServiceDeleteRequest is the request payload for deleting a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceDeleteRequest
  */
@@ -187,13 +187,13 @@ export const FilesystemServiceDeleteRequestSchema: GenMessage<FilesystemServiceD
   messageDesc(file_metalstack_admin_v2_filesystem, 4);
 
 /**
- * message FilesystemServiceDeleteResponse {
+ * FilesystemServiceDeleteResponse is the response payload for deleting a filesystem.
  *
  * @generated from message metalstack.admin.v2.FilesystemServiceDeleteResponse
  */
 export type FilesystemServiceDeleteResponse = Message<"metalstack.admin.v2.FilesystemServiceDeleteResponse"> & {
   /**
-   * FilesystemLayout the filesystemlayout
+   * FilesystemLayout contains the deleted filesystem layout
    *
    * @generated from field: metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
    */
@@ -208,13 +208,13 @@ export const FilesystemServiceDeleteResponseSchema: GenMessage<FilesystemService
   messageDesc(file_metalstack_admin_v2_filesystem, 5);
 
 /**
- * FilesystemService serves filesystem related functions
+ * FilesystemService provides filesystem management operations.
  *
  * @generated from service metalstack.admin.v2.FilesystemService
  */
 export const FilesystemService: GenService<{
   /**
-   * Create a filesystem
+   * Creates a new filesystem.
    *
    * @generated from rpc metalstack.admin.v2.FilesystemService.Create
    */
@@ -224,7 +224,7 @@ export const FilesystemService: GenService<{
     output: typeof FilesystemServiceCreateResponseSchema;
   },
   /**
-   * Update a filesystem
+   * Updates a filesystem.
    *
    * @generated from rpc metalstack.admin.v2.FilesystemService.Update
    */
@@ -234,7 +234,7 @@ export const FilesystemService: GenService<{
     output: typeof FilesystemServiceUpdateResponseSchema;
   },
   /**
-   * Delete a filesystem
+   * Deletes a filesystem.
    *
    * @generated from rpc metalstack.admin.v2.FilesystemService.Delete
    */
diff --git a/js/metalstack/admin/v2/image_pb.d.ts b/js/metalstack/admin/v2/image_pb.d.ts
index 68497726..d97674d4 100644
--- a/js/metalstack/admin/v2/image_pb.d.ts
+++ b/js/metalstack/admin/v2/image_pb.d.ts
@@ -8,13 +8,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_image: GenFile;
 /**
- * ImageServiceCreateRequest
+ * ImageServiceCreateRequest is the request payload for creating an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceCreateRequest
  */
 export type ImageServiceCreateRequest = Message<"metalstack.admin.v2.ImageServiceCreateRequest"> & {
     /**
-     * Image is the image
+     * Image is the image to create
      *
      * @generated from field: metalstack.api.v2.Image image = 1;
      */
@@ -26,13 +26,13 @@ export type ImageServiceCreateRequest = Message<"metalstack.admin.v2.ImageServic
  */
 export declare const ImageServiceCreateRequestSchema: GenMessage<ImageServiceCreateRequest>;
 /**
- * ImageServiceCreateResponse
+ * ImageServiceCreateResponse is the response payload for creating an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceCreateResponse
  */
 export type ImageServiceCreateResponse = Message<"metalstack.admin.v2.ImageServiceCreateResponse"> & {
     /**
-     * Image is the image
+     * Image contains the created image
      *
      * @generated from field: metalstack.api.v2.Image image = 1;
      */
@@ -44,7 +44,7 @@ export type ImageServiceCreateResponse = Message<"metalstack.admin.v2.ImageServi
  */
 export declare const ImageServiceCreateResponseSchema: GenMessage<ImageServiceCreateResponse>;
 /**
- * ImageServiceUpdateRequest
+ * ImageServiceUpdateRequest is the request payload for updating an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceUpdateRequest
  */
@@ -68,13 +68,13 @@ export type ImageServiceUpdateRequest = Message<"metalstack.admin.v2.ImageServic
      */
     url?: string;
     /**
-     * Name of this imageLayout
+     * Name of this image
      *
      * @generated from field: optional string name = 4;
      */
     name?: string;
     /**
-     * Description of this imageLayout
+     * Description of this image
      *
      * @generated from field: optional string description = 5;
      */
@@ -104,13 +104,13 @@ export type ImageServiceUpdateRequest = Message<"metalstack.admin.v2.ImageServic
  */
 export declare const ImageServiceUpdateRequestSchema: GenMessage<ImageServiceUpdateRequest>;
 /**
- * ImageServiceUpdateResponse
+ * ImageServiceUpdateResponse is the response payload for updating an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceUpdateResponse
  */
 export type ImageServiceUpdateResponse = Message<"metalstack.admin.v2.ImageServiceUpdateResponse"> & {
     /**
-     * Image is the image
+     * Image contains the updated image
      *
      * @generated from field: metalstack.api.v2.Image image = 1;
      */
@@ -122,7 +122,7 @@ export type ImageServiceUpdateResponse = Message<"metalstack.admin.v2.ImageServi
  */
 export declare const ImageServiceUpdateResponseSchema: GenMessage<ImageServiceUpdateResponse>;
 /**
- * ImageServiceDeleteRequest
+ * ImageServiceDeleteRequest is the request payload for deleting an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceDeleteRequest
  */
@@ -140,13 +140,13 @@ export type ImageServiceDeleteRequest = Message<"metalstack.admin.v2.ImageServic
  */
 export declare const ImageServiceDeleteRequestSchema: GenMessage<ImageServiceDeleteRequest>;
 /**
- * message ImageServiceDeleteResponse {
+ * ImageServiceDeleteResponse is the response payload for deleting an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceDeleteResponse
  */
 export type ImageServiceDeleteResponse = Message<"metalstack.admin.v2.ImageServiceDeleteResponse"> & {
     /**
-     * ImageLayout the imagelayout
+     * Image contains the deleted image
      *
      * @generated from field: metalstack.api.v2.Image image = 1;
      */
@@ -158,7 +158,7 @@ export type ImageServiceDeleteResponse = Message<"metalstack.admin.v2.ImageServi
  */
 export declare const ImageServiceDeleteResponseSchema: GenMessage<ImageServiceDeleteResponse>;
 /**
- * ImageServiceUsageRequest
+ * ImageServiceUsageRequest is the request payload for getting image usage.
  *
  * @generated from message metalstack.admin.v2.ImageServiceUsageRequest
  */
@@ -176,13 +176,13 @@ export type ImageServiceUsageRequest = Message<"metalstack.admin.v2.ImageService
  */
 export declare const ImageServiceUsageRequestSchema: GenMessage<ImageServiceUsageRequest>;
 /**
- * ImageServiceUsageResponse
+ * ImageServiceUsageResponse is the response payload for getting image usage.
  *
  * @generated from message metalstack.admin.v2.ImageServiceUsageResponse
  */
 export type ImageServiceUsageResponse = Message<"metalstack.admin.v2.ImageServiceUsageResponse"> & {
     /**
-     * Images with usage
+     * Images contains usage information
      *
      * @generated from field: repeated metalstack.api.v2.ImageUsage image_usage = 1;
      */
@@ -194,13 +194,13 @@ export type ImageServiceUsageResponse = Message<"metalstack.admin.v2.ImageServic
  */
 export declare const ImageServiceUsageResponseSchema: GenMessage<ImageServiceUsageResponse>;
 /**
- * ImageService serves image related functions
+ * ImageService provides image management operations.
  *
  * @generated from service metalstack.admin.v2.ImageService
  */
 export declare const ImageService: GenService<{
     /**
-     * Create a image
+     * Creates a new image.
      *
      * @generated from rpc metalstack.admin.v2.ImageService.Create
      */
@@ -210,7 +210,7 @@ export declare const ImageService: GenService<{
         output: typeof ImageServiceCreateResponseSchema;
     };
     /**
-     * Update a image
+     * Updates an image.
      *
      * @generated from rpc metalstack.admin.v2.ImageService.Update
      */
@@ -220,7 +220,7 @@ export declare const ImageService: GenService<{
         output: typeof ImageServiceUpdateResponseSchema;
     };
     /**
-     * Delete a image
+     * Deletes an image.
      *
      * @generated from rpc metalstack.admin.v2.ImageService.Delete
      */
@@ -230,7 +230,7 @@ export declare const ImageService: GenService<{
         output: typeof ImageServiceDeleteResponseSchema;
     };
     /**
-     * Usage of images
+     * Returns the usage of images.
      *
      * @generated from rpc metalstack.admin.v2.ImageService.Usage
      */
diff --git a/js/metalstack/admin/v2/image_pb.js b/js/metalstack/admin/v2/image_pb.js
index 463d4f9e..f1598c25 100644
--- a/js/metalstack/admin/v2/image_pb.js
+++ b/js/metalstack/admin/v2/image_pb.js
@@ -52,7 +52,7 @@ export const ImageServiceUsageRequestSchema = /*@__PURE__*/ messageDesc(file_met
  */
 export const ImageServiceUsageResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_image, 7);
 /**
- * ImageService serves image related functions
+ * ImageService provides image management operations.
  *
  * @generated from service metalstack.admin.v2.ImageService
  */
diff --git a/js/metalstack/admin/v2/image_pb.ts b/js/metalstack/admin/v2/image_pb.ts
index bab9b012..280cfedb 100644
--- a/js/metalstack/admin/v2/image_pb.ts
+++ b/js/metalstack/admin/v2/image_pb.ts
@@ -21,13 +21,13 @@ export const file_metalstack_admin_v2_image: GenFile = /*@__PURE__*/
   fileDesc("Ch9tZXRhbHN0YWNrL2FkbWluL3YyL2ltYWdlLnByb3RvEhNtZXRhbHN0YWNrLmFkbWluLnYyIkQKGUltYWdlU2VydmljZUNyZWF0ZVJlcXVlc3QSJwoFaW1hZ2UYASABKAsyGC5tZXRhbHN0YWNrLmFwaS52Mi5JbWFnZSJFChpJbWFnZVNlcnZpY2VDcmVhdGVSZXNwb25zZRInCgVpbWFnZRgBIAEoCzIYLm1ldGFsc3RhY2suYXBpLnYyLkltYWdlIrUDChlJbWFnZVNlcnZpY2VVcGRhdGVSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBsCzrrECARI6Cgt1cGRhdGVfbWV0YRgCIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLlVwZGF0ZU1ldGFCBrpIA8gBARIdCgN1cmwYAyABKAlCC7pICHIG4LOusQIBSACIAQESHgoEbmFtZRgEIAEoCUILukgIcgbAs66xAgFIAYgBARIlCgtkZXNjcmlwdGlvbhgFIAEoCUILukgIcgbIs66xAgFIAogBARJCCghmZWF0dXJlcxgGIAMoDjIfLm1ldGFsc3RhY2suYXBpLnYyLkltYWdlRmVhdHVyZUIPukgMkgEJGAEiBYIBAhABEkgKDmNsYXNzaWZpY2F0aW9uGAcgASgOMiYubWV0YWxzdGFjay5hcGkudjIuSW1hZ2VDbGFzc2lmaWNhdGlvbkIIukgFggECEAESLgoKZXhwaXJlc19hdBgIIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBCBgoEX3VybEIHCgVfbmFtZUIOCgxfZGVzY3JpcHRpb24iRQoaSW1hZ2VTZXJ2aWNlVXBkYXRlUmVzcG9uc2USJwoFaW1hZ2UYASABKAsyGC5tZXRhbHN0YWNrLmFwaS52Mi5JbWFnZSI0ChlJbWFnZVNlcnZpY2VEZWxldGVSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBsCzrrECASJFChpJbWFnZVNlcnZpY2VEZWxldGVSZXNwb25zZRInCgVpbWFnZRgBIAEoCzIYLm1ldGFsc3RhY2suYXBpLnYyLkltYWdlIkgKGEltYWdlU2VydmljZVVzYWdlUmVxdWVzdBIsCgVxdWVyeRgBIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLkltYWdlUXVlcnkiTwoZSW1hZ2VTZXJ2aWNlVXNhZ2VSZXNwb25zZRIyCgtpbWFnZV91c2FnZRgBIAMoCzIdLm1ldGFsc3RhY2suYXBpLnYyLkltYWdlVXNhZ2Uy4AMKDEltYWdlU2VydmljZRJ0CgZDcmVhdGUSLi5tZXRhbHN0YWNrLmFkbWluLnYyLkltYWdlU2VydmljZUNyZWF0ZVJlcXVlc3QaLy5tZXRhbHN0YWNrLmFkbWluLnYyLkltYWdlU2VydmljZUNyZWF0ZVJlc3BvbnNlIgnS8xgBAeDzGAESdAoGVXBkYXRlEi4ubWV0YWxzdGFjay5hZG1pbi52Mi5JbWFnZVNlcnZpY2VVcGRhdGVSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hZG1pbi52Mi5JbWFnZVNlcnZpY2VVcGRhdGVSZXNwb25zZSIJ0vMYAQHg8xgBEnQKBkRlbGV0ZRIuLm1ldGFsc3RhY2suYWRtaW4udjIuSW1hZ2VTZXJ2aWNlRGVsZXRlUmVxdWVzdBovLm1ldGFsc3RhY2suYWRtaW4udjIuSW1hZ2VTZXJ2aWNlRGVsZXRlUmVzcG9uc2UiCdLzGAEB4PMYARJuCgVVc2FnZRItLm1ldGFsc3RhY2suYWRtaW4udjIuSW1hZ2VTZXJ2aWNlVXNhZ2VSZXF1ZXN0Gi4ubWV0YWxzdGFjay5hZG1pbi52Mi5JbWFnZVNlcnZpY2VVc2FnZVJlc3BvbnNlIgbS8xgCAQJCzgEKF2NvbS5tZXRhbHN0YWNrLmFkbWluLnYyQgpJbWFnZVByb3RvUAFaOWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYWRtaW4vdjI7YWRtaW52MqICA01BWKoCE01ldGFsc3RhY2suQWRtaW4uVjLKAhNNZXRhbHN0YWNrXEFkbWluXFYy4gIfTWV0YWxzdGFja1xBZG1pblxWMlxHUEJNZXRhZGF0YeoCFU1ldGFsc3RhY2s6OkFkbWluOjpWMmIGcHJvdG8z", [file_buf_validate_validate, file_google_protobuf_timestamp, file_metalstack_api_v2_common, file_metalstack_api_v2_image, file_metalstack_api_v2_predefined_rules]);
 
 /**
- * ImageServiceCreateRequest
+ * ImageServiceCreateRequest is the request payload for creating an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceCreateRequest
  */
 export type ImageServiceCreateRequest = Message<"metalstack.admin.v2.ImageServiceCreateRequest"> & {
   /**
-   * Image is the image
+   * Image is the image to create
    *
    * @generated from field: metalstack.api.v2.Image image = 1;
    */
@@ -42,13 +42,13 @@ export const ImageServiceCreateRequestSchema: GenMessage<ImageServiceCreateReque
   messageDesc(file_metalstack_admin_v2_image, 0);
 
 /**
- * ImageServiceCreateResponse
+ * ImageServiceCreateResponse is the response payload for creating an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceCreateResponse
  */
 export type ImageServiceCreateResponse = Message<"metalstack.admin.v2.ImageServiceCreateResponse"> & {
   /**
-   * Image is the image
+   * Image contains the created image
    *
    * @generated from field: metalstack.api.v2.Image image = 1;
    */
@@ -63,7 +63,7 @@ export const ImageServiceCreateResponseSchema: GenMessage<ImageServiceCreateResp
   messageDesc(file_metalstack_admin_v2_image, 1);
 
 /**
- * ImageServiceUpdateRequest
+ * ImageServiceUpdateRequest is the request payload for updating an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceUpdateRequest
  */
@@ -90,14 +90,14 @@ export type ImageServiceUpdateRequest = Message<"metalstack.admin.v2.ImageServic
   url?: string;
 
   /**
-   * Name of this imageLayout
+   * Name of this image
    *
    * @generated from field: optional string name = 4;
    */
   name?: string;
 
   /**
-   * Description of this imageLayout
+   * Description of this image
    *
    * @generated from field: optional string description = 5;
    */
@@ -133,13 +133,13 @@ export const ImageServiceUpdateRequestSchema: GenMessage<ImageServiceUpdateReque
   messageDesc(file_metalstack_admin_v2_image, 2);
 
 /**
- * ImageServiceUpdateResponse
+ * ImageServiceUpdateResponse is the response payload for updating an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceUpdateResponse
  */
 export type ImageServiceUpdateResponse = Message<"metalstack.admin.v2.ImageServiceUpdateResponse"> & {
   /**
-   * Image is the image
+   * Image contains the updated image
    *
    * @generated from field: metalstack.api.v2.Image image = 1;
    */
@@ -154,7 +154,7 @@ export const ImageServiceUpdateResponseSchema: GenMessage<ImageServiceUpdateResp
   messageDesc(file_metalstack_admin_v2_image, 3);
 
 /**
- * ImageServiceDeleteRequest
+ * ImageServiceDeleteRequest is the request payload for deleting an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceDeleteRequest
  */
@@ -175,13 +175,13 @@ export const ImageServiceDeleteRequestSchema: GenMessage<ImageServiceDeleteReque
   messageDesc(file_metalstack_admin_v2_image, 4);
 
 /**
- * message ImageServiceDeleteResponse {
+ * ImageServiceDeleteResponse is the response payload for deleting an image.
  *
  * @generated from message metalstack.admin.v2.ImageServiceDeleteResponse
  */
 export type ImageServiceDeleteResponse = Message<"metalstack.admin.v2.ImageServiceDeleteResponse"> & {
   /**
-   * ImageLayout the imagelayout
+   * Image contains the deleted image
    *
    * @generated from field: metalstack.api.v2.Image image = 1;
    */
@@ -196,7 +196,7 @@ export const ImageServiceDeleteResponseSchema: GenMessage<ImageServiceDeleteResp
   messageDesc(file_metalstack_admin_v2_image, 5);
 
 /**
- * ImageServiceUsageRequest
+ * ImageServiceUsageRequest is the request payload for getting image usage.
  *
  * @generated from message metalstack.admin.v2.ImageServiceUsageRequest
  */
@@ -217,13 +217,13 @@ export const ImageServiceUsageRequestSchema: GenMessage<ImageServiceUsageRequest
   messageDesc(file_metalstack_admin_v2_image, 6);
 
 /**
- * ImageServiceUsageResponse
+ * ImageServiceUsageResponse is the response payload for getting image usage.
  *
  * @generated from message metalstack.admin.v2.ImageServiceUsageResponse
  */
 export type ImageServiceUsageResponse = Message<"metalstack.admin.v2.ImageServiceUsageResponse"> & {
   /**
-   * Images with usage
+   * Images contains usage information
    *
    * @generated from field: repeated metalstack.api.v2.ImageUsage image_usage = 1;
    */
@@ -238,13 +238,13 @@ export const ImageServiceUsageResponseSchema: GenMessage<ImageServiceUsageRespon
   messageDesc(file_metalstack_admin_v2_image, 7);
 
 /**
- * ImageService serves image related functions
+ * ImageService provides image management operations.
  *
  * @generated from service metalstack.admin.v2.ImageService
  */
 export const ImageService: GenService<{
   /**
-   * Create a image
+   * Creates a new image.
    *
    * @generated from rpc metalstack.admin.v2.ImageService.Create
    */
@@ -254,7 +254,7 @@ export const ImageService: GenService<{
     output: typeof ImageServiceCreateResponseSchema;
   },
   /**
-   * Update a image
+   * Updates an image.
    *
    * @generated from rpc metalstack.admin.v2.ImageService.Update
    */
@@ -264,7 +264,7 @@ export const ImageService: GenService<{
     output: typeof ImageServiceUpdateResponseSchema;
   },
   /**
-   * Delete a image
+   * Deletes an image.
    *
    * @generated from rpc metalstack.admin.v2.ImageService.Delete
    */
@@ -274,7 +274,7 @@ export const ImageService: GenService<{
     output: typeof ImageServiceDeleteResponseSchema;
   },
   /**
-   * Usage of images
+   * Returns the usage of images.
    *
    * @generated from rpc metalstack.admin.v2.ImageService.Usage
    */
diff --git a/js/metalstack/admin/v2/ip_pb.d.ts b/js/metalstack/admin/v2/ip_pb.d.ts
index b89a5f81..ec6ed3c9 100644
--- a/js/metalstack/admin/v2/ip_pb.d.ts
+++ b/js/metalstack/admin/v2/ip_pb.d.ts
@@ -6,13 +6,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_ip: GenFile;
 /**
- * IPServiceListRequest
+ * IPServiceListRequest is the request payload for listing IP addresses.
  *
  * @generated from message metalstack.admin.v2.IPServiceListRequest
  */
 export type IPServiceListRequest = Message<"metalstack.admin.v2.IPServiceListRequest"> & {
     /**
-     * Query to search for one or more ips
+     * Query to search for IP addresses
      *
      * @generated from field: metalstack.api.v2.IPQuery query = 1;
      */
@@ -24,13 +24,13 @@ export type IPServiceListRequest = Message<"metalstack.admin.v2.IPServiceListReq
  */
 export declare const IPServiceListRequestSchema: GenMessage<IPServiceListRequest>;
 /**
- * IPServiceListResponse
+ * IPServiceListResponse is the response payload for listing IP addresses.
  *
  * @generated from message metalstack.admin.v2.IPServiceListResponse
  */
 export type IPServiceListResponse = Message<"metalstack.admin.v2.IPServiceListResponse"> & {
     /**
-     * IPs are the list of ips
+     * IPs contains the list of IP addresses
      *
      * @generated from field: repeated metalstack.api.v2.IP ips = 1;
      */
@@ -42,13 +42,13 @@ export type IPServiceListResponse = Message<"metalstack.admin.v2.IPServiceListRe
  */
 export declare const IPServiceListResponseSchema: GenMessage<IPServiceListResponse>;
 /**
- * IPService serves ip address related functions
+ * IPService provides IP address management operations.
  *
  * @generated from service metalstack.admin.v2.IPService
  */
 export declare const IPService: GenService<{
     /**
-     * List all ips
+     * Returns the list of all IP addresses.
      *
      * @generated from rpc metalstack.admin.v2.IPService.List
      */
diff --git a/js/metalstack/admin/v2/ip_pb.js b/js/metalstack/admin/v2/ip_pb.js
index b40556f3..c95d9156 100644
--- a/js/metalstack/admin/v2/ip_pb.js
+++ b/js/metalstack/admin/v2/ip_pb.js
@@ -19,7 +19,7 @@ export const IPServiceListRequestSchema = /*@__PURE__*/ messageDesc(file_metalst
  */
 export const IPServiceListResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_ip, 1);
 /**
- * IPService serves ip address related functions
+ * IPService provides IP address management operations.
  *
  * @generated from service metalstack.admin.v2.IPService
  */
diff --git a/js/metalstack/admin/v2/ip_pb.ts b/js/metalstack/admin/v2/ip_pb.ts
index 358e51d4..90fba6e0 100644
--- a/js/metalstack/admin/v2/ip_pb.ts
+++ b/js/metalstack/admin/v2/ip_pb.ts
@@ -16,13 +16,13 @@ export const file_metalstack_admin_v2_ip: GenFile = /*@__PURE__*/
   fileDesc("ChxtZXRhbHN0YWNrL2FkbWluL3YyL2lwLnByb3RvEhNtZXRhbHN0YWNrLmFkbWluLnYyIkEKFElQU2VydmljZUxpc3RSZXF1ZXN0EikKBXF1ZXJ5GAEgASgLMhoubWV0YWxzdGFjay5hcGkudjIuSVBRdWVyeSI7ChVJUFNlcnZpY2VMaXN0UmVzcG9uc2USIgoDaXBzGAEgAygLMhUubWV0YWxzdGFjay5hcGkudjIuSVAydgoJSVBTZXJ2aWNlEmkKBExpc3QSKS5tZXRhbHN0YWNrLmFkbWluLnYyLklQU2VydmljZUxpc3RSZXF1ZXN0GioubWV0YWxzdGFjay5hZG1pbi52Mi5JUFNlcnZpY2VMaXN0UmVzcG9uc2UiCtLzGAIBAuDzGAJCywEKF2NvbS5tZXRhbHN0YWNrLmFkbWluLnYyQgdJcFByb3RvUAFaOWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYWRtaW4vdjI7YWRtaW52MqICA01BWKoCE01ldGFsc3RhY2suQWRtaW4uVjLKAhNNZXRhbHN0YWNrXEFkbWluXFYy4gIfTWV0YWxzdGFja1xBZG1pblxWMlxHUEJNZXRhZGF0YeoCFU1ldGFsc3RhY2s6OkFkbWluOjpWMmIGcHJvdG8z", [file_metalstack_api_v2_common, file_metalstack_api_v2_ip]);
 
 /**
- * IPServiceListRequest
+ * IPServiceListRequest is the request payload for listing IP addresses.
  *
  * @generated from message metalstack.admin.v2.IPServiceListRequest
  */
 export type IPServiceListRequest = Message<"metalstack.admin.v2.IPServiceListRequest"> & {
   /**
-   * Query to search for one or more ips
+   * Query to search for IP addresses
    *
    * @generated from field: metalstack.api.v2.IPQuery query = 1;
    */
@@ -37,13 +37,13 @@ export const IPServiceListRequestSchema: GenMessage<IPServiceListRequest> = /*@_
   messageDesc(file_metalstack_admin_v2_ip, 0);
 
 /**
- * IPServiceListResponse
+ * IPServiceListResponse is the response payload for listing IP addresses.
  *
  * @generated from message metalstack.admin.v2.IPServiceListResponse
  */
 export type IPServiceListResponse = Message<"metalstack.admin.v2.IPServiceListResponse"> & {
   /**
-   * IPs are the list of ips
+   * IPs contains the list of IP addresses
    *
    * @generated from field: repeated metalstack.api.v2.IP ips = 1;
    */
@@ -58,13 +58,13 @@ export const IPServiceListResponseSchema: GenMessage<IPServiceListResponse> = /*
   messageDesc(file_metalstack_admin_v2_ip, 1);
 
 /**
- * IPService serves ip address related functions
+ * IPService provides IP address management operations.
  *
  * @generated from service metalstack.admin.v2.IPService
  */
 export const IPService: GenService<{
   /**
-   * List all ips
+   * Returns the list of all IP addresses.
    *
    * @generated from rpc metalstack.admin.v2.IPService.List
    */
diff --git a/js/metalstack/admin/v2/machine_pb.d.ts b/js/metalstack/admin/v2/machine_pb.d.ts
index 3e8b6c14..454b98bb 100644
--- a/js/metalstack/admin/v2/machine_pb.d.ts
+++ b/js/metalstack/admin/v2/machine_pb.d.ts
@@ -200,7 +200,7 @@ export type MachineServiceListBMCResponse = Message<"metalstack.admin.v2.Machine
  */
 export declare const MachineServiceListBMCResponseSchema: GenMessage<MachineServiceListBMCResponse>;
 /**
- * MachineServiceConsolePasswordRequest is the request to get the console password
+ * MachineServiceConsolePasswordRequest is the request payload for getting the console password.
  *
  * @generated from message metalstack.admin.v2.MachineServiceConsolePasswordRequest
  */
@@ -212,7 +212,7 @@ export type MachineServiceConsolePasswordRequest = Message<"metalstack.admin.v2.
      */
     uuid: string;
     /**
-     * Reason must be provided why access to the console is requested.
+     * Reason must be provided why access to the console is requested
      * Reason is only forwarded to an audit sink
      *
      * @generated from field: string reason = 2;
@@ -225,7 +225,7 @@ export type MachineServiceConsolePasswordRequest = Message<"metalstack.admin.v2.
  */
 export declare const MachineServiceConsolePasswordRequestSchema: GenMessage<MachineServiceConsolePasswordRequest>;
 /**
- * MachineServiceConsolePasswordResponse is the response to the console password request
+ * MachineServiceConsolePasswordResponse is the response payload for getting the console password.
  *
  * @generated from message metalstack.admin.v2.MachineServiceConsolePasswordResponse
  */
@@ -249,13 +249,13 @@ export type MachineServiceConsolePasswordResponse = Message<"metalstack.admin.v2
  */
 export declare const MachineServiceConsolePasswordResponseSchema: GenMessage<MachineServiceConsolePasswordResponse>;
 /**
- * MachineService serves machine related functions
+ * MachineService provides machine lifecycle management operations.
  *
  * @generated from service metalstack.admin.v2.MachineService
  */
 export declare const MachineService: GenService<{
     /**
-     * Get a machine
+     * Returns the machine with the specified UUID.
      *
      * @generated from rpc metalstack.admin.v2.MachineService.Get
      */
@@ -265,7 +265,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceGetResponseSchema;
     };
     /**
-     * List all machines
+     * Returns the list of all machines.
      *
      * @generated from rpc metalstack.admin.v2.MachineService.List
      */
@@ -275,7 +275,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceListResponseSchema;
     };
     /**
-     * BMCCommand send a command to the bmc of a machine
+     * BMCCommand sends a command to the BMC of a machine.
      *
      * @generated from rpc metalstack.admin.v2.MachineService.BMCCommand
      */
@@ -285,7 +285,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceBMCCommandResponseSchema;
     };
     /**
-     * GetBMC returns the BMC details of a machine
+     * Returns the BMC details of a machine.
      *
      * @generated from rpc metalstack.admin.v2.MachineService.GetBMC
      */
@@ -295,7 +295,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceGetBMCResponseSchema;
     };
     /**
-     * ListBMC returns the BMC details of many machines
+     * ListBMC returns the BMC details of many machines.
      *
      * @generated from rpc metalstack.admin.v2.MachineService.ListBMC
      */
@@ -305,7 +305,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceListBMCResponseSchema;
     };
     /**
-     * ConsolePassword returns the password to access the serial console of the machine
+     * GetConsolePassword returns the password to access the serial console of the machine.
      *
      * @generated from rpc metalstack.admin.v2.MachineService.ConsolePassword
      */
diff --git a/js/metalstack/admin/v2/machine_pb.js b/js/metalstack/admin/v2/machine_pb.js
index fec84223..330888d0 100644
--- a/js/metalstack/admin/v2/machine_pb.js
+++ b/js/metalstack/admin/v2/machine_pb.js
@@ -71,7 +71,7 @@ export const MachineServiceConsolePasswordRequestSchema = /*@__PURE__*/ messageD
  */
 export const MachineServiceConsolePasswordResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_machine, 11);
 /**
- * MachineService serves machine related functions
+ * MachineService provides machine lifecycle management operations.
  *
  * @generated from service metalstack.admin.v2.MachineService
  */
diff --git a/js/metalstack/admin/v2/machine_pb.ts b/js/metalstack/admin/v2/machine_pb.ts
index cc2a39ef..0a5b8a10 100644
--- a/js/metalstack/admin/v2/machine_pb.ts
+++ b/js/metalstack/admin/v2/machine_pb.ts
@@ -244,7 +244,7 @@ export const MachineServiceListBMCResponseSchema: GenMessage<MachineServiceListB
   messageDesc(file_metalstack_admin_v2_machine, 9);
 
 /**
- * MachineServiceConsolePasswordRequest is the request to get the console password
+ * MachineServiceConsolePasswordRequest is the request payload for getting the console password.
  *
  * @generated from message metalstack.admin.v2.MachineServiceConsolePasswordRequest
  */
@@ -257,7 +257,7 @@ export type MachineServiceConsolePasswordRequest = Message<"metalstack.admin.v2.
   uuid: string;
 
   /**
-   * Reason must be provided why access to the console is requested.
+   * Reason must be provided why access to the console is requested
    * Reason is only forwarded to an audit sink
    *
    * @generated from field: string reason = 2;
@@ -273,7 +273,7 @@ export const MachineServiceConsolePasswordRequestSchema: GenMessage<MachineServi
   messageDesc(file_metalstack_admin_v2_machine, 10);
 
 /**
- * MachineServiceConsolePasswordResponse is the response to the console password request
+ * MachineServiceConsolePasswordResponse is the response payload for getting the console password.
  *
  * @generated from message metalstack.admin.v2.MachineServiceConsolePasswordResponse
  */
@@ -301,13 +301,13 @@ export const MachineServiceConsolePasswordResponseSchema: GenMessage<MachineServ
   messageDesc(file_metalstack_admin_v2_machine, 11);
 
 /**
- * MachineService serves machine related functions
+ * MachineService provides machine lifecycle management operations.
  *
  * @generated from service metalstack.admin.v2.MachineService
  */
 export const MachineService: GenService<{
   /**
-   * Get a machine
+   * Returns the machine with the specified UUID.
    *
    * @generated from rpc metalstack.admin.v2.MachineService.Get
    */
@@ -317,7 +317,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceGetResponseSchema;
   },
   /**
-   * List all machines
+   * Returns the list of all machines.
    *
    * @generated from rpc metalstack.admin.v2.MachineService.List
    */
@@ -327,7 +327,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceListResponseSchema;
   },
   /**
-   * BMCCommand send a command to the bmc of a machine
+   * BMCCommand sends a command to the BMC of a machine.
    *
    * @generated from rpc metalstack.admin.v2.MachineService.BMCCommand
    */
@@ -337,7 +337,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceBMCCommandResponseSchema;
   },
   /**
-   * GetBMC returns the BMC details of a machine
+   * Returns the BMC details of a machine.
    *
    * @generated from rpc metalstack.admin.v2.MachineService.GetBMC
    */
@@ -347,7 +347,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceGetBMCResponseSchema;
   },
   /**
-   * ListBMC returns the BMC details of many machines
+   * ListBMC returns the BMC details of many machines.
    *
    * @generated from rpc metalstack.admin.v2.MachineService.ListBMC
    */
@@ -357,7 +357,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceListBMCResponseSchema;
   },
   /**
-   * ConsolePassword returns the password to access the serial console of the machine
+   * GetConsolePassword returns the password to access the serial console of the machine.
    *
    * @generated from rpc metalstack.admin.v2.MachineService.ConsolePassword
    */
diff --git a/js/metalstack/admin/v2/network_pb.d.ts b/js/metalstack/admin/v2/network_pb.d.ts
index 82566b06..2ab87294 100644
--- a/js/metalstack/admin/v2/network_pb.d.ts
+++ b/js/metalstack/admin/v2/network_pb.d.ts
@@ -7,7 +7,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_network: GenFile;
 /**
- * NetworkServiceGetRequest
+ * NetworkServiceGetRequest is the request payload for getting a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceGetRequest
  */
@@ -25,13 +25,13 @@ export type NetworkServiceGetRequest = Message<"metalstack.admin.v2.NetworkServi
  */
 export declare const NetworkServiceGetRequestSchema: GenMessage<NetworkServiceGetRequest>;
 /**
- * NetworkServiceGetResponse
+ * NetworkServiceGetResponse is the response payload for getting a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceGetResponse
  */
 export type NetworkServiceGetResponse = Message<"metalstack.admin.v2.NetworkServiceGetResponse"> & {
     /**
-     * Network which was requested to get
+     * Network contains the requested network
      *
      * @generated from field: metalstack.api.v2.Network network = 1;
      */
@@ -43,7 +43,7 @@ export type NetworkServiceGetResponse = Message<"metalstack.admin.v2.NetworkServ
  */
 export declare const NetworkServiceGetResponseSchema: GenMessage<NetworkServiceGetResponse>;
 /**
- * NetworkServiceCreateRequest
+ * NetworkServiceCreateRequest is the request payload for creating a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceCreateRequest
  */
@@ -121,7 +121,7 @@ export type NetworkServiceCreateRequest = Message<"metalstack.admin.v2.NetworkSe
      */
     natType?: NATType;
     /**
-     * VRF of this network has this VNI.
+     * VRF of this network has this VNI
      *
      * @generated from field: optional uint32 vrf = 13;
      */
@@ -157,7 +157,7 @@ export type NetworkServiceCreateRequest = Message<"metalstack.admin.v2.NetworkSe
  */
 export declare const NetworkServiceCreateRequestSchema: GenMessage<NetworkServiceCreateRequest>;
 /**
- * NetworkServiceUpdateRequest is the request payload for a network update request
+ * NetworkServiceUpdateRequest is the request payload for updating a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceUpdateRequest
  */
@@ -205,7 +205,7 @@ export type NetworkServiceUpdateRequest = Message<"metalstack.admin.v2.NetworkSe
      */
     destinationPrefixes: string[];
     /**
-     * Default Child Prefix length defines the bit length of a child network created per addressfamily, of not specified during the allocate request
+     * Default Child Prefix length defines the bit length of a child network created per addressfamily, if not specified during the allocate request
      *
      * @generated from field: optional metalstack.api.v2.ChildPrefixLength default_child_prefix_length = 8;
      */
@@ -229,7 +229,7 @@ export type NetworkServiceUpdateRequest = Message<"metalstack.admin.v2.NetworkSe
      */
     additionalAnnouncableCidrs: string[];
     /**
-     * Force update, actually only prevents accidental removal of additional_announcable_cidrs which will destroy your dataplane in fact.
+     * Force update, prevents accidental removal of additional_announcable_cidrs which will destroy your dataplane.
      *
      * @generated from field: bool force = 12;
      */
@@ -241,7 +241,7 @@ export type NetworkServiceUpdateRequest = Message<"metalstack.admin.v2.NetworkSe
  */
 export declare const NetworkServiceUpdateRequestSchema: GenMessage<NetworkServiceUpdateRequest>;
 /**
- * NetworkServiceDeleteRequest is the request payload for a network delete request
+ * NetworkServiceDeleteRequest is the request payload for deleting a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceDeleteRequest
  */
@@ -259,13 +259,13 @@ export type NetworkServiceDeleteRequest = Message<"metalstack.admin.v2.NetworkSe
  */
 export declare const NetworkServiceDeleteRequestSchema: GenMessage<NetworkServiceDeleteRequest>;
 /**
- * NetworkServiceListRequest
+ * NetworkServiceListRequest is the request payload for listing networks.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceListRequest
  */
 export type NetworkServiceListRequest = Message<"metalstack.admin.v2.NetworkServiceListRequest"> & {
     /**
-     * Query which specifies which networks to return
+     * Query specifies which networks to return
      *
      * @generated from field: metalstack.api.v2.NetworkQuery query = 2;
      */
@@ -277,13 +277,13 @@ export type NetworkServiceListRequest = Message<"metalstack.admin.v2.NetworkServ
  */
 export declare const NetworkServiceListRequestSchema: GenMessage<NetworkServiceListRequest>;
 /**
- * NetworkServiceCreateResponse is the response payload for a network create request
+ * NetworkServiceCreateResponse is the response payload for creating a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceCreateResponse
  */
 export type NetworkServiceCreateResponse = Message<"metalstack.admin.v2.NetworkServiceCreateResponse"> & {
     /**
-     * Network the network
+     * Network contains the created network
      *
      * @generated from field: metalstack.api.v2.Network network = 1;
      */
@@ -295,13 +295,13 @@ export type NetworkServiceCreateResponse = Message<"metalstack.admin.v2.NetworkS
  */
 export declare const NetworkServiceCreateResponseSchema: GenMessage<NetworkServiceCreateResponse>;
 /**
- * NetworkServiceUpdateResponse is the response payload for a network update request
+ * NetworkServiceUpdateResponse is the response payload for updating a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceUpdateResponse
  */
 export type NetworkServiceUpdateResponse = Message<"metalstack.admin.v2.NetworkServiceUpdateResponse"> & {
     /**
-     * Network the network
+     * Network contains the updated network
      *
      * @generated from field: metalstack.api.v2.Network network = 1;
      */
@@ -313,13 +313,13 @@ export type NetworkServiceUpdateResponse = Message<"metalstack.admin.v2.NetworkS
  */
 export declare const NetworkServiceUpdateResponseSchema: GenMessage<NetworkServiceUpdateResponse>;
 /**
- * NetworkServiceCapacityResponse is the response payload for a network delete request
+ * NetworkServiceDeleteResponse is the response payload for deleting a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceDeleteResponse
  */
 export type NetworkServiceDeleteResponse = Message<"metalstack.admin.v2.NetworkServiceDeleteResponse"> & {
     /**
-     * Network the network
+     * Network contains the deleted network
      *
      * @generated from field: metalstack.api.v2.Network network = 1;
      */
@@ -331,13 +331,13 @@ export type NetworkServiceDeleteResponse = Message<"metalstack.admin.v2.NetworkS
  */
 export declare const NetworkServiceDeleteResponseSchema: GenMessage<NetworkServiceDeleteResponse>;
 /**
- * NetworkServiceListResponse
+ * NetworkServiceListResponse is the response payload for listing networks.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceListResponse
  */
 export type NetworkServiceListResponse = Message<"metalstack.admin.v2.NetworkServiceListResponse"> & {
     /**
-     * Networks are the requested networks
+     * Networks contains the list of networks
      *
      * @generated from field: repeated metalstack.api.v2.Network networks = 1;
      */
@@ -349,13 +349,13 @@ export type NetworkServiceListResponse = Message<"metalstack.admin.v2.NetworkSer
  */
 export declare const NetworkServiceListResponseSchema: GenMessage<NetworkServiceListResponse>;
 /**
- * NetworkService serves network address related functions
+ * NetworkService provides network management operations.
  *
  * @generated from service metalstack.admin.v2.NetworkService
  */
 export declare const NetworkService: GenService<{
     /**
-     * Get a network
+     * Returns the network with the specified ID.
      *
      * @generated from rpc metalstack.admin.v2.NetworkService.Get
      */
@@ -365,7 +365,7 @@ export declare const NetworkService: GenService<{
         output: typeof NetworkServiceGetResponseSchema;
     };
     /**
-     * Create a network
+     * Creates a new network.
      *
      * @generated from rpc metalstack.admin.v2.NetworkService.Create
      */
@@ -375,7 +375,7 @@ export declare const NetworkService: GenService<{
         output: typeof NetworkServiceCreateResponseSchema;
     };
     /**
-     * Update a network
+     * Updates a network.
      *
      * @generated from rpc metalstack.admin.v2.NetworkService.Update
      */
@@ -385,7 +385,7 @@ export declare const NetworkService: GenService<{
         output: typeof NetworkServiceUpdateResponseSchema;
     };
     /**
-     * Delete a network
+     * Deletes a network.
      *
      * @generated from rpc metalstack.admin.v2.NetworkService.Delete
      */
@@ -395,7 +395,7 @@ export declare const NetworkService: GenService<{
         output: typeof NetworkServiceDeleteResponseSchema;
     };
     /**
-     * List all networks
+     * Returns the list of all networks.
      *
      * @generated from rpc metalstack.admin.v2.NetworkService.List
      */
diff --git a/js/metalstack/admin/v2/network_pb.js b/js/metalstack/admin/v2/network_pb.js
index b5b71967..4c3cf074 100644
--- a/js/metalstack/admin/v2/network_pb.js
+++ b/js/metalstack/admin/v2/network_pb.js
@@ -61,7 +61,7 @@ export const NetworkServiceDeleteResponseSchema = /*@__PURE__*/ messageDesc(file
  */
 export const NetworkServiceListResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_network, 9);
 /**
- * NetworkService serves network address related functions
+ * NetworkService provides network management operations.
  *
  * @generated from service metalstack.admin.v2.NetworkService
  */
diff --git a/js/metalstack/admin/v2/network_pb.ts b/js/metalstack/admin/v2/network_pb.ts
index 843ca508..a2062610 100644
--- a/js/metalstack/admin/v2/network_pb.ts
+++ b/js/metalstack/admin/v2/network_pb.ts
@@ -19,7 +19,7 @@ export const file_metalstack_admin_v2_network: GenFile = /*@__PURE__*/
   fileDesc("CiFtZXRhbHN0YWNrL2FkbWluL3YyL25ldHdvcmsucHJvdG8SE21ldGFsc3RhY2suYWRtaW4udjIiMwoYTmV0d29ya1NlcnZpY2VHZXRSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBsCzrrECASJIChlOZXR3b3JrU2VydmljZUdldFJlc3BvbnNlEisKB25ldHdvcmsYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5OZXR3b3JrItAHChtOZXR3b3JrU2VydmljZUNyZWF0ZVJlcXVlc3QSHAoCaWQYASABKAlCC7pICHIGwLOusQIBSACIAQESHgoEbmFtZRgCIAEoCUILukgIcgbAs66xAgFIAYgBARIlCgtkZXNjcmlwdGlvbhgDIAEoCUILukgIcgbIs66xAgFIAogBARIjCglwYXJ0aXRpb24YBCABKAlCC7pICHIG0LOusQIBSAOIAQESHgoHcHJvamVjdBgFIAEoCUIIukgFcgOwAQFIBIgBARI2CgR0eXBlGAYgASgOMh4ubWV0YWxzdGFjay5hcGkudjIuTmV0d29ya1R5cGVCCLpIBYIBAhABEi4KBmxhYmVscxgHIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLkxhYmVsc0gFiAEBEh4KCHByZWZpeGVzGAggAygJQgy6SAmSAQa4pLOxAgESKgoUZGVzdGluYXRpb25fcHJlZml4ZXMYCSADKAlCDLpICZIBBriks7ECARJJChtkZWZhdWx0X2NoaWxkX3ByZWZpeF9sZW5ndGgYCiABKAsyJC5tZXRhbHN0YWNrLmFwaS52Mi5DaGlsZFByZWZpeExlbmd0aBJFChdtaW5fY2hpbGRfcHJlZml4X2xlbmd0aBgLIAEoCzIkLm1ldGFsc3RhY2suYXBpLnYyLkNoaWxkUHJlZml4TGVuZ3RoEjsKCG5hdF90eXBlGAwgASgOMhoubWV0YWxzdGFjay5hcGkudjIuTkFUVHlwZUIIukgFggECEAFIBogBARIQCgN2cmYYDSABKA1IB4gBARIoCg5wYXJlbnRfbmV0d29yaxgOIAEoCUILukgIcgbAs66xAgFICIgBARIyChxhZGRpdGlvbmFsX2Fubm91bmNhYmxlX2NpZHJzGA8gAygJQgy6SAmSAQa4pLOxAgESOQoGbGVuZ3RoGBAgASgLMiQubWV0YWxzdGFjay5hcGkudjIuQ2hpbGRQcmVmaXhMZW5ndGhICYgBARJOCg5hZGRyZXNzX2ZhbWlseRgRIAEoDjInLm1ldGFsc3RhY2suYXBpLnYyLk5ldHdvcmtBZGRyZXNzRmFtaWx5Qgi6SAWCAQIQAUgKiAEBQgUKA19pZEIHCgVfbmFtZUIOCgxfZGVzY3JpcHRpb25CDAoKX3BhcnRpdGlvbkIKCghfcHJvamVjdEIJCgdfbGFiZWxzQgsKCV9uYXRfdHlwZUIGCgRfdnJmQhEKD19wYXJlbnRfbmV0d29ya0IJCgdfbGVuZ3RoQhEKD19hZGRyZXNzX2ZhbWlseSLEBQobTmV0d29ya1NlcnZpY2VVcGRhdGVSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBsCzrrECARI6Cgt1cGRhdGVfbWV0YRgCIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLlVwZGF0ZU1ldGFCBrpIA8gBARIeCgRuYW1lGAMgASgJQgu6SAhyBsCzrrECAUgAiAEBEiUKC2Rlc2NyaXB0aW9uGAQgASgJQgu6SAhyBsizrrECAUgBiAEBEjQKBmxhYmVscxgFIAEoCzIfLm1ldGFsc3RhY2suYXBpLnYyLlVwZGF0ZUxhYmVsc0gCiAEBEh4KCHByZWZpeGVzGAYgAygJQgy6SAmSAQa4pLOxAgESKgoUZGVzdGluYXRpb25fcHJlZml4ZXMYByADKAlCDLpICZIBBriks7ECARJOChtkZWZhdWx0X2NoaWxkX3ByZWZpeF9sZW5ndGgYCCABKAsyJC5tZXRhbHN0YWNrLmFwaS52Mi5DaGlsZFByZWZpeExlbmd0aEgDiAEBEkoKF21pbl9jaGlsZF9wcmVmaXhfbGVuZ3RoGAkgASgLMiQubWV0YWxzdGFjay5hcGkudjIuQ2hpbGRQcmVmaXhMZW5ndGhIBIgBARI7CghuYXRfdHlwZRgKIAEoDjIaLm1ldGFsc3RhY2suYXBpLnYyLk5BVFR5cGVCCLpIBYIBAhABSAWIAQESMgocYWRkaXRpb25hbF9hbm5vdW5jYWJsZV9jaWRycxgLIAMoCUIMukgJkgEGuKSzsQIBEg0KBWZvcmNlGAwgASgIQgcKBV9uYW1lQg4KDF9kZXNjcmlwdGlvbkIJCgdfbGFiZWxzQh4KHF9kZWZhdWx0X2NoaWxkX3ByZWZpeF9sZW5ndGhCGgoYX21pbl9jaGlsZF9wcmVmaXhfbGVuZ3RoQgsKCV9uYXRfdHlwZSI2ChtOZXR3b3JrU2VydmljZURlbGV0ZVJlcXVlc3QSFwoCaWQYASABKAlCC7pICHIGwLOusQIBIksKGU5ldHdvcmtTZXJ2aWNlTGlzdFJlcXVlc3QSLgoFcXVlcnkYAiABKAsyHy5tZXRhbHN0YWNrLmFwaS52Mi5OZXR3b3JrUXVlcnkiSwocTmV0d29ya1NlcnZpY2VDcmVhdGVSZXNwb25zZRIrCgduZXR3b3JrGAEgASgLMhoubWV0YWxzdGFjay5hcGkudjIuTmV0d29yayJLChxOZXR3b3JrU2VydmljZVVwZGF0ZVJlc3BvbnNlEisKB25ldHdvcmsYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5OZXR3b3JrIksKHE5ldHdvcmtTZXJ2aWNlRGVsZXRlUmVzcG9uc2USKwoHbmV0d29yaxgBIAEoCzIaLm1ldGFsc3RhY2suYXBpLnYyLk5ldHdvcmsiSgoaTmV0d29ya1NlcnZpY2VMaXN0UmVzcG9uc2USLAoIbmV0d29ya3MYASADKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5OZXR3b3JrMuUECg5OZXR3b3JrU2VydmljZRJwCgNHZXQSLS5tZXRhbHN0YWNrLmFkbWluLnYyLk5ldHdvcmtTZXJ2aWNlR2V0UmVxdWVzdBouLm1ldGFsc3RhY2suYWRtaW4udjIuTmV0d29ya1NlcnZpY2VHZXRSZXNwb25zZSIK0vMYAgEC4PMYAhJ4CgZDcmVhdGUSMC5tZXRhbHN0YWNrLmFkbWluLnYyLk5ldHdvcmtTZXJ2aWNlQ3JlYXRlUmVxdWVzdBoxLm1ldGFsc3RhY2suYWRtaW4udjIuTmV0d29ya1NlcnZpY2VDcmVhdGVSZXNwb25zZSIJ0vMYAQHg8xgBEngKBlVwZGF0ZRIwLm1ldGFsc3RhY2suYWRtaW4udjIuTmV0d29ya1NlcnZpY2VVcGRhdGVSZXF1ZXN0GjEubWV0YWxzdGFjay5hZG1pbi52Mi5OZXR3b3JrU2VydmljZVVwZGF0ZVJlc3BvbnNlIgnS8xgBAeDzGAESeAoGRGVsZXRlEjAubWV0YWxzdGFjay5hZG1pbi52Mi5OZXR3b3JrU2VydmljZURlbGV0ZVJlcXVlc3QaMS5tZXRhbHN0YWNrLmFkbWluLnYyLk5ldHdvcmtTZXJ2aWNlRGVsZXRlUmVzcG9uc2UiCdLzGAEB4PMYARJzCgRMaXN0Ei4ubWV0YWxzdGFjay5hZG1pbi52Mi5OZXR3b3JrU2VydmljZUxpc3RSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hZG1pbi52Mi5OZXR3b3JrU2VydmljZUxpc3RSZXNwb25zZSIK0vMYAgEC4PMYAkLQAQoXY29tLm1ldGFsc3RhY2suYWRtaW4udjJCDE5ldHdvcmtQcm90b1ABWjlnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FkbWluL3YyO2FkbWludjKiAgNNQViqAhNNZXRhbHN0YWNrLkFkbWluLlYyygITTWV0YWxzdGFja1xBZG1pblxWMuICH01ldGFsc3RhY2tcQWRtaW5cVjJcR1BCTWV0YWRhdGHqAhVNZXRhbHN0YWNrOjpBZG1pbjo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_network, file_metalstack_api_v2_predefined_rules]);
 
 /**
- * NetworkServiceGetRequest
+ * NetworkServiceGetRequest is the request payload for getting a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceGetRequest
  */
@@ -40,13 +40,13 @@ export const NetworkServiceGetRequestSchema: GenMessage<NetworkServiceGetRequest
   messageDesc(file_metalstack_admin_v2_network, 0);
 
 /**
- * NetworkServiceGetResponse
+ * NetworkServiceGetResponse is the response payload for getting a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceGetResponse
  */
 export type NetworkServiceGetResponse = Message<"metalstack.admin.v2.NetworkServiceGetResponse"> & {
   /**
-   * Network which was requested to get
+   * Network contains the requested network
    *
    * @generated from field: metalstack.api.v2.Network network = 1;
    */
@@ -61,7 +61,7 @@ export const NetworkServiceGetResponseSchema: GenMessage<NetworkServiceGetRespon
   messageDesc(file_metalstack_admin_v2_network, 1);
 
 /**
- * NetworkServiceCreateRequest
+ * NetworkServiceCreateRequest is the request payload for creating a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceCreateRequest
  */
@@ -151,7 +151,7 @@ export type NetworkServiceCreateRequest = Message<"metalstack.admin.v2.NetworkSe
   natType?: NATType;
 
   /**
-   * VRF of this network has this VNI.
+   * VRF of this network has this VNI
    *
    * @generated from field: optional uint32 vrf = 13;
    */
@@ -194,7 +194,7 @@ export const NetworkServiceCreateRequestSchema: GenMessage<NetworkServiceCreateR
   messageDesc(file_metalstack_admin_v2_network, 2);
 
 /**
- * NetworkServiceUpdateRequest is the request payload for a network update request
+ * NetworkServiceUpdateRequest is the request payload for updating a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceUpdateRequest
  */
@@ -249,7 +249,7 @@ export type NetworkServiceUpdateRequest = Message<"metalstack.admin.v2.NetworkSe
   destinationPrefixes: string[];
 
   /**
-   * Default Child Prefix length defines the bit length of a child network created per addressfamily, of not specified during the allocate request
+   * Default Child Prefix length defines the bit length of a child network created per addressfamily, if not specified during the allocate request
    *
    * @generated from field: optional metalstack.api.v2.ChildPrefixLength default_child_prefix_length = 8;
    */
@@ -277,7 +277,7 @@ export type NetworkServiceUpdateRequest = Message<"metalstack.admin.v2.NetworkSe
   additionalAnnouncableCidrs: string[];
 
   /**
-   * Force update, actually only prevents accidental removal of additional_announcable_cidrs which will destroy your dataplane in fact.
+   * Force update, prevents accidental removal of additional_announcable_cidrs which will destroy your dataplane.
    *
    * @generated from field: bool force = 12;
    */
@@ -292,7 +292,7 @@ export const NetworkServiceUpdateRequestSchema: GenMessage<NetworkServiceUpdateR
   messageDesc(file_metalstack_admin_v2_network, 3);
 
 /**
- * NetworkServiceDeleteRequest is the request payload for a network delete request
+ * NetworkServiceDeleteRequest is the request payload for deleting a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceDeleteRequest
  */
@@ -313,13 +313,13 @@ export const NetworkServiceDeleteRequestSchema: GenMessage<NetworkServiceDeleteR
   messageDesc(file_metalstack_admin_v2_network, 4);
 
 /**
- * NetworkServiceListRequest
+ * NetworkServiceListRequest is the request payload for listing networks.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceListRequest
  */
 export type NetworkServiceListRequest = Message<"metalstack.admin.v2.NetworkServiceListRequest"> & {
   /**
-   * Query which specifies which networks to return
+   * Query specifies which networks to return
    *
    * @generated from field: metalstack.api.v2.NetworkQuery query = 2;
    */
@@ -334,13 +334,13 @@ export const NetworkServiceListRequestSchema: GenMessage<NetworkServiceListReque
   messageDesc(file_metalstack_admin_v2_network, 5);
 
 /**
- * NetworkServiceCreateResponse is the response payload for a network create request
+ * NetworkServiceCreateResponse is the response payload for creating a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceCreateResponse
  */
 export type NetworkServiceCreateResponse = Message<"metalstack.admin.v2.NetworkServiceCreateResponse"> & {
   /**
-   * Network the network
+   * Network contains the created network
    *
    * @generated from field: metalstack.api.v2.Network network = 1;
    */
@@ -355,13 +355,13 @@ export const NetworkServiceCreateResponseSchema: GenMessage<NetworkServiceCreate
   messageDesc(file_metalstack_admin_v2_network, 6);
 
 /**
- * NetworkServiceUpdateResponse is the response payload for a network update request
+ * NetworkServiceUpdateResponse is the response payload for updating a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceUpdateResponse
  */
 export type NetworkServiceUpdateResponse = Message<"metalstack.admin.v2.NetworkServiceUpdateResponse"> & {
   /**
-   * Network the network
+   * Network contains the updated network
    *
    * @generated from field: metalstack.api.v2.Network network = 1;
    */
@@ -376,13 +376,13 @@ export const NetworkServiceUpdateResponseSchema: GenMessage<NetworkServiceUpdate
   messageDesc(file_metalstack_admin_v2_network, 7);
 
 /**
- * NetworkServiceCapacityResponse is the response payload for a network delete request
+ * NetworkServiceDeleteResponse is the response payload for deleting a network.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceDeleteResponse
  */
 export type NetworkServiceDeleteResponse = Message<"metalstack.admin.v2.NetworkServiceDeleteResponse"> & {
   /**
-   * Network the network
+   * Network contains the deleted network
    *
    * @generated from field: metalstack.api.v2.Network network = 1;
    */
@@ -397,13 +397,13 @@ export const NetworkServiceDeleteResponseSchema: GenMessage<NetworkServiceDelete
   messageDesc(file_metalstack_admin_v2_network, 8);
 
 /**
- * NetworkServiceListResponse
+ * NetworkServiceListResponse is the response payload for listing networks.
  *
  * @generated from message metalstack.admin.v2.NetworkServiceListResponse
  */
 export type NetworkServiceListResponse = Message<"metalstack.admin.v2.NetworkServiceListResponse"> & {
   /**
-   * Networks are the requested networks
+   * Networks contains the list of networks
    *
    * @generated from field: repeated metalstack.api.v2.Network networks = 1;
    */
@@ -418,13 +418,13 @@ export const NetworkServiceListResponseSchema: GenMessage<NetworkServiceListResp
   messageDesc(file_metalstack_admin_v2_network, 9);
 
 /**
- * NetworkService serves network address related functions
+ * NetworkService provides network management operations.
  *
  * @generated from service metalstack.admin.v2.NetworkService
  */
 export const NetworkService: GenService<{
   /**
-   * Get a network
+   * Returns the network with the specified ID.
    *
    * @generated from rpc metalstack.admin.v2.NetworkService.Get
    */
@@ -434,7 +434,7 @@ export const NetworkService: GenService<{
     output: typeof NetworkServiceGetResponseSchema;
   },
   /**
-   * Create a network
+   * Creates a new network.
    *
    * @generated from rpc metalstack.admin.v2.NetworkService.Create
    */
@@ -444,7 +444,7 @@ export const NetworkService: GenService<{
     output: typeof NetworkServiceCreateResponseSchema;
   },
   /**
-   * Update a network
+   * Updates a network.
    *
    * @generated from rpc metalstack.admin.v2.NetworkService.Update
    */
@@ -454,7 +454,7 @@ export const NetworkService: GenService<{
     output: typeof NetworkServiceUpdateResponseSchema;
   },
   /**
-   * Delete a network
+   * Deletes a network.
    *
    * @generated from rpc metalstack.admin.v2.NetworkService.Delete
    */
@@ -464,7 +464,7 @@ export const NetworkService: GenService<{
     output: typeof NetworkServiceDeleteResponseSchema;
   },
   /**
-   * List all networks
+   * Returns the list of all networks.
    *
    * @generated from rpc metalstack.admin.v2.NetworkService.List
    */
diff --git a/js/metalstack/admin/v2/partition_pb.d.ts b/js/metalstack/admin/v2/partition_pb.d.ts
index e5cb2a58..54c58f34 100644
--- a/js/metalstack/admin/v2/partition_pb.d.ts
+++ b/js/metalstack/admin/v2/partition_pb.d.ts
@@ -25,7 +25,7 @@ export type PartitionServiceCreateRequest = Message<"metalstack.admin.v2.Partiti
  */
 export declare const PartitionServiceCreateRequestSchema: GenMessage<PartitionServiceCreateRequest>;
 /**
- * PartitionServiceUpdateRequest is the request payload for a partition update request
+ * PartitionServiceUpdateRequest is the request payload for updating a partition.
  *
  * @generated from message metalstack.admin.v2.PartitionServiceUpdateRequest
  */
@@ -68,8 +68,7 @@ export type PartitionServiceUpdateRequest = Message<"metalstack.admin.v2.Partiti
     ntpServers: NTPServer[];
     /**
      * ManagementServiceAddresses defines where the management is reachable
-     * should be in the form <ip|host>:<port>
-     * FIXME validation
+     * must be in the form <ip|host>:<port>
      *
      * @generated from field: repeated string mgmt_service_addresses = 7;
      */
@@ -141,13 +140,13 @@ export type PartitionServiceUpdateResponse = Message<"metalstack.admin.v2.Partit
  */
 export declare const PartitionServiceUpdateResponseSchema: GenMessage<PartitionServiceUpdateResponse>;
 /**
- * PartitionServiceCapacityResponse is the response payload for a partition delete request
+ * PartitionServiceDeleteResponse is the response payload for deleting a partition.
  *
  * @generated from message metalstack.admin.v2.PartitionServiceDeleteResponse
  */
 export type PartitionServiceDeleteResponse = Message<"metalstack.admin.v2.PartitionServiceDeleteResponse"> & {
     /**
-     * Partition the partition
+     * Partition contains the deleted partition
      *
      * @generated from field: metalstack.api.v2.Partition partition = 1;
      */
@@ -159,7 +158,7 @@ export type PartitionServiceDeleteResponse = Message<"metalstack.admin.v2.Partit
  */
 export declare const PartitionServiceDeleteResponseSchema: GenMessage<PartitionServiceDeleteResponse>;
 /**
- * PartitionServiceListRequest is the request payload for a partition capacity request
+ * PartitionServiceCapacityRequest is the request payload for getting partition capacity.
  *
  * @generated from message metalstack.admin.v2.PartitionServiceCapacityRequest
  */
@@ -336,13 +335,13 @@ export type MachineSizeCapacity = Message<"metalstack.admin.v2.MachineSizeCapaci
  */
 export declare const MachineSizeCapacitySchema: GenMessage<MachineSizeCapacity>;
 /**
- * PartitionService serves partition address related functions
+ * PartitionService provides partition management operations.
  *
  * @generated from service metalstack.admin.v2.PartitionService
  */
 export declare const PartitionService: GenService<{
     /**
-     * Create a partition
+     * Creates a new partition.
      *
      * @generated from rpc metalstack.admin.v2.PartitionService.Create
      */
@@ -352,7 +351,7 @@ export declare const PartitionService: GenService<{
         output: typeof PartitionServiceCreateResponseSchema;
     };
     /**
-     * Update a partition
+     * Updates a partition.
      *
      * @generated from rpc metalstack.admin.v2.PartitionService.Update
      */
@@ -362,7 +361,7 @@ export declare const PartitionService: GenService<{
         output: typeof PartitionServiceUpdateResponseSchema;
     };
     /**
-     * Delete a partition
+     * Deletes a partition.
      *
      * @generated from rpc metalstack.admin.v2.PartitionService.Delete
      */
@@ -372,7 +371,7 @@ export declare const PartitionService: GenService<{
         output: typeof PartitionServiceDeleteResponseSchema;
     };
     /**
-     * Capacity of a partitions
+     * Returns the capacity of a partition.
      *
      * @generated from rpc metalstack.admin.v2.PartitionService.Capacity
      */
diff --git a/js/metalstack/admin/v2/partition_pb.js b/js/metalstack/admin/v2/partition_pb.js
index b5d424cc..5152d4b3 100644
--- a/js/metalstack/admin/v2/partition_pb.js
+++ b/js/metalstack/admin/v2/partition_pb.js
@@ -9,7 +9,7 @@ import { file_metalstack_api_v2_predefined_rules } from "../../api/v2/predefined
 /**
  * Describes the file metalstack/admin/v2/partition.proto.
  */
-export const file_metalstack_admin_v2_partition = /*@__PURE__*/ fileDesc("CiNtZXRhbHN0YWNrL2FkbWluL3YyL3BhcnRpdGlvbi5wcm90bxITbWV0YWxzdGFjay5hZG1pbi52MiJQCh1QYXJ0aXRpb25TZXJ2aWNlQ3JlYXRlUmVxdWVzdBIvCglwYXJ0aXRpb24YASABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24i0QMKHVBhcnRpdGlvblNlcnZpY2VVcGRhdGVSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBtCzrrECARI6Cgt1cGRhdGVfbWV0YRgCIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLlVwZGF0ZU1ldGFCBrpIA8gBARIlCgtkZXNjcmlwdGlvbhgDIAEoCUILukgIcgbIs66xAgFIAIgBARJJChJib290X2NvbmZpZ3VyYXRpb24YBCABKAsyLS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25Cb290Q29uZmlndXJhdGlvbhI7CgtkbnNfc2VydmVycxgFIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYBiADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEh4KFm1nbXRfc2VydmljZV9hZGRyZXNzZXMYByADKAkSNAoGbGFiZWxzGAggASgLMh8ubWV0YWxzdGFjay5hcGkudjIuVXBkYXRlTGFiZWxzSAGIAQFCDgoMX2Rlc2NyaXB0aW9uQgkKB19sYWJlbHMiOAodUGFydGl0aW9uU2VydmljZURlbGV0ZVJlcXVlc3QSFwoCaWQYASABKAlCC7pICHIG0LOusQIBIlEKHlBhcnRpdGlvblNlcnZpY2VDcmVhdGVSZXNwb25zZRIvCglwYXJ0aXRpb24YASABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24iUQoeUGFydGl0aW9uU2VydmljZVVwZGF0ZVJlc3BvbnNlEi8KCXBhcnRpdGlvbhgBIAEoCzIcLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvbiJRCh5QYXJ0aXRpb25TZXJ2aWNlRGVsZXRlUmVzcG9uc2USLwoJcGFydGl0aW9uGAEgASgLMhwubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uIpsBCh9QYXJ0aXRpb25TZXJ2aWNlQ2FwYWNpdHlSZXF1ZXN0EhwKAmlkGAEgASgJQgu6SAhyBtCzrrECAUgAiAEBEh4KBHNpemUYAiABKAlCC7pICHIGwLOusQIBSAGIAQESHgoHcHJvamVjdBgDIAEoCUIIukgFcgOwAQFIAogBAUIFCgNfaWRCBwoFX3NpemVCCgoIX3Byb2plY3QiZgogUGFydGl0aW9uU2VydmljZUNhcGFjaXR5UmVzcG9uc2USQgoScGFydGl0aW9uX2NhcGFjaXR5GAEgAygLMiYubWV0YWxzdGFjay5hZG1pbi52Mi5QYXJ0aXRpb25DYXBhY2l0eSJ+ChFQYXJ0aXRpb25DYXBhY2l0eRIeCglwYXJ0aXRpb24YASABKAlCC7pICHIG0LOusQIBEkkKF21hY2hpbmVfc2l6ZV9jYXBhY2l0aWVzGAIgAygLMigubWV0YWxzdGFjay5hZG1pbi52Mi5NYWNoaW5lU2l6ZUNhcGFjaXR5ItECChNNYWNoaW5lU2l6ZUNhcGFjaXR5EhkKBHNpemUYAiABKAlCC7pICHIGwLOusQIBEg0KBXRvdGFsGAMgASgDEhMKC3Bob25lZF9ob21lGAQgASgDEg8KB3dhaXRpbmcYBSABKAMSDQoFb3RoZXIYBiABKAMSFgoOb3RoZXJfbWFjaGluZXMYByADKAkSEQoJYWxsb2NhdGVkGAggASgDEhMKC2FsbG9jYXRhYmxlGAkgASgDEgwKBGZyZWUYCiABKAMSEwoLdW5hdmFpbGFibGUYCyABKAMSDgoGZmF1bHR5GAwgASgDEhcKD2ZhdWx0eV9tYWNoaW5lcxgNIAMoCRIUCgxyZXNlcnZhdGlvbnMYDiABKAMSGQoRdXNlZF9yZXNlcnZhdGlvbnMYDyABKAMSHgoWcmVtYWluaW5nX3Jlc2VydmF0aW9ucxgQIAEoAzKSBAoQUGFydGl0aW9uU2VydmljZRJ8CgZDcmVhdGUSMi5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VDcmVhdGVSZXF1ZXN0GjMubWV0YWxzdGFjay5hZG1pbi52Mi5QYXJ0aXRpb25TZXJ2aWNlQ3JlYXRlUmVzcG9uc2UiCdLzGAEB4PMYARJ8CgZVcGRhdGUSMi5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VVcGRhdGVSZXF1ZXN0GjMubWV0YWxzdGFjay5hZG1pbi52Mi5QYXJ0aXRpb25TZXJ2aWNlVXBkYXRlUmVzcG9uc2UiCdLzGAEB4PMYARJ8CgZEZWxldGUSMi5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VEZWxldGVSZXF1ZXN0GjMubWV0YWxzdGFjay5hZG1pbi52Mi5QYXJ0aXRpb25TZXJ2aWNlRGVsZXRlUmVzcG9uc2UiCdLzGAEB4PMYARKDAQoIQ2FwYWNpdHkSNC5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VDYXBhY2l0eVJlcXVlc3QaNS5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VDYXBhY2l0eVJlc3BvbnNlIgrS8xgCAgHg8xgCQtIBChdjb20ubWV0YWxzdGFjay5hZG1pbi52MkIOUGFydGl0aW9uUHJvdG9QAVo5Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9hZG1pbi92MjthZG1pbnYyogIDTUFYqgITTWV0YWxzdGFjay5BZG1pbi5WMsoCE01ldGFsc3RhY2tcQWRtaW5cVjLiAh9NZXRhbHN0YWNrXEFkbWluXFYyXEdQQk1ldGFkYXRh6gIVTWV0YWxzdGFjazo6QWRtaW46OlYyYgZwcm90bzM", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_partition, file_metalstack_api_v2_predefined_rules]);
+export const file_metalstack_admin_v2_partition = /*@__PURE__*/ fileDesc("CiNtZXRhbHN0YWNrL2FkbWluL3YyL3BhcnRpdGlvbi5wcm90bxITbWV0YWxzdGFjay5hZG1pbi52MiJQCh1QYXJ0aXRpb25TZXJ2aWNlQ3JlYXRlUmVxdWVzdBIvCglwYXJ0aXRpb24YASABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24i3wMKHVBhcnRpdGlvblNlcnZpY2VVcGRhdGVSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBtCzrrECARI6Cgt1cGRhdGVfbWV0YRgCIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLlVwZGF0ZU1ldGFCBrpIA8gBARIlCgtkZXNjcmlwdGlvbhgDIAEoCUILukgIcgbIs66xAgFIAIgBARJJChJib290X2NvbmZpZ3VyYXRpb24YBCABKAsyLS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25Cb290Q29uZmlndXJhdGlvbhI7CgtkbnNfc2VydmVycxgFIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYBiADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEiwKFm1nbXRfc2VydmljZV9hZGRyZXNzZXMYByADKAlCDLpICZIBBsiks7ECARI0CgZsYWJlbHMYCCABKAsyHy5tZXRhbHN0YWNrLmFwaS52Mi5VcGRhdGVMYWJlbHNIAYgBAUIOCgxfZGVzY3JpcHRpb25CCQoHX2xhYmVscyI4Ch1QYXJ0aXRpb25TZXJ2aWNlRGVsZXRlUmVxdWVzdBIXCgJpZBgBIAEoCUILukgIcgbQs66xAgEiUQoeUGFydGl0aW9uU2VydmljZUNyZWF0ZVJlc3BvbnNlEi8KCXBhcnRpdGlvbhgBIAEoCzIcLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvbiJRCh5QYXJ0aXRpb25TZXJ2aWNlVXBkYXRlUmVzcG9uc2USLwoJcGFydGl0aW9uGAEgASgLMhwubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uIlEKHlBhcnRpdGlvblNlcnZpY2VEZWxldGVSZXNwb25zZRIvCglwYXJ0aXRpb24YASABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24imwEKH1BhcnRpdGlvblNlcnZpY2VDYXBhY2l0eVJlcXVlc3QSHAoCaWQYASABKAlCC7pICHIG0LOusQIBSACIAQESHgoEc2l6ZRgCIAEoCUILukgIcgbAs66xAgFIAYgBARIeCgdwcm9qZWN0GAMgASgJQgi6SAVyA7ABAUgCiAEBQgUKA19pZEIHCgVfc2l6ZUIKCghfcHJvamVjdCJmCiBQYXJ0aXRpb25TZXJ2aWNlQ2FwYWNpdHlSZXNwb25zZRJCChJwYXJ0aXRpb25fY2FwYWNpdHkYASADKAsyJi5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvbkNhcGFjaXR5In4KEVBhcnRpdGlvbkNhcGFjaXR5Eh4KCXBhcnRpdGlvbhgBIAEoCUILukgIcgbQs66xAgESSQoXbWFjaGluZV9zaXplX2NhcGFjaXRpZXMYAiADKAsyKC5tZXRhbHN0YWNrLmFkbWluLnYyLk1hY2hpbmVTaXplQ2FwYWNpdHki0QIKE01hY2hpbmVTaXplQ2FwYWNpdHkSGQoEc2l6ZRgCIAEoCUILukgIcgbAs66xAgESDQoFdG90YWwYAyABKAMSEwoLcGhvbmVkX2hvbWUYBCABKAMSDwoHd2FpdGluZxgFIAEoAxINCgVvdGhlchgGIAEoAxIWCg5vdGhlcl9tYWNoaW5lcxgHIAMoCRIRCglhbGxvY2F0ZWQYCCABKAMSEwoLYWxsb2NhdGFibGUYCSABKAMSDAoEZnJlZRgKIAEoAxITCgt1bmF2YWlsYWJsZRgLIAEoAxIOCgZmYXVsdHkYDCABKAMSFwoPZmF1bHR5X21hY2hpbmVzGA0gAygJEhQKDHJlc2VydmF0aW9ucxgOIAEoAxIZChF1c2VkX3Jlc2VydmF0aW9ucxgPIAEoAxIeChZyZW1haW5pbmdfcmVzZXJ2YXRpb25zGBAgASgDMpIEChBQYXJ0aXRpb25TZXJ2aWNlEnwKBkNyZWF0ZRIyLm1ldGFsc3RhY2suYWRtaW4udjIuUGFydGl0aW9uU2VydmljZUNyZWF0ZVJlcXVlc3QaMy5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VDcmVhdGVSZXNwb25zZSIJ0vMYAQHg8xgBEnwKBlVwZGF0ZRIyLm1ldGFsc3RhY2suYWRtaW4udjIuUGFydGl0aW9uU2VydmljZVVwZGF0ZVJlcXVlc3QaMy5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VVcGRhdGVSZXNwb25zZSIJ0vMYAQHg8xgBEnwKBkRlbGV0ZRIyLm1ldGFsc3RhY2suYWRtaW4udjIuUGFydGl0aW9uU2VydmljZURlbGV0ZVJlcXVlc3QaMy5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VEZWxldGVSZXNwb25zZSIJ0vMYAQHg8xgBEoMBCghDYXBhY2l0eRI0Lm1ldGFsc3RhY2suYWRtaW4udjIuUGFydGl0aW9uU2VydmljZUNhcGFjaXR5UmVxdWVzdBo1Lm1ldGFsc3RhY2suYWRtaW4udjIuUGFydGl0aW9uU2VydmljZUNhcGFjaXR5UmVzcG9uc2UiCtLzGAICAeDzGAJC0gEKF2NvbS5tZXRhbHN0YWNrLmFkbWluLnYyQg5QYXJ0aXRpb25Qcm90b1ABWjlnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FkbWluL3YyO2FkbWludjKiAgNNQViqAhNNZXRhbHN0YWNrLkFkbWluLlYyygITTWV0YWxzdGFja1xBZG1pblxWMuICH01ldGFsc3RhY2tcQWRtaW5cVjJcR1BCTWV0YWRhdGHqAhVNZXRhbHN0YWNrOjpBZG1pbjo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_partition, file_metalstack_api_v2_predefined_rules]);
 /**
  * Describes the message metalstack.admin.v2.PartitionServiceCreateRequest.
  * Use `create(PartitionServiceCreateRequestSchema)` to create a new message.
@@ -61,7 +61,7 @@ export const PartitionCapacitySchema = /*@__PURE__*/ messageDesc(file_metalstack
  */
 export const MachineSizeCapacitySchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_partition, 9);
 /**
- * PartitionService serves partition address related functions
+ * PartitionService provides partition management operations.
  *
  * @generated from service metalstack.admin.v2.PartitionService
  */
diff --git a/js/metalstack/admin/v2/partition_pb.ts b/js/metalstack/admin/v2/partition_pb.ts
index 7b1a795d..c6097a27 100644
--- a/js/metalstack/admin/v2/partition_pb.ts
+++ b/js/metalstack/admin/v2/partition_pb.ts
@@ -16,7 +16,7 @@ import type { Message } from "@bufbuild/protobuf";
  * Describes the file metalstack/admin/v2/partition.proto.
  */
 export const file_metalstack_admin_v2_partition: GenFile = /*@__PURE__*/
-  fileDesc("CiNtZXRhbHN0YWNrL2FkbWluL3YyL3BhcnRpdGlvbi5wcm90bxITbWV0YWxzdGFjay5hZG1pbi52MiJQCh1QYXJ0aXRpb25TZXJ2aWNlQ3JlYXRlUmVxdWVzdBIvCglwYXJ0aXRpb24YASABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24i0QMKHVBhcnRpdGlvblNlcnZpY2VVcGRhdGVSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBtCzrrECARI6Cgt1cGRhdGVfbWV0YRgCIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLlVwZGF0ZU1ldGFCBrpIA8gBARIlCgtkZXNjcmlwdGlvbhgDIAEoCUILukgIcgbIs66xAgFIAIgBARJJChJib290X2NvbmZpZ3VyYXRpb24YBCABKAsyLS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25Cb290Q29uZmlndXJhdGlvbhI7CgtkbnNfc2VydmVycxgFIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYBiADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEh4KFm1nbXRfc2VydmljZV9hZGRyZXNzZXMYByADKAkSNAoGbGFiZWxzGAggASgLMh8ubWV0YWxzdGFjay5hcGkudjIuVXBkYXRlTGFiZWxzSAGIAQFCDgoMX2Rlc2NyaXB0aW9uQgkKB19sYWJlbHMiOAodUGFydGl0aW9uU2VydmljZURlbGV0ZVJlcXVlc3QSFwoCaWQYASABKAlCC7pICHIG0LOusQIBIlEKHlBhcnRpdGlvblNlcnZpY2VDcmVhdGVSZXNwb25zZRIvCglwYXJ0aXRpb24YASABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24iUQoeUGFydGl0aW9uU2VydmljZVVwZGF0ZVJlc3BvbnNlEi8KCXBhcnRpdGlvbhgBIAEoCzIcLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvbiJRCh5QYXJ0aXRpb25TZXJ2aWNlRGVsZXRlUmVzcG9uc2USLwoJcGFydGl0aW9uGAEgASgLMhwubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uIpsBCh9QYXJ0aXRpb25TZXJ2aWNlQ2FwYWNpdHlSZXF1ZXN0EhwKAmlkGAEgASgJQgu6SAhyBtCzrrECAUgAiAEBEh4KBHNpemUYAiABKAlCC7pICHIGwLOusQIBSAGIAQESHgoHcHJvamVjdBgDIAEoCUIIukgFcgOwAQFIAogBAUIFCgNfaWRCBwoFX3NpemVCCgoIX3Byb2plY3QiZgogUGFydGl0aW9uU2VydmljZUNhcGFjaXR5UmVzcG9uc2USQgoScGFydGl0aW9uX2NhcGFjaXR5GAEgAygLMiYubWV0YWxzdGFjay5hZG1pbi52Mi5QYXJ0aXRpb25DYXBhY2l0eSJ+ChFQYXJ0aXRpb25DYXBhY2l0eRIeCglwYXJ0aXRpb24YASABKAlCC7pICHIG0LOusQIBEkkKF21hY2hpbmVfc2l6ZV9jYXBhY2l0aWVzGAIgAygLMigubWV0YWxzdGFjay5hZG1pbi52Mi5NYWNoaW5lU2l6ZUNhcGFjaXR5ItECChNNYWNoaW5lU2l6ZUNhcGFjaXR5EhkKBHNpemUYAiABKAlCC7pICHIGwLOusQIBEg0KBXRvdGFsGAMgASgDEhMKC3Bob25lZF9ob21lGAQgASgDEg8KB3dhaXRpbmcYBSABKAMSDQoFb3RoZXIYBiABKAMSFgoOb3RoZXJfbWFjaGluZXMYByADKAkSEQoJYWxsb2NhdGVkGAggASgDEhMKC2FsbG9jYXRhYmxlGAkgASgDEgwKBGZyZWUYCiABKAMSEwoLdW5hdmFpbGFibGUYCyABKAMSDgoGZmF1bHR5GAwgASgDEhcKD2ZhdWx0eV9tYWNoaW5lcxgNIAMoCRIUCgxyZXNlcnZhdGlvbnMYDiABKAMSGQoRdXNlZF9yZXNlcnZhdGlvbnMYDyABKAMSHgoWcmVtYWluaW5nX3Jlc2VydmF0aW9ucxgQIAEoAzKSBAoQUGFydGl0aW9uU2VydmljZRJ8CgZDcmVhdGUSMi5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VDcmVhdGVSZXF1ZXN0GjMubWV0YWxzdGFjay5hZG1pbi52Mi5QYXJ0aXRpb25TZXJ2aWNlQ3JlYXRlUmVzcG9uc2UiCdLzGAEB4PMYARJ8CgZVcGRhdGUSMi5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VVcGRhdGVSZXF1ZXN0GjMubWV0YWxzdGFjay5hZG1pbi52Mi5QYXJ0aXRpb25TZXJ2aWNlVXBkYXRlUmVzcG9uc2UiCdLzGAEB4PMYARJ8CgZEZWxldGUSMi5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VEZWxldGVSZXF1ZXN0GjMubWV0YWxzdGFjay5hZG1pbi52Mi5QYXJ0aXRpb25TZXJ2aWNlRGVsZXRlUmVzcG9uc2UiCdLzGAEB4PMYARKDAQoIQ2FwYWNpdHkSNC5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VDYXBhY2l0eVJlcXVlc3QaNS5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VDYXBhY2l0eVJlc3BvbnNlIgrS8xgCAgHg8xgCQtIBChdjb20ubWV0YWxzdGFjay5hZG1pbi52MkIOUGFydGl0aW9uUHJvdG9QAVo5Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9hZG1pbi92MjthZG1pbnYyogIDTUFYqgITTWV0YWxzdGFjay5BZG1pbi5WMsoCE01ldGFsc3RhY2tcQWRtaW5cVjLiAh9NZXRhbHN0YWNrXEFkbWluXFYyXEdQQk1ldGFkYXRh6gIVTWV0YWxzdGFjazo6QWRtaW46OlYyYgZwcm90bzM", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_partition, file_metalstack_api_v2_predefined_rules]);
+  fileDesc("CiNtZXRhbHN0YWNrL2FkbWluL3YyL3BhcnRpdGlvbi5wcm90bxITbWV0YWxzdGFjay5hZG1pbi52MiJQCh1QYXJ0aXRpb25TZXJ2aWNlQ3JlYXRlUmVxdWVzdBIvCglwYXJ0aXRpb24YASABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24i3wMKHVBhcnRpdGlvblNlcnZpY2VVcGRhdGVSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBtCzrrECARI6Cgt1cGRhdGVfbWV0YRgCIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLlVwZGF0ZU1ldGFCBrpIA8gBARIlCgtkZXNjcmlwdGlvbhgDIAEoCUILukgIcgbIs66xAgFIAIgBARJJChJib290X2NvbmZpZ3VyYXRpb24YBCABKAsyLS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25Cb290Q29uZmlndXJhdGlvbhI7CgtkbnNfc2VydmVycxgFIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYBiADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEiwKFm1nbXRfc2VydmljZV9hZGRyZXNzZXMYByADKAlCDLpICZIBBsiks7ECARI0CgZsYWJlbHMYCCABKAsyHy5tZXRhbHN0YWNrLmFwaS52Mi5VcGRhdGVMYWJlbHNIAYgBAUIOCgxfZGVzY3JpcHRpb25CCQoHX2xhYmVscyI4Ch1QYXJ0aXRpb25TZXJ2aWNlRGVsZXRlUmVxdWVzdBIXCgJpZBgBIAEoCUILukgIcgbQs66xAgEiUQoeUGFydGl0aW9uU2VydmljZUNyZWF0ZVJlc3BvbnNlEi8KCXBhcnRpdGlvbhgBIAEoCzIcLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvbiJRCh5QYXJ0aXRpb25TZXJ2aWNlVXBkYXRlUmVzcG9uc2USLwoJcGFydGl0aW9uGAEgASgLMhwubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uIlEKHlBhcnRpdGlvblNlcnZpY2VEZWxldGVSZXNwb25zZRIvCglwYXJ0aXRpb24YASABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24imwEKH1BhcnRpdGlvblNlcnZpY2VDYXBhY2l0eVJlcXVlc3QSHAoCaWQYASABKAlCC7pICHIG0LOusQIBSACIAQESHgoEc2l6ZRgCIAEoCUILukgIcgbAs66xAgFIAYgBARIeCgdwcm9qZWN0GAMgASgJQgi6SAVyA7ABAUgCiAEBQgUKA19pZEIHCgVfc2l6ZUIKCghfcHJvamVjdCJmCiBQYXJ0aXRpb25TZXJ2aWNlQ2FwYWNpdHlSZXNwb25zZRJCChJwYXJ0aXRpb25fY2FwYWNpdHkYASADKAsyJi5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvbkNhcGFjaXR5In4KEVBhcnRpdGlvbkNhcGFjaXR5Eh4KCXBhcnRpdGlvbhgBIAEoCUILukgIcgbQs66xAgESSQoXbWFjaGluZV9zaXplX2NhcGFjaXRpZXMYAiADKAsyKC5tZXRhbHN0YWNrLmFkbWluLnYyLk1hY2hpbmVTaXplQ2FwYWNpdHki0QIKE01hY2hpbmVTaXplQ2FwYWNpdHkSGQoEc2l6ZRgCIAEoCUILukgIcgbAs66xAgESDQoFdG90YWwYAyABKAMSEwoLcGhvbmVkX2hvbWUYBCABKAMSDwoHd2FpdGluZxgFIAEoAxINCgVvdGhlchgGIAEoAxIWCg5vdGhlcl9tYWNoaW5lcxgHIAMoCRIRCglhbGxvY2F0ZWQYCCABKAMSEwoLYWxsb2NhdGFibGUYCSABKAMSDAoEZnJlZRgKIAEoAxITCgt1bmF2YWlsYWJsZRgLIAEoAxIOCgZmYXVsdHkYDCABKAMSFwoPZmF1bHR5X21hY2hpbmVzGA0gAygJEhQKDHJlc2VydmF0aW9ucxgOIAEoAxIZChF1c2VkX3Jlc2VydmF0aW9ucxgPIAEoAxIeChZyZW1haW5pbmdfcmVzZXJ2YXRpb25zGBAgASgDMpIEChBQYXJ0aXRpb25TZXJ2aWNlEnwKBkNyZWF0ZRIyLm1ldGFsc3RhY2suYWRtaW4udjIuUGFydGl0aW9uU2VydmljZUNyZWF0ZVJlcXVlc3QaMy5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VDcmVhdGVSZXNwb25zZSIJ0vMYAQHg8xgBEnwKBlVwZGF0ZRIyLm1ldGFsc3RhY2suYWRtaW4udjIuUGFydGl0aW9uU2VydmljZVVwZGF0ZVJlcXVlc3QaMy5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VVcGRhdGVSZXNwb25zZSIJ0vMYAQHg8xgBEnwKBkRlbGV0ZRIyLm1ldGFsc3RhY2suYWRtaW4udjIuUGFydGl0aW9uU2VydmljZURlbGV0ZVJlcXVlc3QaMy5tZXRhbHN0YWNrLmFkbWluLnYyLlBhcnRpdGlvblNlcnZpY2VEZWxldGVSZXNwb25zZSIJ0vMYAQHg8xgBEoMBCghDYXBhY2l0eRI0Lm1ldGFsc3RhY2suYWRtaW4udjIuUGFydGl0aW9uU2VydmljZUNhcGFjaXR5UmVxdWVzdBo1Lm1ldGFsc3RhY2suYWRtaW4udjIuUGFydGl0aW9uU2VydmljZUNhcGFjaXR5UmVzcG9uc2UiCtLzGAICAeDzGAJC0gEKF2NvbS5tZXRhbHN0YWNrLmFkbWluLnYyQg5QYXJ0aXRpb25Qcm90b1ABWjlnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FkbWluL3YyO2FkbWludjKiAgNNQViqAhNNZXRhbHN0YWNrLkFkbWluLlYyygITTWV0YWxzdGFja1xBZG1pblxWMuICH01ldGFsc3RhY2tcQWRtaW5cVjJcR1BCTWV0YWRhdGHqAhVNZXRhbHN0YWNrOjpBZG1pbjo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_partition, file_metalstack_api_v2_predefined_rules]);
 
 /**
  * PartitionServiceCreateRequest is the request payload for a partition create request
@@ -40,7 +40,7 @@ export const PartitionServiceCreateRequestSchema: GenMessage<PartitionServiceCre
   messageDesc(file_metalstack_admin_v2_partition, 0);
 
 /**
- * PartitionServiceUpdateRequest is the request payload for a partition update request
+ * PartitionServiceUpdateRequest is the request payload for updating a partition.
  *
  * @generated from message metalstack.admin.v2.PartitionServiceUpdateRequest
  */
@@ -89,8 +89,7 @@ export type PartitionServiceUpdateRequest = Message<"metalstack.admin.v2.Partiti
 
   /**
    * ManagementServiceAddresses defines where the management is reachable
-   * should be in the form <ip|host>:<port>
-   * FIXME validation
+   * must be in the form <ip|host>:<port>
    *
    * @generated from field: repeated string mgmt_service_addresses = 7;
    */
@@ -175,13 +174,13 @@ export const PartitionServiceUpdateResponseSchema: GenMessage<PartitionServiceUp
   messageDesc(file_metalstack_admin_v2_partition, 4);
 
 /**
- * PartitionServiceCapacityResponse is the response payload for a partition delete request
+ * PartitionServiceDeleteResponse is the response payload for deleting a partition.
  *
  * @generated from message metalstack.admin.v2.PartitionServiceDeleteResponse
  */
 export type PartitionServiceDeleteResponse = Message<"metalstack.admin.v2.PartitionServiceDeleteResponse"> & {
   /**
-   * Partition the partition
+   * Partition contains the deleted partition
    *
    * @generated from field: metalstack.api.v2.Partition partition = 1;
    */
@@ -196,7 +195,7 @@ export const PartitionServiceDeleteResponseSchema: GenMessage<PartitionServiceDe
   messageDesc(file_metalstack_admin_v2_partition, 5);
 
 /**
- * PartitionServiceListRequest is the request payload for a partition capacity request
+ * PartitionServiceCapacityRequest is the request payload for getting partition capacity.
  *
  * @generated from message metalstack.admin.v2.PartitionServiceCapacityRequest
  */
@@ -402,13 +401,13 @@ export const MachineSizeCapacitySchema: GenMessage<MachineSizeCapacity> = /*@__P
   messageDesc(file_metalstack_admin_v2_partition, 9);
 
 /**
- * PartitionService serves partition address related functions
+ * PartitionService provides partition management operations.
  *
  * @generated from service metalstack.admin.v2.PartitionService
  */
 export const PartitionService: GenService<{
   /**
-   * Create a partition
+   * Creates a new partition.
    *
    * @generated from rpc metalstack.admin.v2.PartitionService.Create
    */
@@ -418,7 +417,7 @@ export const PartitionService: GenService<{
     output: typeof PartitionServiceCreateResponseSchema;
   },
   /**
-   * Update a partition
+   * Updates a partition.
    *
    * @generated from rpc metalstack.admin.v2.PartitionService.Update
    */
@@ -428,7 +427,7 @@ export const PartitionService: GenService<{
     output: typeof PartitionServiceUpdateResponseSchema;
   },
   /**
-   * Delete a partition
+   * Deletes a partition.
    *
    * @generated from rpc metalstack.admin.v2.PartitionService.Delete
    */
@@ -438,7 +437,7 @@ export const PartitionService: GenService<{
     output: typeof PartitionServiceDeleteResponseSchema;
   },
   /**
-   * Capacity of a partitions
+   * Returns the capacity of a partition.
    *
    * @generated from rpc metalstack.admin.v2.PartitionService.Capacity
    */
diff --git a/js/metalstack/admin/v2/project_pb.d.ts b/js/metalstack/admin/v2/project_pb.d.ts
index 763eba47..48ababcb 100644
--- a/js/metalstack/admin/v2/project_pb.d.ts
+++ b/js/metalstack/admin/v2/project_pb.d.ts
@@ -7,19 +7,19 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_project: GenFile;
 /**
- * ProjectServiceListRequest is the request payload for the project list request
+ * ProjectServiceListRequest is the request payload for listing projects.
  *
  * @generated from message metalstack.admin.v2.ProjectServiceListRequest
  */
 export type ProjectServiceListRequest = Message<"metalstack.admin.v2.ProjectServiceListRequest"> & {
     /**
-     * Tenant lists only projects of this tenant
+     * Tenant filters projects by this tenant
      *
      * @generated from field: optional string tenant = 1;
      */
     tenant?: string;
     /**
-     * Labels lists only projects containing the given labels
+     * Labels filters projects containing the given labels
      *
      * @generated from field: optional metalstack.api.v2.Labels labels = 2;
      */
@@ -31,13 +31,13 @@ export type ProjectServiceListRequest = Message<"metalstack.admin.v2.ProjectServ
  */
 export declare const ProjectServiceListRequestSchema: GenMessage<ProjectServiceListRequest>;
 /**
- * ProjectServiceListResponse is the response payload for the project list request
+ * ProjectServiceListResponse is the response payload for listing projects.
  *
  * @generated from message metalstack.admin.v2.ProjectServiceListResponse
  */
 export type ProjectServiceListResponse = Message<"metalstack.admin.v2.ProjectServiceListResponse"> & {
     /**
-     * Projects is a list of all projects
+     * Projects contains the list of projects
      *
      * @generated from field: repeated metalstack.api.v2.Project projects = 1;
      */
@@ -49,13 +49,13 @@ export type ProjectServiceListResponse = Message<"metalstack.admin.v2.ProjectSer
  */
 export declare const ProjectServiceListResponseSchema: GenMessage<ProjectServiceListResponse>;
 /**
- * ProjectService serves project related functions
+ * ProjectService provides project management operations.
  *
  * @generated from service metalstack.admin.v2.ProjectService
  */
 export declare const ProjectService: GenService<{
     /**
-     * List projects based on various filter criteria
+     * Returns the list of projects matching the filter criteria.
      *
      * @generated from rpc metalstack.admin.v2.ProjectService.List
      */
diff --git a/js/metalstack/admin/v2/project_pb.js b/js/metalstack/admin/v2/project_pb.js
index 1e8b9f46..1ec54637 100644
--- a/js/metalstack/admin/v2/project_pb.js
+++ b/js/metalstack/admin/v2/project_pb.js
@@ -21,7 +21,7 @@ export const ProjectServiceListRequestSchema = /*@__PURE__*/ messageDesc(file_me
  */
 export const ProjectServiceListResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_project, 1);
 /**
- * ProjectService serves project related functions
+ * ProjectService provides project management operations.
  *
  * @generated from service metalstack.admin.v2.ProjectService
  */
diff --git a/js/metalstack/admin/v2/project_pb.ts b/js/metalstack/admin/v2/project_pb.ts
index 914c265a..693c3b90 100644
--- a/js/metalstack/admin/v2/project_pb.ts
+++ b/js/metalstack/admin/v2/project_pb.ts
@@ -19,20 +19,20 @@ export const file_metalstack_admin_v2_project: GenFile = /*@__PURE__*/
   fileDesc("CiFtZXRhbHN0YWNrL2FkbWluL3YyL3Byb2plY3QucHJvdG8SE21ldGFsc3RhY2suYWRtaW4udjIigwEKGVByb2plY3RTZXJ2aWNlTGlzdFJlcXVlc3QSIAoGdGVuYW50GAEgASgJQgu6SAhyBsCzrrECAUgAiAEBEi4KBmxhYmVscxgCIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLkxhYmVsc0gBiAEBQgkKB190ZW5hbnRCCQoHX2xhYmVscyJKChpQcm9qZWN0U2VydmljZUxpc3RSZXNwb25zZRIsCghwcm9qZWN0cxgBIAMoCzIaLm1ldGFsc3RhY2suYXBpLnYyLlByb2plY3QyhQEKDlByb2plY3RTZXJ2aWNlEnMKBExpc3QSLi5tZXRhbHN0YWNrLmFkbWluLnYyLlByb2plY3RTZXJ2aWNlTGlzdFJlcXVlc3QaLy5tZXRhbHN0YWNrLmFkbWluLnYyLlByb2plY3RTZXJ2aWNlTGlzdFJlc3BvbnNlIgrS8xgCAQLg8xgCQtABChdjb20ubWV0YWxzdGFjay5hZG1pbi52MkIMUHJvamVjdFByb3RvUAFaOWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYWRtaW4vdjI7YWRtaW52MqICA01BWKoCE01ldGFsc3RhY2suQWRtaW4uVjLKAhNNZXRhbHN0YWNrXEFkbWluXFYy4gIfTWV0YWxzdGFja1xBZG1pblxWMlxHUEJNZXRhZGF0YeoCFU1ldGFsc3RhY2s6OkFkbWluOjpWMmIGcHJvdG8z", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_project]);
 
 /**
- * ProjectServiceListRequest is the request payload for the project list request
+ * ProjectServiceListRequest is the request payload for listing projects.
  *
  * @generated from message metalstack.admin.v2.ProjectServiceListRequest
  */
 export type ProjectServiceListRequest = Message<"metalstack.admin.v2.ProjectServiceListRequest"> & {
   /**
-   * Tenant lists only projects of this tenant
+   * Tenant filters projects by this tenant
    *
    * @generated from field: optional string tenant = 1;
    */
   tenant?: string;
 
   /**
-   * Labels lists only projects containing the given labels
+   * Labels filters projects containing the given labels
    *
    * @generated from field: optional metalstack.api.v2.Labels labels = 2;
    */
@@ -47,13 +47,13 @@ export const ProjectServiceListRequestSchema: GenMessage<ProjectServiceListReque
   messageDesc(file_metalstack_admin_v2_project, 0);
 
 /**
- * ProjectServiceListResponse is the response payload for the project list request
+ * ProjectServiceListResponse is the response payload for listing projects.
  *
  * @generated from message metalstack.admin.v2.ProjectServiceListResponse
  */
 export type ProjectServiceListResponse = Message<"metalstack.admin.v2.ProjectServiceListResponse"> & {
   /**
-   * Projects is a list of all projects
+   * Projects contains the list of projects
    *
    * @generated from field: repeated metalstack.api.v2.Project projects = 1;
    */
@@ -68,13 +68,13 @@ export const ProjectServiceListResponseSchema: GenMessage<ProjectServiceListResp
   messageDesc(file_metalstack_admin_v2_project, 1);
 
 /**
- * ProjectService serves project related functions
+ * ProjectService provides project management operations.
  *
  * @generated from service metalstack.admin.v2.ProjectService
  */
 export const ProjectService: GenService<{
   /**
-   * List projects based on various filter criteria
+   * Returns the list of projects matching the filter criteria.
    *
    * @generated from rpc metalstack.admin.v2.ProjectService.List
    */
diff --git a/js/metalstack/admin/v2/size_imageconstraint_pb.d.ts b/js/metalstack/admin/v2/size_imageconstraint_pb.d.ts
index 81cc96dc..35b32870 100644
--- a/js/metalstack/admin/v2/size_imageconstraint_pb.d.ts
+++ b/js/metalstack/admin/v2/size_imageconstraint_pb.d.ts
@@ -7,7 +7,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_size_imageconstraint: GenFile;
 /**
- * SizeImageConstraintServiceCreateRequest is the request payload for a size image constraint create request
+ * SizeImageConstraintServiceCreateRequest is the request payload for creating a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceCreateRequest
  */
@@ -49,13 +49,13 @@ export type SizeImageConstraintServiceCreateRequest = Message<"metalstack.admin.
  */
 export declare const SizeImageConstraintServiceCreateRequestSchema: GenMessage<SizeImageConstraintServiceCreateRequest>;
 /**
- * SizeImageConstraintServiceCreateResponse is the response payload for a size image constraint create request
+ * SizeImageConstraintServiceCreateResponse is the response payload for creating a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceCreateResponse
  */
 export type SizeImageConstraintServiceCreateResponse = Message<"metalstack.admin.v2.SizeImageConstraintServiceCreateResponse"> & {
     /**
-     * SizeImageConstraint created
+     * SizeImageConstraint contains the created constraint
      *
      * @generated from field: metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
      */
@@ -67,7 +67,7 @@ export type SizeImageConstraintServiceCreateResponse = Message<"metalstack.admin
  */
 export declare const SizeImageConstraintServiceCreateResponseSchema: GenMessage<SizeImageConstraintServiceCreateResponse>;
 /**
- * SizeImageConstraintServiceUpdateRequest is the request payload for a size image constraint update request
+ * SizeImageConstraintServiceUpdateRequest is the request payload for updating a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceUpdateRequest
  */
@@ -109,13 +109,13 @@ export type SizeImageConstraintServiceUpdateRequest = Message<"metalstack.admin.
  */
 export declare const SizeImageConstraintServiceUpdateRequestSchema: GenMessage<SizeImageConstraintServiceUpdateRequest>;
 /**
- * SizeImageConstraintServiceUpdateResponse is the response payload for a size image constraint update request
+ * SizeImageConstraintServiceUpdateResponse is the response payload for updating a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceUpdateResponse
  */
 export type SizeImageConstraintServiceUpdateResponse = Message<"metalstack.admin.v2.SizeImageConstraintServiceUpdateResponse"> & {
     /**
-     * SizeImageConstraint updated
+     * SizeImageConstraint contains the updated constraint
      *
      * @generated from field: metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
      */
@@ -127,7 +127,7 @@ export type SizeImageConstraintServiceUpdateResponse = Message<"metalstack.admin
  */
 export declare const SizeImageConstraintServiceUpdateResponseSchema: GenMessage<SizeImageConstraintServiceUpdateResponse>;
 /**
- * SizeImageConstraintServiceDeleteRequest is the request payload for a size image constraint delete request
+ * SizeImageConstraintServiceDeleteRequest is the request payload for deleting a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceDeleteRequest
  */
@@ -145,13 +145,13 @@ export type SizeImageConstraintServiceDeleteRequest = Message<"metalstack.admin.
  */
 export declare const SizeImageConstraintServiceDeleteRequestSchema: GenMessage<SizeImageConstraintServiceDeleteRequest>;
 /**
- * SizeImageConstraintServiceDeleteResponse is the response payload for a size image constraint delete request
+ * SizeImageConstraintServiceDeleteResponse is the response payload for deleting a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceDeleteResponse
  */
 export type SizeImageConstraintServiceDeleteResponse = Message<"metalstack.admin.v2.SizeImageConstraintServiceDeleteResponse"> & {
     /**
-     * SizeImageConstraint deleted
+     * SizeImageConstraint contains the deleted constraint
      *
      * @generated from field: metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
      */
@@ -163,7 +163,7 @@ export type SizeImageConstraintServiceDeleteResponse = Message<"metalstack.admin
  */
 export declare const SizeImageConstraintServiceDeleteResponseSchema: GenMessage<SizeImageConstraintServiceDeleteResponse>;
 /**
- * SizeImageConstraintServiceGetRequest is the request payload for a size image constraint get request
+ * SizeImageConstraintServiceGetRequest is the request payload for getting a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceGetRequest
  */
@@ -181,13 +181,13 @@ export type SizeImageConstraintServiceGetRequest = Message<"metalstack.admin.v2.
  */
 export declare const SizeImageConstraintServiceGetRequestSchema: GenMessage<SizeImageConstraintServiceGetRequest>;
 /**
- * SizeImageConstraintServiceGetResponse is the response payload for a size image constraint get request
+ * SizeImageConstraintServiceGetResponse is the response payload for getting a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceGetResponse
  */
 export type SizeImageConstraintServiceGetResponse = Message<"metalstack.admin.v2.SizeImageConstraintServiceGetResponse"> & {
     /**
-     * SizeImageConstraint get
+     * SizeImageConstraint contains the retrieved constraint
      *
      * @generated from field: metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
      */
@@ -199,7 +199,7 @@ export type SizeImageConstraintServiceGetResponse = Message<"metalstack.admin.v2
  */
 export declare const SizeImageConstraintServiceGetResponseSchema: GenMessage<SizeImageConstraintServiceGetResponse>;
 /**
- * SizeImageConstraintServiceListRequest is the request payload for a size image constraint list request
+ * SizeImageConstraintServiceListRequest is the request payload for listing size image constraints.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceListRequest
  */
@@ -217,13 +217,13 @@ export type SizeImageConstraintServiceListRequest = Message<"metalstack.admin.v2
  */
 export declare const SizeImageConstraintServiceListRequestSchema: GenMessage<SizeImageConstraintServiceListRequest>;
 /**
- * SizeImageConstraintServiceListResponse is the response payload for a size image constraint list request
+ * SizeImageConstraintServiceListResponse is the response payload for listing size image constraints.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceListResponse
  */
 export type SizeImageConstraintServiceListResponse = Message<"metalstack.admin.v2.SizeImageConstraintServiceListResponse"> & {
     /**
-     * SizeImageConstraints listed
+     * SizeImageConstraints contains the list of constraints
      *
      * @generated from field: repeated metalstack.api.v2.SizeImageConstraint size_image_constraints = 1;
      */
@@ -235,13 +235,13 @@ export type SizeImageConstraintServiceListResponse = Message<"metalstack.admin.v
  */
 export declare const SizeImageConstraintServiceListResponseSchema: GenMessage<SizeImageConstraintServiceListResponse>;
 /**
- * SizeImageConstraintService serves size and image constraint related functions
+ * SizeImageConstraintService provides size and image constraint management operations.
  *
  * @generated from service metalstack.admin.v2.SizeImageConstraintService
  */
 export declare const SizeImageConstraintService: GenService<{
     /**
-     * Create a size image constraint
+     * Creates a size image constraint.
      *
      * @generated from rpc metalstack.admin.v2.SizeImageConstraintService.Create
      */
@@ -251,7 +251,7 @@ export declare const SizeImageConstraintService: GenService<{
         output: typeof SizeImageConstraintServiceCreateResponseSchema;
     };
     /**
-     * Update a size image constraint
+     * Updates a size image constraint.
      *
      * @generated from rpc metalstack.admin.v2.SizeImageConstraintService.Update
      */
@@ -261,7 +261,7 @@ export declare const SizeImageConstraintService: GenService<{
         output: typeof SizeImageConstraintServiceUpdateResponseSchema;
     };
     /**
-     * Delete a size image constraint
+     * Deletes a size image constraint.
      *
      * @generated from rpc metalstack.admin.v2.SizeImageConstraintService.Delete
      */
@@ -271,7 +271,7 @@ export declare const SizeImageConstraintService: GenService<{
         output: typeof SizeImageConstraintServiceDeleteResponseSchema;
     };
     /**
-     * Get a size image constraint
+     * Returns the size image constraint with the specified size.
      *
      * @generated from rpc metalstack.admin.v2.SizeImageConstraintService.Get
      */
@@ -281,7 +281,7 @@ export declare const SizeImageConstraintService: GenService<{
         output: typeof SizeImageConstraintServiceGetResponseSchema;
     };
     /**
-     * List a size image constraint
+     * Returns the list of size image constraints.
      *
      * @generated from rpc metalstack.admin.v2.SizeImageConstraintService.List
      */
diff --git a/js/metalstack/admin/v2/size_imageconstraint_pb.js b/js/metalstack/admin/v2/size_imageconstraint_pb.js
index bcf57f42..23a92526 100644
--- a/js/metalstack/admin/v2/size_imageconstraint_pb.js
+++ b/js/metalstack/admin/v2/size_imageconstraint_pb.js
@@ -61,7 +61,7 @@ export const SizeImageConstraintServiceListRequestSchema = /*@__PURE__*/ message
  */
 export const SizeImageConstraintServiceListResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_size_imageconstraint, 9);
 /**
- * SizeImageConstraintService serves size and image constraint related functions
+ * SizeImageConstraintService provides size and image constraint management operations.
  *
  * @generated from service metalstack.admin.v2.SizeImageConstraintService
  */
diff --git a/js/metalstack/admin/v2/size_imageconstraint_pb.ts b/js/metalstack/admin/v2/size_imageconstraint_pb.ts
index 328d5331..c802e7e4 100644
--- a/js/metalstack/admin/v2/size_imageconstraint_pb.ts
+++ b/js/metalstack/admin/v2/size_imageconstraint_pb.ts
@@ -19,7 +19,7 @@ export const file_metalstack_admin_v2_size_imageconstraint: GenFile = /*@__PURE_
   fileDesc("Ci5tZXRhbHN0YWNrL2FkbWluL3YyL3NpemVfaW1hZ2Vjb25zdHJhaW50LnByb3RvEhNtZXRhbHN0YWNrLmFkbWluLnYyIooCCidTaXplSW1hZ2VDb25zdHJhaW50U2VydmljZUNyZWF0ZVJlcXVlc3QSGQoEc2l6ZRgBIAEoCUILukgIcgbAs66xAgESPQoRaW1hZ2VfY29uc3RyYWludHMYAiADKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5JbWFnZUNvbnN0cmFpbnQSJQoEbWV0YRgDIAEoCzIXLm1ldGFsc3RhY2suYXBpLnYyLk1ldGESHgoEbmFtZRgEIAEoCUILukgIcgbAs66xAgFIAIgBARIlCgtkZXNjcmlwdGlvbhgFIAEoCUILukgIcgbIs66xAgFIAYgBAUIHCgVfbmFtZUIOCgxfZGVzY3JpcHRpb24icQooU2l6ZUltYWdlQ29uc3RyYWludFNlcnZpY2VDcmVhdGVSZXNwb25zZRJFChVzaXplX2ltYWdlX2NvbnN0cmFpbnQYASABKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5TaXplSW1hZ2VDb25zdHJhaW50Ip8CCidTaXplSW1hZ2VDb25zdHJhaW50U2VydmljZVVwZGF0ZVJlcXVlc3QSGQoEc2l6ZRgBIAEoCUILukgIcgbAs66xAgESOgoLdXBkYXRlX21ldGEYAiABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5VcGRhdGVNZXRhQga6SAPIAQESPQoRaW1hZ2VfY29uc3RyYWludHMYAyADKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5JbWFnZUNvbnN0cmFpbnQSHgoEbmFtZRgEIAEoCUILukgIcgbAs66xAgFIAIgBARIlCgtkZXNjcmlwdGlvbhgFIAEoCUILukgIcgbIs66xAgFIAYgBAUIHCgVfbmFtZUIOCgxfZGVzY3JpcHRpb24icQooU2l6ZUltYWdlQ29uc3RyYWludFNlcnZpY2VVcGRhdGVSZXNwb25zZRJFChVzaXplX2ltYWdlX2NvbnN0cmFpbnQYASABKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5TaXplSW1hZ2VDb25zdHJhaW50IkQKJ1NpemVJbWFnZUNvbnN0cmFpbnRTZXJ2aWNlRGVsZXRlUmVxdWVzdBIZCgRzaXplGAEgASgJQgu6SAhyBsCzrrECASJxCihTaXplSW1hZ2VDb25zdHJhaW50U2VydmljZURlbGV0ZVJlc3BvbnNlEkUKFXNpemVfaW1hZ2VfY29uc3RyYWludBgBIAEoCzImLm1ldGFsc3RhY2suYXBpLnYyLlNpemVJbWFnZUNvbnN0cmFpbnQiQQokU2l6ZUltYWdlQ29uc3RyYWludFNlcnZpY2VHZXRSZXF1ZXN0EhkKBHNpemUYASABKAlCC7pICHIGwLOusQIBIm4KJVNpemVJbWFnZUNvbnN0cmFpbnRTZXJ2aWNlR2V0UmVzcG9uc2USRQoVc2l6ZV9pbWFnZV9jb25zdHJhaW50GAEgASgLMiYubWV0YWxzdGFjay5hcGkudjIuU2l6ZUltYWdlQ29uc3RyYWludCJjCiVTaXplSW1hZ2VDb25zdHJhaW50U2VydmljZUxpc3RSZXF1ZXN0EjoKBXF1ZXJ5GAEgASgLMisubWV0YWxzdGFjay5hcGkudjIuU2l6ZUltYWdlQ29uc3RyYWludFF1ZXJ5InAKJlNpemVJbWFnZUNvbnN0cmFpbnRTZXJ2aWNlTGlzdFJlc3BvbnNlEkYKFnNpemVfaW1hZ2VfY29uc3RyYWludHMYASADKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5TaXplSW1hZ2VDb25zdHJhaW50Mu4FChpTaXplSW1hZ2VDb25zdHJhaW50U2VydmljZRKQAQoGQ3JlYXRlEjwubWV0YWxzdGFjay5hZG1pbi52Mi5TaXplSW1hZ2VDb25zdHJhaW50U2VydmljZUNyZWF0ZVJlcXVlc3QaPS5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVJbWFnZUNvbnN0cmFpbnRTZXJ2aWNlQ3JlYXRlUmVzcG9uc2UiCdLzGAEB4PMYARKQAQoGVXBkYXRlEjwubWV0YWxzdGFjay5hZG1pbi52Mi5TaXplSW1hZ2VDb25zdHJhaW50U2VydmljZVVwZGF0ZVJlcXVlc3QaPS5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVJbWFnZUNvbnN0cmFpbnRTZXJ2aWNlVXBkYXRlUmVzcG9uc2UiCdLzGAEB4PMYARKQAQoGRGVsZXRlEjwubWV0YWxzdGFjay5hZG1pbi52Mi5TaXplSW1hZ2VDb25zdHJhaW50U2VydmljZURlbGV0ZVJlcXVlc3QaPS5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVJbWFnZUNvbnN0cmFpbnRTZXJ2aWNlRGVsZXRlUmVzcG9uc2UiCdLzGAEB4PMYARKIAQoDR2V0EjkubWV0YWxzdGFjay5hZG1pbi52Mi5TaXplSW1hZ2VDb25zdHJhaW50U2VydmljZUdldFJlcXVlc3QaOi5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVJbWFnZUNvbnN0cmFpbnRTZXJ2aWNlR2V0UmVzcG9uc2UiCtLzGAIBAuDzGAISiwEKBExpc3QSOi5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVJbWFnZUNvbnN0cmFpbnRTZXJ2aWNlTGlzdFJlcXVlc3QaOy5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVJbWFnZUNvbnN0cmFpbnRTZXJ2aWNlTGlzdFJlc3BvbnNlIgrS8xgCAQLg8xgCQtwBChdjb20ubWV0YWxzdGFjay5hZG1pbi52MkIYU2l6ZUltYWdlY29uc3RyYWludFByb3RvUAFaOWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYWRtaW4vdjI7YWRtaW52MqICA01BWKoCE01ldGFsc3RhY2suQWRtaW4uVjLKAhNNZXRhbHN0YWNrXEFkbWluXFYy4gIfTWV0YWxzdGFja1xBZG1pblxWMlxHUEJNZXRhZGF0YeoCFU1ldGFsc3RhY2s6OkFkbWluOjpWMmIGcHJvdG8z", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_size_imageconstraint]);
 
 /**
- * SizeImageConstraintServiceCreateRequest is the request payload for a size image constraint create request
+ * SizeImageConstraintServiceCreateRequest is the request payload for creating a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceCreateRequest
  */
@@ -68,13 +68,13 @@ export const SizeImageConstraintServiceCreateRequestSchema: GenMessage<SizeImage
   messageDesc(file_metalstack_admin_v2_size_imageconstraint, 0);
 
 /**
- * SizeImageConstraintServiceCreateResponse is the response payload for a size image constraint create request
+ * SizeImageConstraintServiceCreateResponse is the response payload for creating a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceCreateResponse
  */
 export type SizeImageConstraintServiceCreateResponse = Message<"metalstack.admin.v2.SizeImageConstraintServiceCreateResponse"> & {
   /**
-   * SizeImageConstraint created
+   * SizeImageConstraint contains the created constraint
    *
    * @generated from field: metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
    */
@@ -89,7 +89,7 @@ export const SizeImageConstraintServiceCreateResponseSchema: GenMessage<SizeImag
   messageDesc(file_metalstack_admin_v2_size_imageconstraint, 1);
 
 /**
- * SizeImageConstraintServiceUpdateRequest is the request payload for a size image constraint update request
+ * SizeImageConstraintServiceUpdateRequest is the request payload for updating a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceUpdateRequest
  */
@@ -138,13 +138,13 @@ export const SizeImageConstraintServiceUpdateRequestSchema: GenMessage<SizeImage
   messageDesc(file_metalstack_admin_v2_size_imageconstraint, 2);
 
 /**
- * SizeImageConstraintServiceUpdateResponse is the response payload for a size image constraint update request
+ * SizeImageConstraintServiceUpdateResponse is the response payload for updating a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceUpdateResponse
  */
 export type SizeImageConstraintServiceUpdateResponse = Message<"metalstack.admin.v2.SizeImageConstraintServiceUpdateResponse"> & {
   /**
-   * SizeImageConstraint updated
+   * SizeImageConstraint contains the updated constraint
    *
    * @generated from field: metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
    */
@@ -159,7 +159,7 @@ export const SizeImageConstraintServiceUpdateResponseSchema: GenMessage<SizeImag
   messageDesc(file_metalstack_admin_v2_size_imageconstraint, 3);
 
 /**
- * SizeImageConstraintServiceDeleteRequest is the request payload for a size image constraint delete request
+ * SizeImageConstraintServiceDeleteRequest is the request payload for deleting a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceDeleteRequest
  */
@@ -180,13 +180,13 @@ export const SizeImageConstraintServiceDeleteRequestSchema: GenMessage<SizeImage
   messageDesc(file_metalstack_admin_v2_size_imageconstraint, 4);
 
 /**
- * SizeImageConstraintServiceDeleteResponse is the response payload for a size image constraint delete request
+ * SizeImageConstraintServiceDeleteResponse is the response payload for deleting a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceDeleteResponse
  */
 export type SizeImageConstraintServiceDeleteResponse = Message<"metalstack.admin.v2.SizeImageConstraintServiceDeleteResponse"> & {
   /**
-   * SizeImageConstraint deleted
+   * SizeImageConstraint contains the deleted constraint
    *
    * @generated from field: metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
    */
@@ -201,7 +201,7 @@ export const SizeImageConstraintServiceDeleteResponseSchema: GenMessage<SizeImag
   messageDesc(file_metalstack_admin_v2_size_imageconstraint, 5);
 
 /**
- * SizeImageConstraintServiceGetRequest is the request payload for a size image constraint get request
+ * SizeImageConstraintServiceGetRequest is the request payload for getting a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceGetRequest
  */
@@ -222,13 +222,13 @@ export const SizeImageConstraintServiceGetRequestSchema: GenMessage<SizeImageCon
   messageDesc(file_metalstack_admin_v2_size_imageconstraint, 6);
 
 /**
- * SizeImageConstraintServiceGetResponse is the response payload for a size image constraint get request
+ * SizeImageConstraintServiceGetResponse is the response payload for getting a size image constraint.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceGetResponse
  */
 export type SizeImageConstraintServiceGetResponse = Message<"metalstack.admin.v2.SizeImageConstraintServiceGetResponse"> & {
   /**
-   * SizeImageConstraint get
+   * SizeImageConstraint contains the retrieved constraint
    *
    * @generated from field: metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
    */
@@ -243,7 +243,7 @@ export const SizeImageConstraintServiceGetResponseSchema: GenMessage<SizeImageCo
   messageDesc(file_metalstack_admin_v2_size_imageconstraint, 7);
 
 /**
- * SizeImageConstraintServiceListRequest is the request payload for a size image constraint list request
+ * SizeImageConstraintServiceListRequest is the request payload for listing size image constraints.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceListRequest
  */
@@ -264,13 +264,13 @@ export const SizeImageConstraintServiceListRequestSchema: GenMessage<SizeImageCo
   messageDesc(file_metalstack_admin_v2_size_imageconstraint, 8);
 
 /**
- * SizeImageConstraintServiceListResponse is the response payload for a size image constraint list request
+ * SizeImageConstraintServiceListResponse is the response payload for listing size image constraints.
  *
  * @generated from message metalstack.admin.v2.SizeImageConstraintServiceListResponse
  */
 export type SizeImageConstraintServiceListResponse = Message<"metalstack.admin.v2.SizeImageConstraintServiceListResponse"> & {
   /**
-   * SizeImageConstraints listed
+   * SizeImageConstraints contains the list of constraints
    *
    * @generated from field: repeated metalstack.api.v2.SizeImageConstraint size_image_constraints = 1;
    */
@@ -285,13 +285,13 @@ export const SizeImageConstraintServiceListResponseSchema: GenMessage<SizeImageC
   messageDesc(file_metalstack_admin_v2_size_imageconstraint, 9);
 
 /**
- * SizeImageConstraintService serves size and image constraint related functions
+ * SizeImageConstraintService provides size and image constraint management operations.
  *
  * @generated from service metalstack.admin.v2.SizeImageConstraintService
  */
 export const SizeImageConstraintService: GenService<{
   /**
-   * Create a size image constraint
+   * Creates a size image constraint.
    *
    * @generated from rpc metalstack.admin.v2.SizeImageConstraintService.Create
    */
@@ -301,7 +301,7 @@ export const SizeImageConstraintService: GenService<{
     output: typeof SizeImageConstraintServiceCreateResponseSchema;
   },
   /**
-   * Update a size image constraint
+   * Updates a size image constraint.
    *
    * @generated from rpc metalstack.admin.v2.SizeImageConstraintService.Update
    */
@@ -311,7 +311,7 @@ export const SizeImageConstraintService: GenService<{
     output: typeof SizeImageConstraintServiceUpdateResponseSchema;
   },
   /**
-   * Delete a size image constraint
+   * Deletes a size image constraint.
    *
    * @generated from rpc metalstack.admin.v2.SizeImageConstraintService.Delete
    */
@@ -321,7 +321,7 @@ export const SizeImageConstraintService: GenService<{
     output: typeof SizeImageConstraintServiceDeleteResponseSchema;
   },
   /**
-   * Get a size image constraint
+   * Returns the size image constraint with the specified size.
    *
    * @generated from rpc metalstack.admin.v2.SizeImageConstraintService.Get
    */
@@ -331,7 +331,7 @@ export const SizeImageConstraintService: GenService<{
     output: typeof SizeImageConstraintServiceGetResponseSchema;
   },
   /**
-   * List a size image constraint
+   * Returns the list of size image constraints.
    *
    * @generated from rpc metalstack.admin.v2.SizeImageConstraintService.List
    */
diff --git a/js/metalstack/admin/v2/size_pb.d.ts b/js/metalstack/admin/v2/size_pb.d.ts
index 4c16f516..c42fe931 100644
--- a/js/metalstack/admin/v2/size_pb.d.ts
+++ b/js/metalstack/admin/v2/size_pb.d.ts
@@ -7,7 +7,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_size: GenFile;
 /**
- * SizeServiceCreateRequest is the request payload for a size create request
+ * SizeServiceCreateRequest is the request payload for creating a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceCreateRequest
  */
@@ -25,13 +25,13 @@ export type SizeServiceCreateRequest = Message<"metalstack.admin.v2.SizeServiceC
  */
 export declare const SizeServiceCreateRequestSchema: GenMessage<SizeServiceCreateRequest>;
 /**
- * SizeServiceGetResponse is the response payload for a size create request
+ * SizeServiceCreateResponse is the response payload for creating a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceCreateResponse
  */
 export type SizeServiceCreateResponse = Message<"metalstack.admin.v2.SizeServiceCreateResponse"> & {
     /**
-     * Size the size
+     * Size contains the created size
      *
      * @generated from field: metalstack.api.v2.Size size = 1;
      */
@@ -43,7 +43,7 @@ export type SizeServiceCreateResponse = Message<"metalstack.admin.v2.SizeService
  */
 export declare const SizeServiceCreateResponseSchema: GenMessage<SizeServiceCreateResponse>;
 /**
- * SizeServiceUpdateRequest is the request payload for a size update request
+ * SizeServiceUpdateRequest is the request payload for updating a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceUpdateRequest
  */
@@ -91,13 +91,13 @@ export type SizeServiceUpdateRequest = Message<"metalstack.admin.v2.SizeServiceU
  */
 export declare const SizeServiceUpdateRequestSchema: GenMessage<SizeServiceUpdateRequest>;
 /**
- * SizeServiceUpdateResponse is the response payload for a size update request
+ * SizeServiceUpdateResponse is the response payload for updating a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceUpdateResponse
  */
 export type SizeServiceUpdateResponse = Message<"metalstack.admin.v2.SizeServiceUpdateResponse"> & {
     /**
-     * Size the size
+     * Size contains the updated size
      *
      * @generated from field: metalstack.api.v2.Size size = 1;
      */
@@ -109,7 +109,7 @@ export type SizeServiceUpdateResponse = Message<"metalstack.admin.v2.SizeService
  */
 export declare const SizeServiceUpdateResponseSchema: GenMessage<SizeServiceUpdateResponse>;
 /**
- * SizeServiceDeleteRequest is the request payload for a size delete request
+ * SizeServiceDeleteRequest is the request payload for deleting a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceDeleteRequest
  */
@@ -127,13 +127,13 @@ export type SizeServiceDeleteRequest = Message<"metalstack.admin.v2.SizeServiceD
  */
 export declare const SizeServiceDeleteRequestSchema: GenMessage<SizeServiceDeleteRequest>;
 /**
- * SizeServiceDeleteResponse is the response payload for a size delete request
+ * SizeServiceDeleteResponse is the response payload for deleting a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceDeleteResponse
  */
 export type SizeServiceDeleteResponse = Message<"metalstack.admin.v2.SizeServiceDeleteResponse"> & {
     /**
-     * Size the size
+     * Size contains the deleted size
      *
      * @generated from field: metalstack.api.v2.Size size = 1;
      */
@@ -145,13 +145,13 @@ export type SizeServiceDeleteResponse = Message<"metalstack.admin.v2.SizeService
  */
 export declare const SizeServiceDeleteResponseSchema: GenMessage<SizeServiceDeleteResponse>;
 /**
- * SizeService serves size related functions
+ * SizeService provides size management operations.
  *
  * @generated from service metalstack.admin.v2.SizeService
  */
 export declare const SizeService: GenService<{
     /**
-     * Create a size
+     * Creates a new size.
      *
      * @generated from rpc metalstack.admin.v2.SizeService.Create
      */
@@ -161,7 +161,7 @@ export declare const SizeService: GenService<{
         output: typeof SizeServiceCreateResponseSchema;
     };
     /**
-     * Update a size
+     * Updates a size.
      *
      * @generated from rpc metalstack.admin.v2.SizeService.Update
      */
@@ -171,7 +171,7 @@ export declare const SizeService: GenService<{
         output: typeof SizeServiceUpdateResponseSchema;
     };
     /**
-     * Delete a size
+     * Deletes a size.
      *
      * @generated from rpc metalstack.admin.v2.SizeService.Delete
      */
diff --git a/js/metalstack/admin/v2/size_pb.js b/js/metalstack/admin/v2/size_pb.js
index f870a5de..235f8f96 100644
--- a/js/metalstack/admin/v2/size_pb.js
+++ b/js/metalstack/admin/v2/size_pb.js
@@ -41,7 +41,7 @@ export const SizeServiceDeleteRequestSchema = /*@__PURE__*/ messageDesc(file_met
  */
 export const SizeServiceDeleteResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_size, 5);
 /**
- * SizeService serves size related functions
+ * SizeService provides size management operations.
  *
  * @generated from service metalstack.admin.v2.SizeService
  */
diff --git a/js/metalstack/admin/v2/size_pb.ts b/js/metalstack/admin/v2/size_pb.ts
index d6001611..98c5a498 100644
--- a/js/metalstack/admin/v2/size_pb.ts
+++ b/js/metalstack/admin/v2/size_pb.ts
@@ -19,7 +19,7 @@ export const file_metalstack_admin_v2_size: GenFile = /*@__PURE__*/
   fileDesc("Ch5tZXRhbHN0YWNrL2FkbWluL3YyL3NpemUucHJvdG8SE21ldGFsc3RhY2suYWRtaW4udjIiQQoYU2l6ZVNlcnZpY2VDcmVhdGVSZXF1ZXN0EiUKBHNpemUYASABKAsyFy5tZXRhbHN0YWNrLmFwaS52Mi5TaXplIkIKGVNpemVTZXJ2aWNlQ3JlYXRlUmVzcG9uc2USJQoEc2l6ZRgBIAEoCzIXLm1ldGFsc3RhY2suYXBpLnYyLlNpemUiyAIKGFNpemVTZXJ2aWNlVXBkYXRlUmVxdWVzdBIXCgJpZBgBIAEoCUILukgIcgbAs66xAgESOgoLdXBkYXRlX21ldGEYAiABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5VcGRhdGVNZXRhQga6SAPIAQESHgoEbmFtZRgDIAEoCUILukgIcgbAs66xAgFIAIgBARIlCgtkZXNjcmlwdGlvbhgEIAEoCUILukgIcgbIs66xAgFIAYgBARI2Cgtjb25zdHJhaW50cxgFIAMoCzIhLm1ldGFsc3RhY2suYXBpLnYyLlNpemVDb25zdHJhaW50EjQKBmxhYmVscxgGIAEoCzIfLm1ldGFsc3RhY2suYXBpLnYyLlVwZGF0ZUxhYmVsc0gCiAEBQgcKBV9uYW1lQg4KDF9kZXNjcmlwdGlvbkIJCgdfbGFiZWxzIkIKGVNpemVTZXJ2aWNlVXBkYXRlUmVzcG9uc2USJQoEc2l6ZRgBIAEoCzIXLm1ldGFsc3RhY2suYXBpLnYyLlNpemUiMwoYU2l6ZVNlcnZpY2VEZWxldGVSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBsCzrrECASJCChlTaXplU2VydmljZURlbGV0ZVJlc3BvbnNlEiUKBHNpemUYASABKAsyFy5tZXRhbHN0YWNrLmFwaS52Mi5TaXplMt0CCgtTaXplU2VydmljZRJuCgZDcmVhdGUSLS5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVTZXJ2aWNlQ3JlYXRlUmVxdWVzdBouLm1ldGFsc3RhY2suYWRtaW4udjIuU2l6ZVNlcnZpY2VDcmVhdGVSZXNwb25zZSIF0vMYAQESbgoGVXBkYXRlEi0ubWV0YWxzdGFjay5hZG1pbi52Mi5TaXplU2VydmljZVVwZGF0ZVJlcXVlc3QaLi5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVTZXJ2aWNlVXBkYXRlUmVzcG9uc2UiBdLzGAEBEm4KBkRlbGV0ZRItLm1ldGFsc3RhY2suYWRtaW4udjIuU2l6ZVNlcnZpY2VEZWxldGVSZXF1ZXN0Gi4ubWV0YWxzdGFjay5hZG1pbi52Mi5TaXplU2VydmljZURlbGV0ZVJlc3BvbnNlIgXS8xgBAULNAQoXY29tLm1ldGFsc3RhY2suYWRtaW4udjJCCVNpemVQcm90b1ABWjlnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FkbWluL3YyO2FkbWludjKiAgNNQViqAhNNZXRhbHN0YWNrLkFkbWluLlYyygITTWV0YWxzdGFja1xBZG1pblxWMuICH01ldGFsc3RhY2tcQWRtaW5cVjJcR1BCTWV0YWRhdGHqAhVNZXRhbHN0YWNrOjpBZG1pbjo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_size]);
 
 /**
- * SizeServiceCreateRequest is the request payload for a size create request
+ * SizeServiceCreateRequest is the request payload for creating a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceCreateRequest
  */
@@ -40,13 +40,13 @@ export const SizeServiceCreateRequestSchema: GenMessage<SizeServiceCreateRequest
   messageDesc(file_metalstack_admin_v2_size, 0);
 
 /**
- * SizeServiceGetResponse is the response payload for a size create request
+ * SizeServiceCreateResponse is the response payload for creating a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceCreateResponse
  */
 export type SizeServiceCreateResponse = Message<"metalstack.admin.v2.SizeServiceCreateResponse"> & {
   /**
-   * Size the size
+   * Size contains the created size
    *
    * @generated from field: metalstack.api.v2.Size size = 1;
    */
@@ -61,7 +61,7 @@ export const SizeServiceCreateResponseSchema: GenMessage<SizeServiceCreateRespon
   messageDesc(file_metalstack_admin_v2_size, 1);
 
 /**
- * SizeServiceUpdateRequest is the request payload for a size update request
+ * SizeServiceUpdateRequest is the request payload for updating a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceUpdateRequest
  */
@@ -117,13 +117,13 @@ export const SizeServiceUpdateRequestSchema: GenMessage<SizeServiceUpdateRequest
   messageDesc(file_metalstack_admin_v2_size, 2);
 
 /**
- * SizeServiceUpdateResponse is the response payload for a size update request
+ * SizeServiceUpdateResponse is the response payload for updating a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceUpdateResponse
  */
 export type SizeServiceUpdateResponse = Message<"metalstack.admin.v2.SizeServiceUpdateResponse"> & {
   /**
-   * Size the size
+   * Size contains the updated size
    *
    * @generated from field: metalstack.api.v2.Size size = 1;
    */
@@ -138,7 +138,7 @@ export const SizeServiceUpdateResponseSchema: GenMessage<SizeServiceUpdateRespon
   messageDesc(file_metalstack_admin_v2_size, 3);
 
 /**
- * SizeServiceDeleteRequest is the request payload for a size delete request
+ * SizeServiceDeleteRequest is the request payload for deleting a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceDeleteRequest
  */
@@ -159,13 +159,13 @@ export const SizeServiceDeleteRequestSchema: GenMessage<SizeServiceDeleteRequest
   messageDesc(file_metalstack_admin_v2_size, 4);
 
 /**
- * SizeServiceDeleteResponse is the response payload for a size delete request
+ * SizeServiceDeleteResponse is the response payload for deleting a size.
  *
  * @generated from message metalstack.admin.v2.SizeServiceDeleteResponse
  */
 export type SizeServiceDeleteResponse = Message<"metalstack.admin.v2.SizeServiceDeleteResponse"> & {
   /**
-   * Size the size
+   * Size contains the deleted size
    *
    * @generated from field: metalstack.api.v2.Size size = 1;
    */
@@ -180,13 +180,13 @@ export const SizeServiceDeleteResponseSchema: GenMessage<SizeServiceDeleteRespon
   messageDesc(file_metalstack_admin_v2_size, 5);
 
 /**
- * SizeService serves size related functions
+ * SizeService provides size management operations.
  *
  * @generated from service metalstack.admin.v2.SizeService
  */
 export const SizeService: GenService<{
   /**
-   * Create a size
+   * Creates a new size.
    *
    * @generated from rpc metalstack.admin.v2.SizeService.Create
    */
@@ -196,7 +196,7 @@ export const SizeService: GenService<{
     output: typeof SizeServiceCreateResponseSchema;
   },
   /**
-   * Update a size
+   * Updates a size.
    *
    * @generated from rpc metalstack.admin.v2.SizeService.Update
    */
@@ -206,7 +206,7 @@ export const SizeService: GenService<{
     output: typeof SizeServiceUpdateResponseSchema;
   },
   /**
-   * Delete a size
+   * Deletes a size.
    *
    * @generated from rpc metalstack.admin.v2.SizeService.Delete
    */
diff --git a/js/metalstack/admin/v2/size_reservation_pb.d.ts b/js/metalstack/admin/v2/size_reservation_pb.d.ts
index 6dab55ff..9e0475f4 100644
--- a/js/metalstack/admin/v2/size_reservation_pb.d.ts
+++ b/js/metalstack/admin/v2/size_reservation_pb.d.ts
@@ -7,7 +7,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_size_reservation: GenFile;
 /**
- * SizeReservationServiceCreateRequest is the request payload for a size reservation create request
+ * SizeReservationServiceCreateRequest is the request payload for creating a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceCreateRequest
  */
@@ -25,13 +25,13 @@ export type SizeReservationServiceCreateRequest = Message<"metalstack.admin.v2.S
  */
 export declare const SizeReservationServiceCreateRequestSchema: GenMessage<SizeReservationServiceCreateRequest>;
 /**
- * SizeReservationServiceCreateResponse is the response payload for a size reservation create request
+ * SizeReservationServiceCreateResponse is the response payload for creating a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceCreateResponse
  */
 export type SizeReservationServiceCreateResponse = Message<"metalstack.admin.v2.SizeReservationServiceCreateResponse"> & {
     /**
-     * SizeReservation the size reservation
+     * SizeReservation contains the created reservation
      *
      * @generated from field: metalstack.api.v2.SizeReservation size_reservation = 1;
      */
@@ -43,7 +43,7 @@ export type SizeReservationServiceCreateResponse = Message<"metalstack.admin.v2.
  */
 export declare const SizeReservationServiceCreateResponseSchema: GenMessage<SizeReservationServiceCreateResponse>;
 /**
- * SizeReservationServiceUpdateRequest is the request payload for a size reservation update request
+ * SizeReservationServiceUpdateRequest is the request payload for updating a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceUpdateRequest
  */
@@ -97,13 +97,13 @@ export type SizeReservationServiceUpdateRequest = Message<"metalstack.admin.v2.S
  */
 export declare const SizeReservationServiceUpdateRequestSchema: GenMessage<SizeReservationServiceUpdateRequest>;
 /**
- * SizeReservationServiceUpdateResponse is the response payload for a size reservation update request
+ * SizeReservationServiceUpdateResponse is the response payload for updating a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceUpdateResponse
  */
 export type SizeReservationServiceUpdateResponse = Message<"metalstack.admin.v2.SizeReservationServiceUpdateResponse"> & {
     /**
-     * SizeReservation the size reservation
+     * SizeReservation contains the updated reservation
      *
      * @generated from field: metalstack.api.v2.SizeReservation size_reservation = 1;
      */
@@ -115,7 +115,7 @@ export type SizeReservationServiceUpdateResponse = Message<"metalstack.admin.v2.
  */
 export declare const SizeReservationServiceUpdateResponseSchema: GenMessage<SizeReservationServiceUpdateResponse>;
 /**
- * SizeReservationServiceDeleteRequest is the request payload for a size reservation delete request
+ * SizeReservationServiceDeleteRequest is the request payload for deleting a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceDeleteRequest
  */
@@ -133,13 +133,13 @@ export type SizeReservationServiceDeleteRequest = Message<"metalstack.admin.v2.S
  */
 export declare const SizeReservationServiceDeleteRequestSchema: GenMessage<SizeReservationServiceDeleteRequest>;
 /**
- * SizeReservationServiceDeleteResponse is the response payload for a size reservation delete request
+ * SizeReservationServiceDeleteResponse is the response payload for deleting a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceDeleteResponse
  */
 export type SizeReservationServiceDeleteResponse = Message<"metalstack.admin.v2.SizeReservationServiceDeleteResponse"> & {
     /**
-     * SizeReservation the size reservation
+     * SizeReservation contains the deleted reservation
      *
      * @generated from field: metalstack.api.v2.SizeReservation size_reservation = 1;
      */
@@ -151,7 +151,7 @@ export type SizeReservationServiceDeleteResponse = Message<"metalstack.admin.v2.
  */
 export declare const SizeReservationServiceDeleteResponseSchema: GenMessage<SizeReservationServiceDeleteResponse>;
 /**
- * SizeReservationServiceListRequest is the request payload for a size list request
+ * SizeReservationServiceListRequest is the request payload for listing size reservations.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceListRequest
  */
@@ -169,13 +169,13 @@ export type SizeReservationServiceListRequest = Message<"metalstack.admin.v2.Siz
  */
 export declare const SizeReservationServiceListRequestSchema: GenMessage<SizeReservationServiceListRequest>;
 /**
- * SizeReservationServiceListResponse is the response payload for a size reservation list request
+ * SizeReservationServiceListResponse is the response payload for listing size reservations.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceListResponse
  */
 export type SizeReservationServiceListResponse = Message<"metalstack.admin.v2.SizeReservationServiceListResponse"> & {
     /**
-     * Size reservations
+     * SizeReservations contains the list of reservations
      *
      * @generated from field: repeated metalstack.api.v2.SizeReservation size_reservations = 1;
      */
@@ -187,13 +187,13 @@ export type SizeReservationServiceListResponse = Message<"metalstack.admin.v2.Si
  */
 export declare const SizeReservationServiceListResponseSchema: GenMessage<SizeReservationServiceListResponse>;
 /**
- * SizeReservationService serves size reservation related functions
+ * SizeReservationService provides size reservation management operations.
  *
  * @generated from service metalstack.admin.v2.SizeReservationService
  */
 export declare const SizeReservationService: GenService<{
     /**
-     * Create a size reservation
+     * Creates a new size reservation.
      *
      * @generated from rpc metalstack.admin.v2.SizeReservationService.Create
      */
@@ -203,7 +203,7 @@ export declare const SizeReservationService: GenService<{
         output: typeof SizeReservationServiceCreateResponseSchema;
     };
     /**
-     * Update a size reservation
+     * Updates a size reservation.
      *
      * @generated from rpc metalstack.admin.v2.SizeReservationService.Update
      */
@@ -213,7 +213,7 @@ export declare const SizeReservationService: GenService<{
         output: typeof SizeReservationServiceUpdateResponseSchema;
     };
     /**
-     * Delete a size reservation
+     * Deletes a size reservation.
      *
      * @generated from rpc metalstack.admin.v2.SizeReservationService.Delete
      */
@@ -223,7 +223,7 @@ export declare const SizeReservationService: GenService<{
         output: typeof SizeReservationServiceDeleteResponseSchema;
     };
     /**
-     * List size reservations
+     * Returns the list of size reservations.
      *
      * @generated from rpc metalstack.admin.v2.SizeReservationService.List
      */
diff --git a/js/metalstack/admin/v2/size_reservation_pb.js b/js/metalstack/admin/v2/size_reservation_pb.js
index 83ca848c..ecc2cff2 100644
--- a/js/metalstack/admin/v2/size_reservation_pb.js
+++ b/js/metalstack/admin/v2/size_reservation_pb.js
@@ -51,7 +51,7 @@ export const SizeReservationServiceListRequestSchema = /*@__PURE__*/ messageDesc
  */
 export const SizeReservationServiceListResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_size_reservation, 7);
 /**
- * SizeReservationService serves size reservation related functions
+ * SizeReservationService provides size reservation management operations.
  *
  * @generated from service metalstack.admin.v2.SizeReservationService
  */
diff --git a/js/metalstack/admin/v2/size_reservation_pb.ts b/js/metalstack/admin/v2/size_reservation_pb.ts
index 4dd7815a..f9598e46 100644
--- a/js/metalstack/admin/v2/size_reservation_pb.ts
+++ b/js/metalstack/admin/v2/size_reservation_pb.ts
@@ -19,7 +19,7 @@ export const file_metalstack_admin_v2_size_reservation: GenFile = /*@__PURE__*/
   fileDesc("CiptZXRhbHN0YWNrL2FkbWluL3YyL3NpemVfcmVzZXJ2YXRpb24ucHJvdG8SE21ldGFsc3RhY2suYWRtaW4udjIiYwojU2l6ZVJlc2VydmF0aW9uU2VydmljZUNyZWF0ZVJlcXVlc3QSPAoQc2l6ZV9yZXNlcnZhdGlvbhgBIAEoCzIiLm1ldGFsc3RhY2suYXBpLnYyLlNpemVSZXNlcnZhdGlvbiJkCiRTaXplUmVzZXJ2YXRpb25TZXJ2aWNlQ3JlYXRlUmVzcG9uc2USPAoQc2l6ZV9yZXNlcnZhdGlvbhgBIAEoCzIiLm1ldGFsc3RhY2suYXBpLnYyLlNpemVSZXNlcnZhdGlvbiLpAgojU2l6ZVJlc2VydmF0aW9uU2VydmljZVVwZGF0ZVJlcXVlc3QSFAoCaWQYASABKAlCCLpIBXIDsAEBEh4KBG5hbWUYAiABKAlCC7pICHIGwLOusQIBSACIAQESJQoLZGVzY3JpcHRpb24YAyABKAlCC7pICHIGyLOusQIBSAGIAQESOgoLdXBkYXRlX21ldGEYBCABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5VcGRhdGVNZXRhQga6SAPIAQESJgoKcGFydGl0aW9ucxgFIAMoCUISukgPkgEMGAEiCHIG0LOusQIBEhwKBmFtb3VudBgGIAEoBUIHukgEGgIgAEgCiAEBEjQKBmxhYmVscxgHIAEoCzIfLm1ldGFsc3RhY2suYXBpLnYyLlVwZGF0ZUxhYmVsc0gDiAEBQgcKBV9uYW1lQg4KDF9kZXNjcmlwdGlvbkIJCgdfYW1vdW50QgkKB19sYWJlbHMiZAokU2l6ZVJlc2VydmF0aW9uU2VydmljZVVwZGF0ZVJlc3BvbnNlEjwKEHNpemVfcmVzZXJ2YXRpb24YASABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5TaXplUmVzZXJ2YXRpb24iOwojU2l6ZVJlc2VydmF0aW9uU2VydmljZURlbGV0ZVJlcXVlc3QSFAoCaWQYASABKAlCCLpIBXIDsAEBImQKJFNpemVSZXNlcnZhdGlvblNlcnZpY2VEZWxldGVSZXNwb25zZRI8ChBzaXplX3Jlc2VydmF0aW9uGAEgASgLMiIubWV0YWxzdGFjay5hcGkudjIuU2l6ZVJlc2VydmF0aW9uIlsKIVNpemVSZXNlcnZhdGlvblNlcnZpY2VMaXN0UmVxdWVzdBI2CgVxdWVyeRgBIAEoCzInLm1ldGFsc3RhY2suYXBpLnYyLlNpemVSZXNlcnZhdGlvblF1ZXJ5ImMKIlNpemVSZXNlcnZhdGlvblNlcnZpY2VMaXN0UmVzcG9uc2USPQoRc2l6ZV9yZXNlcnZhdGlvbnMYASADKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5TaXplUmVzZXJ2YXRpb24yvwQKFlNpemVSZXNlcnZhdGlvblNlcnZpY2USiAEKBkNyZWF0ZRI4Lm1ldGFsc3RhY2suYWRtaW4udjIuU2l6ZVJlc2VydmF0aW9uU2VydmljZUNyZWF0ZVJlcXVlc3QaOS5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVSZXNlcnZhdGlvblNlcnZpY2VDcmVhdGVSZXNwb25zZSIJ0vMYAQHg8xgBEogBCgZVcGRhdGUSOC5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVSZXNlcnZhdGlvblNlcnZpY2VVcGRhdGVSZXF1ZXN0GjkubWV0YWxzdGFjay5hZG1pbi52Mi5TaXplUmVzZXJ2YXRpb25TZXJ2aWNlVXBkYXRlUmVzcG9uc2UiCdLzGAEB4PMYARKIAQoGRGVsZXRlEjgubWV0YWxzdGFjay5hZG1pbi52Mi5TaXplUmVzZXJ2YXRpb25TZXJ2aWNlRGVsZXRlUmVxdWVzdBo5Lm1ldGFsc3RhY2suYWRtaW4udjIuU2l6ZVJlc2VydmF0aW9uU2VydmljZURlbGV0ZVJlc3BvbnNlIgnS8xgBAeDzGAESgwEKBExpc3QSNi5tZXRhbHN0YWNrLmFkbWluLnYyLlNpemVSZXNlcnZhdGlvblNlcnZpY2VMaXN0UmVxdWVzdBo3Lm1ldGFsc3RhY2suYWRtaW4udjIuU2l6ZVJlc2VydmF0aW9uU2VydmljZUxpc3RSZXNwb25zZSIK0vMYAgEC4PMYAkLYAQoXY29tLm1ldGFsc3RhY2suYWRtaW4udjJCFFNpemVSZXNlcnZhdGlvblByb3RvUAFaOWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYWRtaW4vdjI7YWRtaW52MqICA01BWKoCE01ldGFsc3RhY2suQWRtaW4uVjLKAhNNZXRhbHN0YWNrXEFkbWluXFYy4gIfTWV0YWxzdGFja1xBZG1pblxWMlxHUEJNZXRhZGF0YeoCFU1ldGFsc3RhY2s6OkFkbWluOjpWMmIGcHJvdG8z", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_size_reservation]);
 
 /**
- * SizeReservationServiceCreateRequest is the request payload for a size reservation create request
+ * SizeReservationServiceCreateRequest is the request payload for creating a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceCreateRequest
  */
@@ -40,13 +40,13 @@ export const SizeReservationServiceCreateRequestSchema: GenMessage<SizeReservati
   messageDesc(file_metalstack_admin_v2_size_reservation, 0);
 
 /**
- * SizeReservationServiceCreateResponse is the response payload for a size reservation create request
+ * SizeReservationServiceCreateResponse is the response payload for creating a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceCreateResponse
  */
 export type SizeReservationServiceCreateResponse = Message<"metalstack.admin.v2.SizeReservationServiceCreateResponse"> & {
   /**
-   * SizeReservation the size reservation
+   * SizeReservation contains the created reservation
    *
    * @generated from field: metalstack.api.v2.SizeReservation size_reservation = 1;
    */
@@ -61,7 +61,7 @@ export const SizeReservationServiceCreateResponseSchema: GenMessage<SizeReservat
   messageDesc(file_metalstack_admin_v2_size_reservation, 1);
 
 /**
- * SizeReservationServiceUpdateRequest is the request payload for a size reservation update request
+ * SizeReservationServiceUpdateRequest is the request payload for updating a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceUpdateRequest
  */
@@ -124,13 +124,13 @@ export const SizeReservationServiceUpdateRequestSchema: GenMessage<SizeReservati
   messageDesc(file_metalstack_admin_v2_size_reservation, 2);
 
 /**
- * SizeReservationServiceUpdateResponse is the response payload for a size reservation update request
+ * SizeReservationServiceUpdateResponse is the response payload for updating a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceUpdateResponse
  */
 export type SizeReservationServiceUpdateResponse = Message<"metalstack.admin.v2.SizeReservationServiceUpdateResponse"> & {
   /**
-   * SizeReservation the size reservation
+   * SizeReservation contains the updated reservation
    *
    * @generated from field: metalstack.api.v2.SizeReservation size_reservation = 1;
    */
@@ -145,7 +145,7 @@ export const SizeReservationServiceUpdateResponseSchema: GenMessage<SizeReservat
   messageDesc(file_metalstack_admin_v2_size_reservation, 3);
 
 /**
- * SizeReservationServiceDeleteRequest is the request payload for a size reservation delete request
+ * SizeReservationServiceDeleteRequest is the request payload for deleting a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceDeleteRequest
  */
@@ -166,13 +166,13 @@ export const SizeReservationServiceDeleteRequestSchema: GenMessage<SizeReservati
   messageDesc(file_metalstack_admin_v2_size_reservation, 4);
 
 /**
- * SizeReservationServiceDeleteResponse is the response payload for a size reservation delete request
+ * SizeReservationServiceDeleteResponse is the response payload for deleting a size reservation.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceDeleteResponse
  */
 export type SizeReservationServiceDeleteResponse = Message<"metalstack.admin.v2.SizeReservationServiceDeleteResponse"> & {
   /**
-   * SizeReservation the size reservation
+   * SizeReservation contains the deleted reservation
    *
    * @generated from field: metalstack.api.v2.SizeReservation size_reservation = 1;
    */
@@ -187,7 +187,7 @@ export const SizeReservationServiceDeleteResponseSchema: GenMessage<SizeReservat
   messageDesc(file_metalstack_admin_v2_size_reservation, 5);
 
 /**
- * SizeReservationServiceListRequest is the request payload for a size list request
+ * SizeReservationServiceListRequest is the request payload for listing size reservations.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceListRequest
  */
@@ -208,13 +208,13 @@ export const SizeReservationServiceListRequestSchema: GenMessage<SizeReservation
   messageDesc(file_metalstack_admin_v2_size_reservation, 6);
 
 /**
- * SizeReservationServiceListResponse is the response payload for a size reservation list request
+ * SizeReservationServiceListResponse is the response payload for listing size reservations.
  *
  * @generated from message metalstack.admin.v2.SizeReservationServiceListResponse
  */
 export type SizeReservationServiceListResponse = Message<"metalstack.admin.v2.SizeReservationServiceListResponse"> & {
   /**
-   * Size reservations
+   * SizeReservations contains the list of reservations
    *
    * @generated from field: repeated metalstack.api.v2.SizeReservation size_reservations = 1;
    */
@@ -229,13 +229,13 @@ export const SizeReservationServiceListResponseSchema: GenMessage<SizeReservatio
   messageDesc(file_metalstack_admin_v2_size_reservation, 7);
 
 /**
- * SizeReservationService serves size reservation related functions
+ * SizeReservationService provides size reservation management operations.
  *
  * @generated from service metalstack.admin.v2.SizeReservationService
  */
 export const SizeReservationService: GenService<{
   /**
-   * Create a size reservation
+   * Creates a new size reservation.
    *
    * @generated from rpc metalstack.admin.v2.SizeReservationService.Create
    */
@@ -245,7 +245,7 @@ export const SizeReservationService: GenService<{
     output: typeof SizeReservationServiceCreateResponseSchema;
   },
   /**
-   * Update a size reservation
+   * Updates a size reservation.
    *
    * @generated from rpc metalstack.admin.v2.SizeReservationService.Update
    */
@@ -255,7 +255,7 @@ export const SizeReservationService: GenService<{
     output: typeof SizeReservationServiceUpdateResponseSchema;
   },
   /**
-   * Delete a size reservation
+   * Deletes a size reservation.
    *
    * @generated from rpc metalstack.admin.v2.SizeReservationService.Delete
    */
@@ -265,7 +265,7 @@ export const SizeReservationService: GenService<{
     output: typeof SizeReservationServiceDeleteResponseSchema;
   },
   /**
-   * List size reservations
+   * Returns the list of size reservations.
    *
    * @generated from rpc metalstack.admin.v2.SizeReservationService.List
    */
diff --git a/js/metalstack/admin/v2/switch_pb.d.ts b/js/metalstack/admin/v2/switch_pb.d.ts
index 5f096f33..b1658f3b 100644
--- a/js/metalstack/admin/v2/switch_pb.d.ts
+++ b/js/metalstack/admin/v2/switch_pb.d.ts
@@ -9,13 +9,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_switch: GenFile;
 /**
- * SwitchServiceGetRequest.
+ * SwitchServiceGetRequest is the request payload for getting a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceGetRequest
  */
 export type SwitchServiceGetRequest = Message<"metalstack.admin.v2.SwitchServiceGetRequest"> & {
     /**
-     * Id of the switch to get.
+     * Id of the switch to get
      *
      * @generated from field: string id = 1;
      */
@@ -27,13 +27,13 @@ export type SwitchServiceGetRequest = Message<"metalstack.admin.v2.SwitchService
  */
 export declare const SwitchServiceGetRequestSchema: GenMessage<SwitchServiceGetRequest>;
 /**
- * SwitchServiceGetResponse.
+ * SwitchServiceGetResponse is the response payload for getting a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceGetResponse
  */
 export type SwitchServiceGetResponse = Message<"metalstack.admin.v2.SwitchServiceGetResponse"> & {
     /**
-     * Switch that was requested.
+     * Switch contains the requested switch
      *
      * @generated from field: metalstack.api.v2.Switch switch = 1;
      */
@@ -45,13 +45,13 @@ export type SwitchServiceGetResponse = Message<"metalstack.admin.v2.SwitchServic
  */
 export declare const SwitchServiceGetResponseSchema: GenMessage<SwitchServiceGetResponse>;
 /**
- * SwitchServiceListRequest.
+ * SwitchServiceListRequest is the request payload for listing switches.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceListRequest
  */
 export type SwitchServiceListRequest = Message<"metalstack.admin.v2.SwitchServiceListRequest"> & {
     /**
-     * Query to filter the results.
+     * Query to filter the results
      *
      * @generated from field: metalstack.api.v2.SwitchQuery query = 1;
      */
@@ -63,13 +63,13 @@ export type SwitchServiceListRequest = Message<"metalstack.admin.v2.SwitchServic
  */
 export declare const SwitchServiceListRequestSchema: GenMessage<SwitchServiceListRequest>;
 /**
- * SwitchServiceListResponse.
+ * SwitchServiceListResponse is the response payload for listing switches.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceListResponse
  */
 export type SwitchServiceListResponse = Message<"metalstack.admin.v2.SwitchServiceListResponse"> & {
     /**
-     * Switches that match the request query.
+     * Switches that match the request query
      *
      * @generated from field: repeated metalstack.api.v2.Switch switches = 1;
      */
@@ -81,68 +81,68 @@ export type SwitchServiceListResponse = Message<"metalstack.admin.v2.SwitchServi
  */
 export declare const SwitchServiceListResponseSchema: GenMessage<SwitchServiceListResponse>;
 /**
- * SwitchServiceUpdateRequest.
+ * SwitchServiceUpdateRequest is the request payload for updating a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceUpdateRequest
  */
 export type SwitchServiceUpdateRequest = Message<"metalstack.admin.v2.SwitchServiceUpdateRequest"> & {
     /**
-     * ID of the switch.
+     * ID of the switch
      *
      * @generated from field: string id = 1;
      */
     id: string;
     /**
-     * UpdateMeta contains the timestamp and strategy to be used in this update request.
+     * UpdateMeta contains the timestamp and strategy to be used in this update request
      *
      * @generated from field: metalstack.api.v2.UpdateMeta update_meta = 2;
      */
     updateMeta?: UpdateMeta;
     /**
-     * UpdatedAt is the date when this entity was updated.
-     * must be part of the update request to ensure optimistic locking.
+     * UpdatedAt is the date when this entity was updated
+     * Must be part of the update request to ensure optimistic locking
      *
      * @generated from field: google.protobuf.Timestamp updated_at = 3;
      */
     updatedAt?: Timestamp;
     /**
-     * Description of the switch.
+     * Description of the switch
      *
      * @generated from field: optional string description = 4;
      */
     description?: string;
     /**
-     * Replace mode is used to mark a switch ready for replacement.
+     * ReplaceMode is used to mark a switch ready for replacement
      *
      * @generated from field: optional metalstack.api.v2.SwitchReplaceMode replace_mode = 5;
      */
     replaceMode?: SwitchReplaceMode;
     /**
-     * Management IP is the switch's IP for management access.
+     * ManagementIp is the switch's IP for management access
      *
      * @generated from field: optional string management_ip = 6;
      */
     managementIp?: string;
     /**
-     * Management user is the user name to use for management access.
+     * ManagementUser is the user name to use for management access
      *
      * @generated from field: optional string management_user = 7;
      */
     managementUser?: string;
     /**
-     * Console command is the command for accessing the switch's console.
+     * ConsoleCommand is the command for accessing the switch's console
      *
      * @generated from field: optional string console_command = 8;
      */
     consoleCommand?: string;
     /**
-     * Nics are the front panel ports of the switch.
+     * Nics are the front panel ports of the switch
      *
      * @generated from field: repeated metalstack.api.v2.SwitchNic nics = 9;
      */
     nics: SwitchNic[];
     /**
-     * SwitchOs is the OS running on the switch.
+     * SwitchOs is the OS running on the switch
      *
      * @generated from field: optional metalstack.api.v2.SwitchOS os = 10;
      */
@@ -154,13 +154,13 @@ export type SwitchServiceUpdateRequest = Message<"metalstack.admin.v2.SwitchServ
  */
 export declare const SwitchServiceUpdateRequestSchema: GenMessage<SwitchServiceUpdateRequest>;
 /**
- * SwitchServiceUpdateResponse.
+ * SwitchServiceUpdateResponse is the response payload for updating a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceUpdateResponse
  */
 export type SwitchServiceUpdateResponse = Message<"metalstack.admin.v2.SwitchServiceUpdateResponse"> & {
     /**
-     * Switch that was updated.
+     * Switch contains the updated switch
      *
      * @generated from field: metalstack.api.v2.Switch switch = 1;
      */
@@ -172,19 +172,19 @@ export type SwitchServiceUpdateResponse = Message<"metalstack.admin.v2.SwitchSer
  */
 export declare const SwitchServiceUpdateResponseSchema: GenMessage<SwitchServiceUpdateResponse>;
 /**
- * SwitchServiceDeleteRequest.
+ * SwitchServiceDeleteRequest is the request payload for deleting a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceDeleteRequest
  */
 export type SwitchServiceDeleteRequest = Message<"metalstack.admin.v2.SwitchServiceDeleteRequest"> & {
     /**
-     * Id of the switch.
+     * Id of the switch
      *
      * @generated from field: string id = 1;
      */
     id: string;
     /**
-     * Force will allow switch deletion despite existing machine connections.
+     * Force will allow switch deletion despite existing machine connections
      *
      * @generated from field: bool force = 2;
      */
@@ -196,13 +196,13 @@ export type SwitchServiceDeleteRequest = Message<"metalstack.admin.v2.SwitchServ
  */
 export declare const SwitchServiceDeleteRequestSchema: GenMessage<SwitchServiceDeleteRequest>;
 /**
- * SwitchServiceDeleteResponse.
+ * SwitchServiceDeleteResponse is the response payload for deleting a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceDeleteResponse
  */
 export type SwitchServiceDeleteResponse = Message<"metalstack.admin.v2.SwitchServiceDeleteResponse"> & {
     /**
-     * Switch that has been deleted.
+     * Switch contains the deleted switch
      *
      * @generated from field: metalstack.api.v2.Switch switch = 1;
      */
@@ -214,19 +214,19 @@ export type SwitchServiceDeleteResponse = Message<"metalstack.admin.v2.SwitchSer
  */
 export declare const SwitchServiceDeleteResponseSchema: GenMessage<SwitchServiceDeleteResponse>;
 /**
- * SwitchServiceMigrateRequest.
+ * SwitchServiceMigrateRequest is the request payload for migrating a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceMigrateRequest
  */
 export type SwitchServiceMigrateRequest = Message<"metalstack.admin.v2.SwitchServiceMigrateRequest"> & {
     /**
-     * OldSwitch which to migrate away from.
+     * OldSwitch is the switch to migrate away from
      *
      * @generated from field: string old_switch = 1;
      */
     oldSwitch: string;
     /**
-     * NewSwitch which to migrate to.
+     * NewSwitch is the switch to migrate to
      *
      * @generated from field: string new_switch = 2;
      */
@@ -238,13 +238,13 @@ export type SwitchServiceMigrateRequest = Message<"metalstack.admin.v2.SwitchSer
  */
 export declare const SwitchServiceMigrateRequestSchema: GenMessage<SwitchServiceMigrateRequest>;
 /**
- * SwitchServiceMigrateResponse.
+ * SwitchServiceMigrateResponse is the response payload for migrating a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceMigrateResponse
  */
 export type SwitchServiceMigrateResponse = Message<"metalstack.admin.v2.SwitchServiceMigrateResponse"> & {
     /**
-     * Switch that was migrated to.
+     * Switch contains the switch was migrated to
      *
      * @generated from field: metalstack.api.v2.Switch switch = 1;
      */
@@ -256,25 +256,25 @@ export type SwitchServiceMigrateResponse = Message<"metalstack.admin.v2.SwitchSe
  */
 export declare const SwitchServiceMigrateResponseSchema: GenMessage<SwitchServiceMigrateResponse>;
 /**
- * SwitchServicePortRequest.
+ * SwitchServicePortRequest is the request payload for setting the port status of a switch port.
  *
  * @generated from message metalstack.admin.v2.SwitchServicePortRequest
  */
 export type SwitchServicePortRequest = Message<"metalstack.admin.v2.SwitchServicePortRequest"> & {
     /**
-     * Id of the switch.
+     * Id of the switch
      *
      * @generated from field: string id = 1;
      */
     id: string;
     /**
-     * NicName of the port whose status should be changed.
+     * NicName of the port whose status should be changed
      *
      * @generated from field: string nic_name = 2;
      */
     nicName: string;
     /**
-     * Status that the port should have.
+     * Status that the port should have
      *
      * @generated from field: metalstack.api.v2.SwitchPortStatus status = 3;
      */
@@ -286,13 +286,13 @@ export type SwitchServicePortRequest = Message<"metalstack.admin.v2.SwitchServic
  */
 export declare const SwitchServicePortRequestSchema: GenMessage<SwitchServicePortRequest>;
 /**
- * SwitchServicePortResponse.
+ * SwitchServicePortResponse is the response payload for setting the port status of a switch port.
  *
  * @generated from message metalstack.admin.v2.SwitchServicePortResponse
  */
 export type SwitchServicePortResponse = Message<"metalstack.admin.v2.SwitchServicePortResponse"> & {
     /**
-     * Switch after the port status toggle..
+     * Switch after the port status toggle
      *
      * @generated from field: metalstack.api.v2.Switch switch = 1;
      */
@@ -304,19 +304,19 @@ export type SwitchServicePortResponse = Message<"metalstack.admin.v2.SwitchServi
  */
 export declare const SwitchServicePortResponseSchema: GenMessage<SwitchServicePortResponse>;
 /**
- * SwitchServiceConnectedMachinesRequest.
+ * SwitchServiceConnectedMachinesRequest is the request payload for listing switches with machine connections.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceConnectedMachinesRequest
  */
 export type SwitchServiceConnectedMachinesRequest = Message<"metalstack.admin.v2.SwitchServiceConnectedMachinesRequest"> & {
     /**
-     * Query to filter the switch results.
+     * Query to filter the switch results
      *
      * @generated from field: metalstack.api.v2.SwitchQuery query = 1;
      */
     query?: SwitchQuery;
     /**
-     * MachineQuery to filter the machine results.
+     * MachineQuery to filter the machine results
      *
      * @generated from field: metalstack.api.v2.MachineQuery machine_query = 2;
      */
@@ -328,13 +328,13 @@ export type SwitchServiceConnectedMachinesRequest = Message<"metalstack.admin.v2
  */
 export declare const SwitchServiceConnectedMachinesRequestSchema: GenMessage<SwitchServiceConnectedMachinesRequest>;
 /**
- * SwitchServiceConnectedMachinesResponse.
+ * SwitchServiceConnectedMachinesResponse is the response payload for listing switches with machine connections.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceConnectedMachinesResponse
  */
 export type SwitchServiceConnectedMachinesResponse = Message<"metalstack.admin.v2.SwitchServiceConnectedMachinesResponse"> & {
     /**
-     * SwitchesWithMachines contains all switches with their machine connections.
+     * SwitchesWithMachines contains all switches with their machine connections
      *
      * @generated from field: repeated metalstack.api.v2.SwitchWithMachines switches_with_machines = 1;
      */
@@ -346,13 +346,13 @@ export type SwitchServiceConnectedMachinesResponse = Message<"metalstack.admin.v
  */
 export declare const SwitchServiceConnectedMachinesResponseSchema: GenMessage<SwitchServiceConnectedMachinesResponse>;
 /**
- * SwitchService serves switch related functions.
+ * SwitchService provides switch management operations.
  *
  * @generated from service metalstack.admin.v2.SwitchService
  */
 export declare const SwitchService: GenService<{
     /**
-     * Get a switch by ID.
+     * Returns the switch with the specified ID.
      *
      * @generated from rpc metalstack.admin.v2.SwitchService.Get
      */
@@ -362,7 +362,7 @@ export declare const SwitchService: GenService<{
         output: typeof SwitchServiceGetResponseSchema;
     };
     /**
-     * List switches.
+     * Returns the list of switches.
      *
      * @generated from rpc metalstack.admin.v2.SwitchService.List
      */
@@ -372,7 +372,7 @@ export declare const SwitchService: GenService<{
         output: typeof SwitchServiceListResponseSchema;
     };
     /**
-     * Update a switch.
+     * Updates a switch.
      *
      * @generated from rpc metalstack.admin.v2.SwitchService.Update
      */
@@ -382,7 +382,7 @@ export declare const SwitchService: GenService<{
         output: typeof SwitchServiceUpdateResponseSchema;
     };
     /**
-     * Delete a switch.
+     * Deletes a switch.
      *
      * @generated from rpc metalstack.admin.v2.SwitchService.Delete
      */
@@ -392,7 +392,7 @@ export declare const SwitchService: GenService<{
         output: typeof SwitchServiceDeleteResponseSchema;
     };
     /**
-     * Migrate a switch.
+     * Migrates a switch.
      *
      * @generated from rpc metalstack.admin.v2.SwitchService.Migrate
      */
@@ -402,7 +402,7 @@ export declare const SwitchService: GenService<{
         output: typeof SwitchServiceMigrateResponseSchema;
     };
     /**
-     * Port set the port status of a switch port.
+     * Sets the port status of a switch port.
      *
      * @generated from rpc metalstack.admin.v2.SwitchService.Port
      */
@@ -412,7 +412,7 @@ export declare const SwitchService: GenService<{
         output: typeof SwitchServicePortResponseSchema;
     };
     /**
-     * ConnectedMachines lists all switches with their machine connections.
+     * Returns all switches with their machine connections.
      *
      * @generated from rpc metalstack.admin.v2.SwitchService.ConnectedMachines
      */
diff --git a/js/metalstack/admin/v2/switch_pb.js b/js/metalstack/admin/v2/switch_pb.js
index 0aa42390..e56f156b 100644
--- a/js/metalstack/admin/v2/switch_pb.js
+++ b/js/metalstack/admin/v2/switch_pb.js
@@ -83,7 +83,7 @@ export const SwitchServiceConnectedMachinesRequestSchema = /*@__PURE__*/ message
  */
 export const SwitchServiceConnectedMachinesResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_switch, 13);
 /**
- * SwitchService serves switch related functions.
+ * SwitchService provides switch management operations.
  *
  * @generated from service metalstack.admin.v2.SwitchService
  */
diff --git a/js/metalstack/admin/v2/switch_pb.ts b/js/metalstack/admin/v2/switch_pb.ts
index d85be681..9294636e 100644
--- a/js/metalstack/admin/v2/switch_pb.ts
+++ b/js/metalstack/admin/v2/switch_pb.ts
@@ -23,13 +23,13 @@ export const file_metalstack_admin_v2_switch: GenFile = /*@__PURE__*/
   fileDesc("CiBtZXRhbHN0YWNrL2FkbWluL3YyL3N3aXRjaC5wcm90bxITbWV0YWxzdGFjay5hZG1pbi52MiI0ChdTd2l0Y2hTZXJ2aWNlR2V0UmVxdWVzdBIZCgJpZBgBIAEoCUINukgKcgjAs66xAgFoASJFChhTd2l0Y2hTZXJ2aWNlR2V0UmVzcG9uc2USKQoGc3dpdGNoGAEgASgLMhkubWV0YWxzdGFjay5hcGkudjIuU3dpdGNoIkkKGFN3aXRjaFNlcnZpY2VMaXN0UmVxdWVzdBItCgVxdWVyeRgBIAEoCzIeLm1ldGFsc3RhY2suYXBpLnYyLlN3aXRjaFF1ZXJ5IkgKGVN3aXRjaFNlcnZpY2VMaXN0UmVzcG9uc2USKwoIc3dpdGNoZXMYASADKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5Td2l0Y2gizAQKGlN3aXRjaFNlcnZpY2VVcGRhdGVSZXF1ZXN0EhkKAmlkGAEgASgJQg26SApyCMCzrrECAWgBEjoKC3VwZGF0ZV9tZXRhGAIgASgLMh0ubWV0YWxzdGFjay5hcGkudjIuVXBkYXRlTWV0YUIGukgDyAEBEi4KCnVwZGF0ZWRfYXQYAyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEiUKC2Rlc2NyaXB0aW9uGAQgASgJQgu6SAhyBsizrrECAUgAiAEBEkkKDHJlcGxhY2VfbW9kZRgFIAEoDjIkLm1ldGFsc3RhY2suYXBpLnYyLlN3aXRjaFJlcGxhY2VNb2RlQgi6SAWCAQIQAUgBiAEBEiMKDW1hbmFnZW1lbnRfaXAYBiABKAlCB7pIBHICcAFIAogBARIpCg9tYW5hZ2VtZW50X3VzZXIYByABKAlCC7pICHIGwLOusQIBSAOIAQESKQoPY29uc29sZV9jb21tYW5kGAggASgJQgu6SAhyBsizrrECAUgEiAEBEioKBG5pY3MYCSADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5Td2l0Y2hOaWMSLAoCb3MYCiABKAsyGy5tZXRhbHN0YWNrLmFwaS52Mi5Td2l0Y2hPU0gFiAEBQg4KDF9kZXNjcmlwdGlvbkIPCg1fcmVwbGFjZV9tb2RlQhAKDl9tYW5hZ2VtZW50X2lwQhIKEF9tYW5hZ2VtZW50X3VzZXJCEgoQX2NvbnNvbGVfY29tbWFuZEIFCgNfb3MiSAobU3dpdGNoU2VydmljZVVwZGF0ZVJlc3BvbnNlEikKBnN3aXRjaBgBIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLlN3aXRjaCJGChpTd2l0Y2hTZXJ2aWNlRGVsZXRlUmVxdWVzdBIZCgJpZBgBIAEoCUINukgKcgjAs66xAgFoARINCgVmb3JjZRgCIAEoCCJIChtTd2l0Y2hTZXJ2aWNlRGVsZXRlUmVzcG9uc2USKQoGc3dpdGNoGAEgASgLMhkubWV0YWxzdGFjay5hcGkudjIuU3dpdGNoImMKG1N3aXRjaFNlcnZpY2VNaWdyYXRlUmVxdWVzdBIhCgpvbGRfc3dpdGNoGAEgASgJQg26SApyCMCzrrECAWgBEiEKCm5ld19zd2l0Y2gYAiABKAlCDbpICnIIwLOusQIBaAEiSQocU3dpdGNoU2VydmljZU1pZ3JhdGVSZXNwb25zZRIpCgZzd2l0Y2gYASABKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5Td2l0Y2gikwEKGFN3aXRjaFNlcnZpY2VQb3J0UmVxdWVzdBIZCgJpZBgBIAEoCUINukgKcgjAs66xAgFoARIdCghuaWNfbmFtZRgCIAEoCUILukgIcgbAs66xAgESPQoGc3RhdHVzGAMgASgOMiMubWV0YWxzdGFjay5hcGkudjIuU3dpdGNoUG9ydFN0YXR1c0IIukgFggECEAEiRgoZU3dpdGNoU2VydmljZVBvcnRSZXNwb25zZRIpCgZzd2l0Y2gYASABKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5Td2l0Y2gijgEKJVN3aXRjaFNlcnZpY2VDb25uZWN0ZWRNYWNoaW5lc1JlcXVlc3QSLQoFcXVlcnkYASABKAsyHi5tZXRhbHN0YWNrLmFwaS52Mi5Td2l0Y2hRdWVyeRI2Cg1tYWNoaW5lX3F1ZXJ5GAIgASgLMh8ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVF1ZXJ5Im8KJlN3aXRjaFNlcnZpY2VDb25uZWN0ZWRNYWNoaW5lc1Jlc3BvbnNlEkUKFnN3aXRjaGVzX3dpdGhfbWFjaGluZXMYASADKAsyJS5tZXRhbHN0YWNrLmFwaS52Mi5Td2l0Y2hXaXRoTWFjaGluZXMy2gYKDVN3aXRjaFNlcnZpY2USbgoDR2V0EiwubWV0YWxzdGFjay5hZG1pbi52Mi5Td2l0Y2hTZXJ2aWNlR2V0UmVxdWVzdBotLm1ldGFsc3RhY2suYWRtaW4udjIuU3dpdGNoU2VydmljZUdldFJlc3BvbnNlIgrS8xgCAQLg8xgCEnEKBExpc3QSLS5tZXRhbHN0YWNrLmFkbWluLnYyLlN3aXRjaFNlcnZpY2VMaXN0UmVxdWVzdBouLm1ldGFsc3RhY2suYWRtaW4udjIuU3dpdGNoU2VydmljZUxpc3RSZXNwb25zZSIK0vMYAgEC4PMYAhJyCgZVcGRhdGUSLy5tZXRhbHN0YWNrLmFkbWluLnYyLlN3aXRjaFNlcnZpY2VVcGRhdGVSZXF1ZXN0GjAubWV0YWxzdGFjay5hZG1pbi52Mi5Td2l0Y2hTZXJ2aWNlVXBkYXRlUmVzcG9uc2UiBdLzGAEBEnIKBkRlbGV0ZRIvLm1ldGFsc3RhY2suYWRtaW4udjIuU3dpdGNoU2VydmljZURlbGV0ZVJlcXVlc3QaMC5tZXRhbHN0YWNrLmFkbWluLnYyLlN3aXRjaFNlcnZpY2VEZWxldGVSZXNwb25zZSIF0vMYAQESdQoHTWlncmF0ZRIwLm1ldGFsc3RhY2suYWRtaW4udjIuU3dpdGNoU2VydmljZU1pZ3JhdGVSZXF1ZXN0GjEubWV0YWxzdGFjay5hZG1pbi52Mi5Td2l0Y2hTZXJ2aWNlTWlncmF0ZVJlc3BvbnNlIgXS8xgBARJsCgRQb3J0Ei0ubWV0YWxzdGFjay5hZG1pbi52Mi5Td2l0Y2hTZXJ2aWNlUG9ydFJlcXVlc3QaLi5tZXRhbHN0YWNrLmFkbWluLnYyLlN3aXRjaFNlcnZpY2VQb3J0UmVzcG9uc2UiBdLzGAEBEpgBChFDb25uZWN0ZWRNYWNoaW5lcxI6Lm1ldGFsc3RhY2suYWRtaW4udjIuU3dpdGNoU2VydmljZUNvbm5lY3RlZE1hY2hpbmVzUmVxdWVzdBo7Lm1ldGFsc3RhY2suYWRtaW4udjIuU3dpdGNoU2VydmljZUNvbm5lY3RlZE1hY2hpbmVzUmVzcG9uc2UiCtLzGAIBAuDzGAJCzwEKF2NvbS5tZXRhbHN0YWNrLmFkbWluLnYyQgtTd2l0Y2hQcm90b1ABWjlnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FkbWluL3YyO2FkbWludjKiAgNNQViqAhNNZXRhbHN0YWNrLkFkbWluLlYyygITTWV0YWxzdGFja1xBZG1pblxWMuICH01ldGFsc3RhY2tcQWRtaW5cVjJcR1BCTWV0YWRhdGHqAhVNZXRhbHN0YWNrOjpBZG1pbjo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_google_protobuf_timestamp, file_metalstack_api_v2_common, file_metalstack_api_v2_machine, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_switch]);
 
 /**
- * SwitchServiceGetRequest.
+ * SwitchServiceGetRequest is the request payload for getting a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceGetRequest
  */
 export type SwitchServiceGetRequest = Message<"metalstack.admin.v2.SwitchServiceGetRequest"> & {
   /**
-   * Id of the switch to get.
+   * Id of the switch to get
    *
    * @generated from field: string id = 1;
    */
@@ -44,13 +44,13 @@ export const SwitchServiceGetRequestSchema: GenMessage<SwitchServiceGetRequest>
   messageDesc(file_metalstack_admin_v2_switch, 0);
 
 /**
- * SwitchServiceGetResponse.
+ * SwitchServiceGetResponse is the response payload for getting a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceGetResponse
  */
 export type SwitchServiceGetResponse = Message<"metalstack.admin.v2.SwitchServiceGetResponse"> & {
   /**
-   * Switch that was requested.
+   * Switch contains the requested switch
    *
    * @generated from field: metalstack.api.v2.Switch switch = 1;
    */
@@ -65,13 +65,13 @@ export const SwitchServiceGetResponseSchema: GenMessage<SwitchServiceGetResponse
   messageDesc(file_metalstack_admin_v2_switch, 1);
 
 /**
- * SwitchServiceListRequest.
+ * SwitchServiceListRequest is the request payload for listing switches.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceListRequest
  */
 export type SwitchServiceListRequest = Message<"metalstack.admin.v2.SwitchServiceListRequest"> & {
   /**
-   * Query to filter the results.
+   * Query to filter the results
    *
    * @generated from field: metalstack.api.v2.SwitchQuery query = 1;
    */
@@ -86,13 +86,13 @@ export const SwitchServiceListRequestSchema: GenMessage<SwitchServiceListRequest
   messageDesc(file_metalstack_admin_v2_switch, 2);
 
 /**
- * SwitchServiceListResponse.
+ * SwitchServiceListResponse is the response payload for listing switches.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceListResponse
  */
 export type SwitchServiceListResponse = Message<"metalstack.admin.v2.SwitchServiceListResponse"> & {
   /**
-   * Switches that match the request query.
+   * Switches that match the request query
    *
    * @generated from field: repeated metalstack.api.v2.Switch switches = 1;
    */
@@ -107,77 +107,77 @@ export const SwitchServiceListResponseSchema: GenMessage<SwitchServiceListRespon
   messageDesc(file_metalstack_admin_v2_switch, 3);
 
 /**
- * SwitchServiceUpdateRequest.
+ * SwitchServiceUpdateRequest is the request payload for updating a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceUpdateRequest
  */
 export type SwitchServiceUpdateRequest = Message<"metalstack.admin.v2.SwitchServiceUpdateRequest"> & {
   /**
-   * ID of the switch.
+   * ID of the switch
    *
    * @generated from field: string id = 1;
    */
   id: string;
 
   /**
-   * UpdateMeta contains the timestamp and strategy to be used in this update request.
+   * UpdateMeta contains the timestamp and strategy to be used in this update request
    *
    * @generated from field: metalstack.api.v2.UpdateMeta update_meta = 2;
    */
   updateMeta?: UpdateMeta;
 
   /**
-   * UpdatedAt is the date when this entity was updated.
-   * must be part of the update request to ensure optimistic locking.
+   * UpdatedAt is the date when this entity was updated
+   * Must be part of the update request to ensure optimistic locking
    *
    * @generated from field: google.protobuf.Timestamp updated_at = 3;
    */
   updatedAt?: Timestamp;
 
   /**
-   * Description of the switch.
+   * Description of the switch
    *
    * @generated from field: optional string description = 4;
    */
   description?: string;
 
   /**
-   * Replace mode is used to mark a switch ready for replacement.
+   * ReplaceMode is used to mark a switch ready for replacement
    *
    * @generated from field: optional metalstack.api.v2.SwitchReplaceMode replace_mode = 5;
    */
   replaceMode?: SwitchReplaceMode;
 
   /**
-   * Management IP is the switch's IP for management access.
+   * ManagementIp is the switch's IP for management access
    *
    * @generated from field: optional string management_ip = 6;
    */
   managementIp?: string;
 
   /**
-   * Management user is the user name to use for management access.
+   * ManagementUser is the user name to use for management access
    *
    * @generated from field: optional string management_user = 7;
    */
   managementUser?: string;
 
   /**
-   * Console command is the command for accessing the switch's console.
+   * ConsoleCommand is the command for accessing the switch's console
    *
    * @generated from field: optional string console_command = 8;
    */
   consoleCommand?: string;
 
   /**
-   * Nics are the front panel ports of the switch.
+   * Nics are the front panel ports of the switch
    *
    * @generated from field: repeated metalstack.api.v2.SwitchNic nics = 9;
    */
   nics: SwitchNic[];
 
   /**
-   * SwitchOs is the OS running on the switch.
+   * SwitchOs is the OS running on the switch
    *
    * @generated from field: optional metalstack.api.v2.SwitchOS os = 10;
    */
@@ -192,13 +192,13 @@ export const SwitchServiceUpdateRequestSchema: GenMessage<SwitchServiceUpdateReq
   messageDesc(file_metalstack_admin_v2_switch, 4);
 
 /**
- * SwitchServiceUpdateResponse.
+ * SwitchServiceUpdateResponse is the response payload for updating a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceUpdateResponse
  */
 export type SwitchServiceUpdateResponse = Message<"metalstack.admin.v2.SwitchServiceUpdateResponse"> & {
   /**
-   * Switch that was updated.
+   * Switch contains the updated switch
    *
    * @generated from field: metalstack.api.v2.Switch switch = 1;
    */
@@ -213,20 +213,20 @@ export const SwitchServiceUpdateResponseSchema: GenMessage<SwitchServiceUpdateRe
   messageDesc(file_metalstack_admin_v2_switch, 5);
 
 /**
- * SwitchServiceDeleteRequest.
+ * SwitchServiceDeleteRequest is the request payload for deleting a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceDeleteRequest
  */
 export type SwitchServiceDeleteRequest = Message<"metalstack.admin.v2.SwitchServiceDeleteRequest"> & {
   /**
-   * Id of the switch.
+   * Id of the switch
    *
    * @generated from field: string id = 1;
    */
   id: string;
 
   /**
-   * Force will allow switch deletion despite existing machine connections.
+   * Force will allow switch deletion despite existing machine connections
    *
    * @generated from field: bool force = 2;
    */
@@ -241,13 +241,13 @@ export const SwitchServiceDeleteRequestSchema: GenMessage<SwitchServiceDeleteReq
   messageDesc(file_metalstack_admin_v2_switch, 6);
 
 /**
- * SwitchServiceDeleteResponse.
+ * SwitchServiceDeleteResponse is the response payload for deleting a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceDeleteResponse
  */
 export type SwitchServiceDeleteResponse = Message<"metalstack.admin.v2.SwitchServiceDeleteResponse"> & {
   /**
-   * Switch that has been deleted.
+   * Switch contains the deleted switch
    *
    * @generated from field: metalstack.api.v2.Switch switch = 1;
    */
@@ -262,20 +262,20 @@ export const SwitchServiceDeleteResponseSchema: GenMessage<SwitchServiceDeleteRe
   messageDesc(file_metalstack_admin_v2_switch, 7);
 
 /**
- * SwitchServiceMigrateRequest.
+ * SwitchServiceMigrateRequest is the request payload for migrating a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceMigrateRequest
  */
 export type SwitchServiceMigrateRequest = Message<"metalstack.admin.v2.SwitchServiceMigrateRequest"> & {
   /**
-   * OldSwitch which to migrate away from.
+   * OldSwitch is the switch to migrate away from
    *
    * @generated from field: string old_switch = 1;
    */
   oldSwitch: string;
 
   /**
-   * NewSwitch which to migrate to.
+   * NewSwitch is the switch to migrate to
    *
    * @generated from field: string new_switch = 2;
    */
@@ -290,13 +290,13 @@ export const SwitchServiceMigrateRequestSchema: GenMessage<SwitchServiceMigrateR
   messageDesc(file_metalstack_admin_v2_switch, 8);
 
 /**
- * SwitchServiceMigrateResponse.
+ * SwitchServiceMigrateResponse is the response payload for migrating a switch.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceMigrateResponse
  */
 export type SwitchServiceMigrateResponse = Message<"metalstack.admin.v2.SwitchServiceMigrateResponse"> & {
   /**
-   * Switch that was migrated to.
+   * Switch contains the switch was migrated to
    *
    * @generated from field: metalstack.api.v2.Switch switch = 1;
    */
@@ -311,27 +311,27 @@ export const SwitchServiceMigrateResponseSchema: GenMessage<SwitchServiceMigrate
   messageDesc(file_metalstack_admin_v2_switch, 9);
 
 /**
- * SwitchServicePortRequest.
+ * SwitchServicePortRequest is the request payload for setting the port status of a switch port.
  *
  * @generated from message metalstack.admin.v2.SwitchServicePortRequest
  */
 export type SwitchServicePortRequest = Message<"metalstack.admin.v2.SwitchServicePortRequest"> & {
   /**
-   * Id of the switch.
+   * Id of the switch
    *
    * @generated from field: string id = 1;
    */
   id: string;
 
   /**
-   * NicName of the port whose status should be changed.
+   * NicName of the port whose status should be changed
    *
    * @generated from field: string nic_name = 2;
    */
   nicName: string;
 
   /**
-   * Status that the port should have.
+   * Status that the port should have
    *
    * @generated from field: metalstack.api.v2.SwitchPortStatus status = 3;
    */
@@ -346,13 +346,13 @@ export const SwitchServicePortRequestSchema: GenMessage<SwitchServicePortRequest
   messageDesc(file_metalstack_admin_v2_switch, 10);
 
 /**
- * SwitchServicePortResponse.
+ * SwitchServicePortResponse is the response payload for setting the port status of a switch port.
  *
  * @generated from message metalstack.admin.v2.SwitchServicePortResponse
  */
 export type SwitchServicePortResponse = Message<"metalstack.admin.v2.SwitchServicePortResponse"> & {
   /**
-   * Switch after the port status toggle..
+   * Switch after the port status toggle
    *
    * @generated from field: metalstack.api.v2.Switch switch = 1;
    */
@@ -367,20 +367,20 @@ export const SwitchServicePortResponseSchema: GenMessage<SwitchServicePortRespon
   messageDesc(file_metalstack_admin_v2_switch, 11);
 
 /**
- * SwitchServiceConnectedMachinesRequest.
+ * SwitchServiceConnectedMachinesRequest is the request payload for listing switches with machine connections.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceConnectedMachinesRequest
  */
 export type SwitchServiceConnectedMachinesRequest = Message<"metalstack.admin.v2.SwitchServiceConnectedMachinesRequest"> & {
   /**
-   * Query to filter the switch results.
+   * Query to filter the switch results
    *
    * @generated from field: metalstack.api.v2.SwitchQuery query = 1;
    */
   query?: SwitchQuery;
 
   /**
-   * MachineQuery to filter the machine results.
+   * MachineQuery to filter the machine results
    *
    * @generated from field: metalstack.api.v2.MachineQuery machine_query = 2;
    */
@@ -395,13 +395,13 @@ export const SwitchServiceConnectedMachinesRequestSchema: GenMessage<SwitchServi
   messageDesc(file_metalstack_admin_v2_switch, 12);
 
 /**
- * SwitchServiceConnectedMachinesResponse.
+ * SwitchServiceConnectedMachinesResponse is the response payload for listing switches with machine connections.
  *
  * @generated from message metalstack.admin.v2.SwitchServiceConnectedMachinesResponse
  */
 export type SwitchServiceConnectedMachinesResponse = Message<"metalstack.admin.v2.SwitchServiceConnectedMachinesResponse"> & {
   /**
-   * SwitchesWithMachines contains all switches with their machine connections.
+   * SwitchesWithMachines contains all switches with their machine connections
    *
    * @generated from field: repeated metalstack.api.v2.SwitchWithMachines switches_with_machines = 1;
    */
@@ -416,13 +416,13 @@ export const SwitchServiceConnectedMachinesResponseSchema: GenMessage<SwitchServ
   messageDesc(file_metalstack_admin_v2_switch, 13);
 
 /**
- * SwitchService serves switch related functions.
+ * SwitchService provides switch management operations.
  *
  * @generated from service metalstack.admin.v2.SwitchService
  */
 export const SwitchService: GenService<{
   /**
-   * Get a switch by ID.
+   * Returns the switch with the specified ID.
    *
    * @generated from rpc metalstack.admin.v2.SwitchService.Get
    */
@@ -432,7 +432,7 @@ export const SwitchService: GenService<{
     output: typeof SwitchServiceGetResponseSchema;
   },
   /**
-   * List switches.
+   * Returns the list of switches.
    *
    * @generated from rpc metalstack.admin.v2.SwitchService.List
    */
@@ -442,7 +442,7 @@ export const SwitchService: GenService<{
     output: typeof SwitchServiceListResponseSchema;
   },
   /**
-   * Update a switch.
+   * Updates a switch.
    *
    * @generated from rpc metalstack.admin.v2.SwitchService.Update
    */
@@ -452,7 +452,7 @@ export const SwitchService: GenService<{
     output: typeof SwitchServiceUpdateResponseSchema;
   },
   /**
-   * Delete a switch.
+   * Deletes a switch.
    *
    * @generated from rpc metalstack.admin.v2.SwitchService.Delete
    */
@@ -462,7 +462,7 @@ export const SwitchService: GenService<{
     output: typeof SwitchServiceDeleteResponseSchema;
   },
   /**
-   * Migrate a switch.
+   * Migrates a switch.
    *
    * @generated from rpc metalstack.admin.v2.SwitchService.Migrate
    */
@@ -472,7 +472,7 @@ export const SwitchService: GenService<{
     output: typeof SwitchServiceMigrateResponseSchema;
   },
   /**
-   * Port set the port status of a switch port.
+   * Sets the port status of a switch port.
    *
    * @generated from rpc metalstack.admin.v2.SwitchService.Port
    */
@@ -482,7 +482,7 @@ export const SwitchService: GenService<{
     output: typeof SwitchServicePortResponseSchema;
   },
   /**
-   * ConnectedMachines lists all switches with their machine connections.
+   * Returns all switches with their machine connections.
    *
    * @generated from rpc metalstack.admin.v2.SwitchService.ConnectedMachines
    */
diff --git a/js/metalstack/admin/v2/task_pb.d.ts b/js/metalstack/admin/v2/task_pb.d.ts
index 58ecbcdb..814207f6 100644
--- a/js/metalstack/admin/v2/task_pb.d.ts
+++ b/js/metalstack/admin/v2/task_pb.d.ts
@@ -6,19 +6,19 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_task: GenFile;
 /**
- * TaskServiceGetRequest is the message to a get task request
+ * TaskServiceGetRequest is the request payload for getting a task.
  *
  * @generated from message metalstack.admin.v2.TaskServiceGetRequest
  */
 export type TaskServiceGetRequest = Message<"metalstack.admin.v2.TaskServiceGetRequest"> & {
     /**
-     * TaskId to get
+     * TaskId is the identifier of the task to get
      *
      * @generated from field: string task_id = 1;
      */
     taskId: string;
     /**
-     * Queue where this task was scheduled to
+     * Queue is the queue where this task was scheduled to
      *
      * @generated from field: string queue = 2;
      */
@@ -30,7 +30,7 @@ export type TaskServiceGetRequest = Message<"metalstack.admin.v2.TaskServiceGetR
  */
 export declare const TaskServiceGetRequestSchema: GenMessage<TaskServiceGetRequest>;
 /**
- * TaskServiceGetResponse is the response to a task get request
+ * TaskServiceGetResponse is the response payload for getting a task.
  *
  * @generated from message metalstack.admin.v2.TaskServiceGetResponse
  */
@@ -48,19 +48,19 @@ export type TaskServiceGetResponse = Message<"metalstack.admin.v2.TaskServiceGet
  */
 export declare const TaskServiceGetResponseSchema: GenMessage<TaskServiceGetResponse>;
 /**
- * TaskServiceDeleteRequest is the message to a delete task request
+ * TaskServiceDeleteRequest is the request payload for deleting a task.
  *
  * @generated from message metalstack.admin.v2.TaskServiceDeleteRequest
  */
 export type TaskServiceDeleteRequest = Message<"metalstack.admin.v2.TaskServiceDeleteRequest"> & {
     /**
-     * TaskId to cancel
+     * TaskId is the identifier of the task to cancel
      *
      * @generated from field: string task_id = 1;
      */
     taskId: string;
     /**
-     * Queue where this task was scheduled to
+     * Queue is the queue where this task was scheduled to
      *
      * @generated from field: string queue = 2;
      */
@@ -72,7 +72,7 @@ export type TaskServiceDeleteRequest = Message<"metalstack.admin.v2.TaskServiceD
  */
 export declare const TaskServiceDeleteRequestSchema: GenMessage<TaskServiceDeleteRequest>;
 /**
- * TaskServiceDeleteResponse is the response to a task delete request
+ * TaskServiceDeleteResponse is the response payload for deleting a task.
  *
  * @generated from message metalstack.admin.v2.TaskServiceDeleteResponse
  */
@@ -83,7 +83,7 @@ export type TaskServiceDeleteResponse = Message<"metalstack.admin.v2.TaskService
  */
 export declare const TaskServiceDeleteResponseSchema: GenMessage<TaskServiceDeleteResponse>;
 /**
- * TaskServiceQueuesRequest is the message to get all queues
+ * TaskServiceQueuesRequest is the request payload for getting all queues.
  *
  * @generated from message metalstack.admin.v2.TaskServiceQueuesRequest
  */
@@ -94,7 +94,7 @@ export type TaskServiceQueuesRequest = Message<"metalstack.admin.v2.TaskServiceQ
  */
 export declare const TaskServiceQueuesRequestSchema: GenMessage<TaskServiceQueuesRequest>;
 /**
- * TaskServiceQueuesResponse is the response to a queues request
+ * TaskServiceQueuesResponse is the response payload for getting all queues.
  *
  * @generated from message metalstack.admin.v2.TaskServiceQueuesResponse
  */
@@ -112,26 +112,26 @@ export type TaskServiceQueuesResponse = Message<"metalstack.admin.v2.TaskService
  */
 export declare const TaskServiceQueuesResponseSchema: GenMessage<TaskServiceQueuesResponse>;
 /**
- * TaskServiceListRequest is the message to a task list request
+ * TaskServiceListRequest is the request payload for listing tasks.
  *
  * @generated from message metalstack.admin.v2.TaskServiceListRequest
  */
 export type TaskServiceListRequest = Message<"metalstack.admin.v2.TaskServiceListRequest"> & {
     /**
-     * Queue where this tasks should be listed
-     * will return tasks from all queues if not specified
+     * Queue filters tasks by this queue
+     * Will return tasks from all queues if not specified
      *
      * @generated from field: optional string queue = 1;
      */
     queue?: string;
     /**
-     * Count of tasks to return
+     * Count is the number of tasks to return
      *
      * @generated from field: optional uint32 count = 2;
      */
     count?: number;
     /**
-     * Page of tasks to return
+     * Page is the page of tasks to return
      *
      * @generated from field: optional uint32 page = 3;
      */
@@ -143,13 +143,13 @@ export type TaskServiceListRequest = Message<"metalstack.admin.v2.TaskServiceLis
  */
 export declare const TaskServiceListRequestSchema: GenMessage<TaskServiceListRequest>;
 /**
- * TaskServiceListResponse is the response to a task list request
+ * TaskServiceListResponse is the response payload for listing tasks.
  *
  * @generated from message metalstack.admin.v2.TaskServiceListResponse
  */
 export type TaskServiceListResponse = Message<"metalstack.admin.v2.TaskServiceListResponse"> & {
     /**
-     * Tasks contains the requested list of tasks
+     * Tasks contains the list of requested tasks
      *
      * @generated from field: repeated metalstack.admin.v2.TaskInfo tasks = 1;
      */
@@ -161,123 +161,123 @@ export type TaskServiceListResponse = Message<"metalstack.admin.v2.TaskServiceLi
  */
 export declare const TaskServiceListResponseSchema: GenMessage<TaskServiceListResponse>;
 /**
- * TaskInfo contains details of an async task
+ * TaskInfo contains details of an asynchronous task.
  *
  * @generated from message metalstack.admin.v2.TaskInfo
  */
 export type TaskInfo = Message<"metalstack.admin.v2.TaskInfo"> & {
     /**
-     * ID is the identifier of the task.
+     * ID is the identifier of the task
      *
      * @generated from field: string id = 1;
      */
     id: string;
     /**
-     * Queue is the name of the queue in which the task belongs.
+     * Queue is the name of the queue in which the task belongs
      *
      * @generated from field: string queue = 2;
      */
     queue: string;
     /**
-     * Type is the type name of the task.
+     * Type is the type name of the task
      *
      * @generated from field: string type = 3;
      */
     type: string;
     /**
-     * Payload is the payload data of the task.
+     * Payload is the payload data of the task
      *
      * @generated from field: bytes payload = 4;
      */
     payload: Uint8Array;
     /**
-     * State indicates the task state.
+     * State indicates the task state
      *
      * @generated from field: metalstack.admin.v2.TaskState state = 5;
      */
     state: TaskState;
     /**
-     * MaxRetry is the maximum number of times the task can be retried.
+     * MaxRetry is the maximum number of times the task can be retried
      *
      * @generated from field: int32 max_retry = 6;
      */
     maxRetry: number;
     /**
-     * Retried is the number of times the task has retried so far.
+     * Retried is the number of times the task has retried so far
      *
      * @generated from field: int32 retried = 7;
      */
     retried: number;
     /**
-     * LastError is the error message from the last failure.
+     * LastError is the error message from the last failure
      *
      * @generated from field: string last_error = 8;
      */
     lastError: string;
     /**
-     * LastFailedAt is the time time of the last failure if any.
-     * If the task has no failures, LastFailedAt is zero time (i.e. time.Time{}).
+     * LastFailedAt is the time of the last failure if any
+     * If the task has no failures, LastFailedAt is zero time (i.e. time.Time{})
      *
      * @generated from field: google.protobuf.Timestamp last_failed_at = 9;
      */
     lastFailedAt?: Timestamp;
     /**
-     * Timeout is the duration the task can be processed by Handler before being retried,
+     * Timeout is the duration the task can be processed by Handler before being retried
      *
      * @generated from field: google.protobuf.Duration timeout = 10;
      */
     timeout?: Duration;
     /**
-     * Deadline is the deadline for the task.
+     * Deadline is the deadline for the task
      *
      * @generated from field: google.protobuf.Timestamp deadline = 11;
      */
     deadline?: Timestamp;
     /**
-     * Group is the name of the group in which the task belongs.
+     * Group is the name of the group in which the task belongs
      *
      * Tasks in the same queue can be grouped together by Group name and will be aggregated into one task
-     * by a Server processing the queue.
+     * by a Server processing the queue
      *
-     * Empty string (default) indicates task does not belong to any groups, and no aggregation will be applied to the task.
+     * Empty string (default) indicates task does not belong to any groups, and no aggregation will be applied to the task
      *
      * @generated from field: string group = 12;
      */
     group: string;
     /**
-     * NextProcessAt is the time the task is scheduled to be processed,
-     * zero if not applicable.
+     * NextProcessAt is the time the task is scheduled to be processed
+     * Zero if not applicable
      *
      * @generated from field: google.protobuf.Timestamp next_process_at = 13;
      */
     nextProcessAt?: Timestamp;
     /**
-     * IsOrphaned describes whether the task is left in active state with no worker processing it.
+     * IsOrphaned describes whether the task is left in active state with no worker processing it
      * An orphaned task indicates that the worker has crashed or experienced network failures and was not able to
-     * extend its lease on the task.
+     * extend its lease on the task
      *
-     * This task will be recovered by running a server against the queue the task is in.
-     * This field is only applicable to tasks with TaskStateActive.
+     * This task will be recovered by running a server against the queue the task is in
+     * This field is only applicable to tasks with TaskStateActive
      *
      * @generated from field: bool is_orphaned = 14;
      */
     isOrphaned: boolean;
     /**
-     * Retention is duration of the retention period after the task is successfully processed.
+     * Retention is duration of the retention period after the task is successfully processed
      *
      * @generated from field: google.protobuf.Duration retention = 15;
      */
     retention?: Duration;
     /**
-     * CompletedAt is the time when the task is processed successfully.
-     * Zero value (i.e. time.Time{}) indicates no value.
+     * CompletedAt is the time when the task is processed successfully
+     * Zero value (i.e. time.Time{}) indicates no value
      *
      * @generated from field: google.protobuf.Timestamp completed_at = 16;
      */
     completedAt?: Timestamp;
     /**
-     * Result holds the result data associated with the task.
-     * Use ResultWriter to write result data from the Handler.
+     * Result holds the result data associated with the task
+     * Use ResultWriter to write result data from the Handler
      *
      * @generated from field: bytes result = 17;
      */
@@ -289,55 +289,55 @@ export type TaskInfo = Message<"metalstack.admin.v2.TaskInfo"> & {
  */
 export declare const TaskInfoSchema: GenMessage<TaskInfo>;
 /**
- * TaskState defines the state of the task
+ * TaskState defines the state of the task.
  *
  * @generated from enum metalstack.admin.v2.TaskState
  */
 export declare enum TaskState {
     /**
-     * TASK_STATE_UNSPECIFIED indicates a undefined state
+     * TASK_STATE_UNSPECIFIED is not specified
      *
      * @generated from enum value: TASK_STATE_UNSPECIFIED = 0;
      */
     UNSPECIFIED = 0,
     /**
-     * TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler.
+     * TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler
      *
      * @generated from enum value: TASK_STATE_ACTIVE = 1;
      */
     ACTIVE = 1,
     /**
-     * TASK_STATE_PENDING indicates that the task is ready to be processed by Handler.
+     * TASK_STATE_PENDING indicates that the task is ready to be processed by Handler
      *
      * @generated from enum value: TASK_STATE_PENDING = 2;
      */
     PENDING = 2,
     /**
-     * TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future.
+     * TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future
      *
      * @generated from enum value: TASK_STATE_SCHEDULED = 3;
      */
     SCHEDULED = 3,
     /**
-     * TASK_STATE_RETRY indicates that the task has previously failed and scheduled to be processed some time in the future.
+     * TASK_STATE_RETRY indicates that the task has previously failed and is scheduled to be processed some time in the future
      *
      * @generated from enum value: TASK_STATE_RETRY = 4;
      */
     RETRY = 4,
     /**
-     * TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes.
+     * TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes
      *
      * @generated from enum value: TASK_STATE_ARCHIVED = 5;
      */
     ARCHIVED = 5,
     /**
-     * TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires.
+     * TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires
      *
      * @generated from enum value: TASK_STATE_COMPLETED = 6;
      */
     COMPLETED = 6,
     /**
-     * TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task.
+     * TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task
      *
      * @generated from enum value: TASK_STATE_AGGREGATING = 7;
      */
@@ -348,13 +348,13 @@ export declare enum TaskState {
  */
 export declare const TaskStateSchema: GenEnum<TaskState>;
 /**
- * TaskService provides services to async tasks
+ * TaskService provides asynchronous task management operations.
  *
  * @generated from service metalstack.admin.v2.TaskService
  */
 export declare const TaskService: GenService<{
     /**
-     * Get a specific task
+     * Returns the task with the specified identifier.
      *
      * @generated from rpc metalstack.admin.v2.TaskService.Get
      */
@@ -364,7 +364,7 @@ export declare const TaskService: GenService<{
         output: typeof TaskServiceGetResponseSchema;
     };
     /**
-     * Delete a specific task
+     * Deletes the task with the specified identifier.
      *
      * @generated from rpc metalstack.admin.v2.TaskService.Delete
      */
@@ -374,7 +374,7 @@ export declare const TaskService: GenService<{
         output: typeof TaskServiceDeleteResponseSchema;
     };
     /**
-     * Queues returns all configures queues
+     * Returns the list of all configured queues.
      *
      * @generated from rpc metalstack.admin.v2.TaskService.Queues
      */
@@ -384,7 +384,7 @@ export declare const TaskService: GenService<{
         output: typeof TaskServiceQueuesResponseSchema;
     };
     /**
-     * List list all tasks
+     * Returns the list of all tasks.
      *
      * @generated from rpc metalstack.admin.v2.TaskService.List
      */
diff --git a/js/metalstack/admin/v2/task_pb.js b/js/metalstack/admin/v2/task_pb.js
index e30a4b51..1ae2df81 100644
--- a/js/metalstack/admin/v2/task_pb.js
+++ b/js/metalstack/admin/v2/task_pb.js
@@ -54,56 +54,56 @@ export const TaskServiceListResponseSchema = /*@__PURE__*/ messageDesc(file_meta
  */
 export const TaskInfoSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_task, 8);
 /**
- * TaskState defines the state of the task
+ * TaskState defines the state of the task.
  *
  * @generated from enum metalstack.admin.v2.TaskState
  */
 export var TaskState;
 (function (TaskState) {
     /**
-     * TASK_STATE_UNSPECIFIED indicates a undefined state
+     * TASK_STATE_UNSPECIFIED is not specified
      *
      * @generated from enum value: TASK_STATE_UNSPECIFIED = 0;
      */
     TaskState[TaskState["UNSPECIFIED"] = 0] = "UNSPECIFIED";
     /**
-     * TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler.
+     * TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler
      *
      * @generated from enum value: TASK_STATE_ACTIVE = 1;
      */
     TaskState[TaskState["ACTIVE"] = 1] = "ACTIVE";
     /**
-     * TASK_STATE_PENDING indicates that the task is ready to be processed by Handler.
+     * TASK_STATE_PENDING indicates that the task is ready to be processed by Handler
      *
      * @generated from enum value: TASK_STATE_PENDING = 2;
      */
     TaskState[TaskState["PENDING"] = 2] = "PENDING";
     /**
-     * TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future.
+     * TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future
      *
      * @generated from enum value: TASK_STATE_SCHEDULED = 3;
      */
     TaskState[TaskState["SCHEDULED"] = 3] = "SCHEDULED";
     /**
-     * TASK_STATE_RETRY indicates that the task has previously failed and scheduled to be processed some time in the future.
+     * TASK_STATE_RETRY indicates that the task has previously failed and is scheduled to be processed some time in the future
      *
      * @generated from enum value: TASK_STATE_RETRY = 4;
      */
     TaskState[TaskState["RETRY"] = 4] = "RETRY";
     /**
-     * TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes.
+     * TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes
      *
      * @generated from enum value: TASK_STATE_ARCHIVED = 5;
      */
     TaskState[TaskState["ARCHIVED"] = 5] = "ARCHIVED";
     /**
-     * TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires.
+     * TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires
      *
      * @generated from enum value: TASK_STATE_COMPLETED = 6;
      */
     TaskState[TaskState["COMPLETED"] = 6] = "COMPLETED";
     /**
-     * TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task.
+     * TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task
      *
      * @generated from enum value: TASK_STATE_AGGREGATING = 7;
      */
@@ -114,7 +114,7 @@ export var TaskState;
  */
 export const TaskStateSchema = /*@__PURE__*/ enumDesc(file_metalstack_admin_v2_task, 0);
 /**
- * TaskService provides services to async tasks
+ * TaskService provides asynchronous task management operations.
  *
  * @generated from service metalstack.admin.v2.TaskService
  */
diff --git a/js/metalstack/admin/v2/task_pb.ts b/js/metalstack/admin/v2/task_pb.ts
index ab1d9628..63f173de 100644
--- a/js/metalstack/admin/v2/task_pb.ts
+++ b/js/metalstack/admin/v2/task_pb.ts
@@ -16,20 +16,20 @@ export const file_metalstack_admin_v2_task: GenFile = /*@__PURE__*/
   fileDesc("Ch5tZXRhbHN0YWNrL2FkbWluL3YyL3Rhc2sucHJvdG8SE21ldGFsc3RhY2suYWRtaW4udjIiNwoVVGFza1NlcnZpY2VHZXRSZXF1ZXN0Eg8KB3Rhc2tfaWQYASABKAkSDQoFcXVldWUYAiABKAkiRQoWVGFza1NlcnZpY2VHZXRSZXNwb25zZRIrCgR0YXNrGAEgASgLMh0ubWV0YWxzdGFjay5hZG1pbi52Mi5UYXNrSW5mbyI6ChhUYXNrU2VydmljZURlbGV0ZVJlcXVlc3QSDwoHdGFza19pZBgBIAEoCRINCgVxdWV1ZRgCIAEoCSIbChlUYXNrU2VydmljZURlbGV0ZVJlc3BvbnNlIhoKGFRhc2tTZXJ2aWNlUXVldWVzUmVxdWVzdCIrChlUYXNrU2VydmljZVF1ZXVlc1Jlc3BvbnNlEg4KBnF1ZXVlcxgBIAMoCSJwChZUYXNrU2VydmljZUxpc3RSZXF1ZXN0EhIKBXF1ZXVlGAEgASgJSACIAQESEgoFY291bnQYAiABKA1IAYgBARIRCgRwYWdlGAMgASgNSAKIAQFCCAoGX3F1ZXVlQggKBl9jb3VudEIHCgVfcGFnZSJHChdUYXNrU2VydmljZUxpc3RSZXNwb25zZRIsCgV0YXNrcxgBIAMoCzIdLm1ldGFsc3RhY2suYWRtaW4udjIuVGFza0luZm8iggQKCFRhc2tJbmZvEgoKAmlkGAEgASgJEg0KBXF1ZXVlGAIgASgJEgwKBHR5cGUYAyABKAkSDwoHcGF5bG9hZBgEIAEoDBItCgVzdGF0ZRgFIAEoDjIeLm1ldGFsc3RhY2suYWRtaW4udjIuVGFza1N0YXRlEhEKCW1heF9yZXRyeRgGIAEoBRIPCgdyZXRyaWVkGAcgASgFEhIKCmxhc3RfZXJyb3IYCCABKAkSMgoObGFzdF9mYWlsZWRfYXQYCSABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEioKB3RpbWVvdXQYCiABKAsyGS5nb29nbGUucHJvdG9idWYuRHVyYXRpb24SLAoIZGVhZGxpbmUYCyABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEg0KBWdyb3VwGAwgASgJEjMKD25leHRfcHJvY2Vzc19hdBgNIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASEwoLaXNfb3JwaGFuZWQYDiABKAgSLAoJcmV0ZW50aW9uGA8gASgLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uEjAKDGNvbXBsZXRlZF9hdBgQIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXASDgoGcmVzdWx0GBEgASgMKrYCCglUYXNrU3RhdGUSGgoWVEFTS19TVEFURV9VTlNQRUNJRklFRBAAEiEKEVRBU0tfU1RBVEVfQUNUSVZFEAEaCoKyGQZhY3RpdmUSIwoSVEFTS19TVEFURV9QRU5ESU5HEAIaC4KyGQdwZW5kaW5nEicKFFRBU0tfU1RBVEVfU0NIRURVTEVEEAMaDYKyGQlzY2hlZHVsZWQSHwoQVEFTS19TVEFURV9SRVRSWRAEGgmCshkFcmV0cnkSJQoTVEFTS19TVEFURV9BUkNISVZFRBAFGgyCshkIYXJjaGl2ZWQSJwoUVEFTS19TVEFURV9DT01QTEVURUQQBhoNgrIZCWNvbXBsZXRlZBIrChZUQVNLX1NUQVRFX0FHR1JFR0FUSU5HEAcaD4KyGQthZ2dyZWdhdGluZzLBAwoLVGFza1NlcnZpY2USZgoDR2V0EioubWV0YWxzdGFjay5hZG1pbi52Mi5UYXNrU2VydmljZUdldFJlcXVlc3QaKy5tZXRhbHN0YWNrLmFkbWluLnYyLlRhc2tTZXJ2aWNlR2V0UmVzcG9uc2UiBtLzGAIBAhJuCgZEZWxldGUSLS5tZXRhbHN0YWNrLmFkbWluLnYyLlRhc2tTZXJ2aWNlRGVsZXRlUmVxdWVzdBouLm1ldGFsc3RhY2suYWRtaW4udjIuVGFza1NlcnZpY2VEZWxldGVSZXNwb25zZSIF0vMYAQESbwoGUXVldWVzEi0ubWV0YWxzdGFjay5hZG1pbi52Mi5UYXNrU2VydmljZVF1ZXVlc1JlcXVlc3QaLi5tZXRhbHN0YWNrLmFkbWluLnYyLlRhc2tTZXJ2aWNlUXVldWVzUmVzcG9uc2UiBtLzGAIBAhJpCgRMaXN0EisubWV0YWxzdGFjay5hZG1pbi52Mi5UYXNrU2VydmljZUxpc3RSZXF1ZXN0GiwubWV0YWxzdGFjay5hZG1pbi52Mi5UYXNrU2VydmljZUxpc3RSZXNwb25zZSIG0vMYAgECQs0BChdjb20ubWV0YWxzdGFjay5hZG1pbi52MkIJVGFza1Byb3RvUAFaOWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYWRtaW4vdjI7YWRtaW52MqICA01BWKoCE01ldGFsc3RhY2suQWRtaW4uVjLKAhNNZXRhbHN0YWNrXEFkbWluXFYy4gIfTWV0YWxzdGFja1xBZG1pblxWMlxHUEJNZXRhZGF0YeoCFU1ldGFsc3RhY2s6OkFkbWluOjpWMmIGcHJvdG8z", [file_google_protobuf_duration, file_google_protobuf_timestamp, file_metalstack_api_v2_common]);
 
 /**
- * TaskServiceGetRequest is the message to a get task request
+ * TaskServiceGetRequest is the request payload for getting a task.
  *
  * @generated from message metalstack.admin.v2.TaskServiceGetRequest
  */
 export type TaskServiceGetRequest = Message<"metalstack.admin.v2.TaskServiceGetRequest"> & {
   /**
-   * TaskId to get
+   * TaskId is the identifier of the task to get
    *
    * @generated from field: string task_id = 1;
    */
   taskId: string;
 
   /**
-   * Queue where this task was scheduled to
+   * Queue is the queue where this task was scheduled to
    *
    * @generated from field: string queue = 2;
    */
@@ -44,7 +44,7 @@ export const TaskServiceGetRequestSchema: GenMessage<TaskServiceGetRequest> = /*
   messageDesc(file_metalstack_admin_v2_task, 0);
 
 /**
- * TaskServiceGetResponse is the response to a task get request
+ * TaskServiceGetResponse is the response payload for getting a task.
  *
  * @generated from message metalstack.admin.v2.TaskServiceGetResponse
  */
@@ -65,20 +65,20 @@ export const TaskServiceGetResponseSchema: GenMessage<TaskServiceGetResponse> =
   messageDesc(file_metalstack_admin_v2_task, 1);
 
 /**
- * TaskServiceDeleteRequest is the message to a delete task request
+ * TaskServiceDeleteRequest is the request payload for deleting a task.
  *
  * @generated from message metalstack.admin.v2.TaskServiceDeleteRequest
  */
 export type TaskServiceDeleteRequest = Message<"metalstack.admin.v2.TaskServiceDeleteRequest"> & {
   /**
-   * TaskId to cancel
+   * TaskId is the identifier of the task to cancel
    *
    * @generated from field: string task_id = 1;
    */
   taskId: string;
 
   /**
-   * Queue where this task was scheduled to
+   * Queue is the queue where this task was scheduled to
    *
    * @generated from field: string queue = 2;
    */
@@ -93,7 +93,7 @@ export const TaskServiceDeleteRequestSchema: GenMessage<TaskServiceDeleteRequest
   messageDesc(file_metalstack_admin_v2_task, 2);
 
 /**
- * TaskServiceDeleteResponse is the response to a task delete request
+ * TaskServiceDeleteResponse is the response payload for deleting a task.
  *
  * @generated from message metalstack.admin.v2.TaskServiceDeleteResponse
  */
@@ -108,7 +108,7 @@ export const TaskServiceDeleteResponseSchema: GenMessage<TaskServiceDeleteRespon
   messageDesc(file_metalstack_admin_v2_task, 3);
 
 /**
- * TaskServiceQueuesRequest is the message to get all queues
+ * TaskServiceQueuesRequest is the request payload for getting all queues.
  *
  * @generated from message metalstack.admin.v2.TaskServiceQueuesRequest
  */
@@ -123,7 +123,7 @@ export const TaskServiceQueuesRequestSchema: GenMessage<TaskServiceQueuesRequest
   messageDesc(file_metalstack_admin_v2_task, 4);
 
 /**
- * TaskServiceQueuesResponse is the response to a queues request
+ * TaskServiceQueuesResponse is the response payload for getting all queues.
  *
  * @generated from message metalstack.admin.v2.TaskServiceQueuesResponse
  */
@@ -144,28 +144,28 @@ export const TaskServiceQueuesResponseSchema: GenMessage<TaskServiceQueuesRespon
   messageDesc(file_metalstack_admin_v2_task, 5);
 
 /**
- * TaskServiceListRequest is the message to a task list request
+ * TaskServiceListRequest is the request payload for listing tasks.
  *
  * @generated from message metalstack.admin.v2.TaskServiceListRequest
  */
 export type TaskServiceListRequest = Message<"metalstack.admin.v2.TaskServiceListRequest"> & {
   /**
-   * Queue where this tasks should be listed
-   * will return tasks from all queues if not specified
+   * Queue filters tasks by this queue
+   * Will return tasks from all queues if not specified
    *
    * @generated from field: optional string queue = 1;
    */
   queue?: string;
 
   /**
-   * Count of tasks to return
+   * Count is the number of tasks to return
    *
    * @generated from field: optional uint32 count = 2;
    */
   count?: number;
 
   /**
-   * Page of tasks to return
+   * Page is the page of tasks to return
    *
    * @generated from field: optional uint32 page = 3;
    */
@@ -180,13 +180,13 @@ export const TaskServiceListRequestSchema: GenMessage<TaskServiceListRequest> =
   messageDesc(file_metalstack_admin_v2_task, 6);
 
 /**
- * TaskServiceListResponse is the response to a task list request
+ * TaskServiceListResponse is the response payload for listing tasks.
  *
  * @generated from message metalstack.admin.v2.TaskServiceListResponse
  */
 export type TaskServiceListResponse = Message<"metalstack.admin.v2.TaskServiceListResponse"> & {
   /**
-   * Tasks contains the requested list of tasks
+   * Tasks contains the list of requested tasks
    *
    * @generated from field: repeated metalstack.admin.v2.TaskInfo tasks = 1;
    */
@@ -201,139 +201,139 @@ export const TaskServiceListResponseSchema: GenMessage<TaskServiceListResponse>
   messageDesc(file_metalstack_admin_v2_task, 7);
 
 /**
- * TaskInfo contains details of an async task
+ * TaskInfo contains details of an asynchronous task.
  *
  * @generated from message metalstack.admin.v2.TaskInfo
  */
 export type TaskInfo = Message<"metalstack.admin.v2.TaskInfo"> & {
   /**
-   * ID is the identifier of the task.
+   * ID is the identifier of the task
    *
    * @generated from field: string id = 1;
    */
   id: string;
 
   /**
-   * Queue is the name of the queue in which the task belongs.
+   * Queue is the name of the queue in which the task belongs
    *
    * @generated from field: string queue = 2;
    */
   queue: string;
 
   /**
-   * Type is the type name of the task.
+   * Type is the type name of the task
    *
    * @generated from field: string type = 3;
    */
   type: string;
 
   /**
-   * Payload is the payload data of the task.
+   * Payload is the payload data of the task
    *
    * @generated from field: bytes payload = 4;
    */
   payload: Uint8Array;
 
   /**
-   * State indicates the task state.
+   * State indicates the task state
    *
    * @generated from field: metalstack.admin.v2.TaskState state = 5;
    */
   state: TaskState;
 
   /**
-   * MaxRetry is the maximum number of times the task can be retried.
+   * MaxRetry is the maximum number of times the task can be retried
    *
    * @generated from field: int32 max_retry = 6;
    */
   maxRetry: number;
 
   /**
-   * Retried is the number of times the task has retried so far.
+   * Retried is the number of times the task has retried so far
    *
    * @generated from field: int32 retried = 7;
    */
   retried: number;
 
   /**
-   * LastError is the error message from the last failure.
+   * LastError is the error message from the last failure
    *
    * @generated from field: string last_error = 8;
    */
   lastError: string;
 
   /**
-   * LastFailedAt is the time time of the last failure if any.
-   * If the task has no failures, LastFailedAt is zero time (i.e. time.Time{}).
+   * LastFailedAt is the time of the last failure if any
+   * If the task has no failures, LastFailedAt is zero time (i.e. time.Time{})
    *
    * @generated from field: google.protobuf.Timestamp last_failed_at = 9;
    */
   lastFailedAt?: Timestamp;
 
   /**
-   * Timeout is the duration the task can be processed by Handler before being retried,
+   * Timeout is the duration the task can be processed by Handler before being retried
    *
    * @generated from field: google.protobuf.Duration timeout = 10;
    */
   timeout?: Duration;
 
   /**
-   * Deadline is the deadline for the task.
+   * Deadline is the deadline for the task
    *
    * @generated from field: google.protobuf.Timestamp deadline = 11;
    */
   deadline?: Timestamp;
 
   /**
-   * Group is the name of the group in which the task belongs.
+   * Group is the name of the group in which the task belongs
    *
    * Tasks in the same queue can be grouped together by Group name and will be aggregated into one task
-   * by a Server processing the queue.
+   * by a Server processing the queue
    *
-   * Empty string (default) indicates task does not belong to any groups, and no aggregation will be applied to the task.
+   * Empty string (default) indicates task does not belong to any groups, and no aggregation will be applied to the task
    *
    * @generated from field: string group = 12;
    */
   group: string;
 
   /**
-   * NextProcessAt is the time the task is scheduled to be processed,
-   * zero if not applicable.
+   * NextProcessAt is the time the task is scheduled to be processed
+   * Zero if not applicable
    *
    * @generated from field: google.protobuf.Timestamp next_process_at = 13;
    */
   nextProcessAt?: Timestamp;
 
   /**
-   * IsOrphaned describes whether the task is left in active state with no worker processing it.
+   * IsOrphaned describes whether the task is left in active state with no worker processing it
    * An orphaned task indicates that the worker has crashed or experienced network failures and was not able to
-   * extend its lease on the task.
+   * extend its lease on the task
    *
-   * This task will be recovered by running a server against the queue the task is in.
-   * This field is only applicable to tasks with TaskStateActive.
+   * This task will be recovered by running a server against the queue the task is in
+   * This field is only applicable to tasks with TaskStateActive
    *
    * @generated from field: bool is_orphaned = 14;
    */
   isOrphaned: boolean;
 
   /**
-   * Retention is duration of the retention period after the task is successfully processed.
+   * Retention is duration of the retention period after the task is successfully processed
    *
    * @generated from field: google.protobuf.Duration retention = 15;
    */
   retention?: Duration;
 
   /**
-   * CompletedAt is the time when the task is processed successfully.
-   * Zero value (i.e. time.Time{}) indicates no value.
+   * CompletedAt is the time when the task is processed successfully
+   * Zero value (i.e. time.Time{}) indicates no value
    *
    * @generated from field: google.protobuf.Timestamp completed_at = 16;
    */
   completedAt?: Timestamp;
 
   /**
-   * Result holds the result data associated with the task.
-   * Use ResultWriter to write result data from the Handler.
+   * Result holds the result data associated with the task
+   * Use ResultWriter to write result data from the Handler
    *
    * @generated from field: bytes result = 17;
    */
@@ -348,62 +348,62 @@ export const TaskInfoSchema: GenMessage<TaskInfo> = /*@__PURE__*/
   messageDesc(file_metalstack_admin_v2_task, 8);
 
 /**
- * TaskState defines the state of the task
+ * TaskState defines the state of the task.
  *
  * @generated from enum metalstack.admin.v2.TaskState
  */
 export enum TaskState {
   /**
-   * TASK_STATE_UNSPECIFIED indicates a undefined state
+   * TASK_STATE_UNSPECIFIED is not specified
    *
    * @generated from enum value: TASK_STATE_UNSPECIFIED = 0;
    */
   UNSPECIFIED = 0,
 
   /**
-   * TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler.
+   * TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler
    *
    * @generated from enum value: TASK_STATE_ACTIVE = 1;
    */
   ACTIVE = 1,
 
   /**
-   * TASK_STATE_PENDING indicates that the task is ready to be processed by Handler.
+   * TASK_STATE_PENDING indicates that the task is ready to be processed by Handler
    *
    * @generated from enum value: TASK_STATE_PENDING = 2;
    */
   PENDING = 2,
 
   /**
-   * TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future.
+   * TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future
    *
    * @generated from enum value: TASK_STATE_SCHEDULED = 3;
    */
   SCHEDULED = 3,
 
   /**
-   * TASK_STATE_RETRY indicates that the task has previously failed and scheduled to be processed some time in the future.
+   * TASK_STATE_RETRY indicates that the task has previously failed and is scheduled to be processed some time in the future
    *
    * @generated from enum value: TASK_STATE_RETRY = 4;
    */
   RETRY = 4,
 
   /**
-   * TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes.
+   * TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes
    *
    * @generated from enum value: TASK_STATE_ARCHIVED = 5;
    */
   ARCHIVED = 5,
 
   /**
-   * TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires.
+   * TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires
    *
    * @generated from enum value: TASK_STATE_COMPLETED = 6;
    */
   COMPLETED = 6,
 
   /**
-   * TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task.
+   * TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task
    *
    * @generated from enum value: TASK_STATE_AGGREGATING = 7;
    */
@@ -417,13 +417,13 @@ export const TaskStateSchema: GenEnum<TaskState> = /*@__PURE__*/
   enumDesc(file_metalstack_admin_v2_task, 0);
 
 /**
- * TaskService provides services to async tasks
+ * TaskService provides asynchronous task management operations.
  *
  * @generated from service metalstack.admin.v2.TaskService
  */
 export const TaskService: GenService<{
   /**
-   * Get a specific task
+   * Returns the task with the specified identifier.
    *
    * @generated from rpc metalstack.admin.v2.TaskService.Get
    */
@@ -433,7 +433,7 @@ export const TaskService: GenService<{
     output: typeof TaskServiceGetResponseSchema;
   },
   /**
-   * Delete a specific task
+   * Deletes the task with the specified identifier.
    *
    * @generated from rpc metalstack.admin.v2.TaskService.Delete
    */
@@ -443,7 +443,7 @@ export const TaskService: GenService<{
     output: typeof TaskServiceDeleteResponseSchema;
   },
   /**
-   * Queues returns all configures queues
+   * Returns the list of all configured queues.
    *
    * @generated from rpc metalstack.admin.v2.TaskService.Queues
    */
@@ -453,7 +453,7 @@ export const TaskService: GenService<{
     output: typeof TaskServiceQueuesResponseSchema;
   },
   /**
-   * List list all tasks
+   * Returns the list of all tasks.
    *
    * @generated from rpc metalstack.admin.v2.TaskService.List
    */
diff --git a/js/metalstack/admin/v2/tenant_pb.d.ts b/js/metalstack/admin/v2/tenant_pb.d.ts
index 3e79aefe..c1ac26ad 100644
--- a/js/metalstack/admin/v2/tenant_pb.d.ts
+++ b/js/metalstack/admin/v2/tenant_pb.d.ts
@@ -7,19 +7,19 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_tenant: GenFile;
 /**
- * TenantServiceCreateRequest is the request payload of the tenant create request
+ * TenantServiceCreateRequest is the request payload for creating a tenant.
  *
  * @generated from message metalstack.admin.v2.TenantServiceCreateRequest
  */
 export type TenantServiceCreateRequest = Message<"metalstack.admin.v2.TenantServiceCreateRequest"> & {
     /**
-     * Name of this tenant
+     * Name of the tenant
      *
      * @generated from field: string name = 1;
      */
     name: string;
     /**
-     * Description of this tenant
+     * Description of the tenant
      *
      * @generated from field: optional string description = 2;
      */
@@ -49,13 +49,13 @@ export type TenantServiceCreateRequest = Message<"metalstack.admin.v2.TenantServ
  */
 export declare const TenantServiceCreateRequestSchema: GenMessage<TenantServiceCreateRequest>;
 /**
- * TenantServiceCreateResponse is the response payload of the tenant create request
+ * TenantServiceCreateResponse is the response payload for creating a tenant.
  *
  * @generated from message metalstack.admin.v2.TenantServiceCreateResponse
  */
 export type TenantServiceCreateResponse = Message<"metalstack.admin.v2.TenantServiceCreateResponse"> & {
     /**
-     * Tenant is the tenant
+     * Tenant contains the created tenant
      *
      * @generated from field: metalstack.api.v2.Tenant tenant = 1;
      */
@@ -67,19 +67,19 @@ export type TenantServiceCreateResponse = Message<"metalstack.admin.v2.TenantSer
  */
 export declare const TenantServiceCreateResponseSchema: GenMessage<TenantServiceCreateResponse>;
 /**
- * TenantServiceListRequest is the request payload for a tenant list request
+ * TenantServiceListRequest is the request payload for listing tenants.
  *
  * @generated from message metalstack.admin.v2.TenantServiceListRequest
  */
 export type TenantServiceListRequest = Message<"metalstack.admin.v2.TenantServiceListRequest"> & {
     /**
-     * Login of the tenant to list
+     * Login filters tenants by this login
      *
      * @generated from field: optional string login = 1;
      */
     login?: string;
     /**
-     * Name of the tenant to list
+     * Name filters tenants by this name
      *
      * @generated from field: optional string name = 2;
      */
@@ -97,19 +97,19 @@ export type TenantServiceListRequest = Message<"metalstack.admin.v2.TenantServic
  */
 export declare const TenantServiceListRequestSchema: GenMessage<TenantServiceListRequest>;
 /**
- * TenantServiceListResponse is the response payload for a tenant list request
+ * TenantServiceListResponse is the response payload for listing tenants.
  *
  * @generated from message metalstack.admin.v2.TenantServiceListResponse
  */
 export type TenantServiceListResponse = Message<"metalstack.admin.v2.TenantServiceListResponse"> & {
     /**
-     * Tenants are the list of tenants
+     * Tenants contains the list of tenants
      *
      * @generated from field: repeated metalstack.api.v2.Tenant tenants = 1;
      */
     tenants: Tenant[];
     /**
-     * NextPage is used for pagination, returns the next page to be fetched and must then be provided in the list request.
+     * NextPage is used for pagination, returns the next page to be fetched and must then be provided in the list request
      *
      * @generated from field: optional uint64 next_page = 2;
      */
@@ -121,13 +121,13 @@ export type TenantServiceListResponse = Message<"metalstack.admin.v2.TenantServi
  */
 export declare const TenantServiceListResponseSchema: GenMessage<TenantServiceListResponse>;
 /**
- * TenantService serves tenant related functions
+ * TenantService provides tenant management operations.
  *
  * @generated from service metalstack.admin.v2.TenantService
  */
 export declare const TenantService: GenService<{
     /**
-     * Create a tenant
+     * Creates a new tenant.
      *
      * @generated from rpc metalstack.admin.v2.TenantService.Create
      */
@@ -137,7 +137,7 @@ export declare const TenantService: GenService<{
         output: typeof TenantServiceCreateResponseSchema;
     };
     /**
-     * List all tenants
+     * Returns the list of all tenants.
      *
      * @generated from rpc metalstack.admin.v2.TenantService.List
      */
diff --git a/js/metalstack/admin/v2/tenant_pb.js b/js/metalstack/admin/v2/tenant_pb.js
index 87e861e4..1dfe7cc0 100644
--- a/js/metalstack/admin/v2/tenant_pb.js
+++ b/js/metalstack/admin/v2/tenant_pb.js
@@ -31,7 +31,7 @@ export const TenantServiceListRequestSchema = /*@__PURE__*/ messageDesc(file_met
  */
 export const TenantServiceListResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_tenant, 3);
 /**
- * TenantService serves tenant related functions
+ * TenantService provides tenant management operations.
  *
  * @generated from service metalstack.admin.v2.TenantService
  */
diff --git a/js/metalstack/admin/v2/tenant_pb.ts b/js/metalstack/admin/v2/tenant_pb.ts
index 0dfc6e5a..42a29f9d 100644
--- a/js/metalstack/admin/v2/tenant_pb.ts
+++ b/js/metalstack/admin/v2/tenant_pb.ts
@@ -19,20 +19,20 @@ export const file_metalstack_admin_v2_tenant: GenFile = /*@__PURE__*/
   fileDesc("CiBtZXRhbHN0YWNrL2FkbWluL3YyL3RlbmFudC5wcm90bxITbWV0YWxzdGFjay5hZG1pbi52MiLoAQoaVGVuYW50U2VydmljZUNyZWF0ZVJlcXVlc3QSGQoEbmFtZRgBIAEoCUILukgIcgbAs66xAgESJQoLZGVzY3JpcHRpb24YAiABKAlCC7pICHIGyLOusQIBSACIAQESGwoFZW1haWwYAyABKAlCB7pIBHICYAFIAYgBARIXCgphdmF0YXJfdXJsGAQgASgJSAKIAQESKQoGbGFiZWxzGAUgASgLMhkubWV0YWxzdGFjay5hcGkudjIuTGFiZWxzQg4KDF9kZXNjcmlwdGlvbkIICgZfZW1haWxCDQoLX2F2YXRhcl91cmwiSAobVGVuYW50U2VydmljZUNyZWF0ZVJlc3BvbnNlEikKBnRlbmFudBgBIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLlRlbmFudCKMAQoYVGVuYW50U2VydmljZUxpc3RSZXF1ZXN0EhIKBWxvZ2luGAEgASgJSACIAQESHgoEbmFtZRgCIAEoCUILukgIcgbAs66xAgFIAYgBARIpCgZwYWdpbmcYAyABKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5QYWdpbmdCCAoGX2xvZ2luQgcKBV9uYW1lIm0KGVRlbmFudFNlcnZpY2VMaXN0UmVzcG9uc2USKgoHdGVuYW50cxgBIAMoCzIZLm1ldGFsc3RhY2suYXBpLnYyLlRlbmFudBIWCgluZXh0X3BhZ2UYAiABKARIAIgBAUIMCgpfbmV4dF9wYWdlMvIBCg1UZW5hbnRTZXJ2aWNlEnIKBkNyZWF0ZRIvLm1ldGFsc3RhY2suYWRtaW4udjIuVGVuYW50U2VydmljZUNyZWF0ZVJlcXVlc3QaMC5tZXRhbHN0YWNrLmFkbWluLnYyLlRlbmFudFNlcnZpY2VDcmVhdGVSZXNwb25zZSIF0vMYAQESbQoETGlzdBItLm1ldGFsc3RhY2suYWRtaW4udjIuVGVuYW50U2VydmljZUxpc3RSZXF1ZXN0Gi4ubWV0YWxzdGFjay5hZG1pbi52Mi5UZW5hbnRTZXJ2aWNlTGlzdFJlc3BvbnNlIgbS8xgCAQJCzwEKF2NvbS5tZXRhbHN0YWNrLmFkbWluLnYyQgtUZW5hbnRQcm90b1ABWjlnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FkbWluL3YyO2FkbWludjKiAgNNQViqAhNNZXRhbHN0YWNrLkFkbWluLlYyygITTWV0YWxzdGFja1xBZG1pblxWMuICH01ldGFsc3RhY2tcQWRtaW5cVjJcR1BCTWV0YWRhdGHqAhVNZXRhbHN0YWNrOjpBZG1pbjo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_tenant]);
 
 /**
- * TenantServiceCreateRequest is the request payload of the tenant create request
+ * TenantServiceCreateRequest is the request payload for creating a tenant.
  *
  * @generated from message metalstack.admin.v2.TenantServiceCreateRequest
  */
 export type TenantServiceCreateRequest = Message<"metalstack.admin.v2.TenantServiceCreateRequest"> & {
   /**
-   * Name of this tenant
+   * Name of the tenant
    *
    * @generated from field: string name = 1;
    */
   name: string;
 
   /**
-   * Description of this tenant
+   * Description of the tenant
    *
    * @generated from field: optional string description = 2;
    */
@@ -68,13 +68,13 @@ export const TenantServiceCreateRequestSchema: GenMessage<TenantServiceCreateReq
   messageDesc(file_metalstack_admin_v2_tenant, 0);
 
 /**
- * TenantServiceCreateResponse is the response payload of the tenant create request
+ * TenantServiceCreateResponse is the response payload for creating a tenant.
  *
  * @generated from message metalstack.admin.v2.TenantServiceCreateResponse
  */
 export type TenantServiceCreateResponse = Message<"metalstack.admin.v2.TenantServiceCreateResponse"> & {
   /**
-   * Tenant is the tenant
+   * Tenant contains the created tenant
    *
    * @generated from field: metalstack.api.v2.Tenant tenant = 1;
    */
@@ -89,20 +89,20 @@ export const TenantServiceCreateResponseSchema: GenMessage<TenantServiceCreateRe
   messageDesc(file_metalstack_admin_v2_tenant, 1);
 
 /**
- * TenantServiceListRequest is the request payload for a tenant list request
+ * TenantServiceListRequest is the request payload for listing tenants.
  *
  * @generated from message metalstack.admin.v2.TenantServiceListRequest
  */
 export type TenantServiceListRequest = Message<"metalstack.admin.v2.TenantServiceListRequest"> & {
   /**
-   * Login of the tenant to list
+   * Login filters tenants by this login
    *
    * @generated from field: optional string login = 1;
    */
   login?: string;
 
   /**
-   * Name of the tenant to list
+   * Name filters tenants by this name
    *
    * @generated from field: optional string name = 2;
    */
@@ -124,20 +124,20 @@ export const TenantServiceListRequestSchema: GenMessage<TenantServiceListRequest
   messageDesc(file_metalstack_admin_v2_tenant, 2);
 
 /**
- * TenantServiceListResponse is the response payload for a tenant list request
+ * TenantServiceListResponse is the response payload for listing tenants.
  *
  * @generated from message metalstack.admin.v2.TenantServiceListResponse
  */
 export type TenantServiceListResponse = Message<"metalstack.admin.v2.TenantServiceListResponse"> & {
   /**
-   * Tenants are the list of tenants
+   * Tenants contains the list of tenants
    *
    * @generated from field: repeated metalstack.api.v2.Tenant tenants = 1;
    */
   tenants: Tenant[];
 
   /**
-   * NextPage is used for pagination, returns the next page to be fetched and must then be provided in the list request.
+   * NextPage is used for pagination, returns the next page to be fetched and must then be provided in the list request
    *
    * @generated from field: optional uint64 next_page = 2;
    */
@@ -152,13 +152,13 @@ export const TenantServiceListResponseSchema: GenMessage<TenantServiceListRespon
   messageDesc(file_metalstack_admin_v2_tenant, 3);
 
 /**
- * TenantService serves tenant related functions
+ * TenantService provides tenant management operations.
  *
  * @generated from service metalstack.admin.v2.TenantService
  */
 export const TenantService: GenService<{
   /**
-   * Create a tenant
+   * Creates a new tenant.
    *
    * @generated from rpc metalstack.admin.v2.TenantService.Create
    */
@@ -168,7 +168,7 @@ export const TenantService: GenService<{
     output: typeof TenantServiceCreateResponseSchema;
   },
   /**
-   * List all tenants
+   * Returns the list of all tenants.
    *
    * @generated from rpc metalstack.admin.v2.TenantService.List
    */
diff --git a/js/metalstack/admin/v2/token_pb.d.ts b/js/metalstack/admin/v2/token_pb.d.ts
index 3afa905a..a14ac335 100644
--- a/js/metalstack/admin/v2/token_pb.d.ts
+++ b/js/metalstack/admin/v2/token_pb.d.ts
@@ -6,7 +6,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_token: GenFile;
 /**
- * TokenServiceListRequest is the request payload for the token list request
+ * TokenServiceListRequest is the request payload for listing tokens.
  *
  * @generated from message metalstack.admin.v2.TokenServiceListRequest
  */
@@ -24,13 +24,13 @@ export type TokenServiceListRequest = Message<"metalstack.admin.v2.TokenServiceL
  */
 export declare const TokenServiceListRequestSchema: GenMessage<TokenServiceListRequest>;
 /**
- * TokenServiceListResponse is the response payload for the token list request
+ * TokenServiceListResponse is the response payload for listing tokens.
  *
  * @generated from message metalstack.admin.v2.TokenServiceListResponse
  */
 export type TokenServiceListResponse = Message<"metalstack.admin.v2.TokenServiceListResponse"> & {
     /**
-     * Tokens is the list of tokens
+     * Tokens contains the list of tokens
      *
      * @generated from field: repeated metalstack.api.v2.Token tokens = 1;
      */
@@ -42,7 +42,7 @@ export type TokenServiceListResponse = Message<"metalstack.admin.v2.TokenService
  */
 export declare const TokenServiceListResponseSchema: GenMessage<TokenServiceListResponse>;
 /**
- * TokenServiceRevokeRequest is the request payload for the token revoke request
+ * TokenServiceRevokeRequest is the request payload for revoking a token.
  *
  * @generated from message metalstack.admin.v2.TokenServiceRevokeRequest
  */
@@ -66,7 +66,7 @@ export type TokenServiceRevokeRequest = Message<"metalstack.admin.v2.TokenServic
  */
 export declare const TokenServiceRevokeRequestSchema: GenMessage<TokenServiceRevokeRequest>;
 /**
- * TokenServiceRevokeResponse is the response payload for the token revoke request
+ * TokenServiceRevokeResponse is the response payload for revoking a token.
  *
  * @generated from message metalstack.admin.v2.TokenServiceRevokeResponse
  */
@@ -77,7 +77,7 @@ export type TokenServiceRevokeResponse = Message<"metalstack.admin.v2.TokenServi
  */
 export declare const TokenServiceRevokeResponseSchema: GenMessage<TokenServiceRevokeResponse>;
 /**
- * TokenServiceCreateRequest is the request payload to create a token
+ * TokenServiceCreateRequest is the request payload for creating a token.
  *
  * @generated from message metalstack.admin.v2.TokenServiceCreateRequest
  */
@@ -101,19 +101,19 @@ export type TokenServiceCreateRequest = Message<"metalstack.admin.v2.TokenServic
  */
 export declare const TokenServiceCreateRequestSchema: GenMessage<TokenServiceCreateRequest>;
 /**
- * TokenServiceCreateResponse is the response payload of a token create request
+ * TokenServiceCreateResponse is the response payload for creating a token.
  *
  * @generated from message metalstack.admin.v2.TokenServiceCreateResponse
  */
 export type TokenServiceCreateResponse = Message<"metalstack.admin.v2.TokenServiceCreateResponse"> & {
     /**
-     * Token which was created
+     * Token contains the created token
      *
      * @generated from field: metalstack.api.v2.Token token = 1;
      */
     token?: Token;
     /**
-     * Secret is the body if the jwt token, should be used in api requests as bearer token
+     * Secret is the body if the JWT token, should be used in API requests as bearer token
      *
      * @generated from field: string secret = 2;
      */
@@ -125,13 +125,13 @@ export type TokenServiceCreateResponse = Message<"metalstack.admin.v2.TokenServi
  */
 export declare const TokenServiceCreateResponseSchema: GenMessage<TokenServiceCreateResponse>;
 /**
- * TokenService serves token related functions
+ * TokenService provides token management operations.
  *
  * @generated from service metalstack.admin.v2.TokenService
  */
 export declare const TokenService: GenService<{
     /**
-     * List tokens
+     * Returns the list of tokens for a user.
      *
      * @generated from rpc metalstack.admin.v2.TokenService.List
      */
@@ -141,7 +141,7 @@ export declare const TokenService: GenService<{
         output: typeof TokenServiceListResponseSchema;
     };
     /**
-     * Revoke a token
+     * Revokes a token.
      *
      * @generated from rpc metalstack.admin.v2.TokenService.Revoke
      */
@@ -151,7 +151,7 @@ export declare const TokenService: GenService<{
         output: typeof TokenServiceRevokeResponseSchema;
     };
     /**
-     * Create a token to authenticate against the platform, the secret will be only visible in the response.
+     * Creates a token to authenticate against the platform, the secret will be only visible in the response.
      * This service is suitable to create tokens for other users instead of deriving users from tokens directly.
      *
      * @generated from rpc metalstack.admin.v2.TokenService.Create
diff --git a/js/metalstack/admin/v2/token_pb.js b/js/metalstack/admin/v2/token_pb.js
index b7463da2..70c642c1 100644
--- a/js/metalstack/admin/v2/token_pb.js
+++ b/js/metalstack/admin/v2/token_pb.js
@@ -40,7 +40,7 @@ export const TokenServiceCreateRequestSchema = /*@__PURE__*/ messageDesc(file_me
  */
 export const TokenServiceCreateResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_token, 5);
 /**
- * TokenService serves token related functions
+ * TokenService provides token management operations.
  *
  * @generated from service metalstack.admin.v2.TokenService
  */
diff --git a/js/metalstack/admin/v2/token_pb.ts b/js/metalstack/admin/v2/token_pb.ts
index 449166ed..5609a872 100644
--- a/js/metalstack/admin/v2/token_pb.ts
+++ b/js/metalstack/admin/v2/token_pb.ts
@@ -17,7 +17,7 @@ export const file_metalstack_admin_v2_token: GenFile = /*@__PURE__*/
   fileDesc("Ch9tZXRhbHN0YWNrL2FkbWluL3YyL3Rva2VuLnByb3RvEhNtZXRhbHN0YWNrLmFkbWluLnYyIjUKF1Rva2VuU2VydmljZUxpc3RSZXF1ZXN0EhEKBHVzZXIYASABKAlIAIgBAUIHCgVfdXNlciJEChhUb2tlblNlcnZpY2VMaXN0UmVzcG9uc2USKAoGdG9rZW5zGAEgAygLMhgubWV0YWxzdGFjay5hcGkudjIuVG9rZW4iTQoZVG9rZW5TZXJ2aWNlUmV2b2tlUmVxdWVzdBIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIYCgR1c2VyGAIgASgJQgq6SAdyBRACGIAEIhwKGlRva2VuU2VydmljZVJldm9rZVJlc3BvbnNlIo8BChlUb2tlblNlcnZpY2VDcmVhdGVSZXF1ZXN0Eh0KBHVzZXIYASABKAlCCrpIB3IFEAIYgARIAIgBARJKChR0b2tlbl9jcmVhdGVfcmVxdWVzdBgCIAEoCzIsLm1ldGFsc3RhY2suYXBpLnYyLlRva2VuU2VydmljZUNyZWF0ZVJlcXVlc3RCBwoFX3VzZXIiVQoaVG9rZW5TZXJ2aWNlQ3JlYXRlUmVzcG9uc2USJwoFdG9rZW4YASABKAsyGC5tZXRhbHN0YWNrLmFwaS52Mi5Ub2tlbhIOCgZzZWNyZXQYAiABKAky3wIKDFRva2VuU2VydmljZRJrCgRMaXN0EiwubWV0YWxzdGFjay5hZG1pbi52Mi5Ub2tlblNlcnZpY2VMaXN0UmVxdWVzdBotLm1ldGFsc3RhY2suYWRtaW4udjIuVG9rZW5TZXJ2aWNlTGlzdFJlc3BvbnNlIgbS8xgCAQIScAoGUmV2b2tlEi4ubWV0YWxzdGFjay5hZG1pbi52Mi5Ub2tlblNlcnZpY2VSZXZva2VSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hZG1pbi52Mi5Ub2tlblNlcnZpY2VSZXZva2VSZXNwb25zZSIF0vMYAQEScAoGQ3JlYXRlEi4ubWV0YWxzdGFjay5hZG1pbi52Mi5Ub2tlblNlcnZpY2VDcmVhdGVSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hZG1pbi52Mi5Ub2tlblNlcnZpY2VDcmVhdGVSZXNwb25zZSIF0vMYAQFCzgEKF2NvbS5tZXRhbHN0YWNrLmFkbWluLnYyQgpUb2tlblByb3RvUAFaOWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYWRtaW4vdjI7YWRtaW52MqICA01BWKoCE01ldGFsc3RhY2suQWRtaW4uVjLKAhNNZXRhbHN0YWNrXEFkbWluXFYy4gIfTWV0YWxzdGFja1xBZG1pblxWMlxHUEJNZXRhZGF0YeoCFU1ldGFsc3RhY2s6OkFkbWluOjpWMmIGcHJvdG8z", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_token]);
 
 /**
- * TokenServiceListRequest is the request payload for the token list request
+ * TokenServiceListRequest is the request payload for listing tokens.
  *
  * @generated from message metalstack.admin.v2.TokenServiceListRequest
  */
@@ -38,13 +38,13 @@ export const TokenServiceListRequestSchema: GenMessage<TokenServiceListRequest>
   messageDesc(file_metalstack_admin_v2_token, 0);
 
 /**
- * TokenServiceListResponse is the response payload for the token list request
+ * TokenServiceListResponse is the response payload for listing tokens.
  *
  * @generated from message metalstack.admin.v2.TokenServiceListResponse
  */
 export type TokenServiceListResponse = Message<"metalstack.admin.v2.TokenServiceListResponse"> & {
   /**
-   * Tokens is the list of tokens
+   * Tokens contains the list of tokens
    *
    * @generated from field: repeated metalstack.api.v2.Token tokens = 1;
    */
@@ -59,7 +59,7 @@ export const TokenServiceListResponseSchema: GenMessage<TokenServiceListResponse
   messageDesc(file_metalstack_admin_v2_token, 1);
 
 /**
- * TokenServiceRevokeRequest is the request payload for the token revoke request
+ * TokenServiceRevokeRequest is the request payload for revoking a token.
  *
  * @generated from message metalstack.admin.v2.TokenServiceRevokeRequest
  */
@@ -87,7 +87,7 @@ export const TokenServiceRevokeRequestSchema: GenMessage<TokenServiceRevokeReque
   messageDesc(file_metalstack_admin_v2_token, 2);
 
 /**
- * TokenServiceRevokeResponse is the response payload for the token revoke request
+ * TokenServiceRevokeResponse is the response payload for revoking a token.
  *
  * @generated from message metalstack.admin.v2.TokenServiceRevokeResponse
  */
@@ -102,7 +102,7 @@ export const TokenServiceRevokeResponseSchema: GenMessage<TokenServiceRevokeResp
   messageDesc(file_metalstack_admin_v2_token, 3);
 
 /**
- * TokenServiceCreateRequest is the request payload to create a token
+ * TokenServiceCreateRequest is the request payload for creating a token.
  *
  * @generated from message metalstack.admin.v2.TokenServiceCreateRequest
  */
@@ -130,20 +130,20 @@ export const TokenServiceCreateRequestSchema: GenMessage<TokenServiceCreateReque
   messageDesc(file_metalstack_admin_v2_token, 4);
 
 /**
- * TokenServiceCreateResponse is the response payload of a token create request
+ * TokenServiceCreateResponse is the response payload for creating a token.
  *
  * @generated from message metalstack.admin.v2.TokenServiceCreateResponse
  */
 export type TokenServiceCreateResponse = Message<"metalstack.admin.v2.TokenServiceCreateResponse"> & {
   /**
-   * Token which was created
+   * Token contains the created token
    *
    * @generated from field: metalstack.api.v2.Token token = 1;
    */
   token?: Token;
 
   /**
-   * Secret is the body if the jwt token, should be used in api requests as bearer token
+   * Secret is the body if the JWT token, should be used in API requests as bearer token
    *
    * @generated from field: string secret = 2;
    */
@@ -158,13 +158,13 @@ export const TokenServiceCreateResponseSchema: GenMessage<TokenServiceCreateResp
   messageDesc(file_metalstack_admin_v2_token, 5);
 
 /**
- * TokenService serves token related functions
+ * TokenService provides token management operations.
  *
  * @generated from service metalstack.admin.v2.TokenService
  */
 export const TokenService: GenService<{
   /**
-   * List tokens
+   * Returns the list of tokens for a user.
    *
    * @generated from rpc metalstack.admin.v2.TokenService.List
    */
@@ -174,7 +174,7 @@ export const TokenService: GenService<{
     output: typeof TokenServiceListResponseSchema;
   },
   /**
-   * Revoke a token
+   * Revokes a token.
    *
    * @generated from rpc metalstack.admin.v2.TokenService.Revoke
    */
@@ -184,7 +184,7 @@ export const TokenService: GenService<{
     output: typeof TokenServiceRevokeResponseSchema;
   },
   /**
-   * Create a token to authenticate against the platform, the secret will be only visible in the response.
+   * Creates a token to authenticate against the platform, the secret will be only visible in the response.
    * This service is suitable to create tokens for other users instead of deriving users from tokens directly.
    *
    * @generated from rpc metalstack.admin.v2.TokenService.Create
diff --git a/js/metalstack/admin/v2/vpn_pb.d.ts b/js/metalstack/admin/v2/vpn_pb.d.ts
index fa0a5aed..5472029f 100644
--- a/js/metalstack/admin/v2/vpn_pb.d.ts
+++ b/js/metalstack/admin/v2/vpn_pb.d.ts
@@ -7,32 +7,32 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_admin_v2_vpn: GenFile;
 /**
- * VPNServiceAuthKeyRequest is the request payload for a vpn authkey request.
+ * VPNServiceAuthKeyRequest is the request payload for generating a VPN authentication key.
  *
  * @generated from message metalstack.admin.v2.VPNServiceAuthKeyRequest
  */
 export type VPNServiceAuthKeyRequest = Message<"metalstack.admin.v2.VPNServiceAuthKeyRequest"> & {
     /**
-     * Project for which a vpn authkey should be generated.
+     * Project for which a VPN authentication key should be generated
      *
      * @generated from field: string project = 1;
      */
     project: string;
     /**
-     * Ephemeral defines if the authkey should be ephemeral.
+     * Ephemeral defines if the authentication key should be ephemeral
      *
      * @generated from field: bool ephemeral = 2;
      */
     ephemeral: boolean;
     /**
-     * Expires defines the duration after which the authkey expires.
+     * Expires defines the duration after which the authentication key expires
      *
      * @generated from field: google.protobuf.Duration expires = 3;
      */
     expires?: Duration;
     /**
-     * Reason must be provided why access to the vpn is requested
-     * reason is only forwarded to a audit sink
+     * Reason must be provided why access to the VPN is requested
+     * Reason is only forwarded to an audit sink
      *
      * @generated from field: string reason = 4;
      */
@@ -44,38 +44,38 @@ export type VPNServiceAuthKeyRequest = Message<"metalstack.admin.v2.VPNServiceAu
  */
 export declare const VPNServiceAuthKeyRequestSchema: GenMessage<VPNServiceAuthKeyRequest>;
 /**
- * VPNServiceAuthKeyResponse is the request payload for a authkey response
+ * VPNServiceAuthKeyResponse is the response payload for generating a VPN authentication key.
  *
  * @generated from message metalstack.admin.v2.VPNServiceAuthKeyResponse
  */
 export type VPNServiceAuthKeyResponse = Message<"metalstack.admin.v2.VPNServiceAuthKeyResponse"> & {
     /**
-     * Address is the address of the vpn control plane.
+     * Address is the address of the VPN control plane
      *
      * @generated from field: string address = 1;
      */
     address: string;
     /**
-     * AuthKey is the key to connect to the vpn at the given address.
-     * This key can only be seen once.
+     * AuthKey is the key to connect to the VPN at the given address
+     * This key can only be seen once
      *
      * @generated from field: string auth_key = 2;
      */
     authKey: string;
     /**
-     * Ephemeral defines if the authkey should be ephemeral.
+     * Ephemeral defines if the authentication key should be ephemeral
      *
      * @generated from field: bool ephemeral = 3;
      */
     ephemeral: boolean;
     /**
-     * ExpiresAt this key cannot be used after this timestamp.
+     * ExpiresAt this key cannot be used after this timestamp
      *
      * @generated from field: google.protobuf.Timestamp expires_at = 4;
      */
     expiresAt?: Timestamp;
     /**
-     * CreatedAt this key was created at this timestamp.
+     * CreatedAt this key was created at this timestamp
      *
      * @generated from field: google.protobuf.Timestamp created_at = 5;
      */
@@ -87,13 +87,13 @@ export type VPNServiceAuthKeyResponse = Message<"metalstack.admin.v2.VPNServiceA
  */
 export declare const VPNServiceAuthKeyResponseSchema: GenMessage<VPNServiceAuthKeyResponse>;
 /**
- * VPNServiceListNodesRequest is the request payload for a vpn list nodes request
+ * VPNServiceListNodesRequest is the request payload for listing VPN nodes.
  *
  * @generated from message metalstack.admin.v2.VPNServiceListNodesRequest
  */
 export type VPNServiceListNodesRequest = Message<"metalstack.admin.v2.VPNServiceListNodesRequest"> & {
     /**
-     * Project if given only nodes of this user are returned
+     * Project filters nodes by this project
      *
      * @generated from field: optional string project = 1;
      */
@@ -105,13 +105,13 @@ export type VPNServiceListNodesRequest = Message<"metalstack.admin.v2.VPNService
  */
 export declare const VPNServiceListNodesRequestSchema: GenMessage<VPNServiceListNodesRequest>;
 /**
- * VPNServiceListNodesResponse is the response payload for a vpn list nodes request
+ * VPNServiceListNodesResponse is the response payload for listing VPN nodes.
  *
  * @generated from message metalstack.admin.v2.VPNServiceListNodesResponse
  */
 export type VPNServiceListNodesResponse = Message<"metalstack.admin.v2.VPNServiceListNodesResponse"> & {
     /**
-     * Nodes connected to the vpn
+     * Nodes connected to the VPN
      *
      * @generated from field: repeated metalstack.api.v2.VPNNode nodes = 1;
      */
@@ -123,13 +123,13 @@ export type VPNServiceListNodesResponse = Message<"metalstack.admin.v2.VPNServic
  */
 export declare const VPNServiceListNodesResponseSchema: GenMessage<VPNServiceListNodesResponse>;
 /**
- * VPNService serves vpn related functions
+ * VPNService provides VPN management operations.
  *
  * @generated from service metalstack.admin.v2.VPNService
  */
 export declare const VPNService: GenService<{
     /**
-     * AuthKey generates a authkey for a project to join a machine to the project vpn
+     * GenerateAuthKey generates an authentication key for a project to join a machine to the project VPN.
      *
      * @generated from rpc metalstack.admin.v2.VPNService.AuthKey
      */
@@ -139,7 +139,7 @@ export declare const VPNService: GenService<{
         output: typeof VPNServiceAuthKeyResponseSchema;
     };
     /**
-     * ListNodes returns a list of machines actually connected to the vpn
+     * Returns the list of machines connected to the VPN.
      *
      * @generated from rpc metalstack.admin.v2.VPNService.ListNodes
      */
diff --git a/js/metalstack/admin/v2/vpn_pb.js b/js/metalstack/admin/v2/vpn_pb.js
index eddbaefe..272db427 100644
--- a/js/metalstack/admin/v2/vpn_pb.js
+++ b/js/metalstack/admin/v2/vpn_pb.js
@@ -31,7 +31,7 @@ export const VPNServiceListNodesRequestSchema = /*@__PURE__*/ messageDesc(file_m
  */
 export const VPNServiceListNodesResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_admin_v2_vpn, 3);
 /**
- * VPNService serves vpn related functions
+ * VPNService provides VPN management operations.
  *
  * @generated from service metalstack.admin.v2.VPNService
  */
diff --git a/js/metalstack/admin/v2/vpn_pb.ts b/js/metalstack/admin/v2/vpn_pb.ts
index 1d0db216..3166b55f 100644
--- a/js/metalstack/admin/v2/vpn_pb.ts
+++ b/js/metalstack/admin/v2/vpn_pb.ts
@@ -19,35 +19,35 @@ export const file_metalstack_admin_v2_vpn: GenFile = /*@__PURE__*/
   fileDesc("Ch1tZXRhbHN0YWNrL2FkbWluL3YyL3Zwbi5wcm90bxITbWV0YWxzdGFjay5hZG1pbi52MiKQAQoYVlBOU2VydmljZUF1dGhLZXlSZXF1ZXN0EhkKB3Byb2plY3QYASABKAlCCLpIBXIDsAEBEhEKCWVwaGVtZXJhbBgCIAEoCBIqCgdleHBpcmVzGAMgASgLMhkuZ29vZ2xlLnByb3RvYnVmLkR1cmF0aW9uEhoKBnJlYXNvbhgEIAEoCUIKukgHcgUQChiABCKxAQoZVlBOU2VydmljZUF1dGhLZXlSZXNwb25zZRIPCgdhZGRyZXNzGAEgASgJEhAKCGF1dGhfa2V5GAIgASgJEhEKCWVwaGVtZXJhbBgDIAEoCBIuCgpleHBpcmVzX2F0GAQgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIuCgpjcmVhdGVkX2F0GAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcCI+ChpWUE5TZXJ2aWNlTGlzdE5vZGVzUmVxdWVzdBIUCgdwcm9qZWN0GAEgASgJSACIAQFCCgoIX3Byb2plY3QiSAobVlBOU2VydmljZUxpc3ROb2Rlc1Jlc3BvbnNlEikKBW5vZGVzGAEgAygLMhoubWV0YWxzdGFjay5hcGkudjIuVlBOTm9kZTL1AQoKVlBOU2VydmljZRJvCgdBdXRoS2V5Ei0ubWV0YWxzdGFjay5hZG1pbi52Mi5WUE5TZXJ2aWNlQXV0aEtleVJlcXVlc3QaLi5tZXRhbHN0YWNrLmFkbWluLnYyLlZQTlNlcnZpY2VBdXRoS2V5UmVzcG9uc2UiBdLzGAEBEnYKCUxpc3ROb2RlcxIvLm1ldGFsc3RhY2suYWRtaW4udjIuVlBOU2VydmljZUxpc3ROb2Rlc1JlcXVlc3QaMC5tZXRhbHN0YWNrLmFkbWluLnYyLlZQTlNlcnZpY2VMaXN0Tm9kZXNSZXNwb25zZSIG0vMYAgECQswBChdjb20ubWV0YWxzdGFjay5hZG1pbi52MkIIVnBuUHJvdG9QAVo5Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9hZG1pbi92MjthZG1pbnYyogIDTUFYqgITTWV0YWxzdGFjay5BZG1pbi5WMsoCE01ldGFsc3RhY2tcQWRtaW5cVjLiAh9NZXRhbHN0YWNrXEFkbWluXFYyXEdQQk1ldGFkYXRh6gIVTWV0YWxzdGFjazo6QWRtaW46OlYyYgZwcm90bzM", [file_buf_validate_validate, file_google_protobuf_duration, file_google_protobuf_timestamp, file_metalstack_api_v2_common, file_metalstack_api_v2_vpn]);
 
 /**
- * VPNServiceAuthKeyRequest is the request payload for a vpn authkey request.
+ * VPNServiceAuthKeyRequest is the request payload for generating a VPN authentication key.
  *
  * @generated from message metalstack.admin.v2.VPNServiceAuthKeyRequest
  */
 export type VPNServiceAuthKeyRequest = Message<"metalstack.admin.v2.VPNServiceAuthKeyRequest"> & {
   /**
-   * Project for which a vpn authkey should be generated.
+   * Project for which a VPN authentication key should be generated
    *
    * @generated from field: string project = 1;
    */
   project: string;
 
   /**
-   * Ephemeral defines if the authkey should be ephemeral.
+   * Ephemeral defines if the authentication key should be ephemeral
    *
    * @generated from field: bool ephemeral = 2;
    */
   ephemeral: boolean;
 
   /**
-   * Expires defines the duration after which the authkey expires.
+   * Expires defines the duration after which the authentication key expires
    *
    * @generated from field: google.protobuf.Duration expires = 3;
    */
   expires?: Duration;
 
   /**
-   * Reason must be provided why access to the vpn is requested
-   * reason is only forwarded to a audit sink
+   * Reason must be provided why access to the VPN is requested
+   * Reason is only forwarded to an audit sink
    *
    * @generated from field: string reason = 4;
    */
@@ -62,42 +62,42 @@ export const VPNServiceAuthKeyRequestSchema: GenMessage<VPNServiceAuthKeyRequest
   messageDesc(file_metalstack_admin_v2_vpn, 0);
 
 /**
- * VPNServiceAuthKeyResponse is the request payload for a authkey response
+ * VPNServiceAuthKeyResponse is the response payload for generating a VPN authentication key.
  *
  * @generated from message metalstack.admin.v2.VPNServiceAuthKeyResponse
  */
 export type VPNServiceAuthKeyResponse = Message<"metalstack.admin.v2.VPNServiceAuthKeyResponse"> & {
   /**
-   * Address is the address of the vpn control plane.
+   * Address is the address of the VPN control plane
    *
    * @generated from field: string address = 1;
    */
   address: string;
 
   /**
-   * AuthKey is the key to connect to the vpn at the given address.
-   * This key can only be seen once.
+   * AuthKey is the key to connect to the VPN at the given address
+   * This key can only be seen once
    *
    * @generated from field: string auth_key = 2;
    */
   authKey: string;
 
   /**
-   * Ephemeral defines if the authkey should be ephemeral.
+   * Ephemeral defines if the authentication key should be ephemeral
    *
    * @generated from field: bool ephemeral = 3;
    */
   ephemeral: boolean;
 
   /**
-   * ExpiresAt this key cannot be used after this timestamp.
+   * ExpiresAt this key cannot be used after this timestamp
    *
    * @generated from field: google.protobuf.Timestamp expires_at = 4;
    */
   expiresAt?: Timestamp;
 
   /**
-   * CreatedAt this key was created at this timestamp.
+   * CreatedAt this key was created at this timestamp
    *
    * @generated from field: google.protobuf.Timestamp created_at = 5;
    */
@@ -112,13 +112,13 @@ export const VPNServiceAuthKeyResponseSchema: GenMessage<VPNServiceAuthKeyRespon
   messageDesc(file_metalstack_admin_v2_vpn, 1);
 
 /**
- * VPNServiceListNodesRequest is the request payload for a vpn list nodes request
+ * VPNServiceListNodesRequest is the request payload for listing VPN nodes.
  *
  * @generated from message metalstack.admin.v2.VPNServiceListNodesRequest
  */
 export type VPNServiceListNodesRequest = Message<"metalstack.admin.v2.VPNServiceListNodesRequest"> & {
   /**
-   * Project if given only nodes of this user are returned
+   * Project filters nodes by this project
    *
    * @generated from field: optional string project = 1;
    */
@@ -133,13 +133,13 @@ export const VPNServiceListNodesRequestSchema: GenMessage<VPNServiceListNodesReq
   messageDesc(file_metalstack_admin_v2_vpn, 2);
 
 /**
- * VPNServiceListNodesResponse is the response payload for a vpn list nodes request
+ * VPNServiceListNodesResponse is the response payload for listing VPN nodes.
  *
  * @generated from message metalstack.admin.v2.VPNServiceListNodesResponse
  */
 export type VPNServiceListNodesResponse = Message<"metalstack.admin.v2.VPNServiceListNodesResponse"> & {
   /**
-   * Nodes connected to the vpn
+   * Nodes connected to the VPN
    *
    * @generated from field: repeated metalstack.api.v2.VPNNode nodes = 1;
    */
@@ -154,13 +154,13 @@ export const VPNServiceListNodesResponseSchema: GenMessage<VPNServiceListNodesRe
   messageDesc(file_metalstack_admin_v2_vpn, 3);
 
 /**
- * VPNService serves vpn related functions
+ * VPNService provides VPN management operations.
  *
  * @generated from service metalstack.admin.v2.VPNService
  */
 export const VPNService: GenService<{
   /**
-   * AuthKey generates a authkey for a project to join a machine to the project vpn
+   * GenerateAuthKey generates an authentication key for a project to join a machine to the project VPN.
    *
    * @generated from rpc metalstack.admin.v2.VPNService.AuthKey
    */
@@ -170,7 +170,7 @@ export const VPNService: GenService<{
     output: typeof VPNServiceAuthKeyResponseSchema;
   },
   /**
-   * ListNodes returns a list of machines actually connected to the vpn
+   * Returns the list of machines connected to the VPN.
    *
    * @generated from rpc metalstack.admin.v2.VPNService.ListNodes
    */
diff --git a/js/metalstack/api/v2/audit_pb.d.ts b/js/metalstack/api/v2/audit_pb.d.ts
index bd437adb..948c7289 100644
--- a/js/metalstack/api/v2/audit_pb.d.ts
+++ b/js/metalstack/api/v2/audit_pb.d.ts
@@ -6,7 +6,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_api_v2_audit: GenFile;
 /**
- * AuditTrace is an audit trace
+ * AuditTrace is an audit trace.
  *
  * @generated from message metalstack.api.v2.AuditTrace
  */
@@ -18,49 +18,49 @@ export type AuditTrace = Message<"metalstack.api.v2.AuditTrace"> & {
      */
     uuid: string;
     /**
-     * Timestamp is the timestamp when the request arrived at the api
+     * Timestamp is the timestamp when the request arrived at the API
      *
      * @generated from field: google.protobuf.Timestamp timestamp = 2;
      */
     timestamp?: Timestamp;
     /**
-     * User is the login user who called the api method
+     * User is the login user who called the API method
      *
      * @generated from field: string user = 3;
      */
     user: string;
     /**
-     * Tenant is the tenant targeted by the api call
+     * Tenant is the tenant targeted by the API call
      *
      * @generated from field: string tenant = 4;
      */
     tenant: string;
     /**
-     * Project is the project targeted by the api call
+     * Project is the project targeted by the API call
      *
      * @generated from field: optional string project = 5;
      */
     project?: string;
     /**
-     * Method is the api method that was called
+     * Method is the API method that was called
      *
      * @generated from field: string method = 6;
      */
     method: string;
     /**
-     * Body is the payload of the api call. In the request phase this contains the payload sent by the client, in the request phase it contains the payload returned by the api server
+     * Body is the payload of the API call. In the request phase this contains the payload sent by the client, in the response phase it contains the payload returned by the API server
      *
      * @generated from field: optional string body = 7;
      */
     body?: string;
     /**
-     * Source IP contains the source ip address of the api call
+     * SourceIP contains the source IP address of the API call
      *
      * @generated from field: string source_ip = 8;
      */
     sourceIp: string;
     /**
-     * Result Code is a status code describing the result of the api call. It is set for traces in the response phase and contains official gRPC status codes
+     * ResultCode is a status code describing the result of the API call. It is set for traces in the response phase and contains official gRPC status codes
      *
      * @generated from field: optional int32 result_code = 9;
      */
@@ -246,7 +246,7 @@ export type AuditServiceGetResponse = Message<"metalstack.api.v2.AuditServiceGet
  */
 export declare const AuditServiceGetResponseSchema: GenMessage<AuditServiceGetResponse>;
 /**
- * AuditPhase specifies phase of an audit trace
+ * AuditPhase specifies the phase of an audit trace.
  *
  * @generated from enum metalstack.api.v2.AuditPhase
  */
@@ -264,7 +264,7 @@ export declare enum AuditPhase {
      */
     REQUEST = 1,
     /**
-     * AUDIT_PHASE_REQUEST defines an audit trace in the response phase
+     * AUDIT_PHASE_RESPONSE defines an audit trace in the response phase
      *
      * @generated from enum value: AUDIT_PHASE_RESPONSE = 2;
      */
@@ -275,13 +275,13 @@ export declare enum AuditPhase {
  */
 export declare const AuditPhaseSchema: GenEnum<AuditPhase>;
 /**
- * AuditService serves audit related functions
+ * AuditService provides audit logging operations.
  *
  * @generated from service metalstack.api.v2.AuditService
  */
 export declare const AuditService: GenService<{
     /**
-     * Get an audit trace
+     * Returns the audit trace with the specified UUID.
      *
      * @generated from rpc metalstack.api.v2.AuditService.Get
      */
@@ -291,7 +291,7 @@ export declare const AuditService: GenService<{
         output: typeof AuditServiceGetResponseSchema;
     };
     /**
-     * List audit traces
+     * Returns the list of audit traces.
      *
      * @generated from rpc metalstack.api.v2.AuditService.List
      */
diff --git a/js/metalstack/api/v2/audit_pb.js b/js/metalstack/api/v2/audit_pb.js
index 81d5761e..1500569b 100644
--- a/js/metalstack/api/v2/audit_pb.js
+++ b/js/metalstack/api/v2/audit_pb.js
@@ -41,7 +41,7 @@ export const AuditServiceGetRequestSchema = /*@__PURE__*/ messageDesc(file_metal
  */
 export const AuditServiceGetResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_api_v2_audit, 5);
 /**
- * AuditPhase specifies phase of an audit trace
+ * AuditPhase specifies the phase of an audit trace.
  *
  * @generated from enum metalstack.api.v2.AuditPhase
  */
@@ -60,7 +60,7 @@ export var AuditPhase;
      */
     AuditPhase[AuditPhase["REQUEST"] = 1] = "REQUEST";
     /**
-     * AUDIT_PHASE_REQUEST defines an audit trace in the response phase
+     * AUDIT_PHASE_RESPONSE defines an audit trace in the response phase
      *
      * @generated from enum value: AUDIT_PHASE_RESPONSE = 2;
      */
@@ -71,7 +71,7 @@ export var AuditPhase;
  */
 export const AuditPhaseSchema = /*@__PURE__*/ enumDesc(file_metalstack_api_v2_audit, 0);
 /**
- * AuditService serves audit related functions
+ * AuditService provides audit logging operations.
  *
  * @generated from service metalstack.api.v2.AuditService
  */
diff --git a/js/metalstack/api/v2/audit_pb.ts b/js/metalstack/api/v2/audit_pb.ts
index 38adf518..f8349535 100644
--- a/js/metalstack/api/v2/audit_pb.ts
+++ b/js/metalstack/api/v2/audit_pb.ts
@@ -18,7 +18,7 @@ export const file_metalstack_api_v2_audit: GenFile = /*@__PURE__*/
   fileDesc("Ch1tZXRhbHN0YWNrL2FwaS92Mi9hdWRpdC5wcm90bxIRbWV0YWxzdGFjay5hcGkudjIiqgIKCkF1ZGl0VHJhY2USFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESLQoJdGltZXN0YW1wGAIgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIMCgR1c2VyGAMgASgJEg4KBnRlbmFudBgEIAEoCRIUCgdwcm9qZWN0GAUgASgJSACIAQESDgoGbWV0aG9kGAYgASgJEhEKBGJvZHkYByABKAlIAYgBARIRCglzb3VyY2VfaXAYCCABKAkSGAoLcmVzdWx0X2NvZGUYCSABKAVIAogBARIsCgVwaGFzZRgKIAEoDjIdLm1ldGFsc3RhY2suYXBpLnYyLkF1ZGl0UGhhc2VCCgoIX3Byb2plY3RCBwoFX2JvZHlCDgoMX3Jlc3VsdF9jb2RlIpoECgpBdWRpdFF1ZXJ5EhsKBHV1aWQYAiABKAlCCLpIBXIDsAEBSACIAQESLQoEZnJvbRgDIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBIAYgBARIrCgJ0bxgEIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXBIAogBARIeCgR1c2VyGAUgASgJQgu6SAhyBsCzrrECAUgDiAEBEh4KB3Byb2plY3QYBiABKAlCCLpIBXIDsAEBSASIAQESHwoGbWV0aG9kGAcgASgJQgq6SAdyBRACGIACSAWIAQESHwoJc291cmNlX2lwGAggASgJQge6SARyAnABSAaIAQESIQoLcmVzdWx0X2NvZGUYCSABKAVCB7pIBBoCKABIB4gBARIdCgRib2R5GAogASgJQgq6SAdyBRACGIACSAiIAQESHgoFbGltaXQYCyABKAVCCrpIBxoFGOgHIABICYgBARI7CgVwaGFzZRgMIAEoDjIdLm1ldGFsc3RhY2suYXBpLnYyLkF1ZGl0UGhhc2VCCLpIBYIBAhABSAqIAQFCBwoFX3V1aWRCBwoFX2Zyb21CBQoDX3RvQgcKBV91c2VyQgoKCF9wcm9qZWN0QgkKB19tZXRob2RCDAoKX3NvdXJjZV9pcEIOCgxfcmVzdWx0X2NvZGVCBwoFX2JvZHlCCAoGX2xpbWl0QggKBl9waGFzZSJjChdBdWRpdFNlcnZpY2VMaXN0UmVxdWVzdBIaCgVsb2dpbhgBIAEoCUILukgIcgbAs66xAgESLAoFcXVlcnkYAiABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5BdWRpdFF1ZXJ5IkkKGEF1ZGl0U2VydmljZUxpc3RSZXNwb25zZRItCgZ0cmFjZXMYASADKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5BdWRpdFRyYWNlIpMBChZBdWRpdFNlcnZpY2VHZXRSZXF1ZXN0EhoKBWxvZ2luGAEgASgJQgu6SAhyBsCzrrECARIWCgR1dWlkGAIgASgJQgi6SAVyA7ABARI7CgVwaGFzZRgDIAEoDjIdLm1ldGFsc3RhY2suYXBpLnYyLkF1ZGl0UGhhc2VCCLpIBYIBAhABSACIAQFCCAoGX3BoYXNlIkcKF0F1ZGl0U2VydmljZUdldFJlc3BvbnNlEiwKBXRyYWNlGAEgASgLMh0ubWV0YWxzdGFjay5hcGkudjIuQXVkaXRUcmFjZSpcCgpBdWRpdFBoYXNlEhsKF0FVRElUX1BIQVNFX1VOU1BFQ0lGSUVEEAASFwoTQVVESVRfUEhBU0VfUkVRVUVTVBABEhgKFEFVRElUX1BIQVNFX1JFU1BPTlNFEAIy4wEKDEF1ZGl0U2VydmljZRJnCgNHZXQSKS5tZXRhbHN0YWNrLmFwaS52Mi5BdWRpdFNlcnZpY2VHZXRSZXF1ZXN0GioubWV0YWxzdGFjay5hcGkudjIuQXVkaXRTZXJ2aWNlR2V0UmVzcG9uc2UiCcLzGAEB4PMYAhJqCgRMaXN0EioubWV0YWxzdGFjay5hcGkudjIuQXVkaXRTZXJ2aWNlTGlzdFJlcXVlc3QaKy5tZXRhbHN0YWNrLmFwaS52Mi5BdWRpdFNlcnZpY2VMaXN0UmVzcG9uc2UiCcLzGAEB4PMYAkLAAQoVY29tLm1ldGFsc3RhY2suYXBpLnYyQgpBdWRpdFByb3RvUAFaNWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYXBpL3YyO2FwaXYyogIDTUFYqgIRTWV0YWxzdGFjay5BcGkuVjLKAhFNZXRhbHN0YWNrXEFwaVxWMuICHU1ldGFsc3RhY2tcQXBpXFYyXEdQQk1ldGFkYXRh6gITTWV0YWxzdGFjazo6QXBpOjpWMmIGcHJvdG8z", [file_buf_validate_validate, file_google_protobuf_timestamp, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules]);
 
 /**
- * AuditTrace is an audit trace
+ * AuditTrace is an audit trace.
  *
  * @generated from message metalstack.api.v2.AuditTrace
  */
@@ -31,56 +31,56 @@ export type AuditTrace = Message<"metalstack.api.v2.AuditTrace"> & {
   uuid: string;
 
   /**
-   * Timestamp is the timestamp when the request arrived at the api
+   * Timestamp is the timestamp when the request arrived at the API
    *
    * @generated from field: google.protobuf.Timestamp timestamp = 2;
    */
   timestamp?: Timestamp;
 
   /**
-   * User is the login user who called the api method
+   * User is the login user who called the API method
    *
    * @generated from field: string user = 3;
    */
   user: string;
 
   /**
-   * Tenant is the tenant targeted by the api call
+   * Tenant is the tenant targeted by the API call
    *
    * @generated from field: string tenant = 4;
    */
   tenant: string;
 
   /**
-   * Project is the project targeted by the api call
+   * Project is the project targeted by the API call
    *
    * @generated from field: optional string project = 5;
    */
   project?: string;
 
   /**
-   * Method is the api method that was called
+   * Method is the API method that was called
    *
    * @generated from field: string method = 6;
    */
   method: string;
 
   /**
-   * Body is the payload of the api call. In the request phase this contains the payload sent by the client, in the request phase it contains the payload returned by the api server
+   * Body is the payload of the API call. In the request phase this contains the payload sent by the client, in the response phase it contains the payload returned by the API server
    *
    * @generated from field: optional string body = 7;
    */
   body?: string;
 
   /**
-   * Source IP contains the source ip address of the api call
+   * SourceIP contains the source IP address of the API call
    *
    * @generated from field: string source_ip = 8;
    */
   sourceIp: string;
 
   /**
-   * Result Code is a status code describing the result of the api call. It is set for traces in the response phase and contains official gRPC status codes
+   * ResultCode is a status code describing the result of the API call. It is set for traces in the response phase and contains official gRPC status codes
    *
    * @generated from field: optional int32 result_code = 9;
    */
@@ -298,7 +298,7 @@ export const AuditServiceGetResponseSchema: GenMessage<AuditServiceGetResponse>
   messageDesc(file_metalstack_api_v2_audit, 5);
 
 /**
- * AuditPhase specifies phase of an audit trace
+ * AuditPhase specifies the phase of an audit trace.
  *
  * @generated from enum metalstack.api.v2.AuditPhase
  */
@@ -318,7 +318,7 @@ export enum AuditPhase {
   REQUEST = 1,
 
   /**
-   * AUDIT_PHASE_REQUEST defines an audit trace in the response phase
+   * AUDIT_PHASE_RESPONSE defines an audit trace in the response phase
    *
    * @generated from enum value: AUDIT_PHASE_RESPONSE = 2;
    */
@@ -332,13 +332,13 @@ export const AuditPhaseSchema: GenEnum<AuditPhase> = /*@__PURE__*/
   enumDesc(file_metalstack_api_v2_audit, 0);
 
 /**
- * AuditService serves audit related functions
+ * AuditService provides audit logging operations.
  *
  * @generated from service metalstack.api.v2.AuditService
  */
 export const AuditService: GenService<{
   /**
-   * Get an audit trace
+   * Returns the audit trace with the specified UUID.
    *
    * @generated from rpc metalstack.api.v2.AuditService.Get
    */
@@ -348,7 +348,7 @@ export const AuditService: GenService<{
     output: typeof AuditServiceGetResponseSchema;
   },
   /**
-   * List audit traces
+   * Returns the list of audit traces.
    *
    * @generated from rpc metalstack.api.v2.AuditService.List
    */
diff --git a/js/metalstack/api/v2/filesystem_pb.d.ts b/js/metalstack/api/v2/filesystem_pb.d.ts
index 4e880c6d..d782a0fe 100644
--- a/js/metalstack/api/v2/filesystem_pb.d.ts
+++ b/js/metalstack/api/v2/filesystem_pb.d.ts
@@ -666,13 +666,13 @@ export declare enum RaidLevel {
  */
 export declare const RaidLevelSchema: GenEnum<RaidLevel>;
 /**
- * FilesystemService serves filesystem related functions
+ * FilesystemService provides filesystem management operations.
  *
  * @generated from service metalstack.api.v2.FilesystemService
  */
 export declare const FilesystemService: GenService<{
     /**
-     * Get a filesystem
+     * Returns the filesystem with the specified ID.
      *
      * @generated from rpc metalstack.api.v2.FilesystemService.Get
      */
@@ -682,7 +682,7 @@ export declare const FilesystemService: GenService<{
         output: typeof FilesystemServiceGetResponseSchema;
     };
     /**
-     * List all filesystems
+     * Returns the list of all filesystems.
      *
      * @generated from rpc metalstack.api.v2.FilesystemService.List
      */
@@ -692,7 +692,7 @@ export declare const FilesystemService: GenService<{
         output: typeof FilesystemServiceListResponseSchema;
     };
     /**
-     * Match a filesystems
+     * Matches a filesystem to a size and image or machine.
      *
      * @generated from rpc metalstack.api.v2.FilesystemService.Match
      */
diff --git a/js/metalstack/api/v2/filesystem_pb.js b/js/metalstack/api/v2/filesystem_pb.js
index 218444e9..a90c15b9 100644
--- a/js/metalstack/api/v2/filesystem_pb.js
+++ b/js/metalstack/api/v2/filesystem_pb.js
@@ -252,7 +252,7 @@ export var RaidLevel;
  */
 export const RaidLevelSchema = /*@__PURE__*/ enumDesc(file_metalstack_api_v2_filesystem, 3);
 /**
- * FilesystemService serves filesystem related functions
+ * FilesystemService provides filesystem management operations.
  *
  * @generated from service metalstack.api.v2.FilesystemService
  */
diff --git a/js/metalstack/api/v2/filesystem_pb.ts b/js/metalstack/api/v2/filesystem_pb.ts
index 964a1832..9d21217d 100644
--- a/js/metalstack/api/v2/filesystem_pb.ts
+++ b/js/metalstack/api/v2/filesystem_pb.ts
@@ -779,13 +779,13 @@ export const RaidLevelSchema: GenEnum<RaidLevel> = /*@__PURE__*/
   enumDesc(file_metalstack_api_v2_filesystem, 3);
 
 /**
- * FilesystemService serves filesystem related functions
+ * FilesystemService provides filesystem management operations.
  *
  * @generated from service metalstack.api.v2.FilesystemService
  */
 export const FilesystemService: GenService<{
   /**
-   * Get a filesystem
+   * Returns the filesystem with the specified ID.
    *
    * @generated from rpc metalstack.api.v2.FilesystemService.Get
    */
@@ -795,7 +795,7 @@ export const FilesystemService: GenService<{
     output: typeof FilesystemServiceGetResponseSchema;
   },
   /**
-   * List all filesystems
+   * Returns the list of all filesystems.
    *
    * @generated from rpc metalstack.api.v2.FilesystemService.List
    */
@@ -805,7 +805,7 @@ export const FilesystemService: GenService<{
     output: typeof FilesystemServiceListResponseSchema;
   },
   /**
-   * Match a filesystems
+   * Matches a filesystem to a size and image or machine.
    *
    * @generated from rpc metalstack.api.v2.FilesystemService.Match
    */
diff --git a/js/metalstack/api/v2/health_pb.d.ts b/js/metalstack/api/v2/health_pb.d.ts
index 7e5c0ef4..86c959a4 100644
--- a/js/metalstack/api/v2/health_pb.d.ts
+++ b/js/metalstack/api/v2/health_pb.d.ts
@@ -5,13 +5,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_api_v2_health: GenFile;
 /**
- * Health reports the health status of all services
+ * Health reports the health status of all services.
  *
  * @generated from message metalstack.api.v2.Health
  */
 export type Health = Message<"metalstack.api.v2.Health"> & {
     /**
-     * Services the health of all individual services
+     * Services contains the health of all individual services
      *
      * @generated from field: repeated metalstack.api.v2.HealthStatus services = 1;
      */
@@ -23,19 +23,19 @@ export type Health = Message<"metalstack.api.v2.Health"> & {
  */
 export declare const HealthSchema: GenMessage<Health>;
 /**
- * HealthStatus the health of one service
+ * HealthStatus represents the health status of one service.
  *
  * @generated from message metalstack.api.v2.HealthStatus
  */
 export type HealthStatus = Message<"metalstack.api.v2.HealthStatus"> & {
     /**
-     * Name the name of the service
+     * Name is the name of the service
      *
      * @generated from field: metalstack.api.v2.Service name = 1;
      */
     name: Service;
     /**
-     * Status the status of this service
+     * Status is the status of this service
      *
      * @generated from field: metalstack.api.v2.ServiceStatus status = 2;
      */
@@ -61,13 +61,13 @@ export type HealthStatus = Message<"metalstack.api.v2.HealthStatus"> & {
  */
 export declare const HealthStatusSchema: GenMessage<HealthStatus>;
 /**
- * PartitionHealth the status of a specific service in this partition
+ * PartitionHealth represents the status of a specific service in this partition.
  *
  * @generated from message metalstack.api.v2.PartitionHealth
  */
 export type PartitionHealth = Message<"metalstack.api.v2.PartitionHealth"> & {
     /**
-     * Status the health status of the service in this partition
+     * Status is the health status of the service in this partition
      *
      * @generated from field: metalstack.api.v2.ServiceStatus status = 1;
      */
@@ -85,7 +85,7 @@ export type PartitionHealth = Message<"metalstack.api.v2.PartitionHealth"> & {
  */
 export declare const PartitionHealthSchema: GenMessage<PartitionHealth>;
 /**
- * HealthServiceGetRequest is request payload to get the health of the system
+ * HealthServiceGetRequest is the request payload for getting the health of the system.
  *
  * @generated from message metalstack.api.v2.HealthServiceGetRequest
  */
@@ -96,13 +96,13 @@ export type HealthServiceGetRequest = Message<"metalstack.api.v2.HealthServiceGe
  */
 export declare const HealthServiceGetRequestSchema: GenMessage<HealthServiceGetRequest>;
 /**
- * HealthServiceGetRequest is the response payload with the health of the system
+ * HealthServiceGetResponse is the response payload for getting the health of the system.
  *
  * @generated from message metalstack.api.v2.HealthServiceGetResponse
  */
 export type HealthServiceGetResponse = Message<"metalstack.api.v2.HealthServiceGetResponse"> & {
     /**
-     * Health is the overall health of the system
+     * Health contains the overall health of the system
      *
      * @generated from field: metalstack.api.v2.Health health = 1;
      */
@@ -114,7 +114,7 @@ export type HealthServiceGetResponse = Message<"metalstack.api.v2.HealthServiceG
  */
 export declare const HealthServiceGetResponseSchema: GenMessage<HealthServiceGetResponse>;
 /**
- * ServiceStatus defines the status of a service
+ * ServiceStatus defines the status of a service.
  *
  * @generated from enum metalstack.api.v2.ServiceStatus
  */
@@ -138,7 +138,7 @@ export declare enum ServiceStatus {
      */
     UNHEALTHY = 2,
     /**
-     * SERVICE_STATUS_HEALTHY the service is in healthy status e.g. fully functional
+     * SERVICE_STATUS_HEALTHY the service is in healthy status, for example fully functional
      *
      * @generated from enum value: SERVICE_STATUS_HEALTHY = 3;
      */
@@ -149,7 +149,7 @@ export declare enum ServiceStatus {
  */
 export declare const ServiceStatusSchema: GenEnum<ServiceStatus>;
 /**
- * Service defines the service for which the healtyness is reported
+ * Service defines the service for which the healthiness is reported.
  *
  * @generated from enum metalstack.api.v2.Service
  */
@@ -161,19 +161,19 @@ export declare enum Service {
      */
     UNSPECIFIED = 0,
     /**
-     * SERVICE_IPAM the ipam service
+     * SERVICE_IPAM the IPAM service
      *
      * @generated from enum value: SERVICE_IPAM = 1;
      */
     IPAM = 1,
     /**
-     * SERVICE_RETHINK the rethinkdb
+     * SERVICE_RETHINK the RethinkDB
      *
      * @generated from enum value: SERVICE_RETHINK = 2;
      */
     RETHINK = 2,
     /**
-     * SERVICE_MASTERDATA the masterdata-api
+     * SERVICE_MASTERDATA the masterdata API
      *
      * @generated from enum value: SERVICE_MASTERDATA = 3;
      */
@@ -191,13 +191,13 @@ export declare enum Service {
      */
     AUDIT = 5,
     /**
-     * SERVICE_VPN the vpn service
+     * SERVICE_VPN the VPN service
      *
      * @generated from enum value: SERVICE_VPN = 6;
      */
     VPN = 6,
     /**
-     * SERVICE_REDIS the redis service
+     * SERVICE_REDIS the Redis service
      *
      * @generated from enum value: SERVICE_REDIS = 7;
      */
@@ -214,13 +214,13 @@ export declare enum Service {
  */
 export declare const ServiceSchema: GenEnum<Service>;
 /**
- * HealthService serves health related functions
+ * HealthService provides health status monitoring operations.
  *
  * @generated from service metalstack.api.v2.HealthService
  */
 export declare const HealthService: GenService<{
     /**
-     * Get the health of the platform
+     * Returns the health status of the platform.
      *
      * @generated from rpc metalstack.api.v2.HealthService.Get
      */
diff --git a/js/metalstack/api/v2/health_pb.js b/js/metalstack/api/v2/health_pb.js
index 653461b6..160e0d20 100644
--- a/js/metalstack/api/v2/health_pb.js
+++ b/js/metalstack/api/v2/health_pb.js
@@ -33,7 +33,7 @@ export const HealthServiceGetRequestSchema = /*@__PURE__*/ messageDesc(file_meta
  */
 export const HealthServiceGetResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_api_v2_health, 4);
 /**
- * ServiceStatus defines the status of a service
+ * ServiceStatus defines the status of a service.
  *
  * @generated from enum metalstack.api.v2.ServiceStatus
  */
@@ -58,7 +58,7 @@ export var ServiceStatus;
      */
     ServiceStatus[ServiceStatus["UNHEALTHY"] = 2] = "UNHEALTHY";
     /**
-     * SERVICE_STATUS_HEALTHY the service is in healthy status e.g. fully functional
+     * SERVICE_STATUS_HEALTHY the service is in healthy status, for example fully functional
      *
      * @generated from enum value: SERVICE_STATUS_HEALTHY = 3;
      */
@@ -69,7 +69,7 @@ export var ServiceStatus;
  */
 export const ServiceStatusSchema = /*@__PURE__*/ enumDesc(file_metalstack_api_v2_health, 0);
 /**
- * Service defines the service for which the healtyness is reported
+ * Service defines the service for which the healthiness is reported.
  *
  * @generated from enum metalstack.api.v2.Service
  */
@@ -82,19 +82,19 @@ export var Service;
      */
     Service[Service["UNSPECIFIED"] = 0] = "UNSPECIFIED";
     /**
-     * SERVICE_IPAM the ipam service
+     * SERVICE_IPAM the IPAM service
      *
      * @generated from enum value: SERVICE_IPAM = 1;
      */
     Service[Service["IPAM"] = 1] = "IPAM";
     /**
-     * SERVICE_RETHINK the rethinkdb
+     * SERVICE_RETHINK the RethinkDB
      *
      * @generated from enum value: SERVICE_RETHINK = 2;
      */
     Service[Service["RETHINK"] = 2] = "RETHINK";
     /**
-     * SERVICE_MASTERDATA the masterdata-api
+     * SERVICE_MASTERDATA the masterdata API
      *
      * @generated from enum value: SERVICE_MASTERDATA = 3;
      */
@@ -112,13 +112,13 @@ export var Service;
      */
     Service[Service["AUDIT"] = 5] = "AUDIT";
     /**
-     * SERVICE_VPN the vpn service
+     * SERVICE_VPN the VPN service
      *
      * @generated from enum value: SERVICE_VPN = 6;
      */
     Service[Service["VPN"] = 6] = "VPN";
     /**
-     * SERVICE_REDIS the redis service
+     * SERVICE_REDIS the Redis service
      *
      * @generated from enum value: SERVICE_REDIS = 7;
      */
@@ -135,7 +135,7 @@ export var Service;
  */
 export const ServiceSchema = /*@__PURE__*/ enumDesc(file_metalstack_api_v2_health, 1);
 /**
- * HealthService serves health related functions
+ * HealthService provides health status monitoring operations.
  *
  * @generated from service metalstack.api.v2.HealthService
  */
diff --git a/js/metalstack/api/v2/health_pb.ts b/js/metalstack/api/v2/health_pb.ts
index b7351bfc..0b813250 100644
--- a/js/metalstack/api/v2/health_pb.ts
+++ b/js/metalstack/api/v2/health_pb.ts
@@ -14,13 +14,13 @@ export const file_metalstack_api_v2_health: GenFile = /*@__PURE__*/
   fileDesc("Ch5tZXRhbHN0YWNrL2FwaS92Mi9oZWFsdGgucHJvdG8SEW1ldGFsc3RhY2suYXBpLnYyIjsKBkhlYWx0aBIxCghzZXJ2aWNlcxgBIAMoCzIfLm1ldGFsc3RhY2suYXBpLnYyLkhlYWx0aFN0YXR1cyKXAgoMSGVhbHRoU3RhdHVzEigKBG5hbWUYASABKA4yGi5tZXRhbHN0YWNrLmFwaS52Mi5TZXJ2aWNlEjAKBnN0YXR1cxgCIAEoDjIgLm1ldGFsc3RhY2suYXBpLnYyLlNlcnZpY2VTdGF0dXMSDwoHbWVzc2FnZRgDIAEoCRJDCgpwYXJ0aXRpb25zGAQgAygLMi8ubWV0YWxzdGFjay5hcGkudjIuSGVhbHRoU3RhdHVzLlBhcnRpdGlvbnNFbnRyeRpVCg9QYXJ0aXRpb25zRW50cnkSCwoDa2V5GAEgASgJEjEKBXZhbHVlGAIgASgLMiIubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uSGVhbHRoOgI4ASJUCg9QYXJ0aXRpb25IZWFsdGgSMAoGc3RhdHVzGAEgASgOMiAubWV0YWxzdGFjay5hcGkudjIuU2VydmljZVN0YXR1cxIPCgdtZXNzYWdlGAIgASgJIhkKF0hlYWx0aFNlcnZpY2VHZXRSZXF1ZXN0IkUKGEhlYWx0aFNlcnZpY2VHZXRSZXNwb25zZRIpCgZoZWFsdGgYASABKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5IZWFsdGgqhgEKDVNlcnZpY2VTdGF0dXMSHgoaU0VSVklDRV9TVEFUVVNfVU5TUEVDSUZJRUQQABIbChdTRVJWSUNFX1NUQVRVU19ERUdSQURFRBABEhwKGFNFUlZJQ0VfU1RBVFVTX1VOSEVBTFRIWRACEhoKFlNFUlZJQ0VfU1RBVFVTX0hFQUxUSFkQAyqiAgoHU2VydmljZRIXChNTRVJWSUNFX1VOU1BFQ0lGSUVEEAASGgoMU0VSVklDRV9JUEFNEAEaCIKyGQRpcGFtEiIKD1NFUlZJQ0VfUkVUSElOSxACGg2CshkJcmV0aGlua2RiEiYKElNFUlZJQ0VfTUFTVEVSREFUQRADGg6CshkKbWFzdGVyZGF0YRIiChBTRVJWSUNFX01BQ0hJTkVTEAQaDIKyGQhtYWNoaW5lcxIcCg1TRVJWSUNFX0FVRElUEAUaCYKyGQVhdWRpdBIYCgtTRVJWSUNFX1ZQThAGGgeCshkDdnBuEhwKDVNFUlZJQ0VfUkVESVMQBxoJgrIZBXJlZGlzEhwKDVNFUlZJQ0VfVEFTS1MQCBoJgrIZBXRhc2tzMnkKDUhlYWx0aFNlcnZpY2USaAoDR2V0EioubWV0YWxzdGFjay5hcGkudjIuSGVhbHRoU2VydmljZUdldFJlcXVlc3QaKy5tZXRhbHN0YWNrLmFwaS52Mi5IZWFsdGhTZXJ2aWNlR2V0UmVzcG9uc2UiCNjzGAHg8xgCQsEBChVjb20ubWV0YWxzdGFjay5hcGkudjJCC0hlYWx0aFByb3RvUAFaNWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYXBpL3YyO2FwaXYyogIDTUFYqgIRTWV0YWxzdGFjay5BcGkuVjLKAhFNZXRhbHN0YWNrXEFwaVxWMuICHU1ldGFsc3RhY2tcQXBpXFYyXEdQQk1ldGFkYXRh6gITTWV0YWxzdGFjazo6QXBpOjpWMmIGcHJvdG8z", [file_metalstack_api_v2_common]);
 
 /**
- * Health reports the health status of all services
+ * Health reports the health status of all services.
  *
  * @generated from message metalstack.api.v2.Health
  */
 export type Health = Message<"metalstack.api.v2.Health"> & {
   /**
-   * Services the health of all individual services
+   * Services contains the health of all individual services
    *
    * @generated from field: repeated metalstack.api.v2.HealthStatus services = 1;
    */
@@ -35,20 +35,20 @@ export const HealthSchema: GenMessage<Health> = /*@__PURE__*/
   messageDesc(file_metalstack_api_v2_health, 0);
 
 /**
- * HealthStatus the health of one service
+ * HealthStatus represents the health status of one service.
  *
  * @generated from message metalstack.api.v2.HealthStatus
  */
 export type HealthStatus = Message<"metalstack.api.v2.HealthStatus"> & {
   /**
-   * Name the name of the service
+   * Name is the name of the service
    *
    * @generated from field: metalstack.api.v2.Service name = 1;
    */
   name: Service;
 
   /**
-   * Status the status of this service
+   * Status is the status of this service
    *
    * @generated from field: metalstack.api.v2.ServiceStatus status = 2;
    */
@@ -77,13 +77,13 @@ export const HealthStatusSchema: GenMessage<HealthStatus> = /*@__PURE__*/
   messageDesc(file_metalstack_api_v2_health, 1);
 
 /**
- * PartitionHealth the status of a specific service in this partition
+ * PartitionHealth represents the status of a specific service in this partition.
  *
  * @generated from message metalstack.api.v2.PartitionHealth
  */
 export type PartitionHealth = Message<"metalstack.api.v2.PartitionHealth"> & {
   /**
-   * Status the health status of the service in this partition
+   * Status is the health status of the service in this partition
    *
    * @generated from field: metalstack.api.v2.ServiceStatus status = 1;
    */
@@ -105,7 +105,7 @@ export const PartitionHealthSchema: GenMessage<PartitionHealth> = /*@__PURE__*/
   messageDesc(file_metalstack_api_v2_health, 2);
 
 /**
- * HealthServiceGetRequest is request payload to get the health of the system
+ * HealthServiceGetRequest is the request payload for getting the health of the system.
  *
  * @generated from message metalstack.api.v2.HealthServiceGetRequest
  */
@@ -120,13 +120,13 @@ export const HealthServiceGetRequestSchema: GenMessage<HealthServiceGetRequest>
   messageDesc(file_metalstack_api_v2_health, 3);
 
 /**
- * HealthServiceGetRequest is the response payload with the health of the system
+ * HealthServiceGetResponse is the response payload for getting the health of the system.
  *
  * @generated from message metalstack.api.v2.HealthServiceGetResponse
  */
 export type HealthServiceGetResponse = Message<"metalstack.api.v2.HealthServiceGetResponse"> & {
   /**
-   * Health is the overall health of the system
+   * Health contains the overall health of the system
    *
    * @generated from field: metalstack.api.v2.Health health = 1;
    */
@@ -141,7 +141,7 @@ export const HealthServiceGetResponseSchema: GenMessage<HealthServiceGetResponse
   messageDesc(file_metalstack_api_v2_health, 4);
 
 /**
- * ServiceStatus defines the status of a service
+ * ServiceStatus defines the status of a service.
  *
  * @generated from enum metalstack.api.v2.ServiceStatus
  */
@@ -168,7 +168,7 @@ export enum ServiceStatus {
   UNHEALTHY = 2,
 
   /**
-   * SERVICE_STATUS_HEALTHY the service is in healthy status e.g. fully functional
+   * SERVICE_STATUS_HEALTHY the service is in healthy status, for example fully functional
    *
    * @generated from enum value: SERVICE_STATUS_HEALTHY = 3;
    */
@@ -182,7 +182,7 @@ export const ServiceStatusSchema: GenEnum<ServiceStatus> = /*@__PURE__*/
   enumDesc(file_metalstack_api_v2_health, 0);
 
 /**
- * Service defines the service for which the healtyness is reported
+ * Service defines the service for which the healthiness is reported.
  *
  * @generated from enum metalstack.api.v2.Service
  */
@@ -195,21 +195,21 @@ export enum Service {
   UNSPECIFIED = 0,
 
   /**
-   * SERVICE_IPAM the ipam service
+   * SERVICE_IPAM the IPAM service
    *
    * @generated from enum value: SERVICE_IPAM = 1;
    */
   IPAM = 1,
 
   /**
-   * SERVICE_RETHINK the rethinkdb
+   * SERVICE_RETHINK the RethinkDB
    *
    * @generated from enum value: SERVICE_RETHINK = 2;
    */
   RETHINK = 2,
 
   /**
-   * SERVICE_MASTERDATA the masterdata-api
+   * SERVICE_MASTERDATA the masterdata API
    *
    * @generated from enum value: SERVICE_MASTERDATA = 3;
    */
@@ -230,14 +230,14 @@ export enum Service {
   AUDIT = 5,
 
   /**
-   * SERVICE_VPN the vpn service
+   * SERVICE_VPN the VPN service
    *
    * @generated from enum value: SERVICE_VPN = 6;
    */
   VPN = 6,
 
   /**
-   * SERVICE_REDIS the redis service
+   * SERVICE_REDIS the Redis service
    *
    * @generated from enum value: SERVICE_REDIS = 7;
    */
@@ -258,13 +258,13 @@ export const ServiceSchema: GenEnum<Service> = /*@__PURE__*/
   enumDesc(file_metalstack_api_v2_health, 1);
 
 /**
- * HealthService serves health related functions
+ * HealthService provides health status monitoring operations.
  *
  * @generated from service metalstack.api.v2.HealthService
  */
 export const HealthService: GenService<{
   /**
-   * Get the health of the platform
+   * Returns the health status of the platform.
    *
    * @generated from rpc metalstack.api.v2.HealthService.Get
    */
diff --git a/js/metalstack/api/v2/image_pb.d.ts b/js/metalstack/api/v2/image_pb.d.ts
index 3e7564a0..710db5cc 100644
--- a/js/metalstack/api/v2/image_pb.d.ts
+++ b/js/metalstack/api/v2/image_pb.d.ts
@@ -330,13 +330,13 @@ export declare enum ImageClassification {
  */
 export declare const ImageClassificationSchema: GenEnum<ImageClassification>;
 /**
- * ImageService serves image related functions
+ * ImageService provides image management operations.
  *
  * @generated from service metalstack.api.v2.ImageService
  */
 export declare const ImageService: GenService<{
     /**
-     * Get a image
+     * Returns the image with the specified ID.
      *
      * @generated from rpc metalstack.api.v2.ImageService.Get
      */
@@ -346,7 +346,7 @@ export declare const ImageService: GenService<{
         output: typeof ImageServiceGetResponseSchema;
     };
     /**
-     * List all images
+     * Returns the list of all images.
      *
      * @generated from rpc metalstack.api.v2.ImageService.List
      */
@@ -356,7 +356,7 @@ export declare const ImageService: GenService<{
         output: typeof ImageServiceListResponseSchema;
     };
     /**
-     * Latest image for a specific os
+     * Returns the latest image for a specific operating system.
      *
      * @generated from rpc metalstack.api.v2.ImageService.Latest
      */
diff --git a/js/metalstack/api/v2/image_pb.js b/js/metalstack/api/v2/image_pb.js
index 2e58d8e1..88a81836 100644
--- a/js/metalstack/api/v2/image_pb.js
+++ b/js/metalstack/api/v2/image_pb.js
@@ -122,7 +122,7 @@ export var ImageClassification;
  */
 export const ImageClassificationSchema = /*@__PURE__*/ enumDesc(file_metalstack_api_v2_image, 1);
 /**
- * ImageService serves image related functions
+ * ImageService provides image management operations.
  *
  * @generated from service metalstack.api.v2.ImageService
  */
diff --git a/js/metalstack/api/v2/image_pb.ts b/js/metalstack/api/v2/image_pb.ts
index 6df06378..20d00fe2 100644
--- a/js/metalstack/api/v2/image_pb.ts
+++ b/js/metalstack/api/v2/image_pb.ts
@@ -396,13 +396,13 @@ export const ImageClassificationSchema: GenEnum<ImageClassification> = /*@__PURE
   enumDesc(file_metalstack_api_v2_image, 1);
 
 /**
- * ImageService serves image related functions
+ * ImageService provides image management operations.
  *
  * @generated from service metalstack.api.v2.ImageService
  */
 export const ImageService: GenService<{
   /**
-   * Get a image
+   * Returns the image with the specified ID.
    *
    * @generated from rpc metalstack.api.v2.ImageService.Get
    */
@@ -412,7 +412,7 @@ export const ImageService: GenService<{
     output: typeof ImageServiceGetResponseSchema;
   },
   /**
-   * List all images
+   * Returns the list of all images.
    *
    * @generated from rpc metalstack.api.v2.ImageService.List
    */
@@ -422,7 +422,7 @@ export const ImageService: GenService<{
     output: typeof ImageServiceListResponseSchema;
   },
   /**
-   * Latest image for a specific os
+   * Returns the latest image for a specific operating system.
    *
    * @generated from rpc metalstack.api.v2.ImageService.Latest
    */
diff --git a/js/metalstack/api/v2/ip_pb.d.ts b/js/metalstack/api/v2/ip_pb.d.ts
index 847e82ab..75529998 100644
--- a/js/metalstack/api/v2/ip_pb.d.ts
+++ b/js/metalstack/api/v2/ip_pb.d.ts
@@ -497,13 +497,13 @@ export declare enum IPAddressFamily {
  */
 export declare const IPAddressFamilySchema: GenEnum<IPAddressFamily>;
 /**
- * IPService serves ip address related functions
+ * IPService provides IP address management operations.
  *
  * @generated from service metalstack.api.v2.IPService
  */
 export declare const IPService: GenService<{
     /**
-     * Get a ip
+     * Returns the IP address with the specified IP.
      *
      * @generated from rpc metalstack.api.v2.IPService.Get
      */
@@ -513,7 +513,7 @@ export declare const IPService: GenService<{
         output: typeof IPServiceGetResponseSchema;
     };
     /**
-     * Create a ip
+     * Creates a new IP address.
      *
      * @generated from rpc metalstack.api.v2.IPService.Create
      */
@@ -523,7 +523,7 @@ export declare const IPService: GenService<{
         output: typeof IPServiceCreateResponseSchema;
     };
     /**
-     * Update a ip
+     * Updates an IP address.
      *
      * @generated from rpc metalstack.api.v2.IPService.Update
      */
@@ -533,7 +533,7 @@ export declare const IPService: GenService<{
         output: typeof IPServiceUpdateResponseSchema;
     };
     /**
-     * List all ips
+     * Returns the list of all IP addresses.
      *
      * @generated from rpc metalstack.api.v2.IPService.List
      */
@@ -543,7 +543,7 @@ export declare const IPService: GenService<{
         output: typeof IPServiceListResponseSchema;
     };
     /**
-     * Delete a ip
+     * Deletes an IP address.
      *
      * @generated from rpc metalstack.api.v2.IPService.Delete
      */
diff --git a/js/metalstack/api/v2/ip_pb.js b/js/metalstack/api/v2/ip_pb.js
index 4f243980..b27f5cda 100644
--- a/js/metalstack/api/v2/ip_pb.js
+++ b/js/metalstack/api/v2/ip_pb.js
@@ -130,7 +130,7 @@ export var IPAddressFamily;
  */
 export const IPAddressFamilySchema = /*@__PURE__*/ enumDesc(file_metalstack_api_v2_ip, 1);
 /**
- * IPService serves ip address related functions
+ * IPService provides IP address management operations.
  *
  * @generated from service metalstack.api.v2.IPService
  */
diff --git a/js/metalstack/api/v2/ip_pb.ts b/js/metalstack/api/v2/ip_pb.ts
index 49e5ffc4..d2cfc9be 100644
--- a/js/metalstack/api/v2/ip_pb.ts
+++ b/js/metalstack/api/v2/ip_pb.ts
@@ -590,13 +590,13 @@ export const IPAddressFamilySchema: GenEnum<IPAddressFamily> = /*@__PURE__*/
   enumDesc(file_metalstack_api_v2_ip, 1);
 
 /**
- * IPService serves ip address related functions
+ * IPService provides IP address management operations.
  *
  * @generated from service metalstack.api.v2.IPService
  */
 export const IPService: GenService<{
   /**
-   * Get a ip
+   * Returns the IP address with the specified IP.
    *
    * @generated from rpc metalstack.api.v2.IPService.Get
    */
@@ -606,7 +606,7 @@ export const IPService: GenService<{
     output: typeof IPServiceGetResponseSchema;
   },
   /**
-   * Create a ip
+   * Creates a new IP address.
    *
    * @generated from rpc metalstack.api.v2.IPService.Create
    */
@@ -616,7 +616,7 @@ export const IPService: GenService<{
     output: typeof IPServiceCreateResponseSchema;
   },
   /**
-   * Update a ip
+   * Updates an IP address.
    *
    * @generated from rpc metalstack.api.v2.IPService.Update
    */
@@ -626,7 +626,7 @@ export const IPService: GenService<{
     output: typeof IPServiceUpdateResponseSchema;
   },
   /**
-   * List all ips
+   * Returns the list of all IP addresses.
    *
    * @generated from rpc metalstack.api.v2.IPService.List
    */
@@ -636,7 +636,7 @@ export const IPService: GenService<{
     output: typeof IPServiceListResponseSchema;
   },
   /**
-   * Delete a ip
+   * Deletes an IP address.
    *
    * @generated from rpc metalstack.api.v2.IPService.Delete
    */
diff --git a/js/metalstack/api/v2/machine_pb.d.ts b/js/metalstack/api/v2/machine_pb.d.ts
index 6b72b621..17645089 100644
--- a/js/metalstack/api/v2/machine_pb.d.ts
+++ b/js/metalstack/api/v2/machine_pb.d.ts
@@ -2237,13 +2237,13 @@ export declare enum MachineBMCCommand {
  */
 export declare const MachineBMCCommandSchema: GenEnum<MachineBMCCommand>;
 /**
- * MachineService serves machine related functions
+ * MachineService provides machine lifecycle management operations.
  *
  * @generated from service metalstack.api.v2.MachineService
  */
 export declare const MachineService: GenService<{
     /**
-     * Get a machine
+     * Returns the machine with the specified UUID.
      *
      * @generated from rpc metalstack.api.v2.MachineService.Get
      */
@@ -2253,7 +2253,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceGetResponseSchema;
     };
     /**
-     * Create a machine
+     * Creates a new machine.
      *
      * @generated from rpc metalstack.api.v2.MachineService.Create
      */
@@ -2263,7 +2263,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceCreateResponseSchema;
     };
     /**
-     * Update a machine
+     * Updates a machine.
      *
      * @generated from rpc metalstack.api.v2.MachineService.Update
      */
@@ -2273,7 +2273,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceUpdateResponseSchema;
     };
     /**
-     * List all machines
+     * Returns the list of all machines.
      *
      * @generated from rpc metalstack.api.v2.MachineService.List
      */
@@ -2283,7 +2283,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceListResponseSchema;
     };
     /**
-     * Delete a machine
+     * Deletes a machine.
      *
      * @generated from rpc metalstack.api.v2.MachineService.Delete
      */
@@ -2293,7 +2293,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceDeleteResponseSchema;
     };
     /**
-     * BMCCommand send a command to the bmc of a machine
+     * BMCCommand sends a command to the BMC of a machine.
      *
      * @generated from rpc metalstack.api.v2.MachineService.BMCCommand
      */
@@ -2303,7 +2303,7 @@ export declare const MachineService: GenService<{
         output: typeof MachineServiceBMCCommandResponseSchema;
     };
     /**
-     * GetBMC returns the BMC details of a machine
+     * Returns the BMC details of a machine.
      *
      * @generated from rpc metalstack.api.v2.MachineService.GetBMC
      */
diff --git a/js/metalstack/api/v2/machine_pb.js b/js/metalstack/api/v2/machine_pb.js
index 1ab1a5a2..927a1575 100644
--- a/js/metalstack/api/v2/machine_pb.js
+++ b/js/metalstack/api/v2/machine_pb.js
@@ -14,7 +14,7 @@ import { file_metalstack_api_v2_size } from "./size_pb";
 /**
  * Describes the file metalstack/api/v2/machine.proto.
  */
-export const file_metalstack_api_v2_machine = /*@__PURE__*/ fileDesc("Ch9tZXRhbHN0YWNrL2FwaS92Mi9tYWNoaW5lLnByb3RvEhFtZXRhbHN0YWNrLmFwaS52MiJNChhNYWNoaW5lU2VydmljZUdldFJlcXVlc3QSFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESGQoHcHJvamVjdBgCIAEoCUIIukgFcgOwAQEiSAoZTWFjaGluZVNlcnZpY2VHZXRSZXNwb25zZRIrCgdtYWNoaW5lGAEgASgLMhoubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZSKLBwobTWFjaGluZVNlcnZpY2VDcmVhdGVSZXF1ZXN0EhkKB3Byb2plY3QYASABKAlCCLpIBXIDsAEBEhsKBHV1aWQYAiABKAlCCLpIBXIDsAEBSACIAQESGQoEbmFtZRgDIAEoCUILukgIcgbAs66xAgESJQoLZGVzY3JpcHRpb24YBCABKAlCC7pICHIGyLOusQIBSAGIAQESHgoIaG9zdG5hbWUYBSABKAlCB7pIBHICaAFIAogBARIeCglwYXJ0aXRpb24YBiABKAlCC7pICHIG0LOusQIBEhYKBHNpemUYByABKAlCCLpIBXIDGIABEhcKBWltYWdlGAggASgJQgi6SAVyAxiAARIeChFmaWxlc3lzdGVtX2xheW91dBgJIAEoCUgDiAEBEjAKD3NzaF9wdWJsaWNfa2V5cxgKIAMoCUIXukgUkgERyKSzsQIBEDIiB3IFEAEYgEASJgoIdXNlcmRhdGEYCyABKAlCD7pIDHIK8LOusQIBGICAAkgEiAEBEikKBmxhYmVscxgMIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLkxhYmVscxI9CghuZXR3b3JrcxgNIAMoCzIrLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uTmV0d29yaxIzCgNpcHMYDiADKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQWxsb2NhdGlvbklwEiAKDnBsYWNlbWVudF90YWdzGA8gAygJQgi6SAWSAQIQQBI7CgtkbnNfc2VydmVycxgQIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYESADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEksKD2FsbG9jYXRpb25fdHlwZRgSIAEoDjIoLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uVHlwZUIIukgFggECEAESNgoNZmlyZXdhbGxfc3BlYxgTIAEoCzIfLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsU3BlY0IHCgVfdXVpZEIOCgxfZGVzY3JpcHRpb25CCwoJX2hvc3RuYW1lQhQKEl9maWxlc3lzdGVtX2xheW91dEILCglfdXNlcmRhdGEiSAoMRmlyZXdhbGxTcGVjEjgKDmZpcmV3YWxsX3J1bGVzGAEgASgLMiAubWV0YWxzdGFjay5hcGkudjIuRmlyZXdhbGxSdWxlcyJLChxNYWNoaW5lU2VydmljZUNyZWF0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIrYCChtNYWNoaW5lU2VydmljZVVwZGF0ZVJlcXVlc3QSFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESOgoLdXBkYXRlX21ldGEYAiABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5VcGRhdGVNZXRhQga6SAPIAQESGQoHcHJvamVjdBgDIAEoCUIIukgFcgOwAQESJQoLZGVzY3JpcHRpb24YBCABKAlCC7pICHIGyLOusQIBSACIAQESNAoGbGFiZWxzGAUgASgLMh8ubWV0YWxzdGFjay5hcGkudjIuVXBkYXRlTGFiZWxzSAGIAQESMAoPc3NoX3B1YmxpY19rZXlzGAYgAygJQhe6SBSSARHIpLOxAgEQMiIHcgUQARiAQEIOCgxfZGVzY3JpcHRpb25CCQoHX2xhYmVscyJLChxNYWNoaW5lU2VydmljZVVwZGF0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lImYKGU1hY2hpbmVTZXJ2aWNlTGlzdFJlcXVlc3QSGQoHcHJvamVjdBgBIAEoCUIIukgFcgOwAQESLgoFcXVlcnkYAiABKAsyHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUXVlcnkiSgoaTWFjaGluZVNlcnZpY2VMaXN0UmVzcG9uc2USLAoIbWFjaGluZXMYASADKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIlAKG01hY2hpbmVTZXJ2aWNlRGVsZXRlUmVxdWVzdBIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIZCgdwcm9qZWN0GAIgASgJQgi6SAVyA7ABASJLChxNYWNoaW5lU2VydmljZURlbGV0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIpUBCh9NYWNoaW5lU2VydmljZUJNQ0NvbW1hbmRSZXF1ZXN0EhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEhkKB3Byb2plY3QYAiABKAlCCLpIBXIDsAEBEj8KB2NvbW1hbmQYAyABKA4yJC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DQ29tbWFuZEIIukgFggECEAEiIgogTWFjaGluZVNlcnZpY2VCTUNDb21tYW5kUmVzcG9uc2UiUAobTWFjaGluZVNlcnZpY2VHZXRCTUNSZXF1ZXN0EhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEhkKB3Byb2plY3QYAiABKAlCCLpIBXIDsAEBImgKHE1hY2hpbmVTZXJ2aWNlR2V0Qk1DUmVzcG9uc2USFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESMAoDYm1jGAIgASgLMiMubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUJNQ1JlcG9ydCKyAwoHTWFjaGluZRIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIlCgRtZXRhGAIgASgLMhcubWV0YWxzdGFjay5hcGkudjIuTWV0YRIvCglwYXJ0aXRpb24YAyABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24SFgoEcmFjaxgEIAEoCUIIukgFcgMYgAESJQoEc2l6ZRgFIAEoCzIXLm1ldGFsc3RhY2suYXBpLnYyLlNpemUSNAoIaGFyZHdhcmUYBiABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lSGFyZHdhcmUSOAoKYWxsb2NhdGlvbhgHIAEoCzIkLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uEjAKBnN0YXR1cxgIIAEoCzIgLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTdGF0dXMSVgoacmVjZW50X3Byb3Zpc2lvbmluZ19ldmVudHMYCSABKAsyMi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUmVjZW50UHJvdmlzaW9uaW5nRXZlbnRzIu8BCg1NYWNoaW5lU3RhdHVzEjYKCWNvbmRpdGlvbhgBIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVDb25kaXRpb24SRAoJbGVkX3N0YXRlGAIgASgLMjEubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUNoYXNzaXNJZGVudGlmeUxFRFN0YXRlEkIKCmxpdmVsaW5lc3MYAyABKA4yJC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTGl2ZWxpbmVzc0IIukgFggECEAESHAoUbWV0YWxfaGFtbWVyX3ZlcnNpb24YBCABKAkiiAEKEE1hY2hpbmVDb25kaXRpb24SOAoFc3RhdGUYASABKA4yHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU3RhdGVCCLpIBYIBAhABEiAKC2Rlc2NyaXB0aW9uGAIgASgJQgu6SAhyBsizrrECARIYCgZpc3N1ZXIYAyABKAlCCLpIBXIDGIACIoMGChFNYWNoaW5lQWxsb2NhdGlvbhIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIlCgRtZXRhGAIgASgLMhcubWV0YWxzdGFjay5hcGkudjIuTWV0YRIZCgRuYW1lGAMgASgJQgu6SAhyBsCzrrECARIgCgtkZXNjcmlwdGlvbhgEIAEoCUILukgIcgbIs66xAgESHAoKY3JlYXRlZF9ieRgFIAEoCUIIukgFcgMYgAESGQoHcHJvamVjdBgGIAEoCUIIukgFcgOwAQESJwoFaW1hZ2UYByABKAsyGC5tZXRhbHN0YWNrLmFwaS52Mi5JbWFnZRI+ChFmaWxlc3lzdGVtX2xheW91dBgIIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLkZpbGVzeXN0ZW1MYXlvdXQSMwoIbmV0d29ya3MYCSADKAsyIS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTmV0d29yaxIZCghob3N0bmFtZRgKIAEoCUIHukgEcgJoARIwCg9zc2hfcHVibGljX2tleXMYCyADKAlCF7pIFJIBEciks7ECARAyIgdyBRABGIBAEiEKCHVzZXJkYXRhGAwgASgJQg+6SAxyCvCzrrECARiAgAISSwoPYWxsb2NhdGlvbl90eXBlGA0gASgOMigubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25UeXBlQgi6SAWCAQIQARI4Cg5maXJld2FsbF9ydWxlcxgOIAEoCzIgLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsUnVsZXMSOwoLZG5zX3NlcnZlcnMYDyADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5ETlNTZXJ2ZXJCCLpIBZIBAhADEjsKC250cF9zZXJ2ZXJzGBAgAygLMhwubWV0YWxzdGFjay5hcGkudjIuTlRQU2VydmVyQgi6SAWSAQIQChIqCgN2cG4YESABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lVlBOInAKGE1hY2hpbmVBbGxvY2F0aW9uTmV0d29yaxIcCgduZXR3b3JrGAEgASgJQgu6SAhyBsCzrrECARIfChJub19hdXRvX2FjcXVpcmVfaXAYAiABKAhIAIgBAUIVChNfbm9fYXV0b19hY3F1aXJlX2lwIloKE01hY2hpbmVBbGxvY2F0aW9uSXASEwoCaXAYASABKAlCB7pIBHICcAESIAoJbmFtZXNwYWNlGAIgASgJQgi6SAVyA7ABAUgAiAEBQgwKCl9uYW1lc3BhY2UifwoNRmlyZXdhbGxSdWxlcxI1CgZlZ3Jlc3MYASADKAsyJS5tZXRhbHN0YWNrLmFwaS52Mi5GaXJld2FsbEVncmVzc1J1bGUSNwoHaW5ncmVzcxgCIAMoCzImLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsSW5ncmVzc1J1bGUisgEKEkZpcmV3YWxsRWdyZXNzUnVsZRI5Cghwcm90b2NvbBgBIAEoDjIdLm1ldGFsc3RhY2suYXBpLnYyLklQUHJvdG9jb2xCCLpIBYIBAhABEh0KBXBvcnRzGAIgAygNQg66SAuSAQgiBioEGPz/AxIYCgJ0bxgDIAMoCUIMukgJkgEGuKSzsQIBEigKB2NvbW1lbnQYBCABKAlCF7pIFNgBAXIPGGQyC15bYS16XyAtXSokIs8BChNGaXJld2FsbEluZ3Jlc3NSdWxlEjkKCHByb3RvY29sGAEgASgOMh0ubWV0YWxzdGFjay5hcGkudjIuSVBQcm90b2NvbEIIukgFggECEAESHQoFcG9ydHMYAiADKA1CDrpIC5IBCCIGKgQY/P8DEhgKAnRvGAMgAygJQgy6SAmSAQa4pLOxAgESGgoEZnJvbRgEIAMoCUIMukgJkgEGuKSzsQIBEigKB2NvbW1lbnQYBSABKAlCF7pIFNgBAXIPGGQyC15bYS16XyAtXSokIsYCCg5NYWNoaW5lTmV0d29yaxIPCgduZXR3b3JrGAEgASgJEh4KCHByZWZpeGVzGAIgAygJQgy6SAmSAQa4pLOxAgESKgoUZGVzdGluYXRpb25fcHJlZml4ZXMYAyADKAlCDLpICZIBBriks7ECARIZCgNpcHMYBCADKAlCDLpICZIBBsCks7ECARI+CgxuZXR3b3JrX3R5cGUYBSABKA4yHi5tZXRhbHN0YWNrLmFwaS52Mi5OZXR3b3JrVHlwZUIIukgFggECEAESNgoIbmF0X3R5cGUYBiABKA4yGi5tZXRhbHN0YWNrLmFwaS52Mi5OQVRUeXBlQgi6SAWCAQIQARILCgN2cmYYByABKAQSCwoDYXNuGAggASgNEh4KB3Byb2plY3QYCSABKAlCCLpIBXIDsAEBSACIAQFCCgoIX3Byb2plY3Qi2gEKD01hY2hpbmVIYXJkd2FyZRIOCgZtZW1vcnkYASABKAQSNAoFZGlza3MYAiADKAsyJS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQmxvY2tEZXZpY2USKQoEY3B1cxgDIAMoCzIbLm1ldGFsc3RhY2suYXBpLnYyLk1ldGFsQ1BVEikKBGdwdXMYBCADKAsyGy5tZXRhbHN0YWNrLmFwaS52Mi5NZXRhbEdQVRIrCgRuaWNzGAUgAygLMh0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pYyJdCghNZXRhbENQVRIYCgZ2ZW5kb3IYASABKAlCCLpIBXIDGIACEhcKBW1vZGVsGAIgASgJQgi6SAVyAxiAAhINCgVjb3JlcxgDIAEoDRIPCgd0aHJlYWRzGAQgASgNIj0KCE1ldGFsR1BVEhgKBnZlbmRvchgBIAEoCUIIukgFcgMYgAISFwoFbW9kZWwYAiABKAlCCLpIBXIDGIACIuUBCgpNYWNoaW5lTmljEhgKA21hYxgBIAEoCUILukgIcga4s66xAgESGQoEbmFtZRgCIAEoCUILukgIcgbAs66xAgESHAoKaWRlbnRpZmllchgDIAEoCUIIukgFcgMYgAESGAoGdmVuZG9yGAQgASgJQgi6SAVyAxiAARIXCgVtb2RlbBgFIAEoCUIIukgFcgMYgAESDQoFc3BlZWQYBiABKAQSMAoJbmVpZ2hib3JzGAcgAygLMh0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pYxIQCghob3N0bmFtZRgIIAEoCSI9ChJNYWNoaW5lQmxvY2tEZXZpY2USGQoEbmFtZRgBIAEoCUILukgIcgbAs66xAgESDAoEc2l6ZRgCIAEoBCJbCh5NYWNoaW5lQ2hhc3Npc0lkZW50aWZ5TEVEU3RhdGUSFwoFdmFsdWUYASABKAlCCLpIBXIDGIABEiAKC2Rlc2NyaXB0aW9uGAIgASgJQgu6SAhyBsizrrECASKKAwoQTWFjaGluZUJNQ1JlcG9ydBIqCgNibWMYASABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DEiwKBGJpb3MYAiABKAsyHi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQmlvcxIqCgNmcnUYAyABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lRlJVEjsKDHBvd2VyX21ldHJpYxgEIAEoCzIlLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQb3dlck1ldHJpYxI9Cg5wb3dlcl9zdXBwbGllcxgFIAMoCzIlLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQb3dlclN1cHBseRJECglsZWRfc3RhdGUYBiABKAsyMS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQ2hhc3Npc0lkZW50aWZ5TEVEU3RhdGUSLgoKdXBkYXRlZF9hdBgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiYwoLTWFjaGluZUJpb3MSHAoHdmVyc2lvbhgBIAEoCUILukgIcgbIs66xAgESGwoGdmVuZG9yGAIgASgJQgu6SAhyBsizrrECARIZCgRkYXRlGAMgASgJQgu6SAhyBsizrrECASLbAQoKTWFjaGluZUJNQxIZCgdhZGRyZXNzGAEgASgJQgi6SAVyA4ACARIYCgNtYWMYAiABKAlCC7pICHIGuLOusQIBEhkKBHVzZXIYAyABKAlCC7pICHIGyLOusQIBEh0KCHBhc3N3b3JkGAQgASgJQgu6SAhyBsizrrECARIeCglpbnRlcmZhY2UYBSABKAlCC7pICHIGyLOusQIBEhwKB3ZlcnNpb24YBiABKAlCC7pICHIGyLOusQIBEiAKC3Bvd2VyX3N0YXRlGAcgASgJQgu6SAhyBsizrrECASKeBAoKTWFjaGluZUZSVRItChNjaGFzc2lzX3BhcnRfbnVtYmVyGAEgASgJQgu6SAhyBsizrrECAUgAiAEBEi0KE2NoYXNzaXNfcGFydF9zZXJpYWwYAiABKAlCC7pICHIGyLOusQIBSAGIAQESIwoJYm9hcmRfbWZnGAMgASgJQgu6SAhyBsizrrECAUgCiAEBEioKEGJvYXJkX21mZ19zZXJpYWwYBCABKAlCC7pICHIGyLOusQIBSAOIAQESKwoRYm9hcmRfcGFydF9udW1iZXIYBSABKAlCC7pICHIGyLOusQIBSASIAQESLgoUcHJvZHVjdF9tYW51ZmFjdHVyZXIYBiABKAlCC7pICHIGyLOusQIBSAWIAQESLQoTcHJvZHVjdF9wYXJ0X251bWJlchgHIAEoCUILukgIcgbIs66xAgFIBogBARIoCg5wcm9kdWN0X3NlcmlhbBgIIAEoCUILukgIcgbIs66xAgFIB4gBAUIWChRfY2hhc3Npc19wYXJ0X251bWJlckIWChRfY2hhc3Npc19wYXJ0X3NlcmlhbEIMCgpfYm9hcmRfbWZnQhMKEV9ib2FyZF9tZmdfc2VyaWFsQhQKEl9ib2FyZF9wYXJ0X251bWJlckIXChVfcHJvZHVjdF9tYW51ZmFjdHVyZXJCFgoUX3Byb2R1Y3RfcGFydF9udW1iZXJCEQoPX3Byb2R1Y3Rfc2VyaWFsIoUBChJNYWNoaW5lUG93ZXJNZXRyaWMSHgoWYXZlcmFnZV9jb25zdW1lZF93YXR0cxgBIAEoAhIXCg9pbnRlcnZhbF9pbl9taW4YAiABKAISGgoSbWF4X2NvbnN1bWVkX3dhdHRzGAMgASgCEhoKEm1pbl9jb25zdW1lZF93YXR0cxgEIAEoAiIzChJNYWNoaW5lUG93ZXJTdXBwbHkSDgoGaGVhbHRoGAEgASgJEg0KBXN0YXRlGAIgASgJIqUCCh9NYWNoaW5lUmVjZW50UHJvdmlzaW9uaW5nRXZlbnRzEjsKBmV2ZW50cxgBIAMoCzIrLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQcm92aXNpb25pbmdFdmVudBIzCg9sYXN0X2V2ZW50X3RpbWUYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEkUKEGxhc3RfZXJyb3JfZXZlbnQYAyABKAsyKy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUHJvdmlzaW9uaW5nRXZlbnQSSQoFc3RhdGUYBCABKA4yMC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUHJvdmlzaW9uaW5nRXZlbnRTdGF0ZUIIukgFggECEAEilQEKGE1hY2hpbmVQcm92aXNpb25pbmdFdmVudBIoCgR0aW1lGAEgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI+CgVldmVudBgCIAEoDjIvLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQcm92aXNpb25pbmdFdmVudFR5cGUSDwoHbWVzc2FnZRgDIAEoCSJrCgpNYWNoaW5lVlBOEh0KFWNvbnRyb2xfcGxhbmVfYWRkcmVzcxgBIAEoCRIQCghhdXRoX2tleRgCIAEoCRIRCgljb25uZWN0ZWQYAyABKAgSGQoDaXBzGAQgAygJQgy6SAmSAQbApLOxAgEiugcKDE1hY2hpbmVRdWVyeRIbCgR1dWlkGAEgASgJQgi6SAVyA7ABAUgAiAEBEh4KBG5hbWUYAiABKAlCC7pICHIGwLOusQIBSAGIAQESIgoJcGFydGl0aW9uGAMgASgJQgq6SAdyBRACGIABSAKIAQESHQoEc2l6ZRgEIAEoCUIKukgHcgUQAhiAAUgDiAEBEh0KBHJhY2sYBSABKAlCCrpIB3IFEAIYgAFIBIgBARIuCgZsYWJlbHMYBiABKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5MYWJlbHNIBYgBARJCCgphbGxvY2F0aW9uGAcgASgLMikubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25RdWVyeUgGiAEBEjwKB25ldHdvcmsYCCABKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTmV0d29ya1F1ZXJ5SAeIAQESNAoDbmljGAkgASgLMiIubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pY1F1ZXJ5SAiIAQESNgoEZGlzaxgKIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVEaXNrUXVlcnlICYgBARI0CgNibWMYCyABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DUXVlcnlICogBARI0CgNmcnUYDCABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lRlJVUXVlcnlIC4gBARI+CghoYXJkd2FyZRgNIAEoCzInLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVIYXJkd2FyZVF1ZXJ5SAyIAQESMwoFc3RhdGUYDiABKA4yHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU3RhdGVIDYgBARIUCgd3YWl0aW5nGA8gASgISA6IAQESGQoMcHJlYWxsb2NhdGVkGBAgASgISA+IAQESGgoNbm90X2FsbG9jYXRlZBgRIAEoCEgQiAEBQgcKBV91dWlkQgcKBV9uYW1lQgwKCl9wYXJ0aXRpb25CBwoFX3NpemVCBwoFX3JhY2tCCQoHX2xhYmVsc0INCgtfYWxsb2NhdGlvbkIKCghfbmV0d29ya0IGCgRfbmljQgcKBV9kaXNrQgYKBF9ibWNCBgoEX2ZydUILCglfaGFyZHdhcmVCCAoGX3N0YXRlQgoKCF93YWl0aW5nQg8KDV9wcmVhbGxvY2F0ZWRCEAoOX25vdF9hbGxvY2F0ZWQiiQQKFk1hY2hpbmVBbGxvY2F0aW9uUXVlcnkSGwoEdXVpZBgBIAEoCUIIukgFcgOwAQFIAIgBARIeCgRuYW1lGAIgASgJQgu6SAhyBsCzrrECAUgBiAEBEh4KB3Byb2plY3QYAyABKAlCCLpIBXIDsAEBSAKIAQESHgoFaW1hZ2UYBCABKAlCCrpIB3IFEAIYgAFIA4gBARIqChFmaWxlc3lzdGVtX2xheW91dBgFIAEoCUIKukgHcgUQAhiAAUgEiAEBEiEKCGhvc3RuYW1lGAYgASgJQgq6SAdyBRACGIABSAWIAQESUAoPYWxsb2NhdGlvbl90eXBlGAcgASgOMigubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25UeXBlQgi6SAWCAQIQAUgGiAEBEi4KBmxhYmVscxgIIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLkxhYmVsc0gHiAEBEi8KA3ZwbhgJIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVWUE5ICIgBAUIHCgVfdXVpZEIHCgVfbmFtZUIKCghfcHJvamVjdEIICgZfaW1hZ2VCFAoSX2ZpbGVzeXN0ZW1fbGF5b3V0QgsKCV9ob3N0bmFtZUISChBfYWxsb2NhdGlvbl90eXBlQgkKB19sYWJlbHNCBgoEX3ZwbiKqAQoTTWFjaGluZU5ldHdvcmtRdWVyeRIQCghuZXR3b3JrcxgBIAMoCRIeCghwcmVmaXhlcxgCIAMoCUIMukgJkgEGuKSzsQIBEioKFGRlc3RpbmF0aW9uX3ByZWZpeGVzGAMgAygJQgy6SAmSAQa4pLOxAgESGQoDaXBzGAQgAygJQgy6SAmSAQbApLOxAgESDAoEdnJmcxgFIAMoBBIMCgRhc25zGAYgAygNIq8BCg9NYWNoaW5lTmljUXVlcnkSIgoEbWFjcxgBIAMoCUIUukgRkgEOEGQYASIIcga4s66xAgESIAoFbmFtZXMYAiADKAlCEbpIDpIBCxBkGAEiBXIDGIABEisKDW5laWdoYm9yX21hY3MYAyADKAlCFLpIEZIBDhBkGAEiCHIGuLOusQIBEikKDm5laWdoYm9yX25hbWVzGAQgAygJQhG6SA6SAQsQZBgBIgVyAxiAASJLChBNYWNoaW5lRGlza1F1ZXJ5Eh4KBW5hbWVzGAEgAygJQg+6SAySAQkQZCIFcgMYgAESFwoFc2l6ZXMYAiADKARCCLpIBZIBAhBkIrkBCg9NYWNoaW5lQk1DUXVlcnkSHQoHYWRkcmVzcxgBIAEoCUIHukgEcgJwAUgAiAEBEh0KA21hYxgCIAEoCUILukgIcga4s66xAgFIAYgBARIbCgR1c2VyGAMgASgJQgi6SAVyAxiAAUgCiAEBEiAKCWludGVyZmFjZRgEIAEoCUIIukgFcgMYgAFIA4gBAUIKCghfYWRkcmVzc0IGCgRfbWFjQgcKBV91c2VyQgwKCl9pbnRlcmZhY2UigwQKD01hY2hpbmVGUlVRdWVyeRIqChNjaGFzc2lzX3BhcnRfbnVtYmVyGAEgASgJQgi6SAVyAxiAAUgAiAEBEioKE2NoYXNzaXNfcGFydF9zZXJpYWwYAiABKAlCCLpIBXIDGIABSAGIAQESIAoJYm9hcmRfbWZnGAMgASgJQgi6SAVyAxiAAUgCiAEBEiMKDGJvYXJkX3NlcmlhbBgEIAEoCUIIukgFcgMYgAFIA4gBARIoChFib2FyZF9wYXJ0X251bWJlchgFIAEoCUIIukgFcgMYgAFIBIgBARIrChRwcm9kdWN0X21hbnVmYWN0dXJlchgGIAEoCUIIukgFcgMYgAFIBYgBARIqChNwcm9kdWN0X3BhcnRfbnVtYmVyGAcgASgJQgi6SAVyAxiAAUgGiAEBEiUKDnByb2R1Y3Rfc2VyaWFsGAggASgJQgi6SAVyAxiAAUgHiAEBQhYKFF9jaGFzc2lzX3BhcnRfbnVtYmVyQhYKFF9jaGFzc2lzX3BhcnRfc2VyaWFsQgwKCl9ib2FyZF9tZmdCDwoNX2JvYXJkX3NlcmlhbEIUChJfYm9hcmRfcGFydF9udW1iZXJCFwoVX3Byb2R1Y3RfbWFudWZhY3R1cmVyQhYKFF9wcm9kdWN0X3BhcnRfbnVtYmVyQhEKD19wcm9kdWN0X3NlcmlhbCJcChRNYWNoaW5lSGFyZHdhcmVRdWVyeRITCgZtZW1vcnkYASABKARIAIgBARIWCgljcHVfY29yZXMYAiABKA1IAYgBAUIJCgdfbWVtb3J5QgwKCl9jcHVfY29yZXMqZQoKSVBQcm90b2NvbBIbChdJUF9QUk9UT0NPTF9VTlNQRUNJRklFRBAAEhwKD0lQX1BST1RPQ09MX1RDUBABGgeCshkDdGNwEhwKD0lQX1BST1RPQ09MX1VEUBACGgeCshkDdWRwKq8BCgxNYWNoaW5lU3RhdGUSIwoZTUFDSElORV9TVEFURV9VTlNQRUNJRklFRBAAGgSCshkAEigKFk1BQ0hJTkVfU1RBVEVfUkVTRVJWRUQQARoMgrIZCHJlc2VydmVkEiQKFE1BQ0hJTkVfU1RBVEVfTE9DS0VEEAIaCoKyGQZsb2NrZWQSKgoXTUFDSElORV9TVEFURV9BVkFJTEFCTEUQAxoNgrIZCWF2YWlsYWJsZSrfAQodTWFjaGluZVByb3Zpc2lvbmluZ0V2ZW50U3RhdGUSNgosTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfU1RBVEVfVU5TUEVDSUZJRUQQABoEgrIZABI9CipNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9TVEFURV9DUkFTSExPT1AQARoNgrIZCWNyYXNobG9vcBJHCi9NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9TVEFURV9GQUlMRURfUkVDTEFJTRACGhKCshkOZmFpbGVkLXJlY2xhaW0qnwYKHE1hY2hpbmVQcm92aXNpb25pbmdFdmVudFR5cGUSLworTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9VTlNQRUNJRklFRBAAEjQKJU1BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfQUxJVkUQARoJgrIZBUFsaXZlEjgKJ01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfQ1JBU0hFRBACGguCshkHQ3Jhc2hlZBJACitNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BYRV9CT09USU5HEAMaD4KyGQtQWEUgQm9vdGluZxJGCi5NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BMQU5ORURfUkVCT09UEAQaEoKyGQ5QbGFubmVkIFJlYm9vdBI8CilNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BSRVBBUklORxAFGg2CshkJUHJlcGFyaW5nEkAKK01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfUkVHSVNURVJJTkcQBhoPgrIZC1JlZ2lzdGVyaW5nEjgKJ01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfV0FJVElORxAHGguCshkHV2FpdGluZxI+CipNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX0lOU1RBTExJTkcQCBoOgrIZCkluc3RhbGxpbmcSTgoyTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9CT09USU5HX05FV19LRVJORUwQCRoWgrIZEkJvb3RpbmcgTmV3IEtlcm5lbBJACitNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BIT05FRF9IT01FEAoaD4KyGQtQaG9uZWQgSG9tZRJICi9NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX01BQ0hJTkVfUkVDTEFJTRALGhOCshkPTWFjaGluZSBSZWNsYWltKroBChFNYWNoaW5lTGl2ZWxpbmVzcxIoCh5NQUNISU5FX0xJVkVMSU5FU1NfVU5TUEVDSUZJRUQQABoEgrIZABInChhNQUNISU5FX0xJVkVMSU5FU1NfQUxJVkUQARoJgrIZBWFsaXZlEiUKF01BQ0hJTkVfTElWRUxJTkVTU19ERUFEEAIaCIKyGQRkZWFkEisKGk1BQ0hJTkVfTElWRUxJTkVTU19VTktOT1dOEAMaC4KyGQd1bmtub3duKqwBChVNYWNoaW5lQWxsb2NhdGlvblR5cGUSLQojTUFDSElORV9BTExPQ0FUSU9OX1RZUEVfVU5TUEVDSUZJRUQQABoEgrIZABIwCh9NQUNISU5FX0FMTE9DQVRJT05fVFlQRV9NQUNISU5FEAEaC4KyGQdtYWNoaW5lEjIKIE1BQ0hJTkVfQUxMT0NBVElPTl9UWVBFX0ZJUkVXQUxMEAIaDIKyGQhmaXJld2FsbCr+BAoRTWFjaGluZUJNQ0NvbW1hbmQSIwofTUFDSElORV9CTUNfQ09NTUFORF9VTlNQRUNJRklFRBAAEiIKFk1BQ0hJTkVfQk1DX0NPTU1BTkRfT04QARoGgrIZAm9uEiQKF01BQ0hJTkVfQk1DX0NPTU1BTkRfT0ZGEAIaB4KyGQNvZmYSKAoZTUFDSElORV9CTUNfQ09NTUFORF9SRVNFVBADGgmCshkFcmVzZXQSKAoZTUFDSElORV9CTUNfQ09NTUFORF9DWUNMRRAEGgmCshkFY3ljbGUSNgogTUFDSElORV9CTUNfQ09NTUFORF9CT09UX1RPX0JJT1MQBRoQgrIZDGJvb3QtdG8tYmlvcxI6CiJNQUNISU5FX0JNQ19DT01NQU5EX0JPT1RfRlJPTV9ESVNLEAYaEoKyGQ5ib290LWZyb20tZGlzaxI4CiFNQUNISU5FX0JNQ19DT01NQU5EX0JPT1RfRlJPTV9QWEUQBxoRgrIZDWJvb3QtZnJvbS1weGUSPAojTUFDSElORV9CTUNfQ09NTUFORF9JREVOVElGWV9MRURfT04QCBoTgrIZD2lkZW50aWZ5LWxlZC1vbhI+CiRNQUNISU5FX0JNQ19DT01NQU5EX0lERU5USUZZX0xFRF9PRkYQCRoUgrIZEGlkZW50aWZ5LWxlZC1vZmYSPAojTUFDSElORV9CTUNfQ09NTUFORF9NQUNISU5FX0RFTEVURUQQChoTgrIZD21hY2hpbmUtZGVsZXRlZBI8CiNNQUNISU5FX0JNQ19DT01NQU5EX01BQ0hJTkVfQ1JFQVRFRBALGhOCshkPbWFjaGluZS1jcmVhdGVkMrwGCg5NYWNoaW5lU2VydmljZRJtCgNHZXQSKy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUdldFJlcXVlc3QaLC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUdldFJlc3BvbnNlIgvK8xgDAQID4PMYAhJxCgZDcmVhdGUSLi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUNyZWF0ZVJlcXVlc3QaLy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUNyZWF0ZVJlc3BvbnNlIgbK8xgCAQIScQoGVXBkYXRlEi4ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VVcGRhdGVSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VVcGRhdGVSZXNwb25zZSIGyvMYAgECEnAKBExpc3QSLC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUxpc3RSZXF1ZXN0Gi0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VMaXN0UmVzcG9uc2UiC8rzGAMBAgPg8xgCEnEKBkRlbGV0ZRIuLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlRGVsZXRlUmVxdWVzdBovLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlRGVsZXRlUmVzcG9uc2UiBsrzGAIBAhJ9CgpCTUNDb21tYW5kEjIubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VCTUNDb21tYW5kUmVxdWVzdBozLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlQk1DQ29tbWFuZFJlc3BvbnNlIgbK8xgCAQIScQoGR2V0Qk1DEi4ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VHZXRCTUNSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VHZXRCTUNSZXNwb25zZSIGyvMYAgECQsIBChVjb20ubWV0YWxzdGFjay5hcGkudjJCDE1hY2hpbmVQcm90b1ABWjVnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FwaS92MjthcGl2MqICA01BWKoCEU1ldGFsc3RhY2suQXBpLlYyygIRTWV0YWxzdGFja1xBcGlcVjLiAh1NZXRhbHN0YWNrXEFwaVxWMlxHUEJNZXRhZGF0YeoCE01ldGFsc3RhY2s6OkFwaTo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_google_protobuf_timestamp, file_metalstack_api_v2_common, file_metalstack_api_v2_filesystem, file_metalstack_api_v2_image, file_metalstack_api_v2_network, file_metalstack_api_v2_partition, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_size]);
+export const file_metalstack_api_v2_machine = /*@__PURE__*/ fileDesc("Ch9tZXRhbHN0YWNrL2FwaS92Mi9tYWNoaW5lLnByb3RvEhFtZXRhbHN0YWNrLmFwaS52MiJNChhNYWNoaW5lU2VydmljZUdldFJlcXVlc3QSFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESGQoHcHJvamVjdBgCIAEoCUIIukgFcgOwAQEiSAoZTWFjaGluZVNlcnZpY2VHZXRSZXNwb25zZRIrCgdtYWNoaW5lGAEgASgLMhoubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZSKLBwobTWFjaGluZVNlcnZpY2VDcmVhdGVSZXF1ZXN0EhkKB3Byb2plY3QYASABKAlCCLpIBXIDsAEBEhsKBHV1aWQYAiABKAlCCLpIBXIDsAEBSACIAQESGQoEbmFtZRgDIAEoCUILukgIcgbAs66xAgESJQoLZGVzY3JpcHRpb24YBCABKAlCC7pICHIGyLOusQIBSAGIAQESHgoIaG9zdG5hbWUYBSABKAlCB7pIBHICaAFIAogBARIeCglwYXJ0aXRpb24YBiABKAlCC7pICHIG0LOusQIBEhYKBHNpemUYByABKAlCCLpIBXIDGIABEhcKBWltYWdlGAggASgJQgi6SAVyAxiAARIeChFmaWxlc3lzdGVtX2xheW91dBgJIAEoCUgDiAEBEjAKD3NzaF9wdWJsaWNfa2V5cxgKIAMoCUIXukgUkgER0KSzsQIBEDIiB3IFEAEYgEASJgoIdXNlcmRhdGEYCyABKAlCD7pIDHIK8LOusQIBGICAAkgEiAEBEikKBmxhYmVscxgMIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLkxhYmVscxI9CghuZXR3b3JrcxgNIAMoCzIrLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uTmV0d29yaxIzCgNpcHMYDiADKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQWxsb2NhdGlvbklwEiAKDnBsYWNlbWVudF90YWdzGA8gAygJQgi6SAWSAQIQQBI7CgtkbnNfc2VydmVycxgQIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYESADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEksKD2FsbG9jYXRpb25fdHlwZRgSIAEoDjIoLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uVHlwZUIIukgFggECEAESNgoNZmlyZXdhbGxfc3BlYxgTIAEoCzIfLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsU3BlY0IHCgVfdXVpZEIOCgxfZGVzY3JpcHRpb25CCwoJX2hvc3RuYW1lQhQKEl9maWxlc3lzdGVtX2xheW91dEILCglfdXNlcmRhdGEiSAoMRmlyZXdhbGxTcGVjEjgKDmZpcmV3YWxsX3J1bGVzGAEgASgLMiAubWV0YWxzdGFjay5hcGkudjIuRmlyZXdhbGxSdWxlcyJLChxNYWNoaW5lU2VydmljZUNyZWF0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIrYCChtNYWNoaW5lU2VydmljZVVwZGF0ZVJlcXVlc3QSFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESOgoLdXBkYXRlX21ldGEYAiABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5VcGRhdGVNZXRhQga6SAPIAQESGQoHcHJvamVjdBgDIAEoCUIIukgFcgOwAQESJQoLZGVzY3JpcHRpb24YBCABKAlCC7pICHIGyLOusQIBSACIAQESNAoGbGFiZWxzGAUgASgLMh8ubWV0YWxzdGFjay5hcGkudjIuVXBkYXRlTGFiZWxzSAGIAQESMAoPc3NoX3B1YmxpY19rZXlzGAYgAygJQhe6SBSSARHQpLOxAgEQMiIHcgUQARiAQEIOCgxfZGVzY3JpcHRpb25CCQoHX2xhYmVscyJLChxNYWNoaW5lU2VydmljZVVwZGF0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lImYKGU1hY2hpbmVTZXJ2aWNlTGlzdFJlcXVlc3QSGQoHcHJvamVjdBgBIAEoCUIIukgFcgOwAQESLgoFcXVlcnkYAiABKAsyHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUXVlcnkiSgoaTWFjaGluZVNlcnZpY2VMaXN0UmVzcG9uc2USLAoIbWFjaGluZXMYASADKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIlAKG01hY2hpbmVTZXJ2aWNlRGVsZXRlUmVxdWVzdBIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIZCgdwcm9qZWN0GAIgASgJQgi6SAVyA7ABASJLChxNYWNoaW5lU2VydmljZURlbGV0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIpUBCh9NYWNoaW5lU2VydmljZUJNQ0NvbW1hbmRSZXF1ZXN0EhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEhkKB3Byb2plY3QYAiABKAlCCLpIBXIDsAEBEj8KB2NvbW1hbmQYAyABKA4yJC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DQ29tbWFuZEIIukgFggECEAEiIgogTWFjaGluZVNlcnZpY2VCTUNDb21tYW5kUmVzcG9uc2UiUAobTWFjaGluZVNlcnZpY2VHZXRCTUNSZXF1ZXN0EhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEhkKB3Byb2plY3QYAiABKAlCCLpIBXIDsAEBImgKHE1hY2hpbmVTZXJ2aWNlR2V0Qk1DUmVzcG9uc2USFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESMAoDYm1jGAIgASgLMiMubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUJNQ1JlcG9ydCKyAwoHTWFjaGluZRIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIlCgRtZXRhGAIgASgLMhcubWV0YWxzdGFjay5hcGkudjIuTWV0YRIvCglwYXJ0aXRpb24YAyABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24SFgoEcmFjaxgEIAEoCUIIukgFcgMYgAESJQoEc2l6ZRgFIAEoCzIXLm1ldGFsc3RhY2suYXBpLnYyLlNpemUSNAoIaGFyZHdhcmUYBiABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lSGFyZHdhcmUSOAoKYWxsb2NhdGlvbhgHIAEoCzIkLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uEjAKBnN0YXR1cxgIIAEoCzIgLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTdGF0dXMSVgoacmVjZW50X3Byb3Zpc2lvbmluZ19ldmVudHMYCSABKAsyMi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUmVjZW50UHJvdmlzaW9uaW5nRXZlbnRzIu8BCg1NYWNoaW5lU3RhdHVzEjYKCWNvbmRpdGlvbhgBIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVDb25kaXRpb24SRAoJbGVkX3N0YXRlGAIgASgLMjEubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUNoYXNzaXNJZGVudGlmeUxFRFN0YXRlEkIKCmxpdmVsaW5lc3MYAyABKA4yJC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTGl2ZWxpbmVzc0IIukgFggECEAESHAoUbWV0YWxfaGFtbWVyX3ZlcnNpb24YBCABKAkiiAEKEE1hY2hpbmVDb25kaXRpb24SOAoFc3RhdGUYASABKA4yHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU3RhdGVCCLpIBYIBAhABEiAKC2Rlc2NyaXB0aW9uGAIgASgJQgu6SAhyBsizrrECARIYCgZpc3N1ZXIYAyABKAlCCLpIBXIDGIACIoMGChFNYWNoaW5lQWxsb2NhdGlvbhIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIlCgRtZXRhGAIgASgLMhcubWV0YWxzdGFjay5hcGkudjIuTWV0YRIZCgRuYW1lGAMgASgJQgu6SAhyBsCzrrECARIgCgtkZXNjcmlwdGlvbhgEIAEoCUILukgIcgbIs66xAgESHAoKY3JlYXRlZF9ieRgFIAEoCUIIukgFcgMYgAESGQoHcHJvamVjdBgGIAEoCUIIukgFcgOwAQESJwoFaW1hZ2UYByABKAsyGC5tZXRhbHN0YWNrLmFwaS52Mi5JbWFnZRI+ChFmaWxlc3lzdGVtX2xheW91dBgIIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLkZpbGVzeXN0ZW1MYXlvdXQSMwoIbmV0d29ya3MYCSADKAsyIS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTmV0d29yaxIZCghob3N0bmFtZRgKIAEoCUIHukgEcgJoARIwCg9zc2hfcHVibGljX2tleXMYCyADKAlCF7pIFJIBEdCks7ECARAyIgdyBRABGIBAEiEKCHVzZXJkYXRhGAwgASgJQg+6SAxyCvCzrrECARiAgAISSwoPYWxsb2NhdGlvbl90eXBlGA0gASgOMigubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25UeXBlQgi6SAWCAQIQARI4Cg5maXJld2FsbF9ydWxlcxgOIAEoCzIgLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsUnVsZXMSOwoLZG5zX3NlcnZlcnMYDyADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5ETlNTZXJ2ZXJCCLpIBZIBAhADEjsKC250cF9zZXJ2ZXJzGBAgAygLMhwubWV0YWxzdGFjay5hcGkudjIuTlRQU2VydmVyQgi6SAWSAQIQChIqCgN2cG4YESABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lVlBOInAKGE1hY2hpbmVBbGxvY2F0aW9uTmV0d29yaxIcCgduZXR3b3JrGAEgASgJQgu6SAhyBsCzrrECARIfChJub19hdXRvX2FjcXVpcmVfaXAYAiABKAhIAIgBAUIVChNfbm9fYXV0b19hY3F1aXJlX2lwIloKE01hY2hpbmVBbGxvY2F0aW9uSXASEwoCaXAYASABKAlCB7pIBHICcAESIAoJbmFtZXNwYWNlGAIgASgJQgi6SAVyA7ABAUgAiAEBQgwKCl9uYW1lc3BhY2UifwoNRmlyZXdhbGxSdWxlcxI1CgZlZ3Jlc3MYASADKAsyJS5tZXRhbHN0YWNrLmFwaS52Mi5GaXJld2FsbEVncmVzc1J1bGUSNwoHaW5ncmVzcxgCIAMoCzImLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsSW5ncmVzc1J1bGUisgEKEkZpcmV3YWxsRWdyZXNzUnVsZRI5Cghwcm90b2NvbBgBIAEoDjIdLm1ldGFsc3RhY2suYXBpLnYyLklQUHJvdG9jb2xCCLpIBYIBAhABEh0KBXBvcnRzGAIgAygNQg66SAuSAQgiBioEGPz/AxIYCgJ0bxgDIAMoCUIMukgJkgEGuKSzsQIBEigKB2NvbW1lbnQYBCABKAlCF7pIFNgBAXIPGGQyC15bYS16XyAtXSokIs8BChNGaXJld2FsbEluZ3Jlc3NSdWxlEjkKCHByb3RvY29sGAEgASgOMh0ubWV0YWxzdGFjay5hcGkudjIuSVBQcm90b2NvbEIIukgFggECEAESHQoFcG9ydHMYAiADKA1CDrpIC5IBCCIGKgQY/P8DEhgKAnRvGAMgAygJQgy6SAmSAQa4pLOxAgESGgoEZnJvbRgEIAMoCUIMukgJkgEGuKSzsQIBEigKB2NvbW1lbnQYBSABKAlCF7pIFNgBAXIPGGQyC15bYS16XyAtXSokIsYCCg5NYWNoaW5lTmV0d29yaxIPCgduZXR3b3JrGAEgASgJEh4KCHByZWZpeGVzGAIgAygJQgy6SAmSAQa4pLOxAgESKgoUZGVzdGluYXRpb25fcHJlZml4ZXMYAyADKAlCDLpICZIBBriks7ECARIZCgNpcHMYBCADKAlCDLpICZIBBsCks7ECARI+CgxuZXR3b3JrX3R5cGUYBSABKA4yHi5tZXRhbHN0YWNrLmFwaS52Mi5OZXR3b3JrVHlwZUIIukgFggECEAESNgoIbmF0X3R5cGUYBiABKA4yGi5tZXRhbHN0YWNrLmFwaS52Mi5OQVRUeXBlQgi6SAWCAQIQARILCgN2cmYYByABKAQSCwoDYXNuGAggASgNEh4KB3Byb2plY3QYCSABKAlCCLpIBXIDsAEBSACIAQFCCgoIX3Byb2plY3Qi2gEKD01hY2hpbmVIYXJkd2FyZRIOCgZtZW1vcnkYASABKAQSNAoFZGlza3MYAiADKAsyJS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQmxvY2tEZXZpY2USKQoEY3B1cxgDIAMoCzIbLm1ldGFsc3RhY2suYXBpLnYyLk1ldGFsQ1BVEikKBGdwdXMYBCADKAsyGy5tZXRhbHN0YWNrLmFwaS52Mi5NZXRhbEdQVRIrCgRuaWNzGAUgAygLMh0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pYyJdCghNZXRhbENQVRIYCgZ2ZW5kb3IYASABKAlCCLpIBXIDGIACEhcKBW1vZGVsGAIgASgJQgi6SAVyAxiAAhINCgVjb3JlcxgDIAEoDRIPCgd0aHJlYWRzGAQgASgNIj0KCE1ldGFsR1BVEhgKBnZlbmRvchgBIAEoCUIIukgFcgMYgAISFwoFbW9kZWwYAiABKAlCCLpIBXIDGIACIuUBCgpNYWNoaW5lTmljEhgKA21hYxgBIAEoCUILukgIcga4s66xAgESGQoEbmFtZRgCIAEoCUILukgIcgbAs66xAgESHAoKaWRlbnRpZmllchgDIAEoCUIIukgFcgMYgAESGAoGdmVuZG9yGAQgASgJQgi6SAVyAxiAARIXCgVtb2RlbBgFIAEoCUIIukgFcgMYgAESDQoFc3BlZWQYBiABKAQSMAoJbmVpZ2hib3JzGAcgAygLMh0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pYxIQCghob3N0bmFtZRgIIAEoCSI9ChJNYWNoaW5lQmxvY2tEZXZpY2USGQoEbmFtZRgBIAEoCUILukgIcgbAs66xAgESDAoEc2l6ZRgCIAEoBCJbCh5NYWNoaW5lQ2hhc3Npc0lkZW50aWZ5TEVEU3RhdGUSFwoFdmFsdWUYASABKAlCCLpIBXIDGIABEiAKC2Rlc2NyaXB0aW9uGAIgASgJQgu6SAhyBsizrrECASKKAwoQTWFjaGluZUJNQ1JlcG9ydBIqCgNibWMYASABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DEiwKBGJpb3MYAiABKAsyHi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQmlvcxIqCgNmcnUYAyABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lRlJVEjsKDHBvd2VyX21ldHJpYxgEIAEoCzIlLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQb3dlck1ldHJpYxI9Cg5wb3dlcl9zdXBwbGllcxgFIAMoCzIlLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQb3dlclN1cHBseRJECglsZWRfc3RhdGUYBiABKAsyMS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQ2hhc3Npc0lkZW50aWZ5TEVEU3RhdGUSLgoKdXBkYXRlZF9hdBgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiYwoLTWFjaGluZUJpb3MSHAoHdmVyc2lvbhgBIAEoCUILukgIcgbIs66xAgESGwoGdmVuZG9yGAIgASgJQgu6SAhyBsizrrECARIZCgRkYXRlGAMgASgJQgu6SAhyBsizrrECASLbAQoKTWFjaGluZUJNQxIZCgdhZGRyZXNzGAEgASgJQgi6SAVyA4ACARIYCgNtYWMYAiABKAlCC7pICHIGuLOusQIBEhkKBHVzZXIYAyABKAlCC7pICHIGyLOusQIBEh0KCHBhc3N3b3JkGAQgASgJQgu6SAhyBsizrrECARIeCglpbnRlcmZhY2UYBSABKAlCC7pICHIGyLOusQIBEhwKB3ZlcnNpb24YBiABKAlCC7pICHIGyLOusQIBEiAKC3Bvd2VyX3N0YXRlGAcgASgJQgu6SAhyBsizrrECASKeBAoKTWFjaGluZUZSVRItChNjaGFzc2lzX3BhcnRfbnVtYmVyGAEgASgJQgu6SAhyBsizrrECAUgAiAEBEi0KE2NoYXNzaXNfcGFydF9zZXJpYWwYAiABKAlCC7pICHIGyLOusQIBSAGIAQESIwoJYm9hcmRfbWZnGAMgASgJQgu6SAhyBsizrrECAUgCiAEBEioKEGJvYXJkX21mZ19zZXJpYWwYBCABKAlCC7pICHIGyLOusQIBSAOIAQESKwoRYm9hcmRfcGFydF9udW1iZXIYBSABKAlCC7pICHIGyLOusQIBSASIAQESLgoUcHJvZHVjdF9tYW51ZmFjdHVyZXIYBiABKAlCC7pICHIGyLOusQIBSAWIAQESLQoTcHJvZHVjdF9wYXJ0X251bWJlchgHIAEoCUILukgIcgbIs66xAgFIBogBARIoCg5wcm9kdWN0X3NlcmlhbBgIIAEoCUILukgIcgbIs66xAgFIB4gBAUIWChRfY2hhc3Npc19wYXJ0X251bWJlckIWChRfY2hhc3Npc19wYXJ0X3NlcmlhbEIMCgpfYm9hcmRfbWZnQhMKEV9ib2FyZF9tZmdfc2VyaWFsQhQKEl9ib2FyZF9wYXJ0X251bWJlckIXChVfcHJvZHVjdF9tYW51ZmFjdHVyZXJCFgoUX3Byb2R1Y3RfcGFydF9udW1iZXJCEQoPX3Byb2R1Y3Rfc2VyaWFsIoUBChJNYWNoaW5lUG93ZXJNZXRyaWMSHgoWYXZlcmFnZV9jb25zdW1lZF93YXR0cxgBIAEoAhIXCg9pbnRlcnZhbF9pbl9taW4YAiABKAISGgoSbWF4X2NvbnN1bWVkX3dhdHRzGAMgASgCEhoKEm1pbl9jb25zdW1lZF93YXR0cxgEIAEoAiIzChJNYWNoaW5lUG93ZXJTdXBwbHkSDgoGaGVhbHRoGAEgASgJEg0KBXN0YXRlGAIgASgJIqUCCh9NYWNoaW5lUmVjZW50UHJvdmlzaW9uaW5nRXZlbnRzEjsKBmV2ZW50cxgBIAMoCzIrLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQcm92aXNpb25pbmdFdmVudBIzCg9sYXN0X2V2ZW50X3RpbWUYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEkUKEGxhc3RfZXJyb3JfZXZlbnQYAyABKAsyKy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUHJvdmlzaW9uaW5nRXZlbnQSSQoFc3RhdGUYBCABKA4yMC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUHJvdmlzaW9uaW5nRXZlbnRTdGF0ZUIIukgFggECEAEilQEKGE1hY2hpbmVQcm92aXNpb25pbmdFdmVudBIoCgR0aW1lGAEgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI+CgVldmVudBgCIAEoDjIvLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQcm92aXNpb25pbmdFdmVudFR5cGUSDwoHbWVzc2FnZRgDIAEoCSJrCgpNYWNoaW5lVlBOEh0KFWNvbnRyb2xfcGxhbmVfYWRkcmVzcxgBIAEoCRIQCghhdXRoX2tleRgCIAEoCRIRCgljb25uZWN0ZWQYAyABKAgSGQoDaXBzGAQgAygJQgy6SAmSAQbApLOxAgEiugcKDE1hY2hpbmVRdWVyeRIbCgR1dWlkGAEgASgJQgi6SAVyA7ABAUgAiAEBEh4KBG5hbWUYAiABKAlCC7pICHIGwLOusQIBSAGIAQESIgoJcGFydGl0aW9uGAMgASgJQgq6SAdyBRACGIABSAKIAQESHQoEc2l6ZRgEIAEoCUIKukgHcgUQAhiAAUgDiAEBEh0KBHJhY2sYBSABKAlCCrpIB3IFEAIYgAFIBIgBARIuCgZsYWJlbHMYBiABKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5MYWJlbHNIBYgBARJCCgphbGxvY2F0aW9uGAcgASgLMikubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25RdWVyeUgGiAEBEjwKB25ldHdvcmsYCCABKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTmV0d29ya1F1ZXJ5SAeIAQESNAoDbmljGAkgASgLMiIubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pY1F1ZXJ5SAiIAQESNgoEZGlzaxgKIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVEaXNrUXVlcnlICYgBARI0CgNibWMYCyABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DUXVlcnlICogBARI0CgNmcnUYDCABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lRlJVUXVlcnlIC4gBARI+CghoYXJkd2FyZRgNIAEoCzInLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVIYXJkd2FyZVF1ZXJ5SAyIAQESMwoFc3RhdGUYDiABKA4yHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU3RhdGVIDYgBARIUCgd3YWl0aW5nGA8gASgISA6IAQESGQoMcHJlYWxsb2NhdGVkGBAgASgISA+IAQESGgoNbm90X2FsbG9jYXRlZBgRIAEoCEgQiAEBQgcKBV91dWlkQgcKBV9uYW1lQgwKCl9wYXJ0aXRpb25CBwoFX3NpemVCBwoFX3JhY2tCCQoHX2xhYmVsc0INCgtfYWxsb2NhdGlvbkIKCghfbmV0d29ya0IGCgRfbmljQgcKBV9kaXNrQgYKBF9ibWNCBgoEX2ZydUILCglfaGFyZHdhcmVCCAoGX3N0YXRlQgoKCF93YWl0aW5nQg8KDV9wcmVhbGxvY2F0ZWRCEAoOX25vdF9hbGxvY2F0ZWQiiQQKFk1hY2hpbmVBbGxvY2F0aW9uUXVlcnkSGwoEdXVpZBgBIAEoCUIIukgFcgOwAQFIAIgBARIeCgRuYW1lGAIgASgJQgu6SAhyBsCzrrECAUgBiAEBEh4KB3Byb2plY3QYAyABKAlCCLpIBXIDsAEBSAKIAQESHgoFaW1hZ2UYBCABKAlCCrpIB3IFEAIYgAFIA4gBARIqChFmaWxlc3lzdGVtX2xheW91dBgFIAEoCUIKukgHcgUQAhiAAUgEiAEBEiEKCGhvc3RuYW1lGAYgASgJQgq6SAdyBRACGIABSAWIAQESUAoPYWxsb2NhdGlvbl90eXBlGAcgASgOMigubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25UeXBlQgi6SAWCAQIQAUgGiAEBEi4KBmxhYmVscxgIIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLkxhYmVsc0gHiAEBEi8KA3ZwbhgJIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVWUE5ICIgBAUIHCgVfdXVpZEIHCgVfbmFtZUIKCghfcHJvamVjdEIICgZfaW1hZ2VCFAoSX2ZpbGVzeXN0ZW1fbGF5b3V0QgsKCV9ob3N0bmFtZUISChBfYWxsb2NhdGlvbl90eXBlQgkKB19sYWJlbHNCBgoEX3ZwbiKqAQoTTWFjaGluZU5ldHdvcmtRdWVyeRIQCghuZXR3b3JrcxgBIAMoCRIeCghwcmVmaXhlcxgCIAMoCUIMukgJkgEGuKSzsQIBEioKFGRlc3RpbmF0aW9uX3ByZWZpeGVzGAMgAygJQgy6SAmSAQa4pLOxAgESGQoDaXBzGAQgAygJQgy6SAmSAQbApLOxAgESDAoEdnJmcxgFIAMoBBIMCgRhc25zGAYgAygNIq8BCg9NYWNoaW5lTmljUXVlcnkSIgoEbWFjcxgBIAMoCUIUukgRkgEOEGQYASIIcga4s66xAgESIAoFbmFtZXMYAiADKAlCEbpIDpIBCxBkGAEiBXIDGIABEisKDW5laWdoYm9yX21hY3MYAyADKAlCFLpIEZIBDhBkGAEiCHIGuLOusQIBEikKDm5laWdoYm9yX25hbWVzGAQgAygJQhG6SA6SAQsQZBgBIgVyAxiAASJLChBNYWNoaW5lRGlza1F1ZXJ5Eh4KBW5hbWVzGAEgAygJQg+6SAySAQkQZCIFcgMYgAESFwoFc2l6ZXMYAiADKARCCLpIBZIBAhBkIrkBCg9NYWNoaW5lQk1DUXVlcnkSHQoHYWRkcmVzcxgBIAEoCUIHukgEcgJwAUgAiAEBEh0KA21hYxgCIAEoCUILukgIcga4s66xAgFIAYgBARIbCgR1c2VyGAMgASgJQgi6SAVyAxiAAUgCiAEBEiAKCWludGVyZmFjZRgEIAEoCUIIukgFcgMYgAFIA4gBAUIKCghfYWRkcmVzc0IGCgRfbWFjQgcKBV91c2VyQgwKCl9pbnRlcmZhY2UigwQKD01hY2hpbmVGUlVRdWVyeRIqChNjaGFzc2lzX3BhcnRfbnVtYmVyGAEgASgJQgi6SAVyAxiAAUgAiAEBEioKE2NoYXNzaXNfcGFydF9zZXJpYWwYAiABKAlCCLpIBXIDGIABSAGIAQESIAoJYm9hcmRfbWZnGAMgASgJQgi6SAVyAxiAAUgCiAEBEiMKDGJvYXJkX3NlcmlhbBgEIAEoCUIIukgFcgMYgAFIA4gBARIoChFib2FyZF9wYXJ0X251bWJlchgFIAEoCUIIukgFcgMYgAFIBIgBARIrChRwcm9kdWN0X21hbnVmYWN0dXJlchgGIAEoCUIIukgFcgMYgAFIBYgBARIqChNwcm9kdWN0X3BhcnRfbnVtYmVyGAcgASgJQgi6SAVyAxiAAUgGiAEBEiUKDnByb2R1Y3Rfc2VyaWFsGAggASgJQgi6SAVyAxiAAUgHiAEBQhYKFF9jaGFzc2lzX3BhcnRfbnVtYmVyQhYKFF9jaGFzc2lzX3BhcnRfc2VyaWFsQgwKCl9ib2FyZF9tZmdCDwoNX2JvYXJkX3NlcmlhbEIUChJfYm9hcmRfcGFydF9udW1iZXJCFwoVX3Byb2R1Y3RfbWFudWZhY3R1cmVyQhYKFF9wcm9kdWN0X3BhcnRfbnVtYmVyQhEKD19wcm9kdWN0X3NlcmlhbCJcChRNYWNoaW5lSGFyZHdhcmVRdWVyeRITCgZtZW1vcnkYASABKARIAIgBARIWCgljcHVfY29yZXMYAiABKA1IAYgBAUIJCgdfbWVtb3J5QgwKCl9jcHVfY29yZXMqZQoKSVBQcm90b2NvbBIbChdJUF9QUk9UT0NPTF9VTlNQRUNJRklFRBAAEhwKD0lQX1BST1RPQ09MX1RDUBABGgeCshkDdGNwEhwKD0lQX1BST1RPQ09MX1VEUBACGgeCshkDdWRwKq8BCgxNYWNoaW5lU3RhdGUSIwoZTUFDSElORV9TVEFURV9VTlNQRUNJRklFRBAAGgSCshkAEigKFk1BQ0hJTkVfU1RBVEVfUkVTRVJWRUQQARoMgrIZCHJlc2VydmVkEiQKFE1BQ0hJTkVfU1RBVEVfTE9DS0VEEAIaCoKyGQZsb2NrZWQSKgoXTUFDSElORV9TVEFURV9BVkFJTEFCTEUQAxoNgrIZCWF2YWlsYWJsZSrfAQodTWFjaGluZVByb3Zpc2lvbmluZ0V2ZW50U3RhdGUSNgosTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfU1RBVEVfVU5TUEVDSUZJRUQQABoEgrIZABI9CipNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9TVEFURV9DUkFTSExPT1AQARoNgrIZCWNyYXNobG9vcBJHCi9NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9TVEFURV9GQUlMRURfUkVDTEFJTRACGhKCshkOZmFpbGVkLXJlY2xhaW0qnwYKHE1hY2hpbmVQcm92aXNpb25pbmdFdmVudFR5cGUSLworTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9VTlNQRUNJRklFRBAAEjQKJU1BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfQUxJVkUQARoJgrIZBUFsaXZlEjgKJ01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfQ1JBU0hFRBACGguCshkHQ3Jhc2hlZBJACitNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BYRV9CT09USU5HEAMaD4KyGQtQWEUgQm9vdGluZxJGCi5NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BMQU5ORURfUkVCT09UEAQaEoKyGQ5QbGFubmVkIFJlYm9vdBI8CilNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BSRVBBUklORxAFGg2CshkJUHJlcGFyaW5nEkAKK01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfUkVHSVNURVJJTkcQBhoPgrIZC1JlZ2lzdGVyaW5nEjgKJ01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfV0FJVElORxAHGguCshkHV2FpdGluZxI+CipNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX0lOU1RBTExJTkcQCBoOgrIZCkluc3RhbGxpbmcSTgoyTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9CT09USU5HX05FV19LRVJORUwQCRoWgrIZEkJvb3RpbmcgTmV3IEtlcm5lbBJACitNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BIT05FRF9IT01FEAoaD4KyGQtQaG9uZWQgSG9tZRJICi9NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX01BQ0hJTkVfUkVDTEFJTRALGhOCshkPTWFjaGluZSBSZWNsYWltKroBChFNYWNoaW5lTGl2ZWxpbmVzcxIoCh5NQUNISU5FX0xJVkVMSU5FU1NfVU5TUEVDSUZJRUQQABoEgrIZABInChhNQUNISU5FX0xJVkVMSU5FU1NfQUxJVkUQARoJgrIZBWFsaXZlEiUKF01BQ0hJTkVfTElWRUxJTkVTU19ERUFEEAIaCIKyGQRkZWFkEisKGk1BQ0hJTkVfTElWRUxJTkVTU19VTktOT1dOEAMaC4KyGQd1bmtub3duKqwBChVNYWNoaW5lQWxsb2NhdGlvblR5cGUSLQojTUFDSElORV9BTExPQ0FUSU9OX1RZUEVfVU5TUEVDSUZJRUQQABoEgrIZABIwCh9NQUNISU5FX0FMTE9DQVRJT05fVFlQRV9NQUNISU5FEAEaC4KyGQdtYWNoaW5lEjIKIE1BQ0hJTkVfQUxMT0NBVElPTl9UWVBFX0ZJUkVXQUxMEAIaDIKyGQhmaXJld2FsbCr+BAoRTWFjaGluZUJNQ0NvbW1hbmQSIwofTUFDSElORV9CTUNfQ09NTUFORF9VTlNQRUNJRklFRBAAEiIKFk1BQ0hJTkVfQk1DX0NPTU1BTkRfT04QARoGgrIZAm9uEiQKF01BQ0hJTkVfQk1DX0NPTU1BTkRfT0ZGEAIaB4KyGQNvZmYSKAoZTUFDSElORV9CTUNfQ09NTUFORF9SRVNFVBADGgmCshkFcmVzZXQSKAoZTUFDSElORV9CTUNfQ09NTUFORF9DWUNMRRAEGgmCshkFY3ljbGUSNgogTUFDSElORV9CTUNfQ09NTUFORF9CT09UX1RPX0JJT1MQBRoQgrIZDGJvb3QtdG8tYmlvcxI6CiJNQUNISU5FX0JNQ19DT01NQU5EX0JPT1RfRlJPTV9ESVNLEAYaEoKyGQ5ib290LWZyb20tZGlzaxI4CiFNQUNISU5FX0JNQ19DT01NQU5EX0JPT1RfRlJPTV9QWEUQBxoRgrIZDWJvb3QtZnJvbS1weGUSPAojTUFDSElORV9CTUNfQ09NTUFORF9JREVOVElGWV9MRURfT04QCBoTgrIZD2lkZW50aWZ5LWxlZC1vbhI+CiRNQUNISU5FX0JNQ19DT01NQU5EX0lERU5USUZZX0xFRF9PRkYQCRoUgrIZEGlkZW50aWZ5LWxlZC1vZmYSPAojTUFDSElORV9CTUNfQ09NTUFORF9NQUNISU5FX0RFTEVURUQQChoTgrIZD21hY2hpbmUtZGVsZXRlZBI8CiNNQUNISU5FX0JNQ19DT01NQU5EX01BQ0hJTkVfQ1JFQVRFRBALGhOCshkPbWFjaGluZS1jcmVhdGVkMrwGCg5NYWNoaW5lU2VydmljZRJtCgNHZXQSKy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUdldFJlcXVlc3QaLC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUdldFJlc3BvbnNlIgvK8xgDAQID4PMYAhJxCgZDcmVhdGUSLi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUNyZWF0ZVJlcXVlc3QaLy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUNyZWF0ZVJlc3BvbnNlIgbK8xgCAQIScQoGVXBkYXRlEi4ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VVcGRhdGVSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VVcGRhdGVSZXNwb25zZSIGyvMYAgECEnAKBExpc3QSLC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUxpc3RSZXF1ZXN0Gi0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VMaXN0UmVzcG9uc2UiC8rzGAMBAgPg8xgCEnEKBkRlbGV0ZRIuLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlRGVsZXRlUmVxdWVzdBovLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlRGVsZXRlUmVzcG9uc2UiBsrzGAIBAhJ9CgpCTUNDb21tYW5kEjIubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VCTUNDb21tYW5kUmVxdWVzdBozLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlQk1DQ29tbWFuZFJlc3BvbnNlIgbK8xgCAQIScQoGR2V0Qk1DEi4ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VHZXRCTUNSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VHZXRCTUNSZXNwb25zZSIGyvMYAgECQsIBChVjb20ubWV0YWxzdGFjay5hcGkudjJCDE1hY2hpbmVQcm90b1ABWjVnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FwaS92MjthcGl2MqICA01BWKoCEU1ldGFsc3RhY2suQXBpLlYyygIRTWV0YWxzdGFja1xBcGlcVjLiAh1NZXRhbHN0YWNrXEFwaVxWMlxHUEJNZXRhZGF0YeoCE01ldGFsc3RhY2s6OkFwaTo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_google_protobuf_timestamp, file_metalstack_api_v2_common, file_metalstack_api_v2_filesystem, file_metalstack_api_v2_image, file_metalstack_api_v2_network, file_metalstack_api_v2_partition, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_size]);
 /**
  * Describes the message metalstack.api.v2.MachineServiceGetRequest.
  * Use `create(MachineServiceGetRequestSchema)` to create a new message.
@@ -586,7 +586,7 @@ export var MachineBMCCommand;
  */
 export const MachineBMCCommandSchema = /*@__PURE__*/ enumDesc(file_metalstack_api_v2_machine, 6);
 /**
- * MachineService serves machine related functions
+ * MachineService provides machine lifecycle management operations.
  *
  * @generated from service metalstack.api.v2.MachineService
  */
diff --git a/js/metalstack/api/v2/machine_pb.ts b/js/metalstack/api/v2/machine_pb.ts
index 3413fba0..62c54693 100644
--- a/js/metalstack/api/v2/machine_pb.ts
+++ b/js/metalstack/api/v2/machine_pb.ts
@@ -26,7 +26,7 @@ import type { Message } from "@bufbuild/protobuf";
  * Describes the file metalstack/api/v2/machine.proto.
  */
 export const file_metalstack_api_v2_machine: GenFile = /*@__PURE__*/
-  fileDesc("Ch9tZXRhbHN0YWNrL2FwaS92Mi9tYWNoaW5lLnByb3RvEhFtZXRhbHN0YWNrLmFwaS52MiJNChhNYWNoaW5lU2VydmljZUdldFJlcXVlc3QSFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESGQoHcHJvamVjdBgCIAEoCUIIukgFcgOwAQEiSAoZTWFjaGluZVNlcnZpY2VHZXRSZXNwb25zZRIrCgdtYWNoaW5lGAEgASgLMhoubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZSKLBwobTWFjaGluZVNlcnZpY2VDcmVhdGVSZXF1ZXN0EhkKB3Byb2plY3QYASABKAlCCLpIBXIDsAEBEhsKBHV1aWQYAiABKAlCCLpIBXIDsAEBSACIAQESGQoEbmFtZRgDIAEoCUILukgIcgbAs66xAgESJQoLZGVzY3JpcHRpb24YBCABKAlCC7pICHIGyLOusQIBSAGIAQESHgoIaG9zdG5hbWUYBSABKAlCB7pIBHICaAFIAogBARIeCglwYXJ0aXRpb24YBiABKAlCC7pICHIG0LOusQIBEhYKBHNpemUYByABKAlCCLpIBXIDGIABEhcKBWltYWdlGAggASgJQgi6SAVyAxiAARIeChFmaWxlc3lzdGVtX2xheW91dBgJIAEoCUgDiAEBEjAKD3NzaF9wdWJsaWNfa2V5cxgKIAMoCUIXukgUkgERyKSzsQIBEDIiB3IFEAEYgEASJgoIdXNlcmRhdGEYCyABKAlCD7pIDHIK8LOusQIBGICAAkgEiAEBEikKBmxhYmVscxgMIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLkxhYmVscxI9CghuZXR3b3JrcxgNIAMoCzIrLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uTmV0d29yaxIzCgNpcHMYDiADKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQWxsb2NhdGlvbklwEiAKDnBsYWNlbWVudF90YWdzGA8gAygJQgi6SAWSAQIQQBI7CgtkbnNfc2VydmVycxgQIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYESADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEksKD2FsbG9jYXRpb25fdHlwZRgSIAEoDjIoLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uVHlwZUIIukgFggECEAESNgoNZmlyZXdhbGxfc3BlYxgTIAEoCzIfLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsU3BlY0IHCgVfdXVpZEIOCgxfZGVzY3JpcHRpb25CCwoJX2hvc3RuYW1lQhQKEl9maWxlc3lzdGVtX2xheW91dEILCglfdXNlcmRhdGEiSAoMRmlyZXdhbGxTcGVjEjgKDmZpcmV3YWxsX3J1bGVzGAEgASgLMiAubWV0YWxzdGFjay5hcGkudjIuRmlyZXdhbGxSdWxlcyJLChxNYWNoaW5lU2VydmljZUNyZWF0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIrYCChtNYWNoaW5lU2VydmljZVVwZGF0ZVJlcXVlc3QSFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESOgoLdXBkYXRlX21ldGEYAiABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5VcGRhdGVNZXRhQga6SAPIAQESGQoHcHJvamVjdBgDIAEoCUIIukgFcgOwAQESJQoLZGVzY3JpcHRpb24YBCABKAlCC7pICHIGyLOusQIBSACIAQESNAoGbGFiZWxzGAUgASgLMh8ubWV0YWxzdGFjay5hcGkudjIuVXBkYXRlTGFiZWxzSAGIAQESMAoPc3NoX3B1YmxpY19rZXlzGAYgAygJQhe6SBSSARHIpLOxAgEQMiIHcgUQARiAQEIOCgxfZGVzY3JpcHRpb25CCQoHX2xhYmVscyJLChxNYWNoaW5lU2VydmljZVVwZGF0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lImYKGU1hY2hpbmVTZXJ2aWNlTGlzdFJlcXVlc3QSGQoHcHJvamVjdBgBIAEoCUIIukgFcgOwAQESLgoFcXVlcnkYAiABKAsyHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUXVlcnkiSgoaTWFjaGluZVNlcnZpY2VMaXN0UmVzcG9uc2USLAoIbWFjaGluZXMYASADKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIlAKG01hY2hpbmVTZXJ2aWNlRGVsZXRlUmVxdWVzdBIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIZCgdwcm9qZWN0GAIgASgJQgi6SAVyA7ABASJLChxNYWNoaW5lU2VydmljZURlbGV0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIpUBCh9NYWNoaW5lU2VydmljZUJNQ0NvbW1hbmRSZXF1ZXN0EhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEhkKB3Byb2plY3QYAiABKAlCCLpIBXIDsAEBEj8KB2NvbW1hbmQYAyABKA4yJC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DQ29tbWFuZEIIukgFggECEAEiIgogTWFjaGluZVNlcnZpY2VCTUNDb21tYW5kUmVzcG9uc2UiUAobTWFjaGluZVNlcnZpY2VHZXRCTUNSZXF1ZXN0EhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEhkKB3Byb2plY3QYAiABKAlCCLpIBXIDsAEBImgKHE1hY2hpbmVTZXJ2aWNlR2V0Qk1DUmVzcG9uc2USFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESMAoDYm1jGAIgASgLMiMubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUJNQ1JlcG9ydCKyAwoHTWFjaGluZRIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIlCgRtZXRhGAIgASgLMhcubWV0YWxzdGFjay5hcGkudjIuTWV0YRIvCglwYXJ0aXRpb24YAyABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24SFgoEcmFjaxgEIAEoCUIIukgFcgMYgAESJQoEc2l6ZRgFIAEoCzIXLm1ldGFsc3RhY2suYXBpLnYyLlNpemUSNAoIaGFyZHdhcmUYBiABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lSGFyZHdhcmUSOAoKYWxsb2NhdGlvbhgHIAEoCzIkLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uEjAKBnN0YXR1cxgIIAEoCzIgLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTdGF0dXMSVgoacmVjZW50X3Byb3Zpc2lvbmluZ19ldmVudHMYCSABKAsyMi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUmVjZW50UHJvdmlzaW9uaW5nRXZlbnRzIu8BCg1NYWNoaW5lU3RhdHVzEjYKCWNvbmRpdGlvbhgBIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVDb25kaXRpb24SRAoJbGVkX3N0YXRlGAIgASgLMjEubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUNoYXNzaXNJZGVudGlmeUxFRFN0YXRlEkIKCmxpdmVsaW5lc3MYAyABKA4yJC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTGl2ZWxpbmVzc0IIukgFggECEAESHAoUbWV0YWxfaGFtbWVyX3ZlcnNpb24YBCABKAkiiAEKEE1hY2hpbmVDb25kaXRpb24SOAoFc3RhdGUYASABKA4yHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU3RhdGVCCLpIBYIBAhABEiAKC2Rlc2NyaXB0aW9uGAIgASgJQgu6SAhyBsizrrECARIYCgZpc3N1ZXIYAyABKAlCCLpIBXIDGIACIoMGChFNYWNoaW5lQWxsb2NhdGlvbhIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIlCgRtZXRhGAIgASgLMhcubWV0YWxzdGFjay5hcGkudjIuTWV0YRIZCgRuYW1lGAMgASgJQgu6SAhyBsCzrrECARIgCgtkZXNjcmlwdGlvbhgEIAEoCUILukgIcgbIs66xAgESHAoKY3JlYXRlZF9ieRgFIAEoCUIIukgFcgMYgAESGQoHcHJvamVjdBgGIAEoCUIIukgFcgOwAQESJwoFaW1hZ2UYByABKAsyGC5tZXRhbHN0YWNrLmFwaS52Mi5JbWFnZRI+ChFmaWxlc3lzdGVtX2xheW91dBgIIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLkZpbGVzeXN0ZW1MYXlvdXQSMwoIbmV0d29ya3MYCSADKAsyIS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTmV0d29yaxIZCghob3N0bmFtZRgKIAEoCUIHukgEcgJoARIwCg9zc2hfcHVibGljX2tleXMYCyADKAlCF7pIFJIBEciks7ECARAyIgdyBRABGIBAEiEKCHVzZXJkYXRhGAwgASgJQg+6SAxyCvCzrrECARiAgAISSwoPYWxsb2NhdGlvbl90eXBlGA0gASgOMigubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25UeXBlQgi6SAWCAQIQARI4Cg5maXJld2FsbF9ydWxlcxgOIAEoCzIgLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsUnVsZXMSOwoLZG5zX3NlcnZlcnMYDyADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5ETlNTZXJ2ZXJCCLpIBZIBAhADEjsKC250cF9zZXJ2ZXJzGBAgAygLMhwubWV0YWxzdGFjay5hcGkudjIuTlRQU2VydmVyQgi6SAWSAQIQChIqCgN2cG4YESABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lVlBOInAKGE1hY2hpbmVBbGxvY2F0aW9uTmV0d29yaxIcCgduZXR3b3JrGAEgASgJQgu6SAhyBsCzrrECARIfChJub19hdXRvX2FjcXVpcmVfaXAYAiABKAhIAIgBAUIVChNfbm9fYXV0b19hY3F1aXJlX2lwIloKE01hY2hpbmVBbGxvY2F0aW9uSXASEwoCaXAYASABKAlCB7pIBHICcAESIAoJbmFtZXNwYWNlGAIgASgJQgi6SAVyA7ABAUgAiAEBQgwKCl9uYW1lc3BhY2UifwoNRmlyZXdhbGxSdWxlcxI1CgZlZ3Jlc3MYASADKAsyJS5tZXRhbHN0YWNrLmFwaS52Mi5GaXJld2FsbEVncmVzc1J1bGUSNwoHaW5ncmVzcxgCIAMoCzImLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsSW5ncmVzc1J1bGUisgEKEkZpcmV3YWxsRWdyZXNzUnVsZRI5Cghwcm90b2NvbBgBIAEoDjIdLm1ldGFsc3RhY2suYXBpLnYyLklQUHJvdG9jb2xCCLpIBYIBAhABEh0KBXBvcnRzGAIgAygNQg66SAuSAQgiBioEGPz/AxIYCgJ0bxgDIAMoCUIMukgJkgEGuKSzsQIBEigKB2NvbW1lbnQYBCABKAlCF7pIFNgBAXIPGGQyC15bYS16XyAtXSokIs8BChNGaXJld2FsbEluZ3Jlc3NSdWxlEjkKCHByb3RvY29sGAEgASgOMh0ubWV0YWxzdGFjay5hcGkudjIuSVBQcm90b2NvbEIIukgFggECEAESHQoFcG9ydHMYAiADKA1CDrpIC5IBCCIGKgQY/P8DEhgKAnRvGAMgAygJQgy6SAmSAQa4pLOxAgESGgoEZnJvbRgEIAMoCUIMukgJkgEGuKSzsQIBEigKB2NvbW1lbnQYBSABKAlCF7pIFNgBAXIPGGQyC15bYS16XyAtXSokIsYCCg5NYWNoaW5lTmV0d29yaxIPCgduZXR3b3JrGAEgASgJEh4KCHByZWZpeGVzGAIgAygJQgy6SAmSAQa4pLOxAgESKgoUZGVzdGluYXRpb25fcHJlZml4ZXMYAyADKAlCDLpICZIBBriks7ECARIZCgNpcHMYBCADKAlCDLpICZIBBsCks7ECARI+CgxuZXR3b3JrX3R5cGUYBSABKA4yHi5tZXRhbHN0YWNrLmFwaS52Mi5OZXR3b3JrVHlwZUIIukgFggECEAESNgoIbmF0X3R5cGUYBiABKA4yGi5tZXRhbHN0YWNrLmFwaS52Mi5OQVRUeXBlQgi6SAWCAQIQARILCgN2cmYYByABKAQSCwoDYXNuGAggASgNEh4KB3Byb2plY3QYCSABKAlCCLpIBXIDsAEBSACIAQFCCgoIX3Byb2plY3Qi2gEKD01hY2hpbmVIYXJkd2FyZRIOCgZtZW1vcnkYASABKAQSNAoFZGlza3MYAiADKAsyJS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQmxvY2tEZXZpY2USKQoEY3B1cxgDIAMoCzIbLm1ldGFsc3RhY2suYXBpLnYyLk1ldGFsQ1BVEikKBGdwdXMYBCADKAsyGy5tZXRhbHN0YWNrLmFwaS52Mi5NZXRhbEdQVRIrCgRuaWNzGAUgAygLMh0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pYyJdCghNZXRhbENQVRIYCgZ2ZW5kb3IYASABKAlCCLpIBXIDGIACEhcKBW1vZGVsGAIgASgJQgi6SAVyAxiAAhINCgVjb3JlcxgDIAEoDRIPCgd0aHJlYWRzGAQgASgNIj0KCE1ldGFsR1BVEhgKBnZlbmRvchgBIAEoCUIIukgFcgMYgAISFwoFbW9kZWwYAiABKAlCCLpIBXIDGIACIuUBCgpNYWNoaW5lTmljEhgKA21hYxgBIAEoCUILukgIcga4s66xAgESGQoEbmFtZRgCIAEoCUILukgIcgbAs66xAgESHAoKaWRlbnRpZmllchgDIAEoCUIIukgFcgMYgAESGAoGdmVuZG9yGAQgASgJQgi6SAVyAxiAARIXCgVtb2RlbBgFIAEoCUIIukgFcgMYgAESDQoFc3BlZWQYBiABKAQSMAoJbmVpZ2hib3JzGAcgAygLMh0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pYxIQCghob3N0bmFtZRgIIAEoCSI9ChJNYWNoaW5lQmxvY2tEZXZpY2USGQoEbmFtZRgBIAEoCUILukgIcgbAs66xAgESDAoEc2l6ZRgCIAEoBCJbCh5NYWNoaW5lQ2hhc3Npc0lkZW50aWZ5TEVEU3RhdGUSFwoFdmFsdWUYASABKAlCCLpIBXIDGIABEiAKC2Rlc2NyaXB0aW9uGAIgASgJQgu6SAhyBsizrrECASKKAwoQTWFjaGluZUJNQ1JlcG9ydBIqCgNibWMYASABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DEiwKBGJpb3MYAiABKAsyHi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQmlvcxIqCgNmcnUYAyABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lRlJVEjsKDHBvd2VyX21ldHJpYxgEIAEoCzIlLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQb3dlck1ldHJpYxI9Cg5wb3dlcl9zdXBwbGllcxgFIAMoCzIlLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQb3dlclN1cHBseRJECglsZWRfc3RhdGUYBiABKAsyMS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQ2hhc3Npc0lkZW50aWZ5TEVEU3RhdGUSLgoKdXBkYXRlZF9hdBgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiYwoLTWFjaGluZUJpb3MSHAoHdmVyc2lvbhgBIAEoCUILukgIcgbIs66xAgESGwoGdmVuZG9yGAIgASgJQgu6SAhyBsizrrECARIZCgRkYXRlGAMgASgJQgu6SAhyBsizrrECASLbAQoKTWFjaGluZUJNQxIZCgdhZGRyZXNzGAEgASgJQgi6SAVyA4ACARIYCgNtYWMYAiABKAlCC7pICHIGuLOusQIBEhkKBHVzZXIYAyABKAlCC7pICHIGyLOusQIBEh0KCHBhc3N3b3JkGAQgASgJQgu6SAhyBsizrrECARIeCglpbnRlcmZhY2UYBSABKAlCC7pICHIGyLOusQIBEhwKB3ZlcnNpb24YBiABKAlCC7pICHIGyLOusQIBEiAKC3Bvd2VyX3N0YXRlGAcgASgJQgu6SAhyBsizrrECASKeBAoKTWFjaGluZUZSVRItChNjaGFzc2lzX3BhcnRfbnVtYmVyGAEgASgJQgu6SAhyBsizrrECAUgAiAEBEi0KE2NoYXNzaXNfcGFydF9zZXJpYWwYAiABKAlCC7pICHIGyLOusQIBSAGIAQESIwoJYm9hcmRfbWZnGAMgASgJQgu6SAhyBsizrrECAUgCiAEBEioKEGJvYXJkX21mZ19zZXJpYWwYBCABKAlCC7pICHIGyLOusQIBSAOIAQESKwoRYm9hcmRfcGFydF9udW1iZXIYBSABKAlCC7pICHIGyLOusQIBSASIAQESLgoUcHJvZHVjdF9tYW51ZmFjdHVyZXIYBiABKAlCC7pICHIGyLOusQIBSAWIAQESLQoTcHJvZHVjdF9wYXJ0X251bWJlchgHIAEoCUILukgIcgbIs66xAgFIBogBARIoCg5wcm9kdWN0X3NlcmlhbBgIIAEoCUILukgIcgbIs66xAgFIB4gBAUIWChRfY2hhc3Npc19wYXJ0X251bWJlckIWChRfY2hhc3Npc19wYXJ0X3NlcmlhbEIMCgpfYm9hcmRfbWZnQhMKEV9ib2FyZF9tZmdfc2VyaWFsQhQKEl9ib2FyZF9wYXJ0X251bWJlckIXChVfcHJvZHVjdF9tYW51ZmFjdHVyZXJCFgoUX3Byb2R1Y3RfcGFydF9udW1iZXJCEQoPX3Byb2R1Y3Rfc2VyaWFsIoUBChJNYWNoaW5lUG93ZXJNZXRyaWMSHgoWYXZlcmFnZV9jb25zdW1lZF93YXR0cxgBIAEoAhIXCg9pbnRlcnZhbF9pbl9taW4YAiABKAISGgoSbWF4X2NvbnN1bWVkX3dhdHRzGAMgASgCEhoKEm1pbl9jb25zdW1lZF93YXR0cxgEIAEoAiIzChJNYWNoaW5lUG93ZXJTdXBwbHkSDgoGaGVhbHRoGAEgASgJEg0KBXN0YXRlGAIgASgJIqUCCh9NYWNoaW5lUmVjZW50UHJvdmlzaW9uaW5nRXZlbnRzEjsKBmV2ZW50cxgBIAMoCzIrLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQcm92aXNpb25pbmdFdmVudBIzCg9sYXN0X2V2ZW50X3RpbWUYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEkUKEGxhc3RfZXJyb3JfZXZlbnQYAyABKAsyKy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUHJvdmlzaW9uaW5nRXZlbnQSSQoFc3RhdGUYBCABKA4yMC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUHJvdmlzaW9uaW5nRXZlbnRTdGF0ZUIIukgFggECEAEilQEKGE1hY2hpbmVQcm92aXNpb25pbmdFdmVudBIoCgR0aW1lGAEgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI+CgVldmVudBgCIAEoDjIvLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQcm92aXNpb25pbmdFdmVudFR5cGUSDwoHbWVzc2FnZRgDIAEoCSJrCgpNYWNoaW5lVlBOEh0KFWNvbnRyb2xfcGxhbmVfYWRkcmVzcxgBIAEoCRIQCghhdXRoX2tleRgCIAEoCRIRCgljb25uZWN0ZWQYAyABKAgSGQoDaXBzGAQgAygJQgy6SAmSAQbApLOxAgEiugcKDE1hY2hpbmVRdWVyeRIbCgR1dWlkGAEgASgJQgi6SAVyA7ABAUgAiAEBEh4KBG5hbWUYAiABKAlCC7pICHIGwLOusQIBSAGIAQESIgoJcGFydGl0aW9uGAMgASgJQgq6SAdyBRACGIABSAKIAQESHQoEc2l6ZRgEIAEoCUIKukgHcgUQAhiAAUgDiAEBEh0KBHJhY2sYBSABKAlCCrpIB3IFEAIYgAFIBIgBARIuCgZsYWJlbHMYBiABKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5MYWJlbHNIBYgBARJCCgphbGxvY2F0aW9uGAcgASgLMikubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25RdWVyeUgGiAEBEjwKB25ldHdvcmsYCCABKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTmV0d29ya1F1ZXJ5SAeIAQESNAoDbmljGAkgASgLMiIubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pY1F1ZXJ5SAiIAQESNgoEZGlzaxgKIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVEaXNrUXVlcnlICYgBARI0CgNibWMYCyABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DUXVlcnlICogBARI0CgNmcnUYDCABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lRlJVUXVlcnlIC4gBARI+CghoYXJkd2FyZRgNIAEoCzInLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVIYXJkd2FyZVF1ZXJ5SAyIAQESMwoFc3RhdGUYDiABKA4yHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU3RhdGVIDYgBARIUCgd3YWl0aW5nGA8gASgISA6IAQESGQoMcHJlYWxsb2NhdGVkGBAgASgISA+IAQESGgoNbm90X2FsbG9jYXRlZBgRIAEoCEgQiAEBQgcKBV91dWlkQgcKBV9uYW1lQgwKCl9wYXJ0aXRpb25CBwoFX3NpemVCBwoFX3JhY2tCCQoHX2xhYmVsc0INCgtfYWxsb2NhdGlvbkIKCghfbmV0d29ya0IGCgRfbmljQgcKBV9kaXNrQgYKBF9ibWNCBgoEX2ZydUILCglfaGFyZHdhcmVCCAoGX3N0YXRlQgoKCF93YWl0aW5nQg8KDV9wcmVhbGxvY2F0ZWRCEAoOX25vdF9hbGxvY2F0ZWQiiQQKFk1hY2hpbmVBbGxvY2F0aW9uUXVlcnkSGwoEdXVpZBgBIAEoCUIIukgFcgOwAQFIAIgBARIeCgRuYW1lGAIgASgJQgu6SAhyBsCzrrECAUgBiAEBEh4KB3Byb2plY3QYAyABKAlCCLpIBXIDsAEBSAKIAQESHgoFaW1hZ2UYBCABKAlCCrpIB3IFEAIYgAFIA4gBARIqChFmaWxlc3lzdGVtX2xheW91dBgFIAEoCUIKukgHcgUQAhiAAUgEiAEBEiEKCGhvc3RuYW1lGAYgASgJQgq6SAdyBRACGIABSAWIAQESUAoPYWxsb2NhdGlvbl90eXBlGAcgASgOMigubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25UeXBlQgi6SAWCAQIQAUgGiAEBEi4KBmxhYmVscxgIIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLkxhYmVsc0gHiAEBEi8KA3ZwbhgJIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVWUE5ICIgBAUIHCgVfdXVpZEIHCgVfbmFtZUIKCghfcHJvamVjdEIICgZfaW1hZ2VCFAoSX2ZpbGVzeXN0ZW1fbGF5b3V0QgsKCV9ob3N0bmFtZUISChBfYWxsb2NhdGlvbl90eXBlQgkKB19sYWJlbHNCBgoEX3ZwbiKqAQoTTWFjaGluZU5ldHdvcmtRdWVyeRIQCghuZXR3b3JrcxgBIAMoCRIeCghwcmVmaXhlcxgCIAMoCUIMukgJkgEGuKSzsQIBEioKFGRlc3RpbmF0aW9uX3ByZWZpeGVzGAMgAygJQgy6SAmSAQa4pLOxAgESGQoDaXBzGAQgAygJQgy6SAmSAQbApLOxAgESDAoEdnJmcxgFIAMoBBIMCgRhc25zGAYgAygNIq8BCg9NYWNoaW5lTmljUXVlcnkSIgoEbWFjcxgBIAMoCUIUukgRkgEOEGQYASIIcga4s66xAgESIAoFbmFtZXMYAiADKAlCEbpIDpIBCxBkGAEiBXIDGIABEisKDW5laWdoYm9yX21hY3MYAyADKAlCFLpIEZIBDhBkGAEiCHIGuLOusQIBEikKDm5laWdoYm9yX25hbWVzGAQgAygJQhG6SA6SAQsQZBgBIgVyAxiAASJLChBNYWNoaW5lRGlza1F1ZXJ5Eh4KBW5hbWVzGAEgAygJQg+6SAySAQkQZCIFcgMYgAESFwoFc2l6ZXMYAiADKARCCLpIBZIBAhBkIrkBCg9NYWNoaW5lQk1DUXVlcnkSHQoHYWRkcmVzcxgBIAEoCUIHukgEcgJwAUgAiAEBEh0KA21hYxgCIAEoCUILukgIcga4s66xAgFIAYgBARIbCgR1c2VyGAMgASgJQgi6SAVyAxiAAUgCiAEBEiAKCWludGVyZmFjZRgEIAEoCUIIukgFcgMYgAFIA4gBAUIKCghfYWRkcmVzc0IGCgRfbWFjQgcKBV91c2VyQgwKCl9pbnRlcmZhY2UigwQKD01hY2hpbmVGUlVRdWVyeRIqChNjaGFzc2lzX3BhcnRfbnVtYmVyGAEgASgJQgi6SAVyAxiAAUgAiAEBEioKE2NoYXNzaXNfcGFydF9zZXJpYWwYAiABKAlCCLpIBXIDGIABSAGIAQESIAoJYm9hcmRfbWZnGAMgASgJQgi6SAVyAxiAAUgCiAEBEiMKDGJvYXJkX3NlcmlhbBgEIAEoCUIIukgFcgMYgAFIA4gBARIoChFib2FyZF9wYXJ0X251bWJlchgFIAEoCUIIukgFcgMYgAFIBIgBARIrChRwcm9kdWN0X21hbnVmYWN0dXJlchgGIAEoCUIIukgFcgMYgAFIBYgBARIqChNwcm9kdWN0X3BhcnRfbnVtYmVyGAcgASgJQgi6SAVyAxiAAUgGiAEBEiUKDnByb2R1Y3Rfc2VyaWFsGAggASgJQgi6SAVyAxiAAUgHiAEBQhYKFF9jaGFzc2lzX3BhcnRfbnVtYmVyQhYKFF9jaGFzc2lzX3BhcnRfc2VyaWFsQgwKCl9ib2FyZF9tZmdCDwoNX2JvYXJkX3NlcmlhbEIUChJfYm9hcmRfcGFydF9udW1iZXJCFwoVX3Byb2R1Y3RfbWFudWZhY3R1cmVyQhYKFF9wcm9kdWN0X3BhcnRfbnVtYmVyQhEKD19wcm9kdWN0X3NlcmlhbCJcChRNYWNoaW5lSGFyZHdhcmVRdWVyeRITCgZtZW1vcnkYASABKARIAIgBARIWCgljcHVfY29yZXMYAiABKA1IAYgBAUIJCgdfbWVtb3J5QgwKCl9jcHVfY29yZXMqZQoKSVBQcm90b2NvbBIbChdJUF9QUk9UT0NPTF9VTlNQRUNJRklFRBAAEhwKD0lQX1BST1RPQ09MX1RDUBABGgeCshkDdGNwEhwKD0lQX1BST1RPQ09MX1VEUBACGgeCshkDdWRwKq8BCgxNYWNoaW5lU3RhdGUSIwoZTUFDSElORV9TVEFURV9VTlNQRUNJRklFRBAAGgSCshkAEigKFk1BQ0hJTkVfU1RBVEVfUkVTRVJWRUQQARoMgrIZCHJlc2VydmVkEiQKFE1BQ0hJTkVfU1RBVEVfTE9DS0VEEAIaCoKyGQZsb2NrZWQSKgoXTUFDSElORV9TVEFURV9BVkFJTEFCTEUQAxoNgrIZCWF2YWlsYWJsZSrfAQodTWFjaGluZVByb3Zpc2lvbmluZ0V2ZW50U3RhdGUSNgosTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfU1RBVEVfVU5TUEVDSUZJRUQQABoEgrIZABI9CipNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9TVEFURV9DUkFTSExPT1AQARoNgrIZCWNyYXNobG9vcBJHCi9NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9TVEFURV9GQUlMRURfUkVDTEFJTRACGhKCshkOZmFpbGVkLXJlY2xhaW0qnwYKHE1hY2hpbmVQcm92aXNpb25pbmdFdmVudFR5cGUSLworTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9VTlNQRUNJRklFRBAAEjQKJU1BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfQUxJVkUQARoJgrIZBUFsaXZlEjgKJ01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfQ1JBU0hFRBACGguCshkHQ3Jhc2hlZBJACitNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BYRV9CT09USU5HEAMaD4KyGQtQWEUgQm9vdGluZxJGCi5NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BMQU5ORURfUkVCT09UEAQaEoKyGQ5QbGFubmVkIFJlYm9vdBI8CilNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BSRVBBUklORxAFGg2CshkJUHJlcGFyaW5nEkAKK01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfUkVHSVNURVJJTkcQBhoPgrIZC1JlZ2lzdGVyaW5nEjgKJ01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfV0FJVElORxAHGguCshkHV2FpdGluZxI+CipNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX0lOU1RBTExJTkcQCBoOgrIZCkluc3RhbGxpbmcSTgoyTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9CT09USU5HX05FV19LRVJORUwQCRoWgrIZEkJvb3RpbmcgTmV3IEtlcm5lbBJACitNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BIT05FRF9IT01FEAoaD4KyGQtQaG9uZWQgSG9tZRJICi9NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX01BQ0hJTkVfUkVDTEFJTRALGhOCshkPTWFjaGluZSBSZWNsYWltKroBChFNYWNoaW5lTGl2ZWxpbmVzcxIoCh5NQUNISU5FX0xJVkVMSU5FU1NfVU5TUEVDSUZJRUQQABoEgrIZABInChhNQUNISU5FX0xJVkVMSU5FU1NfQUxJVkUQARoJgrIZBWFsaXZlEiUKF01BQ0hJTkVfTElWRUxJTkVTU19ERUFEEAIaCIKyGQRkZWFkEisKGk1BQ0hJTkVfTElWRUxJTkVTU19VTktOT1dOEAMaC4KyGQd1bmtub3duKqwBChVNYWNoaW5lQWxsb2NhdGlvblR5cGUSLQojTUFDSElORV9BTExPQ0FUSU9OX1RZUEVfVU5TUEVDSUZJRUQQABoEgrIZABIwCh9NQUNISU5FX0FMTE9DQVRJT05fVFlQRV9NQUNISU5FEAEaC4KyGQdtYWNoaW5lEjIKIE1BQ0hJTkVfQUxMT0NBVElPTl9UWVBFX0ZJUkVXQUxMEAIaDIKyGQhmaXJld2FsbCr+BAoRTWFjaGluZUJNQ0NvbW1hbmQSIwofTUFDSElORV9CTUNfQ09NTUFORF9VTlNQRUNJRklFRBAAEiIKFk1BQ0hJTkVfQk1DX0NPTU1BTkRfT04QARoGgrIZAm9uEiQKF01BQ0hJTkVfQk1DX0NPTU1BTkRfT0ZGEAIaB4KyGQNvZmYSKAoZTUFDSElORV9CTUNfQ09NTUFORF9SRVNFVBADGgmCshkFcmVzZXQSKAoZTUFDSElORV9CTUNfQ09NTUFORF9DWUNMRRAEGgmCshkFY3ljbGUSNgogTUFDSElORV9CTUNfQ09NTUFORF9CT09UX1RPX0JJT1MQBRoQgrIZDGJvb3QtdG8tYmlvcxI6CiJNQUNISU5FX0JNQ19DT01NQU5EX0JPT1RfRlJPTV9ESVNLEAYaEoKyGQ5ib290LWZyb20tZGlzaxI4CiFNQUNISU5FX0JNQ19DT01NQU5EX0JPT1RfRlJPTV9QWEUQBxoRgrIZDWJvb3QtZnJvbS1weGUSPAojTUFDSElORV9CTUNfQ09NTUFORF9JREVOVElGWV9MRURfT04QCBoTgrIZD2lkZW50aWZ5LWxlZC1vbhI+CiRNQUNISU5FX0JNQ19DT01NQU5EX0lERU5USUZZX0xFRF9PRkYQCRoUgrIZEGlkZW50aWZ5LWxlZC1vZmYSPAojTUFDSElORV9CTUNfQ09NTUFORF9NQUNISU5FX0RFTEVURUQQChoTgrIZD21hY2hpbmUtZGVsZXRlZBI8CiNNQUNISU5FX0JNQ19DT01NQU5EX01BQ0hJTkVfQ1JFQVRFRBALGhOCshkPbWFjaGluZS1jcmVhdGVkMrwGCg5NYWNoaW5lU2VydmljZRJtCgNHZXQSKy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUdldFJlcXVlc3QaLC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUdldFJlc3BvbnNlIgvK8xgDAQID4PMYAhJxCgZDcmVhdGUSLi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUNyZWF0ZVJlcXVlc3QaLy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUNyZWF0ZVJlc3BvbnNlIgbK8xgCAQIScQoGVXBkYXRlEi4ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VVcGRhdGVSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VVcGRhdGVSZXNwb25zZSIGyvMYAgECEnAKBExpc3QSLC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUxpc3RSZXF1ZXN0Gi0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VMaXN0UmVzcG9uc2UiC8rzGAMBAgPg8xgCEnEKBkRlbGV0ZRIuLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlRGVsZXRlUmVxdWVzdBovLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlRGVsZXRlUmVzcG9uc2UiBsrzGAIBAhJ9CgpCTUNDb21tYW5kEjIubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VCTUNDb21tYW5kUmVxdWVzdBozLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlQk1DQ29tbWFuZFJlc3BvbnNlIgbK8xgCAQIScQoGR2V0Qk1DEi4ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VHZXRCTUNSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VHZXRCTUNSZXNwb25zZSIGyvMYAgECQsIBChVjb20ubWV0YWxzdGFjay5hcGkudjJCDE1hY2hpbmVQcm90b1ABWjVnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FwaS92MjthcGl2MqICA01BWKoCEU1ldGFsc3RhY2suQXBpLlYyygIRTWV0YWxzdGFja1xBcGlcVjLiAh1NZXRhbHN0YWNrXEFwaVxWMlxHUEJNZXRhZGF0YeoCE01ldGFsc3RhY2s6OkFwaTo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_google_protobuf_timestamp, file_metalstack_api_v2_common, file_metalstack_api_v2_filesystem, file_metalstack_api_v2_image, file_metalstack_api_v2_network, file_metalstack_api_v2_partition, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_size]);
+  fileDesc("Ch9tZXRhbHN0YWNrL2FwaS92Mi9tYWNoaW5lLnByb3RvEhFtZXRhbHN0YWNrLmFwaS52MiJNChhNYWNoaW5lU2VydmljZUdldFJlcXVlc3QSFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESGQoHcHJvamVjdBgCIAEoCUIIukgFcgOwAQEiSAoZTWFjaGluZVNlcnZpY2VHZXRSZXNwb25zZRIrCgdtYWNoaW5lGAEgASgLMhoubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZSKLBwobTWFjaGluZVNlcnZpY2VDcmVhdGVSZXF1ZXN0EhkKB3Byb2plY3QYASABKAlCCLpIBXIDsAEBEhsKBHV1aWQYAiABKAlCCLpIBXIDsAEBSACIAQESGQoEbmFtZRgDIAEoCUILukgIcgbAs66xAgESJQoLZGVzY3JpcHRpb24YBCABKAlCC7pICHIGyLOusQIBSAGIAQESHgoIaG9zdG5hbWUYBSABKAlCB7pIBHICaAFIAogBARIeCglwYXJ0aXRpb24YBiABKAlCC7pICHIG0LOusQIBEhYKBHNpemUYByABKAlCCLpIBXIDGIABEhcKBWltYWdlGAggASgJQgi6SAVyAxiAARIeChFmaWxlc3lzdGVtX2xheW91dBgJIAEoCUgDiAEBEjAKD3NzaF9wdWJsaWNfa2V5cxgKIAMoCUIXukgUkgER0KSzsQIBEDIiB3IFEAEYgEASJgoIdXNlcmRhdGEYCyABKAlCD7pIDHIK8LOusQIBGICAAkgEiAEBEikKBmxhYmVscxgMIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLkxhYmVscxI9CghuZXR3b3JrcxgNIAMoCzIrLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uTmV0d29yaxIzCgNpcHMYDiADKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQWxsb2NhdGlvbklwEiAKDnBsYWNlbWVudF90YWdzGA8gAygJQgi6SAWSAQIQQBI7CgtkbnNfc2VydmVycxgQIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYESADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEksKD2FsbG9jYXRpb25fdHlwZRgSIAEoDjIoLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uVHlwZUIIukgFggECEAESNgoNZmlyZXdhbGxfc3BlYxgTIAEoCzIfLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsU3BlY0IHCgVfdXVpZEIOCgxfZGVzY3JpcHRpb25CCwoJX2hvc3RuYW1lQhQKEl9maWxlc3lzdGVtX2xheW91dEILCglfdXNlcmRhdGEiSAoMRmlyZXdhbGxTcGVjEjgKDmZpcmV3YWxsX3J1bGVzGAEgASgLMiAubWV0YWxzdGFjay5hcGkudjIuRmlyZXdhbGxSdWxlcyJLChxNYWNoaW5lU2VydmljZUNyZWF0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIrYCChtNYWNoaW5lU2VydmljZVVwZGF0ZVJlcXVlc3QSFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESOgoLdXBkYXRlX21ldGEYAiABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5VcGRhdGVNZXRhQga6SAPIAQESGQoHcHJvamVjdBgDIAEoCUIIukgFcgOwAQESJQoLZGVzY3JpcHRpb24YBCABKAlCC7pICHIGyLOusQIBSACIAQESNAoGbGFiZWxzGAUgASgLMh8ubWV0YWxzdGFjay5hcGkudjIuVXBkYXRlTGFiZWxzSAGIAQESMAoPc3NoX3B1YmxpY19rZXlzGAYgAygJQhe6SBSSARHQpLOxAgEQMiIHcgUQARiAQEIOCgxfZGVzY3JpcHRpb25CCQoHX2xhYmVscyJLChxNYWNoaW5lU2VydmljZVVwZGF0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lImYKGU1hY2hpbmVTZXJ2aWNlTGlzdFJlcXVlc3QSGQoHcHJvamVjdBgBIAEoCUIIukgFcgOwAQESLgoFcXVlcnkYAiABKAsyHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUXVlcnkiSgoaTWFjaGluZVNlcnZpY2VMaXN0UmVzcG9uc2USLAoIbWFjaGluZXMYASADKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIlAKG01hY2hpbmVTZXJ2aWNlRGVsZXRlUmVxdWVzdBIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIZCgdwcm9qZWN0GAIgASgJQgi6SAVyA7ABASJLChxNYWNoaW5lU2VydmljZURlbGV0ZVJlc3BvbnNlEisKB21hY2hpbmUYASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lIpUBCh9NYWNoaW5lU2VydmljZUJNQ0NvbW1hbmRSZXF1ZXN0EhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEhkKB3Byb2plY3QYAiABKAlCCLpIBXIDsAEBEj8KB2NvbW1hbmQYAyABKA4yJC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DQ29tbWFuZEIIukgFggECEAEiIgogTWFjaGluZVNlcnZpY2VCTUNDb21tYW5kUmVzcG9uc2UiUAobTWFjaGluZVNlcnZpY2VHZXRCTUNSZXF1ZXN0EhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEhkKB3Byb2plY3QYAiABKAlCCLpIBXIDsAEBImgKHE1hY2hpbmVTZXJ2aWNlR2V0Qk1DUmVzcG9uc2USFgoEdXVpZBgBIAEoCUIIukgFcgOwAQESMAoDYm1jGAIgASgLMiMubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUJNQ1JlcG9ydCKyAwoHTWFjaGluZRIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIlCgRtZXRhGAIgASgLMhcubWV0YWxzdGFjay5hcGkudjIuTWV0YRIvCglwYXJ0aXRpb24YAyABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24SFgoEcmFjaxgEIAEoCUIIukgFcgMYgAESJQoEc2l6ZRgFIAEoCzIXLm1ldGFsc3RhY2suYXBpLnYyLlNpemUSNAoIaGFyZHdhcmUYBiABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lSGFyZHdhcmUSOAoKYWxsb2NhdGlvbhgHIAEoCzIkLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVBbGxvY2F0aW9uEjAKBnN0YXR1cxgIIAEoCzIgLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTdGF0dXMSVgoacmVjZW50X3Byb3Zpc2lvbmluZ19ldmVudHMYCSABKAsyMi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUmVjZW50UHJvdmlzaW9uaW5nRXZlbnRzIu8BCg1NYWNoaW5lU3RhdHVzEjYKCWNvbmRpdGlvbhgBIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVDb25kaXRpb24SRAoJbGVkX3N0YXRlGAIgASgLMjEubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUNoYXNzaXNJZGVudGlmeUxFRFN0YXRlEkIKCmxpdmVsaW5lc3MYAyABKA4yJC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTGl2ZWxpbmVzc0IIukgFggECEAESHAoUbWV0YWxfaGFtbWVyX3ZlcnNpb24YBCABKAkiiAEKEE1hY2hpbmVDb25kaXRpb24SOAoFc3RhdGUYASABKA4yHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU3RhdGVCCLpIBYIBAhABEiAKC2Rlc2NyaXB0aW9uGAIgASgJQgu6SAhyBsizrrECARIYCgZpc3N1ZXIYAyABKAlCCLpIBXIDGIACIoMGChFNYWNoaW5lQWxsb2NhdGlvbhIWCgR1dWlkGAEgASgJQgi6SAVyA7ABARIlCgRtZXRhGAIgASgLMhcubWV0YWxzdGFjay5hcGkudjIuTWV0YRIZCgRuYW1lGAMgASgJQgu6SAhyBsCzrrECARIgCgtkZXNjcmlwdGlvbhgEIAEoCUILukgIcgbIs66xAgESHAoKY3JlYXRlZF9ieRgFIAEoCUIIukgFcgMYgAESGQoHcHJvamVjdBgGIAEoCUIIukgFcgOwAQESJwoFaW1hZ2UYByABKAsyGC5tZXRhbHN0YWNrLmFwaS52Mi5JbWFnZRI+ChFmaWxlc3lzdGVtX2xheW91dBgIIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLkZpbGVzeXN0ZW1MYXlvdXQSMwoIbmV0d29ya3MYCSADKAsyIS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTmV0d29yaxIZCghob3N0bmFtZRgKIAEoCUIHukgEcgJoARIwCg9zc2hfcHVibGljX2tleXMYCyADKAlCF7pIFJIBEdCks7ECARAyIgdyBRABGIBAEiEKCHVzZXJkYXRhGAwgASgJQg+6SAxyCvCzrrECARiAgAISSwoPYWxsb2NhdGlvbl90eXBlGA0gASgOMigubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25UeXBlQgi6SAWCAQIQARI4Cg5maXJld2FsbF9ydWxlcxgOIAEoCzIgLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsUnVsZXMSOwoLZG5zX3NlcnZlcnMYDyADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5ETlNTZXJ2ZXJCCLpIBZIBAhADEjsKC250cF9zZXJ2ZXJzGBAgAygLMhwubWV0YWxzdGFjay5hcGkudjIuTlRQU2VydmVyQgi6SAWSAQIQChIqCgN2cG4YESABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lVlBOInAKGE1hY2hpbmVBbGxvY2F0aW9uTmV0d29yaxIcCgduZXR3b3JrGAEgASgJQgu6SAhyBsCzrrECARIfChJub19hdXRvX2FjcXVpcmVfaXAYAiABKAhIAIgBAUIVChNfbm9fYXV0b19hY3F1aXJlX2lwIloKE01hY2hpbmVBbGxvY2F0aW9uSXASEwoCaXAYASABKAlCB7pIBHICcAESIAoJbmFtZXNwYWNlGAIgASgJQgi6SAVyA7ABAUgAiAEBQgwKCl9uYW1lc3BhY2UifwoNRmlyZXdhbGxSdWxlcxI1CgZlZ3Jlc3MYASADKAsyJS5tZXRhbHN0YWNrLmFwaS52Mi5GaXJld2FsbEVncmVzc1J1bGUSNwoHaW5ncmVzcxgCIAMoCzImLm1ldGFsc3RhY2suYXBpLnYyLkZpcmV3YWxsSW5ncmVzc1J1bGUisgEKEkZpcmV3YWxsRWdyZXNzUnVsZRI5Cghwcm90b2NvbBgBIAEoDjIdLm1ldGFsc3RhY2suYXBpLnYyLklQUHJvdG9jb2xCCLpIBYIBAhABEh0KBXBvcnRzGAIgAygNQg66SAuSAQgiBioEGPz/AxIYCgJ0bxgDIAMoCUIMukgJkgEGuKSzsQIBEigKB2NvbW1lbnQYBCABKAlCF7pIFNgBAXIPGGQyC15bYS16XyAtXSokIs8BChNGaXJld2FsbEluZ3Jlc3NSdWxlEjkKCHByb3RvY29sGAEgASgOMh0ubWV0YWxzdGFjay5hcGkudjIuSVBQcm90b2NvbEIIukgFggECEAESHQoFcG9ydHMYAiADKA1CDrpIC5IBCCIGKgQY/P8DEhgKAnRvGAMgAygJQgy6SAmSAQa4pLOxAgESGgoEZnJvbRgEIAMoCUIMukgJkgEGuKSzsQIBEigKB2NvbW1lbnQYBSABKAlCF7pIFNgBAXIPGGQyC15bYS16XyAtXSokIsYCCg5NYWNoaW5lTmV0d29yaxIPCgduZXR3b3JrGAEgASgJEh4KCHByZWZpeGVzGAIgAygJQgy6SAmSAQa4pLOxAgESKgoUZGVzdGluYXRpb25fcHJlZml4ZXMYAyADKAlCDLpICZIBBriks7ECARIZCgNpcHMYBCADKAlCDLpICZIBBsCks7ECARI+CgxuZXR3b3JrX3R5cGUYBSABKA4yHi5tZXRhbHN0YWNrLmFwaS52Mi5OZXR3b3JrVHlwZUIIukgFggECEAESNgoIbmF0X3R5cGUYBiABKA4yGi5tZXRhbHN0YWNrLmFwaS52Mi5OQVRUeXBlQgi6SAWCAQIQARILCgN2cmYYByABKAQSCwoDYXNuGAggASgNEh4KB3Byb2plY3QYCSABKAlCCLpIBXIDsAEBSACIAQFCCgoIX3Byb2plY3Qi2gEKD01hY2hpbmVIYXJkd2FyZRIOCgZtZW1vcnkYASABKAQSNAoFZGlza3MYAiADKAsyJS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQmxvY2tEZXZpY2USKQoEY3B1cxgDIAMoCzIbLm1ldGFsc3RhY2suYXBpLnYyLk1ldGFsQ1BVEikKBGdwdXMYBCADKAsyGy5tZXRhbHN0YWNrLmFwaS52Mi5NZXRhbEdQVRIrCgRuaWNzGAUgAygLMh0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pYyJdCghNZXRhbENQVRIYCgZ2ZW5kb3IYASABKAlCCLpIBXIDGIACEhcKBW1vZGVsGAIgASgJQgi6SAVyAxiAAhINCgVjb3JlcxgDIAEoDRIPCgd0aHJlYWRzGAQgASgNIj0KCE1ldGFsR1BVEhgKBnZlbmRvchgBIAEoCUIIukgFcgMYgAISFwoFbW9kZWwYAiABKAlCCLpIBXIDGIACIuUBCgpNYWNoaW5lTmljEhgKA21hYxgBIAEoCUILukgIcga4s66xAgESGQoEbmFtZRgCIAEoCUILukgIcgbAs66xAgESHAoKaWRlbnRpZmllchgDIAEoCUIIukgFcgMYgAESGAoGdmVuZG9yGAQgASgJQgi6SAVyAxiAARIXCgVtb2RlbBgFIAEoCUIIukgFcgMYgAESDQoFc3BlZWQYBiABKAQSMAoJbmVpZ2hib3JzGAcgAygLMh0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pYxIQCghob3N0bmFtZRgIIAEoCSI9ChJNYWNoaW5lQmxvY2tEZXZpY2USGQoEbmFtZRgBIAEoCUILukgIcgbAs66xAgESDAoEc2l6ZRgCIAEoBCJbCh5NYWNoaW5lQ2hhc3Npc0lkZW50aWZ5TEVEU3RhdGUSFwoFdmFsdWUYASABKAlCCLpIBXIDGIABEiAKC2Rlc2NyaXB0aW9uGAIgASgJQgu6SAhyBsizrrECASKKAwoQTWFjaGluZUJNQ1JlcG9ydBIqCgNibWMYASABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DEiwKBGJpb3MYAiABKAsyHi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQmlvcxIqCgNmcnUYAyABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lRlJVEjsKDHBvd2VyX21ldHJpYxgEIAEoCzIlLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQb3dlck1ldHJpYxI9Cg5wb3dlcl9zdXBwbGllcxgFIAMoCzIlLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQb3dlclN1cHBseRJECglsZWRfc3RhdGUYBiABKAsyMS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQ2hhc3Npc0lkZW50aWZ5TEVEU3RhdGUSLgoKdXBkYXRlZF9hdBgHIAEoCzIaLmdvb2dsZS5wcm90b2J1Zi5UaW1lc3RhbXAiYwoLTWFjaGluZUJpb3MSHAoHdmVyc2lvbhgBIAEoCUILukgIcgbIs66xAgESGwoGdmVuZG9yGAIgASgJQgu6SAhyBsizrrECARIZCgRkYXRlGAMgASgJQgu6SAhyBsizrrECASLbAQoKTWFjaGluZUJNQxIZCgdhZGRyZXNzGAEgASgJQgi6SAVyA4ACARIYCgNtYWMYAiABKAlCC7pICHIGuLOusQIBEhkKBHVzZXIYAyABKAlCC7pICHIGyLOusQIBEh0KCHBhc3N3b3JkGAQgASgJQgu6SAhyBsizrrECARIeCglpbnRlcmZhY2UYBSABKAlCC7pICHIGyLOusQIBEhwKB3ZlcnNpb24YBiABKAlCC7pICHIGyLOusQIBEiAKC3Bvd2VyX3N0YXRlGAcgASgJQgu6SAhyBsizrrECASKeBAoKTWFjaGluZUZSVRItChNjaGFzc2lzX3BhcnRfbnVtYmVyGAEgASgJQgu6SAhyBsizrrECAUgAiAEBEi0KE2NoYXNzaXNfcGFydF9zZXJpYWwYAiABKAlCC7pICHIGyLOusQIBSAGIAQESIwoJYm9hcmRfbWZnGAMgASgJQgu6SAhyBsizrrECAUgCiAEBEioKEGJvYXJkX21mZ19zZXJpYWwYBCABKAlCC7pICHIGyLOusQIBSAOIAQESKwoRYm9hcmRfcGFydF9udW1iZXIYBSABKAlCC7pICHIGyLOusQIBSASIAQESLgoUcHJvZHVjdF9tYW51ZmFjdHVyZXIYBiABKAlCC7pICHIGyLOusQIBSAWIAQESLQoTcHJvZHVjdF9wYXJ0X251bWJlchgHIAEoCUILukgIcgbIs66xAgFIBogBARIoCg5wcm9kdWN0X3NlcmlhbBgIIAEoCUILukgIcgbIs66xAgFIB4gBAUIWChRfY2hhc3Npc19wYXJ0X251bWJlckIWChRfY2hhc3Npc19wYXJ0X3NlcmlhbEIMCgpfYm9hcmRfbWZnQhMKEV9ib2FyZF9tZmdfc2VyaWFsQhQKEl9ib2FyZF9wYXJ0X251bWJlckIXChVfcHJvZHVjdF9tYW51ZmFjdHVyZXJCFgoUX3Byb2R1Y3RfcGFydF9udW1iZXJCEQoPX3Byb2R1Y3Rfc2VyaWFsIoUBChJNYWNoaW5lUG93ZXJNZXRyaWMSHgoWYXZlcmFnZV9jb25zdW1lZF93YXR0cxgBIAEoAhIXCg9pbnRlcnZhbF9pbl9taW4YAiABKAISGgoSbWF4X2NvbnN1bWVkX3dhdHRzGAMgASgCEhoKEm1pbl9jb25zdW1lZF93YXR0cxgEIAEoAiIzChJNYWNoaW5lUG93ZXJTdXBwbHkSDgoGaGVhbHRoGAEgASgJEg0KBXN0YXRlGAIgASgJIqUCCh9NYWNoaW5lUmVjZW50UHJvdmlzaW9uaW5nRXZlbnRzEjsKBmV2ZW50cxgBIAMoCzIrLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQcm92aXNpb25pbmdFdmVudBIzCg9sYXN0X2V2ZW50X3RpbWUYAiABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEkUKEGxhc3RfZXJyb3JfZXZlbnQYAyABKAsyKy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUHJvdmlzaW9uaW5nRXZlbnQSSQoFc3RhdGUYBCABKA4yMC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUHJvdmlzaW9uaW5nRXZlbnRTdGF0ZUIIukgFggECEAEilQEKGE1hY2hpbmVQcm92aXNpb25pbmdFdmVudBIoCgR0aW1lGAEgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBI+CgVldmVudBgCIAEoDjIvLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVQcm92aXNpb25pbmdFdmVudFR5cGUSDwoHbWVzc2FnZRgDIAEoCSJrCgpNYWNoaW5lVlBOEh0KFWNvbnRyb2xfcGxhbmVfYWRkcmVzcxgBIAEoCRIQCghhdXRoX2tleRgCIAEoCRIRCgljb25uZWN0ZWQYAyABKAgSGQoDaXBzGAQgAygJQgy6SAmSAQbApLOxAgEiugcKDE1hY2hpbmVRdWVyeRIbCgR1dWlkGAEgASgJQgi6SAVyA7ABAUgAiAEBEh4KBG5hbWUYAiABKAlCC7pICHIGwLOusQIBSAGIAQESIgoJcGFydGl0aW9uGAMgASgJQgq6SAdyBRACGIABSAKIAQESHQoEc2l6ZRgEIAEoCUIKukgHcgUQAhiAAUgDiAEBEh0KBHJhY2sYBSABKAlCCrpIB3IFEAIYgAFIBIgBARIuCgZsYWJlbHMYBiABKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5MYWJlbHNIBYgBARJCCgphbGxvY2F0aW9uGAcgASgLMikubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25RdWVyeUgGiAEBEjwKB25ldHdvcmsYCCABKAsyJi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lTmV0d29ya1F1ZXJ5SAeIAQESNAoDbmljGAkgASgLMiIubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZU5pY1F1ZXJ5SAiIAQESNgoEZGlzaxgKIAEoCzIjLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVEaXNrUXVlcnlICYgBARI0CgNibWMYCyABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DUXVlcnlICogBARI0CgNmcnUYDCABKAsyIi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lRlJVUXVlcnlIC4gBARI+CghoYXJkd2FyZRgNIAEoCzInLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVIYXJkd2FyZVF1ZXJ5SAyIAQESMwoFc3RhdGUYDiABKA4yHy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU3RhdGVIDYgBARIUCgd3YWl0aW5nGA8gASgISA6IAQESGQoMcHJlYWxsb2NhdGVkGBAgASgISA+IAQESGgoNbm90X2FsbG9jYXRlZBgRIAEoCEgQiAEBQgcKBV91dWlkQgcKBV9uYW1lQgwKCl9wYXJ0aXRpb25CBwoFX3NpemVCBwoFX3JhY2tCCQoHX2xhYmVsc0INCgtfYWxsb2NhdGlvbkIKCghfbmV0d29ya0IGCgRfbmljQgcKBV9kaXNrQgYKBF9ibWNCBgoEX2ZydUILCglfaGFyZHdhcmVCCAoGX3N0YXRlQgoKCF93YWl0aW5nQg8KDV9wcmVhbGxvY2F0ZWRCEAoOX25vdF9hbGxvY2F0ZWQiiQQKFk1hY2hpbmVBbGxvY2F0aW9uUXVlcnkSGwoEdXVpZBgBIAEoCUIIukgFcgOwAQFIAIgBARIeCgRuYW1lGAIgASgJQgu6SAhyBsCzrrECAUgBiAEBEh4KB3Byb2plY3QYAyABKAlCCLpIBXIDsAEBSAKIAQESHgoFaW1hZ2UYBCABKAlCCrpIB3IFEAIYgAFIA4gBARIqChFmaWxlc3lzdGVtX2xheW91dBgFIAEoCUIKukgHcgUQAhiAAUgEiAEBEiEKCGhvc3RuYW1lGAYgASgJQgq6SAdyBRACGIABSAWIAQESUAoPYWxsb2NhdGlvbl90eXBlGAcgASgOMigubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUFsbG9jYXRpb25UeXBlQgi6SAWCAQIQAUgGiAEBEi4KBmxhYmVscxgIIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLkxhYmVsc0gHiAEBEi8KA3ZwbhgJIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVWUE5ICIgBAUIHCgVfdXVpZEIHCgVfbmFtZUIKCghfcHJvamVjdEIICgZfaW1hZ2VCFAoSX2ZpbGVzeXN0ZW1fbGF5b3V0QgsKCV9ob3N0bmFtZUISChBfYWxsb2NhdGlvbl90eXBlQgkKB19sYWJlbHNCBgoEX3ZwbiKqAQoTTWFjaGluZU5ldHdvcmtRdWVyeRIQCghuZXR3b3JrcxgBIAMoCRIeCghwcmVmaXhlcxgCIAMoCUIMukgJkgEGuKSzsQIBEioKFGRlc3RpbmF0aW9uX3ByZWZpeGVzGAMgAygJQgy6SAmSAQa4pLOxAgESGQoDaXBzGAQgAygJQgy6SAmSAQbApLOxAgESDAoEdnJmcxgFIAMoBBIMCgRhc25zGAYgAygNIq8BCg9NYWNoaW5lTmljUXVlcnkSIgoEbWFjcxgBIAMoCUIUukgRkgEOEGQYASIIcga4s66xAgESIAoFbmFtZXMYAiADKAlCEbpIDpIBCxBkGAEiBXIDGIABEisKDW5laWdoYm9yX21hY3MYAyADKAlCFLpIEZIBDhBkGAEiCHIGuLOusQIBEikKDm5laWdoYm9yX25hbWVzGAQgAygJQhG6SA6SAQsQZBgBIgVyAxiAASJLChBNYWNoaW5lRGlza1F1ZXJ5Eh4KBW5hbWVzGAEgAygJQg+6SAySAQkQZCIFcgMYgAESFwoFc2l6ZXMYAiADKARCCLpIBZIBAhBkIrkBCg9NYWNoaW5lQk1DUXVlcnkSHQoHYWRkcmVzcxgBIAEoCUIHukgEcgJwAUgAiAEBEh0KA21hYxgCIAEoCUILukgIcga4s66xAgFIAYgBARIbCgR1c2VyGAMgASgJQgi6SAVyAxiAAUgCiAEBEiAKCWludGVyZmFjZRgEIAEoCUIIukgFcgMYgAFIA4gBAUIKCghfYWRkcmVzc0IGCgRfbWFjQgcKBV91c2VyQgwKCl9pbnRlcmZhY2UigwQKD01hY2hpbmVGUlVRdWVyeRIqChNjaGFzc2lzX3BhcnRfbnVtYmVyGAEgASgJQgi6SAVyAxiAAUgAiAEBEioKE2NoYXNzaXNfcGFydF9zZXJpYWwYAiABKAlCCLpIBXIDGIABSAGIAQESIAoJYm9hcmRfbWZnGAMgASgJQgi6SAVyAxiAAUgCiAEBEiMKDGJvYXJkX3NlcmlhbBgEIAEoCUIIukgFcgMYgAFIA4gBARIoChFib2FyZF9wYXJ0X251bWJlchgFIAEoCUIIukgFcgMYgAFIBIgBARIrChRwcm9kdWN0X21hbnVmYWN0dXJlchgGIAEoCUIIukgFcgMYgAFIBYgBARIqChNwcm9kdWN0X3BhcnRfbnVtYmVyGAcgASgJQgi6SAVyAxiAAUgGiAEBEiUKDnByb2R1Y3Rfc2VyaWFsGAggASgJQgi6SAVyAxiAAUgHiAEBQhYKFF9jaGFzc2lzX3BhcnRfbnVtYmVyQhYKFF9jaGFzc2lzX3BhcnRfc2VyaWFsQgwKCl9ib2FyZF9tZmdCDwoNX2JvYXJkX3NlcmlhbEIUChJfYm9hcmRfcGFydF9udW1iZXJCFwoVX3Byb2R1Y3RfbWFudWZhY3R1cmVyQhYKFF9wcm9kdWN0X3BhcnRfbnVtYmVyQhEKD19wcm9kdWN0X3NlcmlhbCJcChRNYWNoaW5lSGFyZHdhcmVRdWVyeRITCgZtZW1vcnkYASABKARIAIgBARIWCgljcHVfY29yZXMYAiABKA1IAYgBAUIJCgdfbWVtb3J5QgwKCl9jcHVfY29yZXMqZQoKSVBQcm90b2NvbBIbChdJUF9QUk9UT0NPTF9VTlNQRUNJRklFRBAAEhwKD0lQX1BST1RPQ09MX1RDUBABGgeCshkDdGNwEhwKD0lQX1BST1RPQ09MX1VEUBACGgeCshkDdWRwKq8BCgxNYWNoaW5lU3RhdGUSIwoZTUFDSElORV9TVEFURV9VTlNQRUNJRklFRBAAGgSCshkAEigKFk1BQ0hJTkVfU1RBVEVfUkVTRVJWRUQQARoMgrIZCHJlc2VydmVkEiQKFE1BQ0hJTkVfU1RBVEVfTE9DS0VEEAIaCoKyGQZsb2NrZWQSKgoXTUFDSElORV9TVEFURV9BVkFJTEFCTEUQAxoNgrIZCWF2YWlsYWJsZSrfAQodTWFjaGluZVByb3Zpc2lvbmluZ0V2ZW50U3RhdGUSNgosTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfU1RBVEVfVU5TUEVDSUZJRUQQABoEgrIZABI9CipNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9TVEFURV9DUkFTSExPT1AQARoNgrIZCWNyYXNobG9vcBJHCi9NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9TVEFURV9GQUlMRURfUkVDTEFJTRACGhKCshkOZmFpbGVkLXJlY2xhaW0qnwYKHE1hY2hpbmVQcm92aXNpb25pbmdFdmVudFR5cGUSLworTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9VTlNQRUNJRklFRBAAEjQKJU1BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfQUxJVkUQARoJgrIZBUFsaXZlEjgKJ01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfQ1JBU0hFRBACGguCshkHQ3Jhc2hlZBJACitNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BYRV9CT09USU5HEAMaD4KyGQtQWEUgQm9vdGluZxJGCi5NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BMQU5ORURfUkVCT09UEAQaEoKyGQ5QbGFubmVkIFJlYm9vdBI8CilNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BSRVBBUklORxAFGg2CshkJUHJlcGFyaW5nEkAKK01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfUkVHSVNURVJJTkcQBhoPgrIZC1JlZ2lzdGVyaW5nEjgKJ01BQ0hJTkVfUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfV0FJVElORxAHGguCshkHV2FpdGluZxI+CipNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX0lOU1RBTExJTkcQCBoOgrIZCkluc3RhbGxpbmcSTgoyTUFDSElORV9QUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9CT09USU5HX05FV19LRVJORUwQCRoWgrIZEkJvb3RpbmcgTmV3IEtlcm5lbBJACitNQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BIT05FRF9IT01FEAoaD4KyGQtQaG9uZWQgSG9tZRJICi9NQUNISU5FX1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX01BQ0hJTkVfUkVDTEFJTRALGhOCshkPTWFjaGluZSBSZWNsYWltKroBChFNYWNoaW5lTGl2ZWxpbmVzcxIoCh5NQUNISU5FX0xJVkVMSU5FU1NfVU5TUEVDSUZJRUQQABoEgrIZABInChhNQUNISU5FX0xJVkVMSU5FU1NfQUxJVkUQARoJgrIZBWFsaXZlEiUKF01BQ0hJTkVfTElWRUxJTkVTU19ERUFEEAIaCIKyGQRkZWFkEisKGk1BQ0hJTkVfTElWRUxJTkVTU19VTktOT1dOEAMaC4KyGQd1bmtub3duKqwBChVNYWNoaW5lQWxsb2NhdGlvblR5cGUSLQojTUFDSElORV9BTExPQ0FUSU9OX1RZUEVfVU5TUEVDSUZJRUQQABoEgrIZABIwCh9NQUNISU5FX0FMTE9DQVRJT05fVFlQRV9NQUNISU5FEAEaC4KyGQdtYWNoaW5lEjIKIE1BQ0hJTkVfQUxMT0NBVElPTl9UWVBFX0ZJUkVXQUxMEAIaDIKyGQhmaXJld2FsbCr+BAoRTWFjaGluZUJNQ0NvbW1hbmQSIwofTUFDSElORV9CTUNfQ09NTUFORF9VTlNQRUNJRklFRBAAEiIKFk1BQ0hJTkVfQk1DX0NPTU1BTkRfT04QARoGgrIZAm9uEiQKF01BQ0hJTkVfQk1DX0NPTU1BTkRfT0ZGEAIaB4KyGQNvZmYSKAoZTUFDSElORV9CTUNfQ09NTUFORF9SRVNFVBADGgmCshkFcmVzZXQSKAoZTUFDSElORV9CTUNfQ09NTUFORF9DWUNMRRAEGgmCshkFY3ljbGUSNgogTUFDSElORV9CTUNfQ09NTUFORF9CT09UX1RPX0JJT1MQBRoQgrIZDGJvb3QtdG8tYmlvcxI6CiJNQUNISU5FX0JNQ19DT01NQU5EX0JPT1RfRlJPTV9ESVNLEAYaEoKyGQ5ib290LWZyb20tZGlzaxI4CiFNQUNISU5FX0JNQ19DT01NQU5EX0JPT1RfRlJPTV9QWEUQBxoRgrIZDWJvb3QtZnJvbS1weGUSPAojTUFDSElORV9CTUNfQ09NTUFORF9JREVOVElGWV9MRURfT04QCBoTgrIZD2lkZW50aWZ5LWxlZC1vbhI+CiRNQUNISU5FX0JNQ19DT01NQU5EX0lERU5USUZZX0xFRF9PRkYQCRoUgrIZEGlkZW50aWZ5LWxlZC1vZmYSPAojTUFDSElORV9CTUNfQ09NTUFORF9NQUNISU5FX0RFTEVURUQQChoTgrIZD21hY2hpbmUtZGVsZXRlZBI8CiNNQUNISU5FX0JNQ19DT01NQU5EX01BQ0hJTkVfQ1JFQVRFRBALGhOCshkPbWFjaGluZS1jcmVhdGVkMrwGCg5NYWNoaW5lU2VydmljZRJtCgNHZXQSKy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUdldFJlcXVlc3QaLC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUdldFJlc3BvbnNlIgvK8xgDAQID4PMYAhJxCgZDcmVhdGUSLi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUNyZWF0ZVJlcXVlc3QaLy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUNyZWF0ZVJlc3BvbnNlIgbK8xgCAQIScQoGVXBkYXRlEi4ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VVcGRhdGVSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VVcGRhdGVSZXNwb25zZSIGyvMYAgECEnAKBExpc3QSLC5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lU2VydmljZUxpc3RSZXF1ZXN0Gi0ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VMaXN0UmVzcG9uc2UiC8rzGAMBAgPg8xgCEnEKBkRlbGV0ZRIuLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlRGVsZXRlUmVxdWVzdBovLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlRGVsZXRlUmVzcG9uc2UiBsrzGAIBAhJ9CgpCTUNDb21tYW5kEjIubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VCTUNDb21tYW5kUmVxdWVzdBozLm1ldGFsc3RhY2suYXBpLnYyLk1hY2hpbmVTZXJ2aWNlQk1DQ29tbWFuZFJlc3BvbnNlIgbK8xgCAQIScQoGR2V0Qk1DEi4ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VHZXRCTUNSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZVNlcnZpY2VHZXRCTUNSZXNwb25zZSIGyvMYAgECQsIBChVjb20ubWV0YWxzdGFjay5hcGkudjJCDE1hY2hpbmVQcm90b1ABWjVnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FwaS92MjthcGl2MqICA01BWKoCEU1ldGFsc3RhY2suQXBpLlYyygIRTWV0YWxzdGFja1xBcGlcVjLiAh1NZXRhbHN0YWNrXEFwaVxWMlxHUEJNZXRhZGF0YeoCE01ldGFsc3RhY2s6OkFwaTo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_google_protobuf_timestamp, file_metalstack_api_v2_common, file_metalstack_api_v2_filesystem, file_metalstack_api_v2_image, file_metalstack_api_v2_network, file_metalstack_api_v2_partition, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_size]);
 
 /**
  * MachineServiceGetRequest is the request payload for a machine get request
@@ -2625,13 +2625,13 @@ export const MachineBMCCommandSchema: GenEnum<MachineBMCCommand> = /*@__PURE__*/
   enumDesc(file_metalstack_api_v2_machine, 6);
 
 /**
- * MachineService serves machine related functions
+ * MachineService provides machine lifecycle management operations.
  *
  * @generated from service metalstack.api.v2.MachineService
  */
 export const MachineService: GenService<{
   /**
-   * Get a machine
+   * Returns the machine with the specified UUID.
    *
    * @generated from rpc metalstack.api.v2.MachineService.Get
    */
@@ -2641,7 +2641,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceGetResponseSchema;
   },
   /**
-   * Create a machine
+   * Creates a new machine.
    *
    * @generated from rpc metalstack.api.v2.MachineService.Create
    */
@@ -2651,7 +2651,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceCreateResponseSchema;
   },
   /**
-   * Update a machine
+   * Updates a machine.
    *
    * @generated from rpc metalstack.api.v2.MachineService.Update
    */
@@ -2661,7 +2661,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceUpdateResponseSchema;
   },
   /**
-   * List all machines
+   * Returns the list of all machines.
    *
    * @generated from rpc metalstack.api.v2.MachineService.List
    */
@@ -2671,7 +2671,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceListResponseSchema;
   },
   /**
-   * Delete a machine
+   * Deletes a machine.
    *
    * @generated from rpc metalstack.api.v2.MachineService.Delete
    */
@@ -2681,7 +2681,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceDeleteResponseSchema;
   },
   /**
-   * BMCCommand send a command to the bmc of a machine
+   * BMCCommand sends a command to the BMC of a machine.
    *
    * @generated from rpc metalstack.api.v2.MachineService.BMCCommand
    */
@@ -2691,7 +2691,7 @@ export const MachineService: GenService<{
     output: typeof MachineServiceBMCCommandResponseSchema;
   },
   /**
-   * GetBMC returns the BMC details of a machine
+   * Returns the BMC details of a machine.
    *
    * @generated from rpc metalstack.api.v2.MachineService.GetBMC
    */
diff --git a/js/metalstack/api/v2/method_pb.d.ts b/js/metalstack/api/v2/method_pb.d.ts
index 502e7ce3..1ca19939 100644
--- a/js/metalstack/api/v2/method_pb.d.ts
+++ b/js/metalstack/api/v2/method_pb.d.ts
@@ -7,7 +7,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_api_v2_method: GenFile;
 /**
- * MethodServiceListRequest is the request payload to list all public methods
+ * MethodServiceListRequest is the request payload for listing all public methods.
  *
  * @generated from message metalstack.api.v2.MethodServiceListRequest
  */
@@ -18,7 +18,7 @@ export type MethodServiceListRequest = Message<"metalstack.api.v2.MethodServiceL
  */
 export declare const MethodServiceListRequestSchema: GenMessage<MethodServiceListRequest>;
 /**
- * MethodServiceListResponse is the response payload with all public visible methods
+ * MethodServiceListResponse is the response payload for listing all public methods.
  *
  * @generated from message metalstack.api.v2.MethodServiceListResponse
  */
@@ -36,7 +36,7 @@ export type MethodServiceListResponse = Message<"metalstack.api.v2.MethodService
  */
 export declare const MethodServiceListResponseSchema: GenMessage<MethodServiceListResponse>;
 /**
- * MethodServiceTokenScopedListRequest is the request payload to list all methods callable with the token present in the request
+ * MethodServiceTokenScopedListRequest is the request payload for listing all methods callable with the token present in the request.
  *
  * @generated from message metalstack.api.v2.MethodServiceTokenScopedListRequest
  */
@@ -47,19 +47,19 @@ export type MethodServiceTokenScopedListRequest = Message<"metalstack.api.v2.Met
  */
 export declare const MethodServiceTokenScopedListRequestSchema: GenMessage<MethodServiceTokenScopedListRequest>;
 /**
- * MethodServiceTokenScopedListResponse is the response payload which contains all methods which are callable with the given token
+ * MethodServiceTokenScopedListResponse is the response payload which contains all methods which are callable with the given token.
  *
  * @generated from message metalstack.api.v2.MethodServiceTokenScopedListResponse
  */
 export type MethodServiceTokenScopedListResponse = Message<"metalstack.api.v2.MethodServiceTokenScopedListResponse"> & {
     /**
-     * Permissions a list of methods which can be called
+     * Permissions contains a list of methods which can be called
      *
      * @generated from field: repeated metalstack.api.v2.MethodPermission permissions = 1;
      */
     permissions: MethodPermission[];
     /**
-     * ProjectRoles associates a project id with the corresponding role of the token owner
+     * ProjectRoles associates a project ID with the corresponding role of the token owner
      *
      * @generated from field: map<string, metalstack.api.v2.ProjectRole> project_roles = 2;
      */
@@ -67,7 +67,7 @@ export type MethodServiceTokenScopedListResponse = Message<"metalstack.api.v2.Me
         [key: string]: ProjectRole;
     };
     /**
-     * TenantRoles associates a tenant id with the corresponding role of the token owner
+     * TenantRoles associates a tenant ID with the corresponding role of the token owner
      *
      * @generated from field: map<string, metalstack.api.v2.TenantRole> tenant_roles = 3;
      */
@@ -101,14 +101,14 @@ export type MethodServiceTokenScopedListResponse = Message<"metalstack.api.v2.Me
  */
 export declare const MethodServiceTokenScopedListResponseSchema: GenMessage<MethodServiceTokenScopedListResponse>;
 /**
- * MethodService serves method related functions
- * methods are functions in services
+ * MethodService provides method discovery operations.
+ * Methods are functions in services.
  *
  * @generated from service metalstack.api.v2.MethodService
  */
 export declare const MethodService: GenService<{
     /**
-     * List all public visible methods
+     * Returns the list of all public visible methods.
      *
      * @generated from rpc metalstack.api.v2.MethodService.List
      */
@@ -118,7 +118,7 @@ export declare const MethodService: GenService<{
         output: typeof MethodServiceListResponseSchema;
     };
     /**
-     * TokenScopedList all methods callable with the token present in the request
+     * TokenScopedList returns all methods callable with the token present in the request.
      *
      * @generated from rpc metalstack.api.v2.MethodService.TokenScopedList
      */
diff --git a/js/metalstack/api/v2/method_pb.js b/js/metalstack/api/v2/method_pb.js
index f2d5af3c..7041d6da 100644
--- a/js/metalstack/api/v2/method_pb.js
+++ b/js/metalstack/api/v2/method_pb.js
@@ -30,8 +30,8 @@ export const MethodServiceTokenScopedListRequestSchema = /*@__PURE__*/ messageDe
  */
 export const MethodServiceTokenScopedListResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_api_v2_method, 3);
 /**
- * MethodService serves method related functions
- * methods are functions in services
+ * MethodService provides method discovery operations.
+ * Methods are functions in services.
  *
  * @generated from service metalstack.api.v2.MethodService
  */
diff --git a/js/metalstack/api/v2/method_pb.ts b/js/metalstack/api/v2/method_pb.ts
index beb1a900..34e3798c 100644
--- a/js/metalstack/api/v2/method_pb.ts
+++ b/js/metalstack/api/v2/method_pb.ts
@@ -18,7 +18,7 @@ export const file_metalstack_api_v2_method: GenFile = /*@__PURE__*/
   fileDesc("Ch5tZXRhbHN0YWNrL2FwaS92Mi9tZXRob2QucHJvdG8SEW1ldGFsc3RhY2suYXBpLnYyIhoKGE1ldGhvZFNlcnZpY2VMaXN0UmVxdWVzdCIsChlNZXRob2RTZXJ2aWNlTGlzdFJlc3BvbnNlEg8KB21ldGhvZHMYASADKAkiJQojTWV0aG9kU2VydmljZVRva2VuU2NvcGVkTGlzdFJlcXVlc3QioQYKJE1ldGhvZFNlcnZpY2VUb2tlblNjb3BlZExpc3RSZXNwb25zZRI4CgtwZXJtaXNzaW9ucxgBIAMoCzIjLm1ldGFsc3RhY2suYXBpLnYyLk1ldGhvZFBlcm1pc3Npb24SYAoNcHJvamVjdF9yb2xlcxgCIAMoCzJJLm1ldGFsc3RhY2suYXBpLnYyLk1ldGhvZFNlcnZpY2VUb2tlblNjb3BlZExpc3RSZXNwb25zZS5Qcm9qZWN0Um9sZXNFbnRyeRJeCgx0ZW5hbnRfcm9sZXMYAyADKAsySC5tZXRhbHN0YWNrLmFwaS52Mi5NZXRob2RTZXJ2aWNlVG9rZW5TY29wZWRMaXN0UmVzcG9uc2UuVGVuYW50Um9sZXNFbnRyeRI/CgphZG1pbl9yb2xlGAQgASgOMhwubWV0YWxzdGFjay5hcGkudjIuQWRtaW5Sb2xlQgi6SAWCAQIQAUgAiAEBEj8KCmluZnJhX3JvbGUYBSABKA4yHC5tZXRhbHN0YWNrLmFwaS52Mi5JbmZyYVJvbGVCCLpIBYIBAhABSAGIAQESYAoNbWFjaGluZV9yb2xlcxgGIAMoCzJJLm1ldGFsc3RhY2suYXBpLnYyLk1ldGhvZFNlcnZpY2VUb2tlblNjb3BlZExpc3RSZXNwb25zZS5NYWNoaW5lUm9sZXNFbnRyeRpTChFQcm9qZWN0Um9sZXNFbnRyeRILCgNrZXkYASABKAkSLQoFdmFsdWUYAiABKA4yHi5tZXRhbHN0YWNrLmFwaS52Mi5Qcm9qZWN0Um9sZToCOAEaUQoQVGVuYW50Um9sZXNFbnRyeRILCgNrZXkYASABKAkSLAoFdmFsdWUYAiABKA4yHS5tZXRhbHN0YWNrLmFwaS52Mi5UZW5hbnRSb2xlOgI4ARpTChFNYWNoaW5lUm9sZXNFbnRyeRILCgNrZXkYASABKAkSLQoFdmFsdWUYAiABKA4yHi5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lUm9sZToCOAFCDQoLX2FkbWluX3JvbGVCDQoLX2luZnJhX3JvbGUygwIKDU1ldGhvZFNlcnZpY2USZwoETGlzdBIrLm1ldGFsc3RhY2suYXBpLnYyLk1ldGhvZFNlcnZpY2VMaXN0UmVxdWVzdBosLm1ldGFsc3RhY2suYXBpLnYyLk1ldGhvZFNlcnZpY2VMaXN0UmVzcG9uc2UiBNjzGAESiAEKD1Rva2VuU2NvcGVkTGlzdBI2Lm1ldGFsc3RhY2suYXBpLnYyLk1ldGhvZFNlcnZpY2VUb2tlblNjb3BlZExpc3RSZXF1ZXN0GjcubWV0YWxzdGFjay5hcGkudjIuTWV0aG9kU2VydmljZVRva2VuU2NvcGVkTGlzdFJlc3BvbnNlIgTY8xgDQsEBChVjb20ubWV0YWxzdGFjay5hcGkudjJCC01ldGhvZFByb3RvUAFaNWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYXBpL3YyO2FwaXYyogIDTUFYqgIRTWV0YWxzdGFjay5BcGkuVjLKAhFNZXRhbHN0YWNrXEFwaVxWMuICHU1ldGFsc3RhY2tcQXBpXFYyXEdQQk1ldGFkYXRh6gITTWV0YWxzdGFjazo6QXBpOjpWMmIGcHJvdG8z", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_token]);
 
 /**
- * MethodServiceListRequest is the request payload to list all public methods
+ * MethodServiceListRequest is the request payload for listing all public methods.
  *
  * @generated from message metalstack.api.v2.MethodServiceListRequest
  */
@@ -33,7 +33,7 @@ export const MethodServiceListRequestSchema: GenMessage<MethodServiceListRequest
   messageDesc(file_metalstack_api_v2_method, 0);
 
 /**
- * MethodServiceListResponse is the response payload with all public visible methods
+ * MethodServiceListResponse is the response payload for listing all public methods.
  *
  * @generated from message metalstack.api.v2.MethodServiceListResponse
  */
@@ -54,7 +54,7 @@ export const MethodServiceListResponseSchema: GenMessage<MethodServiceListRespon
   messageDesc(file_metalstack_api_v2_method, 1);
 
 /**
- * MethodServiceTokenScopedListRequest is the request payload to list all methods callable with the token present in the request
+ * MethodServiceTokenScopedListRequest is the request payload for listing all methods callable with the token present in the request.
  *
  * @generated from message metalstack.api.v2.MethodServiceTokenScopedListRequest
  */
@@ -69,27 +69,27 @@ export const MethodServiceTokenScopedListRequestSchema: GenMessage<MethodService
   messageDesc(file_metalstack_api_v2_method, 2);
 
 /**
- * MethodServiceTokenScopedListResponse is the response payload which contains all methods which are callable with the given token
+ * MethodServiceTokenScopedListResponse is the response payload which contains all methods which are callable with the given token.
  *
  * @generated from message metalstack.api.v2.MethodServiceTokenScopedListResponse
  */
 export type MethodServiceTokenScopedListResponse = Message<"metalstack.api.v2.MethodServiceTokenScopedListResponse"> & {
   /**
-   * Permissions a list of methods which can be called
+   * Permissions contains a list of methods which can be called
    *
    * @generated from field: repeated metalstack.api.v2.MethodPermission permissions = 1;
    */
   permissions: MethodPermission[];
 
   /**
-   * ProjectRoles associates a project id with the corresponding role of the token owner
+   * ProjectRoles associates a project ID with the corresponding role of the token owner
    *
    * @generated from field: map<string, metalstack.api.v2.ProjectRole> project_roles = 2;
    */
   projectRoles: { [key: string]: ProjectRole };
 
   /**
-   * TenantRoles associates a tenant id with the corresponding role of the token owner
+   * TenantRoles associates a tenant ID with the corresponding role of the token owner
    *
    * @generated from field: map<string, metalstack.api.v2.TenantRole> tenant_roles = 3;
    */
@@ -125,14 +125,14 @@ export const MethodServiceTokenScopedListResponseSchema: GenMessage<MethodServic
   messageDesc(file_metalstack_api_v2_method, 3);
 
 /**
- * MethodService serves method related functions
- * methods are functions in services
+ * MethodService provides method discovery operations.
+ * Methods are functions in services.
  *
  * @generated from service metalstack.api.v2.MethodService
  */
 export const MethodService: GenService<{
   /**
-   * List all public visible methods
+   * Returns the list of all public visible methods.
    *
    * @generated from rpc metalstack.api.v2.MethodService.List
    */
@@ -142,7 +142,7 @@ export const MethodService: GenService<{
     output: typeof MethodServiceListResponseSchema;
   },
   /**
-   * TokenScopedList all methods callable with the token present in the request
+   * TokenScopedList returns all methods callable with the token present in the request.
    *
    * @generated from rpc metalstack.api.v2.MethodService.TokenScopedList
    */
diff --git a/js/metalstack/api/v2/network_pb.d.ts b/js/metalstack/api/v2/network_pb.d.ts
index 428953d9..027573a8 100644
--- a/js/metalstack/api/v2/network_pb.d.ts
+++ b/js/metalstack/api/v2/network_pb.d.ts
@@ -753,13 +753,13 @@ export declare enum NetworkAddressFamily {
  */
 export declare const NetworkAddressFamilySchema: GenEnum<NetworkAddressFamily>;
 /**
- * NetworkService serves network address related functions for end users, e.g. with project scope
+ * NetworkService provides network management operations for end users, for example with project scope.
  *
  * @generated from service metalstack.api.v2.NetworkService
  */
 export declare const NetworkService: GenService<{
     /**
-     * Get a network
+     * Returns the network with the specified ID.
      *
      * @generated from rpc metalstack.api.v2.NetworkService.Get
      */
@@ -769,7 +769,7 @@ export declare const NetworkService: GenService<{
         output: typeof NetworkServiceGetResponseSchema;
     };
     /**
-     * Create a child network from a super network.
+     * Creates a child network from a super network.
      *
      * @generated from rpc metalstack.api.v2.NetworkService.Create
      */
@@ -779,7 +779,7 @@ export declare const NetworkService: GenService<{
         output: typeof NetworkServiceCreateResponseSchema;
     };
     /**
-     * Update a network
+     * Updates a network.
      *
      * @generated from rpc metalstack.api.v2.NetworkService.Update
      */
@@ -789,7 +789,7 @@ export declare const NetworkService: GenService<{
         output: typeof NetworkServiceUpdateResponseSchema;
     };
     /**
-     * List all project networks
+     * Returns the list of all project networks.
      *
      * @generated from rpc metalstack.api.v2.NetworkService.List
      */
@@ -799,7 +799,7 @@ export declare const NetworkService: GenService<{
         output: typeof NetworkServiceListResponseSchema;
     };
     /**
-     * ListBaseNetworks all base networks that can be used for either child network or ip allocation
+     * ListBaseNetworks returns all base networks that can be used for either child network or IP allocation.
      *
      * @generated from rpc metalstack.api.v2.NetworkService.ListBaseNetworks
      */
@@ -809,7 +809,7 @@ export declare const NetworkService: GenService<{
         output: typeof NetworkServiceListBaseNetworksResponseSchema;
     };
     /**
-     * Delete a network
+     * Deletes a network.
      *
      * @generated from rpc metalstack.api.v2.NetworkService.Delete
      */
diff --git a/js/metalstack/api/v2/network_pb.js b/js/metalstack/api/v2/network_pb.js
index ee544835..c36c6e9d 100644
--- a/js/metalstack/api/v2/network_pb.js
+++ b/js/metalstack/api/v2/network_pb.js
@@ -238,7 +238,7 @@ export var NetworkAddressFamily;
  */
 export const NetworkAddressFamilySchema = /*@__PURE__*/ enumDesc(file_metalstack_api_v2_network, 2);
 /**
- * NetworkService serves network address related functions for end users, e.g. with project scope
+ * NetworkService provides network management operations for end users, for example with project scope.
  *
  * @generated from service metalstack.api.v2.NetworkService
  */
diff --git a/js/metalstack/api/v2/network_pb.ts b/js/metalstack/api/v2/network_pb.ts
index 9cdcbb4e..ae4258ed 100644
--- a/js/metalstack/api/v2/network_pb.ts
+++ b/js/metalstack/api/v2/network_pb.ts
@@ -885,13 +885,13 @@ export const NetworkAddressFamilySchema: GenEnum<NetworkAddressFamily> = /*@__PU
   enumDesc(file_metalstack_api_v2_network, 2);
 
 /**
- * NetworkService serves network address related functions for end users, e.g. with project scope
+ * NetworkService provides network management operations for end users, for example with project scope.
  *
  * @generated from service metalstack.api.v2.NetworkService
  */
 export const NetworkService: GenService<{
   /**
-   * Get a network
+   * Returns the network with the specified ID.
    *
    * @generated from rpc metalstack.api.v2.NetworkService.Get
    */
@@ -901,7 +901,7 @@ export const NetworkService: GenService<{
     output: typeof NetworkServiceGetResponseSchema;
   },
   /**
-   * Create a child network from a super network.
+   * Creates a child network from a super network.
    *
    * @generated from rpc metalstack.api.v2.NetworkService.Create
    */
@@ -911,7 +911,7 @@ export const NetworkService: GenService<{
     output: typeof NetworkServiceCreateResponseSchema;
   },
   /**
-   * Update a network
+   * Updates a network.
    *
    * @generated from rpc metalstack.api.v2.NetworkService.Update
    */
@@ -921,7 +921,7 @@ export const NetworkService: GenService<{
     output: typeof NetworkServiceUpdateResponseSchema;
   },
   /**
-   * List all project networks
+   * Returns the list of all project networks.
    *
    * @generated from rpc metalstack.api.v2.NetworkService.List
    */
@@ -931,7 +931,7 @@ export const NetworkService: GenService<{
     output: typeof NetworkServiceListResponseSchema;
   },
   /**
-   * ListBaseNetworks all base networks that can be used for either child network or ip allocation
+   * ListBaseNetworks returns all base networks that can be used for either child network or IP allocation.
    *
    * @generated from rpc metalstack.api.v2.NetworkService.ListBaseNetworks
    */
@@ -941,7 +941,7 @@ export const NetworkService: GenService<{
     output: typeof NetworkServiceListBaseNetworksResponseSchema;
   },
   /**
-   * Delete a network
+   * Deletes a network.
    *
    * @generated from rpc metalstack.api.v2.NetworkService.Delete
    */
diff --git a/js/metalstack/api/v2/partition_pb.d.ts b/js/metalstack/api/v2/partition_pb.d.ts
index 4da8e866..b9bd62a2 100644
--- a/js/metalstack/api/v2/partition_pb.d.ts
+++ b/js/metalstack/api/v2/partition_pb.d.ts
@@ -223,13 +223,13 @@ export type PartitionServiceListResponse = Message<"metalstack.api.v2.PartitionS
  */
 export declare const PartitionServiceListResponseSchema: GenMessage<PartitionServiceListResponse>;
 /**
- * PartitionService serves partition address related functions
+ * PartitionService provides partition management operations.
  *
  * @generated from service metalstack.api.v2.PartitionService
  */
 export declare const PartitionService: GenService<{
     /**
-     * Get a partition
+     * Returns the partition with the specified ID.
      *
      * @generated from rpc metalstack.api.v2.PartitionService.Get
      */
@@ -239,7 +239,7 @@ export declare const PartitionService: GenService<{
         output: typeof PartitionServiceGetResponseSchema;
     };
     /**
-     * List all partitions
+     * Returns the list of all partitions.
      *
      * @generated from rpc metalstack.api.v2.PartitionService.List
      */
diff --git a/js/metalstack/api/v2/partition_pb.js b/js/metalstack/api/v2/partition_pb.js
index 3c2ea224..96cde7ff 100644
--- a/js/metalstack/api/v2/partition_pb.js
+++ b/js/metalstack/api/v2/partition_pb.js
@@ -8,7 +8,7 @@ import { file_metalstack_api_v2_predefined_rules } from "./predefined_rules_pb";
 /**
  * Describes the file metalstack/api/v2/partition.proto.
  */
-export const file_metalstack_api_v2_partition = /*@__PURE__*/ fileDesc("CiFtZXRhbHN0YWNrL2FwaS92Mi9wYXJ0aXRpb24ucHJvdG8SEW1ldGFsc3RhY2suYXBpLnYyItICCglQYXJ0aXRpb24SFwoCaWQYASABKAlCC7pICHIG0LOusQIBEiUKBG1ldGEYAiABKAsyFy5tZXRhbHN0YWNrLmFwaS52Mi5NZXRhEiAKC2Rlc2NyaXB0aW9uGAMgASgJQgu6SAhyBsizrrECARJJChJib290X2NvbmZpZ3VyYXRpb24YBCABKAsyLS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25Cb290Q29uZmlndXJhdGlvbhI7CgtkbnNfc2VydmVycxgFIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYBiADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEh4KFm1nbXRfc2VydmljZV9hZGRyZXNzZXMYByADKAkicAoOUGFydGl0aW9uUXVlcnkSHAoCaWQYASABKAlCC7pICHIG0LOusQIBSACIAQESLgoGbGFiZWxzGAIgASgLMhkubWV0YWxzdGFjay5hcGkudjIuTGFiZWxzSAGIAQFCBQoDX2lkQgkKB19sYWJlbHMicgoaUGFydGl0aW9uQm9vdENvbmZpZ3VyYXRpb24SHgoJaW1hZ2VfdXJsGAEgASgJQgu6SAhyBuCzrrECARIfCgprZXJuZWxfdXJsGAIgASgJQgu6SAhyBuCzrrECARITCgtjb21tYW5kbGluZRgDIAEoCSIgCglETlNTZXJ2ZXISEwoCaXAYASABKAlCB7pIBHICcAEiKQoJTlRQU2VydmVyEhwKB2FkZHJlc3MYASABKAlCC7pICHIG6LOusQIBIjUKGlBhcnRpdGlvblNlcnZpY2VHZXRSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBtCzrrECASJPChtQYXJ0aXRpb25TZXJ2aWNlTGlzdFJlcXVlc3QSMAoFcXVlcnkYASABKAsyIS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25RdWVyeSJOChtQYXJ0aXRpb25TZXJ2aWNlR2V0UmVzcG9uc2USLwoJcGFydGl0aW9uGAEgASgLMhwubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uIlAKHFBhcnRpdGlvblNlcnZpY2VMaXN0UmVzcG9uc2USMAoKcGFydGl0aW9ucxgBIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvbjL1AQoQUGFydGl0aW9uU2VydmljZRJuCgNHZXQSLS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25TZXJ2aWNlR2V0UmVxdWVzdBouLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvblNlcnZpY2VHZXRSZXNwb25zZSII2PMYA+DzGAIScQoETGlzdBIuLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvblNlcnZpY2VMaXN0UmVxdWVzdBovLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvblNlcnZpY2VMaXN0UmVzcG9uc2UiCNjzGAPg8xgCQsQBChVjb20ubWV0YWxzdGFjay5hcGkudjJCDlBhcnRpdGlvblByb3RvUAFaNWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYXBpL3YyO2FwaXYyogIDTUFYqgIRTWV0YWxzdGFjay5BcGkuVjLKAhFNZXRhbHN0YWNrXEFwaVxWMuICHU1ldGFsc3RhY2tcQXBpXFYyXEdQQk1ldGFkYXRh6gITTWV0YWxzdGFjazo6QXBpOjpWMmIGcHJvdG8z", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules]);
+export const file_metalstack_api_v2_partition = /*@__PURE__*/ fileDesc("CiFtZXRhbHN0YWNrL2FwaS92Mi9wYXJ0aXRpb24ucHJvdG8SEW1ldGFsc3RhY2suYXBpLnYyIuACCglQYXJ0aXRpb24SFwoCaWQYASABKAlCC7pICHIG0LOusQIBEiUKBG1ldGEYAiABKAsyFy5tZXRhbHN0YWNrLmFwaS52Mi5NZXRhEiAKC2Rlc2NyaXB0aW9uGAMgASgJQgu6SAhyBsizrrECARJJChJib290X2NvbmZpZ3VyYXRpb24YBCABKAsyLS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25Cb290Q29uZmlndXJhdGlvbhI7CgtkbnNfc2VydmVycxgFIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYBiADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEiwKFm1nbXRfc2VydmljZV9hZGRyZXNzZXMYByADKAlCDLpICZIBBsiks7ECASJwCg5QYXJ0aXRpb25RdWVyeRIcCgJpZBgBIAEoCUILukgIcgbQs66xAgFIAIgBARIuCgZsYWJlbHMYAiABKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5MYWJlbHNIAYgBAUIFCgNfaWRCCQoHX2xhYmVscyJyChpQYXJ0aXRpb25Cb290Q29uZmlndXJhdGlvbhIeCglpbWFnZV91cmwYASABKAlCC7pICHIG4LOusQIBEh8KCmtlcm5lbF91cmwYAiABKAlCC7pICHIG4LOusQIBEhMKC2NvbW1hbmRsaW5lGAMgASgJIiAKCUROU1NlcnZlchITCgJpcBgBIAEoCUIHukgEcgJwASIpCglOVFBTZXJ2ZXISHAoHYWRkcmVzcxgBIAEoCUILukgIcgbos66xAgEiNQoaUGFydGl0aW9uU2VydmljZUdldFJlcXVlc3QSFwoCaWQYASABKAlCC7pICHIG0LOusQIBIk8KG1BhcnRpdGlvblNlcnZpY2VMaXN0UmVxdWVzdBIwCgVxdWVyeRgBIAEoCzIhLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvblF1ZXJ5Ik4KG1BhcnRpdGlvblNlcnZpY2VHZXRSZXNwb25zZRIvCglwYXJ0aXRpb24YASABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24iUAocUGFydGl0aW9uU2VydmljZUxpc3RSZXNwb25zZRIwCgpwYXJ0aXRpb25zGAEgAygLMhwubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uMvUBChBQYXJ0aXRpb25TZXJ2aWNlEm4KA0dldBItLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvblNlcnZpY2VHZXRSZXF1ZXN0Gi4ubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uU2VydmljZUdldFJlc3BvbnNlIgjY8xgD4PMYAhJxCgRMaXN0Ei4ubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uU2VydmljZUxpc3RSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uU2VydmljZUxpc3RSZXNwb25zZSII2PMYA+DzGAJCxAEKFWNvbS5tZXRhbHN0YWNrLmFwaS52MkIOUGFydGl0aW9uUHJvdG9QAVo1Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9hcGkvdjI7YXBpdjKiAgNNQViqAhFNZXRhbHN0YWNrLkFwaS5WMsoCEU1ldGFsc3RhY2tcQXBpXFYy4gIdTWV0YWxzdGFja1xBcGlcVjJcR1BCTWV0YWRhdGHqAhNNZXRhbHN0YWNrOjpBcGk6OlYyYgZwcm90bzM", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules]);
 /**
  * Describes the message metalstack.api.v2.Partition.
  * Use `create(PartitionSchema)` to create a new message.
@@ -55,7 +55,7 @@ export const PartitionServiceGetResponseSchema = /*@__PURE__*/ messageDesc(file_
  */
 export const PartitionServiceListResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_api_v2_partition, 8);
 /**
- * PartitionService serves partition address related functions
+ * PartitionService provides partition management operations.
  *
  * @generated from service metalstack.api.v2.PartitionService
  */
diff --git a/js/metalstack/api/v2/partition_pb.ts b/js/metalstack/api/v2/partition_pb.ts
index 3adf3412..a1312bd0 100644
--- a/js/metalstack/api/v2/partition_pb.ts
+++ b/js/metalstack/api/v2/partition_pb.ts
@@ -14,7 +14,7 @@ import type { Message } from "@bufbuild/protobuf";
  * Describes the file metalstack/api/v2/partition.proto.
  */
 export const file_metalstack_api_v2_partition: GenFile = /*@__PURE__*/
-  fileDesc("CiFtZXRhbHN0YWNrL2FwaS92Mi9wYXJ0aXRpb24ucHJvdG8SEW1ldGFsc3RhY2suYXBpLnYyItICCglQYXJ0aXRpb24SFwoCaWQYASABKAlCC7pICHIG0LOusQIBEiUKBG1ldGEYAiABKAsyFy5tZXRhbHN0YWNrLmFwaS52Mi5NZXRhEiAKC2Rlc2NyaXB0aW9uGAMgASgJQgu6SAhyBsizrrECARJJChJib290X2NvbmZpZ3VyYXRpb24YBCABKAsyLS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25Cb290Q29uZmlndXJhdGlvbhI7CgtkbnNfc2VydmVycxgFIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYBiADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEh4KFm1nbXRfc2VydmljZV9hZGRyZXNzZXMYByADKAkicAoOUGFydGl0aW9uUXVlcnkSHAoCaWQYASABKAlCC7pICHIG0LOusQIBSACIAQESLgoGbGFiZWxzGAIgASgLMhkubWV0YWxzdGFjay5hcGkudjIuTGFiZWxzSAGIAQFCBQoDX2lkQgkKB19sYWJlbHMicgoaUGFydGl0aW9uQm9vdENvbmZpZ3VyYXRpb24SHgoJaW1hZ2VfdXJsGAEgASgJQgu6SAhyBuCzrrECARIfCgprZXJuZWxfdXJsGAIgASgJQgu6SAhyBuCzrrECARITCgtjb21tYW5kbGluZRgDIAEoCSIgCglETlNTZXJ2ZXISEwoCaXAYASABKAlCB7pIBHICcAEiKQoJTlRQU2VydmVyEhwKB2FkZHJlc3MYASABKAlCC7pICHIG6LOusQIBIjUKGlBhcnRpdGlvblNlcnZpY2VHZXRSZXF1ZXN0EhcKAmlkGAEgASgJQgu6SAhyBtCzrrECASJPChtQYXJ0aXRpb25TZXJ2aWNlTGlzdFJlcXVlc3QSMAoFcXVlcnkYASABKAsyIS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25RdWVyeSJOChtQYXJ0aXRpb25TZXJ2aWNlR2V0UmVzcG9uc2USLwoJcGFydGl0aW9uGAEgASgLMhwubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uIlAKHFBhcnRpdGlvblNlcnZpY2VMaXN0UmVzcG9uc2USMAoKcGFydGl0aW9ucxgBIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvbjL1AQoQUGFydGl0aW9uU2VydmljZRJuCgNHZXQSLS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25TZXJ2aWNlR2V0UmVxdWVzdBouLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvblNlcnZpY2VHZXRSZXNwb25zZSII2PMYA+DzGAIScQoETGlzdBIuLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvblNlcnZpY2VMaXN0UmVxdWVzdBovLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvblNlcnZpY2VMaXN0UmVzcG9uc2UiCNjzGAPg8xgCQsQBChVjb20ubWV0YWxzdGFjay5hcGkudjJCDlBhcnRpdGlvblByb3RvUAFaNWdpdGh1Yi5jb20vbWV0YWwtc3RhY2svYXBpL2dvL21ldGFsc3RhY2svYXBpL3YyO2FwaXYyogIDTUFYqgIRTWV0YWxzdGFjay5BcGkuVjLKAhFNZXRhbHN0YWNrXEFwaVxWMuICHU1ldGFsc3RhY2tcQXBpXFYyXEdQQk1ldGFkYXRh6gITTWV0YWxzdGFjazo6QXBpOjpWMmIGcHJvdG8z", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules]);
+  fileDesc("CiFtZXRhbHN0YWNrL2FwaS92Mi9wYXJ0aXRpb24ucHJvdG8SEW1ldGFsc3RhY2suYXBpLnYyIuACCglQYXJ0aXRpb24SFwoCaWQYASABKAlCC7pICHIG0LOusQIBEiUKBG1ldGEYAiABKAsyFy5tZXRhbHN0YWNrLmFwaS52Mi5NZXRhEiAKC2Rlc2NyaXB0aW9uGAMgASgJQgu6SAhyBsizrrECARJJChJib290X2NvbmZpZ3VyYXRpb24YBCABKAsyLS5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb25Cb290Q29uZmlndXJhdGlvbhI7CgtkbnNfc2VydmVycxgFIAMoCzIcLm1ldGFsc3RhY2suYXBpLnYyLkROU1NlcnZlckIIukgFkgECEAMSOwoLbnRwX3NlcnZlcnMYBiADKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5OVFBTZXJ2ZXJCCLpIBZIBAhAKEiwKFm1nbXRfc2VydmljZV9hZGRyZXNzZXMYByADKAlCDLpICZIBBsiks7ECASJwCg5QYXJ0aXRpb25RdWVyeRIcCgJpZBgBIAEoCUILukgIcgbQs66xAgFIAIgBARIuCgZsYWJlbHMYAiABKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5MYWJlbHNIAYgBAUIFCgNfaWRCCQoHX2xhYmVscyJyChpQYXJ0aXRpb25Cb290Q29uZmlndXJhdGlvbhIeCglpbWFnZV91cmwYASABKAlCC7pICHIG4LOusQIBEh8KCmtlcm5lbF91cmwYAiABKAlCC7pICHIG4LOusQIBEhMKC2NvbW1hbmRsaW5lGAMgASgJIiAKCUROU1NlcnZlchITCgJpcBgBIAEoCUIHukgEcgJwASIpCglOVFBTZXJ2ZXISHAoHYWRkcmVzcxgBIAEoCUILukgIcgbos66xAgEiNQoaUGFydGl0aW9uU2VydmljZUdldFJlcXVlc3QSFwoCaWQYASABKAlCC7pICHIG0LOusQIBIk8KG1BhcnRpdGlvblNlcnZpY2VMaXN0UmVxdWVzdBIwCgVxdWVyeRgBIAEoCzIhLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvblF1ZXJ5Ik4KG1BhcnRpdGlvblNlcnZpY2VHZXRSZXNwb25zZRIvCglwYXJ0aXRpb24YASABKAsyHC5tZXRhbHN0YWNrLmFwaS52Mi5QYXJ0aXRpb24iUAocUGFydGl0aW9uU2VydmljZUxpc3RSZXNwb25zZRIwCgpwYXJ0aXRpb25zGAEgAygLMhwubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uMvUBChBQYXJ0aXRpb25TZXJ2aWNlEm4KA0dldBItLm1ldGFsc3RhY2suYXBpLnYyLlBhcnRpdGlvblNlcnZpY2VHZXRSZXF1ZXN0Gi4ubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uU2VydmljZUdldFJlc3BvbnNlIgjY8xgD4PMYAhJxCgRMaXN0Ei4ubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uU2VydmljZUxpc3RSZXF1ZXN0Gi8ubWV0YWxzdGFjay5hcGkudjIuUGFydGl0aW9uU2VydmljZUxpc3RSZXNwb25zZSII2PMYA+DzGAJCxAEKFWNvbS5tZXRhbHN0YWNrLmFwaS52MkIOUGFydGl0aW9uUHJvdG9QAVo1Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9hcGkvdjI7YXBpdjKiAgNNQViqAhFNZXRhbHN0YWNrLkFwaS5WMsoCEU1ldGFsc3RhY2tcQXBpXFYy4gIdTWV0YWxzdGFja1xBcGlcVjJcR1BCTWV0YWRhdGHqAhNNZXRhbHN0YWNrOjpBcGk6OlYyYgZwcm90bzM", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules]);
 
 /**
  * Partition is a failure domain with machines and switches
@@ -270,13 +270,13 @@ export const PartitionServiceListResponseSchema: GenMessage<PartitionServiceList
   messageDesc(file_metalstack_api_v2_partition, 8);
 
 /**
- * PartitionService serves partition address related functions
+ * PartitionService provides partition management operations.
  *
  * @generated from service metalstack.api.v2.PartitionService
  */
 export const PartitionService: GenService<{
   /**
-   * Get a partition
+   * Returns the partition with the specified ID.
    *
    * @generated from rpc metalstack.api.v2.PartitionService.Get
    */
@@ -286,7 +286,7 @@ export const PartitionService: GenService<{
     output: typeof PartitionServiceGetResponseSchema;
   },
   /**
-   * List all partitions
+   * Returns the list of all partitions.
    *
    * @generated from rpc metalstack.api.v2.PartitionService.List
    */
diff --git a/js/metalstack/api/v2/predefined_rules_pb.d.ts b/js/metalstack/api/v2/predefined_rules_pb.d.ts
index 980c5d7f..46d31cda 100644
--- a/js/metalstack/api/v2/predefined_rules_pb.d.ts
+++ b/js/metalstack/api/v2/predefined_rules_pb.d.ts
@@ -47,7 +47,7 @@ export declare const is_uri: GenExtension<StringRules, boolean>;
  */
 export declare const is_ip_or_hostname: GenExtension<StringRules, boolean>;
 /**
- * Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end.
+ * Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end
  *
  * @generated from extension: optional bool trimmed = 80048958;
  */
@@ -65,8 +65,14 @@ export declare const prefixes: GenExtension<RepeatedRules, boolean>;
  */
 export declare const ips: GenExtension<RepeatedRules, boolean>;
 /**
- * All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end.
+ * AreHostAndPort validates if a slice of strings are all in the form of <ip | host>:<port>
  *
- * @generated from extension: optional bool all_trimmed = 80058953;
+ * @generated from extension: optional bool are_host_and_port = 80058953;
+ */
+export declare const are_host_and_port: GenExtension<RepeatedRules, boolean>;
+/**
+ * All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end
+ *
+ * @generated from extension: optional bool all_trimmed = 80058954;
  */
 export declare const all_trimmed: GenExtension<RepeatedRules, boolean>;
diff --git a/js/metalstack/api/v2/predefined_rules_pb.js b/js/metalstack/api/v2/predefined_rules_pb.js
index a456ebe0..14d087a3 100644
--- a/js/metalstack/api/v2/predefined_rules_pb.js
+++ b/js/metalstack/api/v2/predefined_rules_pb.js
@@ -6,7 +6,7 @@ import { file_buf_validate_validate } from "../../../buf/validate/validate_pb";
 /**
  * Describes the file metalstack/api/v2/predefined_rules.proto.
  */
-export const file_metalstack_api_v2_predefined_rules = /*@__PURE__*/ fileDesc("CihtZXRhbHN0YWNrL2FwaS92Mi9wcmVkZWZpbmVkX3J1bGVzLnByb3RvEhFtZXRhbHN0YWNrLmFwaS52Mjq4AQoKbWFjYWRkcmVzcxIZLmJ1Zi52YWxpZGF0ZS5TdHJpbmdSdWxlcxi35pUmIAEoCEJ6wkh3CnUKEXN0cmluZy5tYWNhZGRyZXNzEiZ0aGlzIHN0cmluZyBtdXN0IGJlIGEgdmFsaWQgbWFjYWRkcmVzcxo4dGhpcy5tYXRjaGVzKCdeKFswLTlBLUZhLWZdezJ9WzpdKXs1fShbMC05QS1GYS1mXXsyfSkkJylSCm1hY2FkZHJlc3M6mQEKB2lzX25hbWUSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYuOaVJiABKAhCYsJIXwpdCg5zdHJpbmcuaXNfbmFtZRIjbXVzdCBiZSB3aXRoaW4gMiBhbmQgMTI4IGNoYXJhY3RlcnMaJnRoaXMuc2l6ZSgpID49IDIgJiYgdGhpcy5zaXplKCkgPD0gMTI4UgZpc05hbWU6mgEKDmlzX2Rlc2NyaXB0aW9uEhkuYnVmLnZhbGlkYXRlLlN0cmluZ1J1bGVzGLnmlSYgASgIQlXCSFIKUAoVc3RyaW5nLmlzX2Rlc2NyaXB0aW9uEiNtdXN0IGJlIHNob3J0ZXIgdGhhbiAyNTYgY2hhcmFjdGVycxoSdGhpcy5zaXplKCkgPD0gMjU2Ug1pc0Rlc2NyaXB0aW9uOqgBCgxpc19wYXJ0aXRpb24SGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYuuaVJiABKAhCZ8JIZApiChNzdHJpbmcuaXNfcGFydGl0aW9uEiNtdXN0IGJlIHdpdGhpbiAyIGFuZCAxMjggY2hhcmFjdGVycxomdGhpcy5zaXplKCkgPj0gMiAmJiB0aGlzLnNpemUoKSA8PSAxMjhSC2lzUGFydGl0aW9uOoIBCglpc19wcmVmaXgSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYu+aVJiABKAhCR8JIRApCCg9zdHJpbmcucHJlZml4ZXMSHGdpdmVuIHByZWZpeGVzIG11c3QgYmUgdmFsaWQaEXRoaXMuaXNJcFByZWZpeCgpUghpc1ByZWZpeDptCgZpc191cmkSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYvOaVJiABKAhCOMJINQozCgpzdHJpbmcudXJpEhdnaXZlbiB1cmkgbXVzdCBiZSB2YWxpZBoMdGhpcy5pc1VyaSgpUgVpc1VyaTqnAQoRaXNfaXBfb3JfaG9zdG5hbWUSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYveaVJiABKAhCXsJIWwpZCg12YWxpZF9hZGRyZXNzEiZtdXN0IGJlIGEgdmFsaWQgSVAgYWRkcmVzcyBvciBob3N0bmFtZRogdGhpcy5pc0lwKCkgfHwgdGhpcy5pc0hvc3RuYW1lKClSDmlzSXBPckhvc3RuYW1lOp0BCgd0cmltbWVkEhkuYnVmLnZhbGlkYXRlLlN0cmluZ1J1bGVzGL7mlSYgASgIQmXCSGIKYAoOc3RyaW5nLnRyaW1tZWQSK3ZhbHVlIG11c3Qgbm90IHN0YXJ0IG9yIGVuZCB3aXRoIHdoaXRlc3BhY2UaIXRoaXMudHJpbSgpLnNpemUoKSA9PSB0aGlzLnNpemUoKVIHdHJpbW1lZDqPAQoIcHJlZml4ZXMSGy5idWYudmFsaWRhdGUuUmVwZWF0ZWRSdWxlcxjHtJYmIAEoCEJTwkhQCk4KEXJlcGVhdGVkLnByZWZpeGVzEhxnaXZlbiBwcmVmaXhlcyBtdXN0IGJlIHZhbGlkGht0aGlzLmFsbChtLCBtLmlzSXBQcmVmaXgoKSlSCHByZWZpeGVzOnUKA2lwcxIbLmJ1Zi52YWxpZGF0ZS5SZXBlYXRlZFJ1bGVzGMi0liYgASgIQkPCSEAKPgoMcmVwZWF0ZWQuaXBzEhdnaXZlbiBpcHMgbXVzdCBiZSB2YWxpZBoVdGhpcy5hbGwobSwgbS5pc0lwKCkpUgNpcHM6ugEKC2FsbF90cmltbWVkEhsuYnVmLnZhbGlkYXRlLlJlcGVhdGVkUnVsZXMYybSWJiABKAhCecJIdgp0ChRyZXBlYXRlZC5hbGxfdHJpbW1lZBIyZ2l2ZW4gdmFsdWVzIG11c3Qgbm90IHN0YXJ0IG9yIGVuZCB3aXRoIHdoaXRlc3BhY2UaKHRoaXMuYWxsKG0sIG0udHJpbSgpLnNpemUoKSA9PSBtLnNpemUoKSlSCmFsbFRyaW1tZWRCygEKFWNvbS5tZXRhbHN0YWNrLmFwaS52MkIUUHJlZGVmaW5lZFJ1bGVzUHJvdG9QAVo1Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9hcGkvdjI7YXBpdjKiAgNNQViqAhFNZXRhbHN0YWNrLkFwaS5WMsoCEU1ldGFsc3RhY2tcQXBpXFYy4gIdTWV0YWxzdGFja1xBcGlcVjJcR1BCTWV0YWRhdGHqAhNNZXRhbHN0YWNrOjpBcGk6OlYy", [file_buf_validate_validate]);
+export const file_metalstack_api_v2_predefined_rules = /*@__PURE__*/ fileDesc("CihtZXRhbHN0YWNrL2FwaS92Mi9wcmVkZWZpbmVkX3J1bGVzLnByb3RvEhFtZXRhbHN0YWNrLmFwaS52Mjq4AQoKbWFjYWRkcmVzcxIZLmJ1Zi52YWxpZGF0ZS5TdHJpbmdSdWxlcxi35pUmIAEoCEJ6wkh3CnUKEXN0cmluZy5tYWNhZGRyZXNzEiZ0aGlzIHN0cmluZyBtdXN0IGJlIGEgdmFsaWQgbWFjYWRkcmVzcxo4dGhpcy5tYXRjaGVzKCdeKFswLTlBLUZhLWZdezJ9WzpdKXs1fShbMC05QS1GYS1mXXsyfSkkJylSCm1hY2FkZHJlc3M6mQEKB2lzX25hbWUSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYuOaVJiABKAhCYsJIXwpdCg5zdHJpbmcuaXNfbmFtZRIjbXVzdCBiZSB3aXRoaW4gMiBhbmQgMTI4IGNoYXJhY3RlcnMaJnRoaXMuc2l6ZSgpID49IDIgJiYgdGhpcy5zaXplKCkgPD0gMTI4UgZpc05hbWU6mgEKDmlzX2Rlc2NyaXB0aW9uEhkuYnVmLnZhbGlkYXRlLlN0cmluZ1J1bGVzGLnmlSYgASgIQlXCSFIKUAoVc3RyaW5nLmlzX2Rlc2NyaXB0aW9uEiNtdXN0IGJlIHNob3J0ZXIgdGhhbiAyNTYgY2hhcmFjdGVycxoSdGhpcy5zaXplKCkgPD0gMjU2Ug1pc0Rlc2NyaXB0aW9uOqgBCgxpc19wYXJ0aXRpb24SGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYuuaVJiABKAhCZ8JIZApiChNzdHJpbmcuaXNfcGFydGl0aW9uEiNtdXN0IGJlIHdpdGhpbiAyIGFuZCAxMjggY2hhcmFjdGVycxomdGhpcy5zaXplKCkgPj0gMiAmJiB0aGlzLnNpemUoKSA8PSAxMjhSC2lzUGFydGl0aW9uOoIBCglpc19wcmVmaXgSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYu+aVJiABKAhCR8JIRApCCg9zdHJpbmcucHJlZml4ZXMSHGdpdmVuIHByZWZpeGVzIG11c3QgYmUgdmFsaWQaEXRoaXMuaXNJcFByZWZpeCgpUghpc1ByZWZpeDptCgZpc191cmkSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYvOaVJiABKAhCOMJINQozCgpzdHJpbmcudXJpEhdnaXZlbiB1cmkgbXVzdCBiZSB2YWxpZBoMdGhpcy5pc1VyaSgpUgVpc1VyaTqnAQoRaXNfaXBfb3JfaG9zdG5hbWUSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYveaVJiABKAhCXsJIWwpZCg12YWxpZF9hZGRyZXNzEiZtdXN0IGJlIGEgdmFsaWQgSVAgYWRkcmVzcyBvciBob3N0bmFtZRogdGhpcy5pc0lwKCkgfHwgdGhpcy5pc0hvc3RuYW1lKClSDmlzSXBPckhvc3RuYW1lOp0BCgd0cmltbWVkEhkuYnVmLnZhbGlkYXRlLlN0cmluZ1J1bGVzGL7mlSYgASgIQmXCSGIKYAoOc3RyaW5nLnRyaW1tZWQSK3ZhbHVlIG11c3Qgbm90IHN0YXJ0IG9yIGVuZCB3aXRoIHdoaXRlc3BhY2UaIXRoaXMudHJpbSgpLnNpemUoKSA9PSB0aGlzLnNpemUoKVIHdHJpbW1lZDqPAQoIcHJlZml4ZXMSGy5idWYudmFsaWRhdGUuUmVwZWF0ZWRSdWxlcxjHtJYmIAEoCEJTwkhQCk4KEXJlcGVhdGVkLnByZWZpeGVzEhxnaXZlbiBwcmVmaXhlcyBtdXN0IGJlIHZhbGlkGht0aGlzLmFsbChtLCBtLmlzSXBQcmVmaXgoKSlSCHByZWZpeGVzOnUKA2lwcxIbLmJ1Zi52YWxpZGF0ZS5SZXBlYXRlZFJ1bGVzGMi0liYgASgIQkPCSEAKPgoMcmVwZWF0ZWQuaXBzEhdnaXZlbiBpcHMgbXVzdCBiZSB2YWxpZBoVdGhpcy5hbGwobSwgbS5pc0lwKCkpUgNpcHM65gEKEWFyZV9ob3N0X2FuZF9wb3J0EhsuYnVmLnZhbGlkYXRlLlJlcGVhdGVkUnVsZXMYybSWJiABKAhCmgHCSJYBCpMBChpyZXBlYXRlZC5hcmVfaG9zdF9hbmRfcG9ydBJQZ2l2ZW4gZW50cmllcyBtdXN0IGFsbCBiZSBpbiB0aGUgZm9ybSBvZiA8aXAgfCBob3N0Pjo8cG9ydD4gYnV0IHBvcnQgaXMgb3B0aW9uYWwaI3RoaXMuYWxsKG0sIG0uaXNIb3N0QW5kUG9ydChmYWxzZSkpUg5hcmVIb3N0QW5kUG9ydDq6AQoLYWxsX3RyaW1tZWQSGy5idWYudmFsaWRhdGUuUmVwZWF0ZWRSdWxlcxjKtJYmIAEoCEJ5wkh2CnQKFHJlcGVhdGVkLmFsbF90cmltbWVkEjJnaXZlbiB2YWx1ZXMgbXVzdCBub3Qgc3RhcnQgb3IgZW5kIHdpdGggd2hpdGVzcGFjZRoodGhpcy5hbGwobSwgbS50cmltKCkuc2l6ZSgpID09IG0uc2l6ZSgpKVIKYWxsVHJpbW1lZELKAQoVY29tLm1ldGFsc3RhY2suYXBpLnYyQhRQcmVkZWZpbmVkUnVsZXNQcm90b1ABWjVnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FwaS92MjthcGl2MqICA01BWKoCEU1ldGFsc3RhY2suQXBpLlYyygIRTWV0YWxzdGFja1xBcGlcVjLiAh1NZXRhbHN0YWNrXEFwaVxWMlxHUEJNZXRhZGF0YeoCE01ldGFsc3RhY2s6OkFwaTo6VjI", [file_buf_validate_validate]);
 /**
  * Macaddress returns true if the given string is a valid macadress
  *
@@ -50,7 +50,7 @@ export const is_uri = /*@__PURE__*/ extDesc(file_metalstack_api_v2_predefined_ru
  */
 export const is_ip_or_hostname = /*@__PURE__*/ extDesc(file_metalstack_api_v2_predefined_rules, 6);
 /**
- * Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end.
+ * Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end
  *
  * @generated from extension: optional bool trimmed = 80048958;
  */
@@ -68,8 +68,14 @@ export const prefixes = /*@__PURE__*/ extDesc(file_metalstack_api_v2_predefined_
  */
 export const ips = /*@__PURE__*/ extDesc(file_metalstack_api_v2_predefined_rules, 9);
 /**
- * All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end.
+ * AreHostAndPort validates if a slice of strings are all in the form of <ip | host>:<port>
  *
- * @generated from extension: optional bool all_trimmed = 80058953;
+ * @generated from extension: optional bool are_host_and_port = 80058953;
  */
-export const all_trimmed = /*@__PURE__*/ extDesc(file_metalstack_api_v2_predefined_rules, 10);
+export const are_host_and_port = /*@__PURE__*/ extDesc(file_metalstack_api_v2_predefined_rules, 10);
+/**
+ * All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end
+ *
+ * @generated from extension: optional bool all_trimmed = 80058954;
+ */
+export const all_trimmed = /*@__PURE__*/ extDesc(file_metalstack_api_v2_predefined_rules, 11);
diff --git a/js/metalstack/api/v2/predefined_rules_pb.ts b/js/metalstack/api/v2/predefined_rules_pb.ts
index 57951dd9..30c9655b 100644
--- a/js/metalstack/api/v2/predefined_rules_pb.ts
+++ b/js/metalstack/api/v2/predefined_rules_pb.ts
@@ -11,7 +11,7 @@ import { file_buf_validate_validate } from "../../../buf/validate/validate_pb";
  * Describes the file metalstack/api/v2/predefined_rules.proto.
  */
 export const file_metalstack_api_v2_predefined_rules: GenFile = /*@__PURE__*/
-  fileDesc("CihtZXRhbHN0YWNrL2FwaS92Mi9wcmVkZWZpbmVkX3J1bGVzLnByb3RvEhFtZXRhbHN0YWNrLmFwaS52Mjq4AQoKbWFjYWRkcmVzcxIZLmJ1Zi52YWxpZGF0ZS5TdHJpbmdSdWxlcxi35pUmIAEoCEJ6wkh3CnUKEXN0cmluZy5tYWNhZGRyZXNzEiZ0aGlzIHN0cmluZyBtdXN0IGJlIGEgdmFsaWQgbWFjYWRkcmVzcxo4dGhpcy5tYXRjaGVzKCdeKFswLTlBLUZhLWZdezJ9WzpdKXs1fShbMC05QS1GYS1mXXsyfSkkJylSCm1hY2FkZHJlc3M6mQEKB2lzX25hbWUSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYuOaVJiABKAhCYsJIXwpdCg5zdHJpbmcuaXNfbmFtZRIjbXVzdCBiZSB3aXRoaW4gMiBhbmQgMTI4IGNoYXJhY3RlcnMaJnRoaXMuc2l6ZSgpID49IDIgJiYgdGhpcy5zaXplKCkgPD0gMTI4UgZpc05hbWU6mgEKDmlzX2Rlc2NyaXB0aW9uEhkuYnVmLnZhbGlkYXRlLlN0cmluZ1J1bGVzGLnmlSYgASgIQlXCSFIKUAoVc3RyaW5nLmlzX2Rlc2NyaXB0aW9uEiNtdXN0IGJlIHNob3J0ZXIgdGhhbiAyNTYgY2hhcmFjdGVycxoSdGhpcy5zaXplKCkgPD0gMjU2Ug1pc0Rlc2NyaXB0aW9uOqgBCgxpc19wYXJ0aXRpb24SGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYuuaVJiABKAhCZ8JIZApiChNzdHJpbmcuaXNfcGFydGl0aW9uEiNtdXN0IGJlIHdpdGhpbiAyIGFuZCAxMjggY2hhcmFjdGVycxomdGhpcy5zaXplKCkgPj0gMiAmJiB0aGlzLnNpemUoKSA8PSAxMjhSC2lzUGFydGl0aW9uOoIBCglpc19wcmVmaXgSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYu+aVJiABKAhCR8JIRApCCg9zdHJpbmcucHJlZml4ZXMSHGdpdmVuIHByZWZpeGVzIG11c3QgYmUgdmFsaWQaEXRoaXMuaXNJcFByZWZpeCgpUghpc1ByZWZpeDptCgZpc191cmkSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYvOaVJiABKAhCOMJINQozCgpzdHJpbmcudXJpEhdnaXZlbiB1cmkgbXVzdCBiZSB2YWxpZBoMdGhpcy5pc1VyaSgpUgVpc1VyaTqnAQoRaXNfaXBfb3JfaG9zdG5hbWUSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYveaVJiABKAhCXsJIWwpZCg12YWxpZF9hZGRyZXNzEiZtdXN0IGJlIGEgdmFsaWQgSVAgYWRkcmVzcyBvciBob3N0bmFtZRogdGhpcy5pc0lwKCkgfHwgdGhpcy5pc0hvc3RuYW1lKClSDmlzSXBPckhvc3RuYW1lOp0BCgd0cmltbWVkEhkuYnVmLnZhbGlkYXRlLlN0cmluZ1J1bGVzGL7mlSYgASgIQmXCSGIKYAoOc3RyaW5nLnRyaW1tZWQSK3ZhbHVlIG11c3Qgbm90IHN0YXJ0IG9yIGVuZCB3aXRoIHdoaXRlc3BhY2UaIXRoaXMudHJpbSgpLnNpemUoKSA9PSB0aGlzLnNpemUoKVIHdHJpbW1lZDqPAQoIcHJlZml4ZXMSGy5idWYudmFsaWRhdGUuUmVwZWF0ZWRSdWxlcxjHtJYmIAEoCEJTwkhQCk4KEXJlcGVhdGVkLnByZWZpeGVzEhxnaXZlbiBwcmVmaXhlcyBtdXN0IGJlIHZhbGlkGht0aGlzLmFsbChtLCBtLmlzSXBQcmVmaXgoKSlSCHByZWZpeGVzOnUKA2lwcxIbLmJ1Zi52YWxpZGF0ZS5SZXBlYXRlZFJ1bGVzGMi0liYgASgIQkPCSEAKPgoMcmVwZWF0ZWQuaXBzEhdnaXZlbiBpcHMgbXVzdCBiZSB2YWxpZBoVdGhpcy5hbGwobSwgbS5pc0lwKCkpUgNpcHM6ugEKC2FsbF90cmltbWVkEhsuYnVmLnZhbGlkYXRlLlJlcGVhdGVkUnVsZXMYybSWJiABKAhCecJIdgp0ChRyZXBlYXRlZC5hbGxfdHJpbW1lZBIyZ2l2ZW4gdmFsdWVzIG11c3Qgbm90IHN0YXJ0IG9yIGVuZCB3aXRoIHdoaXRlc3BhY2UaKHRoaXMuYWxsKG0sIG0udHJpbSgpLnNpemUoKSA9PSBtLnNpemUoKSlSCmFsbFRyaW1tZWRCygEKFWNvbS5tZXRhbHN0YWNrLmFwaS52MkIUUHJlZGVmaW5lZFJ1bGVzUHJvdG9QAVo1Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9hcGkvdjI7YXBpdjKiAgNNQViqAhFNZXRhbHN0YWNrLkFwaS5WMsoCEU1ldGFsc3RhY2tcQXBpXFYy4gIdTWV0YWxzdGFja1xBcGlcVjJcR1BCTWV0YWRhdGHqAhNNZXRhbHN0YWNrOjpBcGk6OlYy", [file_buf_validate_validate]);
+  fileDesc("CihtZXRhbHN0YWNrL2FwaS92Mi9wcmVkZWZpbmVkX3J1bGVzLnByb3RvEhFtZXRhbHN0YWNrLmFwaS52Mjq4AQoKbWFjYWRkcmVzcxIZLmJ1Zi52YWxpZGF0ZS5TdHJpbmdSdWxlcxi35pUmIAEoCEJ6wkh3CnUKEXN0cmluZy5tYWNhZGRyZXNzEiZ0aGlzIHN0cmluZyBtdXN0IGJlIGEgdmFsaWQgbWFjYWRkcmVzcxo4dGhpcy5tYXRjaGVzKCdeKFswLTlBLUZhLWZdezJ9WzpdKXs1fShbMC05QS1GYS1mXXsyfSkkJylSCm1hY2FkZHJlc3M6mQEKB2lzX25hbWUSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYuOaVJiABKAhCYsJIXwpdCg5zdHJpbmcuaXNfbmFtZRIjbXVzdCBiZSB3aXRoaW4gMiBhbmQgMTI4IGNoYXJhY3RlcnMaJnRoaXMuc2l6ZSgpID49IDIgJiYgdGhpcy5zaXplKCkgPD0gMTI4UgZpc05hbWU6mgEKDmlzX2Rlc2NyaXB0aW9uEhkuYnVmLnZhbGlkYXRlLlN0cmluZ1J1bGVzGLnmlSYgASgIQlXCSFIKUAoVc3RyaW5nLmlzX2Rlc2NyaXB0aW9uEiNtdXN0IGJlIHNob3J0ZXIgdGhhbiAyNTYgY2hhcmFjdGVycxoSdGhpcy5zaXplKCkgPD0gMjU2Ug1pc0Rlc2NyaXB0aW9uOqgBCgxpc19wYXJ0aXRpb24SGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYuuaVJiABKAhCZ8JIZApiChNzdHJpbmcuaXNfcGFydGl0aW9uEiNtdXN0IGJlIHdpdGhpbiAyIGFuZCAxMjggY2hhcmFjdGVycxomdGhpcy5zaXplKCkgPj0gMiAmJiB0aGlzLnNpemUoKSA8PSAxMjhSC2lzUGFydGl0aW9uOoIBCglpc19wcmVmaXgSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYu+aVJiABKAhCR8JIRApCCg9zdHJpbmcucHJlZml4ZXMSHGdpdmVuIHByZWZpeGVzIG11c3QgYmUgdmFsaWQaEXRoaXMuaXNJcFByZWZpeCgpUghpc1ByZWZpeDptCgZpc191cmkSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYvOaVJiABKAhCOMJINQozCgpzdHJpbmcudXJpEhdnaXZlbiB1cmkgbXVzdCBiZSB2YWxpZBoMdGhpcy5pc1VyaSgpUgVpc1VyaTqnAQoRaXNfaXBfb3JfaG9zdG5hbWUSGS5idWYudmFsaWRhdGUuU3RyaW5nUnVsZXMYveaVJiABKAhCXsJIWwpZCg12YWxpZF9hZGRyZXNzEiZtdXN0IGJlIGEgdmFsaWQgSVAgYWRkcmVzcyBvciBob3N0bmFtZRogdGhpcy5pc0lwKCkgfHwgdGhpcy5pc0hvc3RuYW1lKClSDmlzSXBPckhvc3RuYW1lOp0BCgd0cmltbWVkEhkuYnVmLnZhbGlkYXRlLlN0cmluZ1J1bGVzGL7mlSYgASgIQmXCSGIKYAoOc3RyaW5nLnRyaW1tZWQSK3ZhbHVlIG11c3Qgbm90IHN0YXJ0IG9yIGVuZCB3aXRoIHdoaXRlc3BhY2UaIXRoaXMudHJpbSgpLnNpemUoKSA9PSB0aGlzLnNpemUoKVIHdHJpbW1lZDqPAQoIcHJlZml4ZXMSGy5idWYudmFsaWRhdGUuUmVwZWF0ZWRSdWxlcxjHtJYmIAEoCEJTwkhQCk4KEXJlcGVhdGVkLnByZWZpeGVzEhxnaXZlbiBwcmVmaXhlcyBtdXN0IGJlIHZhbGlkGht0aGlzLmFsbChtLCBtLmlzSXBQcmVmaXgoKSlSCHByZWZpeGVzOnUKA2lwcxIbLmJ1Zi52YWxpZGF0ZS5SZXBlYXRlZFJ1bGVzGMi0liYgASgIQkPCSEAKPgoMcmVwZWF0ZWQuaXBzEhdnaXZlbiBpcHMgbXVzdCBiZSB2YWxpZBoVdGhpcy5hbGwobSwgbS5pc0lwKCkpUgNpcHM65gEKEWFyZV9ob3N0X2FuZF9wb3J0EhsuYnVmLnZhbGlkYXRlLlJlcGVhdGVkUnVsZXMYybSWJiABKAhCmgHCSJYBCpMBChpyZXBlYXRlZC5hcmVfaG9zdF9hbmRfcG9ydBJQZ2l2ZW4gZW50cmllcyBtdXN0IGFsbCBiZSBpbiB0aGUgZm9ybSBvZiA8aXAgfCBob3N0Pjo8cG9ydD4gYnV0IHBvcnQgaXMgb3B0aW9uYWwaI3RoaXMuYWxsKG0sIG0uaXNIb3N0QW5kUG9ydChmYWxzZSkpUg5hcmVIb3N0QW5kUG9ydDq6AQoLYWxsX3RyaW1tZWQSGy5idWYudmFsaWRhdGUuUmVwZWF0ZWRSdWxlcxjKtJYmIAEoCEJ5wkh2CnQKFHJlcGVhdGVkLmFsbF90cmltbWVkEjJnaXZlbiB2YWx1ZXMgbXVzdCBub3Qgc3RhcnQgb3IgZW5kIHdpdGggd2hpdGVzcGFjZRoodGhpcy5hbGwobSwgbS50cmltKCkuc2l6ZSgpID09IG0uc2l6ZSgpKVIKYWxsVHJpbW1lZELKAQoVY29tLm1ldGFsc3RhY2suYXBpLnYyQhRQcmVkZWZpbmVkUnVsZXNQcm90b1ABWjVnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FwaS92MjthcGl2MqICA01BWKoCEU1ldGFsc3RhY2suQXBpLlYyygIRTWV0YWxzdGFja1xBcGlcVjLiAh1NZXRhbHN0YWNrXEFwaVxWMlxHUEJNZXRhZGF0YeoCE01ldGFsc3RhY2s6OkFwaTo6VjI", [file_buf_validate_validate]);
 
 /**
  * Macaddress returns true if the given string is a valid macadress
@@ -70,7 +70,7 @@ export const is_ip_or_hostname: GenExtension<StringRules, boolean> = /*@__PURE__
   extDesc(file_metalstack_api_v2_predefined_rules, 6);
 
 /**
- * Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end.
+ * Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end
  *
  * @generated from extension: optional bool trimmed = 80048958;
  */
@@ -94,10 +94,18 @@ export const ips: GenExtension<RepeatedRules, boolean> = /*@__PURE__*/
   extDesc(file_metalstack_api_v2_predefined_rules, 9);
 
 /**
- * All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end.
+ * AreHostAndPort validates if a slice of strings are all in the form of <ip | host>:<port>
  *
- * @generated from extension: optional bool all_trimmed = 80058953;
+ * @generated from extension: optional bool are_host_and_port = 80058953;
  */
-export const all_trimmed: GenExtension<RepeatedRules, boolean> = /*@__PURE__*/
+export const are_host_and_port: GenExtension<RepeatedRules, boolean> = /*@__PURE__*/
   extDesc(file_metalstack_api_v2_predefined_rules, 10);
 
+/**
+ * All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end
+ *
+ * @generated from extension: optional bool all_trimmed = 80058954;
+ */
+export const all_trimmed: GenExtension<RepeatedRules, boolean> = /*@__PURE__*/
+  extDesc(file_metalstack_api_v2_predefined_rules, 11);
+
diff --git a/js/metalstack/api/v2/project_pb.d.ts b/js/metalstack/api/v2/project_pb.d.ts
index fb78a8b6..5f96b8ec 100644
--- a/js/metalstack/api/v2/project_pb.d.ts
+++ b/js/metalstack/api/v2/project_pb.d.ts
@@ -724,13 +724,13 @@ export type ProjectServiceInviteDeleteResponse = Message<"metalstack.api.v2.Proj
  */
 export declare const ProjectServiceInviteDeleteResponseSchema: GenMessage<ProjectServiceInviteDeleteResponse>;
 /**
- * ProjectService serves project related functions
+ * ProjectService provides project management operations.
  *
  * @generated from service metalstack.api.v2.ProjectService
  */
 export declare const ProjectService: GenService<{
     /**
-     * List all accessible projects
+     * Returns the list of all accessible projects.
      *
      * @generated from rpc metalstack.api.v2.ProjectService.List
      */
@@ -740,7 +740,7 @@ export declare const ProjectService: GenService<{
         output: typeof ProjectServiceListResponseSchema;
     };
     /**
-     * Get a project
+     * Returns the project with the specified UUID.
      *
      * @generated from rpc metalstack.api.v2.ProjectService.Get
      */
diff --git a/js/metalstack/api/v2/project_pb.js b/js/metalstack/api/v2/project_pb.js
index 29392b2d..6615ebb3 100644
--- a/js/metalstack/api/v2/project_pb.js
+++ b/js/metalstack/api/v2/project_pb.js
@@ -156,7 +156,7 @@ export const ProjectServiceInviteDeleteRequestSchema = /*@__PURE__*/ messageDesc
  */
 export const ProjectServiceInviteDeleteResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_api_v2_project, 28);
 /**
- * ProjectService serves project related functions
+ * ProjectService provides project management operations.
  *
  * @generated from service metalstack.api.v2.ProjectService
  */
diff --git a/js/metalstack/api/v2/project_pb.ts b/js/metalstack/api/v2/project_pb.ts
index cfd67960..1c368245 100644
--- a/js/metalstack/api/v2/project_pb.ts
+++ b/js/metalstack/api/v2/project_pb.ts
@@ -861,13 +861,13 @@ export const ProjectServiceInviteDeleteResponseSchema: GenMessage<ProjectService
   messageDesc(file_metalstack_api_v2_project, 28);
 
 /**
- * ProjectService serves project related functions
+ * ProjectService provides project management operations.
  *
  * @generated from service metalstack.api.v2.ProjectService
  */
 export const ProjectService: GenService<{
   /**
-   * List all accessible projects
+   * Returns the list of all accessible projects.
    *
    * @generated from rpc metalstack.api.v2.ProjectService.List
    */
@@ -877,7 +877,7 @@ export const ProjectService: GenService<{
     output: typeof ProjectServiceListResponseSchema;
   },
   /**
-   * Get a project
+   * Returns the project with the specified UUID.
    *
    * @generated from rpc metalstack.api.v2.ProjectService.Get
    */
diff --git a/js/metalstack/api/v2/size_imageconstraint_pb.d.ts b/js/metalstack/api/v2/size_imageconstraint_pb.d.ts
index 1db16df7..6a5c98d5 100644
--- a/js/metalstack/api/v2/size_imageconstraint_pb.d.ts
+++ b/js/metalstack/api/v2/size_imageconstraint_pb.d.ts
@@ -147,13 +147,13 @@ export type SizeImageConstraintQuery = Message<"metalstack.api.v2.SizeImageConst
  */
 export declare const SizeImageConstraintQuerySchema: GenMessage<SizeImageConstraintQuery>;
 /**
- * SizeImageConstraintService serves size and image constraint related functions
+ * SizeImageConstraintService provides size and image constraint validation operations.
  *
  * @generated from service metalstack.api.v2.SizeImageConstraintService
  */
 export declare const SizeImageConstraintService: GenService<{
     /**
-     * Try if a given combination of size and image is possible
+     * Try validates if a given combination of size and image is possible.
      *
      * @generated from rpc metalstack.api.v2.SizeImageConstraintService.Try
      */
diff --git a/js/metalstack/api/v2/size_imageconstraint_pb.js b/js/metalstack/api/v2/size_imageconstraint_pb.js
index 9320fc10..ee6d7227 100644
--- a/js/metalstack/api/v2/size_imageconstraint_pb.js
+++ b/js/metalstack/api/v2/size_imageconstraint_pb.js
@@ -35,7 +35,7 @@ export const ImageConstraintSchema = /*@__PURE__*/ messageDesc(file_metalstack_a
  */
 export const SizeImageConstraintQuerySchema = /*@__PURE__*/ messageDesc(file_metalstack_api_v2_size_imageconstraint, 4);
 /**
- * SizeImageConstraintService serves size and image constraint related functions
+ * SizeImageConstraintService provides size and image constraint validation operations.
  *
  * @generated from service metalstack.api.v2.SizeImageConstraintService
  */
diff --git a/js/metalstack/api/v2/size_imageconstraint_pb.ts b/js/metalstack/api/v2/size_imageconstraint_pb.ts
index 0764d969..fca123db 100644
--- a/js/metalstack/api/v2/size_imageconstraint_pb.ts
+++ b/js/metalstack/api/v2/size_imageconstraint_pb.ts
@@ -182,13 +182,13 @@ export const SizeImageConstraintQuerySchema: GenMessage<SizeImageConstraintQuery
   messageDesc(file_metalstack_api_v2_size_imageconstraint, 4);
 
 /**
- * SizeImageConstraintService serves size and image constraint related functions
+ * SizeImageConstraintService provides size and image constraint validation operations.
  *
  * @generated from service metalstack.api.v2.SizeImageConstraintService
  */
 export const SizeImageConstraintService: GenService<{
   /**
-   * Try if a given combination of size and image is possible
+   * Try validates if a given combination of size and image is possible.
    *
    * @generated from rpc metalstack.api.v2.SizeImageConstraintService.Try
    */
diff --git a/js/metalstack/api/v2/size_pb.d.ts b/js/metalstack/api/v2/size_pb.d.ts
index c8704f9b..893706a7 100644
--- a/js/metalstack/api/v2/size_pb.d.ts
+++ b/js/metalstack/api/v2/size_pb.d.ts
@@ -233,13 +233,13 @@ export declare enum SizeConstraintType {
  */
 export declare const SizeConstraintTypeSchema: GenEnum<SizeConstraintType>;
 /**
- * SizeService serves size related functions
+ * SizeService provides size management operations.
  *
  * @generated from service metalstack.api.v2.SizeService
  */
 export declare const SizeService: GenService<{
     /**
-     * Get a size
+     * Returns the size with the specified ID.
      *
      * @generated from rpc metalstack.api.v2.SizeService.Get
      */
@@ -249,7 +249,7 @@ export declare const SizeService: GenService<{
         output: typeof SizeServiceGetResponseSchema;
     };
     /**
-     * List all sizes
+     * Returns the list of all sizes.
      *
      * @generated from rpc metalstack.api.v2.SizeService.List
      */
diff --git a/js/metalstack/api/v2/size_pb.js b/js/metalstack/api/v2/size_pb.js
index 7b6404c3..6b372401 100644
--- a/js/metalstack/api/v2/size_pb.js
+++ b/js/metalstack/api/v2/size_pb.js
@@ -87,7 +87,7 @@ export var SizeConstraintType;
  */
 export const SizeConstraintTypeSchema = /*@__PURE__*/ enumDesc(file_metalstack_api_v2_size, 0);
 /**
- * SizeService serves size related functions
+ * SizeService provides size management operations.
  *
  * @generated from service metalstack.api.v2.SizeService
  */
diff --git a/js/metalstack/api/v2/size_pb.ts b/js/metalstack/api/v2/size_pb.ts
index f8f13067..8d59f5ed 100644
--- a/js/metalstack/api/v2/size_pb.ts
+++ b/js/metalstack/api/v2/size_pb.ts
@@ -282,13 +282,13 @@ export const SizeConstraintTypeSchema: GenEnum<SizeConstraintType> = /*@__PURE__
   enumDesc(file_metalstack_api_v2_size, 0);
 
 /**
- * SizeService serves size related functions
+ * SizeService provides size management operations.
  *
  * @generated from service metalstack.api.v2.SizeService
  */
 export const SizeService: GenService<{
   /**
-   * Get a size
+   * Returns the size with the specified ID.
    *
    * @generated from rpc metalstack.api.v2.SizeService.Get
    */
@@ -298,7 +298,7 @@ export const SizeService: GenService<{
     output: typeof SizeServiceGetResponseSchema;
   },
   /**
-   * List all sizes
+   * Returns the list of all sizes.
    *
    * @generated from rpc metalstack.api.v2.SizeService.List
    */
diff --git a/js/metalstack/api/v2/size_reservation_pb.d.ts b/js/metalstack/api/v2/size_reservation_pb.d.ts
index 23deb641..cc6138e6 100644
--- a/js/metalstack/api/v2/size_reservation_pb.d.ts
+++ b/js/metalstack/api/v2/size_reservation_pb.d.ts
@@ -204,13 +204,13 @@ export type SizeReservationQuery = Message<"metalstack.api.v2.SizeReservationQue
  */
 export declare const SizeReservationQuerySchema: GenMessage<SizeReservationQuery>;
 /**
- * SizeReservationService serves size reservation related functions
+ * SizeReservationService provides size reservation management operations.
  *
  * @generated from service metalstack.api.v2.SizeReservationService
  */
 export declare const SizeReservationService: GenService<{
     /**
-     * Get a size reservation
+     * Returns the size reservation with the specified ID.
      *
      * @generated from rpc metalstack.api.v2.SizeReservationService.Get
      */
@@ -220,7 +220,7 @@ export declare const SizeReservationService: GenService<{
         output: typeof SizeReservationServiceGetResponseSchema;
     };
     /**
-     * List size reservations
+     * Returns the list of size reservations.
      *
      * @generated from rpc metalstack.api.v2.SizeReservationService.List
      */
diff --git a/js/metalstack/api/v2/size_reservation_pb.js b/js/metalstack/api/v2/size_reservation_pb.js
index 2dddcff3..edf7a8b8 100644
--- a/js/metalstack/api/v2/size_reservation_pb.js
+++ b/js/metalstack/api/v2/size_reservation_pb.js
@@ -40,7 +40,7 @@ export const SizeReservationSchema = /*@__PURE__*/ messageDesc(file_metalstack_a
  */
 export const SizeReservationQuerySchema = /*@__PURE__*/ messageDesc(file_metalstack_api_v2_size_reservation, 5);
 /**
- * SizeReservationService serves size reservation related functions
+ * SizeReservationService provides size reservation management operations.
  *
  * @generated from service metalstack.api.v2.SizeReservationService
  */
diff --git a/js/metalstack/api/v2/size_reservation_pb.ts b/js/metalstack/api/v2/size_reservation_pb.ts
index a5a7fefa..8d75f64b 100644
--- a/js/metalstack/api/v2/size_reservation_pb.ts
+++ b/js/metalstack/api/v2/size_reservation_pb.ts
@@ -248,13 +248,13 @@ export const SizeReservationQuerySchema: GenMessage<SizeReservationQuery> = /*@_
   messageDesc(file_metalstack_api_v2_size_reservation, 5);
 
 /**
- * SizeReservationService serves size reservation related functions
+ * SizeReservationService provides size reservation management operations.
  *
  * @generated from service metalstack.api.v2.SizeReservationService
  */
 export const SizeReservationService: GenService<{
   /**
-   * Get a size reservation
+   * Returns the size reservation with the specified ID.
    *
    * @generated from rpc metalstack.api.v2.SizeReservationService.Get
    */
@@ -264,7 +264,7 @@ export const SizeReservationService: GenService<{
     output: typeof SizeReservationServiceGetResponseSchema;
   },
   /**
-   * List size reservations
+   * Returns the list of size reservations.
    *
    * @generated from rpc metalstack.api.v2.SizeReservationService.List
    */
diff --git a/js/metalstack/api/v2/tenant_pb.d.ts b/js/metalstack/api/v2/tenant_pb.d.ts
index 886ba139..40ed0339 100644
--- a/js/metalstack/api/v2/tenant_pb.d.ts
+++ b/js/metalstack/api/v2/tenant_pb.d.ts
@@ -726,13 +726,13 @@ export type TenantServiceUpdateMemberResponse = Message<"metalstack.api.v2.Tenan
  */
 export declare const TenantServiceUpdateMemberResponseSchema: GenMessage<TenantServiceUpdateMemberResponse>;
 /**
- * TenantService serves tenant related functions
+ * TenantService provides tenant management operations.
  *
  * @generated from service metalstack.api.v2.TenantService
  */
 export declare const TenantService: GenService<{
     /**
-     * Create a tenant
+     * Creates a new tenant.
      *
      * @generated from rpc metalstack.api.v2.TenantService.Create
      */
@@ -742,7 +742,7 @@ export declare const TenantService: GenService<{
         output: typeof TenantServiceCreateResponseSchema;
     };
     /**
-     * List tenants
+     * Returns the list of tenants.
      *
      * @generated from rpc metalstack.api.v2.TenantService.List
      */
diff --git a/js/metalstack/api/v2/tenant_pb.js b/js/metalstack/api/v2/tenant_pb.js
index 519a3543..66218480 100644
--- a/js/metalstack/api/v2/tenant_pb.js
+++ b/js/metalstack/api/v2/tenant_pb.js
@@ -156,7 +156,7 @@ export const TenantServiceUpdateMemberRequestSchema = /*@__PURE__*/ messageDesc(
  */
 export const TenantServiceUpdateMemberResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_api_v2_tenant, 28);
 /**
- * TenantService serves tenant related functions
+ * TenantService provides tenant management operations.
  *
  * @generated from service metalstack.api.v2.TenantService
  */
diff --git a/js/metalstack/api/v2/tenant_pb.ts b/js/metalstack/api/v2/tenant_pb.ts
index 7ccbad6c..c6532582 100644
--- a/js/metalstack/api/v2/tenant_pb.ts
+++ b/js/metalstack/api/v2/tenant_pb.ts
@@ -864,13 +864,13 @@ export const TenantServiceUpdateMemberResponseSchema: GenMessage<TenantServiceUp
   messageDesc(file_metalstack_api_v2_tenant, 28);
 
 /**
- * TenantService serves tenant related functions
+ * TenantService provides tenant management operations.
  *
  * @generated from service metalstack.api.v2.TenantService
  */
 export const TenantService: GenService<{
   /**
-   * Create a tenant
+   * Creates a new tenant.
    *
    * @generated from rpc metalstack.api.v2.TenantService.Create
    */
@@ -880,7 +880,7 @@ export const TenantService: GenService<{
     output: typeof TenantServiceCreateResponseSchema;
   },
   /**
-   * List tenants
+   * Returns the list of tenants.
    *
    * @generated from rpc metalstack.api.v2.TenantService.List
    */
diff --git a/js/metalstack/api/v2/token_pb.d.ts b/js/metalstack/api/v2/token_pb.d.ts
index 4b5c17f0..6fea6b9f 100644
--- a/js/metalstack/api/v2/token_pb.d.ts
+++ b/js/metalstack/api/v2/token_pb.d.ts
@@ -497,13 +497,13 @@ export declare enum TokenType {
  */
 export declare const TokenTypeSchema: GenEnum<TokenType>;
 /**
- * TokenService serves token related functions
+ * TokenService provides token management operations.
  *
  * @generated from service metalstack.api.v2.TokenService
  */
 export declare const TokenService: GenService<{
     /**
-     * Get a token
+     * Returns the token with the specified UUID.
      *
      * @generated from rpc metalstack.api.v2.TokenService.Get
      */
@@ -513,7 +513,7 @@ export declare const TokenService: GenService<{
         output: typeof TokenServiceGetResponseSchema;
     };
     /**
-     * Create a token to authenticate against the platform, the secret will be only visible in the response.
+     * Creates a token to authenticate against the platform, the secret will be only visible in the response.
      *
      * @generated from rpc metalstack.api.v2.TokenService.Create
      */
@@ -523,7 +523,7 @@ export declare const TokenService: GenService<{
         output: typeof TokenServiceCreateResponseSchema;
     };
     /**
-     * Update a token
+     * Updates a token.
      *
      * @generated from rpc metalstack.api.v2.TokenService.Update
      */
@@ -533,7 +533,7 @@ export declare const TokenService: GenService<{
         output: typeof TokenServiceUpdateResponseSchema;
     };
     /**
-     * List all your tokens
+     * Returns the list of all user tokens.
      *
      * @generated from rpc metalstack.api.v2.TokenService.List
      */
@@ -543,7 +543,7 @@ export declare const TokenService: GenService<{
         output: typeof TokenServiceListResponseSchema;
     };
     /**
-     * Revoke a token, no further usage is possible afterwards
+     * Revokes a token, no further usage is possible afterwards.
      *
      * @generated from rpc metalstack.api.v2.TokenService.Revoke
      */
@@ -553,7 +553,7 @@ export declare const TokenService: GenService<{
         output: typeof TokenServiceRevokeResponseSchema;
     };
     /**
-     * Refresh a token, this will create a new token with the exact same permissions as the calling token contains
+     * Refreshes a token, this will create a new token with the exact same permissions as the calling token contains.
      *
      * @generated from rpc metalstack.api.v2.TokenService.Refresh
      */
diff --git a/js/metalstack/api/v2/token_pb.js b/js/metalstack/api/v2/token_pb.js
index e52c4c94..13a69174 100644
--- a/js/metalstack/api/v2/token_pb.js
+++ b/js/metalstack/api/v2/token_pb.js
@@ -111,7 +111,7 @@ export var TokenType;
  */
 export const TokenTypeSchema = /*@__PURE__*/ enumDesc(file_metalstack_api_v2_token, 0);
 /**
- * TokenService serves token related functions
+ * TokenService provides token management operations.
  *
  * @generated from service metalstack.api.v2.TokenService
  */
diff --git a/js/metalstack/api/v2/token_pb.ts b/js/metalstack/api/v2/token_pb.ts
index 4e43541c..bf9b40a9 100644
--- a/js/metalstack/api/v2/token_pb.ts
+++ b/js/metalstack/api/v2/token_pb.ts
@@ -573,13 +573,13 @@ export const TokenTypeSchema: GenEnum<TokenType> = /*@__PURE__*/
   enumDesc(file_metalstack_api_v2_token, 0);
 
 /**
- * TokenService serves token related functions
+ * TokenService provides token management operations.
  *
  * @generated from service metalstack.api.v2.TokenService
  */
 export const TokenService: GenService<{
   /**
-   * Get a token
+   * Returns the token with the specified UUID.
    *
    * @generated from rpc metalstack.api.v2.TokenService.Get
    */
@@ -589,7 +589,7 @@ export const TokenService: GenService<{
     output: typeof TokenServiceGetResponseSchema;
   },
   /**
-   * Create a token to authenticate against the platform, the secret will be only visible in the response.
+   * Creates a token to authenticate against the platform, the secret will be only visible in the response.
    *
    * @generated from rpc metalstack.api.v2.TokenService.Create
    */
@@ -599,7 +599,7 @@ export const TokenService: GenService<{
     output: typeof TokenServiceCreateResponseSchema;
   },
   /**
-   * Update a token
+   * Updates a token.
    *
    * @generated from rpc metalstack.api.v2.TokenService.Update
    */
@@ -609,7 +609,7 @@ export const TokenService: GenService<{
     output: typeof TokenServiceUpdateResponseSchema;
   },
   /**
-   * List all your tokens
+   * Returns the list of all user tokens.
    *
    * @generated from rpc metalstack.api.v2.TokenService.List
    */
@@ -619,7 +619,7 @@ export const TokenService: GenService<{
     output: typeof TokenServiceListResponseSchema;
   },
   /**
-   * Revoke a token, no further usage is possible afterwards
+   * Revokes a token, no further usage is possible afterwards.
    *
    * @generated from rpc metalstack.api.v2.TokenService.Revoke
    */
@@ -629,7 +629,7 @@ export const TokenService: GenService<{
     output: typeof TokenServiceRevokeResponseSchema;
   },
   /**
-   * Refresh a token, this will create a new token with the exact same permissions as the calling token contains
+   * Refreshes a token, this will create a new token with the exact same permissions as the calling token contains.
    *
    * @generated from rpc metalstack.api.v2.TokenService.Refresh
    */
diff --git a/js/metalstack/api/v2/user_pb.d.ts b/js/metalstack/api/v2/user_pb.d.ts
index 7845a278..de292d34 100644
--- a/js/metalstack/api/v2/user_pb.d.ts
+++ b/js/metalstack/api/v2/user_pb.d.ts
@@ -7,13 +7,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_api_v2_user: GenFile;
 /**
- * User is a end user of the platform
+ * User represents an end user of the platform.
  *
  * @generated from message metalstack.api.v2.User
  */
 export type User = Message<"metalstack.api.v2.User"> & {
     /**
-     * Login the login at the provider
+     * Login is the login at the provider
      *
      * @generated from field: string login = 1;
      */
@@ -61,7 +61,7 @@ export type User = Message<"metalstack.api.v2.User"> & {
  */
 export declare const UserSchema: GenMessage<User>;
 /**
- * UserServiceGetRequest is the request to get the user
+ * UserServiceGetRequest is the request payload for getting the user.
  *
  * @generated from message metalstack.api.v2.UserServiceGetRequest
  */
@@ -72,13 +72,13 @@ export type UserServiceGetRequest = Message<"metalstack.api.v2.UserServiceGetReq
  */
 export declare const UserServiceGetRequestSchema: GenMessage<UserServiceGetRequest>;
 /**
- * UserServiceGetResponse the response when userservice get request was called
+ * UserServiceGetResponse is the response payload for getting the user.
  *
  * @generated from message metalstack.api.v2.UserServiceGetResponse
  */
 export type UserServiceGetResponse = Message<"metalstack.api.v2.UserServiceGetResponse"> & {
     /**
-     * User is the user
+     * User contains the authenticated user
      *
      * @generated from field: metalstack.api.v2.User user = 1;
      */
@@ -90,13 +90,13 @@ export type UserServiceGetResponse = Message<"metalstack.api.v2.UserServiceGetRe
  */
 export declare const UserServiceGetResponseSchema: GenMessage<UserServiceGetResponse>;
 /**
- * UserService exposes rpc calls for users
+ * UserService provides user information operations.
  *
  * @generated from service metalstack.api.v2.UserService
  */
 export declare const UserService: GenService<{
     /**
-     * Get a User
+     * Returns the authenticated user.
      *
      * @generated from rpc metalstack.api.v2.UserService.Get
      */
diff --git a/js/metalstack/api/v2/user_pb.js b/js/metalstack/api/v2/user_pb.js
index 5df96cb7..995f4a2a 100644
--- a/js/metalstack/api/v2/user_pb.js
+++ b/js/metalstack/api/v2/user_pb.js
@@ -27,7 +27,7 @@ export const UserServiceGetRequestSchema = /*@__PURE__*/ messageDesc(file_metals
  */
 export const UserServiceGetResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_api_v2_user, 2);
 /**
- * UserService exposes rpc calls for users
+ * UserService provides user information operations.
  *
  * @generated from service metalstack.api.v2.UserService
  */
diff --git a/js/metalstack/api/v2/user_pb.ts b/js/metalstack/api/v2/user_pb.ts
index a74dc76c..661f8f76 100644
--- a/js/metalstack/api/v2/user_pb.ts
+++ b/js/metalstack/api/v2/user_pb.ts
@@ -20,13 +20,13 @@ export const file_metalstack_api_v2_user: GenFile = /*@__PURE__*/
   fileDesc("ChxtZXRhbHN0YWNrL2FwaS92Mi91c2VyLnByb3RvEhFtZXRhbHN0YWNrLmFwaS52MiLgAQoEVXNlchINCgVsb2dpbhgBIAEoCRIZCgRuYW1lGAIgASgJQgu6SAhyBsCzrrECARINCgVlbWFpbBgDIAEoCRISCgphdmF0YXJfdXJsGAQgASgJEioKB3RlbmFudHMYBSADKAsyGS5tZXRhbHN0YWNrLmFwaS52Mi5UZW5hbnQSLAoIcHJvamVjdHMYBiADKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5Qcm9qZWN0EjEKDmRlZmF1bHRfdGVuYW50GAcgASgLMhkubWV0YWxzdGFjay5hcGkudjIuVGVuYW50IhcKFVVzZXJTZXJ2aWNlR2V0UmVxdWVzdCI/ChZVc2VyU2VydmljZUdldFJlc3BvbnNlEiUKBHVzZXIYASABKAsyFy5tZXRhbHN0YWNrLmFwaS52Mi5Vc2VyMnMKC1VzZXJTZXJ2aWNlEmQKA0dldBIoLm1ldGFsc3RhY2suYXBpLnYyLlVzZXJTZXJ2aWNlR2V0UmVxdWVzdBopLm1ldGFsc3RhY2suYXBpLnYyLlVzZXJTZXJ2aWNlR2V0UmVzcG9uc2UiCNjzGAPg8xgBQr8BChVjb20ubWV0YWxzdGFjay5hcGkudjJCCVVzZXJQcm90b1ABWjVnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FwaS92MjthcGl2MqICA01BWKoCEU1ldGFsc3RhY2suQXBpLlYyygIRTWV0YWxzdGFja1xBcGlcVjLiAh1NZXRhbHN0YWNrXEFwaVxWMlxHUEJNZXRhZGF0YeoCE01ldGFsc3RhY2s6OkFwaTo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_project, file_metalstack_api_v2_tenant]);
 
 /**
- * User is a end user of the platform
+ * User represents an end user of the platform.
  *
  * @generated from message metalstack.api.v2.User
  */
 export type User = Message<"metalstack.api.v2.User"> & {
   /**
-   * Login the login at the provider
+   * Login is the login at the provider
    *
    * @generated from field: string login = 1;
    */
@@ -83,7 +83,7 @@ export const UserSchema: GenMessage<User> = /*@__PURE__*/
   messageDesc(file_metalstack_api_v2_user, 0);
 
 /**
- * UserServiceGetRequest is the request to get the user
+ * UserServiceGetRequest is the request payload for getting the user.
  *
  * @generated from message metalstack.api.v2.UserServiceGetRequest
  */
@@ -98,13 +98,13 @@ export const UserServiceGetRequestSchema: GenMessage<UserServiceGetRequest> = /*
   messageDesc(file_metalstack_api_v2_user, 1);
 
 /**
- * UserServiceGetResponse the response when userservice get request was called
+ * UserServiceGetResponse is the response payload for getting the user.
  *
  * @generated from message metalstack.api.v2.UserServiceGetResponse
  */
 export type UserServiceGetResponse = Message<"metalstack.api.v2.UserServiceGetResponse"> & {
   /**
-   * User is the user
+   * User contains the authenticated user
    *
    * @generated from field: metalstack.api.v2.User user = 1;
    */
@@ -119,13 +119,13 @@ export const UserServiceGetResponseSchema: GenMessage<UserServiceGetResponse> =
   messageDesc(file_metalstack_api_v2_user, 2);
 
 /**
- * UserService exposes rpc calls for users
+ * UserService provides user information operations.
  *
  * @generated from service metalstack.api.v2.UserService
  */
 export const UserService: GenService<{
   /**
-   * Get a User
+   * Returns the authenticated user.
    *
    * @generated from rpc metalstack.api.v2.UserService.Get
    */
diff --git a/js/metalstack/api/v2/version_pb.d.ts b/js/metalstack/api/v2/version_pb.d.ts
index bffdc82c..2ca4ddbb 100644
--- a/js/metalstack/api/v2/version_pb.d.ts
+++ b/js/metalstack/api/v2/version_pb.d.ts
@@ -5,7 +5,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_api_v2_version: GenFile;
 /**
- * Version of the application
+ * Version represents the version of the application.
  *
  * @generated from message metalstack.api.v2.Version
  */
@@ -41,7 +41,7 @@ export type Version = Message<"metalstack.api.v2.Version"> & {
  */
 export declare const VersionSchema: GenMessage<Version>;
 /**
- * VersionServiceGetRequest is the request payload to get the version
+ * VersionServiceGetRequest is the request payload for getting the version.
  *
  * @generated from message metalstack.api.v2.VersionServiceGetRequest
  */
@@ -52,13 +52,13 @@ export type VersionServiceGetRequest = Message<"metalstack.api.v2.VersionService
  */
 export declare const VersionServiceGetRequestSchema: GenMessage<VersionServiceGetRequest>;
 /**
- * VersionServiceGetResponse is the response payload with the version
+ * VersionServiceGetResponse is the response payload for getting the version.
  *
  * @generated from message metalstack.api.v2.VersionServiceGetResponse
  */
 export type VersionServiceGetResponse = Message<"metalstack.api.v2.VersionServiceGetResponse"> & {
     /**
-     * Version of the application
+     * Version contains the version of the application
      *
      * @generated from field: metalstack.api.v2.Version version = 1;
      */
@@ -70,13 +70,13 @@ export type VersionServiceGetResponse = Message<"metalstack.api.v2.VersionServic
  */
 export declare const VersionServiceGetResponseSchema: GenMessage<VersionServiceGetResponse>;
 /**
- * VersionService serves version related functions
+ * VersionService provides version information operations.
  *
  * @generated from service metalstack.api.v2.VersionService
  */
 export declare const VersionService: GenService<{
     /**
-     * Get the version
+     * Returns the version of the application.
      *
      * @generated from rpc metalstack.api.v2.VersionService.Get
      */
diff --git a/js/metalstack/api/v2/version_pb.js b/js/metalstack/api/v2/version_pb.js
index 1b850adc..e88f3003 100644
--- a/js/metalstack/api/v2/version_pb.js
+++ b/js/metalstack/api/v2/version_pb.js
@@ -25,7 +25,7 @@ export const VersionServiceGetRequestSchema = /*@__PURE__*/ messageDesc(file_met
  */
 export const VersionServiceGetResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_api_v2_version, 2);
 /**
- * VersionService serves version related functions
+ * VersionService provides version information operations.
  *
  * @generated from service metalstack.api.v2.VersionService
  */
diff --git a/js/metalstack/api/v2/version_pb.ts b/js/metalstack/api/v2/version_pb.ts
index b46963e6..87eb1d98 100644
--- a/js/metalstack/api/v2/version_pb.ts
+++ b/js/metalstack/api/v2/version_pb.ts
@@ -16,7 +16,7 @@ export const file_metalstack_api_v2_version: GenFile = /*@__PURE__*/
   fileDesc("Ch9tZXRhbHN0YWNrL2FwaS92Mi92ZXJzaW9uLnByb3RvEhFtZXRhbHN0YWNrLmFwaS52MiKGAQoHVmVyc2lvbhIcCgd2ZXJzaW9uGAEgASgJQgu6SAhyBsizrrECARIdCghyZXZpc2lvbhgCIAEoCUILukgIcgbIs66xAgESHQoIZ2l0X3NoYTEYAyABKAlCC7pICHIGyLOusQIBEh8KCmJ1aWxkX2RhdGUYBCABKAlCC7pICHIGyLOusQIBIhoKGFZlcnNpb25TZXJ2aWNlR2V0UmVxdWVzdCJIChlWZXJzaW9uU2VydmljZUdldFJlc3BvbnNlEisKB3ZlcnNpb24YASABKAsyGi5tZXRhbHN0YWNrLmFwaS52Mi5WZXJzaW9uMnwKDlZlcnNpb25TZXJ2aWNlEmoKA0dldBIrLm1ldGFsc3RhY2suYXBpLnYyLlZlcnNpb25TZXJ2aWNlR2V0UmVxdWVzdBosLm1ldGFsc3RhY2suYXBpLnYyLlZlcnNpb25TZXJ2aWNlR2V0UmVzcG9uc2UiCNjzGAHg8xgCQsIBChVjb20ubWV0YWxzdGFjay5hcGkudjJCDFZlcnNpb25Qcm90b1ABWjVnaXRodWIuY29tL21ldGFsLXN0YWNrL2FwaS9nby9tZXRhbHN0YWNrL2FwaS92MjthcGl2MqICA01BWKoCEU1ldGFsc3RhY2suQXBpLlYyygIRTWV0YWxzdGFja1xBcGlcVjLiAh1NZXRhbHN0YWNrXEFwaVxWMlxHUEJNZXRhZGF0YeoCE01ldGFsc3RhY2s6OkFwaTo6VjJiBnByb3RvMw", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules]);
 
 /**
- * Version of the application
+ * Version represents the version of the application.
  *
  * @generated from message metalstack.api.v2.Version
  */
@@ -58,7 +58,7 @@ export const VersionSchema: GenMessage<Version> = /*@__PURE__*/
   messageDesc(file_metalstack_api_v2_version, 0);
 
 /**
- * VersionServiceGetRequest is the request payload to get the version
+ * VersionServiceGetRequest is the request payload for getting the version.
  *
  * @generated from message metalstack.api.v2.VersionServiceGetRequest
  */
@@ -73,13 +73,13 @@ export const VersionServiceGetRequestSchema: GenMessage<VersionServiceGetRequest
   messageDesc(file_metalstack_api_v2_version, 1);
 
 /**
- * VersionServiceGetResponse is the response payload with the version
+ * VersionServiceGetResponse is the response payload for getting the version.
  *
  * @generated from message metalstack.api.v2.VersionServiceGetResponse
  */
 export type VersionServiceGetResponse = Message<"metalstack.api.v2.VersionServiceGetResponse"> & {
   /**
-   * Version of the application
+   * Version contains the version of the application
    *
    * @generated from field: metalstack.api.v2.Version version = 1;
    */
@@ -94,13 +94,13 @@ export const VersionServiceGetResponseSchema: GenMessage<VersionServiceGetRespon
   messageDesc(file_metalstack_api_v2_version, 2);
 
 /**
- * VersionService serves version related functions
+ * VersionService provides version information operations.
  *
  * @generated from service metalstack.api.v2.VersionService
  */
 export const VersionService: GenService<{
   /**
-   * Get the version
+   * Returns the version of the application.
    *
    * @generated from rpc metalstack.api.v2.VersionService.Get
    */
diff --git a/js/metalstack/api/v2/vpn_pb.d.ts b/js/metalstack/api/v2/vpn_pb.d.ts
index d3788c46..7b348bfb 100644
--- a/js/metalstack/api/v2/vpn_pb.d.ts
+++ b/js/metalstack/api/v2/vpn_pb.d.ts
@@ -6,13 +6,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_api_v2_vpn: GenFile;
 /**
- * VPNNode is a machine connected to the vpn
+ * VPNNode represents a machine connected to the VPN.
  *
  * @generated from message metalstack.api.v2.VPNNode
  */
 export type VPNNode = Message<"metalstack.api.v2.VPNNode"> & {
     /**
-     * Id of this node
+     * ID of this node
      *
      * @generated from field: uint64 id = 1;
      */
@@ -30,13 +30,13 @@ export type VPNNode = Message<"metalstack.api.v2.VPNNode"> & {
      */
     project: string;
     /**
-     * IPAddresses of this node in the vpn
+     * IPAddresses of this node in the VPN
      *
      * @generated from field: repeated string ip_addresses = 4;
      */
     ipAddresses: string[];
     /**
-     * LastSeen timestamp when this node reached out the the control plane
+     * LastSeen timestamp when this node reached out to the control plane
      *
      * @generated from field: google.protobuf.Timestamp last_seen = 5;
      */
diff --git a/js/metalstack/api/v2/vpn_pb.ts b/js/metalstack/api/v2/vpn_pb.ts
index 68ca9241..ec96ce7a 100644
--- a/js/metalstack/api/v2/vpn_pb.ts
+++ b/js/metalstack/api/v2/vpn_pb.ts
@@ -15,13 +15,13 @@ export const file_metalstack_api_v2_vpn: GenFile = /*@__PURE__*/
   fileDesc("ChttZXRhbHN0YWNrL2FwaS92Mi92cG4ucHJvdG8SEW1ldGFsc3RhY2suYXBpLnYyIokBCgdWUE5Ob2RlEgoKAmlkGAEgASgEEgwKBG5hbWUYAiABKAkSDwoHcHJvamVjdBgDIAEoCRIUCgxpcF9hZGRyZXNzZXMYBCADKAkSLQoJbGFzdF9zZWVuGAUgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcBIOCgZvbmxpbmUYBiABKAhCvgEKFWNvbS5tZXRhbHN0YWNrLmFwaS52MkIIVnBuUHJvdG9QAVo1Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9hcGkvdjI7YXBpdjKiAgNNQViqAhFNZXRhbHN0YWNrLkFwaS5WMsoCEU1ldGFsc3RhY2tcQXBpXFYy4gIdTWV0YWxzdGFja1xBcGlcVjJcR1BCTWV0YWRhdGHqAhNNZXRhbHN0YWNrOjpBcGk6OlYyYgZwcm90bzM", [file_google_protobuf_timestamp]);
 
 /**
- * VPNNode is a machine connected to the vpn
+ * VPNNode represents a machine connected to the VPN.
  *
  * @generated from message metalstack.api.v2.VPNNode
  */
 export type VPNNode = Message<"metalstack.api.v2.VPNNode"> & {
   /**
-   * Id of this node
+   * ID of this node
    *
    * @generated from field: uint64 id = 1;
    */
@@ -42,14 +42,14 @@ export type VPNNode = Message<"metalstack.api.v2.VPNNode"> & {
   project: string;
 
   /**
-   * IPAddresses of this node in the vpn
+   * IPAddresses of this node in the VPN
    *
    * @generated from field: repeated string ip_addresses = 4;
    */
   ipAddresses: string[];
 
   /**
-   * LastSeen timestamp when this node reached out the the control plane
+   * LastSeen timestamp when this node reached out to the control plane
    *
    * @generated from field: google.protobuf.Timestamp last_seen = 5;
    */
diff --git a/js/metalstack/infra/v2/bmc_pb.d.ts b/js/metalstack/infra/v2/bmc_pb.d.ts
index e97d2903..fa041cd5 100644
--- a/js/metalstack/infra/v2/bmc_pb.d.ts
+++ b/js/metalstack/infra/v2/bmc_pb.d.ts
@@ -6,19 +6,19 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_infra_v2_bmc: GenFile;
 /**
- * UpdateBMCInfoRequest
+ * UpdateBMCInfoRequest is the request payload for updating BMC information.
  *
  * @generated from message metalstack.infra.v2.UpdateBMCInfoRequest
  */
 export type UpdateBMCInfoRequest = Message<"metalstack.infra.v2.UpdateBMCInfoRequest"> & {
     /**
-     * Partition the partition id where metal-bmc wants to receive events
+     * Partition is the partition ID where metal-bmc wants to receive events
      *
      * @generated from field: string partition = 1;
      */
     partition: string;
     /**
-     * BmcReports contains maps the bmc report per machine uuid
+     * BmcReports contains maps the BMC report per machine UUID
      *
      * @generated from field: map<string, metalstack.api.v2.MachineBMCReport> bmc_reports = 2;
      */
@@ -32,19 +32,19 @@ export type UpdateBMCInfoRequest = Message<"metalstack.infra.v2.UpdateBMCInfoReq
  */
 export declare const UpdateBMCInfoRequestSchema: GenMessage<UpdateBMCInfoRequest>;
 /**
- * UpdateBMCInfoResponse
+ * UpdateBMCInfoResponse is the response payload for updating BMC information.
  *
  * @generated from message metalstack.infra.v2.UpdateBMCInfoResponse
  */
 export type UpdateBMCInfoResponse = Message<"metalstack.infra.v2.UpdateBMCInfoResponse"> & {
     /**
-     * UpdatedMachines is a slice of machine uuids which were updated
+     * UpdatedMachines is a slice of machine UUIDs which were updated
      *
      * @generated from field: repeated string updated_machines = 1;
      */
     updatedMachines: string[];
     /**
-     * CreatedMachines is a slice of machine uuids which were created
+     * CreatedMachines is a slice of machine UUIDs which were created
      *
      * @generated from field: repeated string created_machines = 2;
      */
@@ -56,13 +56,13 @@ export type UpdateBMCInfoResponse = Message<"metalstack.infra.v2.UpdateBMCInfoRe
  */
 export declare const UpdateBMCInfoResponseSchema: GenMessage<UpdateBMCInfoResponse>;
 /**
- * WaitForBMCCommandRequest
+ * WaitForBMCCommandRequest is the request payload for waiting for a BMC command.
  *
  * @generated from message metalstack.infra.v2.WaitForBMCCommandRequest
  */
 export type WaitForBMCCommandRequest = Message<"metalstack.infra.v2.WaitForBMCCommandRequest"> & {
     /**
-     * Partition the partition id where metal-bmc wants to receive bmc commands
+     * Partition is the partition ID where metal-bmc wants to receive BMC commands
      *
      * @generated from field: string partition = 1;
      */
@@ -74,7 +74,7 @@ export type WaitForBMCCommandRequest = Message<"metalstack.infra.v2.WaitForBMCCo
  */
 export declare const WaitForBMCCommandRequestSchema: GenMessage<WaitForBMCCommandRequest>;
 /**
- * WaitForBMCCommandResponse
+ * WaitForBMCCommandResponse is the response payload for waiting for a BMC command.
  *
  * @generated from message metalstack.infra.v2.WaitForBMCCommandResponse
  */
@@ -86,20 +86,20 @@ export type WaitForBMCCommandResponse = Message<"metalstack.infra.v2.WaitForBMCC
      */
     uuid: string;
     /**
-     * BmcCommand to execute against the bmc of the machine
+     * BmcCommand to execute against the BMC of the machine
      *
      * @generated from field: metalstack.api.v2.MachineBMCCommand bmc_command = 2;
      */
     bmcCommand: MachineBMCCommand;
     /**
-     * MachineBmc contains connection details of the machine to issue the bmcCommand to
+     * MachineBmc contains connection details of the machine to issue the BMC command to
      *
      * @generated from field: metalstack.api.v2.MachineBMC machine_bmc = 3;
      */
     machineBmc?: MachineBMC;
     /**
      * CommandId is a unique ID which must be sent back after execution
-     * it is usually in the form: <machine-uuid>:machine-bmc-command:<command>
+     * It is usually in the form: <machine-uuid>:machine-bmc-command:<command>
      *
      * @generated from field: string command_id = 4;
      */
@@ -111,14 +111,14 @@ export type WaitForBMCCommandResponse = Message<"metalstack.infra.v2.WaitForBMCC
  */
 export declare const WaitForBMCCommandResponseSchema: GenMessage<WaitForBMCCommandResponse>;
 /**
- * BMCCommandDoneRequest must be returned after command execution
+ * BMCCommandDoneRequest must be returned after command execution.
  *
  * @generated from message metalstack.infra.v2.BMCCommandDoneRequest
  */
 export type BMCCommandDoneRequest = Message<"metalstack.infra.v2.BMCCommandDoneRequest"> & {
     /**
      * CommandId is a unique ID which must be sent back after execution
-     * it is usually in the form: <machine-uuid>:machine-bmc-command
+     * It is usually in the form: <machine-uuid>:machine-bmc-command
      *
      * @generated from field: string command_id = 1;
      */
@@ -136,7 +136,7 @@ export type BMCCommandDoneRequest = Message<"metalstack.infra.v2.BMCCommandDoneR
  */
 export declare const BMCCommandDoneRequestSchema: GenMessage<BMCCommandDoneRequest>;
 /**
- * BMCCommandDoneResponse
+ * BMCCommandDoneResponse is the response payload for BMC command completion.
  *
  * @generated from message metalstack.infra.v2.BMCCommandDoneResponse
  */
@@ -147,13 +147,13 @@ export type BMCCommandDoneResponse = Message<"metalstack.infra.v2.BMCCommandDone
  */
 export declare const BMCCommandDoneResponseSchema: GenMessage<BMCCommandDoneResponse>;
 /**
- * BMCService serves bmc related functions
+ * BMCService provides BMC management operations.
  *
  * @generated from service metalstack.infra.v2.BMCService
  */
 export declare const BMCService: GenService<{
     /**
-     * UpdateBMCInfo
+     * Updates BMC information.
      *
      * @generated from rpc metalstack.infra.v2.BMCService.UpdateBMCInfo
      */
@@ -163,7 +163,7 @@ export declare const BMCService: GenService<{
         output: typeof UpdateBMCInfoResponseSchema;
     };
     /**
-     * WaitForBMCCommand is called by the metal-bmc and is returned with a bmc command to execute.
+     * WaitForBMCCommand is called by the metal-bmc and returns a BMC command to execute.
      *
      * @generated from rpc metalstack.infra.v2.BMCService.WaitForBMCCommand
      */
@@ -173,7 +173,7 @@ export declare const BMCService: GenService<{
         output: typeof WaitForBMCCommandResponseSchema;
     };
     /**
-     * BMCCommandDone must be called from metal-bmc after the command execution
+     * BMCCommandDone must be called from metal-bmc after the command execution.
      *
      * @generated from rpc metalstack.infra.v2.BMCService.BMCCommandDone
      */
diff --git a/js/metalstack/infra/v2/bmc_pb.js b/js/metalstack/infra/v2/bmc_pb.js
index 04800070..34b4b40e 100644
--- a/js/metalstack/infra/v2/bmc_pb.js
+++ b/js/metalstack/infra/v2/bmc_pb.js
@@ -41,7 +41,7 @@ export const BMCCommandDoneRequestSchema = /*@__PURE__*/ messageDesc(file_metals
  */
 export const BMCCommandDoneResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_infra_v2_bmc, 5);
 /**
- * BMCService serves bmc related functions
+ * BMCService provides BMC management operations.
  *
  * @generated from service metalstack.infra.v2.BMCService
  */
diff --git a/js/metalstack/infra/v2/bmc_pb.ts b/js/metalstack/infra/v2/bmc_pb.ts
index 68d1bd21..19c89d16 100644
--- a/js/metalstack/infra/v2/bmc_pb.ts
+++ b/js/metalstack/infra/v2/bmc_pb.ts
@@ -18,20 +18,20 @@ export const file_metalstack_infra_v2_bmc: GenFile = /*@__PURE__*/
   fileDesc("Ch1tZXRhbHN0YWNrL2luZnJhL3YyL2JtYy5wcm90bxITbWV0YWxzdGFjay5pbmZyYS52MiLtAQoUVXBkYXRlQk1DSW5mb1JlcXVlc3QSHgoJcGFydGl0aW9uGAEgASgJQgu6SAhyBtCzrrECARJdCgtibWNfcmVwb3J0cxgCIAMoCzI5Lm1ldGFsc3RhY2suaW5mcmEudjIuVXBkYXRlQk1DSW5mb1JlcXVlc3QuQm1jUmVwb3J0c0VudHJ5Qg26SAqaAQciBXIDsAEBGlYKD0JtY1JlcG9ydHNFbnRyeRILCgNrZXkYASABKAkSMgoFdmFsdWUYAiABKAsyIy5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DUmVwb3J0OgI4ASJLChVVcGRhdGVCTUNJbmZvUmVzcG9uc2USGAoQdXBkYXRlZF9tYWNoaW5lcxgBIAMoCRIYChBjcmVhdGVkX21hY2hpbmVzGAIgAygJIjoKGFdhaXRGb3JCTUNDb21tYW5kUmVxdWVzdBIeCglwYXJ0aXRpb24YASABKAlCC7pICHIG0LOusQIBIrYBChlXYWl0Rm9yQk1DQ29tbWFuZFJlc3BvbnNlEhYKBHV1aWQYASABKAlCCLpIBXIDsAEBEjkKC2JtY19jb21tYW5kGAIgASgOMiQubWV0YWxzdGFjay5hcGkudjIuTWFjaGluZUJNQ0NvbW1hbmQSMgoLbWFjaGluZV9ibWMYAyABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5NYWNoaW5lQk1DEhIKCmNvbW1hbmRfaWQYBCABKAkiSQoVQk1DQ29tbWFuZERvbmVSZXF1ZXN0EhIKCmNvbW1hbmRfaWQYASABKAkSEgoFZXJyb3IYAiABKAlIAIgBAUIICgZfZXJyb3IiGAoWQk1DQ29tbWFuZERvbmVSZXNwb25zZTL2AgoKQk1DU2VydmljZRJxCg1VcGRhdGVCTUNJbmZvEikubWV0YWxzdGFjay5pbmZyYS52Mi5VcGRhdGVCTUNJbmZvUmVxdWVzdBoqLm1ldGFsc3RhY2suaW5mcmEudjIuVXBkYXRlQk1DSW5mb1Jlc3BvbnNlIgng8xgC6vMYAQESfwoRV2FpdEZvckJNQ0NvbW1hbmQSLS5tZXRhbHN0YWNrLmluZnJhLnYyLldhaXRGb3JCTUNDb21tYW5kUmVxdWVzdBouLm1ldGFsc3RhY2suaW5mcmEudjIuV2FpdEZvckJNQ0NvbW1hbmRSZXNwb25zZSIJ4PMYAurzGAEBMAESdAoOQk1DQ29tbWFuZERvbmUSKi5tZXRhbHN0YWNrLmluZnJhLnYyLkJNQ0NvbW1hbmREb25lUmVxdWVzdBorLm1ldGFsc3RhY2suaW5mcmEudjIuQk1DQ29tbWFuZERvbmVSZXNwb25zZSIJ4PMYAerzGAEBQswBChdjb20ubWV0YWxzdGFjay5pbmZyYS52MkIIQm1jUHJvdG9QAVo5Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9pbmZyYS92MjtpbmZyYXYyogIDTUlYqgITTWV0YWxzdGFjay5JbmZyYS5WMsoCE01ldGFsc3RhY2tcSW5mcmFcVjLiAh9NZXRhbHN0YWNrXEluZnJhXFYyXEdQQk1ldGFkYXRh6gIVTWV0YWxzdGFjazo6SW5mcmE6OlYyYgZwcm90bzM", [file_buf_validate_validate, file_metalstack_api_v2_common, file_metalstack_api_v2_machine, file_metalstack_api_v2_predefined_rules]);
 
 /**
- * UpdateBMCInfoRequest
+ * UpdateBMCInfoRequest is the request payload for updating BMC information.
  *
  * @generated from message metalstack.infra.v2.UpdateBMCInfoRequest
  */
 export type UpdateBMCInfoRequest = Message<"metalstack.infra.v2.UpdateBMCInfoRequest"> & {
   /**
-   * Partition the partition id where metal-bmc wants to receive events
+   * Partition is the partition ID where metal-bmc wants to receive events
    *
    * @generated from field: string partition = 1;
    */
   partition: string;
 
   /**
-   * BmcReports contains maps the bmc report per machine uuid
+   * BmcReports contains maps the BMC report per machine UUID
    *
    * @generated from field: map<string, metalstack.api.v2.MachineBMCReport> bmc_reports = 2;
    */
@@ -46,20 +46,20 @@ export const UpdateBMCInfoRequestSchema: GenMessage<UpdateBMCInfoRequest> = /*@_
   messageDesc(file_metalstack_infra_v2_bmc, 0);
 
 /**
- * UpdateBMCInfoResponse
+ * UpdateBMCInfoResponse is the response payload for updating BMC information.
  *
  * @generated from message metalstack.infra.v2.UpdateBMCInfoResponse
  */
 export type UpdateBMCInfoResponse = Message<"metalstack.infra.v2.UpdateBMCInfoResponse"> & {
   /**
-   * UpdatedMachines is a slice of machine uuids which were updated
+   * UpdatedMachines is a slice of machine UUIDs which were updated
    *
    * @generated from field: repeated string updated_machines = 1;
    */
   updatedMachines: string[];
 
   /**
-   * CreatedMachines is a slice of machine uuids which were created
+   * CreatedMachines is a slice of machine UUIDs which were created
    *
    * @generated from field: repeated string created_machines = 2;
    */
@@ -74,13 +74,13 @@ export const UpdateBMCInfoResponseSchema: GenMessage<UpdateBMCInfoResponse> = /*
   messageDesc(file_metalstack_infra_v2_bmc, 1);
 
 /**
- * WaitForBMCCommandRequest
+ * WaitForBMCCommandRequest is the request payload for waiting for a BMC command.
  *
  * @generated from message metalstack.infra.v2.WaitForBMCCommandRequest
  */
 export type WaitForBMCCommandRequest = Message<"metalstack.infra.v2.WaitForBMCCommandRequest"> & {
   /**
-   * Partition the partition id where metal-bmc wants to receive bmc commands
+   * Partition is the partition ID where metal-bmc wants to receive BMC commands
    *
    * @generated from field: string partition = 1;
    */
@@ -95,7 +95,7 @@ export const WaitForBMCCommandRequestSchema: GenMessage<WaitForBMCCommandRequest
   messageDesc(file_metalstack_infra_v2_bmc, 2);
 
 /**
- * WaitForBMCCommandResponse
+ * WaitForBMCCommandResponse is the response payload for waiting for a BMC command.
  *
  * @generated from message metalstack.infra.v2.WaitForBMCCommandResponse
  */
@@ -108,14 +108,14 @@ export type WaitForBMCCommandResponse = Message<"metalstack.infra.v2.WaitForBMCC
   uuid: string;
 
   /**
-   * BmcCommand to execute against the bmc of the machine
+   * BmcCommand to execute against the BMC of the machine
    *
    * @generated from field: metalstack.api.v2.MachineBMCCommand bmc_command = 2;
    */
   bmcCommand: MachineBMCCommand;
 
   /**
-   * MachineBmc contains connection details of the machine to issue the bmcCommand to
+   * MachineBmc contains connection details of the machine to issue the BMC command to
    *
    * @generated from field: metalstack.api.v2.MachineBMC machine_bmc = 3;
    */
@@ -123,7 +123,7 @@ export type WaitForBMCCommandResponse = Message<"metalstack.infra.v2.WaitForBMCC
 
   /**
    * CommandId is a unique ID which must be sent back after execution
-   * it is usually in the form: <machine-uuid>:machine-bmc-command:<command>
+   * It is usually in the form: <machine-uuid>:machine-bmc-command:<command>
    *
    * @generated from field: string command_id = 4;
    */
@@ -138,14 +138,14 @@ export const WaitForBMCCommandResponseSchema: GenMessage<WaitForBMCCommandRespon
   messageDesc(file_metalstack_infra_v2_bmc, 3);
 
 /**
- * BMCCommandDoneRequest must be returned after command execution
+ * BMCCommandDoneRequest must be returned after command execution.
  *
  * @generated from message metalstack.infra.v2.BMCCommandDoneRequest
  */
 export type BMCCommandDoneRequest = Message<"metalstack.infra.v2.BMCCommandDoneRequest"> & {
   /**
    * CommandId is a unique ID which must be sent back after execution
-   * it is usually in the form: <machine-uuid>:machine-bmc-command
+   * It is usually in the form: <machine-uuid>:machine-bmc-command
    *
    * @generated from field: string command_id = 1;
    */
@@ -167,7 +167,7 @@ export const BMCCommandDoneRequestSchema: GenMessage<BMCCommandDoneRequest> = /*
   messageDesc(file_metalstack_infra_v2_bmc, 4);
 
 /**
- * BMCCommandDoneResponse
+ * BMCCommandDoneResponse is the response payload for BMC command completion.
  *
  * @generated from message metalstack.infra.v2.BMCCommandDoneResponse
  */
@@ -182,13 +182,13 @@ export const BMCCommandDoneResponseSchema: GenMessage<BMCCommandDoneResponse> =
   messageDesc(file_metalstack_infra_v2_bmc, 5);
 
 /**
- * BMCService serves bmc related functions
+ * BMCService provides BMC management operations.
  *
  * @generated from service metalstack.infra.v2.BMCService
  */
 export const BMCService: GenService<{
   /**
-   * UpdateBMCInfo
+   * Updates BMC information.
    *
    * @generated from rpc metalstack.infra.v2.BMCService.UpdateBMCInfo
    */
@@ -198,7 +198,7 @@ export const BMCService: GenService<{
     output: typeof UpdateBMCInfoResponseSchema;
   },
   /**
-   * WaitForBMCCommand is called by the metal-bmc and is returned with a bmc command to execute.
+   * WaitForBMCCommand is called by the metal-bmc and returns a BMC command to execute.
    *
    * @generated from rpc metalstack.infra.v2.BMCService.WaitForBMCCommand
    */
@@ -208,7 +208,7 @@ export const BMCService: GenService<{
     output: typeof WaitForBMCCommandResponseSchema;
   },
   /**
-   * BMCCommandDone must be called from metal-bmc after the command execution
+   * BMCCommandDone must be called from metal-bmc after the command execution.
    *
    * @generated from rpc metalstack.infra.v2.BMCService.BMCCommandDone
    */
diff --git a/js/metalstack/infra/v2/boot_pb.d.ts b/js/metalstack/infra/v2/boot_pb.d.ts
index 3a6d9ee2..52d7bbdf 100644
--- a/js/metalstack/infra/v2/boot_pb.d.ts
+++ b/js/metalstack/infra/v2/boot_pb.d.ts
@@ -298,7 +298,7 @@ export type BootServiceSuperUserPasswordResponse = Message<"metalstack.infra.v2.
  */
 export declare const BootServiceSuperUserPasswordResponseSchema: GenMessage<BootServiceSuperUserPasswordResponse>;
 /**
- * BootService is used for all boot related requests, either pixiecore or metal-hammer
+ * BootService provides boot-related operations for pixiecore and metal-hammer.
  *
  * Pixiecore
  *
@@ -306,7 +306,7 @@ export declare const BootServiceSuperUserPasswordResponseSchema: GenMessage<Boot
  */
 export declare const BootService: GenService<{
     /**
-     * Dhcp is the first dhcp request (option 97). A ProvisioningEventPXEBooting is fired
+     * Dhcp handles the first DHCP request (option 97). A ProvisioningEventPXEBooting is fired.
      *
      * @generated from rpc metalstack.infra.v2.BootService.Dhcp
      */
@@ -316,7 +316,7 @@ export declare const BootService: GenService<{
         output: typeof BootServiceDhcpResponseSchema;
     };
     /**
-     * Boot is called from pixie once the machine got the first dhcp response and ipxie asks for subsequent kernel and initrd
+     * Boot is called from pixie once the machine got the first DHCP response and ipxe asks for subsequent kernel and initrd.
      *
      * @generated from rpc metalstack.infra.v2.BootService.Boot
      */
@@ -326,7 +326,7 @@ export declare const BootService: GenService<{
         output: typeof BootServiceBootResponseSchema;
     };
     /**
-     * SuperUserPassword metal-hammer takes the configured root password for the bmc from metal-apiserver and configure the bmc accordingly
+     * SuperUserPassword returns the configured root password for the BMC.
      *
      * @generated from rpc metalstack.infra.v2.BootService.SuperUserPassword
      */
@@ -336,7 +336,7 @@ export declare const BootService: GenService<{
         output: typeof BootServiceSuperUserPasswordResponseSchema;
     };
     /**
-     * Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all gory details about that machine
+     * Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all details about that machine.
      *
      * @generated from rpc metalstack.infra.v2.BootService.Register
      */
@@ -346,7 +346,7 @@ export declare const BootService: GenService<{
         output: typeof BootServiceRegisterResponseSchema;
     };
     /**
-     * Wait is a hanging call that waits until the machine gets allocated by a user
+     * Wait is a hanging call that waits until the machine gets allocated by a user.
      *
      * @generated from rpc metalstack.infra.v2.BootService.Wait
      */
@@ -356,7 +356,7 @@ export declare const BootService: GenService<{
         output: typeof BootServiceWaitResponseSchema;
     };
     /**
-     * InstallationSucceeded tells metal-apiserver installation was either successful
+     * InstallationSucceeded tells metal-apiserver that installation was successful.
      *
      * @generated from rpc metalstack.infra.v2.BootService.InstallationSucceeded
      */
diff --git a/js/metalstack/infra/v2/boot_pb.js b/js/metalstack/infra/v2/boot_pb.js
index 1092cf36..714ddd97 100644
--- a/js/metalstack/infra/v2/boot_pb.js
+++ b/js/metalstack/infra/v2/boot_pb.js
@@ -71,7 +71,7 @@ export const BootServiceSuperUserPasswordRequestSchema = /*@__PURE__*/ messageDe
  */
 export const BootServiceSuperUserPasswordResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_infra_v2_boot, 11);
 /**
- * BootService is used for all boot related requests, either pixiecore or metal-hammer
+ * BootService provides boot-related operations for pixiecore and metal-hammer.
  *
  * Pixiecore
  *
diff --git a/js/metalstack/infra/v2/boot_pb.ts b/js/metalstack/infra/v2/boot_pb.ts
index 8844a952..b3a67d55 100644
--- a/js/metalstack/infra/v2/boot_pb.ts
+++ b/js/metalstack/infra/v2/boot_pb.ts
@@ -363,7 +363,7 @@ export const BootServiceSuperUserPasswordResponseSchema: GenMessage<BootServiceS
   messageDesc(file_metalstack_infra_v2_boot, 11);
 
 /**
- * BootService is used for all boot related requests, either pixiecore or metal-hammer
+ * BootService provides boot-related operations for pixiecore and metal-hammer.
  *
  * Pixiecore
  *
@@ -371,7 +371,7 @@ export const BootServiceSuperUserPasswordResponseSchema: GenMessage<BootServiceS
  */
 export const BootService: GenService<{
   /**
-   * Dhcp is the first dhcp request (option 97). A ProvisioningEventPXEBooting is fired
+   * Dhcp handles the first DHCP request (option 97). A ProvisioningEventPXEBooting is fired.
    *
    * @generated from rpc metalstack.infra.v2.BootService.Dhcp
    */
@@ -381,7 +381,7 @@ export const BootService: GenService<{
     output: typeof BootServiceDhcpResponseSchema;
   },
   /**
-   * Boot is called from pixie once the machine got the first dhcp response and ipxie asks for subsequent kernel and initrd
+   * Boot is called from pixie once the machine got the first DHCP response and ipxe asks for subsequent kernel and initrd.
    *
    * @generated from rpc metalstack.infra.v2.BootService.Boot
    */
@@ -391,7 +391,7 @@ export const BootService: GenService<{
     output: typeof BootServiceBootResponseSchema;
   },
   /**
-   * SuperUserPassword metal-hammer takes the configured root password for the bmc from metal-apiserver and configure the bmc accordingly
+   * SuperUserPassword returns the configured root password for the BMC.
    *
    * @generated from rpc metalstack.infra.v2.BootService.SuperUserPassword
    */
@@ -401,7 +401,7 @@ export const BootService: GenService<{
     output: typeof BootServiceSuperUserPasswordResponseSchema;
   },
   /**
-   * Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all gory details about that machine
+   * Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all details about that machine.
    *
    * @generated from rpc metalstack.infra.v2.BootService.Register
    */
@@ -411,7 +411,7 @@ export const BootService: GenService<{
     output: typeof BootServiceRegisterResponseSchema;
   },
   /**
-   * Wait is a hanging call that waits until the machine gets allocated by a user
+   * Wait is a hanging call that waits until the machine gets allocated by a user.
    *
    * @generated from rpc metalstack.infra.v2.BootService.Wait
    */
@@ -421,7 +421,7 @@ export const BootService: GenService<{
     output: typeof BootServiceWaitResponseSchema;
   },
   /**
-   * InstallationSucceeded tells metal-apiserver installation was either successful
+   * InstallationSucceeded tells metal-apiserver that installation was successful.
    *
    * @generated from rpc metalstack.infra.v2.BootService.InstallationSucceeded
    */
diff --git a/js/metalstack/infra/v2/component_pb.d.ts b/js/metalstack/infra/v2/component_pb.d.ts
index 96961a58..634123ee 100644
--- a/js/metalstack/infra/v2/component_pb.d.ts
+++ b/js/metalstack/infra/v2/component_pb.d.ts
@@ -8,7 +8,7 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_infra_v2_component: GenFile;
 /**
- * ComponentServicePingRequest is sent from a microservice to report its state regularly
+ * ComponentServicePingRequest is the request payload for pinging a microservice.
  *
  * @generated from message metalstack.infra.v2.ComponentServicePingRequest
  */
@@ -20,21 +20,19 @@ export type ComponentServicePingRequest = Message<"metalstack.infra.v2.Component
      */
     type: ComponentType;
     /**
-     * Identifier is a unique identifier of this service, e.g. if two instance are running, this might be the pod id.
-     * micro_service and identifier guarantee uniqueness.
+     * Identifier is a unique identifier of this service, for example if two instances are running, this might be the pod ID
      *
      * @generated from field: string identifier = 2;
      */
     identifier: string;
     /**
-     * StartedAt is the timestamp this service was started.
+     * StartedAt is the timestamp this service was started
      *
      * @generated from field: google.protobuf.Timestamp started_at = 3;
      */
     startedAt?: Timestamp;
     /**
-     * Interval at which the ping is scheduled, must be between 5 seconds and 1 hour.
-     * Also gets validated in the same way in go/client/ping.go.
+     * Interval at which the ping is scheduled, must be between 5 seconds and 1 hour
      *
      * @generated from field: google.protobuf.Duration interval = 4;
      */
@@ -52,7 +50,7 @@ export type ComponentServicePingRequest = Message<"metalstack.infra.v2.Component
  */
 export declare const ComponentServicePingRequestSchema: GenMessage<ComponentServicePingRequest>;
 /**
- * ComponentServicePingResponse is the response to a ping request
+ * ComponentServicePingResponse is the response payload for pinging a microservice.
  *
  * @generated from message metalstack.infra.v2.ComponentServicePingResponse
  */
@@ -63,14 +61,13 @@ export type ComponentServicePingResponse = Message<"metalstack.infra.v2.Componen
  */
 export declare const ComponentServicePingResponseSchema: GenMessage<ComponentServicePingResponse>;
 /**
- * ComponentService serves component, e.g. microservices related functions.
+ * ComponentService provides microservice component management operations.
  *
  * @generated from service metalstack.infra.v2.ComponentService
  */
 export declare const ComponentService: GenService<{
     /**
-     * Ping must be called from every connected microservice in a recurring manner
-     * to get visibility of all registered microservices.
+     * Returns the ping response to register or report the microservice state.
      *
      * @generated from rpc metalstack.infra.v2.ComponentService.Ping
      */
diff --git a/js/metalstack/infra/v2/component_pb.js b/js/metalstack/infra/v2/component_pb.js
index 989e0348..f5a698a0 100644
--- a/js/metalstack/infra/v2/component_pb.js
+++ b/js/metalstack/infra/v2/component_pb.js
@@ -23,7 +23,7 @@ export const ComponentServicePingRequestSchema = /*@__PURE__*/ messageDesc(file_
  */
 export const ComponentServicePingResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_infra_v2_component, 1);
 /**
- * ComponentService serves component, e.g. microservices related functions.
+ * ComponentService provides microservice component management operations.
  *
  * @generated from service metalstack.infra.v2.ComponentService
  */
diff --git a/js/metalstack/infra/v2/component_pb.ts b/js/metalstack/infra/v2/component_pb.ts
index 520bef86..7aa270d5 100644
--- a/js/metalstack/infra/v2/component_pb.ts
+++ b/js/metalstack/infra/v2/component_pb.ts
@@ -22,7 +22,7 @@ export const file_metalstack_infra_v2_component: GenFile = /*@__PURE__*/
   fileDesc("CiNtZXRhbHN0YWNrL2luZnJhL3YyL2NvbXBvbmVudC5wcm90bxITbWV0YWxzdGFjay5pbmZyYS52MiKdAgobQ29tcG9uZW50U2VydmljZVBpbmdSZXF1ZXN0EjgKBHR5cGUYASABKA4yIC5tZXRhbHN0YWNrLmFwaS52Mi5Db21wb25lbnRUeXBlQgi6SAWCAQIQARIfCgppZGVudGlmaWVyGAIgASgJQgu6SAhyBsCzrrECARI4CgpzdGFydGVkX2F0GAMgASgLMhouZ29vZ2xlLnByb3RvYnVmLlRpbWVzdGFtcEIIukgFsgECOAESPAoIaW50ZXJ2YWwYBCABKAsyGS5nb29nbGUucHJvdG9idWYuRHVyYXRpb25CD7pIDKoBCSIDCJAcMgIIBRIrCgd2ZXJzaW9uGAUgASgLMhoubWV0YWxzdGFjay5hcGkudjIuVmVyc2lvbiIeChxDb21wb25lbnRTZXJ2aWNlUGluZ1Jlc3BvbnNlMooBChBDb21wb25lbnRTZXJ2aWNlEnYKBFBpbmcSMC5tZXRhbHN0YWNrLmluZnJhLnYyLkNvbXBvbmVudFNlcnZpY2VQaW5nUmVxdWVzdBoxLm1ldGFsc3RhY2suaW5mcmEudjIuQ29tcG9uZW50U2VydmljZVBpbmdSZXNwb25zZSIJ4PMYAurzGAEBQtIBChdjb20ubWV0YWxzdGFjay5pbmZyYS52MkIOQ29tcG9uZW50UHJvdG9QAVo5Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9pbmZyYS92MjtpbmZyYXYyogIDTUlYqgITTWV0YWxzdGFjay5JbmZyYS5WMsoCE01ldGFsc3RhY2tcSW5mcmFcVjLiAh9NZXRhbHN0YWNrXEluZnJhXFYyXEdQQk1ldGFkYXRh6gIVTWV0YWxzdGFjazo6SW5mcmE6OlYyYgZwcm90bzM", [file_buf_validate_validate, file_google_protobuf_duration, file_google_protobuf_timestamp, file_metalstack_api_v2_common, file_metalstack_api_v2_component, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_version]);
 
 /**
- * ComponentServicePingRequest is sent from a microservice to report its state regularly
+ * ComponentServicePingRequest is the request payload for pinging a microservice.
  *
  * @generated from message metalstack.infra.v2.ComponentServicePingRequest
  */
@@ -35,23 +35,21 @@ export type ComponentServicePingRequest = Message<"metalstack.infra.v2.Component
   type: ComponentType;
 
   /**
-   * Identifier is a unique identifier of this service, e.g. if two instance are running, this might be the pod id.
-   * micro_service and identifier guarantee uniqueness.
+   * Identifier is a unique identifier of this service, for example if two instances are running, this might be the pod ID
    *
    * @generated from field: string identifier = 2;
    */
   identifier: string;
 
   /**
-   * StartedAt is the timestamp this service was started.
+   * StartedAt is the timestamp this service was started
    *
    * @generated from field: google.protobuf.Timestamp started_at = 3;
    */
   startedAt?: Timestamp;
 
   /**
-   * Interval at which the ping is scheduled, must be between 5 seconds and 1 hour.
-   * Also gets validated in the same way in go/client/ping.go.
+   * Interval at which the ping is scheduled, must be between 5 seconds and 1 hour
    *
    * @generated from field: google.protobuf.Duration interval = 4;
    */
@@ -73,7 +71,7 @@ export const ComponentServicePingRequestSchema: GenMessage<ComponentServicePingR
   messageDesc(file_metalstack_infra_v2_component, 0);
 
 /**
- * ComponentServicePingResponse is the response to a ping request
+ * ComponentServicePingResponse is the response payload for pinging a microservice.
  *
  * @generated from message metalstack.infra.v2.ComponentServicePingResponse
  */
@@ -88,14 +86,13 @@ export const ComponentServicePingResponseSchema: GenMessage<ComponentServicePing
   messageDesc(file_metalstack_infra_v2_component, 1);
 
 /**
- * ComponentService serves component, e.g. microservices related functions.
+ * ComponentService provides microservice component management operations.
  *
  * @generated from service metalstack.infra.v2.ComponentService
  */
 export const ComponentService: GenService<{
   /**
-   * Ping must be called from every connected microservice in a recurring manner
-   * to get visibility of all registered microservices.
+   * Returns the ping response to register or report the microservice state.
    *
    * @generated from rpc metalstack.infra.v2.ComponentService.Ping
    */
diff --git a/js/metalstack/infra/v2/event_pb.d.ts b/js/metalstack/infra/v2/event_pb.d.ts
index 257e55c7..bfc2377b 100644
--- a/js/metalstack/infra/v2/event_pb.d.ts
+++ b/js/metalstack/infra/v2/event_pb.d.ts
@@ -6,13 +6,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_infra_v2_event: GenFile;
 /**
- * EventServiceSendRequest.
+ * EventServiceSendRequest is the request payload for sending provisioning events.
  *
  * @generated from message metalstack.infra.v2.EventServiceSendRequest
  */
 export type EventServiceSendRequest = Message<"metalstack.infra.v2.EventServiceSendRequest"> & {
     /**
-     * Events grouped by machine IDs.
+     * Events grouped by machine IDs
      *
      * @generated from field: map<string, metalstack.infra.v2.MachineProvisioningEvent> events = 1;
      */
@@ -26,19 +26,19 @@ export type EventServiceSendRequest = Message<"metalstack.infra.v2.EventServiceS
  */
 export declare const EventServiceSendRequestSchema: GenMessage<EventServiceSendRequest>;
 /**
- * EventServiceSendResponse.
+ * EventServiceSendResponse is the response payload for sending provisioning events.
  *
  * @generated from message metalstack.infra.v2.EventServiceSendResponse
  */
 export type EventServiceSendResponse = Message<"metalstack.infra.v2.EventServiceSendResponse"> & {
     /**
-     * Events counts the number of events successfully stored in the database.
+     * Events counts the number of events successfully stored in the database
      *
      * @generated from field: uint64 events = 1;
      */
     events: bigint;
     /**
-     * Failed contains IDs of all machines whose events could not be stored in the database.
+     * Failed contains IDs of all machines whose events could not be stored in the database
      *
      * @generated from field: repeated string failed = 2;
      */
@@ -56,19 +56,19 @@ export declare const EventServiceSendResponseSchema: GenMessage<EventServiceSend
  */
 export type MachineProvisioningEvent = Message<"metalstack.infra.v2.MachineProvisioningEvent"> & {
     /**
-     * Time the event occurred at.
+     * Time the event occurred at
      *
      * @generated from field: google.protobuf.Timestamp time = 1;
      */
     time?: Timestamp;
     /**
-     * Event that occurred.
+     * Event that occurred
      *
      * @generated from field: metalstack.infra.v2.ProvisioningEventType event = 2;
      */
     event: ProvisioningEventType;
     /**
-     * Message describing the event in more detail.
+     * Message describes the event in more detail
      *
      * @generated from field: string message = 3;
      */
@@ -86,73 +86,73 @@ export declare const MachineProvisioningEventSchema: GenMessage<MachineProvision
  */
 export declare enum ProvisioningEventType {
     /**
-     * PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified.
+     * PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_UNSPECIFIED = 0;
      */
     UNSPECIFIED = 0,
     /**
-     * PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago.
+     * PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_ALIVE = 1;
      */
     ALIVE = 1,
     /**
-     * PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle.
+     * PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_CRASHED = 2;
      */
     CRASHED = 2,
     /**
-     * PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE.
+     * PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PXE_BOOTING = 3;
      */
     PXE_BOOTING = 3,
     /**
-     * PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot.
+     * PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PLANNED_REBOOT = 4;
      */
     PLANNED_REBOOT = 4,
     /**
-     * PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started.
+     * PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PREPARING = 5;
      */
     PREPARING = 5,
     /**
-     * PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API.
+     * PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_REGISTERING = 6;
      */
     REGISTERING = 6,
     /**
-     * PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation.
+     * PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_WAITING = 7;
      */
     WAITING = 7,
     /**
-     * PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed.
+     * PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_INSTALLING = 8;
      */
     INSTALLING = 8,
     /**
-     * PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS.
+     * PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL = 9;
      */
     BOOTING_NEW_KERNEL = 9,
     /**
-     * PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness.
+     * PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PHONED_HOME = 10;
      */
     PHONED_HOME = 10,
     /**
-     * PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines.
+     * PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM = 11;
      */
@@ -163,13 +163,13 @@ export declare enum ProvisioningEventType {
  */
 export declare const ProvisioningEventTypeSchema: GenEnum<ProvisioningEventType>;
 /**
- * EventService serves event related functions.
+ * EventService provides machine provisioning event logging operations.
  *
  * @generated from service metalstack.infra.v2.EventService
  */
 export declare const EventService: GenService<{
     /**
-     * Send a series of machine provisioning events.
+     * Sends a series of machine provisioning events.
      *
      * @generated from rpc metalstack.infra.v2.EventService.Send
      */
diff --git a/js/metalstack/infra/v2/event_pb.js b/js/metalstack/infra/v2/event_pb.js
index c2e66cb8..5b933021 100644
--- a/js/metalstack/infra/v2/event_pb.js
+++ b/js/metalstack/infra/v2/event_pb.js
@@ -32,73 +32,73 @@ export const MachineProvisioningEventSchema = /*@__PURE__*/ messageDesc(file_met
 export var ProvisioningEventType;
 (function (ProvisioningEventType) {
     /**
-     * PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified.
+     * PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_UNSPECIFIED = 0;
      */
     ProvisioningEventType[ProvisioningEventType["UNSPECIFIED"] = 0] = "UNSPECIFIED";
     /**
-     * PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago.
+     * PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_ALIVE = 1;
      */
     ProvisioningEventType[ProvisioningEventType["ALIVE"] = 1] = "ALIVE";
     /**
-     * PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle.
+     * PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_CRASHED = 2;
      */
     ProvisioningEventType[ProvisioningEventType["CRASHED"] = 2] = "CRASHED";
     /**
-     * PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE.
+     * PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PXE_BOOTING = 3;
      */
     ProvisioningEventType[ProvisioningEventType["PXE_BOOTING"] = 3] = "PXE_BOOTING";
     /**
-     * PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot.
+     * PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PLANNED_REBOOT = 4;
      */
     ProvisioningEventType[ProvisioningEventType["PLANNED_REBOOT"] = 4] = "PLANNED_REBOOT";
     /**
-     * PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started.
+     * PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PREPARING = 5;
      */
     ProvisioningEventType[ProvisioningEventType["PREPARING"] = 5] = "PREPARING";
     /**
-     * PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API.
+     * PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_REGISTERING = 6;
      */
     ProvisioningEventType[ProvisioningEventType["REGISTERING"] = 6] = "REGISTERING";
     /**
-     * PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation.
+     * PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_WAITING = 7;
      */
     ProvisioningEventType[ProvisioningEventType["WAITING"] = 7] = "WAITING";
     /**
-     * PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed.
+     * PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_INSTALLING = 8;
      */
     ProvisioningEventType[ProvisioningEventType["INSTALLING"] = 8] = "INSTALLING";
     /**
-     * PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS.
+     * PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL = 9;
      */
     ProvisioningEventType[ProvisioningEventType["BOOTING_NEW_KERNEL"] = 9] = "BOOTING_NEW_KERNEL";
     /**
-     * PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness.
+     * PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_PHONED_HOME = 10;
      */
     ProvisioningEventType[ProvisioningEventType["PHONED_HOME"] = 10] = "PHONED_HOME";
     /**
-     * PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines.
+     * PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines
      *
      * @generated from enum value: PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM = 11;
      */
@@ -109,7 +109,7 @@ export var ProvisioningEventType;
  */
 export const ProvisioningEventTypeSchema = /*@__PURE__*/ enumDesc(file_metalstack_infra_v2_event, 0);
 /**
- * EventService serves event related functions.
+ * EventService provides machine provisioning event logging operations.
  *
  * @generated from service metalstack.infra.v2.EventService
  */
diff --git a/js/metalstack/infra/v2/event_pb.ts b/js/metalstack/infra/v2/event_pb.ts
index 97e5fac4..3d278ccc 100644
--- a/js/metalstack/infra/v2/event_pb.ts
+++ b/js/metalstack/infra/v2/event_pb.ts
@@ -17,13 +17,13 @@ export const file_metalstack_infra_v2_event: GenFile = /*@__PURE__*/
   fileDesc("Ch9tZXRhbHN0YWNrL2luZnJhL3YyL2V2ZW50LnByb3RvEhNtZXRhbHN0YWNrLmluZnJhLnYyIsEBChdFdmVudFNlcnZpY2VTZW5kUmVxdWVzdBJICgZldmVudHMYASADKAsyOC5tZXRhbHN0YWNrLmluZnJhLnYyLkV2ZW50U2VydmljZVNlbmRSZXF1ZXN0LkV2ZW50c0VudHJ5GlwKC0V2ZW50c0VudHJ5EgsKA2tleRgBIAEoCRI8CgV2YWx1ZRgCIAEoCzItLm1ldGFsc3RhY2suaW5mcmEudjIuTWFjaGluZVByb3Zpc2lvbmluZ0V2ZW50OgI4ASI6ChhFdmVudFNlcnZpY2VTZW5kUmVzcG9uc2USDgoGZXZlbnRzGAEgASgEEg4KBmZhaWxlZBgCIAMoCSKaAQoYTWFjaGluZVByb3Zpc2lvbmluZ0V2ZW50EigKBHRpbWUYASABKAsyGi5nb29nbGUucHJvdG9idWYuVGltZXN0YW1wEkMKBWV2ZW50GAIgASgOMioubWV0YWxzdGFjay5pbmZyYS52Mi5Qcm92aXNpb25pbmdFdmVudFR5cGVCCLpIBYIBAhABEg8KB21lc3NhZ2UYAyABKAkquAUKFVByb3Zpc2lvbmluZ0V2ZW50VHlwZRInCiNQUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9VTlNQRUNJRklFRBAAEiwKHVBST1ZJU0lPTklOR19FVkVOVF9UWVBFX0FMSVZFEAEaCYKyGQVBbGl2ZRIwCh9QUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9DUkFTSEVEEAIaC4KyGQdDcmFzaGVkEjgKI1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1BYRV9CT09USU5HEAMaD4KyGQtQWEUgQm9vdGluZxI+CiZQUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9QTEFOTkVEX1JFQk9PVBAEGhKCshkOUGxhbm5lZCBSZWJvb3QSNAohUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfUFJFUEFSSU5HEAUaDYKyGQlQcmVwYXJpbmcSOAojUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfUkVHSVNURVJJTkcQBhoPgrIZC1JlZ2lzdGVyaW5nEjAKH1BST1ZJU0lPTklOR19FVkVOVF9UWVBFX1dBSVRJTkcQBxoLgrIZB1dhaXRpbmcSNgoiUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfSU5TVEFMTElORxAIGg6CshkKSW5zdGFsbGluZxJGCipQUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9CT09USU5HX05FV19LRVJORUwQCRoWgrIZEkJvb3RpbmcgTmV3IEtlcm5lbBI4CiNQUk9WSVNJT05JTkdfRVZFTlRfVFlQRV9QSE9ORURfSE9NRRAKGg+CshkLUGhvbmVkIEhvbWUSQAonUFJPVklTSU9OSU5HX0VWRU5UX1RZUEVfTUFDSElORV9SRUNMQUlNEAsaE4KyGQ9NYWNoaW5lIFJlY2xhaW0yfgoMRXZlbnRTZXJ2aWNlEm4KBFNlbmQSLC5tZXRhbHN0YWNrLmluZnJhLnYyLkV2ZW50U2VydmljZVNlbmRSZXF1ZXN0Gi0ubWV0YWxzdGFjay5pbmZyYS52Mi5FdmVudFNlcnZpY2VTZW5kUmVzcG9uc2UiCeDzGALq8xgBAULOAQoXY29tLm1ldGFsc3RhY2suaW5mcmEudjJCCkV2ZW50UHJvdG9QAVo5Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9pbmZyYS92MjtpbmZyYXYyogIDTUlYqgITTWV0YWxzdGFjay5JbmZyYS5WMsoCE01ldGFsc3RhY2tcSW5mcmFcVjLiAh9NZXRhbHN0YWNrXEluZnJhXFYyXEdQQk1ldGFkYXRh6gIVTWV0YWxzdGFjazo6SW5mcmE6OlYyYgZwcm90bzM", [file_buf_validate_validate, file_google_protobuf_timestamp, file_metalstack_api_v2_common]);
 
 /**
- * EventServiceSendRequest.
+ * EventServiceSendRequest is the request payload for sending provisioning events.
  *
  * @generated from message metalstack.infra.v2.EventServiceSendRequest
  */
 export type EventServiceSendRequest = Message<"metalstack.infra.v2.EventServiceSendRequest"> & {
   /**
-   * Events grouped by machine IDs.
+   * Events grouped by machine IDs
    *
    * @generated from field: map<string, metalstack.infra.v2.MachineProvisioningEvent> events = 1;
    */
@@ -38,20 +38,20 @@ export const EventServiceSendRequestSchema: GenMessage<EventServiceSendRequest>
   messageDesc(file_metalstack_infra_v2_event, 0);
 
 /**
- * EventServiceSendResponse.
+ * EventServiceSendResponse is the response payload for sending provisioning events.
  *
  * @generated from message metalstack.infra.v2.EventServiceSendResponse
  */
 export type EventServiceSendResponse = Message<"metalstack.infra.v2.EventServiceSendResponse"> & {
   /**
-   * Events counts the number of events successfully stored in the database.
+   * Events counts the number of events successfully stored in the database
    *
    * @generated from field: uint64 events = 1;
    */
   events: bigint;
 
   /**
-   * Failed contains IDs of all machines whose events could not be stored in the database.
+   * Failed contains IDs of all machines whose events could not be stored in the database
    *
    * @generated from field: repeated string failed = 2;
    */
@@ -72,21 +72,21 @@ export const EventServiceSendResponseSchema: GenMessage<EventServiceSendResponse
  */
 export type MachineProvisioningEvent = Message<"metalstack.infra.v2.MachineProvisioningEvent"> & {
   /**
-   * Time the event occurred at.
+   * Time the event occurred at
    *
    * @generated from field: google.protobuf.Timestamp time = 1;
    */
   time?: Timestamp;
 
   /**
-   * Event that occurred.
+   * Event that occurred
    *
    * @generated from field: metalstack.infra.v2.ProvisioningEventType event = 2;
    */
   event: ProvisioningEventType;
 
   /**
-   * Message describing the event in more detail.
+   * Message describes the event in more detail
    *
    * @generated from field: string message = 3;
    */
@@ -107,84 +107,84 @@ export const MachineProvisioningEventSchema: GenMessage<MachineProvisioningEvent
  */
 export enum ProvisioningEventType {
   /**
-   * PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified.
+   * PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_UNSPECIFIED = 0;
    */
   UNSPECIFIED = 0,
 
   /**
-   * PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago.
+   * PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_ALIVE = 1;
    */
   ALIVE = 1,
 
   /**
-   * PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle.
+   * PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_CRASHED = 2;
    */
   CRASHED = 2,
 
   /**
-   * PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE.
+   * PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_PXE_BOOTING = 3;
    */
   PXE_BOOTING = 3,
 
   /**
-   * PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot.
+   * PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_PLANNED_REBOOT = 4;
    */
   PLANNED_REBOOT = 4,
 
   /**
-   * PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started.
+   * PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_PREPARING = 5;
    */
   PREPARING = 5,
 
   /**
-   * PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API.
+   * PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_REGISTERING = 6;
    */
   REGISTERING = 6,
 
   /**
-   * PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation.
+   * PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_WAITING = 7;
    */
   WAITING = 7,
 
   /**
-   * PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed.
+   * PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_INSTALLING = 8;
    */
   INSTALLING = 8,
 
   /**
-   * PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS.
+   * PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL = 9;
    */
   BOOTING_NEW_KERNEL = 9,
 
   /**
-   * PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness.
+   * PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_PHONED_HOME = 10;
    */
   PHONED_HOME = 10,
 
   /**
-   * PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines.
+   * PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines
    *
    * @generated from enum value: PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM = 11;
    */
@@ -198,13 +198,13 @@ export const ProvisioningEventTypeSchema: GenEnum<ProvisioningEventType> = /*@__
   enumDesc(file_metalstack_infra_v2_event, 0);
 
 /**
- * EventService serves event related functions.
+ * EventService provides machine provisioning event logging operations.
  *
  * @generated from service metalstack.infra.v2.EventService
  */
 export const EventService: GenService<{
   /**
-   * Send a series of machine provisioning events.
+   * Sends a series of machine provisioning events.
    *
    * @generated from rpc metalstack.infra.v2.EventService.Send
    */
diff --git a/js/metalstack/infra/v2/switch_pb.d.ts b/js/metalstack/infra/v2/switch_pb.d.ts
index 98bdf6cd..5acb2daf 100644
--- a/js/metalstack/infra/v2/switch_pb.d.ts
+++ b/js/metalstack/infra/v2/switch_pb.d.ts
@@ -7,13 +7,13 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_metalstack_infra_v2_switch: GenFile;
 /**
- * SwitchServiceGetRequest.
+ * SwitchServiceGetRequest is the request payload for getting a switch.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceGetRequest
  */
 export type SwitchServiceGetRequest = Message<"metalstack.infra.v2.SwitchServiceGetRequest"> & {
     /**
-     * Id of the switch.
+     * Id of the switch
      *
      * @generated from field: string id = 1;
      */
@@ -25,13 +25,13 @@ export type SwitchServiceGetRequest = Message<"metalstack.infra.v2.SwitchService
  */
 export declare const SwitchServiceGetRequestSchema: GenMessage<SwitchServiceGetRequest>;
 /**
- * SwitchServiceGetResponse.
+ * SwitchServiceGetResponse is the response payload for getting a switch.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceGetResponse
  */
 export type SwitchServiceGetResponse = Message<"metalstack.infra.v2.SwitchServiceGetResponse"> & {
     /**
-     * Switch that was requested.
+     * Switch contains the requested switch
      *
      * @generated from field: metalstack.api.v2.Switch switch = 1;
      */
@@ -43,13 +43,13 @@ export type SwitchServiceGetResponse = Message<"metalstack.infra.v2.SwitchServic
  */
 export declare const SwitchServiceGetResponseSchema: GenMessage<SwitchServiceGetResponse>;
 /**
- * SwitchServiceRegisterRequest.
+ * SwitchServiceRegisterRequest is the request payload for registering a switch.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceRegisterRequest
  */
 export type SwitchServiceRegisterRequest = Message<"metalstack.infra.v2.SwitchServiceRegisterRequest"> & {
     /**
-     * Switch to register.
+     * Switch to register
      *
      * @generated from field: metalstack.api.v2.Switch switch = 1;
      */
@@ -61,13 +61,13 @@ export type SwitchServiceRegisterRequest = Message<"metalstack.infra.v2.SwitchSe
  */
 export declare const SwitchServiceRegisterRequestSchema: GenMessage<SwitchServiceRegisterRequest>;
 /**
- * SwitchServiceRegisterResponse.
+ * SwitchServiceRegisterResponse is the response payload for registering a switch.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceRegisterResponse
  */
 export type SwitchServiceRegisterResponse = Message<"metalstack.infra.v2.SwitchServiceRegisterResponse"> & {
     /**
-     * Switch that was registered.
+     * Switch contains the registered switch
      *
      * @generated from field: metalstack.api.v2.Switch switch = 1;
      */
@@ -79,31 +79,31 @@ export type SwitchServiceRegisterResponse = Message<"metalstack.infra.v2.SwitchS
  */
 export declare const SwitchServiceRegisterResponseSchema: GenMessage<SwitchServiceRegisterResponse>;
 /**
- * SwitchServiceHeartbeatRequest.
+ * SwitchServiceHeartbeatRequest is the request payload for sending a switch heartbeat.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceHeartbeatRequest
  */
 export type SwitchServiceHeartbeatRequest = Message<"metalstack.infra.v2.SwitchServiceHeartbeatRequest"> & {
     /**
-     * Id of the switch.
+     * Id of the switch
      *
      * @generated from field: string id = 1;
      */
     id: string;
     /**
-     * Duration of the sync.
+     * Duration of the sync
      *
      * @generated from field: google.protobuf.Duration duration = 2;
      */
     duration?: Duration;
     /**
-     * Error if any occurred during the sync.
+     * Error if any occurred during the sync
      *
      * @generated from field: optional string error = 3;
      */
     error?: string;
     /**
-     * PortStates maps port identifiers to the respective port's operational state.
+     * PortStates maps port identifiers to the respective port's operational state
      *
      * @generated from field: map<string, metalstack.api.v2.SwitchPortStatus> port_states = 4;
      */
@@ -111,7 +111,7 @@ export type SwitchServiceHeartbeatRequest = Message<"metalstack.infra.v2.SwitchS
         [key: string]: SwitchPortStatus;
     };
     /**
-     * BgpPortStates maps port identifiers to the respective port's BGP state.
+     * BgpPortStates maps port identifiers to the respective port's BGP state
      *
      * @generated from field: map<string, metalstack.api.v2.SwitchBGPPortState> bgp_port_states = 5;
      */
@@ -125,25 +125,25 @@ export type SwitchServiceHeartbeatRequest = Message<"metalstack.infra.v2.SwitchS
  */
 export declare const SwitchServiceHeartbeatRequestSchema: GenMessage<SwitchServiceHeartbeatRequest>;
 /**
- * SwitchServiceHeartbeatResponse.
+ * SwitchServiceHeartbeatResponse is the response payload for sending a switch heartbeat.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceHeartbeatResponse
  */
 export type SwitchServiceHeartbeatResponse = Message<"metalstack.infra.v2.SwitchServiceHeartbeatResponse"> & {
     /**
-     * Id of the switch.
+     * Id of the switch
      *
      * @generated from field: string id = 1;
      */
     id: string;
     /**
-     * LastSync holds information about the last sync.
+     * LastSync holds information about the last sync
      *
      * @generated from field: metalstack.api.v2.SwitchSync last_sync = 2;
      */
     lastSync?: SwitchSync;
     /**
-     * LastSyncError holds information about the last erroneous sync.
+     * LastSyncError holds information about the last erroneous sync
      *
      * @generated from field: metalstack.api.v2.SwitchSync last_sync_error = 3;
      */
@@ -155,13 +155,13 @@ export type SwitchServiceHeartbeatResponse = Message<"metalstack.infra.v2.Switch
  */
 export declare const SwitchServiceHeartbeatResponseSchema: GenMessage<SwitchServiceHeartbeatResponse>;
 /**
- * SwitchService serves switch related functions.
+ * SwitchService provides infrastructure switch management operations.
  *
  * @generated from service metalstack.infra.v2.SwitchService
  */
 export declare const SwitchService: GenService<{
     /**
-     * Get a switch by ID.
+     * Returns the switch with the specified ID.
      *
      * @generated from rpc metalstack.infra.v2.SwitchService.Get
      */
@@ -171,7 +171,7 @@ export declare const SwitchService: GenService<{
         output: typeof SwitchServiceGetResponseSchema;
     };
     /**
-     * Register a switch.
+     * Registers a switch.
      *
      * @generated from rpc metalstack.infra.v2.SwitchService.Register
      */
@@ -181,7 +181,7 @@ export declare const SwitchService: GenService<{
         output: typeof SwitchServiceRegisterResponseSchema;
     };
     /**
-     * Heartbeat a switch.
+     * Heartbeat sends a heartbeat from a switch.
      *
      * @generated from rpc metalstack.infra.v2.SwitchService.Heartbeat
      */
diff --git a/js/metalstack/infra/v2/switch_pb.js b/js/metalstack/infra/v2/switch_pb.js
index 8e4e60cc..4dca97b7 100644
--- a/js/metalstack/infra/v2/switch_pb.js
+++ b/js/metalstack/infra/v2/switch_pb.js
@@ -42,7 +42,7 @@ export const SwitchServiceHeartbeatRequestSchema = /*@__PURE__*/ messageDesc(fil
  */
 export const SwitchServiceHeartbeatResponseSchema = /*@__PURE__*/ messageDesc(file_metalstack_infra_v2_switch, 5);
 /**
- * SwitchService serves switch related functions.
+ * SwitchService provides infrastructure switch management operations.
  *
  * @generated from service metalstack.infra.v2.SwitchService
  */
diff --git a/js/metalstack/infra/v2/switch_pb.ts b/js/metalstack/infra/v2/switch_pb.ts
index 37700198..310b06bf 100644
--- a/js/metalstack/infra/v2/switch_pb.ts
+++ b/js/metalstack/infra/v2/switch_pb.ts
@@ -20,13 +20,13 @@ export const file_metalstack_infra_v2_switch: GenFile = /*@__PURE__*/
   fileDesc("CiBtZXRhbHN0YWNrL2luZnJhL3YyL3N3aXRjaC5wcm90bxITbWV0YWxzdGFjay5pbmZyYS52MiI0ChdTd2l0Y2hTZXJ2aWNlR2V0UmVxdWVzdBIZCgJpZBgBIAEoCUINukgKcgjAs66xAgFoASJFChhTd2l0Y2hTZXJ2aWNlR2V0UmVzcG9uc2USKQoGc3dpdGNoGAEgASgLMhkubWV0YWxzdGFjay5hcGkudjIuU3dpdGNoIkkKHFN3aXRjaFNlcnZpY2VSZWdpc3RlclJlcXVlc3QSKQoGc3dpdGNoGAEgASgLMhkubWV0YWxzdGFjay5hcGkudjIuU3dpdGNoIkoKHVN3aXRjaFNlcnZpY2VSZWdpc3RlclJlc3BvbnNlEikKBnN3aXRjaBgBIAEoCzIZLm1ldGFsc3RhY2suYXBpLnYyLlN3aXRjaCLzAwodU3dpdGNoU2VydmljZUhlYXJ0YmVhdFJlcXVlc3QSGQoCaWQYASABKAlCDbpICnIIwLOusQIBaAESKwoIZHVyYXRpb24YAiABKAsyGS5nb29nbGUucHJvdG9idWYuRHVyYXRpb24SEgoFZXJyb3IYAyABKAlIAIgBARJXCgtwb3J0X3N0YXRlcxgEIAMoCzJCLm1ldGFsc3RhY2suaW5mcmEudjIuU3dpdGNoU2VydmljZUhlYXJ0YmVhdFJlcXVlc3QuUG9ydFN0YXRlc0VudHJ5El4KD2JncF9wb3J0X3N0YXRlcxgFIAMoCzJFLm1ldGFsc3RhY2suaW5mcmEudjIuU3dpdGNoU2VydmljZUhlYXJ0YmVhdFJlcXVlc3QuQmdwUG9ydFN0YXRlc0VudHJ5GlYKD1BvcnRTdGF0ZXNFbnRyeRILCgNrZXkYASABKAkSMgoFdmFsdWUYAiABKA4yIy5tZXRhbHN0YWNrLmFwaS52Mi5Td2l0Y2hQb3J0U3RhdHVzOgI4ARpbChJCZ3BQb3J0U3RhdGVzRW50cnkSCwoDa2V5GAEgASgJEjQKBXZhbHVlGAIgASgLMiUubWV0YWxzdGFjay5hcGkudjIuU3dpdGNoQkdQUG9ydFN0YXRlOgI4AUIICgZfZXJyb3IilgEKHlN3aXRjaFNlcnZpY2VIZWFydGJlYXRSZXNwb25zZRIKCgJpZBgBIAEoCRIwCglsYXN0X3N5bmMYAiABKAsyHS5tZXRhbHN0YWNrLmFwaS52Mi5Td2l0Y2hTeW5jEjYKD2xhc3Rfc3luY19lcnJvchgDIAEoCzIdLm1ldGFsc3RhY2suYXBpLnYyLlN3aXRjaFN5bmMy/gIKDVN3aXRjaFNlcnZpY2USbgoDR2V0EiwubWV0YWxzdGFjay5pbmZyYS52Mi5Td2l0Y2hTZXJ2aWNlR2V0UmVxdWVzdBotLm1ldGFsc3RhY2suaW5mcmEudjIuU3dpdGNoU2VydmljZUdldFJlc3BvbnNlIgrg8xgC6vMYAgECEnwKCFJlZ2lzdGVyEjEubWV0YWxzdGFjay5pbmZyYS52Mi5Td2l0Y2hTZXJ2aWNlUmVnaXN0ZXJSZXF1ZXN0GjIubWV0YWxzdGFjay5pbmZyYS52Mi5Td2l0Y2hTZXJ2aWNlUmVnaXN0ZXJSZXNwb25zZSIJ4PMYAurzGAEBEn8KCUhlYXJ0YmVhdBIyLm1ldGFsc3RhY2suaW5mcmEudjIuU3dpdGNoU2VydmljZUhlYXJ0YmVhdFJlcXVlc3QaMy5tZXRhbHN0YWNrLmluZnJhLnYyLlN3aXRjaFNlcnZpY2VIZWFydGJlYXRSZXNwb25zZSIJ4PMYAurzGAEBQs8BChdjb20ubWV0YWxzdGFjay5pbmZyYS52MkILU3dpdGNoUHJvdG9QAVo5Z2l0aHViLmNvbS9tZXRhbC1zdGFjay9hcGkvZ28vbWV0YWxzdGFjay9pbmZyYS92MjtpbmZyYXYyogIDTUlYqgITTWV0YWxzdGFjay5JbmZyYS5WMsoCE01ldGFsc3RhY2tcSW5mcmFcVjLiAh9NZXRhbHN0YWNrXEluZnJhXFYyXEdQQk1ldGFkYXRh6gIVTWV0YWxzdGFjazo6SW5mcmE6OlYyYgZwcm90bzM", [file_buf_validate_validate, file_google_protobuf_duration, file_metalstack_api_v2_common, file_metalstack_api_v2_predefined_rules, file_metalstack_api_v2_switch]);
 
 /**
- * SwitchServiceGetRequest.
+ * SwitchServiceGetRequest is the request payload for getting a switch.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceGetRequest
  */
 export type SwitchServiceGetRequest = Message<"metalstack.infra.v2.SwitchServiceGetRequest"> & {
   /**
-   * Id of the switch.
+   * Id of the switch
    *
    * @generated from field: string id = 1;
    */
@@ -41,13 +41,13 @@ export const SwitchServiceGetRequestSchema: GenMessage<SwitchServiceGetRequest>
   messageDesc(file_metalstack_infra_v2_switch, 0);
 
 /**
- * SwitchServiceGetResponse.
+ * SwitchServiceGetResponse is the response payload for getting a switch.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceGetResponse
  */
 export type SwitchServiceGetResponse = Message<"metalstack.infra.v2.SwitchServiceGetResponse"> & {
   /**
-   * Switch that was requested.
+   * Switch contains the requested switch
    *
    * @generated from field: metalstack.api.v2.Switch switch = 1;
    */
@@ -62,13 +62,13 @@ export const SwitchServiceGetResponseSchema: GenMessage<SwitchServiceGetResponse
   messageDesc(file_metalstack_infra_v2_switch, 1);
 
 /**
- * SwitchServiceRegisterRequest.
+ * SwitchServiceRegisterRequest is the request payload for registering a switch.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceRegisterRequest
  */
 export type SwitchServiceRegisterRequest = Message<"metalstack.infra.v2.SwitchServiceRegisterRequest"> & {
   /**
-   * Switch to register.
+   * Switch to register
    *
    * @generated from field: metalstack.api.v2.Switch switch = 1;
    */
@@ -83,13 +83,13 @@ export const SwitchServiceRegisterRequestSchema: GenMessage<SwitchServiceRegiste
   messageDesc(file_metalstack_infra_v2_switch, 2);
 
 /**
- * SwitchServiceRegisterResponse.
+ * SwitchServiceRegisterResponse is the response payload for registering a switch.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceRegisterResponse
  */
 export type SwitchServiceRegisterResponse = Message<"metalstack.infra.v2.SwitchServiceRegisterResponse"> & {
   /**
-   * Switch that was registered.
+   * Switch contains the registered switch
    *
    * @generated from field: metalstack.api.v2.Switch switch = 1;
    */
@@ -104,41 +104,41 @@ export const SwitchServiceRegisterResponseSchema: GenMessage<SwitchServiceRegist
   messageDesc(file_metalstack_infra_v2_switch, 3);
 
 /**
- * SwitchServiceHeartbeatRequest.
+ * SwitchServiceHeartbeatRequest is the request payload for sending a switch heartbeat.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceHeartbeatRequest
  */
 export type SwitchServiceHeartbeatRequest = Message<"metalstack.infra.v2.SwitchServiceHeartbeatRequest"> & {
   /**
-   * Id of the switch.
+   * Id of the switch
    *
    * @generated from field: string id = 1;
    */
   id: string;
 
   /**
-   * Duration of the sync.
+   * Duration of the sync
    *
    * @generated from field: google.protobuf.Duration duration = 2;
    */
   duration?: Duration;
 
   /**
-   * Error if any occurred during the sync.
+   * Error if any occurred during the sync
    *
    * @generated from field: optional string error = 3;
    */
   error?: string;
 
   /**
-   * PortStates maps port identifiers to the respective port's operational state.
+   * PortStates maps port identifiers to the respective port's operational state
    *
    * @generated from field: map<string, metalstack.api.v2.SwitchPortStatus> port_states = 4;
    */
   portStates: { [key: string]: SwitchPortStatus };
 
   /**
-   * BgpPortStates maps port identifiers to the respective port's BGP state.
+   * BgpPortStates maps port identifiers to the respective port's BGP state
    *
    * @generated from field: map<string, metalstack.api.v2.SwitchBGPPortState> bgp_port_states = 5;
    */
@@ -153,27 +153,27 @@ export const SwitchServiceHeartbeatRequestSchema: GenMessage<SwitchServiceHeartb
   messageDesc(file_metalstack_infra_v2_switch, 4);
 
 /**
- * SwitchServiceHeartbeatResponse.
+ * SwitchServiceHeartbeatResponse is the response payload for sending a switch heartbeat.
  *
  * @generated from message metalstack.infra.v2.SwitchServiceHeartbeatResponse
  */
 export type SwitchServiceHeartbeatResponse = Message<"metalstack.infra.v2.SwitchServiceHeartbeatResponse"> & {
   /**
-   * Id of the switch.
+   * Id of the switch
    *
    * @generated from field: string id = 1;
    */
   id: string;
 
   /**
-   * LastSync holds information about the last sync.
+   * LastSync holds information about the last sync
    *
    * @generated from field: metalstack.api.v2.SwitchSync last_sync = 2;
    */
   lastSync?: SwitchSync;
 
   /**
-   * LastSyncError holds information about the last erroneous sync.
+   * LastSyncError holds information about the last erroneous sync
    *
    * @generated from field: metalstack.api.v2.SwitchSync last_sync_error = 3;
    */
@@ -188,13 +188,13 @@ export const SwitchServiceHeartbeatResponseSchema: GenMessage<SwitchServiceHeart
   messageDesc(file_metalstack_infra_v2_switch, 5);
 
 /**
- * SwitchService serves switch related functions.
+ * SwitchService provides infrastructure switch management operations.
  *
  * @generated from service metalstack.infra.v2.SwitchService
  */
 export const SwitchService: GenService<{
   /**
-   * Get a switch by ID.
+   * Returns the switch with the specified ID.
    *
    * @generated from rpc metalstack.infra.v2.SwitchService.Get
    */
@@ -204,7 +204,7 @@ export const SwitchService: GenService<{
     output: typeof SwitchServiceGetResponseSchema;
   },
   /**
-   * Register a switch.
+   * Registers a switch.
    *
    * @generated from rpc metalstack.infra.v2.SwitchService.Register
    */
@@ -214,7 +214,7 @@ export const SwitchService: GenService<{
     output: typeof SwitchServiceRegisterResponseSchema;
   },
   /**
-   * Heartbeat a switch.
+   * Heartbeat sends a heartbeat from a switch.
    *
    * @generated from rpc metalstack.infra.v2.SwitchService.Heartbeat
    */
diff --git a/proto/metalstack/admin/v2/audit.proto b/proto/metalstack/admin/v2/audit.proto
index 0b131174..288ece83 100644
--- a/proto/metalstack/admin/v2/audit.proto
+++ b/proto/metalstack/admin/v2/audit.proto
@@ -6,33 +6,33 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/audit.proto";
 import "metalstack/api/v2/common.proto";
 
-// AuditService serves audit related functions
+// AuditService provides audit logging operations.
 service AuditService {
-  // Get an audit trace
+  // Returns the audit trace with the specified UUID.
   rpc Get(AuditServiceGetRequest) returns (AuditServiceGetResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
   }
-  // List all audit traces
+  // Returns the list of all audit traces.
   rpc List(AuditServiceListRequest) returns (AuditServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
   }
 }
 
-// AuditServiceListRequest is the request payload to list audits
+// AuditServiceListRequest is the request payload for listing audit traces.
 message AuditServiceListRequest {
   // Query for audit traces
   metalstack.api.v2.AuditQuery query = 1;
 }
 
-// AuditServiceListResponse is the response payload of a audit list request
+// AuditServiceListResponse is the response payload for listing audit traces.
 message AuditServiceListResponse {
-  // Traces is a list of audit traces
+  // Traces contains the list of audit traces
   repeated metalstack.api.v2.AuditTrace traces = 1;
 }
 
-// AuditServiceGetRequest is the request payload of a audit get request
+// AuditServiceGetRequest is the request payload for getting an audit trace.
 message AuditServiceGetRequest {
   // Uuid of the audit trace
   string uuid = 1 [(buf.validate.field).string.uuid = true];
@@ -40,7 +40,7 @@ message AuditServiceGetRequest {
   optional metalstack.api.v2.AuditPhase phase = 2 [(buf.validate.field).enum.defined_only = true];
 }
 
-// AuditServiceGetResponse is the response payload of a audit get request
+// AuditServiceGetResponse is the response payload for getting an audit trace.
 message AuditServiceGetResponse {
   // Trace is the audit trace
   metalstack.api.v2.AuditTrace trace = 1;
diff --git a/proto/metalstack/admin/v2/component.proto b/proto/metalstack/admin/v2/component.proto
index 115f1d9d..26a7b2ee 100644
--- a/proto/metalstack/admin/v2/component.proto
+++ b/proto/metalstack/admin/v2/component.proto
@@ -6,20 +6,20 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/component.proto";
 
-// ComponentService serves microservice related functions
+// ComponentService provides microservice component management operations.
 service ComponentService {
-  // Get a single component
+  // Returns the component with the specified UUID.
   rpc Get(ComponentServiceGetRequest) returns (ComponentServiceGetResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // Delete a component
+  // Deletes the component with the specified UUID.
   rpc Delete(ComponentServiceDeleteRequest) returns (ComponentServiceDeleteResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // List all components with their status
+  // Returns the list of all components with their status.
   rpc List(ComponentServiceListRequest) returns (ComponentServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
@@ -27,38 +27,38 @@ service ComponentService {
   }
 }
 
-// ComponentServiceListRequest
+// ComponentServiceListRequest is the request payload for listing components.
 message ComponentServiceListRequest {
-  // Query components.
+  // Query filters components
   metalstack.api.v2.ComponentQuery query = 1;
 }
 
-// ComponentServiceListResponse
+// ComponentServiceListResponse is the response payload for listing components.
 message ComponentServiceListResponse {
-  // Components
+  // Components contains the list of components
   repeated metalstack.api.v2.Component components = 1;
 }
 
-// ComponentServiceGetRequest
+// ComponentServiceGetRequest is the request payload for getting a component.
 message ComponentServiceGetRequest {
   // UUID identifies the component to get
   string uuid = 1 [(buf.validate.field).string.uuid = true];
 }
 
-// ComponentServiceGetResponse
+// ComponentServiceGetResponse is the response payload for getting a component.
 message ComponentServiceGetResponse {
-  // Component
+  // Component contains the retrieved component
   metalstack.api.v2.Component component = 1;
 }
 
-// ComponentServiceGetRequest
+// ComponentServiceDeleteRequest is the request payload for deleting a component.
 message ComponentServiceDeleteRequest {
   // UUID identifies the component to delete
   string uuid = 1 [(buf.validate.field).string.uuid = true];
 }
 
-// ComponentServiceGetResponse
+// ComponentServiceDeleteResponse is the response payload for deleting a component.
 message ComponentServiceDeleteResponse {
-  // Component
+  // Component contains the deleted component
   metalstack.api.v2.Component component = 1;
 }
diff --git a/proto/metalstack/admin/v2/filesystem.proto b/proto/metalstack/admin/v2/filesystem.proto
index 96d42cd8..6b6acab6 100644
--- a/proto/metalstack/admin/v2/filesystem.proto
+++ b/proto/metalstack/admin/v2/filesystem.proto
@@ -7,38 +7,38 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/filesystem.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// FilesystemService serves filesystem related functions
+// FilesystemService provides filesystem management operations.
 service FilesystemService {
-  // Create a filesystem
+  // Creates a new filesystem.
   rpc Create(FilesystemServiceCreateRequest) returns (FilesystemServiceCreateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Update a filesystem
+  // Updates a filesystem.
   rpc Update(FilesystemServiceUpdateRequest) returns (FilesystemServiceUpdateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Delete a filesystem
+  // Deletes a filesystem.
   rpc Delete(FilesystemServiceDeleteRequest) returns (FilesystemServiceDeleteResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
 }
 
-// FilesystemServiceCreateRequest
+// FilesystemServiceCreateRequest is the request payload for creating a filesystem.
 message FilesystemServiceCreateRequest {
-  // FilesystemLayout the filesystemlayout
+  // FilesystemLayout is the filesystem layout to create
   metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
 }
 
-// FilesystemServiceCreateResponse
+// FilesystemServiceCreateResponse is the response payload for creating a filesystem.
 message FilesystemServiceCreateResponse {
-  // FilesystemLayout the filesystemlayout
+  // FilesystemLayout contains the created filesystem layout
   metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
 }
 
-// FilesystemServiceUpdateRequest
+// FilesystemServiceUpdateRequest is the request payload for updating a filesystem.
 message FilesystemServiceUpdateRequest {
   // Id of this filesystemLayout
   string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
@@ -52,7 +52,7 @@ message FilesystemServiceUpdateRequest {
   repeated metalstack.api.v2.Filesystem filesystems = 5;
   // Disks list of disks that belong to this layout
   repeated metalstack.api.v2.Disk disks = 6;
-  // raid arrays to create
+  // Raid arrays to create
   repeated metalstack.api.v2.Raid raid = 7;
   // VolumeGroups list of volumegroups to create
   repeated metalstack.api.v2.VolumeGroup volume_groups = 8;
@@ -62,20 +62,20 @@ message FilesystemServiceUpdateRequest {
   metalstack.api.v2.FilesystemLayoutConstraints constraints = 10;
 }
 
-// FilesystemServiceUpdateResponse
+// FilesystemServiceUpdateResponse is the response payload for updating a filesystem.
 message FilesystemServiceUpdateResponse {
-  // FilesystemLayout the filesystemlayout
+  // FilesystemLayout contains the updated filesystem layout
   metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
 }
 
-// FilesystemServiceDeleteRequest
+// FilesystemServiceDeleteRequest is the request payload for deleting a filesystem.
 message FilesystemServiceDeleteRequest {
   // ID of the filesystem to delete
   string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
 }
 
-// message FilesystemServiceDeleteResponse {
+// FilesystemServiceDeleteResponse is the response payload for deleting a filesystem.
 message FilesystemServiceDeleteResponse {
-  // FilesystemLayout the filesystemlayout
+  // FilesystemLayout contains the deleted filesystem layout
   metalstack.api.v2.FilesystemLayout filesystem_layout = 1;
 }
diff --git a/proto/metalstack/admin/v2/image.proto b/proto/metalstack/admin/v2/image.proto
index f1bd5c4b..1790e0b4 100644
--- a/proto/metalstack/admin/v2/image.proto
+++ b/proto/metalstack/admin/v2/image.proto
@@ -8,43 +8,43 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/image.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// ImageService serves image related functions
+// ImageService provides image management operations.
 service ImageService {
-  // Create a image
+  // Creates a new image.
   rpc Create(ImageServiceCreateRequest) returns (ImageServiceCreateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Update a image
+  // Updates an image.
   rpc Update(ImageServiceUpdateRequest) returns (ImageServiceUpdateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Delete a image
+  // Deletes an image.
   rpc Delete(ImageServiceDeleteRequest) returns (ImageServiceDeleteResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Usage of images
+  // Returns the usage of images.
   rpc Usage(ImageServiceUsageRequest) returns (ImageServiceUsageResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
   }
 }
 
-// ImageServiceCreateRequest
+// ImageServiceCreateRequest is the request payload for creating an image.
 message ImageServiceCreateRequest {
-  // Image is the image
+  // Image is the image to create
   metalstack.api.v2.Image image = 1;
 }
 
-// ImageServiceCreateResponse
+// ImageServiceCreateResponse is the response payload for creating an image.
 message ImageServiceCreateResponse {
-  // Image is the image
+  // Image contains the created image
   metalstack.api.v2.Image image = 1;
 }
 
-// ImageServiceUpdateRequest
+// ImageServiceUpdateRequest is the request payload for updating an image.
 message ImageServiceUpdateRequest {
   // Id of this image
   string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
@@ -52,9 +52,9 @@ message ImageServiceUpdateRequest {
   metalstack.api.v2.UpdateMeta update_meta = 2 [(buf.validate.field).required = true];
   // URL where this image is located
   optional string url = 3 [(buf.validate.field).string.(metalstack.api.v2.is_uri) = true];
-  // Name of this imageLayout
+  // Name of this image
   optional string name = 4 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
-  // Description of this imageLayout
+  // Description of this image
   optional string description = 5 [(buf.validate.field).string.(metalstack.api.v2.is_description) = true];
   // Features of this image
   repeated metalstack.api.v2.ImageFeature features = 6 [(buf.validate.field).repeated = {
@@ -70,32 +70,32 @@ message ImageServiceUpdateRequest {
   google.protobuf.Timestamp expires_at = 8;
 }
 
-// ImageServiceUpdateResponse
+// ImageServiceUpdateResponse is the response payload for updating an image.
 message ImageServiceUpdateResponse {
-  // Image is the image
+  // Image contains the updated image
   metalstack.api.v2.Image image = 1;
 }
 
-// ImageServiceDeleteRequest
+// ImageServiceDeleteRequest is the request payload for deleting an image.
 message ImageServiceDeleteRequest {
   // ID of the image to delete
   string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
 }
 
-// message ImageServiceDeleteResponse {
+// ImageServiceDeleteResponse is the response payload for deleting an image.
 message ImageServiceDeleteResponse {
-  // ImageLayout the imagelayout
+  // Image contains the deleted image
   metalstack.api.v2.Image image = 1;
 }
 
-// ImageServiceUsageRequest
+// ImageServiceUsageRequest is the request payload for getting image usage.
 message ImageServiceUsageRequest {
   // Query for which images the usage should be reported
   metalstack.api.v2.ImageQuery query = 1;
 }
 
-// ImageServiceUsageResponse
+// ImageServiceUsageResponse is the response payload for getting image usage.
 message ImageServiceUsageResponse {
-  // Images with usage
+  // Images contains usage information
   repeated metalstack.api.v2.ImageUsage image_usage = 1;
 }
diff --git a/proto/metalstack/admin/v2/ip.proto b/proto/metalstack/admin/v2/ip.proto
index d37c9665..ab102aab 100644
--- a/proto/metalstack/admin/v2/ip.proto
+++ b/proto/metalstack/admin/v2/ip.proto
@@ -5,9 +5,9 @@ package metalstack.admin.v2;
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/ip.proto";
 
-// IPService serves ip address related functions
+// IPService provides IP address management operations.
 service IPService {
-  // List all ips
+  // Returns the list of all IP addresses.
   rpc List(IPServiceListRequest) returns (IPServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
@@ -15,14 +15,14 @@ service IPService {
   }
 }
 
-// IPServiceListRequest
+// IPServiceListRequest is the request payload for listing IP addresses.
 message IPServiceListRequest {
-  // Query to search for one or more ips
+  // Query to search for IP addresses
   metalstack.api.v2.IPQuery query = 1;
 }
 
-// IPServiceListResponse
+// IPServiceListResponse is the response payload for listing IP addresses.
 message IPServiceListResponse {
-  // IPs are the list of ips
+  // IPs contains the list of IP addresses
   repeated metalstack.api.v2.IP ips = 1;
 }
diff --git a/proto/metalstack/admin/v2/machine.proto b/proto/metalstack/admin/v2/machine.proto
index 73e49656..95306525 100644
--- a/proto/metalstack/admin/v2/machine.proto
+++ b/proto/metalstack/admin/v2/machine.proto
@@ -7,35 +7,35 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/machine.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// MachineService serves machine related functions
+// MachineService provides machine lifecycle management operations.
 service MachineService {
-  // Get a machine
+  // Returns the machine with the specified UUID.
   rpc Get(MachineServiceGetRequest) returns (MachineServiceGetResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // List all machines
+  // Returns the list of all machines.
   rpc List(MachineServiceListRequest) returns (MachineServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // BMCCommand send a command to the bmc of a machine
+  // BMCCommand sends a command to the BMC of a machine.
   rpc BMCCommand(MachineServiceBMCCommandRequest) returns (MachineServiceBMCCommandResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // GetBMC returns the BMC details of a machine
+  // Returns the BMC details of a machine.
   rpc GetBMC(MachineServiceGetBMCRequest) returns (MachineServiceGetBMCResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
   }
-  // ListBMC returns the BMC details of many machines
+  // ListBMC returns the BMC details of many machines.
   rpc ListBMC(MachineServiceListBMCRequest) returns (MachineServiceListBMCResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
   }
-  // ConsolePassword returns the password to access the serial console of the machine
+  // GetConsolePassword returns the password to access the serial console of the machine.
   rpc ConsolePassword(MachineServiceConsolePasswordRequest) returns (MachineServiceConsolePasswordResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
@@ -112,11 +112,11 @@ message MachineServiceListBMCResponse {
   }];
 }
 
-// MachineServiceConsolePasswordRequest is the request to get the console password
+// MachineServiceConsolePasswordRequest is the request payload for getting the console password.
 message MachineServiceConsolePasswordRequest {
   // UUID of the machine to get
   string uuid = 1 [(buf.validate.field).string.uuid = true];
-  // Reason must be provided why access to the console is requested.
+  // Reason must be provided why access to the console is requested
   // Reason is only forwarded to an audit sink
   string reason = 2 [
     (buf.validate.field).string.min_len = 10,
@@ -124,7 +124,7 @@ message MachineServiceConsolePasswordRequest {
   ];
 }
 
-// MachineServiceConsolePasswordResponse is the response to the console password request
+// MachineServiceConsolePasswordResponse is the response payload for getting the console password.
 message MachineServiceConsolePasswordResponse {
   // UUID of the machine to get
   string uuid = 1 [(buf.validate.field).string.uuid = true];
diff --git a/proto/metalstack/admin/v2/network.proto b/proto/metalstack/admin/v2/network.proto
index aca5bcfd..4f36d57f 100644
--- a/proto/metalstack/admin/v2/network.proto
+++ b/proto/metalstack/admin/v2/network.proto
@@ -7,30 +7,30 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/network.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// NetworkService serves network address related functions
+// NetworkService provides network management operations.
 service NetworkService {
-  // Get a network
+  // Returns the network with the specified ID.
   rpc Get(NetworkServiceGetRequest) returns (NetworkServiceGetResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // Create a network
+  // Creates a new network.
   rpc Create(NetworkServiceCreateRequest) returns (NetworkServiceCreateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Update a network
+  // Updates a network.
   rpc Update(NetworkServiceUpdateRequest) returns (NetworkServiceUpdateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Delete a network
+  // Deletes a network.
   rpc Delete(NetworkServiceDeleteRequest) returns (NetworkServiceDeleteResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // List all networks
+  // Returns the list of all networks.
   rpc List(NetworkServiceListRequest) returns (NetworkServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
@@ -38,19 +38,19 @@ service NetworkService {
   }
 }
 
-// NetworkServiceGetRequest
+// NetworkServiceGetRequest is the request payload for getting a network.
 message NetworkServiceGetRequest {
   // ID of the network to get
   string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
 }
 
-// NetworkServiceGetResponse
+// NetworkServiceGetResponse is the response payload for getting a network.
 message NetworkServiceGetResponse {
-  // Network which was requested to get
+  // Network contains the requested network
   metalstack.api.v2.Network network = 1;
 }
 
-// NetworkServiceCreateRequest
+// NetworkServiceCreateRequest is the request payload for creating a network.
 message NetworkServiceCreateRequest {
   // Id of this network
   optional string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
@@ -76,7 +76,7 @@ message NetworkServiceCreateRequest {
   metalstack.api.v2.ChildPrefixLength min_child_prefix_length = 11;
   // NATType of this network
   optional metalstack.api.v2.NATType nat_type = 12 [(buf.validate.field).enum.defined_only = true];
-  // VRF of this network has this VNI.
+  // VRF of this network has this VNI
   optional uint32 vrf = 13;
   // Parent Network points to the id of the parent network if any
   optional string parent_network = 14 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
@@ -88,7 +88,7 @@ message NetworkServiceCreateRequest {
   optional metalstack.api.v2.NetworkAddressFamily address_family = 17 [(buf.validate.field).enum.defined_only = true];
 }
 
-// NetworkServiceUpdateRequest is the request payload for a network update request
+// NetworkServiceUpdateRequest is the request payload for updating a network.
 message NetworkServiceUpdateRequest {
   // Id of this network
   string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
@@ -104,7 +104,7 @@ message NetworkServiceUpdateRequest {
   repeated string prefixes = 6 [(buf.validate.field).repeated.(metalstack.api.v2.prefixes) = true];
   // Destination Prefixes in this network
   repeated string destination_prefixes = 7 [(buf.validate.field).repeated.(metalstack.api.v2.prefixes) = true];
-  // Default Child Prefix length defines the bit length of a child network created per addressfamily, of not specified during the allocate request
+  // Default Child Prefix length defines the bit length of a child network created per addressfamily, if not specified during the allocate request
   optional metalstack.api.v2.ChildPrefixLength default_child_prefix_length = 8;
   // Min Child Prefix length asserts that during child network creation the requested bit length is greater or equal the min child prefix length
   optional metalstack.api.v2.ChildPrefixLength min_child_prefix_length = 9;
@@ -113,42 +113,42 @@ message NetworkServiceUpdateRequest {
   // AdditionalAnnouncableCidrs will be added to the allow list on the switch which prefixes might be announced
   repeated string additional_announcable_cidrs = 11 [(buf.validate.field).repeated.(metalstack.api.v2.prefixes) = true];
 
-  // Force update, actually only prevents accidental removal of additional_announcable_cidrs which will destroy your dataplane in fact.
+  // Force update, prevents accidental removal of additional_announcable_cidrs which will destroy your dataplane.
   bool force = 12;
 }
 
-// NetworkServiceDeleteRequest is the request payload for a network delete request
+// NetworkServiceDeleteRequest is the request payload for deleting a network.
 message NetworkServiceDeleteRequest {
   // ID of the network to get
   string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
 }
 
-// NetworkServiceListRequest
+// NetworkServiceListRequest is the request payload for listing networks.
 message NetworkServiceListRequest {
-  // Query which specifies which networks to return
+  // Query specifies which networks to return
   metalstack.api.v2.NetworkQuery query = 2;
 }
 
-// NetworkServiceCreateResponse is the response payload for a network create request
+// NetworkServiceCreateResponse is the response payload for creating a network.
 message NetworkServiceCreateResponse {
-  // Network the network
+  // Network contains the created network
   metalstack.api.v2.Network network = 1;
 }
 
-// NetworkServiceUpdateResponse is the response payload for a network update request
+// NetworkServiceUpdateResponse is the response payload for updating a network.
 message NetworkServiceUpdateResponse {
-  // Network the network
+  // Network contains the updated network
   metalstack.api.v2.Network network = 1;
 }
 
-// NetworkServiceCapacityResponse is the response payload for a network delete request
+// NetworkServiceDeleteResponse is the response payload for deleting a network.
 message NetworkServiceDeleteResponse {
-  // Network the network
+  // Network contains the deleted network
   metalstack.api.v2.Network network = 1;
 }
 
-// NetworkServiceListResponse
+// NetworkServiceListResponse is the response payload for listing networks.
 message NetworkServiceListResponse {
-  // Networks are the requested networks
+  // Networks contains the list of networks
   repeated metalstack.api.v2.Network networks = 1;
 }
diff --git a/proto/metalstack/admin/v2/partition.proto b/proto/metalstack/admin/v2/partition.proto
index 0c083c30..ba54a5f7 100644
--- a/proto/metalstack/admin/v2/partition.proto
+++ b/proto/metalstack/admin/v2/partition.proto
@@ -7,24 +7,24 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/partition.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// PartitionService serves partition address related functions
+// PartitionService provides partition management operations.
 service PartitionService {
-  // Create a partition
+  // Creates a new partition.
   rpc Create(PartitionServiceCreateRequest) returns (PartitionServiceCreateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Update a partition
+  // Updates a partition.
   rpc Update(PartitionServiceUpdateRequest) returns (PartitionServiceUpdateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Delete a partition
+  // Deletes a partition.
   rpc Delete(PartitionServiceDeleteRequest) returns (PartitionServiceDeleteResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Capacity of a partitions
+  // Returns the capacity of a partition.
   rpc Capacity(PartitionServiceCapacityRequest) returns (PartitionServiceCapacityResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
@@ -38,7 +38,7 @@ message PartitionServiceCreateRequest {
   metalstack.api.v2.Partition partition = 1;
 }
 
-// PartitionServiceUpdateRequest is the request payload for a partition update request
+// PartitionServiceUpdateRequest is the request payload for updating a partition.
 message PartitionServiceUpdateRequest {
   // ID of this partition
   string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_partition) = true];
@@ -53,9 +53,8 @@ message PartitionServiceUpdateRequest {
   // NTPServers for this partition
   repeated metalstack.api.v2.NTPServer ntp_servers = 6 [(buf.validate.field).repeated.max_items = 10];
   // ManagementServiceAddresses defines where the management is reachable
-  // should be in the form <ip|host>:<port>
-  // FIXME validation
-  repeated string mgmt_service_addresses = 7;
+  // must be in the form <ip|host>:<port>
+  repeated string mgmt_service_addresses = 7 [(buf.validate.field).repeated.(metalstack.api.v2.are_host_and_port) = true];
   // Labels to update on this network
   optional metalstack.api.v2.UpdateLabels labels = 8;
 }
@@ -78,13 +77,13 @@ message PartitionServiceUpdateResponse {
   metalstack.api.v2.Partition partition = 1;
 }
 
-// PartitionServiceCapacityResponse is the response payload for a partition delete request
+// PartitionServiceDeleteResponse is the response payload for deleting a partition.
 message PartitionServiceDeleteResponse {
-  // Partition the partition
+  // Partition contains the deleted partition
   metalstack.api.v2.Partition partition = 1;
 }
 
-// PartitionServiceListRequest is the request payload for a partition capacity request
+// PartitionServiceCapacityRequest is the request payload for getting partition capacity.
 message PartitionServiceCapacityRequest {
   // ID of the partition to get
   optional string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_partition) = true];
diff --git a/proto/metalstack/admin/v2/project.proto b/proto/metalstack/admin/v2/project.proto
index e99dac11..4e02d434 100644
--- a/proto/metalstack/admin/v2/project.proto
+++ b/proto/metalstack/admin/v2/project.proto
@@ -7,9 +7,9 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 import "metalstack/api/v2/project.proto";
 
-// ProjectService serves project related functions
+// ProjectService provides project management operations.
 service ProjectService {
-  // List projects based on various filter criteria
+  // Returns the list of projects matching the filter criteria.
   rpc List(ProjectServiceListRequest) returns (ProjectServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
@@ -17,16 +17,16 @@ service ProjectService {
   }
 }
 
-// ProjectServiceListRequest is the request payload for the project list request
+// ProjectServiceListRequest is the request payload for listing projects.
 message ProjectServiceListRequest {
-  // Tenant lists only projects of this tenant
+  // Tenant filters projects by this tenant
   optional string tenant = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
-  // Labels lists only projects containing the given labels
+  // Labels filters projects containing the given labels
   optional metalstack.api.v2.Labels labels = 2;
 }
 
-// ProjectServiceListResponse is the response payload for the project list request
+// ProjectServiceListResponse is the response payload for listing projects.
 message ProjectServiceListResponse {
-  // Projects is a list of all projects
+  // Projects contains the list of projects
   repeated metalstack.api.v2.Project projects = 1;
 }
diff --git a/proto/metalstack/admin/v2/size.proto b/proto/metalstack/admin/v2/size.proto
index b85b0e85..a3992eac 100644
--- a/proto/metalstack/admin/v2/size.proto
+++ b/proto/metalstack/admin/v2/size.proto
@@ -7,35 +7,35 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 import "metalstack/api/v2/size.proto";
 
-// SizeService serves size related functions
+// SizeService provides size management operations.
 service SizeService {
-  // Create a size
+  // Creates a new size.
   rpc Create(SizeServiceCreateRequest) returns (SizeServiceCreateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // Update a size
+  // Updates a size.
   rpc Update(SizeServiceUpdateRequest) returns (SizeServiceUpdateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // Delete a size
+  // Deletes a size.
   rpc Delete(SizeServiceDeleteRequest) returns (SizeServiceDeleteResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
 }
 
-// SizeServiceCreateRequest is the request payload for a size create request
+// SizeServiceCreateRequest is the request payload for creating a size.
 message SizeServiceCreateRequest {
   // Size is the size to create
   metalstack.api.v2.Size size = 1;
 }
 
-// SizeServiceGetResponse is the response payload for a size create request
+// SizeServiceCreateResponse is the response payload for creating a size.
 message SizeServiceCreateResponse {
-  // Size the size
+  // Size contains the created size
   metalstack.api.v2.Size size = 1;
 }
 
-// SizeServiceUpdateRequest is the request payload for a size update request
+// SizeServiceUpdateRequest is the request payload for updating a size.
 message SizeServiceUpdateRequest {
   // Id of this size
   string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
@@ -51,20 +51,20 @@ message SizeServiceUpdateRequest {
   optional metalstack.api.v2.UpdateLabels labels = 6;
 }
 
-// SizeServiceUpdateResponse is the response payload for a size update request
+// SizeServiceUpdateResponse is the response payload for updating a size.
 message SizeServiceUpdateResponse {
-  // Size the size
+  // Size contains the updated size
   metalstack.api.v2.Size size = 1;
 }
 
-// SizeServiceDeleteRequest is the request payload for a size delete request
+// SizeServiceDeleteRequest is the request payload for deleting a size.
 message SizeServiceDeleteRequest {
   // ID of the size to delete
   string id = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
 }
 
-// SizeServiceDeleteResponse is the response payload for a size delete request
+// SizeServiceDeleteResponse is the response payload for deleting a size.
 message SizeServiceDeleteResponse {
-  // Size the size
+  // Size contains the deleted size
   metalstack.api.v2.Size size = 1;
 }
diff --git a/proto/metalstack/admin/v2/size_imageconstraint.proto b/proto/metalstack/admin/v2/size_imageconstraint.proto
index 0444c7e1..a0d5868e 100644
--- a/proto/metalstack/admin/v2/size_imageconstraint.proto
+++ b/proto/metalstack/admin/v2/size_imageconstraint.proto
@@ -7,30 +7,30 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 import "metalstack/api/v2/size_imageconstraint.proto";
 
-// SizeImageConstraintService serves size and image constraint related functions
+// SizeImageConstraintService provides size and image constraint management operations.
 service SizeImageConstraintService {
-  // Create a size image constraint
+  // Creates a size image constraint.
   rpc Create(SizeImageConstraintServiceCreateRequest) returns (SizeImageConstraintServiceCreateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Update a size image constraint
+  // Updates a size image constraint.
   rpc Update(SizeImageConstraintServiceUpdateRequest) returns (SizeImageConstraintServiceUpdateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Delete a size image constraint
+  // Deletes a size image constraint.
   rpc Delete(SizeImageConstraintServiceDeleteRequest) returns (SizeImageConstraintServiceDeleteResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Get a size image constraint
+  // Returns the size image constraint with the specified size.
   rpc Get(SizeImageConstraintServiceGetRequest) returns (SizeImageConstraintServiceGetResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // List a size image constraint
+  // Returns the list of size image constraints.
   rpc List(SizeImageConstraintServiceListRequest) returns (SizeImageConstraintServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
@@ -38,7 +38,7 @@ service SizeImageConstraintService {
   }
 }
 
-// SizeImageConstraintServiceCreateRequest is the request payload for a size image constraint create request
+// SizeImageConstraintServiceCreateRequest is the request payload for creating a size image constraint.
 message SizeImageConstraintServiceCreateRequest {
   // Size of the constraint
   string size = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
@@ -52,13 +52,13 @@ message SizeImageConstraintServiceCreateRequest {
   optional string description = 5 [(buf.validate.field).string.(metalstack.api.v2.is_description) = true];
 }
 
-// SizeImageConstraintServiceCreateResponse is the response payload for a size image constraint create request
+// SizeImageConstraintServiceCreateResponse is the response payload for creating a size image constraint.
 message SizeImageConstraintServiceCreateResponse {
-  // SizeImageConstraint created
+  // SizeImageConstraint contains the created constraint
   metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
 }
 
-// SizeImageConstraintServiceUpdateRequest is the request payload for a size image constraint update request
+// SizeImageConstraintServiceUpdateRequest is the request payload for updating a size image constraint.
 message SizeImageConstraintServiceUpdateRequest {
   // Size of the image constraint to update
   string size = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
@@ -72,44 +72,44 @@ message SizeImageConstraintServiceUpdateRequest {
   optional string description = 5 [(buf.validate.field).string.(metalstack.api.v2.is_description) = true];
 }
 
-// SizeImageConstraintServiceUpdateResponse is the response payload for a size image constraint update request
+// SizeImageConstraintServiceUpdateResponse is the response payload for updating a size image constraint.
 message SizeImageConstraintServiceUpdateResponse {
-  // SizeImageConstraint updated
+  // SizeImageConstraint contains the updated constraint
   metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
 }
 
-// SizeImageConstraintServiceDeleteRequest is the request payload for a size image constraint delete request
+// SizeImageConstraintServiceDeleteRequest is the request payload for deleting a size image constraint.
 message SizeImageConstraintServiceDeleteRequest {
   // Size of the constraint
   string size = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
 }
 
-// SizeImageConstraintServiceDeleteResponse is the response payload for a size image constraint delete request
+// SizeImageConstraintServiceDeleteResponse is the response payload for deleting a size image constraint.
 message SizeImageConstraintServiceDeleteResponse {
-  // SizeImageConstraint deleted
+  // SizeImageConstraint contains the deleted constraint
   metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
 }
 
-// SizeImageConstraintServiceGetRequest is the request payload for a size image constraint get request
+// SizeImageConstraintServiceGetRequest is the request payload for getting a size image constraint.
 message SizeImageConstraintServiceGetRequest {
   // Size of the constraint
   string size = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
 }
 
-// SizeImageConstraintServiceGetResponse is the response payload for a size image constraint get request
+// SizeImageConstraintServiceGetResponse is the response payload for getting a size image constraint.
 message SizeImageConstraintServiceGetResponse {
-  // SizeImageConstraint get
+  // SizeImageConstraint contains the retrieved constraint
   metalstack.api.v2.SizeImageConstraint size_image_constraint = 1;
 }
 
-// SizeImageConstraintServiceListRequest is the request payload for a size image constraint list request
+// SizeImageConstraintServiceListRequest is the request payload for listing size image constraints.
 message SizeImageConstraintServiceListRequest {
   // Query for size image constraints
   metalstack.api.v2.SizeImageConstraintQuery query = 1;
 }
 
-// SizeImageConstraintServiceListResponse is the response payload for a size image constraint list request
+// SizeImageConstraintServiceListResponse is the response payload for listing size image constraints.
 message SizeImageConstraintServiceListResponse {
-  // SizeImageConstraints listed
+  // SizeImageConstraints contains the list of constraints
   repeated metalstack.api.v2.SizeImageConstraint size_image_constraints = 1;
 }
diff --git a/proto/metalstack/admin/v2/size_reservation.proto b/proto/metalstack/admin/v2/size_reservation.proto
index c3c01746..010d64c7 100644
--- a/proto/metalstack/admin/v2/size_reservation.proto
+++ b/proto/metalstack/admin/v2/size_reservation.proto
@@ -7,24 +7,24 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 import "metalstack/api/v2/size_reservation.proto";
 
-// SizeReservationService serves size reservation related functions
+// SizeReservationService provides size reservation management operations.
 service SizeReservationService {
-  // Create a size reservation
+  // Creates a new size reservation.
   rpc Create(SizeReservationServiceCreateRequest) returns (SizeReservationServiceCreateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Update a size reservation
+  // Updates a size reservation.
   rpc Update(SizeReservationServiceUpdateRequest) returns (SizeReservationServiceUpdateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // Delete a size reservation
+  // Deletes a size reservation.
   rpc Delete(SizeReservationServiceDeleteRequest) returns (SizeReservationServiceDeleteResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
-  // List size reservations
+  // Returns the list of size reservations.
   rpc List(SizeReservationServiceListRequest) returns (SizeReservationServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
@@ -32,19 +32,19 @@ service SizeReservationService {
   }
 }
 
-// SizeReservationServiceCreateRequest is the request payload for a size reservation create request
+// SizeReservationServiceCreateRequest is the request payload for creating a size reservation.
 message SizeReservationServiceCreateRequest {
   // SizeReservation is the size reservation to create
   metalstack.api.v2.SizeReservation size_reservation = 1;
 }
 
-// SizeReservationServiceCreateResponse is the response payload for a size reservation create request
+// SizeReservationServiceCreateResponse is the response payload for creating a size reservation.
 message SizeReservationServiceCreateResponse {
-  // SizeReservation the size reservation
+  // SizeReservation contains the created reservation
   metalstack.api.v2.SizeReservation size_reservation = 1;
 }
 
-// SizeReservationServiceUpdateRequest is the request payload for a size reservation update request
+// SizeReservationServiceUpdateRequest is the request payload for updating a size reservation.
 message SizeReservationServiceUpdateRequest {
   // Id of this size reservation
   string id = 1 [(buf.validate.field).string.uuid = true];
@@ -65,32 +65,32 @@ message SizeReservationServiceUpdateRequest {
   optional metalstack.api.v2.UpdateLabels labels = 7;
 }
 
-// SizeReservationServiceUpdateResponse is the response payload for a size reservation update request
+// SizeReservationServiceUpdateResponse is the response payload for updating a size reservation.
 message SizeReservationServiceUpdateResponse {
-  // SizeReservation the size reservation
+  // SizeReservation contains the updated reservation
   metalstack.api.v2.SizeReservation size_reservation = 1;
 }
 
-// SizeReservationServiceDeleteRequest is the request payload for a size reservation delete request
+// SizeReservationServiceDeleteRequest is the request payload for deleting a size reservation.
 message SizeReservationServiceDeleteRequest {
   // ID of the size reservation to delete
   string id = 1 [(buf.validate.field).string.uuid = true];
 }
 
-// SizeReservationServiceDeleteResponse is the response payload for a size reservation delete request
+// SizeReservationServiceDeleteResponse is the response payload for deleting a size reservation.
 message SizeReservationServiceDeleteResponse {
-  // SizeReservation the size reservation
+  // SizeReservation contains the deleted reservation
   metalstack.api.v2.SizeReservation size_reservation = 1;
 }
 
-// SizeReservationServiceListRequest is the request payload for a size list request
+// SizeReservationServiceListRequest is the request payload for listing size reservations.
 message SizeReservationServiceListRequest {
   // Query for size reservations
   metalstack.api.v2.SizeReservationQuery query = 1;
 }
 
-// SizeReservationServiceListResponse is the response payload for a size reservation list request
+// SizeReservationServiceListResponse is the response payload for listing size reservations.
 message SizeReservationServiceListResponse {
-  // Size reservations
+  // SizeReservations contains the list of reservations
   repeated metalstack.api.v2.SizeReservation size_reservations = 1;
 }
diff --git a/proto/metalstack/admin/v2/switch.proto b/proto/metalstack/admin/v2/switch.proto
index 5fb02794..70f789da 100644
--- a/proto/metalstack/admin/v2/switch.proto
+++ b/proto/metalstack/admin/v2/switch.proto
@@ -9,37 +9,37 @@ import "metalstack/api/v2/machine.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 import "metalstack/api/v2/switch.proto";
 
-// SwitchService serves switch related functions.
+// SwitchService provides switch management operations.
 service SwitchService {
-  // Get a switch by ID.
+  // Returns the switch with the specified ID.
   rpc Get(SwitchServiceGetRequest) returns (SwitchServiceGetResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // List switches.
+  // Returns the list of switches.
   rpc List(SwitchServiceListRequest) returns (SwitchServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // Update a switch.
+  // Updates a switch.
   rpc Update(SwitchServiceUpdateRequest) returns (SwitchServiceUpdateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // Delete a switch.
+  // Deletes a switch.
   rpc Delete(SwitchServiceDeleteRequest) returns (SwitchServiceDeleteResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // Migrate a switch.
+  // Migrates a switch.
   rpc Migrate(SwitchServiceMigrateRequest) returns (SwitchServiceMigrateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // Port set the port status of a switch port.
+  // Sets the port status of a switch port.
   rpc Port(SwitchServicePortRequest) returns (SwitchServicePortResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // ConnectedMachines lists all switches with their machine connections.
+  // Returns all switches with their machine connections.
   rpc ConnectedMachines(SwitchServiceConnectedMachinesRequest) returns (SwitchServiceConnectedMachinesResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
@@ -47,133 +47,133 @@ service SwitchService {
   }
 }
 
-// SwitchServiceGetRequest.
+// SwitchServiceGetRequest is the request payload for getting a switch.
 message SwitchServiceGetRequest {
-  // Id of the switch to get.
+  // Id of the switch to get
   string id = 1 [(buf.validate.field).string = {
     hostname: true
     [metalstack.api.v2.is_name]: true
   }];
 }
 
-// SwitchServiceGetResponse.
+// SwitchServiceGetResponse is the response payload for getting a switch.
 message SwitchServiceGetResponse {
-  // Switch that was requested.
+  // Switch contains the requested switch
   metalstack.api.v2.Switch switch = 1;
 }
 
-// SwitchServiceListRequest.
+// SwitchServiceListRequest is the request payload for listing switches.
 message SwitchServiceListRequest {
-  // Query to filter the results.
+  // Query to filter the results
   metalstack.api.v2.SwitchQuery query = 1;
 }
 
-// SwitchServiceListResponse.
+// SwitchServiceListResponse is the response payload for listing switches.
 message SwitchServiceListResponse {
-  // Switches that match the request query.
+  // Switches that match the request query
   repeated metalstack.api.v2.Switch switches = 1;
 }
 
-// SwitchServiceUpdateRequest.
+// SwitchServiceUpdateRequest is the request payload for updating a switch.
 message SwitchServiceUpdateRequest {
-  // ID of the switch.
+  // ID of the switch
   string id = 1 [(buf.validate.field).string = {
     hostname: true
     [metalstack.api.v2.is_name]: true
   }];
-  // UpdateMeta contains the timestamp and strategy to be used in this update request.
+  // UpdateMeta contains the timestamp and strategy to be used in this update request
   metalstack.api.v2.UpdateMeta update_meta = 2 [(buf.validate.field).required = true];
-  // UpdatedAt is the date when this entity was updated.
-  // must be part of the update request to ensure optimistic locking.
+  // UpdatedAt is the date when this entity was updated
+  // Must be part of the update request to ensure optimistic locking
   google.protobuf.Timestamp updated_at = 3;
-  // Description of the switch.
+  // Description of the switch
   optional string description = 4 [(buf.validate.field).string.(metalstack.api.v2.is_description) = true];
-  // Replace mode is used to mark a switch ready for replacement.
+  // ReplaceMode is used to mark a switch ready for replacement
   optional metalstack.api.v2.SwitchReplaceMode replace_mode = 5 [(buf.validate.field).enum.defined_only = true];
-  // Management IP is the switch's IP for management access.
+  // ManagementIp is the switch's IP for management access
   optional string management_ip = 6 [(buf.validate.field).string.ip = true];
-  // Management user is the user name to use for management access.
+  // ManagementUser is the user name to use for management access
   optional string management_user = 7 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
-  // Console command is the command for accessing the switch's console.
+  // ConsoleCommand is the command for accessing the switch's console
   optional string console_command = 8 [(buf.validate.field).string.(metalstack.api.v2.is_description) = true];
-  // Nics are the front panel ports of the switch.
+  // Nics are the front panel ports of the switch
   repeated metalstack.api.v2.SwitchNic nics = 9;
-  // SwitchOs is the OS running on the switch.
+  // SwitchOs is the OS running on the switch
   optional metalstack.api.v2.SwitchOS os = 10;
 }
 
-// SwitchServiceUpdateResponse.
+// SwitchServiceUpdateResponse is the response payload for updating a switch.
 message SwitchServiceUpdateResponse {
-  // Switch that was updated.
+  // Switch contains the updated switch
   metalstack.api.v2.Switch switch = 1;
 }
 
-// SwitchServiceDeleteRequest.
+// SwitchServiceDeleteRequest is the request payload for deleting a switch.
 message SwitchServiceDeleteRequest {
-  // Id of the switch.
+  // Id of the switch
   string id = 1 [(buf.validate.field).string = {
     hostname: true
     [metalstack.api.v2.is_name]: true
   }];
-  // Force will allow switch deletion despite existing machine connections.
+  // Force will allow switch deletion despite existing machine connections
   bool force = 2;
 }
 
-// SwitchServiceDeleteResponse.
+// SwitchServiceDeleteResponse is the response payload for deleting a switch.
 message SwitchServiceDeleteResponse {
-  // Switch that has been deleted.
+  // Switch contains the deleted switch
   metalstack.api.v2.Switch switch = 1;
 }
 
-// SwitchServiceMigrateRequest.
+// SwitchServiceMigrateRequest is the request payload for migrating a switch.
 message SwitchServiceMigrateRequest {
-  // OldSwitch which to migrate away from.
+  // OldSwitch is the switch to migrate away from
   string old_switch = 1 [(buf.validate.field).string = {
     hostname: true
     [metalstack.api.v2.is_name]: true
   }];
-  // NewSwitch which to migrate to.
+  // NewSwitch is the switch to migrate to
   string new_switch = 2 [(buf.validate.field).string = {
     hostname: true
     [metalstack.api.v2.is_name]: true
   }];
 }
 
-// SwitchServiceMigrateResponse.
+// SwitchServiceMigrateResponse is the response payload for migrating a switch.
 message SwitchServiceMigrateResponse {
-  // Switch that was migrated to.
+  // Switch contains the switch was migrated to
   metalstack.api.v2.Switch switch = 1;
 }
 
-// SwitchServicePortRequest.
+// SwitchServicePortRequest is the request payload for setting the port status of a switch port.
 message SwitchServicePortRequest {
-  // Id of the switch.
+  // Id of the switch
   string id = 1 [(buf.validate.field).string = {
     hostname: true
     [metalstack.api.v2.is_name]: true
   }];
-  // NicName of the port whose status should be changed.
+  // NicName of the port whose status should be changed
   string nic_name = 2 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
-  // Status that the port should have.
+  // Status that the port should have
   metalstack.api.v2.SwitchPortStatus status = 3 [(buf.validate.field).enum.defined_only = true];
 }
 
-// SwitchServicePortResponse.
+// SwitchServicePortResponse is the response payload for setting the port status of a switch port.
 message SwitchServicePortResponse {
-  // Switch after the port status toggle..
+  // Switch after the port status toggle
   metalstack.api.v2.Switch switch = 1;
 }
 
-// SwitchServiceConnectedMachinesRequest.
+// SwitchServiceConnectedMachinesRequest is the request payload for listing switches with machine connections.
 message SwitchServiceConnectedMachinesRequest {
-  // Query to filter the switch results.
+  // Query to filter the switch results
   metalstack.api.v2.SwitchQuery query = 1;
-  // MachineQuery to filter the machine results.
+  // MachineQuery to filter the machine results
   metalstack.api.v2.MachineQuery machine_query = 2;
 }
 
-// SwitchServiceConnectedMachinesResponse.
+// SwitchServiceConnectedMachinesResponse is the response payload for listing switches with machine connections.
 message SwitchServiceConnectedMachinesResponse {
-  // SwitchesWithMachines contains all switches with their machine connections.
+  // SwitchesWithMachines contains all switches with their machine connections
   repeated metalstack.api.v2.SwitchWithMachines switches_with_machines = 1;
 }
diff --git a/proto/metalstack/admin/v2/task.proto b/proto/metalstack/admin/v2/task.proto
index c92dcd53..952def45 100644
--- a/proto/metalstack/admin/v2/task.proto
+++ b/proto/metalstack/admin/v2/task.proto
@@ -6,148 +6,148 @@ import "google/protobuf/duration.proto";
 import "google/protobuf/timestamp.proto";
 import "metalstack/api/v2/common.proto";
 
-// TaskService provides services to async tasks
+// TaskService provides asynchronous task management operations.
 service TaskService {
-  // Get a specific task
+  // Returns the task with the specified identifier.
   rpc Get(TaskServiceGetRequest) returns (TaskServiceGetResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
   }
-  // Delete a specific task
+  // Deletes the task with the specified identifier.
   rpc Delete(TaskServiceDeleteRequest) returns (TaskServiceDeleteResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // Queues returns all configures queues
+  // Returns the list of all configured queues.
   rpc Queues(TaskServiceQueuesRequest) returns (TaskServiceQueuesResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
   }
-  // List list all tasks
+  // Returns the list of all tasks.
   rpc List(TaskServiceListRequest) returns (TaskServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
   }
 }
 
-// TaskServiceGetRequest is the message to a get task request
+// TaskServiceGetRequest is the request payload for getting a task.
 message TaskServiceGetRequest {
-  // TaskId to get
+  // TaskId is the identifier of the task to get
   string task_id = 1;
-  // Queue where this task was scheduled to
+  // Queue is the queue where this task was scheduled to
   string queue = 2;
 }
 
-// TaskServiceGetResponse is the response to a task get request
+// TaskServiceGetResponse is the response payload for getting a task.
 message TaskServiceGetResponse {
   // Task contains the task details
   TaskInfo task = 1;
 }
 
-// TaskServiceDeleteRequest is the message to a delete task request
+// TaskServiceDeleteRequest is the request payload for deleting a task.
 message TaskServiceDeleteRequest {
-  // TaskId to cancel
+  // TaskId is the identifier of the task to cancel
   string task_id = 1;
-  // Queue where this task was scheduled to
+  // Queue is the queue where this task was scheduled to
   string queue = 2;
 }
 
-// TaskServiceDeleteResponse is the response to a task delete request
+// TaskServiceDeleteResponse is the response payload for deleting a task.
 message TaskServiceDeleteResponse {}
 
-// TaskServiceQueuesRequest is the message to get all queues
+// TaskServiceQueuesRequest is the request payload for getting all queues.
 message TaskServiceQueuesRequest {}
 
-// TaskServiceQueuesResponse is the response to a queues request
+// TaskServiceQueuesResponse is the response payload for getting all queues.
 message TaskServiceQueuesResponse {
   // Queues configured for the async system
   repeated string queues = 1;
 }
 
-// TaskServiceListRequest is the message to a task list request
+// TaskServiceListRequest is the request payload for listing tasks.
 message TaskServiceListRequest {
-  // Queue where this tasks should be listed
-  // will return tasks from all queues if not specified
+  // Queue filters tasks by this queue
+  // Will return tasks from all queues if not specified
   optional string queue = 1;
-  // Count of tasks to return
+  // Count is the number of tasks to return
   optional uint32 count = 2;
-  // Page of tasks to return
+  // Page is the page of tasks to return
   optional uint32 page = 3;
 }
 
-// TaskServiceListResponse is the response to a task list request
+// TaskServiceListResponse is the response payload for listing tasks.
 message TaskServiceListResponse {
-  // Tasks contains the requested list of tasks
+  // Tasks contains the list of requested tasks
   repeated TaskInfo tasks = 1;
 }
 
-// TaskInfo contains details of an async task
+// TaskInfo contains details of an asynchronous task.
 message TaskInfo {
-  // ID is the identifier of the task.
+  // ID is the identifier of the task
   string id = 1;
-  // Queue is the name of the queue in which the task belongs.
+  // Queue is the name of the queue in which the task belongs
   string queue = 2;
-  // Type is the type name of the task.
+  // Type is the type name of the task
   string type = 3;
-  // Payload is the payload data of the task.
+  // Payload is the payload data of the task
   bytes payload = 4;
-  // State indicates the task state.
+  // State indicates the task state
   TaskState state = 5;
-  // MaxRetry is the maximum number of times the task can be retried.
+  // MaxRetry is the maximum number of times the task can be retried
   int32 max_retry = 6;
-  // Retried is the number of times the task has retried so far.
+  // Retried is the number of times the task has retried so far
   int32 retried = 7;
-  // LastError is the error message from the last failure.
+  // LastError is the error message from the last failure
   string last_error = 8;
-  // LastFailedAt is the time time of the last failure if any.
-  // If the task has no failures, LastFailedAt is zero time (i.e. time.Time{}).
+  // LastFailedAt is the time of the last failure if any
+  // If the task has no failures, LastFailedAt is zero time (i.e. time.Time{})
   google.protobuf.Timestamp last_failed_at = 9;
-  // Timeout is the duration the task can be processed by Handler before being retried,
+  // Timeout is the duration the task can be processed by Handler before being retried
   google.protobuf.Duration timeout = 10;
-  // Deadline is the deadline for the task.
+  // Deadline is the deadline for the task
   google.protobuf.Timestamp deadline = 11;
-  // Group is the name of the group in which the task belongs.
+  // Group is the name of the group in which the task belongs
   //
   // Tasks in the same queue can be grouped together by Group name and will be aggregated into one task
-  // by a Server processing the queue.
+  // by a Server processing the queue
   //
-  // Empty string (default) indicates task does not belong to any groups, and no aggregation will be applied to the task.
+  // Empty string (default) indicates task does not belong to any groups, and no aggregation will be applied to the task
   string group = 12;
-  // NextProcessAt is the time the task is scheduled to be processed,
-  // zero if not applicable.
+  // NextProcessAt is the time the task is scheduled to be processed
+  // Zero if not applicable
   google.protobuf.Timestamp next_process_at = 13;
-  // IsOrphaned describes whether the task is left in active state with no worker processing it.
+  // IsOrphaned describes whether the task is left in active state with no worker processing it
   // An orphaned task indicates that the worker has crashed or experienced network failures and was not able to
-  // extend its lease on the task.
+  // extend its lease on the task
   //
-  // This task will be recovered by running a server against the queue the task is in.
-  // This field is only applicable to tasks with TaskStateActive.
+  // This task will be recovered by running a server against the queue the task is in
+  // This field is only applicable to tasks with TaskStateActive
   bool is_orphaned = 14;
-  // Retention is duration of the retention period after the task is successfully processed.
+  // Retention is duration of the retention period after the task is successfully processed
   google.protobuf.Duration retention = 15;
-  // CompletedAt is the time when the task is processed successfully.
-  // Zero value (i.e. time.Time{}) indicates no value.
+  // CompletedAt is the time when the task is processed successfully
+  // Zero value (i.e. time.Time{}) indicates no value
   google.protobuf.Timestamp completed_at = 16;
-  // Result holds the result data associated with the task.
-  // Use ResultWriter to write result data from the Handler.
+  // Result holds the result data associated with the task
+  // Use ResultWriter to write result data from the Handler
   bytes result = 17;
 }
 
-// TaskState defines the state of the task
+// TaskState defines the state of the task.
 enum TaskState {
-  // TASK_STATE_UNSPECIFIED indicates a undefined state
+  // TASK_STATE_UNSPECIFIED is not specified
   TASK_STATE_UNSPECIFIED = 0;
-  // TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler.
+  // TASK_STATE_ACTIVE indicates that the task is currently being processed by Handler
   TASK_STATE_ACTIVE = 1 [(metalstack.api.v2.enum_string_value) = "active"];
-  // TASK_STATE_PENDING indicates that the task is ready to be processed by Handler.
+  // TASK_STATE_PENDING indicates that the task is ready to be processed by Handler
   TASK_STATE_PENDING = 2 [(metalstack.api.v2.enum_string_value) = "pending"];
-  // TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future.
+  // TASK_STATE_SCHEDULED indicates that the task is scheduled to be processed some time in the future
   TASK_STATE_SCHEDULED = 3 [(metalstack.api.v2.enum_string_value) = "scheduled"];
-  // TASK_STATE_RETRY indicates that the task has previously failed and scheduled to be processed some time in the future.
+  // TASK_STATE_RETRY indicates that the task has previously failed and is scheduled to be processed some time in the future
   TASK_STATE_RETRY = 4 [(metalstack.api.v2.enum_string_value) = "retry"];
-  // TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes.
+  // TASK_STATE_ARCHIVED indicates that the task is archived and stored for inspection purposes
   TASK_STATE_ARCHIVED = 5 [(metalstack.api.v2.enum_string_value) = "archived"];
-  // TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires.
+  // TASK_STATE_COMPLETED indicates that the task is processed successfully and retained until the retention TTL expires
   TASK_STATE_COMPLETED = 6 [(metalstack.api.v2.enum_string_value) = "completed"];
-  // TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task.
+  // TASK_STATE_AGGREGATING indicates that the task is waiting in a group to be aggregated into one task
   TASK_STATE_AGGREGATING = 7 [(metalstack.api.v2.enum_string_value) = "aggregating"];
 }
diff --git a/proto/metalstack/admin/v2/tenant.proto b/proto/metalstack/admin/v2/tenant.proto
index f048e389..57dbf924 100644
--- a/proto/metalstack/admin/v2/tenant.proto
+++ b/proto/metalstack/admin/v2/tenant.proto
@@ -7,24 +7,24 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 import "metalstack/api/v2/tenant.proto";
 
-// TenantService serves tenant related functions
+// TenantService provides tenant management operations.
 service TenantService {
-  // Create a tenant
+  // Creates a new tenant.
   rpc Create(TenantServiceCreateRequest) returns (TenantServiceCreateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // List all tenants
+  // Returns the list of all tenants.
   rpc List(TenantServiceListRequest) returns (TenantServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
   }
 }
 
-// TenantServiceCreateRequest is the request payload of the tenant create request
+// TenantServiceCreateRequest is the request payload for creating a tenant.
 message TenantServiceCreateRequest {
-  // Name of this tenant
+  // Name of the tenant
   string name = 1 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
-  // Description of this tenant
+  // Description of the tenant
   optional string description = 2 [(buf.validate.field).string.(metalstack.api.v2.is_description) = true];
   // Email of the tenant, if not set will be inherited from the creator
   optional string email = 3 [(buf.validate.field).string.email = true];
@@ -34,26 +34,26 @@ message TenantServiceCreateRequest {
   metalstack.api.v2.Labels labels = 5;
 }
 
-// TenantServiceCreateResponse is the response payload of the tenant create request
+// TenantServiceCreateResponse is the response payload for creating a tenant.
 message TenantServiceCreateResponse {
-  // Tenant is the tenant
+  // Tenant contains the created tenant
   metalstack.api.v2.Tenant tenant = 1;
 }
 
-// TenantServiceListRequest is the request payload for a tenant list request
+// TenantServiceListRequest is the request payload for listing tenants.
 message TenantServiceListRequest {
-  // Login of the tenant to list
+  // Login filters tenants by this login
   optional string login = 1;
-  // Name of the tenant to list
+  // Name filters tenants by this name
   optional string name = 2 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
   // Paging details for the list request
   metalstack.api.v2.Paging paging = 3;
 }
 
-// TenantServiceListResponse is the response payload for a tenant list request
+// TenantServiceListResponse is the response payload for listing tenants.
 message TenantServiceListResponse {
-  // Tenants are the list of tenants
+  // Tenants contains the list of tenants
   repeated metalstack.api.v2.Tenant tenants = 1;
-  // NextPage is used for pagination, returns the next page to be fetched and must then be provided in the list request.
+  // NextPage is used for pagination, returns the next page to be fetched and must then be provided in the list request
   optional uint64 next_page = 2;
 }
diff --git a/proto/metalstack/admin/v2/token.proto b/proto/metalstack/admin/v2/token.proto
index 3359fc7b..31c2265e 100644
--- a/proto/metalstack/admin/v2/token.proto
+++ b/proto/metalstack/admin/v2/token.proto
@@ -6,37 +6,37 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/token.proto";
 
-// TokenService serves token related functions
+// TokenService provides token management operations.
 service TokenService {
-  // List tokens
+  // Returns the list of tokens for a user.
   rpc List(TokenServiceListRequest) returns (TokenServiceListResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
   }
-  // Revoke a token
+  // Revokes a token.
   rpc Revoke(TokenServiceRevokeRequest) returns (TokenServiceRevokeResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // Create a token to authenticate against the platform, the secret will be only visible in the response.
+  // Creates a token to authenticate against the platform, the secret will be only visible in the response.
   // This service is suitable to create tokens for other users instead of deriving users from tokens directly.
   rpc Create(TokenServiceCreateRequest) returns (TokenServiceCreateResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
 }
 
-// TokenServiceListRequest is the request payload for the token list request
+// TokenServiceListRequest is the request payload for listing tokens.
 message TokenServiceListRequest {
   // User is the id of the user for which the tokens should be listed
   optional string user = 1;
 }
 
-// TokenServiceListResponse is the response payload for the token list request
+// TokenServiceListResponse is the response payload for listing tokens.
 message TokenServiceListResponse {
-  // Tokens is the list of tokens
+  // Tokens contains the list of tokens
   repeated metalstack.api.v2.Token tokens = 1;
 }
 
-// TokenServiceRevokeRequest is the request payload for the token revoke request
+// TokenServiceRevokeRequest is the request payload for revoking a token.
 message TokenServiceRevokeRequest {
   // Uuid is the uuid of the token which should be revoked
   string uuid = 1 [(buf.validate.field).string.uuid = true];
@@ -47,10 +47,10 @@ message TokenServiceRevokeRequest {
   }];
 }
 
-// TokenServiceRevokeResponse is the response payload for the token revoke request
+// TokenServiceRevokeResponse is the response payload for revoking a token.
 message TokenServiceRevokeResponse {}
 
-// TokenServiceCreateRequest is the request payload to create a token
+// TokenServiceCreateRequest is the request payload for creating a token.
 message TokenServiceCreateRequest {
   // User this token should be created for, if omitted, user is derived from caller
   optional string user = 1 [(buf.validate.field).string = {
@@ -61,10 +61,10 @@ message TokenServiceCreateRequest {
   metalstack.api.v2.TokenServiceCreateRequest token_create_request = 2;
 }
 
-// TokenServiceCreateResponse is the response payload of a token create request
+// TokenServiceCreateResponse is the response payload for creating a token.
 message TokenServiceCreateResponse {
-  // Token which was created
+  // Token contains the created token
   metalstack.api.v2.Token token = 1;
-  // Secret is the body if the jwt token, should be used in api requests as bearer token
+  // Secret is the body if the JWT token, should be used in API requests as bearer token
   string secret = 2;
 }
diff --git a/proto/metalstack/admin/v2/vpn.proto b/proto/metalstack/admin/v2/vpn.proto
index 3b7b8317..469446fb 100644
--- a/proto/metalstack/admin/v2/vpn.proto
+++ b/proto/metalstack/admin/v2/vpn.proto
@@ -8,13 +8,13 @@ import "google/protobuf/timestamp.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/vpn.proto";
 
-// VPNService serves vpn related functions
+// VPNService provides VPN management operations.
 service VPNService {
-  // AuthKey generates a authkey for a project to join a machine to the project vpn
+  // GenerateAuthKey generates an authentication key for a project to join a machine to the project VPN.
   rpc AuthKey(VPNServiceAuthKeyRequest) returns (VPNServiceAuthKeyResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
   }
-  // ListNodes returns a list of machines actually connected to the vpn
+  // Returns the list of machines connected to the VPN.
   rpc ListNodes(VPNServiceListNodesRequest) returns (VPNServiceListNodesResponse) {
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_EDITOR;
     option (metalstack.api.v2.admin_roles) = ADMIN_ROLE_VIEWER;
@@ -23,45 +23,45 @@ service VPNService {
 
 // ------------------------ Service Messages ----------------------------------
 
-// VPNServiceAuthKeyRequest is the request payload for a vpn authkey request.
+// VPNServiceAuthKeyRequest is the request payload for generating a VPN authentication key.
 message VPNServiceAuthKeyRequest {
-  // Project for which a vpn authkey should be generated.
+  // Project for which a VPN authentication key should be generated
   string project = 1 [(buf.validate.field).string.uuid = true];
-  // Ephemeral defines if the authkey should be ephemeral.
+  // Ephemeral defines if the authentication key should be ephemeral
   bool ephemeral = 2;
-  // Expires defines the duration after which the authkey expires.
+  // Expires defines the duration after which the authentication key expires
   google.protobuf.Duration expires = 3;
-  // Reason must be provided why access to the vpn is requested
-  // reason is only forwarded to a audit sink
+  // Reason must be provided why access to the VPN is requested
+  // Reason is only forwarded to an audit sink
   string reason = 4 [
     (buf.validate.field).string.min_len = 10,
     (buf.validate.field).string.max_len = 512
   ];
 }
 
-// VPNServiceAuthKeyResponse is the request payload for a authkey response
+// VPNServiceAuthKeyResponse is the response payload for generating a VPN authentication key.
 message VPNServiceAuthKeyResponse {
-  // Address is the address of the vpn control plane.
+  // Address is the address of the VPN control plane
   string address = 1;
-  // AuthKey is the key to connect to the vpn at the given address.
-  // This key can only be seen once.
+  // AuthKey is the key to connect to the VPN at the given address
+  // This key can only be seen once
   string auth_key = 2;
-  // Ephemeral defines if the authkey should be ephemeral.
+  // Ephemeral defines if the authentication key should be ephemeral
   bool ephemeral = 3;
-  // ExpiresAt this key cannot be used after this timestamp.
+  // ExpiresAt this key cannot be used after this timestamp
   google.protobuf.Timestamp expires_at = 4;
-  // CreatedAt this key was created at this timestamp.
+  // CreatedAt this key was created at this timestamp
   google.protobuf.Timestamp created_at = 5;
 }
 
-// VPNServiceListNodesRequest is the request payload for a vpn list nodes request
+// VPNServiceListNodesRequest is the request payload for listing VPN nodes.
 message VPNServiceListNodesRequest {
-  // Project if given only nodes of this user are returned
+  // Project filters nodes by this project
   optional string project = 1;
 }
 
-// VPNServiceListNodesResponse is the response payload for a vpn list nodes request
+// VPNServiceListNodesResponse is the response payload for listing VPN nodes.
 message VPNServiceListNodesResponse {
-  // Nodes connected to the vpn
+  // Nodes connected to the VPN
   repeated metalstack.api.v2.VPNNode nodes = 1;
 }
diff --git a/proto/metalstack/api/v2/audit.proto b/proto/metalstack/api/v2/audit.proto
index 8d5bdb22..db323742 100644
--- a/proto/metalstack/api/v2/audit.proto
+++ b/proto/metalstack/api/v2/audit.proto
@@ -7,49 +7,49 @@ import "google/protobuf/timestamp.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// AuditService serves audit related functions
+// AuditService provides audit logging operations.
 service AuditService {
-  // Get an audit trace
+  // Returns the audit trace with the specified UUID.
   rpc Get(AuditServiceGetRequest) returns (AuditServiceGetResponse) {
     option (tenant_roles) = TENANT_ROLE_OWNER;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // List audit traces
+  // Returns the list of audit traces.
   rpc List(AuditServiceListRequest) returns (AuditServiceListResponse) {
     option (tenant_roles) = TENANT_ROLE_OWNER;
     option (auditing) = AUDITING_EXCLUDED;
   }
 }
 
-// AuditPhase specifies phase of an audit trace
+// AuditPhase specifies the phase of an audit trace.
 enum AuditPhase {
   // AUDIT_PHASE_UNSPECIFIED is not specified
   AUDIT_PHASE_UNSPECIFIED = 0;
   // AUDIT_PHASE_REQUEST defines an audit trace in the request phase
   AUDIT_PHASE_REQUEST = 1;
-  // AUDIT_PHASE_REQUEST defines an audit trace in the response phase
+  // AUDIT_PHASE_RESPONSE defines an audit trace in the response phase
   AUDIT_PHASE_RESPONSE = 2;
 }
 
-// AuditTrace is an audit trace
+// AuditTrace is an audit trace.
 message AuditTrace {
   // Uuid of the audit trace
   string uuid = 1 [(buf.validate.field).string.uuid = true];
-  // Timestamp is the timestamp when the request arrived at the api
+  // Timestamp is the timestamp when the request arrived at the API
   google.protobuf.Timestamp timestamp = 2;
-  // User is the login user who called the api method
+  // User is the login user who called the API method
   string user = 3;
-  // Tenant is the tenant targeted by the api call
+  // Tenant is the tenant targeted by the API call
   string tenant = 4;
-  // Project is the project targeted by the api call
+  // Project is the project targeted by the API call
   optional string project = 5;
-  // Method is the api method that was called
+  // Method is the API method that was called
   string method = 6;
-  // Body is the payload of the api call. In the request phase this contains the payload sent by the client, in the request phase it contains the payload returned by the api server
+  // Body is the payload of the API call. In the request phase this contains the payload sent by the client, in the response phase it contains the payload returned by the API server
   optional string body = 7;
-  // Source IP contains the source ip address of the api call
+  // SourceIP contains the source IP address of the API call
   string source_ip = 8;
-  // Result Code is a status code describing the result of the api call. It is set for traces in the response phase and contains official gRPC status codes
+  // ResultCode is a status code describing the result of the API call. It is set for traces in the response phase and contains official gRPC status codes
   optional int32 result_code = 9;
   // Phase represents the phase of the audit trace
   AuditPhase phase = 10;
diff --git a/proto/metalstack/api/v2/filesystem.proto b/proto/metalstack/api/v2/filesystem.proto
index f0fc62a8..0487df4a 100644
--- a/proto/metalstack/api/v2/filesystem.proto
+++ b/proto/metalstack/api/v2/filesystem.proto
@@ -6,19 +6,19 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// FilesystemService serves filesystem related functions
+// FilesystemService provides filesystem management operations.
 service FilesystemService {
-  // Get a filesystem
+  // Returns the filesystem with the specified ID.
   rpc Get(FilesystemServiceGetRequest) returns (FilesystemServiceGetResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // List all filesystems
+  // Returns the list of all filesystems.
   rpc List(FilesystemServiceListRequest) returns (FilesystemServiceListResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // Match a filesystems
+  // Matches a filesystem to a size and image or machine.
   rpc Match(FilesystemServiceMatchRequest) returns (FilesystemServiceMatchResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
diff --git a/proto/metalstack/api/v2/health.proto b/proto/metalstack/api/v2/health.proto
index e6af2857..eb0e7cdd 100644
--- a/proto/metalstack/api/v2/health.proto
+++ b/proto/metalstack/api/v2/health.proto
@@ -4,16 +4,16 @@ package metalstack.api.v2;
 
 import "metalstack/api/v2/common.proto";
 
-// HealthService serves health related functions
+// HealthService provides health status monitoring operations.
 service HealthService {
-  // Get the health of the platform
+  // Returns the health status of the platform.
   rpc Get(HealthServiceGetRequest) returns (HealthServiceGetResponse) {
     option (visibility) = VISIBILITY_PUBLIC;
     option (auditing) = AUDITING_EXCLUDED;
   }
 }
 
-// ServiceStatus defines the status of a service
+// ServiceStatus defines the status of a service.
 enum ServiceStatus {
   // SERVICE_STATUS_UNSPECIFIED service status is not known or unspecified
   SERVICE_STATUS_UNSPECIFIED = 0;
@@ -21,43 +21,43 @@ enum ServiceStatus {
   SERVICE_STATUS_DEGRADED = 1;
   // SERVICE_STATUS_UNHEALTHY the service is in unhealthy status, serious impact is expected
   SERVICE_STATUS_UNHEALTHY = 2;
-  // SERVICE_STATUS_HEALTHY the service is in healthy status e.g. fully functional
+  // SERVICE_STATUS_HEALTHY the service is in healthy status, for example fully functional
   SERVICE_STATUS_HEALTHY = 3;
 }
 
-// Service defines the service for which the healtyness is reported
+// Service defines the service for which the healthiness is reported.
 enum Service {
   // SERVICE_UNSPECIFIED is a unknown service
   SERVICE_UNSPECIFIED = 0;
-  // SERVICE_IPAM the ipam service
+  // SERVICE_IPAM the IPAM service
   SERVICE_IPAM = 1 [(enum_string_value) = "ipam"];
-  // SERVICE_RETHINK the rethinkdb
+  // SERVICE_RETHINK the RethinkDB
   SERVICE_RETHINK = 2 [(enum_string_value) = "rethinkdb"];
-  // SERVICE_MASTERDATA the masterdata-api
+  // SERVICE_MASTERDATA the masterdata API
   SERVICE_MASTERDATA = 3 [(enum_string_value) = "masterdata"];
   // SERVICE_MACHINES the machine service
   SERVICE_MACHINES = 4 [(enum_string_value) = "machines"];
   // SERVICE_AUDIT the auditing
   SERVICE_AUDIT = 5 [(enum_string_value) = "audit"];
-  // SERVICE_VPN the vpn service
+  // SERVICE_VPN the VPN service
   SERVICE_VPN = 6 [(enum_string_value) = "vpn"];
-  // SERVICE_REDIS the redis service
+  // SERVICE_REDIS the Redis service
   SERVICE_REDIS = 7 [(enum_string_value) = "redis"];
   // SERVICE_TASKS the tasks service
   SERVICE_TASKS = 8 [(enum_string_value) = "tasks"];
 }
 
-// Health reports the health status of all services
+// Health reports the health status of all services.
 message Health {
-  // Services the health of all individual services
+  // Services contains the health of all individual services
   repeated HealthStatus services = 1;
 }
 
-// HealthStatus the health of one service
+// HealthStatus represents the health status of one service.
 message HealthStatus {
-  // Name the name of the service
+  // Name is the name of the service
   Service name = 1;
-  // Status the status of this service
+  // Status is the status of this service
   ServiceStatus status = 2;
   // Message describes the reason for the unhealthy status if possible
   string message = 3;
@@ -65,19 +65,19 @@ message HealthStatus {
   map<string, PartitionHealth> partitions = 4;
 }
 
-// PartitionHealth the status of a specific service in this partition
+// PartitionHealth represents the status of a specific service in this partition.
 message PartitionHealth {
-  // Status the health status of the service in this partition
+  // Status is the health status of the service in this partition
   ServiceStatus status = 1;
   // Message describes the reason for the unhealthy status if possible
   string message = 2;
 }
 
-// HealthServiceGetRequest is request payload to get the health of the system
+// HealthServiceGetRequest is the request payload for getting the health of the system.
 message HealthServiceGetRequest {}
 
-// HealthServiceGetRequest is the response payload with the health of the system
+// HealthServiceGetResponse is the response payload for getting the health of the system.
 message HealthServiceGetResponse {
-  // Health is the overall health of the system
+  // Health contains the overall health of the system
   Health health = 1;
 }
diff --git a/proto/metalstack/api/v2/image.proto b/proto/metalstack/api/v2/image.proto
index f0d93475..aa589114 100644
--- a/proto/metalstack/api/v2/image.proto
+++ b/proto/metalstack/api/v2/image.proto
@@ -7,19 +7,19 @@ import "google/protobuf/timestamp.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// ImageService serves image related functions
+// ImageService provides image management operations.
 service ImageService {
-  // Get a image
+  // Returns the image with the specified ID.
   rpc Get(ImageServiceGetRequest) returns (ImageServiceGetResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // List all images
+  // Returns the list of all images.
   rpc List(ImageServiceListRequest) returns (ImageServiceListResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // Latest image for a specific os
+  // Returns the latest image for a specific operating system.
   rpc Latest(ImageServiceLatestRequest) returns (ImageServiceLatestResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
diff --git a/proto/metalstack/api/v2/ip.proto b/proto/metalstack/api/v2/ip.proto
index f9f43e54..570657c4 100644
--- a/proto/metalstack/api/v2/ip.proto
+++ b/proto/metalstack/api/v2/ip.proto
@@ -6,33 +6,33 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// IPService serves ip address related functions
+// IPService provides IP address management operations.
 service IPService {
-  // Get a ip
+  // Returns the IP address with the specified IP.
   rpc Get(IPServiceGetRequest) returns (IPServiceGetResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
     option (project_roles) = PROJECT_ROLE_VIEWER;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // Create a ip
+  // Creates a new IP address.
   rpc Create(IPServiceCreateRequest) returns (IPServiceCreateResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
   }
-  // Update a ip
+  // Updates an IP address.
   rpc Update(IPServiceUpdateRequest) returns (IPServiceUpdateResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
   }
-  // List all ips
+  // Returns the list of all IP addresses.
   rpc List(IPServiceListRequest) returns (IPServiceListResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
     option (project_roles) = PROJECT_ROLE_VIEWER;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // Delete a ip
+  // Deletes an IP address.
   rpc Delete(IPServiceDeleteRequest) returns (IPServiceDeleteResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
diff --git a/proto/metalstack/api/v2/machine.proto b/proto/metalstack/api/v2/machine.proto
index 08428e61..aeee8887 100644
--- a/proto/metalstack/api/v2/machine.proto
+++ b/proto/metalstack/api/v2/machine.proto
@@ -12,43 +12,43 @@ import "metalstack/api/v2/partition.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 import "metalstack/api/v2/size.proto";
 
-// MachineService serves machine related functions
+// MachineService provides machine lifecycle management operations.
 service MachineService {
-  // Get a machine
+  // Returns the machine with the specified UUID.
   rpc Get(MachineServiceGetRequest) returns (MachineServiceGetResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
     option (project_roles) = PROJECT_ROLE_VIEWER;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // Create a machine
+  // Creates a new machine.
   rpc Create(MachineServiceCreateRequest) returns (MachineServiceCreateResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
   }
-  // Update a machine
+  // Updates a machine.
   rpc Update(MachineServiceUpdateRequest) returns (MachineServiceUpdateResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
   }
-  // List all machines
+  // Returns the list of all machines.
   rpc List(MachineServiceListRequest) returns (MachineServiceListResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
     option (project_roles) = PROJECT_ROLE_VIEWER;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // Delete a machine
+  // Deletes a machine.
   rpc Delete(MachineServiceDeleteRequest) returns (MachineServiceDeleteResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
   }
-  // BMCCommand send a command to the bmc of a machine
+  // BMCCommand sends a command to the BMC of a machine.
   rpc BMCCommand(MachineServiceBMCCommandRequest) returns (MachineServiceBMCCommandResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
   }
-  // GetBMC returns the BMC details of a machine
+  // Returns the BMC details of a machine.
   rpc GetBMC(MachineServiceGetBMCRequest) returns (MachineServiceGetBMCResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
diff --git a/proto/metalstack/api/v2/method.proto b/proto/metalstack/api/v2/method.proto
index c11873ac..57f0ac68 100644
--- a/proto/metalstack/api/v2/method.proto
+++ b/proto/metalstack/api/v2/method.proto
@@ -6,38 +6,38 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/token.proto";
 
-// MethodService serves method related functions
-// methods are functions in services
+// MethodService provides method discovery operations.
+// Methods are functions in services.
 service MethodService {
-  // List all public visible methods
+  // Returns the list of all public visible methods.
   rpc List(MethodServiceListRequest) returns (MethodServiceListResponse) {
     option (visibility) = VISIBILITY_PUBLIC;
   }
-  // TokenScopedList all methods callable with the token present in the request
+  // TokenScopedList returns all methods callable with the token present in the request.
   rpc TokenScopedList(MethodServiceTokenScopedListRequest) returns (MethodServiceTokenScopedListResponse) {
     option (visibility) = VISIBILITY_SELF;
   }
 }
 
-// MethodServiceListRequest is the request payload to list all public methods
+// MethodServiceListRequest is the request payload for listing all public methods.
 message MethodServiceListRequest {}
 
-// MethodServiceListResponse is the response payload with all public visible methods
+// MethodServiceListResponse is the response payload for listing all public methods.
 message MethodServiceListResponse {
   // Methods is a list of methods public callable
   repeated string methods = 1;
 }
 
-// MethodServiceTokenScopedListRequest is the request payload to list all methods callable with the token present in the request
+// MethodServiceTokenScopedListRequest is the request payload for listing all methods callable with the token present in the request.
 message MethodServiceTokenScopedListRequest {}
 
-// MethodServiceTokenScopedListResponse is the response payload which contains all methods which are callable with the given token
+// MethodServiceTokenScopedListResponse is the response payload which contains all methods which are callable with the given token.
 message MethodServiceTokenScopedListResponse {
-  // Permissions a list of methods which can be called
+  // Permissions contains a list of methods which can be called
   repeated MethodPermission permissions = 1;
-  // ProjectRoles associates a project id with the corresponding role of the token owner
+  // ProjectRoles associates a project ID with the corresponding role of the token owner
   map<string, ProjectRole> project_roles = 2;
-  // TenantRoles associates a tenant id with the corresponding role of the token owner
+  // TenantRoles associates a tenant ID with the corresponding role of the token owner
   map<string, TenantRole> tenant_roles = 3;
   // AdminRole defines the admin role of the token owner
   optional AdminRole admin_role = 4 [(buf.validate.field).enum.defined_only = true];
diff --git a/proto/metalstack/api/v2/network.proto b/proto/metalstack/api/v2/network.proto
index c8765230..8f1f8e15 100644
--- a/proto/metalstack/api/v2/network.proto
+++ b/proto/metalstack/api/v2/network.proto
@@ -6,40 +6,40 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// NetworkService serves network address related functions for end users, e.g. with project scope
+// NetworkService provides network management operations for end users, for example with project scope.
 service NetworkService {
-  // Get a network
+  // Returns the network with the specified ID.
   rpc Get(NetworkServiceGetRequest) returns (NetworkServiceGetResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
     option (project_roles) = PROJECT_ROLE_VIEWER;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // Create a child network from a super network.
+  // Creates a child network from a super network.
   rpc Create(NetworkServiceCreateRequest) returns (NetworkServiceCreateResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
   }
-  // Update a network
+  // Updates a network.
   rpc Update(NetworkServiceUpdateRequest) returns (NetworkServiceUpdateResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
   }
-  // List all project networks
+  // Returns the list of all project networks.
   rpc List(NetworkServiceListRequest) returns (NetworkServiceListResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
     option (project_roles) = PROJECT_ROLE_VIEWER;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // ListBaseNetworks all base networks that can be used for either child network or ip allocation
+  // ListBaseNetworks returns all base networks that can be used for either child network or IP allocation.
   rpc ListBaseNetworks(NetworkServiceListBaseNetworksRequest) returns (NetworkServiceListBaseNetworksResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
     option (project_roles) = PROJECT_ROLE_VIEWER;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // Delete a network
+  // Deletes a network.
   rpc Delete(NetworkServiceDeleteRequest) returns (NetworkServiceDeleteResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
diff --git a/proto/metalstack/api/v2/partition.proto b/proto/metalstack/api/v2/partition.proto
index 3bd3ff04..3c9ae28d 100644
--- a/proto/metalstack/api/v2/partition.proto
+++ b/proto/metalstack/api/v2/partition.proto
@@ -6,14 +6,14 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// PartitionService serves partition address related functions
+// PartitionService provides partition management operations.
 service PartitionService {
-  // Get a partition
+  // Returns the partition with the specified ID.
   rpc Get(PartitionServiceGetRequest) returns (PartitionServiceGetResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // List all partitions
+  // Returns the list of all partitions.
   rpc List(PartitionServiceListRequest) returns (PartitionServiceListResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
@@ -36,7 +36,7 @@ message Partition {
   repeated NTPServer ntp_servers = 6 [(buf.validate.field).repeated.max_items = 10];
   // ManagementServiceAddresses defines where the management is reachable
   // should be in the form <ip|host>:<port>
-  repeated string mgmt_service_addresses = 7;
+  repeated string mgmt_service_addresses = 7 [(buf.validate.field).repeated.(metalstack.api.v2.are_host_and_port) = true];
 }
 
 // PartitionQuery is used to search partitions
diff --git a/proto/metalstack/api/v2/predefined_rules.proto b/proto/metalstack/api/v2/predefined_rules.proto
index ab192bcf..dc0ab638 100644
--- a/proto/metalstack/api/v2/predefined_rules.proto
+++ b/proto/metalstack/api/v2/predefined_rules.proto
@@ -49,7 +49,7 @@ extend buf.validate.StringRules {
     message: "must be a valid IP address or hostname"
     expression: "this.isIp() || this.isHostname()"
   }];
-  // Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end.
+  // Trimmed enforces the string to be trimmed, e.g. no whitespaces at the begin and end
   optional bool trimmed = 80048958 [(buf.validate.predefined).cel = {
     id: "string.trimmed"
     message: "value must not start or end with whitespace"
@@ -70,8 +70,14 @@ extend buf.validate.RepeatedRules {
     message: "given ips must be valid"
     expression: "this.all(m, m.isIp())"
   }];
-  // All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end.
-  optional bool all_trimmed = 80058953 [(buf.validate.predefined).cel = {
+  // AreHostAndPort validates if a slice of strings are all in the form of <ip | host>:<port>
+  optional bool are_host_and_port = 80058953 [(buf.validate.predefined).cel = {
+    id: "repeated.are_host_and_port"
+    message: "given entries must all be in the form of <ip | host>:<port> but port is optional"
+    expression: "this.all(m, m.isHostAndPort(false))"
+  }];
+  // All Trimmed enforces all strings to be trimmed, e.g. no whitespaces at the begin and end
+  optional bool all_trimmed = 80058954 [(buf.validate.predefined).cel = {
     id: "repeated.all_trimmed"
     message: "given values must not start or end with whitespace"
     expression: "this.all(m, m.trim().size() == m.size())"
diff --git a/proto/metalstack/api/v2/project.proto b/proto/metalstack/api/v2/project.proto
index 936b4a76..5bf96885 100644
--- a/proto/metalstack/api/v2/project.proto
+++ b/proto/metalstack/api/v2/project.proto
@@ -7,14 +7,14 @@ import "google/protobuf/timestamp.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// ProjectService serves project related functions
+// ProjectService provides project management operations.
 service ProjectService {
-  // List all accessible projects
+  // Returns the list of all accessible projects.
   rpc List(ProjectServiceListRequest) returns (ProjectServiceListResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // Get a project
+  // Returns the project with the specified UUID.
   rpc Get(ProjectServiceGetRequest) returns (ProjectServiceGetResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
diff --git a/proto/metalstack/api/v2/size.proto b/proto/metalstack/api/v2/size.proto
index 6fd9c7e3..53fa05fc 100644
--- a/proto/metalstack/api/v2/size.proto
+++ b/proto/metalstack/api/v2/size.proto
@@ -6,14 +6,14 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// SizeService serves size related functions
+// SizeService provides size management operations.
 service SizeService {
-  // Get a size
+  // Returns the size with the specified ID.
   rpc Get(SizeServiceGetRequest) returns (SizeServiceGetResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // List all sizes
+  // Returns the list of all sizes.
   rpc List(SizeServiceListRequest) returns (SizeServiceListResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
diff --git a/proto/metalstack/api/v2/size_imageconstraint.proto b/proto/metalstack/api/v2/size_imageconstraint.proto
index 12e81ea8..cffaf972 100644
--- a/proto/metalstack/api/v2/size_imageconstraint.proto
+++ b/proto/metalstack/api/v2/size_imageconstraint.proto
@@ -6,9 +6,9 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// SizeImageConstraintService serves size and image constraint related functions
+// SizeImageConstraintService provides size and image constraint validation operations.
 service SizeImageConstraintService {
-  // Try if a given combination of size and image is possible
+  // Try validates if a given combination of size and image is possible.
   rpc Try(SizeImageConstraintServiceTryRequest) returns (SizeImageConstraintServiceTryResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
diff --git a/proto/metalstack/api/v2/size_reservation.proto b/proto/metalstack/api/v2/size_reservation.proto
index 83b5d94d..8667fa67 100644
--- a/proto/metalstack/api/v2/size_reservation.proto
+++ b/proto/metalstack/api/v2/size_reservation.proto
@@ -6,16 +6,16 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// SizeReservationService serves size reservation related functions
+// SizeReservationService provides size reservation management operations.
 service SizeReservationService {
-  // Get a size reservation
+  // Returns the size reservation with the specified ID.
   rpc Get(SizeReservationServiceGetRequest) returns (SizeReservationServiceGetResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
     option (project_roles) = PROJECT_ROLE_VIEWER;
     option (auditing) = AUDITING_EXCLUDED;
   }
-  // List size reservations
+  // Returns the list of size reservations.
   rpc List(SizeReservationServiceListRequest) returns (SizeReservationServiceListResponse) {
     option (project_roles) = PROJECT_ROLE_OWNER;
     option (project_roles) = PROJECT_ROLE_EDITOR;
diff --git a/proto/metalstack/api/v2/tenant.proto b/proto/metalstack/api/v2/tenant.proto
index 0f35e777..e20ac209 100644
--- a/proto/metalstack/api/v2/tenant.proto
+++ b/proto/metalstack/api/v2/tenant.proto
@@ -7,14 +7,14 @@ import "google/protobuf/timestamp.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// TenantService serves tenant related functions
+// TenantService provides tenant management operations.
 service TenantService {
-  // Create a tenant
+  // Creates a new tenant.
   rpc Create(TenantServiceCreateRequest) returns (TenantServiceCreateResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_INCLUDED;
   }
-  // List tenants
+  // Returns the list of tenants.
   rpc List(TenantServiceListRequest) returns (TenantServiceListResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_EXCLUDED;
diff --git a/proto/metalstack/api/v2/token.proto b/proto/metalstack/api/v2/token.proto
index 80d24af5..ad8b0efd 100644
--- a/proto/metalstack/api/v2/token.proto
+++ b/proto/metalstack/api/v2/token.proto
@@ -8,29 +8,29 @@ import "google/protobuf/timestamp.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// TokenService serves token related functions
+// TokenService provides token management operations.
 service TokenService {
-  // Get a token
+  // Returns the token with the specified UUID.
   rpc Get(TokenServiceGetRequest) returns (TokenServiceGetResponse) {
     option (visibility) = VISIBILITY_SELF;
   }
-  // Create a token to authenticate against the platform, the secret will be only visible in the response.
+  // Creates a token to authenticate against the platform, the secret will be only visible in the response.
   rpc Create(TokenServiceCreateRequest) returns (TokenServiceCreateResponse) {
     option (visibility) = VISIBILITY_SELF;
   }
-  // Update a token
+  // Updates a token.
   rpc Update(TokenServiceUpdateRequest) returns (TokenServiceUpdateResponse) {
     option (visibility) = VISIBILITY_SELF;
   }
-  // List all your tokens
+  // Returns the list of all user tokens.
   rpc List(TokenServiceListRequest) returns (TokenServiceListResponse) {
     option (visibility) = VISIBILITY_SELF;
   }
-  // Revoke a token, no further usage is possible afterwards
+  // Revokes a token, no further usage is possible afterwards.
   rpc Revoke(TokenServiceRevokeRequest) returns (TokenServiceRevokeResponse) {
     option (visibility) = VISIBILITY_SELF;
   }
-  // Refresh a token, this will create a new token with the exact same permissions as the calling token contains
+  // Refreshes a token, this will create a new token with the exact same permissions as the calling token contains.
   rpc Refresh(TokenServiceRefreshRequest) returns (TokenServiceRefreshResponse) {
     option (visibility) = VISIBILITY_SELF;
   }
diff --git a/proto/metalstack/api/v2/user.proto b/proto/metalstack/api/v2/user.proto
index 6b807003..bd08243e 100644
--- a/proto/metalstack/api/v2/user.proto
+++ b/proto/metalstack/api/v2/user.proto
@@ -8,18 +8,18 @@ import "metalstack/api/v2/predefined_rules.proto";
 import "metalstack/api/v2/project.proto";
 import "metalstack/api/v2/tenant.proto";
 
-// UserService exposes rpc calls for users
+// UserService provides user information operations.
 service UserService {
-  // Get a User
+  // Returns the authenticated user.
   rpc Get(UserServiceGetRequest) returns (UserServiceGetResponse) {
     option (visibility) = VISIBILITY_SELF;
     option (auditing) = AUDITING_INCLUDED;
   }
 }
 
-// User is a end user of the platform
+// User represents an end user of the platform.
 message User {
-  // Login the login at the provider
+  // Login is the login at the provider
   string login = 1;
   // Name of the user
   string name = 2 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
@@ -35,11 +35,11 @@ message User {
   Tenant default_tenant = 7;
 }
 
-// UserServiceGetRequest is the request to get the user
+// UserServiceGetRequest is the request payload for getting the user.
 message UserServiceGetRequest {}
 
-// UserServiceGetResponse the response when userservice get request was called
+// UserServiceGetResponse is the response payload for getting the user.
 message UserServiceGetResponse {
-  // User is the user
+  // User contains the authenticated user
   User user = 1;
 }
diff --git a/proto/metalstack/api/v2/version.proto b/proto/metalstack/api/v2/version.proto
index c9bdae24..beb0c2e9 100644
--- a/proto/metalstack/api/v2/version.proto
+++ b/proto/metalstack/api/v2/version.proto
@@ -6,16 +6,16 @@ import "buf/validate/validate.proto";
 import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// VersionService serves version related functions
+// VersionService provides version information operations.
 service VersionService {
-  // Get the version
+  // Returns the version of the application.
   rpc Get(VersionServiceGetRequest) returns (VersionServiceGetResponse) {
     option (visibility) = VISIBILITY_PUBLIC;
     option (auditing) = AUDITING_EXCLUDED;
   }
 }
 
-// Version of the application
+// Version represents the version of the application.
 message Version {
   // Version of the application
   string version = 1 [(buf.validate.field).string.(metalstack.api.v2.is_description) = true];
@@ -27,11 +27,11 @@ message Version {
   string build_date = 4 [(buf.validate.field).string.(metalstack.api.v2.is_description) = true];
 }
 
-// VersionServiceGetRequest is the request payload to get the version
+// VersionServiceGetRequest is the request payload for getting the version.
 message VersionServiceGetRequest {}
 
-// VersionServiceGetResponse is the response payload with the version
+// VersionServiceGetResponse is the response payload for getting the version.
 message VersionServiceGetResponse {
-  // Version of the application
+  // Version contains the version of the application
   Version version = 1;
 }
diff --git a/proto/metalstack/api/v2/vpn.proto b/proto/metalstack/api/v2/vpn.proto
index 665466ec..97b27c08 100644
--- a/proto/metalstack/api/v2/vpn.proto
+++ b/proto/metalstack/api/v2/vpn.proto
@@ -4,17 +4,17 @@ package metalstack.api.v2;
 
 import "google/protobuf/timestamp.proto";
 
-// VPNNode is a machine connected to the vpn
+// VPNNode represents a machine connected to the VPN.
 message VPNNode {
-  // Id of this node
+  // ID of this node
   uint64 id = 1;
   // Name of this node
   string name = 2;
   // Project of this node, maps to a project
   string project = 3;
-  // IPAddresses of this node in the vpn
+  // IPAddresses of this node in the VPN
   repeated string ip_addresses = 4;
-  // LastSeen timestamp when this node reached out the the control plane
+  // LastSeen timestamp when this node reached out to the control plane
   google.protobuf.Timestamp last_seen = 5;
   // Online indicates if this node is online
   bool online = 6;
diff --git a/proto/metalstack/infra/v2/bmc.proto b/proto/metalstack/infra/v2/bmc.proto
index edcdf0a1..8922a01a 100644
--- a/proto/metalstack/infra/v2/bmc.proto
+++ b/proto/metalstack/infra/v2/bmc.proto
@@ -7,30 +7,30 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/machine.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// BMCService serves bmc related functions
+// BMCService provides BMC management operations.
 service BMCService {
-  // UpdateBMCInfo
+  // Updates BMC information.
   rpc UpdateBMCInfo(UpdateBMCInfoRequest) returns (UpdateBMCInfoResponse) {
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // WaitForBMCCommand is called by the metal-bmc and is returned with a bmc command to execute.
+  // WaitForBMCCommand is called by the metal-bmc and returns a BMC command to execute.
   rpc WaitForBMCCommand(WaitForBMCCommandRequest) returns (stream WaitForBMCCommandResponse) {
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // BMCCommandDone must be called from metal-bmc after the command execution
+  // BMCCommandDone must be called from metal-bmc after the command execution.
   rpc BMCCommandDone(BMCCommandDoneRequest) returns (BMCCommandDoneResponse) {
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_INCLUDED;
   }
 }
 
-// UpdateBMCInfoRequest
+// UpdateBMCInfoRequest is the request payload for updating BMC information.
 message UpdateBMCInfoRequest {
-  // Partition the partition id where metal-bmc wants to receive events
+  // Partition is the partition ID where metal-bmc wants to receive events
   string partition = 1 [(buf.validate.field).string.(metalstack.api.v2.is_partition) = true];
-  // BmcReports contains maps the bmc report per machine uuid
+  // BmcReports contains maps the BMC report per machine UUID
   map<string, metalstack.api.v2.MachineBMCReport> bmc_reports = 2 [(buf.validate.field).map = {
     keys: {
       string: {uuid: true}
@@ -38,41 +38,41 @@ message UpdateBMCInfoRequest {
   }];
 }
 
-// UpdateBMCInfoResponse
+// UpdateBMCInfoResponse is the response payload for updating BMC information.
 message UpdateBMCInfoResponse {
-  // UpdatedMachines is a slice of machine uuids which were updated
+  // UpdatedMachines is a slice of machine UUIDs which were updated
   repeated string updated_machines = 1;
-  // CreatedMachines is a slice of machine uuids which were created
+  // CreatedMachines is a slice of machine UUIDs which were created
   repeated string created_machines = 2;
 }
 
-// WaitForBMCCommandRequest
+// WaitForBMCCommandRequest is the request payload for waiting for a BMC command.
 message WaitForBMCCommandRequest {
-  // Partition the partition id where metal-bmc wants to receive bmc commands
+  // Partition is the partition ID where metal-bmc wants to receive BMC commands
   string partition = 1 [(buf.validate.field).string.(metalstack.api.v2.is_partition) = true];
 }
 
-// WaitForBMCCommandResponse
+// WaitForBMCCommandResponse is the response payload for waiting for a BMC command.
 message WaitForBMCCommandResponse {
   // UUID of the machine to send the command to
   string uuid = 1 [(buf.validate.field).string.uuid = true];
-  // BmcCommand to execute against the bmc of the machine
+  // BmcCommand to execute against the BMC of the machine
   metalstack.api.v2.MachineBMCCommand bmc_command = 2;
-  // MachineBmc contains connection details of the machine to issue the bmcCommand to
+  // MachineBmc contains connection details of the machine to issue the BMC command to
   metalstack.api.v2.MachineBMC machine_bmc = 3;
   // CommandId is a unique ID which must be sent back after execution
-  // it is usually in the form: <machine-uuid>:machine-bmc-command:<command>
+  // It is usually in the form: <machine-uuid>:machine-bmc-command:<command>
   string command_id = 4;
 }
 
-// BMCCommandDoneRequest must be returned after command execution
+// BMCCommandDoneRequest must be returned after command execution.
 message BMCCommandDoneRequest {
   // CommandId is a unique ID which must be sent back after execution
-  // it is usually in the form: <machine-uuid>:machine-bmc-command
+  // It is usually in the form: <machine-uuid>:machine-bmc-command
   string command_id = 1;
   // Error of the command execution, nil if it was successful
   optional string error = 2;
 }
 
-// BMCCommandDoneResponse
+// BMCCommandDoneResponse is the response payload for BMC command completion.
 message BMCCommandDoneResponse {}
diff --git a/proto/metalstack/infra/v2/boot.proto b/proto/metalstack/infra/v2/boot.proto
index 73989140..84bf13f9 100644
--- a/proto/metalstack/infra/v2/boot.proto
+++ b/proto/metalstack/infra/v2/boot.proto
@@ -7,16 +7,16 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/machine.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 
-// BootService is used for all boot related requests, either pixiecore or metal-hammer
+// BootService provides boot-related operations for pixiecore and metal-hammer.
 service BootService {
   // Pixiecore
 
-  // Dhcp is the first dhcp request (option 97). A ProvisioningEventPXEBooting is fired
+  // Dhcp handles the first DHCP request (option 97). A ProvisioningEventPXEBooting is fired.
   rpc Dhcp(BootServiceDhcpRequest) returns (BootServiceDhcpResponse) {
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // Boot is called from pixie once the machine got the first dhcp response and ipxie asks for subsequent kernel and initrd
+  // Boot is called from pixie once the machine got the first DHCP response and ipxe asks for subsequent kernel and initrd.
   rpc Boot(BootServiceBootRequest) returns (BootServiceBootResponse) {
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
@@ -24,22 +24,22 @@ service BootService {
 
   // Metal Hammer
 
-  // SuperUserPassword metal-hammer takes the configured root password for the bmc from metal-apiserver and configure the bmc accordingly
+  // SuperUserPassword returns the configured root password for the BMC.
   rpc SuperUserPassword(BootServiceSuperUserPasswordRequest) returns (BootServiceSuperUserPasswordResponse) {
     option (metalstack.api.v2.machine_roles) = MACHINE_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all gory details about that machine
+  // Register is called from metal-hammer after hardware inventory is finished, tells metal-apiserver all details about that machine.
   rpc Register(BootServiceRegisterRequest) returns (BootServiceRegisterResponse) {
     option (metalstack.api.v2.machine_roles) = MACHINE_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // Wait is a hanging call that waits until the machine gets allocated by a user
+  // Wait is a hanging call that waits until the machine gets allocated by a user.
   rpc Wait(BootServiceWaitRequest) returns (stream BootServiceWaitResponse) {
     option (metalstack.api.v2.machine_roles) = MACHINE_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // InstallationSucceeded tells metal-apiserver installation was either successful
+  // InstallationSucceeded tells metal-apiserver that installation was successful.
   rpc InstallationSucceeded(BootServiceInstallationSucceededRequest) returns (BootServiceInstallationSucceededResponse) {
     option (metalstack.api.v2.machine_roles) = MACHINE_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
diff --git a/proto/metalstack/infra/v2/component.proto b/proto/metalstack/infra/v2/component.proto
index 26c11069..204ecad2 100644
--- a/proto/metalstack/infra/v2/component.proto
+++ b/proto/metalstack/infra/v2/component.proto
@@ -10,27 +10,24 @@ import "metalstack/api/v2/component.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 import "metalstack/api/v2/version.proto";
 
-// ComponentService serves component, e.g. microservices related functions.
+// ComponentService provides microservice component management operations.
 service ComponentService {
-  // Ping must be called from every connected microservice in a recurring manner
-  // to get visibility of all registered microservices.
+  // Returns the ping response to register or report the microservice state.
   rpc Ping(ComponentServicePingRequest) returns (ComponentServicePingResponse) {
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
 }
 
-// ComponentServicePingRequest is sent from a microservice to report its state regularly
+// ComponentServicePingRequest is the request payload for pinging a microservice.
 message ComponentServicePingRequest {
   // Type defines which service is actually pinging
   metalstack.api.v2.ComponentType type = 1 [(buf.validate.field).enum.defined_only = true];
-  // Identifier is a unique identifier of this service, e.g. if two instance are running, this might be the pod id.
-  // micro_service and identifier guarantee uniqueness.
+  // Identifier is a unique identifier of this service, for example if two instances are running, this might be the pod ID
   string identifier = 2 [(buf.validate.field).string.(metalstack.api.v2.is_name) = true];
-  // StartedAt is the timestamp this service was started.
+  // StartedAt is the timestamp this service was started
   google.protobuf.Timestamp started_at = 3 [(buf.validate.field).timestamp.lt_now = true];
-  // Interval at which the ping is scheduled, must be between 5 seconds and 1 hour.
-  // Also gets validated in the same way in go/client/ping.go.
+  // Interval at which the ping is scheduled, must be between 5 seconds and 1 hour
   google.protobuf.Duration interval = 4 [(buf.validate.field).duration = {
     gte: {seconds: 5}
     lte: {seconds: 3600}
@@ -39,5 +36,5 @@ message ComponentServicePingRequest {
   metalstack.api.v2.Version version = 5;
 }
 
-// ComponentServicePingResponse is the response to a ping request
+// ComponentServicePingResponse is the response payload for pinging a microservice.
 message ComponentServicePingResponse {}
diff --git a/proto/metalstack/infra/v2/event.proto b/proto/metalstack/infra/v2/event.proto
index e102f9fb..efbf2cf6 100644
--- a/proto/metalstack/infra/v2/event.proto
+++ b/proto/metalstack/infra/v2/event.proto
@@ -6,63 +6,63 @@ import "buf/validate/validate.proto";
 import "google/protobuf/timestamp.proto";
 import "metalstack/api/v2/common.proto";
 
-// EventService serves event related functions.
+// EventService provides machine provisioning event logging operations.
 service EventService {
-  // Send a series of machine provisioning events.
+  // Sends a series of machine provisioning events.
   rpc Send(EventServiceSendRequest) returns (EventServiceSendResponse) {
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
 }
 
-// EventServiceSendRequest.
+// EventServiceSendRequest is the request payload for sending provisioning events.
 message EventServiceSendRequest {
-  // Events grouped by machine IDs.
+  // Events grouped by machine IDs
   map<string, MachineProvisioningEvent> events = 1;
 }
 
-// EventServiceSendResponse.
+// EventServiceSendResponse is the response payload for sending provisioning events.
 message EventServiceSendResponse {
-  // Events counts the number of events successfully stored in the database.
+  // Events counts the number of events successfully stored in the database
   uint64 events = 1;
-  // Failed contains IDs of all machines whose events could not be stored in the database.
+  // Failed contains IDs of all machines whose events could not be stored in the database
   repeated string failed = 2;
 }
 
 // MachineProvisioningEvent contains details about an event.
 message MachineProvisioningEvent {
-  // Time the event occurred at.
+  // Time the event occurred at
   google.protobuf.Timestamp time = 1;
-  // Event that occurred.
+  // Event that occurred
   ProvisioningEventType event = 2 [(buf.validate.field).enum.defined_only = true];
-  // Message describing the event in more detail.
+  // Message describes the event in more detail
   string message = 3;
 }
 
 // ProvisioningEventType is a short description of a machine event.
 enum ProvisioningEventType {
-  // PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified.
+  // PROVISIONING_EVENT_TYPE_UNSPECIFIED is unspecified
   PROVISIONING_EVENT_TYPE_UNSPECIFIED = 0;
-  // PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago.
+  // PROVISIONING_EVENT_TYPE_ALIVE means the machine has reported itself to the API not long ago
   PROVISIONING_EVENT_TYPE_ALIVE = 1 [(metalstack.api.v2.enum_string_value) = "Alive"];
-  // PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle.
+  // PROVISIONING_EVENT_TYPE_CRASHED means an irregularity in the machine's lifecycle
   PROVISIONING_EVENT_TYPE_CRASHED = 2 [(metalstack.api.v2.enum_string_value) = "Crashed"];
-  // PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE.
+  // PROVISIONING_EVENT_TYPE_PXE_BOOTING is sent when an unprovisioned machine requests a boot image via PXE
   PROVISIONING_EVENT_TYPE_PXE_BOOTING = 3 [(metalstack.api.v2.enum_string_value) = "PXE Booting"];
-  // PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot.
+  // PROVISIONING_EVENT_TYPE_PLANNED_REBOOT means the machine was scheduled for reboot
   PROVISIONING_EVENT_TYPE_PLANNED_REBOOT = 4 [(metalstack.api.v2.enum_string_value) = "Planned Reboot"];
-  // PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started.
+  // PROVISIONING_EVENT_TYPE_PREPARING means the metal-hammer has started
   PROVISIONING_EVENT_TYPE_PREPARING = 5 [(metalstack.api.v2.enum_string_value) = "Preparing"];
-  // PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API.
+  // PROVISIONING_EVENT_TYPE_REGISTERING means the metal-hammer is attempting to register the machine at the API
   PROVISIONING_EVENT_TYPE_REGISTERING = 6 [(metalstack.api.v2.enum_string_value) = "Registering"];
-  // PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation.
+  // PROVISIONING_EVENT_TYPE_WAITING means the machine has successfully reached the state where it is waiting for allocation
   PROVISIONING_EVENT_TYPE_WAITING = 7 [(metalstack.api.v2.enum_string_value) = "Waiting"];
-  // PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed.
+  // PROVISIONING_EVENT_TYPE_INSTALLING means the machine was allocated and the requested OS is being installed
   PROVISIONING_EVENT_TYPE_INSTALLING = 8 [(metalstack.api.v2.enum_string_value) = "Installing"];
-  // PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS.
+  // PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL means the machine has successfully been installed and is now booting into the new OS
   PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL = 9 [(metalstack.api.v2.enum_string_value) = "Booting New Kernel"];
-  // PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness.
+  // PROVISIONING_EVENT_TYPE_PHONED_HOME is sent periodically by an allocated machine to indicate its liveliness
   PROVISIONING_EVENT_TYPE_PHONED_HOME = 10 [(metalstack.api.v2.enum_string_value) = "Phoned Home"];
-  // PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines.
+  // PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM means the machine was freed and is about to return into the pool of waiting machines
   PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM = 11 [(metalstack.api.v2.enum_string_value) = "Machine Reclaim"];
 }
diff --git a/proto/metalstack/infra/v2/switch.proto b/proto/metalstack/infra/v2/switch.proto
index 476c7a99..c9e90481 100644
--- a/proto/metalstack/infra/v2/switch.proto
+++ b/proto/metalstack/infra/v2/switch.proto
@@ -8,76 +8,76 @@ import "metalstack/api/v2/common.proto";
 import "metalstack/api/v2/predefined_rules.proto";
 import "metalstack/api/v2/switch.proto";
 
-// SwitchService serves switch related functions.
+// SwitchService provides infrastructure switch management operations.
 service SwitchService {
-  // Get a switch by ID.
+  // Returns the switch with the specified ID.
   rpc Get(SwitchServiceGetRequest) returns (SwitchServiceGetResponse) {
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_EDITOR;
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_VIEWER;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // Register a switch.
+  // Registers a switch.
   rpc Register(SwitchServiceRegisterRequest) returns (SwitchServiceRegisterResponse) {
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
-  // Heartbeat a switch.
+  // Heartbeat sends a heartbeat from a switch.
   rpc Heartbeat(SwitchServiceHeartbeatRequest) returns (SwitchServiceHeartbeatResponse) {
     option (metalstack.api.v2.infra_roles) = INFRA_ROLE_EDITOR;
     option (metalstack.api.v2.auditing) = AUDITING_EXCLUDED;
   }
 }
 
-// SwitchServiceGetRequest.
+// SwitchServiceGetRequest is the request payload for getting a switch.
 message SwitchServiceGetRequest {
-  // Id of the switch.
+  // Id of the switch
   string id = 1 [(buf.validate.field).string = {
     hostname: true
     [metalstack.api.v2.is_name]: true
   }];
 }
 
-// SwitchServiceGetResponse.
+// SwitchServiceGetResponse is the response payload for getting a switch.
 message SwitchServiceGetResponse {
-  // Switch that was requested.
+  // Switch contains the requested switch
   metalstack.api.v2.Switch switch = 1;
 }
 
-// SwitchServiceRegisterRequest.
+// SwitchServiceRegisterRequest is the request payload for registering a switch.
 message SwitchServiceRegisterRequest {
-  // Switch to register.
+  // Switch to register
   metalstack.api.v2.Switch switch = 1;
 }
 
-// SwitchServiceRegisterResponse.
+// SwitchServiceRegisterResponse is the response payload for registering a switch.
 message SwitchServiceRegisterResponse {
-  // Switch that was registered.
+  // Switch contains the registered switch
   metalstack.api.v2.Switch switch = 1;
 }
 
-// SwitchServiceHeartbeatRequest.
+// SwitchServiceHeartbeatRequest is the request payload for sending a switch heartbeat.
 message SwitchServiceHeartbeatRequest {
-  // Id of the switch.
+  // Id of the switch
   string id = 1 [(buf.validate.field).string = {
     hostname: true
     [metalstack.api.v2.is_name]: true
   }];
-  // Duration of the sync.
+  // Duration of the sync
   google.protobuf.Duration duration = 2;
-  // Error if any occurred during the sync.
+  // Error if any occurred during the sync
   optional string error = 3;
-  // PortStates maps port identifiers to the respective port's operational state.
+  // PortStates maps port identifiers to the respective port's operational state
   map<string, metalstack.api.v2.SwitchPortStatus> port_states = 4;
-  // BgpPortStates maps port identifiers to the respective port's BGP state.
+  // BgpPortStates maps port identifiers to the respective port's BGP state
   map<string, metalstack.api.v2.SwitchBGPPortState> bgp_port_states = 5;
 }
 
-// SwitchServiceHeartbeatResponse.
+// SwitchServiceHeartbeatResponse is the response payload for sending a switch heartbeat.
 message SwitchServiceHeartbeatResponse {
-  // Id of the switch.
+  // Id of the switch
   string id = 1;
-  // LastSync holds information about the last sync.
+  // LastSync holds information about the last sync
   metalstack.api.v2.SwitchSync last_sync = 2;
-  // LastSyncError holds information about the last erroneous sync.
+  // LastSyncError holds information about the last erroneous sync
   metalstack.api.v2.SwitchSync last_sync_error = 3;
 }
diff --git a/python/metalstack/admin/v2/partition_pb2.py b/python/metalstack/admin/v2/partition_pb2.py
index e71efce7..499519c0 100644
--- a/python/metalstack/admin/v2/partition_pb2.py
+++ b/python/metalstack/admin/v2/partition_pb2.py
@@ -28,7 +28,7 @@
 from metalstack.api.v2 import predefined_rules_pb2 as metalstack_dot_api_dot_v2_dot_predefined__rules__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n#metalstack/admin/v2/partition.proto\x12\x13metalstack.admin.v2\x1a\x1b\x62uf/validate/validate.proto\x1a\x1emetalstack/api/v2/common.proto\x1a!metalstack/api/v2/partition.proto\x1a(metalstack/api/v2/predefined_rules.proto\"[\n\x1dPartitionServiceCreateRequest\x12:\n\tpartition\x18\x01 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\"\xb7\x04\n\x1dPartitionServiceUpdateRequest\x12\x1b\n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\x02id\x12\x46\n\x0bupdate_meta\x18\x02 \x01(\x0b\x32\x1d.metalstack.api.v2.UpdateMetaB\x06\xbaH\x03\xc8\x01\x01R\nupdateMeta\x12\x32\n\x0b\x64\x65scription\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x00R\x0b\x64\x65scription\x88\x01\x01\x12\\\n\x12\x62oot_configuration\x18\x04 \x01(\x0b\x32-.metalstack.api.v2.PartitionBootConfigurationR\x11\x62ootConfiguration\x12G\n\x0b\x64ns_servers\x18\x05 \x03(\x0b\x32\x1c.metalstack.api.v2.DNSServerB\x08\xbaH\x05\x92\x01\x02\x10\x03R\ndnsServers\x12G\n\x0bntp_servers\x18\x06 \x03(\x0b\x32\x1c.metalstack.api.v2.NTPServerB\x08\xbaH\x05\x92\x01\x02\x10\nR\nntpServers\x12\x34\n\x16mgmt_service_addresses\x18\x07 \x03(\tR\x14mgmtServiceAddresses\x12<\n\x06labels\x18\x08 \x01(\x0b\x32\x1f.metalstack.api.v2.UpdateLabelsH\x01R\x06labels\x88\x01\x01\x42\x0e\n\x0c_descriptionB\t\n\x07_labels\"<\n\x1dPartitionServiceDeleteRequest\x12\x1b\n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\x02id\"\\\n\x1ePartitionServiceCreateResponse\x12:\n\tpartition\x18\x01 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\"\\\n\x1ePartitionServiceUpdateResponse\x12:\n\tpartition\x18\x01 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\"\\\n\x1ePartitionServiceDeleteResponse\x12:\n\tpartition\x18\x01 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\"\xae\x01\n\x1fPartitionServiceCapacityRequest\x12 \n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01H\x00R\x02id\x88\x01\x01\x12$\n\x04size\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01H\x01R\x04size\x88\x01\x01\x12\'\n\x07project\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x02R\x07project\x88\x01\x01\x42\x05\n\x03_idB\x07\n\x05_sizeB\n\n\x08_project\"y\n PartitionServiceCapacityResponse\x12U\n\x12partition_capacity\x18\x01 \x03(\x0b\x32&.metalstack.admin.v2.PartitionCapacityR\x11partitionCapacity\"\xa0\x01\n\x11PartitionCapacity\x12)\n\tpartition\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\tpartition\x12`\n\x17machine_size_capacities\x18\x02 \x03(\x0b\x32(.metalstack.admin.v2.MachineSizeCapacityR\x15machineSizeCapacities\"\x83\x04\n\x13MachineSizeCapacity\x12\x1f\n\x04size\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x04size\x12\x14\n\x05total\x18\x03 \x01(\x03R\x05total\x12\x1f\n\x0bphoned_home\x18\x04 \x01(\x03R\nphonedHome\x12\x18\n\x07waiting\x18\x05 \x01(\x03R\x07waiting\x12\x14\n\x05other\x18\x06 \x01(\x03R\x05other\x12%\n\x0eother_machines\x18\x07 \x03(\tR\rotherMachines\x12\x1c\n\tallocated\x18\x08 \x01(\x03R\tallocated\x12 \n\x0b\x61llocatable\x18\t \x01(\x03R\x0b\x61llocatable\x12\x12\n\x04\x66ree\x18\n \x01(\x03R\x04\x66ree\x12 \n\x0bunavailable\x18\x0b \x01(\x03R\x0bunavailable\x12\x16\n\x06\x66\x61ulty\x18\x0c \x01(\x03R\x06\x66\x61ulty\x12\'\n\x0f\x66\x61ulty_machines\x18\r \x03(\tR\x0e\x66\x61ultyMachines\x12\"\n\x0creservations\x18\x0e \x01(\x03R\x0creservations\x12+\n\x11used_reservations\x18\x0f \x01(\x03R\x10usedReservations\x12\x35\n\x16remaining_reservations\x18\x10 \x01(\x03R\x15remainingReservations2\x92\x04\n\x10PartitionService\x12|\n\x06\x43reate\x12\x32.metalstack.admin.v2.PartitionServiceCreateRequest\x1a\x33.metalstack.admin.v2.PartitionServiceCreateResponse\"\t\xd2\xf3\x18\x01\x01\xe0\xf3\x18\x01\x12|\n\x06Update\x12\x32.metalstack.admin.v2.PartitionServiceUpdateRequest\x1a\x33.metalstack.admin.v2.PartitionServiceUpdateResponse\"\t\xd2\xf3\x18\x01\x01\xe0\xf3\x18\x01\x12|\n\x06\x44\x65lete\x12\x32.metalstack.admin.v2.PartitionServiceDeleteRequest\x1a\x33.metalstack.admin.v2.PartitionServiceDeleteResponse\"\t\xd2\xf3\x18\x01\x01\xe0\xf3\x18\x01\x12\x83\x01\n\x08\x43\x61pacity\x12\x34.metalstack.admin.v2.PartitionServiceCapacityRequest\x1a\x35.metalstack.admin.v2.PartitionServiceCapacityResponse\"\n\xd2\xf3\x18\x02\x02\x01\xe0\xf3\x18\x02\x42\xd2\x01\n\x17\x63om.metalstack.admin.v2B\x0ePartitionProtoP\x01Z9github.com/metal-stack/api/go/metalstack/admin/v2;adminv2\xa2\x02\x03MAX\xaa\x02\x13Metalstack.Admin.V2\xca\x02\x13Metalstack\\Admin\\V2\xe2\x02\x1fMetalstack\\Admin\\V2\\GPBMetadata\xea\x02\x15Metalstack::Admin::V2b\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n#metalstack/admin/v2/partition.proto\x12\x13metalstack.admin.v2\x1a\x1b\x62uf/validate/validate.proto\x1a\x1emetalstack/api/v2/common.proto\x1a!metalstack/api/v2/partition.proto\x1a(metalstack/api/v2/predefined_rules.proto\"[\n\x1dPartitionServiceCreateRequest\x12:\n\tpartition\x18\x01 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\"\xc5\x04\n\x1dPartitionServiceUpdateRequest\x12\x1b\n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\x02id\x12\x46\n\x0bupdate_meta\x18\x02 \x01(\x0b\x32\x1d.metalstack.api.v2.UpdateMetaB\x06\xbaH\x03\xc8\x01\x01R\nupdateMeta\x12\x32\n\x0b\x64\x65scription\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x00R\x0b\x64\x65scription\x88\x01\x01\x12\\\n\x12\x62oot_configuration\x18\x04 \x01(\x0b\x32-.metalstack.api.v2.PartitionBootConfigurationR\x11\x62ootConfiguration\x12G\n\x0b\x64ns_servers\x18\x05 \x03(\x0b\x32\x1c.metalstack.api.v2.DNSServerB\x08\xbaH\x05\x92\x01\x02\x10\x03R\ndnsServers\x12G\n\x0bntp_servers\x18\x06 \x03(\x0b\x32\x1c.metalstack.api.v2.NTPServerB\x08\xbaH\x05\x92\x01\x02\x10\nR\nntpServers\x12\x42\n\x16mgmt_service_addresses\x18\x07 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xc8\xa4\xb3\xb1\x02\x01R\x14mgmtServiceAddresses\x12<\n\x06labels\x18\x08 \x01(\x0b\x32\x1f.metalstack.api.v2.UpdateLabelsH\x01R\x06labels\x88\x01\x01\x42\x0e\n\x0c_descriptionB\t\n\x07_labels\"<\n\x1dPartitionServiceDeleteRequest\x12\x1b\n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\x02id\"\\\n\x1ePartitionServiceCreateResponse\x12:\n\tpartition\x18\x01 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\"\\\n\x1ePartitionServiceUpdateResponse\x12:\n\tpartition\x18\x01 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\"\\\n\x1ePartitionServiceDeleteResponse\x12:\n\tpartition\x18\x01 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\"\xae\x01\n\x1fPartitionServiceCapacityRequest\x12 \n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01H\x00R\x02id\x88\x01\x01\x12$\n\x04size\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01H\x01R\x04size\x88\x01\x01\x12\'\n\x07project\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x02R\x07project\x88\x01\x01\x42\x05\n\x03_idB\x07\n\x05_sizeB\n\n\x08_project\"y\n PartitionServiceCapacityResponse\x12U\n\x12partition_capacity\x18\x01 \x03(\x0b\x32&.metalstack.admin.v2.PartitionCapacityR\x11partitionCapacity\"\xa0\x01\n\x11PartitionCapacity\x12)\n\tpartition\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\tpartition\x12`\n\x17machine_size_capacities\x18\x02 \x03(\x0b\x32(.metalstack.admin.v2.MachineSizeCapacityR\x15machineSizeCapacities\"\x83\x04\n\x13MachineSizeCapacity\x12\x1f\n\x04size\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x04size\x12\x14\n\x05total\x18\x03 \x01(\x03R\x05total\x12\x1f\n\x0bphoned_home\x18\x04 \x01(\x03R\nphonedHome\x12\x18\n\x07waiting\x18\x05 \x01(\x03R\x07waiting\x12\x14\n\x05other\x18\x06 \x01(\x03R\x05other\x12%\n\x0eother_machines\x18\x07 \x03(\tR\rotherMachines\x12\x1c\n\tallocated\x18\x08 \x01(\x03R\tallocated\x12 \n\x0b\x61llocatable\x18\t \x01(\x03R\x0b\x61llocatable\x12\x12\n\x04\x66ree\x18\n \x01(\x03R\x04\x66ree\x12 \n\x0bunavailable\x18\x0b \x01(\x03R\x0bunavailable\x12\x16\n\x06\x66\x61ulty\x18\x0c \x01(\x03R\x06\x66\x61ulty\x12\'\n\x0f\x66\x61ulty_machines\x18\r \x03(\tR\x0e\x66\x61ultyMachines\x12\"\n\x0creservations\x18\x0e \x01(\x03R\x0creservations\x12+\n\x11used_reservations\x18\x0f \x01(\x03R\x10usedReservations\x12\x35\n\x16remaining_reservations\x18\x10 \x01(\x03R\x15remainingReservations2\x92\x04\n\x10PartitionService\x12|\n\x06\x43reate\x12\x32.metalstack.admin.v2.PartitionServiceCreateRequest\x1a\x33.metalstack.admin.v2.PartitionServiceCreateResponse\"\t\xd2\xf3\x18\x01\x01\xe0\xf3\x18\x01\x12|\n\x06Update\x12\x32.metalstack.admin.v2.PartitionServiceUpdateRequest\x1a\x33.metalstack.admin.v2.PartitionServiceUpdateResponse\"\t\xd2\xf3\x18\x01\x01\xe0\xf3\x18\x01\x12|\n\x06\x44\x65lete\x12\x32.metalstack.admin.v2.PartitionServiceDeleteRequest\x1a\x33.metalstack.admin.v2.PartitionServiceDeleteResponse\"\t\xd2\xf3\x18\x01\x01\xe0\xf3\x18\x01\x12\x83\x01\n\x08\x43\x61pacity\x12\x34.metalstack.admin.v2.PartitionServiceCapacityRequest\x1a\x35.metalstack.admin.v2.PartitionServiceCapacityResponse\"\n\xd2\xf3\x18\x02\x02\x01\xe0\xf3\x18\x02\x42\xd2\x01\n\x17\x63om.metalstack.admin.v2B\x0ePartitionProtoP\x01Z9github.com/metal-stack/api/go/metalstack/admin/v2;adminv2\xa2\x02\x03MAX\xaa\x02\x13Metalstack.Admin.V2\xca\x02\x13Metalstack\\Admin\\V2\xe2\x02\x1fMetalstack\\Admin\\V2\\GPBMetadata\xea\x02\x15Metalstack::Admin::V2b\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -46,6 +46,8 @@
   _globals['_PARTITIONSERVICEUPDATEREQUEST'].fields_by_name['dns_servers']._serialized_options = b'\272H\005\222\001\002\020\003'
   _globals['_PARTITIONSERVICEUPDATEREQUEST'].fields_by_name['ntp_servers']._loaded_options = None
   _globals['_PARTITIONSERVICEUPDATEREQUEST'].fields_by_name['ntp_servers']._serialized_options = b'\272H\005\222\001\002\020\n'
+  _globals['_PARTITIONSERVICEUPDATEREQUEST'].fields_by_name['mgmt_service_addresses']._loaded_options = None
+  _globals['_PARTITIONSERVICEUPDATEREQUEST'].fields_by_name['mgmt_service_addresses']._serialized_options = b'\272H\t\222\001\006\310\244\263\261\002\001'
   _globals['_PARTITIONSERVICEDELETEREQUEST'].fields_by_name['id']._loaded_options = None
   _globals['_PARTITIONSERVICEDELETEREQUEST'].fields_by_name['id']._serialized_options = b'\272H\010r\006\320\263\256\261\002\001'
   _globals['_PARTITIONSERVICECAPACITYREQUEST'].fields_by_name['id']._loaded_options = None
@@ -69,23 +71,23 @@
   _globals['_PARTITIONSERVICECREATEREQUEST']._serialized_start=198
   _globals['_PARTITIONSERVICECREATEREQUEST']._serialized_end=289
   _globals['_PARTITIONSERVICEUPDATEREQUEST']._serialized_start=292
-  _globals['_PARTITIONSERVICEUPDATEREQUEST']._serialized_end=859
-  _globals['_PARTITIONSERVICEDELETEREQUEST']._serialized_start=861
-  _globals['_PARTITIONSERVICEDELETEREQUEST']._serialized_end=921
-  _globals['_PARTITIONSERVICECREATERESPONSE']._serialized_start=923
-  _globals['_PARTITIONSERVICECREATERESPONSE']._serialized_end=1015
-  _globals['_PARTITIONSERVICEUPDATERESPONSE']._serialized_start=1017
-  _globals['_PARTITIONSERVICEUPDATERESPONSE']._serialized_end=1109
-  _globals['_PARTITIONSERVICEDELETERESPONSE']._serialized_start=1111
-  _globals['_PARTITIONSERVICEDELETERESPONSE']._serialized_end=1203
-  _globals['_PARTITIONSERVICECAPACITYREQUEST']._serialized_start=1206
-  _globals['_PARTITIONSERVICECAPACITYREQUEST']._serialized_end=1380
-  _globals['_PARTITIONSERVICECAPACITYRESPONSE']._serialized_start=1382
-  _globals['_PARTITIONSERVICECAPACITYRESPONSE']._serialized_end=1503
-  _globals['_PARTITIONCAPACITY']._serialized_start=1506
-  _globals['_PARTITIONCAPACITY']._serialized_end=1666
-  _globals['_MACHINESIZECAPACITY']._serialized_start=1669
-  _globals['_MACHINESIZECAPACITY']._serialized_end=2184
-  _globals['_PARTITIONSERVICE']._serialized_start=2187
-  _globals['_PARTITIONSERVICE']._serialized_end=2717
+  _globals['_PARTITIONSERVICEUPDATEREQUEST']._serialized_end=873
+  _globals['_PARTITIONSERVICEDELETEREQUEST']._serialized_start=875
+  _globals['_PARTITIONSERVICEDELETEREQUEST']._serialized_end=935
+  _globals['_PARTITIONSERVICECREATERESPONSE']._serialized_start=937
+  _globals['_PARTITIONSERVICECREATERESPONSE']._serialized_end=1029
+  _globals['_PARTITIONSERVICEUPDATERESPONSE']._serialized_start=1031
+  _globals['_PARTITIONSERVICEUPDATERESPONSE']._serialized_end=1123
+  _globals['_PARTITIONSERVICEDELETERESPONSE']._serialized_start=1125
+  _globals['_PARTITIONSERVICEDELETERESPONSE']._serialized_end=1217
+  _globals['_PARTITIONSERVICECAPACITYREQUEST']._serialized_start=1220
+  _globals['_PARTITIONSERVICECAPACITYREQUEST']._serialized_end=1394
+  _globals['_PARTITIONSERVICECAPACITYRESPONSE']._serialized_start=1396
+  _globals['_PARTITIONSERVICECAPACITYRESPONSE']._serialized_end=1517
+  _globals['_PARTITIONCAPACITY']._serialized_start=1520
+  _globals['_PARTITIONCAPACITY']._serialized_end=1680
+  _globals['_MACHINESIZECAPACITY']._serialized_start=1683
+  _globals['_MACHINESIZECAPACITY']._serialized_end=2198
+  _globals['_PARTITIONSERVICE']._serialized_start=2201
+  _globals['_PARTITIONSERVICE']._serialized_end=2731
 # @@protoc_insertion_point(module_scope)
diff --git a/python/metalstack/api/v2/machine_pb2.py b/python/metalstack/api/v2/machine_pb2.py
index 3d0d24ce..84f15921 100644
--- a/python/metalstack/api/v2/machine_pb2.py
+++ b/python/metalstack/api/v2/machine_pb2.py
@@ -33,7 +33,7 @@
 from metalstack.api.v2 import size_pb2 as metalstack_dot_api_dot_v2_dot_size__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1fmetalstack/api/v2/machine.proto\x12\x11metalstack.api.v2\x1a\x1b\x62uf/validate/validate.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1emetalstack/api/v2/common.proto\x1a\"metalstack/api/v2/filesystem.proto\x1a\x1dmetalstack/api/v2/image.proto\x1a\x1fmetalstack/api/v2/network.proto\x1a!metalstack/api/v2/partition.proto\x1a(metalstack/api/v2/predefined_rules.proto\x1a\x1cmetalstack/api/v2/size.proto\"\\\n\x18MachineServiceGetRequest\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\"\n\x07project\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\"Q\n\x19MachineServiceGetResponse\x12\x34\n\x07machine\x18\x01 \x01(\x0b\x32\x1a.metalstack.api.v2.MachineR\x07machine\"\xd6\x08\n\x1bMachineServiceCreateRequest\x12\"\n\x07project\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\x12!\n\x04uuid\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x00R\x04uuid\x88\x01\x01\x12\x1f\n\x04name\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x04name\x12\x32\n\x0b\x64\x65scription\x18\x04 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x01R\x0b\x64\x65scription\x88\x01\x01\x12(\n\x08hostname\x18\x05 \x01(\tB\x07\xbaH\x04r\x02h\x01H\x02R\x08hostname\x88\x01\x01\x12)\n\tpartition\x18\x06 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\tpartition\x12\x1c\n\x04size\x18\x07 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x04size\x12\x1e\n\x05image\x18\x08 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x05image\x12\x30\n\x11\x66ilesystem_layout\x18\t \x01(\tH\x03R\x10\x66ilesystemLayout\x88\x01\x01\x12?\n\x0fssh_public_keys\x18\n \x03(\tB\x17\xbaH\x14\x92\x01\x11\x10\x32\"\x07r\x05\x10\x01\x18\x80@\xc8\xa4\xb3\xb1\x02\x01R\rsshPublicKeys\x12\x30\n\x08userdata\x18\x0b \x01(\tB\x0f\xbaH\x0cr\n\x18\x80\x80\x02\xf0\xb3\xae\xb1\x02\x01H\x04R\x08userdata\x88\x01\x01\x12\x31\n\x06labels\x18\x0c \x01(\x0b\x32\x19.metalstack.api.v2.LabelsR\x06labels\x12G\n\x08networks\x18\r \x03(\x0b\x32+.metalstack.api.v2.MachineAllocationNetworkR\x08networks\x12\x38\n\x03ips\x18\x0e \x03(\x0b\x32&.metalstack.api.v2.MachineAllocationIpR\x03ips\x12/\n\x0eplacement_tags\x18\x0f \x03(\tB\x08\xbaH\x05\x92\x01\x02\x10@R\rplacementTags\x12G\n\x0b\x64ns_servers\x18\x10 \x03(\x0b\x32\x1c.metalstack.api.v2.DNSServerB\x08\xbaH\x05\x92\x01\x02\x10\x03R\ndnsServers\x12G\n\x0bntp_servers\x18\x11 \x03(\x0b\x32\x1c.metalstack.api.v2.NTPServerB\x08\xbaH\x05\x92\x01\x02\x10\nR\nntpServers\x12[\n\x0f\x61llocation_type\x18\x12 \x01(\x0e\x32(.metalstack.api.v2.MachineAllocationTypeB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x0e\x61llocationType\x12\x44\n\rfirewall_spec\x18\x13 \x01(\x0b\x32\x1f.metalstack.api.v2.FirewallSpecR\x0c\x66irewallSpecB\x07\n\x05_uuidB\x0e\n\x0c_descriptionB\x0b\n\t_hostnameB\x14\n\x12_filesystem_layoutB\x0b\n\t_userdata\"W\n\x0c\x46irewallSpec\x12G\n\x0e\x66irewall_rules\x18\x01 \x01(\x0b\x32 .metalstack.api.v2.FirewallRulesR\rfirewallRules\"T\n\x1cMachineServiceCreateResponse\x12\x34\n\x07machine\x18\x01 \x01(\x0b\x32\x1a.metalstack.api.v2.MachineR\x07machine\"\xf5\x02\n\x1bMachineServiceUpdateRequest\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\x46\n\x0bupdate_meta\x18\x02 \x01(\x0b\x32\x1d.metalstack.api.v2.UpdateMetaB\x06\xbaH\x03\xc8\x01\x01R\nupdateMeta\x12\"\n\x07project\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\x12\x32\n\x0b\x64\x65scription\x18\x04 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x00R\x0b\x64\x65scription\x88\x01\x01\x12<\n\x06labels\x18\x05 \x01(\x0b\x32\x1f.metalstack.api.v2.UpdateLabelsH\x01R\x06labels\x88\x01\x01\x12?\n\x0fssh_public_keys\x18\x06 \x03(\tB\x17\xbaH\x14\x92\x01\x11\x10\x32\"\x07r\x05\x10\x01\x18\x80@\xc8\xa4\xb3\xb1\x02\x01R\rsshPublicKeysB\x0e\n\x0c_descriptionB\t\n\x07_labels\"T\n\x1cMachineServiceUpdateResponse\x12\x34\n\x07machine\x18\x01 \x01(\x0b\x32\x1a.metalstack.api.v2.MachineR\x07machine\"v\n\x19MachineServiceListRequest\x12\"\n\x07project\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\x12\x35\n\x05query\x18\x02 \x01(\x0b\x32\x1f.metalstack.api.v2.MachineQueryR\x05query\"T\n\x1aMachineServiceListResponse\x12\x36\n\x08machines\x18\x01 \x03(\x0b\x32\x1a.metalstack.api.v2.MachineR\x08machines\"_\n\x1bMachineServiceDeleteRequest\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\"\n\x07project\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\"T\n\x1cMachineServiceDeleteResponse\x12\x34\n\x07machine\x18\x01 \x01(\x0b\x32\x1a.metalstack.api.v2.MachineR\x07machine\"\xad\x01\n\x1fMachineServiceBMCCommandRequest\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\"\n\x07project\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\x12H\n\x07\x63ommand\x18\x03 \x01(\x0e\x32$.metalstack.api.v2.MachineBMCCommandB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x07\x63ommand\"\"\n MachineServiceBMCCommandResponse\"_\n\x1bMachineServiceGetBMCRequest\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\"\n\x07project\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\"s\n\x1cMachineServiceGetBMCResponse\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\x35\n\x03\x62mc\x18\x02 \x01(\x0b\x32#.metalstack.api.v2.MachineBMCReportR\x03\x62mc\"\x8d\x04\n\x07Machine\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12+\n\x04meta\x18\x02 \x01(\x0b\x32\x17.metalstack.api.v2.MetaR\x04meta\x12:\n\tpartition\x18\x03 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\x12\x1c\n\x04rack\x18\x04 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x04rack\x12+\n\x04size\x18\x05 \x01(\x0b\x32\x17.metalstack.api.v2.SizeR\x04size\x12>\n\x08hardware\x18\x06 \x01(\x0b\x32\".metalstack.api.v2.MachineHardwareR\x08hardware\x12\x44\n\nallocation\x18\x07 \x01(\x0b\x32$.metalstack.api.v2.MachineAllocationR\nallocation\x12\x38\n\x06status\x18\x08 \x01(\x0b\x32 .metalstack.api.v2.MachineStatusR\x06status\x12p\n\x1arecent_provisioning_events\x18\t \x01(\x0b\x32\x32.metalstack.api.v2.MachineRecentProvisioningEventsR\x18recentProvisioningEvents\"\xa4\x02\n\rMachineStatus\x12\x41\n\tcondition\x18\x01 \x01(\x0b\x32#.metalstack.api.v2.MachineConditionR\tcondition\x12N\n\tled_state\x18\x02 \x01(\x0b\x32\x31.metalstack.api.v2.MachineChassisIdentifyLEDStateR\x08ledState\x12N\n\nliveliness\x18\x03 \x01(\x0e\x32$.metalstack.api.v2.MachineLivelinessB\x08\xbaH\x05\x82\x01\x02\x10\x01R\nliveliness\x12\x30\n\x14metal_hammer_version\x18\x04 \x01(\tR\x12metalHammerVersion\"\xa4\x01\n\x10MachineCondition\x12?\n\x05state\x18\x01 \x01(\x0e\x32\x1f.metalstack.api.v2.MachineStateB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x05state\x12-\n\x0b\x64\x65scription\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x0b\x64\x65scription\x12 \n\x06issuer\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x02R\x06issuer\"\xb8\x07\n\x11MachineAllocation\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12+\n\x04meta\x18\x02 \x01(\x0b\x32\x17.metalstack.api.v2.MetaR\x04meta\x12\x1f\n\x04name\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x04name\x12-\n\x0b\x64\x65scription\x18\x04 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x0b\x64\x65scription\x12\'\n\ncreated_by\x18\x05 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\tcreatedBy\x12\"\n\x07project\x18\x06 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\x12.\n\x05image\x18\x07 \x01(\x0b\x32\x18.metalstack.api.v2.ImageR\x05image\x12P\n\x11\x66ilesystem_layout\x18\x08 \x01(\x0b\x32#.metalstack.api.v2.FilesystemLayoutR\x10\x66ilesystemLayout\x12=\n\x08networks\x18\t \x03(\x0b\x32!.metalstack.api.v2.MachineNetworkR\x08networks\x12#\n\x08hostname\x18\n \x01(\tB\x07\xbaH\x04r\x02h\x01R\x08hostname\x12?\n\x0fssh_public_keys\x18\x0b \x03(\tB\x17\xbaH\x14\x92\x01\x11\x10\x32\"\x07r\x05\x10\x01\x18\x80@\xc8\xa4\xb3\xb1\x02\x01R\rsshPublicKeys\x12+\n\x08userdata\x18\x0c \x01(\tB\x0f\xbaH\x0cr\n\x18\x80\x80\x02\xf0\xb3\xae\xb1\x02\x01R\x08userdata\x12[\n\x0f\x61llocation_type\x18\r \x01(\x0e\x32(.metalstack.api.v2.MachineAllocationTypeB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x0e\x61llocationType\x12G\n\x0e\x66irewall_rules\x18\x0e \x01(\x0b\x32 .metalstack.api.v2.FirewallRulesR\rfirewallRules\x12G\n\x0b\x64ns_servers\x18\x0f \x03(\x0b\x32\x1c.metalstack.api.v2.DNSServerB\x08\xbaH\x05\x92\x01\x02\x10\x03R\ndnsServers\x12G\n\x0bntp_servers\x18\x10 \x03(\x0b\x32\x1c.metalstack.api.v2.NTPServerB\x08\xbaH\x05\x92\x01\x02\x10\nR\nntpServers\x12/\n\x03vpn\x18\x11 \x01(\x0b\x32\x1d.metalstack.api.v2.MachineVPNR\x03vpn\"\x8a\x01\n\x18MachineAllocationNetwork\x12%\n\x07network\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x07network\x12\x30\n\x12no_auto_acquire_ip\x18\x02 \x01(\x08H\x00R\x0fnoAutoAcquireIp\x88\x01\x01\x42\x15\n\x13_no_auto_acquire_ip\"i\n\x13MachineAllocationIp\x12\x17\n\x02ip\x18\x01 \x01(\tB\x07\xbaH\x04r\x02p\x01R\x02ip\x12+\n\tnamespace\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x00R\tnamespace\x88\x01\x01\x42\x0c\n\n_namespace\"\x90\x01\n\rFirewallRules\x12=\n\x06\x65gress\x18\x01 \x03(\x0b\x32%.metalstack.api.v2.FirewallEgressRuleR\x06\x65gress\x12@\n\x07ingress\x18\x02 \x03(\x0b\x32&.metalstack.api.v2.FirewallIngressRuleR\x07ingress\"\xd0\x01\n\x12\x46irewallEgressRule\x12\x43\n\x08protocol\x18\x01 \x01(\x0e\x32\x1d.metalstack.api.v2.IPProtocolB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x08protocol\x12$\n\x05ports\x18\x02 \x03(\rB\x0e\xbaH\x0b\x92\x01\x08\"\x06*\x04\x18\xfc\xff\x03R\x05ports\x12\x1c\n\x02to\x18\x03 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x02to\x12\x31\n\x07\x63omment\x18\x04 \x01(\tB\x17\xbaH\x14r\x0f\x18\x64\x32\x0b^[a-z_ -]*$\xd8\x01\x01R\x07\x63omment\"\xf3\x01\n\x13\x46irewallIngressRule\x12\x43\n\x08protocol\x18\x01 \x01(\x0e\x32\x1d.metalstack.api.v2.IPProtocolB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x08protocol\x12$\n\x05ports\x18\x02 \x03(\rB\x0e\xbaH\x0b\x92\x01\x08\"\x06*\x04\x18\xfc\xff\x03R\x05ports\x12\x1c\n\x02to\x18\x03 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x02to\x12 \n\x04\x66rom\x18\x04 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x04\x66rom\x12\x31\n\x07\x63omment\x18\x05 \x01(\tB\x17\xbaH\x14r\x0f\x18\x64\x32\x0b^[a-z_ -]*$\xd8\x01\x01R\x07\x63omment\"\x9c\x03\n\x0eMachineNetwork\x12\x18\n\x07network\x18\x01 \x01(\tR\x07network\x12(\n\x08prefixes\x18\x02 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x08prefixes\x12?\n\x14\x64\x65stination_prefixes\x18\x03 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x13\x64\x65stinationPrefixes\x12\x1e\n\x03ips\x18\x04 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xc0\xa4\xb3\xb1\x02\x01R\x03ips\x12K\n\x0cnetwork_type\x18\x05 \x01(\x0e\x32\x1e.metalstack.api.v2.NetworkTypeB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x0bnetworkType\x12?\n\x08nat_type\x18\x06 \x01(\x0e\x32\x1a.metalstack.api.v2.NATTypeB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x07natType\x12\x10\n\x03vrf\x18\x07 \x01(\x04R\x03vrf\x12\x10\n\x03\x61sn\x18\x08 \x01(\rR\x03\x61sn\x12\'\n\x07project\x18\t \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x00R\x07project\x88\x01\x01\x42\n\n\x08_project\"\xfb\x01\n\x0fMachineHardware\x12\x16\n\x06memory\x18\x01 \x01(\x04R\x06memory\x12;\n\x05\x64isks\x18\x02 \x03(\x0b\x32%.metalstack.api.v2.MachineBlockDeviceR\x05\x64isks\x12/\n\x04\x63pus\x18\x03 \x03(\x0b\x32\x1b.metalstack.api.v2.MetalCPUR\x04\x63pus\x12/\n\x04gpus\x18\x04 \x03(\x0b\x32\x1b.metalstack.api.v2.MetalGPUR\x04gpus\x12\x31\n\x04nics\x18\x05 \x03(\x0b\x32\x1d.metalstack.api.v2.MachineNicR\x04nics\"|\n\x08MetalCPU\x12 \n\x06vendor\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x02R\x06vendor\x12\x1e\n\x05model\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x02R\x05model\x12\x14\n\x05\x63ores\x18\x03 \x01(\rR\x05\x63ores\x12\x18\n\x07threads\x18\x04 \x01(\rR\x07threads\"L\n\x08MetalGPU\x12 \n\x06vendor\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x02R\x06vendor\x12\x1e\n\x05model\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x02R\x05model\"\xa7\x02\n\nMachineNic\x12\x1d\n\x03mac\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xb8\xb3\xae\xb1\x02\x01R\x03mac\x12\x1f\n\x04name\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x04name\x12(\n\nidentifier\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\nidentifier\x12 \n\x06vendor\x18\x04 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x06vendor\x12\x1e\n\x05model\x18\x05 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x05model\x12\x14\n\x05speed\x18\x06 \x01(\x04R\x05speed\x12;\n\tneighbors\x18\x07 \x03(\x0b\x32\x1d.metalstack.api.v2.MachineNicR\tneighbors\x12\x1a\n\x08hostname\x18\x08 \x01(\tR\x08hostname\"I\n\x12MachineBlockDevice\x12\x1f\n\x04name\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x04name\x12\x12\n\x04size\x18\x02 \x01(\x04R\x04size\"o\n\x1eMachineChassisIdentifyLEDState\x12\x1e\n\x05value\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x05value\x12-\n\x0b\x64\x65scription\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x0b\x64\x65scription\"\xcb\x03\n\x10MachineBMCReport\x12/\n\x03\x62mc\x18\x01 \x01(\x0b\x32\x1d.metalstack.api.v2.MachineBMCR\x03\x62mc\x12\x32\n\x04\x62ios\x18\x02 \x01(\x0b\x32\x1e.metalstack.api.v2.MachineBiosR\x04\x62ios\x12/\n\x03\x66ru\x18\x03 \x01(\x0b\x32\x1d.metalstack.api.v2.MachineFRUR\x03\x66ru\x12H\n\x0cpower_metric\x18\x04 \x01(\x0b\x32%.metalstack.api.v2.MachinePowerMetricR\x0bpowerMetric\x12L\n\x0epower_supplies\x18\x05 \x03(\x0b\x32%.metalstack.api.v2.MachinePowerSupplyR\rpowerSupplies\x12N\n\tled_state\x18\x06 \x01(\x0b\x32\x31.metalstack.api.v2.MachineChassisIdentifyLEDStateR\x08ledState\x12\x39\n\nupdated_at\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\tupdatedAt\"z\n\x0bMachineBios\x12%\n\x07version\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x07version\x12#\n\x06vendor\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x06vendor\x12\x1f\n\x04\x64\x61te\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x04\x64\x61te\"\x99\x02\n\nMachineBMC\x12\"\n\x07\x61\x64\x64ress\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\x80\x02\x01R\x07\x61\x64\x64ress\x12\x1d\n\x03mac\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xb8\xb3\xae\xb1\x02\x01R\x03mac\x12\x1f\n\x04user\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x04user\x12\'\n\x08password\x18\x04 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x08password\x12)\n\tinterface\x18\x05 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\tinterface\x12%\n\x07version\x18\x06 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x07version\x12,\n\x0bpower_state\x18\x07 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\npowerState\"\xa6\x05\n\nMachineFRU\x12@\n\x13\x63hassis_part_number\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x00R\x11\x63hassisPartNumber\x88\x01\x01\x12@\n\x13\x63hassis_part_serial\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x01R\x11\x63hassisPartSerial\x88\x01\x01\x12-\n\tboard_mfg\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x02R\x08\x62oardMfg\x88\x01\x01\x12:\n\x10\x62oard_mfg_serial\x18\x04 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x03R\x0e\x62oardMfgSerial\x88\x01\x01\x12<\n\x11\x62oard_part_number\x18\x05 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x04R\x0f\x62oardPartNumber\x88\x01\x01\x12\x43\n\x14product_manufacturer\x18\x06 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x05R\x13productManufacturer\x88\x01\x01\x12@\n\x13product_part_number\x18\x07 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x06R\x11productPartNumber\x88\x01\x01\x12\x37\n\x0eproduct_serial\x18\x08 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x07R\rproductSerial\x88\x01\x01\x42\x16\n\x14_chassis_part_numberB\x16\n\x14_chassis_part_serialB\x0c\n\n_board_mfgB\x13\n\x11_board_mfg_serialB\x14\n\x12_board_part_numberB\x17\n\x15_product_manufacturerB\x16\n\x14_product_part_numberB\x11\n\x0f_product_serial\"\xce\x01\n\x12MachinePowerMetric\x12\x34\n\x16\x61verage_consumed_watts\x18\x01 \x01(\x02R\x14\x61verageConsumedWatts\x12&\n\x0finterval_in_min\x18\x02 \x01(\x02R\rintervalInMin\x12,\n\x12max_consumed_watts\x18\x03 \x01(\x02R\x10maxConsumedWatts\x12,\n\x12min_consumed_watts\x18\x04 \x01(\x02R\x10minConsumedWatts\"B\n\x12MachinePowerSupply\x12\x16\n\x06health\x18\x01 \x01(\tR\x06health\x12\x14\n\x05state\x18\x02 \x01(\tR\x05state\"\xd3\x02\n\x1fMachineRecentProvisioningEvents\x12\x43\n\x06\x65vents\x18\x01 \x03(\x0b\x32+.metalstack.api.v2.MachineProvisioningEventR\x06\x65vents\x12\x42\n\x0flast_event_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\rlastEventTime\x12U\n\x10last_error_event\x18\x03 \x01(\x0b\x32+.metalstack.api.v2.MachineProvisioningEventR\x0elastErrorEvent\x12P\n\x05state\x18\x04 \x01(\x0e\x32\x30.metalstack.api.v2.MachineProvisioningEventStateB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x05state\"\xab\x01\n\x18MachineProvisioningEvent\x12.\n\x04time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\x04time\x12\x45\n\x05\x65vent\x18\x02 \x01(\x0e\x32/.metalstack.api.v2.MachineProvisioningEventTypeR\x05\x65vent\x12\x18\n\x07message\x18\x03 \x01(\tR\x07message\"\x99\x01\n\nMachineVPN\x12\x32\n\x15\x63ontrol_plane_address\x18\x01 \x01(\tR\x13\x63ontrolPlaneAddress\x12\x19\n\x08\x61uth_key\x18\x02 \x01(\tR\x07\x61uthKey\x12\x1c\n\tconnected\x18\x03 \x01(\x08R\tconnected\x12\x1e\n\x03ips\x18\x04 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xc0\xa4\xb3\xb1\x02\x01R\x03ips\"\xc5\x08\n\x0cMachineQuery\x12!\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x00R\x04uuid\x88\x01\x01\x12$\n\x04name\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01H\x01R\x04name\x88\x01\x01\x12-\n\tpartition\x18\x03 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x02R\tpartition\x88\x01\x01\x12#\n\x04size\x18\x04 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x03R\x04size\x88\x01\x01\x12#\n\x04rack\x18\x05 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x04R\x04rack\x88\x01\x01\x12\x36\n\x06labels\x18\x06 \x01(\x0b\x32\x19.metalstack.api.v2.LabelsH\x05R\x06labels\x88\x01\x01\x12N\n\nallocation\x18\x07 \x01(\x0b\x32).metalstack.api.v2.MachineAllocationQueryH\x06R\nallocation\x88\x01\x01\x12\x45\n\x07network\x18\x08 \x01(\x0b\x32&.metalstack.api.v2.MachineNetworkQueryH\x07R\x07network\x88\x01\x01\x12\x39\n\x03nic\x18\t \x01(\x0b\x32\".metalstack.api.v2.MachineNicQueryH\x08R\x03nic\x88\x01\x01\x12<\n\x04\x64isk\x18\n \x01(\x0b\x32#.metalstack.api.v2.MachineDiskQueryH\tR\x04\x64isk\x88\x01\x01\x12\x39\n\x03\x62mc\x18\x0b \x01(\x0b\x32\".metalstack.api.v2.MachineBMCQueryH\nR\x03\x62mc\x88\x01\x01\x12\x39\n\x03\x66ru\x18\x0c \x01(\x0b\x32\".metalstack.api.v2.MachineFRUQueryH\x0bR\x03\x66ru\x88\x01\x01\x12H\n\x08hardware\x18\r \x01(\x0b\x32\'.metalstack.api.v2.MachineHardwareQueryH\x0cR\x08hardware\x88\x01\x01\x12:\n\x05state\x18\x0e \x01(\x0e\x32\x1f.metalstack.api.v2.MachineStateH\rR\x05state\x88\x01\x01\x12\x1d\n\x07waiting\x18\x0f \x01(\x08H\x0eR\x07waiting\x88\x01\x01\x12\'\n\x0cpreallocated\x18\x10 \x01(\x08H\x0fR\x0cpreallocated\x88\x01\x01\x12(\n\rnot_allocated\x18\x11 \x01(\x08H\x10R\x0cnotAllocated\x88\x01\x01\x42\x07\n\x05_uuidB\x07\n\x05_nameB\x0c\n\n_partitionB\x07\n\x05_sizeB\x07\n\x05_rackB\t\n\x07_labelsB\r\n\x0b_allocationB\n\n\x08_networkB\x06\n\x04_nicB\x07\n\x05_diskB\x06\n\x04_bmcB\x06\n\x04_fruB\x0b\n\t_hardwareB\x08\n\x06_stateB\n\n\x08_waitingB\x0f\n\r_preallocatedB\x10\n\x0e_not_allocated\"\xde\x04\n\x16MachineAllocationQuery\x12!\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x00R\x04uuid\x88\x01\x01\x12$\n\x04name\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01H\x01R\x04name\x88\x01\x01\x12\'\n\x07project\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x02R\x07project\x88\x01\x01\x12%\n\x05image\x18\x04 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x03R\x05image\x88\x01\x01\x12<\n\x11\x66ilesystem_layout\x18\x05 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x04R\x10\x66ilesystemLayout\x88\x01\x01\x12+\n\x08hostname\x18\x06 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x05R\x08hostname\x88\x01\x01\x12`\n\x0f\x61llocation_type\x18\x07 \x01(\x0e\x32(.metalstack.api.v2.MachineAllocationTypeB\x08\xbaH\x05\x82\x01\x02\x10\x01H\x06R\x0e\x61llocationType\x88\x01\x01\x12\x36\n\x06labels\x18\x08 \x01(\x0b\x32\x19.metalstack.api.v2.LabelsH\x07R\x06labels\x88\x01\x01\x12\x34\n\x03vpn\x18\t \x01(\x0b\x32\x1d.metalstack.api.v2.MachineVPNH\x08R\x03vpn\x88\x01\x01\x42\x07\n\x05_uuidB\x07\n\x05_nameB\n\n\x08_projectB\x08\n\x06_imageB\x14\n\x12_filesystem_layoutB\x0b\n\t_hostnameB\x12\n\x10_allocation_typeB\t\n\x07_labelsB\x06\n\x04_vpn\"\xe4\x01\n\x13MachineNetworkQuery\x12\x1a\n\x08networks\x18\x01 \x03(\tR\x08networks\x12(\n\x08prefixes\x18\x02 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x08prefixes\x12?\n\x14\x64\x65stination_prefixes\x18\x03 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x13\x64\x65stinationPrefixes\x12\x1e\n\x03ips\x18\x04 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xc0\xa4\xb3\xb1\x02\x01R\x03ips\x12\x12\n\x04vrfs\x18\x05 \x03(\x04R\x04vrfs\x12\x12\n\x04\x61sns\x18\x06 \x03(\rR\x04\x61sns\"\xd9\x01\n\x0fMachineNicQuery\x12(\n\x04macs\x18\x01 \x03(\tB\x14\xbaH\x11\x92\x01\x0e\x10\x64\x18\x01\"\x08r\x06\xb8\xb3\xae\xb1\x02\x01R\x04macs\x12\'\n\x05names\x18\x02 \x03(\tB\x11\xbaH\x0e\x92\x01\x0b\x10\x64\x18\x01\"\x05r\x03\x18\x80\x01R\x05names\x12\x39\n\rneighbor_macs\x18\x03 \x03(\tB\x14\xbaH\x11\x92\x01\x0e\x10\x64\x18\x01\"\x08r\x06\xb8\xb3\xae\xb1\x02\x01R\x0cneighborMacs\x12\x38\n\x0eneighbor_names\x18\x04 \x03(\tB\x11\xbaH\x0e\x92\x01\x0b\x10\x64\x18\x01\"\x05r\x03\x18\x80\x01R\rneighborNames\"Y\n\x10MachineDiskQuery\x12%\n\x05names\x18\x01 \x03(\tB\x0f\xbaH\x0c\x92\x01\t\x10\x64\"\x05r\x03\x18\x80\x01R\x05names\x12\x1e\n\x05sizes\x18\x02 \x03(\x04\x42\x08\xbaH\x05\x92\x01\x02\x10\x64R\x05sizes\"\xd8\x01\n\x0fMachineBMCQuery\x12&\n\x07\x61\x64\x64ress\x18\x01 \x01(\tB\x07\xbaH\x04r\x02p\x01H\x00R\x07\x61\x64\x64ress\x88\x01\x01\x12\"\n\x03mac\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xb8\xb3\xae\xb1\x02\x01H\x01R\x03mac\x88\x01\x01\x12!\n\x04user\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x02R\x04user\x88\x01\x01\x12+\n\tinterface\x18\x04 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x03R\tinterface\x88\x01\x01\x42\n\n\x08_addressB\x06\n\x04_macB\x07\n\x05_userB\x0c\n\n_interface\"\x88\x05\n\x0fMachineFRUQuery\x12=\n\x13\x63hassis_part_number\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x00R\x11\x63hassisPartNumber\x88\x01\x01\x12=\n\x13\x63hassis_part_serial\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x01R\x11\x63hassisPartSerial\x88\x01\x01\x12*\n\tboard_mfg\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x02R\x08\x62oardMfg\x88\x01\x01\x12\x30\n\x0c\x62oard_serial\x18\x04 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x03R\x0b\x62oardSerial\x88\x01\x01\x12\x39\n\x11\x62oard_part_number\x18\x05 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x04R\x0f\x62oardPartNumber\x88\x01\x01\x12@\n\x14product_manufacturer\x18\x06 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x05R\x13productManufacturer\x88\x01\x01\x12=\n\x13product_part_number\x18\x07 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x06R\x11productPartNumber\x88\x01\x01\x12\x34\n\x0eproduct_serial\x18\x08 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x07R\rproductSerial\x88\x01\x01\x42\x16\n\x14_chassis_part_numberB\x16\n\x14_chassis_part_serialB\x0c\n\n_board_mfgB\x0f\n\r_board_serialB\x14\n\x12_board_part_numberB\x17\n\x15_product_manufacturerB\x16\n\x14_product_part_numberB\x11\n\x0f_product_serial\"n\n\x14MachineHardwareQuery\x12\x1b\n\x06memory\x18\x01 \x01(\x04H\x00R\x06memory\x88\x01\x01\x12 \n\tcpu_cores\x18\x02 \x01(\rH\x01R\x08\x63puCores\x88\x01\x01\x42\t\n\x07_memoryB\x0c\n\n_cpu_cores*e\n\nIPProtocol\x12\x1b\n\x17IP_PROTOCOL_UNSPECIFIED\x10\x00\x12\x1c\n\x0fIP_PROTOCOL_TCP\x10\x01\x1a\x07\x82\xb2\x19\x03tcp\x12\x1c\n\x0fIP_PROTOCOL_UDP\x10\x02\x1a\x07\x82\xb2\x19\x03udp*\xaf\x01\n\x0cMachineState\x12#\n\x19MACHINE_STATE_UNSPECIFIED\x10\x00\x1a\x04\x82\xb2\x19\x00\x12(\n\x16MACHINE_STATE_RESERVED\x10\x01\x1a\x0c\x82\xb2\x19\x08reserved\x12$\n\x14MACHINE_STATE_LOCKED\x10\x02\x1a\n\x82\xb2\x19\x06locked\x12*\n\x17MACHINE_STATE_AVAILABLE\x10\x03\x1a\r\x82\xb2\x19\tavailable*\xdf\x01\n\x1dMachineProvisioningEventState\x12\x36\n,MACHINE_PROVISIONING_EVENT_STATE_UNSPECIFIED\x10\x00\x1a\x04\x82\xb2\x19\x00\x12=\n*MACHINE_PROVISIONING_EVENT_STATE_CRASHLOOP\x10\x01\x1a\r\x82\xb2\x19\tcrashloop\x12G\n/MACHINE_PROVISIONING_EVENT_STATE_FAILED_RECLAIM\x10\x02\x1a\x12\x82\xb2\x19\x0e\x66\x61iled-reclaim*\x9f\x06\n\x1cMachineProvisioningEventType\x12/\n+MACHINE_PROVISIONING_EVENT_TYPE_UNSPECIFIED\x10\x00\x12\x34\n%MACHINE_PROVISIONING_EVENT_TYPE_ALIVE\x10\x01\x1a\t\x82\xb2\x19\x05\x41live\x12\x38\n\'MACHINE_PROVISIONING_EVENT_TYPE_CRASHED\x10\x02\x1a\x0b\x82\xb2\x19\x07\x43rashed\x12@\n+MACHINE_PROVISIONING_EVENT_TYPE_PXE_BOOTING\x10\x03\x1a\x0f\x82\xb2\x19\x0bPXE Booting\x12\x46\n.MACHINE_PROVISIONING_EVENT_TYPE_PLANNED_REBOOT\x10\x04\x1a\x12\x82\xb2\x19\x0ePlanned Reboot\x12<\n)MACHINE_PROVISIONING_EVENT_TYPE_PREPARING\x10\x05\x1a\r\x82\xb2\x19\tPreparing\x12@\n+MACHINE_PROVISIONING_EVENT_TYPE_REGISTERING\x10\x06\x1a\x0f\x82\xb2\x19\x0bRegistering\x12\x38\n\'MACHINE_PROVISIONING_EVENT_TYPE_WAITING\x10\x07\x1a\x0b\x82\xb2\x19\x07Waiting\x12>\n*MACHINE_PROVISIONING_EVENT_TYPE_INSTALLING\x10\x08\x1a\x0e\x82\xb2\x19\nInstalling\x12N\n2MACHINE_PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL\x10\t\x1a\x16\x82\xb2\x19\x12\x42ooting New Kernel\x12@\n+MACHINE_PROVISIONING_EVENT_TYPE_PHONED_HOME\x10\n\x1a\x0f\x82\xb2\x19\x0bPhoned Home\x12H\n/MACHINE_PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM\x10\x0b\x1a\x13\x82\xb2\x19\x0fMachine Reclaim*\xba\x01\n\x11MachineLiveliness\x12(\n\x1eMACHINE_LIVELINESS_UNSPECIFIED\x10\x00\x1a\x04\x82\xb2\x19\x00\x12\'\n\x18MACHINE_LIVELINESS_ALIVE\x10\x01\x1a\t\x82\xb2\x19\x05\x61live\x12%\n\x17MACHINE_LIVELINESS_DEAD\x10\x02\x1a\x08\x82\xb2\x19\x04\x64\x65\x61\x64\x12+\n\x1aMACHINE_LIVELINESS_UNKNOWN\x10\x03\x1a\x0b\x82\xb2\x19\x07unknown*\xac\x01\n\x15MachineAllocationType\x12-\n#MACHINE_ALLOCATION_TYPE_UNSPECIFIED\x10\x00\x1a\x04\x82\xb2\x19\x00\x12\x30\n\x1fMACHINE_ALLOCATION_TYPE_MACHINE\x10\x01\x1a\x0b\x82\xb2\x19\x07machine\x12\x32\n MACHINE_ALLOCATION_TYPE_FIREWALL\x10\x02\x1a\x0c\x82\xb2\x19\x08\x66irewall*\xfe\x04\n\x11MachineBMCCommand\x12#\n\x1fMACHINE_BMC_COMMAND_UNSPECIFIED\x10\x00\x12\"\n\x16MACHINE_BMC_COMMAND_ON\x10\x01\x1a\x06\x82\xb2\x19\x02on\x12$\n\x17MACHINE_BMC_COMMAND_OFF\x10\x02\x1a\x07\x82\xb2\x19\x03off\x12(\n\x19MACHINE_BMC_COMMAND_RESET\x10\x03\x1a\t\x82\xb2\x19\x05reset\x12(\n\x19MACHINE_BMC_COMMAND_CYCLE\x10\x04\x1a\t\x82\xb2\x19\x05\x63ycle\x12\x36\n MACHINE_BMC_COMMAND_BOOT_TO_BIOS\x10\x05\x1a\x10\x82\xb2\x19\x0c\x62oot-to-bios\x12:\n\"MACHINE_BMC_COMMAND_BOOT_FROM_DISK\x10\x06\x1a\x12\x82\xb2\x19\x0e\x62oot-from-disk\x12\x38\n!MACHINE_BMC_COMMAND_BOOT_FROM_PXE\x10\x07\x1a\x11\x82\xb2\x19\rboot-from-pxe\x12<\n#MACHINE_BMC_COMMAND_IDENTIFY_LED_ON\x10\x08\x1a\x13\x82\xb2\x19\x0fidentify-led-on\x12>\n$MACHINE_BMC_COMMAND_IDENTIFY_LED_OFF\x10\t\x1a\x14\x82\xb2\x19\x10identify-led-off\x12<\n#MACHINE_BMC_COMMAND_MACHINE_DELETED\x10\n\x1a\x13\x82\xb2\x19\x0fmachine-deleted\x12<\n#MACHINE_BMC_COMMAND_MACHINE_CREATED\x10\x0b\x1a\x13\x82\xb2\x19\x0fmachine-created2\xbc\x06\n\x0eMachineService\x12m\n\x03Get\x12+.metalstack.api.v2.MachineServiceGetRequest\x1a,.metalstack.api.v2.MachineServiceGetResponse\"\x0b\xca\xf3\x18\x03\x01\x02\x03\xe0\xf3\x18\x02\x12q\n\x06\x43reate\x12..metalstack.api.v2.MachineServiceCreateRequest\x1a/.metalstack.api.v2.MachineServiceCreateResponse\"\x06\xca\xf3\x18\x02\x01\x02\x12q\n\x06Update\x12..metalstack.api.v2.MachineServiceUpdateRequest\x1a/.metalstack.api.v2.MachineServiceUpdateResponse\"\x06\xca\xf3\x18\x02\x01\x02\x12p\n\x04List\x12,.metalstack.api.v2.MachineServiceListRequest\x1a-.metalstack.api.v2.MachineServiceListResponse\"\x0b\xca\xf3\x18\x03\x01\x02\x03\xe0\xf3\x18\x02\x12q\n\x06\x44\x65lete\x12..metalstack.api.v2.MachineServiceDeleteRequest\x1a/.metalstack.api.v2.MachineServiceDeleteResponse\"\x06\xca\xf3\x18\x02\x01\x02\x12}\n\nBMCCommand\x12\x32.metalstack.api.v2.MachineServiceBMCCommandRequest\x1a\x33.metalstack.api.v2.MachineServiceBMCCommandResponse\"\x06\xca\xf3\x18\x02\x01\x02\x12q\n\x06GetBMC\x12..metalstack.api.v2.MachineServiceGetBMCRequest\x1a/.metalstack.api.v2.MachineServiceGetBMCResponse\"\x06\xca\xf3\x18\x02\x01\x02\x42\xc2\x01\n\x15\x63om.metalstack.api.v2B\x0cMachineProtoP\x01Z5github.com/metal-stack/api/go/metalstack/api/v2;apiv2\xa2\x02\x03MAX\xaa\x02\x11Metalstack.Api.V2\xca\x02\x11Metalstack\\Api\\V2\xe2\x02\x1dMetalstack\\Api\\V2\\GPBMetadata\xea\x02\x13Metalstack::Api::V2b\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1fmetalstack/api/v2/machine.proto\x12\x11metalstack.api.v2\x1a\x1b\x62uf/validate/validate.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1emetalstack/api/v2/common.proto\x1a\"metalstack/api/v2/filesystem.proto\x1a\x1dmetalstack/api/v2/image.proto\x1a\x1fmetalstack/api/v2/network.proto\x1a!metalstack/api/v2/partition.proto\x1a(metalstack/api/v2/predefined_rules.proto\x1a\x1cmetalstack/api/v2/size.proto\"\\\n\x18MachineServiceGetRequest\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\"\n\x07project\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\"Q\n\x19MachineServiceGetResponse\x12\x34\n\x07machine\x18\x01 \x01(\x0b\x32\x1a.metalstack.api.v2.MachineR\x07machine\"\xd6\x08\n\x1bMachineServiceCreateRequest\x12\"\n\x07project\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\x12!\n\x04uuid\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x00R\x04uuid\x88\x01\x01\x12\x1f\n\x04name\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x04name\x12\x32\n\x0b\x64\x65scription\x18\x04 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x01R\x0b\x64\x65scription\x88\x01\x01\x12(\n\x08hostname\x18\x05 \x01(\tB\x07\xbaH\x04r\x02h\x01H\x02R\x08hostname\x88\x01\x01\x12)\n\tpartition\x18\x06 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\tpartition\x12\x1c\n\x04size\x18\x07 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x04size\x12\x1e\n\x05image\x18\x08 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x05image\x12\x30\n\x11\x66ilesystem_layout\x18\t \x01(\tH\x03R\x10\x66ilesystemLayout\x88\x01\x01\x12?\n\x0fssh_public_keys\x18\n \x03(\tB\x17\xbaH\x14\x92\x01\x11\x10\x32\"\x07r\x05\x10\x01\x18\x80@\xd0\xa4\xb3\xb1\x02\x01R\rsshPublicKeys\x12\x30\n\x08userdata\x18\x0b \x01(\tB\x0f\xbaH\x0cr\n\x18\x80\x80\x02\xf0\xb3\xae\xb1\x02\x01H\x04R\x08userdata\x88\x01\x01\x12\x31\n\x06labels\x18\x0c \x01(\x0b\x32\x19.metalstack.api.v2.LabelsR\x06labels\x12G\n\x08networks\x18\r \x03(\x0b\x32+.metalstack.api.v2.MachineAllocationNetworkR\x08networks\x12\x38\n\x03ips\x18\x0e \x03(\x0b\x32&.metalstack.api.v2.MachineAllocationIpR\x03ips\x12/\n\x0eplacement_tags\x18\x0f \x03(\tB\x08\xbaH\x05\x92\x01\x02\x10@R\rplacementTags\x12G\n\x0b\x64ns_servers\x18\x10 \x03(\x0b\x32\x1c.metalstack.api.v2.DNSServerB\x08\xbaH\x05\x92\x01\x02\x10\x03R\ndnsServers\x12G\n\x0bntp_servers\x18\x11 \x03(\x0b\x32\x1c.metalstack.api.v2.NTPServerB\x08\xbaH\x05\x92\x01\x02\x10\nR\nntpServers\x12[\n\x0f\x61llocation_type\x18\x12 \x01(\x0e\x32(.metalstack.api.v2.MachineAllocationTypeB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x0e\x61llocationType\x12\x44\n\rfirewall_spec\x18\x13 \x01(\x0b\x32\x1f.metalstack.api.v2.FirewallSpecR\x0c\x66irewallSpecB\x07\n\x05_uuidB\x0e\n\x0c_descriptionB\x0b\n\t_hostnameB\x14\n\x12_filesystem_layoutB\x0b\n\t_userdata\"W\n\x0c\x46irewallSpec\x12G\n\x0e\x66irewall_rules\x18\x01 \x01(\x0b\x32 .metalstack.api.v2.FirewallRulesR\rfirewallRules\"T\n\x1cMachineServiceCreateResponse\x12\x34\n\x07machine\x18\x01 \x01(\x0b\x32\x1a.metalstack.api.v2.MachineR\x07machine\"\xf5\x02\n\x1bMachineServiceUpdateRequest\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\x46\n\x0bupdate_meta\x18\x02 \x01(\x0b\x32\x1d.metalstack.api.v2.UpdateMetaB\x06\xbaH\x03\xc8\x01\x01R\nupdateMeta\x12\"\n\x07project\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\x12\x32\n\x0b\x64\x65scription\x18\x04 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x00R\x0b\x64\x65scription\x88\x01\x01\x12<\n\x06labels\x18\x05 \x01(\x0b\x32\x1f.metalstack.api.v2.UpdateLabelsH\x01R\x06labels\x88\x01\x01\x12?\n\x0fssh_public_keys\x18\x06 \x03(\tB\x17\xbaH\x14\x92\x01\x11\x10\x32\"\x07r\x05\x10\x01\x18\x80@\xd0\xa4\xb3\xb1\x02\x01R\rsshPublicKeysB\x0e\n\x0c_descriptionB\t\n\x07_labels\"T\n\x1cMachineServiceUpdateResponse\x12\x34\n\x07machine\x18\x01 \x01(\x0b\x32\x1a.metalstack.api.v2.MachineR\x07machine\"v\n\x19MachineServiceListRequest\x12\"\n\x07project\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\x12\x35\n\x05query\x18\x02 \x01(\x0b\x32\x1f.metalstack.api.v2.MachineQueryR\x05query\"T\n\x1aMachineServiceListResponse\x12\x36\n\x08machines\x18\x01 \x03(\x0b\x32\x1a.metalstack.api.v2.MachineR\x08machines\"_\n\x1bMachineServiceDeleteRequest\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\"\n\x07project\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\"T\n\x1cMachineServiceDeleteResponse\x12\x34\n\x07machine\x18\x01 \x01(\x0b\x32\x1a.metalstack.api.v2.MachineR\x07machine\"\xad\x01\n\x1fMachineServiceBMCCommandRequest\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\"\n\x07project\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\x12H\n\x07\x63ommand\x18\x03 \x01(\x0e\x32$.metalstack.api.v2.MachineBMCCommandB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x07\x63ommand\"\"\n MachineServiceBMCCommandResponse\"_\n\x1bMachineServiceGetBMCRequest\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\"\n\x07project\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\"s\n\x1cMachineServiceGetBMCResponse\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12\x35\n\x03\x62mc\x18\x02 \x01(\x0b\x32#.metalstack.api.v2.MachineBMCReportR\x03\x62mc\"\x8d\x04\n\x07Machine\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12+\n\x04meta\x18\x02 \x01(\x0b\x32\x17.metalstack.api.v2.MetaR\x04meta\x12:\n\tpartition\x18\x03 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\x12\x1c\n\x04rack\x18\x04 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x04rack\x12+\n\x04size\x18\x05 \x01(\x0b\x32\x17.metalstack.api.v2.SizeR\x04size\x12>\n\x08hardware\x18\x06 \x01(\x0b\x32\".metalstack.api.v2.MachineHardwareR\x08hardware\x12\x44\n\nallocation\x18\x07 \x01(\x0b\x32$.metalstack.api.v2.MachineAllocationR\nallocation\x12\x38\n\x06status\x18\x08 \x01(\x0b\x32 .metalstack.api.v2.MachineStatusR\x06status\x12p\n\x1arecent_provisioning_events\x18\t \x01(\x0b\x32\x32.metalstack.api.v2.MachineRecentProvisioningEventsR\x18recentProvisioningEvents\"\xa4\x02\n\rMachineStatus\x12\x41\n\tcondition\x18\x01 \x01(\x0b\x32#.metalstack.api.v2.MachineConditionR\tcondition\x12N\n\tled_state\x18\x02 \x01(\x0b\x32\x31.metalstack.api.v2.MachineChassisIdentifyLEDStateR\x08ledState\x12N\n\nliveliness\x18\x03 \x01(\x0e\x32$.metalstack.api.v2.MachineLivelinessB\x08\xbaH\x05\x82\x01\x02\x10\x01R\nliveliness\x12\x30\n\x14metal_hammer_version\x18\x04 \x01(\tR\x12metalHammerVersion\"\xa4\x01\n\x10MachineCondition\x12?\n\x05state\x18\x01 \x01(\x0e\x32\x1f.metalstack.api.v2.MachineStateB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x05state\x12-\n\x0b\x64\x65scription\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x0b\x64\x65scription\x12 \n\x06issuer\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x02R\x06issuer\"\xb8\x07\n\x11MachineAllocation\x12\x1c\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x04uuid\x12+\n\x04meta\x18\x02 \x01(\x0b\x32\x17.metalstack.api.v2.MetaR\x04meta\x12\x1f\n\x04name\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x04name\x12-\n\x0b\x64\x65scription\x18\x04 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x0b\x64\x65scription\x12\'\n\ncreated_by\x18\x05 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\tcreatedBy\x12\"\n\x07project\x18\x06 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01R\x07project\x12.\n\x05image\x18\x07 \x01(\x0b\x32\x18.metalstack.api.v2.ImageR\x05image\x12P\n\x11\x66ilesystem_layout\x18\x08 \x01(\x0b\x32#.metalstack.api.v2.FilesystemLayoutR\x10\x66ilesystemLayout\x12=\n\x08networks\x18\t \x03(\x0b\x32!.metalstack.api.v2.MachineNetworkR\x08networks\x12#\n\x08hostname\x18\n \x01(\tB\x07\xbaH\x04r\x02h\x01R\x08hostname\x12?\n\x0fssh_public_keys\x18\x0b \x03(\tB\x17\xbaH\x14\x92\x01\x11\x10\x32\"\x07r\x05\x10\x01\x18\x80@\xd0\xa4\xb3\xb1\x02\x01R\rsshPublicKeys\x12+\n\x08userdata\x18\x0c \x01(\tB\x0f\xbaH\x0cr\n\x18\x80\x80\x02\xf0\xb3\xae\xb1\x02\x01R\x08userdata\x12[\n\x0f\x61llocation_type\x18\r \x01(\x0e\x32(.metalstack.api.v2.MachineAllocationTypeB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x0e\x61llocationType\x12G\n\x0e\x66irewall_rules\x18\x0e \x01(\x0b\x32 .metalstack.api.v2.FirewallRulesR\rfirewallRules\x12G\n\x0b\x64ns_servers\x18\x0f \x03(\x0b\x32\x1c.metalstack.api.v2.DNSServerB\x08\xbaH\x05\x92\x01\x02\x10\x03R\ndnsServers\x12G\n\x0bntp_servers\x18\x10 \x03(\x0b\x32\x1c.metalstack.api.v2.NTPServerB\x08\xbaH\x05\x92\x01\x02\x10\nR\nntpServers\x12/\n\x03vpn\x18\x11 \x01(\x0b\x32\x1d.metalstack.api.v2.MachineVPNR\x03vpn\"\x8a\x01\n\x18MachineAllocationNetwork\x12%\n\x07network\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x07network\x12\x30\n\x12no_auto_acquire_ip\x18\x02 \x01(\x08H\x00R\x0fnoAutoAcquireIp\x88\x01\x01\x42\x15\n\x13_no_auto_acquire_ip\"i\n\x13MachineAllocationIp\x12\x17\n\x02ip\x18\x01 \x01(\tB\x07\xbaH\x04r\x02p\x01R\x02ip\x12+\n\tnamespace\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x00R\tnamespace\x88\x01\x01\x42\x0c\n\n_namespace\"\x90\x01\n\rFirewallRules\x12=\n\x06\x65gress\x18\x01 \x03(\x0b\x32%.metalstack.api.v2.FirewallEgressRuleR\x06\x65gress\x12@\n\x07ingress\x18\x02 \x03(\x0b\x32&.metalstack.api.v2.FirewallIngressRuleR\x07ingress\"\xd0\x01\n\x12\x46irewallEgressRule\x12\x43\n\x08protocol\x18\x01 \x01(\x0e\x32\x1d.metalstack.api.v2.IPProtocolB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x08protocol\x12$\n\x05ports\x18\x02 \x03(\rB\x0e\xbaH\x0b\x92\x01\x08\"\x06*\x04\x18\xfc\xff\x03R\x05ports\x12\x1c\n\x02to\x18\x03 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x02to\x12\x31\n\x07\x63omment\x18\x04 \x01(\tB\x17\xbaH\x14r\x0f\x18\x64\x32\x0b^[a-z_ -]*$\xd8\x01\x01R\x07\x63omment\"\xf3\x01\n\x13\x46irewallIngressRule\x12\x43\n\x08protocol\x18\x01 \x01(\x0e\x32\x1d.metalstack.api.v2.IPProtocolB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x08protocol\x12$\n\x05ports\x18\x02 \x03(\rB\x0e\xbaH\x0b\x92\x01\x08\"\x06*\x04\x18\xfc\xff\x03R\x05ports\x12\x1c\n\x02to\x18\x03 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x02to\x12 \n\x04\x66rom\x18\x04 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x04\x66rom\x12\x31\n\x07\x63omment\x18\x05 \x01(\tB\x17\xbaH\x14r\x0f\x18\x64\x32\x0b^[a-z_ -]*$\xd8\x01\x01R\x07\x63omment\"\x9c\x03\n\x0eMachineNetwork\x12\x18\n\x07network\x18\x01 \x01(\tR\x07network\x12(\n\x08prefixes\x18\x02 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x08prefixes\x12?\n\x14\x64\x65stination_prefixes\x18\x03 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x13\x64\x65stinationPrefixes\x12\x1e\n\x03ips\x18\x04 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xc0\xa4\xb3\xb1\x02\x01R\x03ips\x12K\n\x0cnetwork_type\x18\x05 \x01(\x0e\x32\x1e.metalstack.api.v2.NetworkTypeB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x0bnetworkType\x12?\n\x08nat_type\x18\x06 \x01(\x0e\x32\x1a.metalstack.api.v2.NATTypeB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x07natType\x12\x10\n\x03vrf\x18\x07 \x01(\x04R\x03vrf\x12\x10\n\x03\x61sn\x18\x08 \x01(\rR\x03\x61sn\x12\'\n\x07project\x18\t \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x00R\x07project\x88\x01\x01\x42\n\n\x08_project\"\xfb\x01\n\x0fMachineHardware\x12\x16\n\x06memory\x18\x01 \x01(\x04R\x06memory\x12;\n\x05\x64isks\x18\x02 \x03(\x0b\x32%.metalstack.api.v2.MachineBlockDeviceR\x05\x64isks\x12/\n\x04\x63pus\x18\x03 \x03(\x0b\x32\x1b.metalstack.api.v2.MetalCPUR\x04\x63pus\x12/\n\x04gpus\x18\x04 \x03(\x0b\x32\x1b.metalstack.api.v2.MetalGPUR\x04gpus\x12\x31\n\x04nics\x18\x05 \x03(\x0b\x32\x1d.metalstack.api.v2.MachineNicR\x04nics\"|\n\x08MetalCPU\x12 \n\x06vendor\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x02R\x06vendor\x12\x1e\n\x05model\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x02R\x05model\x12\x14\n\x05\x63ores\x18\x03 \x01(\rR\x05\x63ores\x12\x18\n\x07threads\x18\x04 \x01(\rR\x07threads\"L\n\x08MetalGPU\x12 \n\x06vendor\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x02R\x06vendor\x12\x1e\n\x05model\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x02R\x05model\"\xa7\x02\n\nMachineNic\x12\x1d\n\x03mac\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xb8\xb3\xae\xb1\x02\x01R\x03mac\x12\x1f\n\x04name\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x04name\x12(\n\nidentifier\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\nidentifier\x12 \n\x06vendor\x18\x04 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x06vendor\x12\x1e\n\x05model\x18\x05 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x05model\x12\x14\n\x05speed\x18\x06 \x01(\x04R\x05speed\x12;\n\tneighbors\x18\x07 \x03(\x0b\x32\x1d.metalstack.api.v2.MachineNicR\tneighbors\x12\x1a\n\x08hostname\x18\x08 \x01(\tR\x08hostname\"I\n\x12MachineBlockDevice\x12\x1f\n\x04name\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01R\x04name\x12\x12\n\x04size\x18\x02 \x01(\x04R\x04size\"o\n\x1eMachineChassisIdentifyLEDState\x12\x1e\n\x05value\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01R\x05value\x12-\n\x0b\x64\x65scription\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x0b\x64\x65scription\"\xcb\x03\n\x10MachineBMCReport\x12/\n\x03\x62mc\x18\x01 \x01(\x0b\x32\x1d.metalstack.api.v2.MachineBMCR\x03\x62mc\x12\x32\n\x04\x62ios\x18\x02 \x01(\x0b\x32\x1e.metalstack.api.v2.MachineBiosR\x04\x62ios\x12/\n\x03\x66ru\x18\x03 \x01(\x0b\x32\x1d.metalstack.api.v2.MachineFRUR\x03\x66ru\x12H\n\x0cpower_metric\x18\x04 \x01(\x0b\x32%.metalstack.api.v2.MachinePowerMetricR\x0bpowerMetric\x12L\n\x0epower_supplies\x18\x05 \x03(\x0b\x32%.metalstack.api.v2.MachinePowerSupplyR\rpowerSupplies\x12N\n\tled_state\x18\x06 \x01(\x0b\x32\x31.metalstack.api.v2.MachineChassisIdentifyLEDStateR\x08ledState\x12\x39\n\nupdated_at\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\tupdatedAt\"z\n\x0bMachineBios\x12%\n\x07version\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x07version\x12#\n\x06vendor\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x06vendor\x12\x1f\n\x04\x64\x61te\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x04\x64\x61te\"\x99\x02\n\nMachineBMC\x12\"\n\x07\x61\x64\x64ress\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\x80\x02\x01R\x07\x61\x64\x64ress\x12\x1d\n\x03mac\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xb8\xb3\xae\xb1\x02\x01R\x03mac\x12\x1f\n\x04user\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x04user\x12\'\n\x08password\x18\x04 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x08password\x12)\n\tinterface\x18\x05 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\tinterface\x12%\n\x07version\x18\x06 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x07version\x12,\n\x0bpower_state\x18\x07 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\npowerState\"\xa6\x05\n\nMachineFRU\x12@\n\x13\x63hassis_part_number\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x00R\x11\x63hassisPartNumber\x88\x01\x01\x12@\n\x13\x63hassis_part_serial\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x01R\x11\x63hassisPartSerial\x88\x01\x01\x12-\n\tboard_mfg\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x02R\x08\x62oardMfg\x88\x01\x01\x12:\n\x10\x62oard_mfg_serial\x18\x04 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x03R\x0e\x62oardMfgSerial\x88\x01\x01\x12<\n\x11\x62oard_part_number\x18\x05 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x04R\x0f\x62oardPartNumber\x88\x01\x01\x12\x43\n\x14product_manufacturer\x18\x06 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x05R\x13productManufacturer\x88\x01\x01\x12@\n\x13product_part_number\x18\x07 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x06R\x11productPartNumber\x88\x01\x01\x12\x37\n\x0eproduct_serial\x18\x08 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01H\x07R\rproductSerial\x88\x01\x01\x42\x16\n\x14_chassis_part_numberB\x16\n\x14_chassis_part_serialB\x0c\n\n_board_mfgB\x13\n\x11_board_mfg_serialB\x14\n\x12_board_part_numberB\x17\n\x15_product_manufacturerB\x16\n\x14_product_part_numberB\x11\n\x0f_product_serial\"\xce\x01\n\x12MachinePowerMetric\x12\x34\n\x16\x61verage_consumed_watts\x18\x01 \x01(\x02R\x14\x61verageConsumedWatts\x12&\n\x0finterval_in_min\x18\x02 \x01(\x02R\rintervalInMin\x12,\n\x12max_consumed_watts\x18\x03 \x01(\x02R\x10maxConsumedWatts\x12,\n\x12min_consumed_watts\x18\x04 \x01(\x02R\x10minConsumedWatts\"B\n\x12MachinePowerSupply\x12\x16\n\x06health\x18\x01 \x01(\tR\x06health\x12\x14\n\x05state\x18\x02 \x01(\tR\x05state\"\xd3\x02\n\x1fMachineRecentProvisioningEvents\x12\x43\n\x06\x65vents\x18\x01 \x03(\x0b\x32+.metalstack.api.v2.MachineProvisioningEventR\x06\x65vents\x12\x42\n\x0flast_event_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\rlastEventTime\x12U\n\x10last_error_event\x18\x03 \x01(\x0b\x32+.metalstack.api.v2.MachineProvisioningEventR\x0elastErrorEvent\x12P\n\x05state\x18\x04 \x01(\x0e\x32\x30.metalstack.api.v2.MachineProvisioningEventStateB\x08\xbaH\x05\x82\x01\x02\x10\x01R\x05state\"\xab\x01\n\x18MachineProvisioningEvent\x12.\n\x04time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\x04time\x12\x45\n\x05\x65vent\x18\x02 \x01(\x0e\x32/.metalstack.api.v2.MachineProvisioningEventTypeR\x05\x65vent\x12\x18\n\x07message\x18\x03 \x01(\tR\x07message\"\x99\x01\n\nMachineVPN\x12\x32\n\x15\x63ontrol_plane_address\x18\x01 \x01(\tR\x13\x63ontrolPlaneAddress\x12\x19\n\x08\x61uth_key\x18\x02 \x01(\tR\x07\x61uthKey\x12\x1c\n\tconnected\x18\x03 \x01(\x08R\tconnected\x12\x1e\n\x03ips\x18\x04 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xc0\xa4\xb3\xb1\x02\x01R\x03ips\"\xc5\x08\n\x0cMachineQuery\x12!\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x00R\x04uuid\x88\x01\x01\x12$\n\x04name\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01H\x01R\x04name\x88\x01\x01\x12-\n\tpartition\x18\x03 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x02R\tpartition\x88\x01\x01\x12#\n\x04size\x18\x04 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x03R\x04size\x88\x01\x01\x12#\n\x04rack\x18\x05 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x04R\x04rack\x88\x01\x01\x12\x36\n\x06labels\x18\x06 \x01(\x0b\x32\x19.metalstack.api.v2.LabelsH\x05R\x06labels\x88\x01\x01\x12N\n\nallocation\x18\x07 \x01(\x0b\x32).metalstack.api.v2.MachineAllocationQueryH\x06R\nallocation\x88\x01\x01\x12\x45\n\x07network\x18\x08 \x01(\x0b\x32&.metalstack.api.v2.MachineNetworkQueryH\x07R\x07network\x88\x01\x01\x12\x39\n\x03nic\x18\t \x01(\x0b\x32\".metalstack.api.v2.MachineNicQueryH\x08R\x03nic\x88\x01\x01\x12<\n\x04\x64isk\x18\n \x01(\x0b\x32#.metalstack.api.v2.MachineDiskQueryH\tR\x04\x64isk\x88\x01\x01\x12\x39\n\x03\x62mc\x18\x0b \x01(\x0b\x32\".metalstack.api.v2.MachineBMCQueryH\nR\x03\x62mc\x88\x01\x01\x12\x39\n\x03\x66ru\x18\x0c \x01(\x0b\x32\".metalstack.api.v2.MachineFRUQueryH\x0bR\x03\x66ru\x88\x01\x01\x12H\n\x08hardware\x18\r \x01(\x0b\x32\'.metalstack.api.v2.MachineHardwareQueryH\x0cR\x08hardware\x88\x01\x01\x12:\n\x05state\x18\x0e \x01(\x0e\x32\x1f.metalstack.api.v2.MachineStateH\rR\x05state\x88\x01\x01\x12\x1d\n\x07waiting\x18\x0f \x01(\x08H\x0eR\x07waiting\x88\x01\x01\x12\'\n\x0cpreallocated\x18\x10 \x01(\x08H\x0fR\x0cpreallocated\x88\x01\x01\x12(\n\rnot_allocated\x18\x11 \x01(\x08H\x10R\x0cnotAllocated\x88\x01\x01\x42\x07\n\x05_uuidB\x07\n\x05_nameB\x0c\n\n_partitionB\x07\n\x05_sizeB\x07\n\x05_rackB\t\n\x07_labelsB\r\n\x0b_allocationB\n\n\x08_networkB\x06\n\x04_nicB\x07\n\x05_diskB\x06\n\x04_bmcB\x06\n\x04_fruB\x0b\n\t_hardwareB\x08\n\x06_stateB\n\n\x08_waitingB\x0f\n\r_preallocatedB\x10\n\x0e_not_allocated\"\xde\x04\n\x16MachineAllocationQuery\x12!\n\x04uuid\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x00R\x04uuid\x88\x01\x01\x12$\n\x04name\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xc0\xb3\xae\xb1\x02\x01H\x01R\x04name\x88\x01\x01\x12\'\n\x07project\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\xb0\x01\x01H\x02R\x07project\x88\x01\x01\x12%\n\x05image\x18\x04 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x03R\x05image\x88\x01\x01\x12<\n\x11\x66ilesystem_layout\x18\x05 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x04R\x10\x66ilesystemLayout\x88\x01\x01\x12+\n\x08hostname\x18\x06 \x01(\tB\n\xbaH\x07r\x05\x10\x02\x18\x80\x01H\x05R\x08hostname\x88\x01\x01\x12`\n\x0f\x61llocation_type\x18\x07 \x01(\x0e\x32(.metalstack.api.v2.MachineAllocationTypeB\x08\xbaH\x05\x82\x01\x02\x10\x01H\x06R\x0e\x61llocationType\x88\x01\x01\x12\x36\n\x06labels\x18\x08 \x01(\x0b\x32\x19.metalstack.api.v2.LabelsH\x07R\x06labels\x88\x01\x01\x12\x34\n\x03vpn\x18\t \x01(\x0b\x32\x1d.metalstack.api.v2.MachineVPNH\x08R\x03vpn\x88\x01\x01\x42\x07\n\x05_uuidB\x07\n\x05_nameB\n\n\x08_projectB\x08\n\x06_imageB\x14\n\x12_filesystem_layoutB\x0b\n\t_hostnameB\x12\n\x10_allocation_typeB\t\n\x07_labelsB\x06\n\x04_vpn\"\xe4\x01\n\x13MachineNetworkQuery\x12\x1a\n\x08networks\x18\x01 \x03(\tR\x08networks\x12(\n\x08prefixes\x18\x02 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x08prefixes\x12?\n\x14\x64\x65stination_prefixes\x18\x03 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xb8\xa4\xb3\xb1\x02\x01R\x13\x64\x65stinationPrefixes\x12\x1e\n\x03ips\x18\x04 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xc0\xa4\xb3\xb1\x02\x01R\x03ips\x12\x12\n\x04vrfs\x18\x05 \x03(\x04R\x04vrfs\x12\x12\n\x04\x61sns\x18\x06 \x03(\rR\x04\x61sns\"\xd9\x01\n\x0fMachineNicQuery\x12(\n\x04macs\x18\x01 \x03(\tB\x14\xbaH\x11\x92\x01\x0e\x10\x64\x18\x01\"\x08r\x06\xb8\xb3\xae\xb1\x02\x01R\x04macs\x12\'\n\x05names\x18\x02 \x03(\tB\x11\xbaH\x0e\x92\x01\x0b\x10\x64\x18\x01\"\x05r\x03\x18\x80\x01R\x05names\x12\x39\n\rneighbor_macs\x18\x03 \x03(\tB\x14\xbaH\x11\x92\x01\x0e\x10\x64\x18\x01\"\x08r\x06\xb8\xb3\xae\xb1\x02\x01R\x0cneighborMacs\x12\x38\n\x0eneighbor_names\x18\x04 \x03(\tB\x11\xbaH\x0e\x92\x01\x0b\x10\x64\x18\x01\"\x05r\x03\x18\x80\x01R\rneighborNames\"Y\n\x10MachineDiskQuery\x12%\n\x05names\x18\x01 \x03(\tB\x0f\xbaH\x0c\x92\x01\t\x10\x64\"\x05r\x03\x18\x80\x01R\x05names\x12\x1e\n\x05sizes\x18\x02 \x03(\x04\x42\x08\xbaH\x05\x92\x01\x02\x10\x64R\x05sizes\"\xd8\x01\n\x0fMachineBMCQuery\x12&\n\x07\x61\x64\x64ress\x18\x01 \x01(\tB\x07\xbaH\x04r\x02p\x01H\x00R\x07\x61\x64\x64ress\x88\x01\x01\x12\"\n\x03mac\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xb8\xb3\xae\xb1\x02\x01H\x01R\x03mac\x88\x01\x01\x12!\n\x04user\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x02R\x04user\x88\x01\x01\x12+\n\tinterface\x18\x04 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x03R\tinterface\x88\x01\x01\x42\n\n\x08_addressB\x06\n\x04_macB\x07\n\x05_userB\x0c\n\n_interface\"\x88\x05\n\x0fMachineFRUQuery\x12=\n\x13\x63hassis_part_number\x18\x01 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x00R\x11\x63hassisPartNumber\x88\x01\x01\x12=\n\x13\x63hassis_part_serial\x18\x02 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x01R\x11\x63hassisPartSerial\x88\x01\x01\x12*\n\tboard_mfg\x18\x03 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x02R\x08\x62oardMfg\x88\x01\x01\x12\x30\n\x0c\x62oard_serial\x18\x04 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x03R\x0b\x62oardSerial\x88\x01\x01\x12\x39\n\x11\x62oard_part_number\x18\x05 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x04R\x0f\x62oardPartNumber\x88\x01\x01\x12@\n\x14product_manufacturer\x18\x06 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x05R\x13productManufacturer\x88\x01\x01\x12=\n\x13product_part_number\x18\x07 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x06R\x11productPartNumber\x88\x01\x01\x12\x34\n\x0eproduct_serial\x18\x08 \x01(\tB\x08\xbaH\x05r\x03\x18\x80\x01H\x07R\rproductSerial\x88\x01\x01\x42\x16\n\x14_chassis_part_numberB\x16\n\x14_chassis_part_serialB\x0c\n\n_board_mfgB\x0f\n\r_board_serialB\x14\n\x12_board_part_numberB\x17\n\x15_product_manufacturerB\x16\n\x14_product_part_numberB\x11\n\x0f_product_serial\"n\n\x14MachineHardwareQuery\x12\x1b\n\x06memory\x18\x01 \x01(\x04H\x00R\x06memory\x88\x01\x01\x12 \n\tcpu_cores\x18\x02 \x01(\rH\x01R\x08\x63puCores\x88\x01\x01\x42\t\n\x07_memoryB\x0c\n\n_cpu_cores*e\n\nIPProtocol\x12\x1b\n\x17IP_PROTOCOL_UNSPECIFIED\x10\x00\x12\x1c\n\x0fIP_PROTOCOL_TCP\x10\x01\x1a\x07\x82\xb2\x19\x03tcp\x12\x1c\n\x0fIP_PROTOCOL_UDP\x10\x02\x1a\x07\x82\xb2\x19\x03udp*\xaf\x01\n\x0cMachineState\x12#\n\x19MACHINE_STATE_UNSPECIFIED\x10\x00\x1a\x04\x82\xb2\x19\x00\x12(\n\x16MACHINE_STATE_RESERVED\x10\x01\x1a\x0c\x82\xb2\x19\x08reserved\x12$\n\x14MACHINE_STATE_LOCKED\x10\x02\x1a\n\x82\xb2\x19\x06locked\x12*\n\x17MACHINE_STATE_AVAILABLE\x10\x03\x1a\r\x82\xb2\x19\tavailable*\xdf\x01\n\x1dMachineProvisioningEventState\x12\x36\n,MACHINE_PROVISIONING_EVENT_STATE_UNSPECIFIED\x10\x00\x1a\x04\x82\xb2\x19\x00\x12=\n*MACHINE_PROVISIONING_EVENT_STATE_CRASHLOOP\x10\x01\x1a\r\x82\xb2\x19\tcrashloop\x12G\n/MACHINE_PROVISIONING_EVENT_STATE_FAILED_RECLAIM\x10\x02\x1a\x12\x82\xb2\x19\x0e\x66\x61iled-reclaim*\x9f\x06\n\x1cMachineProvisioningEventType\x12/\n+MACHINE_PROVISIONING_EVENT_TYPE_UNSPECIFIED\x10\x00\x12\x34\n%MACHINE_PROVISIONING_EVENT_TYPE_ALIVE\x10\x01\x1a\t\x82\xb2\x19\x05\x41live\x12\x38\n\'MACHINE_PROVISIONING_EVENT_TYPE_CRASHED\x10\x02\x1a\x0b\x82\xb2\x19\x07\x43rashed\x12@\n+MACHINE_PROVISIONING_EVENT_TYPE_PXE_BOOTING\x10\x03\x1a\x0f\x82\xb2\x19\x0bPXE Booting\x12\x46\n.MACHINE_PROVISIONING_EVENT_TYPE_PLANNED_REBOOT\x10\x04\x1a\x12\x82\xb2\x19\x0ePlanned Reboot\x12<\n)MACHINE_PROVISIONING_EVENT_TYPE_PREPARING\x10\x05\x1a\r\x82\xb2\x19\tPreparing\x12@\n+MACHINE_PROVISIONING_EVENT_TYPE_REGISTERING\x10\x06\x1a\x0f\x82\xb2\x19\x0bRegistering\x12\x38\n\'MACHINE_PROVISIONING_EVENT_TYPE_WAITING\x10\x07\x1a\x0b\x82\xb2\x19\x07Waiting\x12>\n*MACHINE_PROVISIONING_EVENT_TYPE_INSTALLING\x10\x08\x1a\x0e\x82\xb2\x19\nInstalling\x12N\n2MACHINE_PROVISIONING_EVENT_TYPE_BOOTING_NEW_KERNEL\x10\t\x1a\x16\x82\xb2\x19\x12\x42ooting New Kernel\x12@\n+MACHINE_PROVISIONING_EVENT_TYPE_PHONED_HOME\x10\n\x1a\x0f\x82\xb2\x19\x0bPhoned Home\x12H\n/MACHINE_PROVISIONING_EVENT_TYPE_MACHINE_RECLAIM\x10\x0b\x1a\x13\x82\xb2\x19\x0fMachine Reclaim*\xba\x01\n\x11MachineLiveliness\x12(\n\x1eMACHINE_LIVELINESS_UNSPECIFIED\x10\x00\x1a\x04\x82\xb2\x19\x00\x12\'\n\x18MACHINE_LIVELINESS_ALIVE\x10\x01\x1a\t\x82\xb2\x19\x05\x61live\x12%\n\x17MACHINE_LIVELINESS_DEAD\x10\x02\x1a\x08\x82\xb2\x19\x04\x64\x65\x61\x64\x12+\n\x1aMACHINE_LIVELINESS_UNKNOWN\x10\x03\x1a\x0b\x82\xb2\x19\x07unknown*\xac\x01\n\x15MachineAllocationType\x12-\n#MACHINE_ALLOCATION_TYPE_UNSPECIFIED\x10\x00\x1a\x04\x82\xb2\x19\x00\x12\x30\n\x1fMACHINE_ALLOCATION_TYPE_MACHINE\x10\x01\x1a\x0b\x82\xb2\x19\x07machine\x12\x32\n MACHINE_ALLOCATION_TYPE_FIREWALL\x10\x02\x1a\x0c\x82\xb2\x19\x08\x66irewall*\xfe\x04\n\x11MachineBMCCommand\x12#\n\x1fMACHINE_BMC_COMMAND_UNSPECIFIED\x10\x00\x12\"\n\x16MACHINE_BMC_COMMAND_ON\x10\x01\x1a\x06\x82\xb2\x19\x02on\x12$\n\x17MACHINE_BMC_COMMAND_OFF\x10\x02\x1a\x07\x82\xb2\x19\x03off\x12(\n\x19MACHINE_BMC_COMMAND_RESET\x10\x03\x1a\t\x82\xb2\x19\x05reset\x12(\n\x19MACHINE_BMC_COMMAND_CYCLE\x10\x04\x1a\t\x82\xb2\x19\x05\x63ycle\x12\x36\n MACHINE_BMC_COMMAND_BOOT_TO_BIOS\x10\x05\x1a\x10\x82\xb2\x19\x0c\x62oot-to-bios\x12:\n\"MACHINE_BMC_COMMAND_BOOT_FROM_DISK\x10\x06\x1a\x12\x82\xb2\x19\x0e\x62oot-from-disk\x12\x38\n!MACHINE_BMC_COMMAND_BOOT_FROM_PXE\x10\x07\x1a\x11\x82\xb2\x19\rboot-from-pxe\x12<\n#MACHINE_BMC_COMMAND_IDENTIFY_LED_ON\x10\x08\x1a\x13\x82\xb2\x19\x0fidentify-led-on\x12>\n$MACHINE_BMC_COMMAND_IDENTIFY_LED_OFF\x10\t\x1a\x14\x82\xb2\x19\x10identify-led-off\x12<\n#MACHINE_BMC_COMMAND_MACHINE_DELETED\x10\n\x1a\x13\x82\xb2\x19\x0fmachine-deleted\x12<\n#MACHINE_BMC_COMMAND_MACHINE_CREATED\x10\x0b\x1a\x13\x82\xb2\x19\x0fmachine-created2\xbc\x06\n\x0eMachineService\x12m\n\x03Get\x12+.metalstack.api.v2.MachineServiceGetRequest\x1a,.metalstack.api.v2.MachineServiceGetResponse\"\x0b\xca\xf3\x18\x03\x01\x02\x03\xe0\xf3\x18\x02\x12q\n\x06\x43reate\x12..metalstack.api.v2.MachineServiceCreateRequest\x1a/.metalstack.api.v2.MachineServiceCreateResponse\"\x06\xca\xf3\x18\x02\x01\x02\x12q\n\x06Update\x12..metalstack.api.v2.MachineServiceUpdateRequest\x1a/.metalstack.api.v2.MachineServiceUpdateResponse\"\x06\xca\xf3\x18\x02\x01\x02\x12p\n\x04List\x12,.metalstack.api.v2.MachineServiceListRequest\x1a-.metalstack.api.v2.MachineServiceListResponse\"\x0b\xca\xf3\x18\x03\x01\x02\x03\xe0\xf3\x18\x02\x12q\n\x06\x44\x65lete\x12..metalstack.api.v2.MachineServiceDeleteRequest\x1a/.metalstack.api.v2.MachineServiceDeleteResponse\"\x06\xca\xf3\x18\x02\x01\x02\x12}\n\nBMCCommand\x12\x32.metalstack.api.v2.MachineServiceBMCCommandRequest\x1a\x33.metalstack.api.v2.MachineServiceBMCCommandResponse\"\x06\xca\xf3\x18\x02\x01\x02\x12q\n\x06GetBMC\x12..metalstack.api.v2.MachineServiceGetBMCRequest\x1a/.metalstack.api.v2.MachineServiceGetBMCResponse\"\x06\xca\xf3\x18\x02\x01\x02\x42\xc2\x01\n\x15\x63om.metalstack.api.v2B\x0cMachineProtoP\x01Z5github.com/metal-stack/api/go/metalstack/api/v2;apiv2\xa2\x02\x03MAX\xaa\x02\x11Metalstack.Api.V2\xca\x02\x11Metalstack\\Api\\V2\xe2\x02\x1dMetalstack\\Api\\V2\\GPBMetadata\xea\x02\x13Metalstack::Api::V2b\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -138,7 +138,7 @@
   _globals['_MACHINESERVICECREATEREQUEST'].fields_by_name['image']._loaded_options = None
   _globals['_MACHINESERVICECREATEREQUEST'].fields_by_name['image']._serialized_options = b'\272H\005r\003\030\200\001'
   _globals['_MACHINESERVICECREATEREQUEST'].fields_by_name['ssh_public_keys']._loaded_options = None
-  _globals['_MACHINESERVICECREATEREQUEST'].fields_by_name['ssh_public_keys']._serialized_options = b'\272H\024\222\001\021\0202\"\007r\005\020\001\030\200@\310\244\263\261\002\001'
+  _globals['_MACHINESERVICECREATEREQUEST'].fields_by_name['ssh_public_keys']._serialized_options = b'\272H\024\222\001\021\0202\"\007r\005\020\001\030\200@\320\244\263\261\002\001'
   _globals['_MACHINESERVICECREATEREQUEST'].fields_by_name['userdata']._loaded_options = None
   _globals['_MACHINESERVICECREATEREQUEST'].fields_by_name['userdata']._serialized_options = b'\272H\014r\n\030\200\200\002\360\263\256\261\002\001'
   _globals['_MACHINESERVICECREATEREQUEST'].fields_by_name['placement_tags']._loaded_options = None
@@ -158,7 +158,7 @@
   _globals['_MACHINESERVICEUPDATEREQUEST'].fields_by_name['description']._loaded_options = None
   _globals['_MACHINESERVICEUPDATEREQUEST'].fields_by_name['description']._serialized_options = b'\272H\010r\006\310\263\256\261\002\001'
   _globals['_MACHINESERVICEUPDATEREQUEST'].fields_by_name['ssh_public_keys']._loaded_options = None
-  _globals['_MACHINESERVICEUPDATEREQUEST'].fields_by_name['ssh_public_keys']._serialized_options = b'\272H\024\222\001\021\0202\"\007r\005\020\001\030\200@\310\244\263\261\002\001'
+  _globals['_MACHINESERVICEUPDATEREQUEST'].fields_by_name['ssh_public_keys']._serialized_options = b'\272H\024\222\001\021\0202\"\007r\005\020\001\030\200@\320\244\263\261\002\001'
   _globals['_MACHINESERVICELISTREQUEST'].fields_by_name['project']._loaded_options = None
   _globals['_MACHINESERVICELISTREQUEST'].fields_by_name['project']._serialized_options = b'\272H\005r\003\260\001\001'
   _globals['_MACHINESERVICEDELETEREQUEST'].fields_by_name['uuid']._loaded_options = None
@@ -202,7 +202,7 @@
   _globals['_MACHINEALLOCATION'].fields_by_name['hostname']._loaded_options = None
   _globals['_MACHINEALLOCATION'].fields_by_name['hostname']._serialized_options = b'\272H\004r\002h\001'
   _globals['_MACHINEALLOCATION'].fields_by_name['ssh_public_keys']._loaded_options = None
-  _globals['_MACHINEALLOCATION'].fields_by_name['ssh_public_keys']._serialized_options = b'\272H\024\222\001\021\0202\"\007r\005\020\001\030\200@\310\244\263\261\002\001'
+  _globals['_MACHINEALLOCATION'].fields_by_name['ssh_public_keys']._serialized_options = b'\272H\024\222\001\021\0202\"\007r\005\020\001\030\200@\320\244\263\261\002\001'
   _globals['_MACHINEALLOCATION'].fields_by_name['userdata']._loaded_options = None
   _globals['_MACHINEALLOCATION'].fields_by_name['userdata']._serialized_options = b'\272H\014r\n\030\200\200\002\360\263\256\261\002\001'
   _globals['_MACHINEALLOCATION'].fields_by_name['allocation_type']._loaded_options = None
diff --git a/python/metalstack/api/v2/partition_pb2.py b/python/metalstack/api/v2/partition_pb2.py
index 274071ba..1ac1c8fc 100644
--- a/python/metalstack/api/v2/partition_pb2.py
+++ b/python/metalstack/api/v2/partition_pb2.py
@@ -27,7 +27,7 @@
 from metalstack.api.v2 import predefined_rules_pb2 as metalstack_dot_api_dot_v2_dot_predefined__rules__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!metalstack/api/v2/partition.proto\x12\x11metalstack.api.v2\x1a\x1b\x62uf/validate/validate.proto\x1a\x1emetalstack/api/v2/common.proto\x1a(metalstack/api/v2/predefined_rules.proto\"\xaa\x03\n\tPartition\x12\x1b\n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\x02id\x12+\n\x04meta\x18\x02 \x01(\x0b\x32\x17.metalstack.api.v2.MetaR\x04meta\x12-\n\x0b\x64\x65scription\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x0b\x64\x65scription\x12\\\n\x12\x62oot_configuration\x18\x04 \x01(\x0b\x32-.metalstack.api.v2.PartitionBootConfigurationR\x11\x62ootConfiguration\x12G\n\x0b\x64ns_servers\x18\x05 \x03(\x0b\x32\x1c.metalstack.api.v2.DNSServerB\x08\xbaH\x05\x92\x01\x02\x10\x03R\ndnsServers\x12G\n\x0bntp_servers\x18\x06 \x03(\x0b\x32\x1c.metalstack.api.v2.NTPServerB\x08\xbaH\x05\x92\x01\x02\x10\nR\nntpServers\x12\x34\n\x16mgmt_service_addresses\x18\x07 \x03(\tR\x14mgmtServiceAddresses\"|\n\x0ePartitionQuery\x12 \n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01H\x00R\x02id\x88\x01\x01\x12\x36\n\x06labels\x18\x02 \x01(\x0b\x32\x19.metalstack.api.v2.LabelsH\x01R\x06labels\x88\x01\x01\x42\x05\n\x03_idB\t\n\x07_labels\"\x94\x01\n\x1aPartitionBootConfiguration\x12(\n\timage_url\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xe0\xb3\xae\xb1\x02\x01R\x08imageUrl\x12*\n\nkernel_url\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xe0\xb3\xae\xb1\x02\x01R\tkernelUrl\x12 \n\x0b\x63ommandline\x18\x03 \x01(\tR\x0b\x63ommandline\"$\n\tDNSServer\x12\x17\n\x02ip\x18\x01 \x01(\tB\x07\xbaH\x04r\x02p\x01R\x02ip\"2\n\tNTPServer\x12%\n\x07\x61\x64\x64ress\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xe8\xb3\xae\xb1\x02\x01R\x07\x61\x64\x64ress\"9\n\x1aPartitionServiceGetRequest\x12\x1b\n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\x02id\"V\n\x1bPartitionServiceListRequest\x12\x37\n\x05query\x18\x01 \x01(\x0b\x32!.metalstack.api.v2.PartitionQueryR\x05query\"Y\n\x1bPartitionServiceGetResponse\x12:\n\tpartition\x18\x01 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\"\\\n\x1cPartitionServiceListResponse\x12<\n\npartitions\x18\x01 \x03(\x0b\x32\x1c.metalstack.api.v2.PartitionR\npartitions2\xf5\x01\n\x10PartitionService\x12n\n\x03Get\x12-.metalstack.api.v2.PartitionServiceGetRequest\x1a..metalstack.api.v2.PartitionServiceGetResponse\"\x08\xd8\xf3\x18\x03\xe0\xf3\x18\x02\x12q\n\x04List\x12..metalstack.api.v2.PartitionServiceListRequest\x1a/.metalstack.api.v2.PartitionServiceListResponse\"\x08\xd8\xf3\x18\x03\xe0\xf3\x18\x02\x42\xc4\x01\n\x15\x63om.metalstack.api.v2B\x0ePartitionProtoP\x01Z5github.com/metal-stack/api/go/metalstack/api/v2;apiv2\xa2\x02\x03MAX\xaa\x02\x11Metalstack.Api.V2\xca\x02\x11Metalstack\\Api\\V2\xe2\x02\x1dMetalstack\\Api\\V2\\GPBMetadata\xea\x02\x13Metalstack::Api::V2b\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!metalstack/api/v2/partition.proto\x12\x11metalstack.api.v2\x1a\x1b\x62uf/validate/validate.proto\x1a\x1emetalstack/api/v2/common.proto\x1a(metalstack/api/v2/predefined_rules.proto\"\xb8\x03\n\tPartition\x12\x1b\n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\x02id\x12+\n\x04meta\x18\x02 \x01(\x0b\x32\x17.metalstack.api.v2.MetaR\x04meta\x12-\n\x0b\x64\x65scription\x18\x03 \x01(\tB\x0b\xbaH\x08r\x06\xc8\xb3\xae\xb1\x02\x01R\x0b\x64\x65scription\x12\\\n\x12\x62oot_configuration\x18\x04 \x01(\x0b\x32-.metalstack.api.v2.PartitionBootConfigurationR\x11\x62ootConfiguration\x12G\n\x0b\x64ns_servers\x18\x05 \x03(\x0b\x32\x1c.metalstack.api.v2.DNSServerB\x08\xbaH\x05\x92\x01\x02\x10\x03R\ndnsServers\x12G\n\x0bntp_servers\x18\x06 \x03(\x0b\x32\x1c.metalstack.api.v2.NTPServerB\x08\xbaH\x05\x92\x01\x02\x10\nR\nntpServers\x12\x42\n\x16mgmt_service_addresses\x18\x07 \x03(\tB\x0c\xbaH\t\x92\x01\x06\xc8\xa4\xb3\xb1\x02\x01R\x14mgmtServiceAddresses\"|\n\x0ePartitionQuery\x12 \n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01H\x00R\x02id\x88\x01\x01\x12\x36\n\x06labels\x18\x02 \x01(\x0b\x32\x19.metalstack.api.v2.LabelsH\x01R\x06labels\x88\x01\x01\x42\x05\n\x03_idB\t\n\x07_labels\"\x94\x01\n\x1aPartitionBootConfiguration\x12(\n\timage_url\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xe0\xb3\xae\xb1\x02\x01R\x08imageUrl\x12*\n\nkernel_url\x18\x02 \x01(\tB\x0b\xbaH\x08r\x06\xe0\xb3\xae\xb1\x02\x01R\tkernelUrl\x12 \n\x0b\x63ommandline\x18\x03 \x01(\tR\x0b\x63ommandline\"$\n\tDNSServer\x12\x17\n\x02ip\x18\x01 \x01(\tB\x07\xbaH\x04r\x02p\x01R\x02ip\"2\n\tNTPServer\x12%\n\x07\x61\x64\x64ress\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xe8\xb3\xae\xb1\x02\x01R\x07\x61\x64\x64ress\"9\n\x1aPartitionServiceGetRequest\x12\x1b\n\x02id\x18\x01 \x01(\tB\x0b\xbaH\x08r\x06\xd0\xb3\xae\xb1\x02\x01R\x02id\"V\n\x1bPartitionServiceListRequest\x12\x37\n\x05query\x18\x01 \x01(\x0b\x32!.metalstack.api.v2.PartitionQueryR\x05query\"Y\n\x1bPartitionServiceGetResponse\x12:\n\tpartition\x18\x01 \x01(\x0b\x32\x1c.metalstack.api.v2.PartitionR\tpartition\"\\\n\x1cPartitionServiceListResponse\x12<\n\npartitions\x18\x01 \x03(\x0b\x32\x1c.metalstack.api.v2.PartitionR\npartitions2\xf5\x01\n\x10PartitionService\x12n\n\x03Get\x12-.metalstack.api.v2.PartitionServiceGetRequest\x1a..metalstack.api.v2.PartitionServiceGetResponse\"\x08\xd8\xf3\x18\x03\xe0\xf3\x18\x02\x12q\n\x04List\x12..metalstack.api.v2.PartitionServiceListRequest\x1a/.metalstack.api.v2.PartitionServiceListResponse\"\x08\xd8\xf3\x18\x03\xe0\xf3\x18\x02\x42\xc4\x01\n\x15\x63om.metalstack.api.v2B\x0ePartitionProtoP\x01Z5github.com/metal-stack/api/go/metalstack/api/v2;apiv2\xa2\x02\x03MAX\xaa\x02\x11Metalstack.Api.V2\xca\x02\x11Metalstack\\Api\\V2\xe2\x02\x1dMetalstack\\Api\\V2\\GPBMetadata\xea\x02\x13Metalstack::Api::V2b\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -43,6 +43,8 @@
   _globals['_PARTITION'].fields_by_name['dns_servers']._serialized_options = b'\272H\005\222\001\002\020\003'
   _globals['_PARTITION'].fields_by_name['ntp_servers']._loaded_options = None
   _globals['_PARTITION'].fields_by_name['ntp_servers']._serialized_options = b'\272H\005\222\001\002\020\n'
+  _globals['_PARTITION'].fields_by_name['mgmt_service_addresses']._loaded_options = None
+  _globals['_PARTITION'].fields_by_name['mgmt_service_addresses']._serialized_options = b'\272H\t\222\001\006\310\244\263\261\002\001'
   _globals['_PARTITIONQUERY'].fields_by_name['id']._loaded_options = None
   _globals['_PARTITIONQUERY'].fields_by_name['id']._serialized_options = b'\272H\010r\006\320\263\256\261\002\001'
   _globals['_PARTITIONBOOTCONFIGURATION'].fields_by_name['image_url']._loaded_options = None
@@ -60,23 +62,23 @@
   _globals['_PARTITIONSERVICE'].methods_by_name['List']._loaded_options = None
   _globals['_PARTITIONSERVICE'].methods_by_name['List']._serialized_options = b'\330\363\030\003\340\363\030\002'
   _globals['_PARTITION']._serialized_start=160
-  _globals['_PARTITION']._serialized_end=586
-  _globals['_PARTITIONQUERY']._serialized_start=588
-  _globals['_PARTITIONQUERY']._serialized_end=712
-  _globals['_PARTITIONBOOTCONFIGURATION']._serialized_start=715
-  _globals['_PARTITIONBOOTCONFIGURATION']._serialized_end=863
-  _globals['_DNSSERVER']._serialized_start=865
-  _globals['_DNSSERVER']._serialized_end=901
-  _globals['_NTPSERVER']._serialized_start=903
-  _globals['_NTPSERVER']._serialized_end=953
-  _globals['_PARTITIONSERVICEGETREQUEST']._serialized_start=955
-  _globals['_PARTITIONSERVICEGETREQUEST']._serialized_end=1012
-  _globals['_PARTITIONSERVICELISTREQUEST']._serialized_start=1014
-  _globals['_PARTITIONSERVICELISTREQUEST']._serialized_end=1100
-  _globals['_PARTITIONSERVICEGETRESPONSE']._serialized_start=1102
-  _globals['_PARTITIONSERVICEGETRESPONSE']._serialized_end=1191
-  _globals['_PARTITIONSERVICELISTRESPONSE']._serialized_start=1193
-  _globals['_PARTITIONSERVICELISTRESPONSE']._serialized_end=1285
-  _globals['_PARTITIONSERVICE']._serialized_start=1288
-  _globals['_PARTITIONSERVICE']._serialized_end=1533
+  _globals['_PARTITION']._serialized_end=600
+  _globals['_PARTITIONQUERY']._serialized_start=602
+  _globals['_PARTITIONQUERY']._serialized_end=726
+  _globals['_PARTITIONBOOTCONFIGURATION']._serialized_start=729
+  _globals['_PARTITIONBOOTCONFIGURATION']._serialized_end=877
+  _globals['_DNSSERVER']._serialized_start=879
+  _globals['_DNSSERVER']._serialized_end=915
+  _globals['_NTPSERVER']._serialized_start=917
+  _globals['_NTPSERVER']._serialized_end=967
+  _globals['_PARTITIONSERVICEGETREQUEST']._serialized_start=969
+  _globals['_PARTITIONSERVICEGETREQUEST']._serialized_end=1026
+  _globals['_PARTITIONSERVICELISTREQUEST']._serialized_start=1028
+  _globals['_PARTITIONSERVICELISTREQUEST']._serialized_end=1114
+  _globals['_PARTITIONSERVICEGETRESPONSE']._serialized_start=1116
+  _globals['_PARTITIONSERVICEGETRESPONSE']._serialized_end=1205
+  _globals['_PARTITIONSERVICELISTRESPONSE']._serialized_start=1207
+  _globals['_PARTITIONSERVICELISTRESPONSE']._serialized_end=1299
+  _globals['_PARTITIONSERVICE']._serialized_start=1302
+  _globals['_PARTITIONSERVICE']._serialized_end=1547
 # @@protoc_insertion_point(module_scope)
diff --git a/python/metalstack/api/v2/predefined_rules_pb2.py b/python/metalstack/api/v2/predefined_rules_pb2.py
index e64e467f..3165b8d5 100644
--- a/python/metalstack/api/v2/predefined_rules_pb2.py
+++ b/python/metalstack/api/v2/predefined_rules_pb2.py
@@ -25,7 +25,7 @@
 from buf.validate import validate_pb2 as buf_dot_validate_dot_validate__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n(metalstack/api/v2/predefined_rules.proto\x12\x11metalstack.api.v2\x1a\x1b\x62uf/validate/validate.proto:\xb8\x01\n\nmacaddress\x12\x19.buf.validate.StringRules\x18\xb7\xe6\x95& \x01(\x08\x42z\xc2Hw\nu\n\x11string.macaddress\x12&this string must be a valid macaddress\x1a\x38this.matches(\'^([0-9A-Fa-f]{2}[:]){5}([0-9A-Fa-f]{2})$\')R\nmacaddress:\x99\x01\n\x07is_name\x12\x19.buf.validate.StringRules\x18\xb8\xe6\x95& \x01(\x08\x42\x62\xc2H_\n]\n\x0estring.is_name\x12#must be within 2 and 128 characters\x1a&this.size() >= 2 && this.size() <= 128R\x06isName:\x9a\x01\n\x0eis_description\x12\x19.buf.validate.StringRules\x18\xb9\xe6\x95& \x01(\x08\x42U\xc2HR\nP\n\x15string.is_description\x12#must be shorter than 256 characters\x1a\x12this.size() <= 256R\risDescription:\xa8\x01\n\x0cis_partition\x12\x19.buf.validate.StringRules\x18\xba\xe6\x95& \x01(\x08\x42g\xc2Hd\nb\n\x13string.is_partition\x12#must be within 2 and 128 characters\x1a&this.size() >= 2 && this.size() <= 128R\x0bisPartition:\x82\x01\n\tis_prefix\x12\x19.buf.validate.StringRules\x18\xbb\xe6\x95& \x01(\x08\x42G\xc2HD\nB\n\x0fstring.prefixes\x12\x1cgiven prefixes must be valid\x1a\x11this.isIpPrefix()R\x08isPrefix:m\n\x06is_uri\x12\x19.buf.validate.StringRules\x18\xbc\xe6\x95& \x01(\x08\x42\x38\xc2H5\n3\n\nstring.uri\x12\x17given uri must be valid\x1a\x0cthis.isUri()R\x05isUri:\xa7\x01\n\x11is_ip_or_hostname\x12\x19.buf.validate.StringRules\x18\xbd\xe6\x95& \x01(\x08\x42^\xc2H[\nY\n\rvalid_address\x12&must be a valid IP address or hostname\x1a this.isIp() || this.isHostname()R\x0eisIpOrHostname:\x9d\x01\n\x07trimmed\x12\x19.buf.validate.StringRules\x18\xbe\xe6\x95& \x01(\x08\x42\x65\xc2Hb\n`\n\x0estring.trimmed\x12+value must not start or end with whitespace\x1a!this.trim().size() == this.size()R\x07trimmed:\x8f\x01\n\x08prefixes\x12\x1b.buf.validate.RepeatedRules\x18\xc7\xb4\x96& \x01(\x08\x42S\xc2HP\nN\n\x11repeated.prefixes\x12\x1cgiven prefixes must be valid\x1a\x1bthis.all(m, m.isIpPrefix())R\x08prefixes:u\n\x03ips\x12\x1b.buf.validate.RepeatedRules\x18\xc8\xb4\x96& \x01(\x08\x42\x43\xc2H@\n>\n\x0crepeated.ips\x12\x17given ips must be valid\x1a\x15this.all(m, m.isIp())R\x03ips:\xba\x01\n\x0b\x61ll_trimmed\x12\x1b.buf.validate.RepeatedRules\x18\xc9\xb4\x96& \x01(\x08\x42y\xc2Hv\nt\n\x14repeated.all_trimmed\x12\x32given values must not start or end with whitespace\x1a(this.all(m, m.trim().size() == m.size())R\nallTrimmedB\xca\x01\n\x15\x63om.metalstack.api.v2B\x14PredefinedRulesProtoP\x01Z5github.com/metal-stack/api/go/metalstack/api/v2;apiv2\xa2\x02\x03MAX\xaa\x02\x11Metalstack.Api.V2\xca\x02\x11Metalstack\\Api\\V2\xe2\x02\x1dMetalstack\\Api\\V2\\GPBMetadata\xea\x02\x13Metalstack::Api::V2')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n(metalstack/api/v2/predefined_rules.proto\x12\x11metalstack.api.v2\x1a\x1b\x62uf/validate/validate.proto:\xb8\x01\n\nmacaddress\x12\x19.buf.validate.StringRules\x18\xb7\xe6\x95& \x01(\x08\x42z\xc2Hw\nu\n\x11string.macaddress\x12&this string must be a valid macaddress\x1a\x38this.matches(\'^([0-9A-Fa-f]{2}[:]){5}([0-9A-Fa-f]{2})$\')R\nmacaddress:\x99\x01\n\x07is_name\x12\x19.buf.validate.StringRules\x18\xb8\xe6\x95& \x01(\x08\x42\x62\xc2H_\n]\n\x0estring.is_name\x12#must be within 2 and 128 characters\x1a&this.size() >= 2 && this.size() <= 128R\x06isName:\x9a\x01\n\x0eis_description\x12\x19.buf.validate.StringRules\x18\xb9\xe6\x95& \x01(\x08\x42U\xc2HR\nP\n\x15string.is_description\x12#must be shorter than 256 characters\x1a\x12this.size() <= 256R\risDescription:\xa8\x01\n\x0cis_partition\x12\x19.buf.validate.StringRules\x18\xba\xe6\x95& \x01(\x08\x42g\xc2Hd\nb\n\x13string.is_partition\x12#must be within 2 and 128 characters\x1a&this.size() >= 2 && this.size() <= 128R\x0bisPartition:\x82\x01\n\tis_prefix\x12\x19.buf.validate.StringRules\x18\xbb\xe6\x95& \x01(\x08\x42G\xc2HD\nB\n\x0fstring.prefixes\x12\x1cgiven prefixes must be valid\x1a\x11this.isIpPrefix()R\x08isPrefix:m\n\x06is_uri\x12\x19.buf.validate.StringRules\x18\xbc\xe6\x95& \x01(\x08\x42\x38\xc2H5\n3\n\nstring.uri\x12\x17given uri must be valid\x1a\x0cthis.isUri()R\x05isUri:\xa7\x01\n\x11is_ip_or_hostname\x12\x19.buf.validate.StringRules\x18\xbd\xe6\x95& \x01(\x08\x42^\xc2H[\nY\n\rvalid_address\x12&must be a valid IP address or hostname\x1a this.isIp() || this.isHostname()R\x0eisIpOrHostname:\x9d\x01\n\x07trimmed\x12\x19.buf.validate.StringRules\x18\xbe\xe6\x95& \x01(\x08\x42\x65\xc2Hb\n`\n\x0estring.trimmed\x12+value must not start or end with whitespace\x1a!this.trim().size() == this.size()R\x07trimmed:\x8f\x01\n\x08prefixes\x12\x1b.buf.validate.RepeatedRules\x18\xc7\xb4\x96& \x01(\x08\x42S\xc2HP\nN\n\x11repeated.prefixes\x12\x1cgiven prefixes must be valid\x1a\x1bthis.all(m, m.isIpPrefix())R\x08prefixes:u\n\x03ips\x12\x1b.buf.validate.RepeatedRules\x18\xc8\xb4\x96& \x01(\x08\x42\x43\xc2H@\n>\n\x0crepeated.ips\x12\x17given ips must be valid\x1a\x15this.all(m, m.isIp())R\x03ips:\xe6\x01\n\x11\x61re_host_and_port\x12\x1b.buf.validate.RepeatedRules\x18\xc9\xb4\x96& \x01(\x08\x42\x9a\x01\xc2H\x96\x01\n\x93\x01\n\x1arepeated.are_host_and_port\x12Pgiven entries must all be in the form of <ip | host>:<port> but port is optional\x1a#this.all(m, m.isHostAndPort(false))R\x0e\x61reHostAndPort:\xba\x01\n\x0b\x61ll_trimmed\x12\x1b.buf.validate.RepeatedRules\x18\xca\xb4\x96& \x01(\x08\x42y\xc2Hv\nt\n\x14repeated.all_trimmed\x12\x32given values must not start or end with whitespace\x1a(this.all(m, m.trim().size() == m.size())R\nallTrimmedB\xca\x01\n\x15\x63om.metalstack.api.v2B\x14PredefinedRulesProtoP\x01Z5github.com/metal-stack/api/go/metalstack/api/v2;apiv2\xa2\x02\x03MAX\xaa\x02\x11Metalstack.Api.V2\xca\x02\x11Metalstack\\Api\\V2\xe2\x02\x1dMetalstack\\Api\\V2\\GPBMetadata\xea\x02\x13Metalstack::Api::V2')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -53,6 +53,8 @@
   _globals['prefixes']._serialized_options = b'\302HP\nN\n\021repeated.prefixes\022\034given prefixes must be valid\032\033this.all(m, m.isIpPrefix())'
   _globals['ips']._loaded_options = None
   _globals['ips']._serialized_options = b'\302H@\n>\n\014repeated.ips\022\027given ips must be valid\032\025this.all(m, m.isIp())'
+  _globals['are_host_and_port']._loaded_options = None
+  _globals['are_host_and_port']._serialized_options = b'\302H\226\001\n\223\001\n\032repeated.are_host_and_port\022Pgiven entries must all be in the form of <ip | host>:<port> but port is optional\032#this.all(m, m.isHostAndPort(false))'
   _globals['all_trimmed']._loaded_options = None
   _globals['all_trimmed']._serialized_options = b'\302Hv\nt\n\024repeated.all_trimmed\0222given values must not start or end with whitespace\032(this.all(m, m.trim().size() == m.size())'
 # @@protoc_insertion_point(module_scope)
diff --git a/python/metalstack/api/v2/predefined_rules_pb2.pyi b/python/metalstack/api/v2/predefined_rules_pb2.pyi
index 5f0da34b..4741dab8 100644
--- a/python/metalstack/api/v2/predefined_rules_pb2.pyi
+++ b/python/metalstack/api/v2/predefined_rules_pb2.pyi
@@ -23,5 +23,7 @@ PREFIXES_FIELD_NUMBER: _ClassVar[int]
 prefixes: _descriptor.FieldDescriptor
 IPS_FIELD_NUMBER: _ClassVar[int]
 ips: _descriptor.FieldDescriptor
+ARE_HOST_AND_PORT_FIELD_NUMBER: _ClassVar[int]
+are_host_and_port: _descriptor.FieldDescriptor
 ALL_TRIMMED_FIELD_NUMBER: _ClassVar[int]
 all_trimmed: _descriptor.FieldDescriptor