qingstor-sdk 1.9.3 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 077caf573d40509928daa24c05cfc408e48507d3
-  data.tar.gz: fd249954ffe298be5d12febad583f88f2124d13b
+  metadata.gz: 33359165658b13aa899f8ffdbb30f2562f9c0db9
+  data.tar.gz: ccb554de7a1c9c00ee90963655cb6c877dbe74ff
 SHA512:
-  metadata.gz: 96ca254d7e4090112d58ff1da2cf7917dad9148a188b0cf38aa3f7f961ec482c2ec9643e8456e8a13fb4cd910c6e91d3ca3e89e17eeaa4721f402fd48978beb9
-  data.tar.gz: 58002a2563f7f51147386998c8fe4ec9a910068f3e5840ff6e41a37163a1737edcdba68ae598e3ee697b12fc09027f551de4627277893a6663af55386d951442
+  metadata.gz: 8752923dafeeffbb74d46f4cc0054d23e7a066640f5762a00ad9732d27eb99055672dd01b958d3f7fd043b9cb8cdd0eea1b11767978650d835fb26f7da38a484
+  data.tar.gz: 00ffd9672d3f59322029a0afd5fe958b25c704f00deba2f80570e7d5c2535ee957aefd0ab216744b7f59e47ec21ffc8c5ad1b61f6c3bbaaa757426550ed482c5

data/README.md

@@ -1,15 +1,19 @@
 # QingStor::SDK
 
+<span style="display: inline-block">
 [![Build Status](https://travis-ci.org/yunify/qingstor-sdk-ruby.svg?branch=master)](https://travis-ci.org/yunify/qingstor-sdk-ruby)
 [![Gem Version](https://badge.fury.io/rb/qingstor-sdk.svg)](http://badge.fury.io/rb/qingstor-sdk)
 [![API Reference](http://img.shields.io/badge/api-reference-green.svg)](https://docs.qingcloud.com/qingstor/)
 [![License](http://img.shields.io/badge/license-apache%20v2-blue.svg)](https://github.com/yunify/qingstor-sdk-ruby/blob/master/LICENSE)
+</span>
 
 The official QingStor SDK for Ruby programming language.
 
 ## Installation
 
-The current code branch is intended to be compatible with Ruby v1.9.x. If you are using Ruby v2.1 or higher, please checkout the [master][master] branch.
+This Gem uses Ruby's _keyword arguments_ feature, thus Ruby 2.1.5 or higher is
+required.  See [this article](https://robots.thoughtbot.com/ruby-2-keyword-arguments)
+for more details about _keyword arguments_.
 
 ### Install from RubyGems
 
@@ -36,7 +40,7 @@ $ bundle install
 Get code from GitHub:
 
 ``` bash
-$ git clone git@github.com:yunify/qingstor-sdk-ruby.git
+$ git clone git@https://github.com/yunify/qingstor-sdk-ruby.git
 ```
 
 Build and install with bundler:
@@ -62,8 +66,8 @@ otherwise.
 ___API Access Key Example:___
 
 ``` yaml
-access_key_id: 'ACCESS_KEY_ID_EXAMPLE'
-secret_access_key: 'SECRET_ACCESS_KEY_EXAMPLE'
+access_key_id: 'WMAGPAJBJRKQEBRCEADPWMAGPAJBJRK'
+secret_access_key: 'Qkk89OcoIaMVZ0iOfnfivjxL7W5o7oOumMvvUiuF'
 ```
 
 ### Code Example
@@ -160,40 +164,6 @@ connection_retries: 3
 log_level: 'warn'
 ```
 
-## Change Log
-All notable changes to QingStor SDK for Ruby will be documented here.
-
-### [v1.9.3] - 2017-03-15
-
-#### Added
-
-- Allow user to append additional info to User-Agent.
-- Add request parameters for GET Object.
-- Add IP address conditions for bucket policy.
-
-### Fixed
-
-- Resource is not mandatory in bucket policy statement.
-
-### [v1.9.2] - 2017-01-23
-
-#### Fixed
-
-- Fix request builder.
-- Fix dependencies.
-
-### [v1.9.1] - 2017-01-16
-
-#### Fixed
-
-- Fix request signer.
-
-### v1.9.0 - 2017-01-13
-
-#### Changed
-
-- Be compatible with Ruby v1.9.x.
-
 ## Reference Documentations
 
 - [QingStor Documentation](https://docs.qingcloud.com/qingstor/index.html)
@@ -202,17 +172,8 @@ All notable changes to QingStor SDK for Ruby will be documented here.
 
 ## Contributing
 
-1. Fork it ( https://github.com/yunify/qingstor-sdk-ruby/fork )
-2. Create your feature branch (`git checkout -b new-feature`)
-3. Commit your changes (`git commit -asm 'Add some feature'`)
-4. Push to the branch (`git push origin new-feature`)
-5. Create a new Pull Request
+This repository is automatically generated, please contribute to [`Snips`](https://github.com/yunify/snips) instead.
 
 ## LICENSE
 
 The Apache License (Version 2.0, January 2004).
-
-[master]: https://github.com/yunify/qingstor-sdk-ruby/tree/master
-[v1.9.3]: https://github.com/yunify/qingstor-sdk-ruby/compare/v1.9.2...v1.9.3
-[v1.9.2]: https://github.com/yunify/qingstor-sdk-ruby/compare/v1.9.1...v1.9.2
-[v1.9.1]: https://github.com/yunify/qingstor-sdk-ruby/compare/v1.9.0...v1.9.1

data/lib/qingstor/sdk/general/config.rb

@@ -46,23 +46,6 @@ module QingStor
         self
       end
 
-      def check
-        [:access_key_id, :secret_access_key, :host, :port, :protocol].each do |x|
-          if !self[x] || self[x].to_s.empty?
-            raise ConfigurationError, "#{x.to_sym} not specified"
-          end
-        end
-        if self[:additional_user_agent] && !self[:additional_user_agent].empty?
-          self[:additional_user_agent].each_byte do |x|
-            # Allow space(32) to ~(126) in ASCII Table, exclude "(34).
-            if x < 32 || x > 126 || x == 32 || x == 34
-              raise ConfigurationError, 'additional User-Agent contains characters that not allowed'
-            end
-          end
-        end
-        self
-      end
-
       def load_default_config
         load_config_from_file Contract::DEFAULT_CONFIG_FILEPATH
       end

data/lib/qingstor/sdk/general/default/config.yaml

@@ -1,15 +1,12 @@
 # QingStor services configuration
 
-#access_key_id: ACCESS_KEY_ID
-#secret_access_key: SECRET_ACCESS_KEY
+#access_key_id: 'ACCESS_KEY_ID'
+#secret_access_key: 'SECRET_ACCESS_KEY'
 
-host: qingstor.com
+host: 'qingstor.com'
 port: 443
-protocol: https
+protocol: 'https'
 connection_retries: 3
 
-# Additional User-Agent
-additional_user_agent: ""
-
 # Valid log levels are "debug", "info", "warn", "error", and "fatal".
-log_level: warn
+log_level: 'warn'

data/lib/qingstor/sdk/general/error.rb

@@ -14,21 +14,11 @@
 #  | limitations under the License.
 #  +-------------------------------------------------------------------------
 
-module QingStor
+module QingCloud
   module SDK
     class SDKError < StandardError
     end
 
-    class ConfigurationError < SDKError
-      def initialize(error_message)
-        @error_message = error_message
-      end
-
-      def message
-        "configuration is not valid, #{@error_message}"
-      end
-    end
-
     class NetworkError < SDKError
     end
 

data/lib/qingstor/sdk/request/preprocessor.rb

@@ -14,10 +14,6 @@
 #  | limitations under the License.
 #  +-------------------------------------------------------------------------
 
-require 'cgi'
-require 'base64'
-require 'digest'
-
 require 'active_support/core_ext/hash/keys'
 require 'mimemagic'
 
@@ -30,7 +26,6 @@ module QingStor
         input[:request_uri]      = request_uri input
         input[:request_body]     = request_body input
         input[:request_headers]  = request_headers input
-        input[:request_params]   = request_params input
 
         display = {}
         input.each { |k, v| display[k] = v unless k.to_s == 'request_body' }
@@ -51,7 +46,7 @@ module QingStor
       def self.request_uri(input)
         unless input[:properties].nil?
           input[:properties].each do |k, v|
-            input[:request_uri].gsub! "<#{k}>", (escape v.to_s)
+            input[:request_uri].gsub! "<#{k}>", v.to_s
           end
         end
         input[:request_uri]
@@ -59,14 +54,7 @@ module QingStor
 
       def self.request_body(input)
         body = input[:request_body]
-        body = body.is_a?(File) ? body.read : body
-        return body if body
-
-        if input[:request_elements] && !input[:request_elements].empty?
-          json_body = JSON.generate input[:request_elements]
-          Logger.info "QingStor request json: [#{input[:id]}] #{json_body}"
-          json_body
-        end
+        body.is_a?(File) ? body.read : body
       end
 
       def self.request_headers(input)
@@ -91,33 +79,12 @@ module QingStor
           input[:request_headers][:'Content-Type'] = 'application/octet-stream'
         end
         unless input[:request_headers][:'User-Agent']
-          ua = "qingstor-sdk-ruby/#{QingStor::SDK::VERSION} (Ruby v#{RUBY_VERSION}; #{RUBY_PLATFORM})"
-          if input[:config][:additional_user_agent] && !input[:config][:additional_user_agent].empty?
-            ua = "#{ua} #{input[:config][:additional_user_agent]}"
-          end
+          ua = "QingStorSDK/#{QingStor::SDK::VERSION} (Ruby v#{RUBY_VERSION}; #{RUBY_PLATFORM})"
           input[:request_headers][:'User-Agent'] = ua
         end
-
-        if input[:api_name] == 'Delete Multiple Objects'
-          input[:request_headers][:'Content-MD5'] = Base64.encode64(Digest::MD5.digest(input[:request_body])).strip
-        end
-
-        input[:request_headers].map do |k, v|
-          input[:request_headers][k] = escape v.to_s unless v.to_s.ascii_only?
-        end
-
         input[:request_headers]
       end
 
-      def self.request_params(input)
-        unless input[:request_params].nil?
-          input[:request_params].map do |k, v|
-            input[:request_params][k] = escape v.to_s
-          end
-        end
-        input[:request_params]
-      end
-
       def self.decorate_input(input)
         input.deep_symbolize_keys!
         input[:id] = (Random.new.rand * 1_000_000).to_int
@@ -131,14 +98,6 @@ module QingStor
         end
         object
       end
-
-      def self.escape(origin)
-        origin = CGI.escape origin
-        origin.gsub! '%2F', '/'
-        origin.gsub! '%3D', '='
-        origin.gsub! '+', '%20'
-        origin
-      end
     end
   end
 end

data/lib/qingstor/sdk/request/request.rb

@@ -14,7 +14,6 @@
 #  | limitations under the License.
 #  +-------------------------------------------------------------------------
 
-require 'uri'
 require 'time'
 require 'json'
 require 'net/http'
@@ -63,15 +62,12 @@ module QingStor
 
       def build
         params           = input[:request_params].map { |k, v| "#{k}=#{v}" }
-        query_string     = params.join '&'
-        if query_string && !query_string.empty?
-          query_string = "#{input[:request_uri].include?('?') ? '&' : '?'}#{query_string}"
-        end
-        self.request_url = URI "#{input[:request_endpoint]}#{input[:request_uri]}#{query_string}"
+        query_string     = !params.empty? ? "?#{params.join '&'}" : ''
+        self.request_url = "#{input[:request_endpoint]}#{Signer.escape input[:request_uri]}#{query_string}"
 
-        request      = new_http_request input[:request_method], request_url.to_s
-        request.body = input[:request_body]
-        input[:request_headers].each { |k, v| request[k.to_s] = v }
+        request      = new_http_request input[:request_method], request_url
+        request.body = build_request_body input[:request_body], input[:request_elements]
+        input[:request_headers].each { |k, v| request.add_field k.to_s, v }
 
         self.http_request = request
       end
@@ -106,6 +102,18 @@ module QingStor
         end
       end
 
+      def build_request_body(request_body, request_elements)
+        if request_body
+          request_body
+        elsif request_elements
+          unless request_elements.empty?
+            json_body = JSON.generate request_elements
+            Logger.info "QingStor request json: [#{input[:id]}] #{json_body}"
+            json_body
+          end
+        end
+      end
+
       def new_http_request(method, url)
         case method
         when 'GET'

data/lib/qingstor/sdk/request/signer.rb

@@ -87,22 +87,29 @@ module QingStor
       end
 
       def self.canonicalized_resource(input)
+        path = escape input[:request_uri]
+
         params = input[:request_params].keys.sort.map { |k|
           if sub_resource? k.to_s
             v = input[:request_params][k].to_s.strip
-            !v.nil? && v != '' ? "#{k}=#{CGI.unescape v}" : k
+            !v.nil? && v != '' ? "#{k}=#{escape v}" : k
           end
         }.compact.join '&'
-        params = input[:request_uri].include?('?') ? "&#{params}" : "?#{params}" if params != ''
-        "#{input[:request_uri]}#{params}"
+        params = path.include?('?') ? "&#{params}" : "?#{params}" if params != ''
+        "#{path}#{params}"
+      end
+
+      def self.escape(original)
+        result = CGI.escape(original)
+        result.gsub! '%3F', '?'
+        result.gsub! '%2F', '/'
+        result.gsub! '+', '%20'
+        result.gsub! '%2B', '+'
+        result
       end
 
       def self.sub_resource?(key)
-        %w(
-          acl cors delete mirror part_number policy stats upload_id uploads
-          response-expires response-cache-control response-content-type
-          response-content-language response-content-encoding response-content-disposition
-        ).include? key
+        %w(acl cors delete mirror part_number policy stats upload_id uploads).include? key
       end
     end
   end

data/lib/qingstor/sdk/service/bucket.rb

@@ -28,18 +28,12 @@ module QingStor
 
       # delete_bucket: Delete a bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/delete.html
-      #
-      # == Options
-      #
-      #
-      def delete(options = {})
-        options.deep_stringify_keys!
-        request = delete_request options
+      def delete
+        request = delete_request
         request.send
       end
 
-      def delete_request(options = {})
-        options.deep_stringify_keys!
+      def delete_request
         input = {
           config:           config,
           properties:       properties,
@@ -52,7 +46,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             204, # Bucket deleted
           ],
@@ -72,18 +68,12 @@ module QingStor
 
       # delete_bucket_cors: Delete CORS information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/cors/delete_cors.html
-      #
-      # == Options
-      #
-      #
-      def delete_cors(options = {})
-        options.deep_stringify_keys!
-        request = delete_cors_request options
+      def delete_cors
+        request = delete_cors_request
         request.send
       end
 
-      def delete_cors_request(options = {})
-        options.deep_stringify_keys!
+      def delete_cors_request
         input = {
           config:           config,
           properties:       properties,
@@ -96,7 +86,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -116,18 +108,12 @@ module QingStor
 
       # delete_bucket_external_mirror: Delete external mirror of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/external_mirror/delete_external_mirror.html
-      #
-      # == Options
-      #
-      #
-      def delete_external_mirror(options = {})
-        options.deep_stringify_keys!
-        request = delete_external_mirror_request options
+      def delete_external_mirror
+        request = delete_external_mirror_request
         request.send
       end
 
-      def delete_external_mirror_request(options = {})
-        options.deep_stringify_keys!
+      def delete_external_mirror_request
         input = {
           config:           config,
           properties:       properties,
@@ -140,7 +126,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             204, # No content
           ],
@@ -160,18 +148,12 @@ module QingStor
 
       # delete_bucket_policy: Delete policy information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/policy/delete_policy.html
-      #
-      # == Options
-      #
-      #
-      def delete_policy(options = {})
-        options.deep_stringify_keys!
-        request = delete_policy_request options
+      def delete_policy
+        request = delete_policy_request
         request.send
       end
 
-      def delete_policy_request(options = {})
-        options.deep_stringify_keys!
+      def delete_policy_request
         input = {
           config:           config,
           properties:       properties,
@@ -184,7 +166,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             204, # No content
           ],
@@ -204,21 +188,15 @@ module QingStor
 
       # delete_multiple_objects: Delete multiple objects from the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/delete_multiple.html
-      #
-      # == Options
-      #
-      # * +:content_md5+ - Object MD5sum
-      # * +:objects+ - A list of keys to delete
-      # * +:quiet+ - Whether to return the list of deleted objects
-      #
-      def delete_multiple_objects(options = {})
-        options.deep_stringify_keys!
-        request = delete_multiple_objects_request options
+      def delete_multiple_objects(content_md5: '', objects: [],
+                                  quiet: nil)
+        request = delete_multiple_objects_request content_md5: content_md5, objects: objects,
+          quiet: quiet
         request.send
       end
 
-      def delete_multiple_objects_request(options = {})
-        options.deep_stringify_keys!
+      def delete_multiple_objects_request(content_md5: '', objects: [],
+                                          quiet: nil)
         input = {
           config:           config,
           properties:       properties,
@@ -228,12 +206,15 @@ module QingStor
           request_params:   {
           },
           request_headers:  {
+            'Content-MD5' => content_md5,
           },
           request_elements: {
-            'objects' => options['objects'],
-            'quiet'   => options['quiet'],
+            'objects' => objects,
+            'quiet'   => quiet,
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -248,6 +229,10 @@ module QingStor
       def delete_multiple_objects_input_validate(input)
         input.deep_stringify_keys!
 
+        unless !input['request_headers']['Content-MD5'].nil? && !input['request_headers']['Content-MD5'].to_s.empty?
+          raise ParameterRequiredError.new('Content-MD5', 'DeleteMultipleObjectsInput')
+        end
+
         unless !input['request_elements']['objects'].nil? && !input['request_elements']['objects'].to_s.empty?
           raise ParameterRequiredError.new('objects', 'DeleteMultipleObjectsInput')
         end
@@ -260,18 +245,12 @@ module QingStor
 
       # get_bucket_acl: Get ACL information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/get_acl.html
-      #
-      # == Options
-      #
-      #
-      def get_acl(options = {})
-        options.deep_stringify_keys!
-        request = get_acl_request options
+      def get_acl
+        request = get_acl_request
         request.send
       end
 
-      def get_acl_request(options = {})
-        options.deep_stringify_keys!
+      def get_acl_request
         input = {
           config:           config,
           properties:       properties,
@@ -284,7 +263,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -304,18 +285,12 @@ module QingStor
 
       # get_bucket_cors: Get CORS information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/cors/get_cors.html
-      #
-      # == Options
-      #
-      #
-      def get_cors(options = {})
-        options.deep_stringify_keys!
-        request = get_cors_request options
+      def get_cors
+        request = get_cors_request
         request.send
       end
 
-      def get_cors_request(options = {})
-        options.deep_stringify_keys!
+      def get_cors_request
         input = {
           config:           config,
           properties:       properties,
@@ -328,7 +303,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -348,18 +325,12 @@ module QingStor
 
       # get_bucket_external_mirror: Get external mirror of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/external_mirror/get_external_mirror.html
-      #
-      # == Options
-      #
-      #
-      def get_external_mirror(options = {})
-        options.deep_stringify_keys!
-        request = get_external_mirror_request options
+      def get_external_mirror
+        request = get_external_mirror_request
         request.send
       end
 
-      def get_external_mirror_request(options = {})
-        options.deep_stringify_keys!
+      def get_external_mirror_request
         input = {
           config:           config,
           properties:       properties,
@@ -372,7 +343,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -392,18 +365,12 @@ module QingStor
 
       # get_bucket_policy: Get policy information of the bucket.
       # Documentation URL: https://https://docs.qingcloud.com/qingstor/api/bucket/policy/get_policy.html
-      #
-      # == Options
-      #
-      #
-      def get_policy(options = {})
-        options.deep_stringify_keys!
-        request = get_policy_request options
+      def get_policy
+        request = get_policy_request
         request.send
       end
 
-      def get_policy_request(options = {})
-        options.deep_stringify_keys!
+      def get_policy_request
         input = {
           config:           config,
           properties:       properties,
@@ -416,7 +383,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -436,18 +405,12 @@ module QingStor
 
       # get_bucket_statistics: Get statistics information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/get_stats.html
-      #
-      # == Options
-      #
-      #
-      def get_statistics(options = {})
-        options.deep_stringify_keys!
-        request = get_statistics_request options
+      def get_statistics
+        request = get_statistics_request
         request.send
       end
 
-      def get_statistics_request(options = {})
-        options.deep_stringify_keys!
+      def get_statistics_request
         input = {
           config:           config,
           properties:       properties,
@@ -460,7 +423,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -480,18 +445,12 @@ module QingStor
 
       # head_bucket: Check whether the bucket exists and available.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/head.html
-      #
-      # == Options
-      #
-      #
-      def head(options = {})
-        options.deep_stringify_keys!
-        request = head_request options
+      def head
+        request = head_request
         request.send
       end
 
-      def head_request(options = {})
-        options.deep_stringify_keys!
+      def head_request
         input = {
           config:           config,
           properties:       properties,
@@ -504,7 +463,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -522,76 +483,23 @@ module QingStor
 
       public
 
-      # list_multipart_uploads: List multipart uploads in the bucket.
-      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/list_multipart_uploads.html
-      #
-      # == Options
-      #
-      # * +:delimiter+ - Put all keys that share a common prefix into a list
-      # * +:limit+ - Results count limit
-      # * +:marker+ - Limit results to keys that start at this marker
-      # * +:prefix+ - Limits results to keys that begin with the prefix
-      #
-      def list_multipart_uploads(options = {})
-        options.deep_stringify_keys!
-        request = list_multipart_uploads_request options
-        request.send
-      end
-
-      def list_multipart_uploads_request(options = {})
-        options.deep_stringify_keys!
-        input = {
-          config:           config,
-          properties:       properties,
-          api_name:         'List Multipart Uploads',
-          request_method:   'GET',
-          request_uri:      '/<bucket-name>?uploads',
-          request_params:   {
-            'delimiter' => options['delimiter'],
-            'limit'     => options['limit'],
-            'marker'    => options['marker'],
-            'prefix'    => options['prefix'],
-          },
-          request_headers:  {
-          },
-          request_elements: {
-          },
-          request_body:     nil,
-          status_code:      [
-            200, # OK
-          ],
-        }
-
-        list_multipart_uploads_input_validate input
-        Request.new input
-      end
-
-      private
-
-      def list_multipart_uploads_input_validate(input)
-        input.deep_stringify_keys!
-      end
-
-      public
-
       # list_objects: Retrieve the object list in a bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/get.html
-      #
-      # == Options
-      #
-      # * +:delimiter+ - Put all keys that share a common prefix into a list
-      # * +:limit+ - Results count limit
-      # * +:marker+ - Limit results to keys that start at this marker
-      # * +:prefix+ - Limits results to keys that begin with the prefix
-      #
-      def list_objects(options = {})
-        options.deep_stringify_keys!
-        request = list_objects_request options
+      def list_objects(delimiter: '',
+                       limit: nil,
+                       marker: '',
+                       prefix: '')
+        request = list_objects_request delimiter: delimiter,
+                                       limit:     limit,
+                                       marker:    marker,
+                                       prefix:    prefix
         request.send
       end
 
-      def list_objects_request(options = {})
-        options.deep_stringify_keys!
+      def list_objects_request(delimiter: '',
+                               limit: nil,
+                               marker: '',
+                               prefix: '')
         input = {
           config:           config,
           properties:       properties,
@@ -599,16 +507,18 @@ module QingStor
           request_method:   'GET',
           request_uri:      '/<bucket-name>',
           request_params:   {
-            'delimiter' => options['delimiter'],
-            'limit'     => options['limit'],
-            'marker'    => options['marker'],
-            'prefix'    => options['prefix'],
+            'delimiter' => delimiter,
+            'limit'     => limit,
+            'marker'    => marker,
+            'prefix'    => prefix,
           },
           request_headers:  {
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -628,18 +538,12 @@ module QingStor
 
       # put_bucket: Create a new bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/put.html
-      #
-      # == Options
-      #
-      #
-      def put(options = {})
-        options.deep_stringify_keys!
-        request = put_request options
+      def put
+        request = put_request
         request.send
       end
 
-      def put_request(options = {})
-        options.deep_stringify_keys!
+      def put_request
         input = {
           config:           config,
           properties:       properties,
@@ -652,7 +556,9 @@ module QingStor
           },
           request_elements: {
           },
+
           request_body:     nil,
+
           status_code:      [
             201, # Bucket created
           ],
@@ -672,19 +578,12 @@ module QingStor
 
       # put_bucket_acl: Set ACL information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/put_acl.html
-      #
-      # == Options
-      #
-      # * +:acl+ - Bucket ACL rules
-      #
-      def put_acl(options = {})
-        options.deep_stringify_keys!
-        request = put_acl_request options
+      def put_acl(acl: [])
+        request = put_acl_request acl: acl
         request.send
       end
 
-      def put_acl_request(options = {})
-        options.deep_stringify_keys!
+      def put_acl_request(acl: [])
         input = {
           config:           config,
           properties:       properties,
@@ -696,9 +595,11 @@ module QingStor
           request_headers:  {
           },
           request_elements: {
-            'acl' => options['acl'],
+            'acl' => acl,
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -758,19 +659,12 @@ module QingStor
 
       # put_bucket_cors: Set CORS information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/cors/put_cors.html
-      #
-      # == Options
-      #
-      # * +:cors_rules+ - Bucket CORS rules
-      #
-      def put_cors(options = {})
-        options.deep_stringify_keys!
-        request = put_cors_request options
+      def put_cors(cors_rules: [])
+        request = put_cors_request cors_rules: cors_rules
         request.send
       end
 
-      def put_cors_request(options = {})
-        options.deep_stringify_keys!
+      def put_cors_request(cors_rules: [])
         input = {
           config:           config,
           properties:       properties,
@@ -782,9 +676,11 @@ module QingStor
           request_headers:  {
           },
           request_elements: {
-            'cors_rules' => options['cors_rules'],
+            'cors_rules' => cors_rules,
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -818,19 +714,12 @@ module QingStor
 
       # put_bucket_external_mirror: Set external mirror of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/external_mirror/put_external_mirror.html
-      #
-      # == Options
-      #
-      # * +:source_site+ - Source site url
-      #
-      def put_external_mirror(options = {})
-        options.deep_stringify_keys!
-        request = put_external_mirror_request options
+      def put_external_mirror(source_site: '')
+        request = put_external_mirror_request source_site: source_site
         request.send
       end
 
-      def put_external_mirror_request(options = {})
-        options.deep_stringify_keys!
+      def put_external_mirror_request(source_site: '')
         input = {
           config:           config,
           properties:       properties,
@@ -842,9 +731,11 @@ module QingStor
           request_headers:  {
           },
           request_elements: {
-            'source_site' => options['source_site'],
+            'source_site' => source_site,
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -868,19 +759,12 @@ module QingStor
 
       # put_bucket_policy: Set policy information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/policy/put_policy.html
-      #
-      # == Options
-      #
-      # * +:statement+ - Bucket policy statement
-      #
-      def put_policy(options = {})
-        options.deep_stringify_keys!
-        request = put_policy_request options
+      def put_policy(statement: [])
+        request = put_policy_request statement: statement
         request.send
       end
 
-      def put_policy_request(options = {})
-        options.deep_stringify_keys!
+      def put_policy_request(statement: [])
         input = {
           config:           config,
           properties:       properties,
@@ -892,9 +776,11 @@ module QingStor
           request_headers:  {
           },
           request_elements: {
-            'statement' => options['statement'],
+            'statement' => statement,
           },
+
           request_body:     nil,
+
           status_code:      [
             200, # OK
           ],
@@ -920,18 +806,10 @@ module QingStor
 
           unless x['condition'].nil?
 
-            unless x['condition']['ip_address'].nil?
-
-            end
-
             unless x['condition']['is_null'].nil?
 
             end
 
-            unless x['condition']['not_ip_address'].nil?
-
-            end
-
             unless x['condition']['string_like'].nil?
 
             end
@@ -961,6 +839,10 @@ module QingStor
             raise ParameterRequiredError.new('id', 'statement')
           end
 
+          unless !x['resource'].nil? && !x['resource'].to_s.empty?
+            raise ParameterRequiredError.new('resource', 'statement')
+          end
+
           unless !x['user'].nil? && !x['user'].to_s.empty?
             raise ParameterRequiredError.new('user', 'statement')
           end