From 0a15f24ea3b29426c38b83f3678fa086f9766686 Mon Sep 17 00:00:00 2001
From: Hugo Labrador <labkode@users.noreply.github.com>
Date: Tue, 27 Aug 2019 14:02:21 +0200
Subject: [PATCH] Add CreateReference method to StorageProviderService (#29)

* Add operation redirects: Code.CODE_REDIRECT and Status.target_uri

* add CreateReference method for storage provider
---
 .../v0alpha/storageprovider.proto             | 21 +++++
 docs/index.html                               | 82 +++++++++++++++++++
 2 files changed, 103 insertions(+)

diff --git a/cs3/storageprovider/v0alpha/storageprovider.proto b/cs3/storageprovider/v0alpha/storageprovider.proto
index e9ad744..e867088 100644
--- a/cs3/storageprovider/v0alpha/storageprovider.proto
+++ b/cs3/storageprovider/v0alpha/storageprovider.proto
@@ -132,6 +132,9 @@ service StorageProviderService {
   // MUST return CODE_NOT_FOUND if the reference does not exist.
   // MUST return CODE_PRECONDITION_FAILED if the acl does not exist.
   rpc UpdateGrant(UpdateGrantRequest) returns (UpdateGrantResponse);
+  // Creates a reference to another resource in the same cluster or another domain (OCM shares).
+  // The references resource can be accessed by the protocol specificied in the request message.
+  rpc CreateReference(CreateReferenceRequest) returns (CreateReferenceResponse);
 }
 
 message AddGrantRequest {
@@ -593,3 +596,21 @@ message UpdateGrantResponse {
   // Opaque information.
   cs3.types.Opaque opaque = 2;
 }
+
+message CreateReferenceRequest {
+  // OPTIONAL.
+  // Opaque information.
+  cs3.types.Opaque opaque = 1;
+  // REQUIRED.
+  // The reference resource by RFC3986.
+  string target_uri = 2;
+}
+
+message CreateReferenceResponse {
+  // REQUIRED.
+  // The response status.
+  cs3.rpc.Status status = 1;
+  // OPTIONAL.
+  // Opaque information.
+  cs3.types.Opaque opaque = 2;
+}
diff --git a/docs/index.html b/docs/index.html
index 13cf8ea..0a920b3 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -727,6 +727,14 @@ <h2>Table of Contents</h2>
                   <a href="#cs3.storageproviderv0alpha.CreateContainerResponse"><span class="badge">M</span>CreateContainerResponse</a>
                 </li>
               
+                <li>
+                  <a href="#cs3.storageproviderv0alpha.CreateReferenceRequest"><span class="badge">M</span>CreateReferenceRequest</a>
+                </li>
+              
+                <li>
+                  <a href="#cs3.storageproviderv0alpha.CreateReferenceResponse"><span class="badge">M</span>CreateReferenceResponse</a>
+                </li>
+              
                 <li>
                   <a href="#cs3.storageproviderv0alpha.DeleteRequest"><span class="badge">M</span>DeleteRequest</a>
                 </li>
@@ -5364,6 +5372,72 @@ <h3 id="cs3.storageproviderv0alpha.CreateContainerResponse">CreateContainerRespo
 
         
       
+        <h3 id="cs3.storageproviderv0alpha.CreateReferenceRequest">CreateReferenceRequest</h3>
+        <p></p>
+
+        
+          <table class="field-table">
+            <thead>
+              <tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
+            </thead>
+            <tbody>
+              
+                <tr>
+                  <td>opaque</td>
+                  <td><a href="#cs3.types.Opaque">cs3.types.Opaque</a></td>
+                  <td></td>
+                  <td><p>OPTIONAL.
+Opaque information. </p></td>
+                </tr>
+              
+                <tr>
+                  <td>target_uri</td>
+                  <td><a href="#string">string</a></td>
+                  <td></td>
+                  <td><p>REQUIRED.
+The reference resource by RFC3986. </p></td>
+                </tr>
+              
+            </tbody>
+          </table>
+
+          
+
+        
+      
+        <h3 id="cs3.storageproviderv0alpha.CreateReferenceResponse">CreateReferenceResponse</h3>
+        <p></p>
+
+        
+          <table class="field-table">
+            <thead>
+              <tr><td>Field</td><td>Type</td><td>Label</td><td>Description</td></tr>
+            </thead>
+            <tbody>
+              
+                <tr>
+                  <td>status</td>
+                  <td><a href="#cs3.rpc.Status">cs3.rpc.Status</a></td>
+                  <td></td>
+                  <td><p>REQUIRED.
+The response status. </p></td>
+                </tr>
+              
+                <tr>
+                  <td>opaque</td>
+                  <td><a href="#cs3.types.Opaque">cs3.types.Opaque</a></td>
+                  <td></td>
+                  <td><p>OPTIONAL.
+Opaque information. </p></td>
+                </tr>
+              
+            </tbody>
+          </table>
+
+          
+
+        
+      
         <h3 id="cs3.storageproviderv0alpha.DeleteRequest">DeleteRequest</h3>
         <p></p>
 
@@ -6997,6 +7071,14 @@ <h3 id="cs3.storageproviderv0alpha.StorageProviderService">StorageProviderServic
 MUST return CODE_PRECONDITION_FAILED if the acl does not exist.</p></td>
               </tr>
             
+              <tr>
+                <td>CreateReference</td>
+                <td><a href="#cs3.storageproviderv0alpha.CreateReferenceRequest">CreateReferenceRequest</a></td>
+                <td><a href="#cs3.storageproviderv0alpha.CreateReferenceResponse">CreateReferenceResponse</a></td>
+                <td><p>Creates a reference to another resource in the same cluster or another domain (OCM shares).
+The references resource can be accessed by the protocol specificied in the request message.</p></td>
+              </tr>
+            
           </tbody>
         </table>