the code locked added (#210)

Author: 2403905

cs3/gateway/v1beta1/gateway_api.proto

@@ -216,6 +216,7 @@ service GatewayAPI {
 
   // Creates a new share.
   // MUST return CODE_NOT_FOUND if the resource reference does not exist.
+  // MUST return CODE_LOCKED if the resource reference already locked.
   // MUST return CODE_ALREADY_EXISTS if the share already exists for the 4-tuple consisting of
   // (owner, shared_resource, grantee).
   // New shares MUST be created in the state SHARE_STATE_PENDING.

cs3/rpc/v1beta1/code.proto

@@ -191,4 +191,11 @@ enum Code {
   //
   // HTTP Mapping: 507 Insufficient Storage
   CODE_INSUFFICIENT_STORAGE = 19;
+  //
+  // The ability to lock a resource is specific to some WebDAV servers.
+  // The HTTP 423 Locked error response code indicates that either
+  // the resources tentatively targeted by is locked, meaning it can't be accessed.
+  //
+  // HTTP Mapping: 423 Locked
+  CODE_LOCKED = 20;
 }

cs3/sharing/collaboration/v1beta1/collaboration_api.proto

@@ -55,6 +55,7 @@ import "google/protobuf/field_mask.proto";
 service CollaborationAPI {
   // Creates a new share.
   // MUST return CODE_NOT_FOUND if the resource reference does not exist.
+  // MUST return CODE_LOCKED if the resource reference already locked.
   // MUST return CODE_ALREADY_EXISTS if the share already exists for the 4-tuple consisting of
   // (owner, shared_resource, grantee).
   // New shares MUST be created in the state SHARE_STATE_PENDING.

docs/index.html

@@ -2863,6 +2863,7 @@ <h3 id="cs3.gateway.v1beta1.GatewayAPI">GatewayAPI</h3>
                 <td><a href="#cs3.sharing.collaboration.v1beta1.CreateShareResponse">.cs3.sharing.collaboration.v1beta1.CreateShareResponse</a></td>
                 <td><p>Creates a new share.
 MUST return CODE_NOT_FOUND if the resource reference does not exist.
+MUST return CODE_LOCKED if the resource reference already locked.
 MUST return CODE_ALREADY_EXISTS if the share already exists for the 4-tuple consisting of
 (owner, shared_resource, grantee).
 New shares MUST be created in the state SHARE_STATE_PENDING.</p></td>
@@ -4081,6 +4082,16 @@ <h3 id="cs3.rpc.v1beta1.Code">Code</h3>
 HTTP Mapping: 507 Insufficient Storage</p></td>
               </tr>
 
+              <tr>
+                <td>CODE_LOCKED</td>
+                <td>20</td>
+                <td><p>The ability to lock a resource is specific to some WebDAV servers.
+The HTTP 423 Locked error response code indicates that either
+the resources tentatively targeted by is locked, meaning it can&#39;t be accessed.
+
+HTTP Mapping: 423 Locked</p></td>
+              </tr>
+            
           </tbody>
         </table>
 
@@ -10836,6 +10847,7 @@ <h3 id="cs3.sharing.collaboration.v1beta1.CollaborationAPI">CollaborationAPI</h3
                 <td><a href="#cs3.sharing.collaboration.v1beta1.CreateShareResponse">CreateShareResponse</a></td>
                 <td><p>Creates a new share.
 MUST return CODE_NOT_FOUND if the resource reference does not exist.
+MUST return CODE_LOCKED if the resource reference already locked.
 MUST return CODE_ALREADY_EXISTS if the share already exists for the 4-tuple consisting of
 (owner, shared_resource, grantee).
 New shares MUST be created in the state SHARE_STATE_PENDING.</p></td>
@@ -13696,10 +13708,13 @@ <h3 id="cs3.sharing.ocm.v1beta1.ReceivedShare">ReceivedShare</h3>
                 </tr>
 
                 <tr>
-                  <td>resource_id</td>
-                  <td><a href="#cs3.storage.provider.v1beta1.ResourceId">cs3.storage.provider.v1beta1.ResourceId</a></td>
+                  <td>remote_share_id</td>
+                  <td><a href="#string">string</a></td>
                   <td></td>
-                  <td><p>REQUIRED. </p></td>
+                  <td><p>REQUIRED.
+Identifier to identify the shared resource at the provider side.
+This is unique per provider such that if the same resource is shared twice, this will not be repeated.
+This correspond to the `providerId` in the OCM API specs. </p></td>
                 </tr>
 
                 <tr>