azure-storage 0.11.5.preview → 0.12.0.preview

data/lib/azure/storage/file/file_service.rb

@@ -0,0 +1,191 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+require 'azure/storage/core/auth/shared_key'
+require 'azure/storage/file/serialization'
+require 'azure/storage/file/file'
+
+module Azure::Storage
+  module File
+    class FileService < StorageService
+      include Azure::Storage::Core::Utility
+      include Azure::Storage::File::Share
+      include Azure::Storage::File::Directory
+      include Azure::Storage::File
+
+      def initialize(options = {}, &block)
+        client_config = options[:client] || Azure::Storage
+        signer = options[:signer] || client_config.signer || Core::Auth::SharedKey.new(client_config.storage_account_name, client_config.storage_access_key)
+        super(signer, client_config.storage_account_name, options, &block)
+        @host = client.storage_file_host
+      end
+
+      def call(method, uri, body=nil, headers={}, options={})
+        # Force the request.body to the content encoding of specified in the header
+        if headers && !body.nil? && (body.is_a? String) && ((body.encoding.to_s <=> 'ASCII_8BIT') != 0)
+          if headers['x-ms-content-type'].nil?
+            Service::StorageService.with_header headers, 'x-ms-content-type', "text/plain; charset=#{body.encoding}"
+          else
+            charset = parse_charset_from_content_type(headers['x-ms-content-type'])
+            body.force_encoding(charset) if charset
+          end
+        end
+
+        response = super
+
+        # Force the response.body to the content charset of specified in the header.
+        # Content-Type is echo'd back for the blob and is used to store the encoding of the octet stream
+        if !response.nil? && !response.body.nil? && response.headers['Content-Type']
+          charset = parse_charset_from_content_type(response.headers['Content-Type'])
+          response.body.force_encoding(charset) if charset && charset.length > 0
+        end
+
+        response
+      end
+
+      # Public: Get a list of Shares from the server.
+      #
+      # ==== Attributes
+      #
+      # * +options+                  - Hash. Optional parameters.
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +:prefix+                  - String. Filters the results to return only shares
+      #                                whose name begins with the specified prefix. (optional)
+      #
+      # * +:marker+                  - String. An identifier the specifies the portion of the
+      #                                list to be returned. This value comes from the property
+      #                                Azure::Service::EnumerationResults.continuation_token when there
+      #                                are more shares available than were returned. The
+      #                                marker value may then be used here to request the next set
+      #                                of list items. (optional)
+      #
+      # * +:max_results+             - Integer. Specifies the maximum number of shares to return.
+      #                                If max_results is not specified, or is a value greater than
+      #                                5,000, the server will return up to 5,000 items. If it is set
+      #                                to a value less than or equal to zero, the server will return
+      #                                status code 400 (Bad Request). (optional)
+      #
+      # * +:metadata+                - Boolean. Specifies whether or not to return the share metadata.
+      #                                (optional, Default=false)
+      #
+      # * +:timeout+                 - Integer. A timeout in seconds.
+      #
+      # * +:request_id+              - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded 
+      #                                in the analytics logs when storage analytics logging is enabled.
+      #
+      # See: https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/list-shares
+      #
+      # Returns an Azure::Service::EnumerationResults
+      #
+      def list_shares(options={})
+        query = { }
+        if options
+          StorageService.with_query query, 'prefix', options[:prefix]
+          StorageService.with_query query, 'marker', options[:marker]
+          StorageService.with_query query, 'maxresults', options[:max_results].to_s if options[:max_results]
+          StorageService.with_query query, 'include', 'metadata' if options[:metadata] == true
+          StorageService.with_query query, 'timeout', options[:timeout].to_s if options[:timeout]
+        end
+
+        uri = shares_uri(query)
+        response = call(:get, uri, nil, {}, options)
+
+        Serialization.share_enumeration_results_from_xml(response.body)
+      end
+
+      # Protected: Generate the URI for the collection of shares.
+      #
+      # ==== Attributes
+      #
+      # * +query+ - A Hash of key => value query parameters.
+      #
+      # Returns a URI.
+      #
+      protected
+      def shares_uri(query={})
+        query = { 'comp' => 'list' }.merge(query)
+        generate_uri('', query)
+      end
+
+      # Protected: Generate the URI for a specific share.
+      #
+      # ==== Attributes
+      #
+      # * +name+  - The share name. If this is a URI, we just return this.
+      # * +query+ - A Hash of key => value query parameters.
+      #
+      # Returns a URI.
+      #
+      protected
+      def share_uri(name, query={})
+        return name if name.kind_of? ::URI
+        query = { 'restype' => 'share' }.merge(query)
+        generate_uri(name, query)
+      end
+
+      # Protected: Generate the URI for a specific directory.
+      #
+      # ==== Attributes
+      #
+      # * +share+                 - String representing the name of the share.
+      # * +directory_path+        - String representing the path to the directory.
+      # * +directory+             - String representing the name to the directory.
+      # * +query+                 - A Hash of key => value query parameters.
+      #
+      # Returns a URI.
+      #
+      protected
+      def directory_uri(share, directory_path, query={})
+        path = directory_path.nil? ? share : ::File.join(share, directory_path)
+        query = { 'restype' => 'directory' }.merge(query)
+        generate_uri(path, query, true)
+      end
+
+      # Protected: Generate the URI for a specific file.
+      #
+      # ==== Attributes
+      #
+      # * +share+                 - String representing the name of the share.
+      # * +directory_path+        - String representing the path to the directory.
+      # * +file+                  - String representing the name to the file.
+      # * +query+                 - A Hash of key => value query parameters.
+      #
+      # Returns a URI.
+      #
+      protected
+      def file_uri(share, directory_path, file, query={})
+        if directory_path.nil?
+          path = ::File.join(share, file)
+        else
+          path = ::File.join(share, directory_path, file)
+        end
+        generate_uri(path, query, true)
+      end
+    end
+  end
+end
+
+Azure::Storage::FileService = Azure::Storage::File::FileService

data/lib/azure/storage/file/serialization.rb

@@ -0,0 +1,225 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+require 'azure/storage/service/serialization'
+
+module Azure::Storage
+  module File
+    module Serialization
+      include Service::Serialization
+
+      def self.share_enumeration_results_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("EnumerationResults", xml)
+
+        results = enumeration_results_from_xml(xml, Azure::Service::EnumerationResults.new)
+        
+        return results unless (xml > "Shares").any? && ((xml > "Shares") > "Share").any?
+
+        if xml.Shares.Share.count == 0
+          results.push(share_from_xml(xml.Shares.Share))
+        else
+          xml.Shares.Share.each { |share_node|
+            results.push(share_from_xml(share_node))
+          }
+        end
+
+        results
+      end
+
+      def self.share_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("Share", xml)
+
+        Share::Share.new do |share|
+          share.name = xml.Name.text if (xml > "Name").any?
+          share.properties = share_properties_from_xml(xml.Properties) if (xml > "Properties").any?
+          share.metadata = metadata_from_xml(xml.Metadata) if (xml > "Metadata").any?
+        end
+      end
+
+      def self.share_properties_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("Properties", xml)
+
+        props = {}
+        props[:last_modified] = (xml > "Last-Modified").text if (xml > "Last-Modified").any?
+        props[:etag] = xml.ETag.text if (xml > "ETag").any?
+        props[:quota] = xml.Quota.text if (xml > "Quota").any?
+        props
+      end
+
+      def self.share_from_headers(headers)
+        Share::Share.new do |share|
+          share.properties = share_properties_from_headers(headers)
+          share.quota = quota_from_headers(headers)
+          share.metadata = metadata_from_headers(headers)
+        end
+      end
+
+      def self.share_properties_from_headers(headers)
+        props = {}
+        props[:last_modified] = headers["Last-Modified"] 
+        props[:etag] = headers["ETag"]
+        props
+      end
+
+      def self.quota_from_headers(headers)
+        headers["x-ms-share-quota"] ? headers["x-ms-share-quota"].to_i : nil
+      end
+
+      def self.share_stats_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("ShareStats", xml)
+        xml.ShareUsage.text.to_i
+      end
+
+      def self.directories_and_files_enumeration_results_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("EnumerationResults", xml)
+
+        results = enumeration_results_from_xml(xml, Azure::Service::EnumerationResults.new)
+
+        return results unless (xml > "Entries").any?
+
+        if ((xml > "Entries") > "File").any?
+          if xml.Entries.File.count == 0
+            results.push(file_from_xml(xml.Entries.File))
+          else
+            xml.Entries.File.each { |file_node|
+              results.push(file_from_xml(file_node))
+            }
+          end
+        end
+
+        if ((xml > "Entries") > "Directory").any?
+          if xml.Entries.Directory.count == 0
+            results.push(directory_from_xml(xml.Entries.Directory))
+          else
+            xml.Entries.Directory.each { |directory_node|
+              results.push(directory_from_xml(directory_node))
+            }
+          end
+        end
+
+        results
+      end
+
+      def self.file_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("File", xml)
+
+        File.new do |file|
+          file.name = xml.Name.text if (xml > "Name").any?
+          file.properties = file_properties_from_xml(xml.Properties) if (xml > "Properties").any?
+        end
+      end
+
+      def self.file_properties_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("Properties", xml)
+
+        props = {}
+        props[:content_length] = (xml > "Content-Length").text.to_i if (xml > "Content-Length").any?
+        props
+      end
+
+      def self.directory_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("Directory", xml)
+
+        Directory::Directory.new do |directory|
+          directory.name = xml.Name.text if (xml > "Name").any?
+        end
+      end
+
+      def self.directory_from_headers(headers)
+        Directory::Directory.new do |directory|
+          directory.properties = directory_properties_from_headers(headers)
+          directory.metadata = metadata_from_headers(headers)
+        end
+      end
+
+      def self.directory_properties_from_headers(headers)
+        props = {}
+        props[:last_modified] = headers["Last-Modified"] 
+        props[:etag] = headers["ETag"]
+        props
+      end
+
+      def self.file_from_headers(headers)
+        File.new do |file|
+          file.properties = file_properties_from_headers(headers)
+          file.metadata = metadata_from_headers(headers)
+        end
+      end
+
+      def self.file_properties_from_headers(headers)
+        props = {}
+
+        props[:last_modified] = headers["Last-Modified"]
+        props[:etag] = headers["ETag"]
+        props[:type] = headers["x-ms-type"]
+
+        props[:content_length] = headers["Content-Length"].to_i unless headers["Content-Length"].nil?
+        props[:content_length] = headers["x-ms-content-length"].to_i unless headers["x-ms-content-length"].nil?
+  
+        props[:content_type] =  headers["Content-Type"]
+        props[:content_encoding] = headers["Content-Encoding"]
+        props[:content_language] = headers["Content-Language"]
+        props[:content_disposition] = headers["Content-Disposition"]
+        props[:content_md5] = headers["Content-MD5"]
+        props[:cache_control] = headers["Cache-Control"]
+
+        props[:copy_id] = headers["x-ms-copy-id"]
+        props[:copy_status] = headers["x-ms-copy-status"]
+        props[:copy_source] = headers["x-ms-copy-source"]
+        props[:copy_progress] = headers["x-ms-copy-progress"]
+        props[:copy_completion_time] = headers["x-ms-copy-completion-time"]
+        props[:copy_status_description] = headers["x-ms-copy-status-description"]
+
+        props[:accept_ranges] = headers["Accept-Ranges"].to_i if headers["Accept-Ranges"]
+
+        props
+      end
+
+      def self.range_list_from_xml(xml)
+        xml = slopify(xml)
+        expect_node("Ranges", xml)
+
+        range_list = []
+        return range_list unless (xml > "Range").any?
+
+        if xml.Range.count == 0
+          range_list.push [xml.Range.Start.text.to_i, xml.Range.End.text.to_i]
+        else
+          xml.Range.each { |range|
+            range_list.push [range.Start.text.to_i, range.End.text.to_i]
+          }
+        end
+
+        range_list
+      end
+    end
+  end
+end

data/lib/azure/storage/file/share.rb

@@ -0,0 +1,363 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+require 'azure/storage/file/serialization'
+
+module Azure::Storage::File
+  module Share
+    include Azure::Storage::Service
+    
+    class Share
+      def initialize
+        @properties = {}
+        @metadata = {}
+        yield self if block_given?
+      end
+
+      attr_accessor :name
+      attr_accessor :properties
+      attr_accessor :metadata
+      attr_accessor :quota
+      attr_accessor :usage
+    end
+
+    # Public: Create a new share
+    #
+    # ==== Attributes
+    #
+    # * +name+                      - String. The name of the share.
+    # * +options+                   - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:metadata+                 - Hash. User defined metadata for the share (optional).
+    # * +:quota+                    - Integer. The maximum size of the share, in gigabytes.
+    #                                 Must be greater than 0, and less than or equal to 5TB (5120). (optional).
+    # * +:timeout+                  - Integer. A timeout in seconds.
+    # * +:request_id+               - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded 
+    #                                 in the analytics logs when storage analytics logging is enabled.
+    #
+    # See https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/create-share
+    #
+    # Returns a Share
+    def create_share(name, options={})
+      # Query
+      query = { }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Scheme + path
+      uri = share_uri(name, query)
+
+      # Headers
+      headers = StorageService.common_headers
+      StorageService.add_metadata_to_headers(options[:metadata], headers) if options[:metadata]
+      headers['x-ms-share-quota'] = options[:quota].to_s if options[:quota]
+
+      # Call
+      response = call(:put, uri, nil, headers, options)
+
+      # result
+      share = Serialization.share_from_headers(response.headers)
+      share.name = name
+      share.quota = options[:quota] if options[:quota]
+      share.metadata = options[:metadata] if options[:metadata]
+      share
+    end
+
+    # Public: Returns all properties and metadata on the share.
+    #
+    # ==== Attributes
+    #
+    # * +name+                      - String. The name of the share
+    # * +options+                   - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                  - Integer. A timeout in seconds.
+    # * +:request_id+               - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded 
+    #                                 in the analytics logs when storage analytics logging is enabled.
+    #
+    # See https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/get-share-properties
+    #
+    # Returns a Share
+    def get_share_properties(name, options={})
+      # Query
+      query = { }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Call
+      response = call(:get, share_uri(name, query), nil, {}, options)
+
+      # result
+      share = Serialization.share_from_headers(response.headers)
+      share.name = name
+      share
+    end
+
+    # Public: Sets service-defined properties for the share.
+    #
+    # ==== Attributes
+    #
+    # * +name+                      - String. The name of the share
+    # * +options+                   - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:quota+                    - Integer. The maximum size of the share, in gigabytes.
+    #                                 Must be greater than 0, and less than or equal to 5TB (5120). (optional).
+    # * +:timeout+                  - Integer. A timeout in seconds.
+    # * +:request_id+               - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded 
+    #                                 in the analytics logs when storage analytics logging is enabled.
+    #
+    # See https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/set-share-properties
+    #
+    # Returns nil on success
+    def set_share_properties(name, options={})
+      # Query
+      query = { 'comp' => 'properties' }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Headers
+      headers = StorageService.common_headers
+      headers['x-ms-share-quota'] = options[:quota].to_s if options[:quota]
+
+      # Call
+      call(:put, share_uri(name, query), nil, headers, options)
+      
+      # Result
+      nil
+    end
+
+    # Public: Returns only user-defined metadata for the specified share.
+    #
+    # ==== Attributes
+    #
+    # * +name+                      - String. The name of the share
+    # * +options+                   - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                  - Integer. A timeout in seconds.
+    # * +:request_id+               - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded 
+    #                                 in the analytics logs when storage analytics logging is enabled.
+    #
+    # See https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/get-share-metadata
+    #
+    # Returns a Share
+    def get_share_metadata(name, options={})
+      # Query
+      query = { 'comp' => 'metadata' }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Call
+      response = call(:get, share_uri(name, query), nil, {}, options)
+
+      # result
+      share = Serialization.share_from_headers(response.headers)
+      share.name = name
+      share
+    end
+
+    # Public: Sets custom metadata for the share.
+    #
+    # ==== Attributes
+    #
+    # * +name+                      - String. The name of the share
+    # * +metadata+                  - Hash. A Hash of the metadata values
+    # * +options+                   - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                  - Integer. A timeout in seconds.
+    # * +:request_id+               - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded 
+    #                                 in the analytics logs when storage analytics logging is enabled.
+    #
+    # See https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/set-share-metadata
+    #
+    # Returns nil on success
+    def set_share_metadata(name, metadata, options={})
+      # Query
+      query = { 'comp' => 'metadata' }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Headers
+      headers = StorageService.common_headers
+      StorageService.add_metadata_to_headers(metadata, headers) if metadata
+
+      # Call
+      call(:put, share_uri(name, query), nil, headers, options)
+      
+      # Result
+      nil
+    end
+
+    # Public: Deletes a share.
+    #
+    # ==== Attributes
+    #
+    # * +name+                      - String. The name of the share.
+    # * +options+                   - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                  - Integer. A timeout in seconds.
+    # * +:request_id+               - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded 
+    #                                 in the analytics logs when storage analytics logging is enabled.
+    #
+    # See https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/delete-share
+    #
+    # Returns nil on success
+    def delete_share(name, options={})
+      # Query
+      query = { }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Call
+      call(:delete, share_uri(name, query), nil, {}, options)
+      
+      # result
+      nil
+    end
+
+    # Public: Gets the information about stored access policies for the share.
+    #
+    # ==== Attributes
+    #
+    # * +name+                      - String. The name of the share
+    # * +options+                   - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                  - Integer. A timeout in seconds.
+    # * +:request_id+               - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded 
+    #                                 in the analytics logs when storage analytics logging is enabled.
+    #
+    # See https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/get-share-acl
+    #
+    # Returns a tuple of (share, signed_identifiers)
+    #   share                       - A Azure::Storage::File::Share::Share instance
+    #   signed_identifiers          - A list of Azure::Storage::Service::SignedIdentifier instances
+    #
+    def get_share_acl(name, options={})
+      # Query
+      query = { 'comp' => 'acl' }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+      
+      # Call
+      response = call(:get, share_uri(name, query), nil, {}, options)
+
+      # Result
+      share = Serialization.share_from_headers(response.headers)
+      share.name = name
+
+      signed_identifiers = nil
+      signed_identifiers = Serialization.signed_identifiers_from_xml(response.body) if response.body != nil && response.body.length > 0
+
+      return share, signed_identifiers
+    end
+
+    # Public: Sets stored access policies the share.
+    #
+    # ==== Attributes
+    #
+    # * +name+                         - String. The name of the share
+    # * +options+                      - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:signed_identifiers+          - Array. A list of Azure::Storage::Service::SignedIdentifier instances.
+    # * +:timeout+                     - Integer. A timeout in seconds.
+    # * +:request_id+                  - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded 
+    #                                    in the analytics logs when storage analytics logging is enabled.
+    # 
+    # See https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/set-share-acl
+    #
+    # Returns a tuple of (share, signed_identifiers)
+    # * +share+                        - A Azure::Storage::File::Share::Share instance
+    # * +signed_identifiers+           - A list of Azure::Storage::Service::SignedIdentifier instances
+    #
+    def set_share_acl(name, options={})
+      # Query
+      query = { 'comp' => 'acl' }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Scheme + path
+      uri = share_uri(name, query)
+
+      # Headers + body
+      headers = StorageService.common_headers
+
+      signed_identifiers = options[:signed_identifiers] ? options[:signed_identifiers] : nil
+      body = signed_identifiers ? Serialization.signed_identifiers_to_xml(signed_identifiers) : nil
+
+      # Call
+      response = call(:put, uri, body, headers, options)
+
+      # Result
+      share = Serialization.share_from_headers(response.headers)
+      share.name = name
+
+      return share, signed_identifiers || []
+    end
+
+    # Public: Retrieves statistics related to the share.
+    #
+    # ==== Attributes
+    #
+    # * +name+                      - String. The name of the share
+    # * +options+                   - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                  - Integer. A timeout in seconds.
+    # * +:request_id+               - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded 
+    #                                 in the analytics logs when storage analytics logging is enabled.
+    #
+    # See https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/get-share-stats
+    #
+    # Returns a Share
+    def get_share_stats(name, options={})
+      # Query
+      query = { 'comp' => 'stats' }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Call
+      response = call(:get, share_uri(name, query), nil, {}, options)
+
+      # result
+      share = Serialization.share_from_headers(response.headers)
+      share.name = name
+      share.usage = Serialization.share_stats_from_xml(response.body)
+      share
+    end
+  end
+end