qingstor-sdk 2.2.1 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: c85e73c270e2630d4e2499bd7ef31f1b6e246d2d
-  data.tar.gz: 1b3a584bbee63df761921a43d4f8270ae42beab0
+SHA256:
+  metadata.gz: cb83b84c4cd53131d0092b26061348057db9f2af57d1d4670bc5cef3b36c12b8
+  data.tar.gz: 0c2d01a2a0d134540e57e11cdeaef5f5547cb613b3b8a1ee5a2e531302391a15
 SHA512:
-  metadata.gz: 8246701fa0c00c9959dce2e967984fdb9427c0378272eb510766fab145b3a276e4b79d0e275190e297275f96939f82cdce8016e1f3f34a6280e917fc36461c64
-  data.tar.gz: ac8bc039c6f9be943efae10848bfdc03b225e2d5a7264510f900de43b940998ae7734fcb7d36676d1c65b8b932b4eb53aaf58fb59741197133e538756a0e2c9d
+  metadata.gz: bf9f6e59304fa869921e5300b57560f5fae7728b9bb521a6ffc2d1d1d03783871dc03b68b9f08ffa875afef7a0210b237d518f8fd30d24260e6db14a766ce7ad
+  data.tar.gz: 394b4f14aea92f46e8b511dbbd283a4e08a9f7d28ef1f5f71e87e0eae63ee32c4bd30a172266638efd9a715fe81a70c91c7dec0c738dabec2eed1175c5376c45

data/README.md

@@ -1,11 +1,10 @@
 # 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)
+[![Build Status](https://github.com/qingstor/qingstor-sdk-ruby/workflows/Unit%20Test/badge.svg?branch=master)](https://github.com/qingstor/qingstor-sdk-ruby/actions?query=workflow%3A%22Unit+Test%22)
 [![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>
+[![Join the chat](https://img.shields.io/badge/chat-online-blue?style=flat&logo=zulip)](https://qingstor.zulipchat.com/join/odapi42t7xhqc7v4gb2wfgjx/)
 
 The official QingStor SDK for Ruby programming language.
 
@@ -169,11 +168,52 @@ log_level: 'warn'
 ## Change Log
 All notable changes to QingStor SDK for Ruby will be documented here.
 
+### [v2.4.0] - 2021-01-05
+
+### Added
+
+- Support to set x-qs-metadata-directive header (#29)
+- Add support for bucket replication (#45)
+
+### Changed
+
+- ci: Transfer ci into github action (#30)
+
+### Fixed
+
+- Fix metadata added into signature when empty (#44)
+
+### [v2.3.0] - 2020-05-11
+
+### Added
+
+- Add support for lifecycle and notification.
+- Add support for bucket logging, bucket cname and append object. (#24)
+
+### Fixed
+
+- Modify content-type check for application/json. (#21)
+- Fix sub-resources not be recognized when generate signature. (#25)
+- Fix meta data not work as intended. (#26)
+- Reverse fix of empty map in template, should not compact empty hash when sign. (#28)
+
+### [v2.2.3] - 2017-03-28
+
+### Fixed
+
+- Fix status code of DELETE CORS API.
+
+### [v2.2.2] - 2017-03-10
+
+### Fixed
+
+- Resource is not mandatory in bucket policy statement.
+
 ### [v2.2.1] - 2017-03-10
 
 #### Added
 
-- Allow user to append additional info to User-Agent
+- Allow user to append additional info to User-Agent.
 
 ### [v2.2.0] - 2017-02-28
 
@@ -234,6 +274,10 @@ All notable changes to QingStor SDK for Ruby will be documented here.
 The Apache License (Version 2.0, January 2004).
 
 [compatible]: https://github.com/yunify/qingstor-sdk-ruby/tree/compatible
+[v2.4.0]: https://github.com/yunify/qingstor-sdk-ruby/compare/v2.3.0...v2.4.0
+[v2.3.0]: https://github.com/yunify/qingstor-sdk-ruby/compare/v2.2.3...v2.3.0
+[v2.2.3]: https://github.com/yunify/qingstor-sdk-ruby/compare/v2.2.2...v2.2.3
+[v2.2.2]: https://github.com/yunify/qingstor-sdk-ruby/compare/v2.2.1...v2.2.2
 [v2.2.1]: https://github.com/yunify/qingstor-sdk-ruby/compare/v2.2.0...v2.2.1
 [v2.2.0]: https://github.com/yunify/qingstor-sdk-ruby/compare/v2.1.1...v2.2.0
 [v2.1.1]: https://github.com/yunify/qingstor-sdk-ruby/compare/v2.1.0...v2.1.1

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

@@ -29,7 +29,7 @@ module QingStor
       def self.init(access_key_id, secret_access_key)
         initial_config = {
           access_key_id:     access_key_id,
-          secret_access_key: secret_access_key,
+          secret_access_key: secret_access_key
         }
         Config.new(initial_config)
       end
@@ -47,7 +47,7 @@ module QingStor
       end
 
       def check
-        [:access_key_id, :secret_access_key, :host, :port, :protocol].each do |x|
+        %i[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

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

@@ -23,7 +23,7 @@ module QingStor
       @@level = :warn
 
       def self.set_level(level)
-        index = %w(debug info warn error fatal).find_index level.to_s
+        index = %w[debug info warn error fatal].find_index level.to_s
         @@logger.level = index.nil? ? 0 : index
         @@level = level.to_sym
       end

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

@@ -102,6 +102,24 @@ module QingStor
           input[:request_headers][:'Content-MD5'] = Base64.encode64(Digest::MD5.digest(input[:request_body])).strip
         end
 
+        unless input[:request_headers][:'X-QS-MetaData'].nil?
+          if input[:request_headers][:'X-QS-MetaData'].is_a?(Hash) && !input[:request_headers][:'X-QS-MetaData'].empty?
+            prefix = 'x-qs-meta-'
+            input[:request_headers][:'X-QS-MetaData'].each do |k, v|
+              k = k.to_s
+              # check whether meta header has prefix
+              if k.downcase.start_with? prefix
+                suffix_len = prefix.size - k.size
+                k = prefix + k[suffix_len, -suffix_len]
+              else
+                k = prefix + k
+              end
+              input[:request_headers][:"#{k}"] = v
+            end
+          end
+          input[:request_headers].delete :'X-QS-MetaData'
+        end
+
         input[:request_headers].map do |k, v|
           input[:request_headers][k] = escape v.to_s unless v.to_s.ascii_only?
         end
@@ -127,7 +145,7 @@ module QingStor
       def self.compact(object)
         object.each do |k, v|
           object[k] = compact v if v.is_a? Hash
-          object.delete k if v.nil? || v == ''
+          object.delete k if v.nil? || v == '' || v == []
         end
         object
       end

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

@@ -62,7 +62,10 @@ module QingStor
 
       def build
         params           = input[:request_params].map { |k, v| "#{k}=#{v}" }
-        query_string     = !params.empty? ? "?#{params.join '&'}" : ''
+        query_string     = params.join '&'
+        if query_string && !query_string.empty?
+          query_string = "#{input[:request_uri].include?('?') ? '&' : '?'}#{query_string}"
+        end
         self.request_url = "#{input[:request_endpoint]}#{input[:request_uri]}#{query_string}"
 
         request      = new_http_request input[:request_method], request_url
@@ -77,7 +80,7 @@ module QingStor
         output['status_code'] = http_response.code.to_i
 
         http_response.each_header { |k, v| output[k.tr('-', '_')] = v }
-        if http_response['Content-Type'] == 'application/json'
+        if http_response['Content-Type'].include? 'application/json'
           unless http_response.body.nil?
             JSON.parse(http_response.body).each { |k, v| output[k] = v }
           end

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

@@ -83,7 +83,7 @@ module QingStor
       def self.canonicalized_headers(input)
         h = {}
         input[:request_headers].each { |k, v| h[k.to_s.strip.downcase] = v.to_s.strip }
-        h.keys.sort.reject { |k| !k.start_with? 'x-qs-' }.map { |k| "#{k}:#{h[k]}\n" }.join ''
+        h.keys.sort.select { |k| k.start_with? 'x-qs-' }.map { |k| "#{k}:#{h[k]}\n" }.join ''
       end
 
       def self.canonicalized_resource(input)
@@ -98,11 +98,12 @@ module QingStor
       end
 
       def self.sub_resource?(key)
-        %w(
-          acl cors delete mirror part_number policy stats upload_id uploads
+        %w[
+          acl append cname cors delete image lifecycle logging mirror
+          notification part_number policy position stats upload_id uploads
           response-expires response-cache-control response-content-type
           response-content-language response-content-encoding response-content-disposition
-        ).include? key
+        ].include? key
       end
     end
   end

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

@@ -47,9 +47,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            204, # Bucket deleted
-          ],
+            204
+          ]
         }
 
         delete_bucket_input_validate input
@@ -64,6 +65,50 @@ module QingStor
 
       public
 
+      # delete_bucket_cname: Delete bucket CNAME setting of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/cname/delete_cname.html
+      def delete_cname(domain: '')
+        request = delete_cname_request domain: domain
+        request.send
+      end
+
+      def delete_cname_request(domain: '')
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'DELETE Bucket CNAME',
+          request_method:   'DELETE',
+          request_uri:      '/<bucket-name>?cname',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+            'domain' => domain
+          },
+          request_body:     nil,
+
+          status_code:      [
+            204
+          ]
+        }
+
+        delete_bucket_cname_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def delete_bucket_cname_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_elements']['domain'].nil? && !input['request_elements']['domain'].to_s.empty?
+          raise ParameterRequiredError.new('domain', 'DeleteBucketCNAMEInput')
+        end
+      end
+
+      public
+
       # delete_bucket_cors: Delete CORS information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/cors/delete_cors.html
       def delete_cors
@@ -85,9 +130,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            204
+          ]
         }
 
         delete_bucket_cors_input_validate input
@@ -123,9 +169,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            204, # No content
-          ],
+            204
+          ]
         }
 
         delete_bucket_external_mirror_input_validate input
@@ -140,6 +187,123 @@ module QingStor
 
       public
 
+      # delete_bucket_lifecycle: Delete Lifecycle information of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/lifecycle/delete_lifecycle.html
+      def delete_lifecycle
+        request = delete_lifecycle_request
+        request.send
+      end
+
+      def delete_lifecycle_request
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'DELETE Bucket Lifecycle',
+          request_method:   'DELETE',
+          request_uri:      '/<bucket-name>?lifecycle',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+          },
+          request_body:     nil,
+
+          status_code:      [
+            204
+          ]
+        }
+
+        delete_bucket_lifecycle_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def delete_bucket_lifecycle_input_validate(input)
+        input.deep_stringify_keys!
+      end
+
+      public
+
+      # delete_bucket_logging: Delete bucket logging setting of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/logging/delete_logging.html
+      def delete_logging
+        request = delete_logging_request
+        request.send
+      end
+
+      def delete_logging_request
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'DELETE Bucket Logging',
+          request_method:   'DELETE',
+          request_uri:      '/<bucket-name>?logging',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+          },
+          request_body:     nil,
+
+          status_code:      [
+            204
+          ]
+        }
+
+        delete_bucket_logging_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def delete_bucket_logging_input_validate(input)
+        input.deep_stringify_keys!
+      end
+
+      public
+
+      # delete_bucket_notification: Delete Notification information of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/notification/delete_notification.html
+      def delete_notification
+        request = delete_notification_request
+        request.send
+      end
+
+      def delete_notification_request
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'DELETE Bucket Notification',
+          request_method:   'DELETE',
+          request_uri:      '/<bucket-name>?notification',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+          },
+          request_body:     nil,
+
+          status_code:      [
+            204
+          ]
+        }
+
+        delete_bucket_notification_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def delete_bucket_notification_input_validate(input)
+        input.deep_stringify_keys!
+      end
+
+      public
+
       # delete_bucket_policy: Delete policy information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/policy/delete_policy.html
       def delete_policy
@@ -161,9 +325,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            204, # No content
-          ],
+            204
+          ]
         }
 
         delete_bucket_policy_input_validate input
@@ -178,6 +343,45 @@ module QingStor
 
       public
 
+      # delete_bucket_replication: Delete Replication information of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/replication/delete_replication.html
+      def delete_replication
+        request = delete_replication_request
+        request.send
+      end
+
+      def delete_replication_request
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'DELETE Bucket Replication',
+          request_method:   'DELETE',
+          request_uri:      '/<bucket-name>?replication',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+          },
+          request_body:     nil,
+
+          status_code:      [
+            204
+          ]
+        }
+
+        delete_bucket_replication_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def delete_bucket_replication_input_validate(input)
+        input.deep_stringify_keys!
+      end
+
+      public
+
       # delete_multiple_objects: Delete multiple objects from the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/delete_multiple.html
       def delete_multiple_objects(objects: [],
@@ -201,12 +405,13 @@ module QingStor
           },
           request_elements: {
             'objects' => objects,
-            'quiet'   => quiet,
+            'quiet'   => quiet
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         delete_multiple_objects_input_validate input
@@ -218,7 +423,7 @@ module QingStor
       def delete_multiple_objects_input_validate(input)
         input.deep_stringify_keys!
 
-        unless !input['request_elements']['objects'].nil? && !input['request_elements']['objects'].to_s.empty?
+        unless !input['request_elements']['objects'].nil? && !input['request_elements']['objects'].empty?
           raise ParameterRequiredError.new('objects', 'DeleteMultipleObjectsInput')
         end
 
@@ -249,9 +454,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_acl_input_validate input
@@ -266,6 +472,57 @@ module QingStor
 
       public
 
+      # get_bucket_cname: Get bucket CNAME setting of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/cname/get_cname.html
+      def get_cname(type: '')
+        request = get_cname_request type: type
+        request.send
+      end
+
+      def get_cname_request(type: '')
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'GET Bucket CNAME',
+          request_method:   'GET',
+          request_uri:      '/<bucket-name>?cname',
+          request_params:   {
+            'type' => type
+          },
+          request_headers:  {
+          },
+          request_elements: {
+          },
+          request_body:     nil,
+
+          status_code:      [
+            200
+          ]
+        }
+
+        get_bucket_cname_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def get_bucket_cname_input_validate(input)
+        input.deep_stringify_keys!
+
+        if input['request_params']['type'] && !input['request_params']['type'].to_s.empty?
+          type_valid_values = %w[website normal]
+          unless type_valid_values.include? input['request_params']['type'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'type',
+              input['request_params']['type'],
+              type_valid_values,
+            )
+          end
+        end
+      end
+
+      public
+
       # get_bucket_cors: Get CORS information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/cors/get_cors.html
       def get_cors
@@ -287,9 +544,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_cors_input_validate input
@@ -325,9 +583,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_external_mirror_input_validate input
@@ -342,6 +601,123 @@ module QingStor
 
       public
 
+      # get_bucket_lifecycle: Get Lifecycle information of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/lifecycle/get_lifecycle.html
+      def get_lifecycle
+        request = get_lifecycle_request
+        request.send
+      end
+
+      def get_lifecycle_request
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'GET Bucket Lifecycle',
+          request_method:   'GET',
+          request_uri:      '/<bucket-name>?lifecycle',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+          },
+          request_body:     nil,
+
+          status_code:      [
+            200
+          ]
+        }
+
+        get_bucket_lifecycle_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def get_bucket_lifecycle_input_validate(input)
+        input.deep_stringify_keys!
+      end
+
+      public
+
+      # get_bucket_logging: Get bucket logging setting of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/logging/get_logging.html
+      def get_logging
+        request = get_logging_request
+        request.send
+      end
+
+      def get_logging_request
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'GET Bucket Logging',
+          request_method:   'GET',
+          request_uri:      '/<bucket-name>?logging',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+          },
+          request_body:     nil,
+
+          status_code:      [
+            200
+          ]
+        }
+
+        get_bucket_logging_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def get_bucket_logging_input_validate(input)
+        input.deep_stringify_keys!
+      end
+
+      public
+
+      # get_bucket_notification: Get Notification information of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/notification/get_notification.html
+      def get_notification
+        request = get_notification_request
+        request.send
+      end
+
+      def get_notification_request
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'GET Bucket Notification',
+          request_method:   'GET',
+          request_uri:      '/<bucket-name>?notification',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+          },
+          request_body:     nil,
+
+          status_code:      [
+            200
+          ]
+        }
+
+        get_bucket_notification_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def get_bucket_notification_input_validate(input)
+        input.deep_stringify_keys!
+      end
+
+      public
+
       # get_bucket_policy: Get policy information of the bucket.
       # Documentation URL: https://https://docs.qingcloud.com/qingstor/api/bucket/policy/get_policy.html
       def get_policy
@@ -349,13 +725,52 @@ module QingStor
         request.send
       end
 
-      def get_policy_request
+      def get_policy_request
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'GET Bucket Policy',
+          request_method:   'GET',
+          request_uri:      '/<bucket-name>?policy',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+          },
+          request_body:     nil,
+
+          status_code:      [
+            200
+          ]
+        }
+
+        get_bucket_policy_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def get_bucket_policy_input_validate(input)
+        input.deep_stringify_keys!
+      end
+
+      public
+
+      # get_bucket_replication: Get Replication information of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/replication/get_replication.html
+      def get_replication
+        request = get_replication_request
+        request.send
+      end
+
+      def get_replication_request
         input = {
           config:           config,
           properties:       properties,
-          api_name:         'GET Bucket Policy',
+          api_name:         'GET Bucket Replication',
           request_method:   'GET',
-          request_uri:      '/<bucket-name>?policy',
+          request_uri:      '/<bucket-name>?replication',
           request_params:   {
           },
           request_headers:  {
@@ -363,18 +778,19 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
-        get_bucket_policy_input_validate input
+        get_bucket_replication_input_validate input
         Request.new input
       end
 
       private
 
-      def get_bucket_policy_input_validate(input)
+      def get_bucket_replication_input_validate(input)
         input.deep_stringify_keys!
       end
 
@@ -401,9 +817,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_statistics_input_validate input
@@ -439,9 +856,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         head_bucket_input_validate input
@@ -459,20 +877,23 @@ module QingStor
       # list_multipart_uploads: List multipart uploads in the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/list_multipart_uploads.html
       def list_multipart_uploads(delimiter: '',
+                                 key_marker: '',
                                  limit: nil,
-                                 marker: '',
-                                 prefix: '')
-        request = list_multipart_uploads_request delimiter: delimiter,
-                                                 limit:     limit,
-                                                 marker:    marker,
-                                                 prefix:    prefix
+                                 prefix: '',
+                                 upload_id_marker: '')
+        request = list_multipart_uploads_request delimiter:        delimiter,
+                                                 key_marker:       key_marker,
+                                                 limit:            limit,
+                                                 prefix:           prefix,
+                                                 upload_id_marker: upload_id_marker
         request.send
       end
 
       def list_multipart_uploads_request(delimiter: '',
+                                         key_marker: '',
                                          limit: nil,
-                                         marker: '',
-                                         prefix: '')
+                                         prefix: '',
+                                         upload_id_marker: '')
         input = {
           config:           config,
           properties:       properties,
@@ -480,19 +901,21 @@ module QingStor
           request_method:   'GET',
           request_uri:      '/<bucket-name>?uploads',
           request_params:   {
-            'delimiter' => delimiter,
-            'limit'     => limit,
-            'marker'    => marker,
-            'prefix'    => prefix,
+            'delimiter'        => delimiter,
+            'key_marker'       => key_marker,
+            'limit'            => limit,
+            'prefix'           => prefix,
+            'upload_id_marker' => upload_id_marker
           },
           request_headers:  {
           },
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         list_multipart_uploads_input_validate input
@@ -534,16 +957,17 @@ module QingStor
             'delimiter' => delimiter,
             'limit'     => limit,
             'marker'    => marker,
-            'prefix'    => prefix,
+            'prefix'    => prefix
           },
           request_headers:  {
           },
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         list_objects_input_validate input
@@ -579,9 +1003,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            201, # Bucket created
-          ],
+            201
+          ]
         }
 
         put_bucket_input_validate input
@@ -615,12 +1040,13 @@ module QingStor
           request_headers:  {
           },
           request_elements: {
-            'acl' => acl,
+            'acl' => acl
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         put_bucket_acl_input_validate input
@@ -632,7 +1058,7 @@ module QingStor
       def put_bucket_acl_input_validate(input)
         input.deep_stringify_keys!
 
-        unless !input['request_elements']['acl'].nil? && !input['request_elements']['acl'].to_s.empty?
+        unless !input['request_elements']['acl'].nil? && !input['request_elements']['acl'].empty?
           raise ParameterRequiredError.new('acl', 'PutBucketACLInput')
         end
 
@@ -644,7 +1070,7 @@ module QingStor
             end
 
             if x['grantee']['type'] && !x['grantee']['type'].to_s.empty?
-              type_valid_values = %w(user group)
+              type_valid_values = %w[user group]
               unless type_valid_values.include? x['grantee']['type'].to_s
                 raise ParameterValueNotAllowedError.new(
                   'type',
@@ -656,15 +1082,19 @@ module QingStor
 
           end
 
-          raise ParameterRequiredError.new('grantee', 'acl') if x['grantee'].nil?
+          if x['grantee'].nil?
+            raise ParameterRequiredError.new('grantee', 'acl')
+          end
 
           unless !x['permission'].nil? && !x['permission'].to_s.empty?
             raise ParameterRequiredError.new('permission', 'acl')
           end
 
           next unless x['permission'] && !x['permission'].to_s.empty?
-          permission_valid_values = %w(READ WRITE FULL_CONTROL)
+
+          permission_valid_values = %w[READ WRITE FULL_CONTROL]
           next if permission_valid_values.include? x['permission'].to_s
+
           raise ParameterValueNotAllowedError.new(
             'permission',
             x['permission'],
@@ -675,6 +1105,65 @@ module QingStor
 
       public
 
+      # put_bucket_cname: Set bucket CNAME of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/cname/put_cname.html
+      def put_cname(domain: '',
+                    type: '')
+        request = put_cname_request domain: domain,
+                                    type:   type
+        request.send
+      end
+
+      def put_cname_request(domain: '',
+                            type: '')
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'PUT Bucket CNAME',
+          request_method:   'PUT',
+          request_uri:      '/<bucket-name>?cname',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+            'domain' => domain,
+            'type'   => type
+          },
+          request_body:     nil,
+
+          status_code:      [
+            200
+          ]
+        }
+
+        put_bucket_cname_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def put_bucket_cname_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_elements']['domain'].nil? && !input['request_elements']['domain'].to_s.empty?
+          raise ParameterRequiredError.new('domain', 'PutBucketCNAMEInput')
+        end
+
+        if input['request_elements']['type'] && !input['request_elements']['type'].to_s.empty?
+          type_valid_values = %w[normal website]
+          unless type_valid_values.include? input['request_elements']['type'].to_s
+            raise ParameterValueNotAllowedError.new(
+              'type',
+              input['request_elements']['type'],
+              type_valid_values,
+            )
+          end
+        end
+      end
+
+      public
+
       # put_bucket_cors: Set CORS information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/cors/put_cors.html
       def put_cors(cors_rules: [])
@@ -694,12 +1183,13 @@ module QingStor
           request_headers:  {
           },
           request_elements: {
-            'cors_rules' => cors_rules,
+            'cors_rules' => cors_rules
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         put_bucket_cors_input_validate input
@@ -711,12 +1201,12 @@ module QingStor
       def put_bucket_cors_input_validate(input)
         input.deep_stringify_keys!
 
-        unless !input['request_elements']['cors_rules'].nil? && !input['request_elements']['cors_rules'].to_s.empty?
+        unless !input['request_elements']['cors_rules'].nil? && !input['request_elements']['cors_rules'].empty?
           raise ParameterRequiredError.new('cors_rules', 'PutBucketCORSInput')
         end
 
         input['request_elements']['cors_rules'].each do |x|
-          unless !x['allowed_methods'].nil? && !x['allowed_methods'].to_s.empty?
+          unless !x['allowed_methods'].nil? && !x['allowed_methods'].empty?
             raise ParameterRequiredError.new('allowed_methods', 'cors_rule')
           end
 
@@ -747,12 +1237,13 @@ module QingStor
           request_headers:  {
           },
           request_elements: {
-            'source_site' => source_site,
+            'source_site' => source_site
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         put_bucket_external_mirror_input_validate input
@@ -771,6 +1262,230 @@ module QingStor
 
       public
 
+      # put_bucket_lifecycle: Set Lifecycle information of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/lifecycle/put_lifecycle.html
+      def put_lifecycle(rule: [])
+        request = put_lifecycle_request rule: rule
+        request.send
+      end
+
+      def put_lifecycle_request(rule: [])
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'PUT Bucket Lifecycle',
+          request_method:   'PUT',
+          request_uri:      '/<bucket-name>?lifecycle',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+            'rule' => rule
+          },
+          request_body:     nil,
+
+          status_code:      [
+            200
+          ]
+        }
+
+        put_bucket_lifecycle_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def put_bucket_lifecycle_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_elements']['rule'].nil? && !input['request_elements']['rule'].empty?
+          raise ParameterRequiredError.new('rule', 'PutBucketLifecycleInput')
+        end
+
+        input['request_elements']['rule'].each do |x|
+          unless x['abort_incomplete_multipart_upload'].nil?
+
+            unless !x['abort_incomplete_multipart_upload']['days_after_initiation'].nil? && !x['abort_incomplete_multipart_upload']['days_after_initiation'].to_s.empty?
+              raise ParameterRequiredError.new('days_after_initiation', 'abort_incomplete_multipart_upload')
+            end
+
+          end
+
+          unless x['expiration'].nil?
+
+          end
+
+          unless x['filter'].nil?
+
+            unless !x['filter']['prefix'].nil? && !x['filter']['prefix'].to_s.empty?
+              raise ParameterRequiredError.new('prefix', 'filter')
+              end
+
+          end
+
+          if x['filter'].nil?
+            raise ParameterRequiredError.new('filter', 'rule')
+          end
+
+          unless !x['id'].nil? && !x['id'].to_s.empty?
+            raise ParameterRequiredError.new('id', 'rule')
+          end
+
+          unless !x['status'].nil? && !x['status'].to_s.empty?
+            raise ParameterRequiredError.new('status', 'rule')
+          end
+
+          if x['status'] && !x['status'].to_s.empty?
+            status_valid_values = %w[enabled disabled]
+            unless status_valid_values.include? x['status'].to_s
+              raise ParameterValueNotAllowedError.new(
+                'status',
+                x['status'],
+                status_valid_values,
+              )
+            end
+          end
+
+          next if x['transition'].nil?
+
+          unless !x['transition']['storage_class'].nil? && !x['transition']['storage_class'].to_s.empty?
+            raise ParameterRequiredError.new('storage_class', 'transition')
+          end
+        end
+      end
+
+      public
+
+      # put_bucket_logging: Set bucket logging of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/logging/put_logging.html
+      def put_logging(target_bucket: '',
+                      target_prefix: '')
+        request = put_logging_request target_bucket: target_bucket,
+                                      target_prefix: target_prefix
+        request.send
+      end
+
+      def put_logging_request(target_bucket: '',
+                              target_prefix: '')
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'PUT Bucket Logging',
+          request_method:   'PUT',
+          request_uri:      '/<bucket-name>?logging',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+            'target_bucket' => target_bucket,
+            'target_prefix' => target_prefix
+          },
+          request_body:     nil,
+
+          status_code:      [
+            200
+          ]
+        }
+
+        put_bucket_logging_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def put_bucket_logging_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_elements']['target_bucket'].nil? && !input['request_elements']['target_bucket'].to_s.empty?
+          raise ParameterRequiredError.new('target_bucket', 'PutBucketLoggingInput')
+        end
+
+        unless !input['request_elements']['target_prefix'].nil? && !input['request_elements']['target_prefix'].to_s.empty?
+          raise ParameterRequiredError.new('target_prefix', 'PutBucketLoggingInput')
+        end
+      end
+
+      public
+
+      # put_bucket_notification: Set Notification information of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/notification/put_notification.html
+      def put_notification(notifications: [])
+        request = put_notification_request notifications: notifications
+        request.send
+      end
+
+      def put_notification_request(notifications: [])
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'PUT Bucket Notification',
+          request_method:   'PUT',
+          request_uri:      '/<bucket-name>?notification',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+            'notifications' => notifications
+          },
+          request_body:     nil,
+
+          status_code:      [
+            200
+          ]
+        }
+
+        put_bucket_notification_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def put_bucket_notification_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_elements']['notifications'].nil? && !input['request_elements']['notifications'].empty?
+          raise ParameterRequiredError.new('notifications', 'PutBucketNotificationInput')
+        end
+
+        input['request_elements']['notifications'].each do |x|
+          unless !x['cloudfunc'].nil? && !x['cloudfunc'].to_s.empty?
+            raise ParameterRequiredError.new('cloudfunc', 'notification')
+          end
+
+          if x['cloudfunc'] && !x['cloudfunc'].to_s.empty?
+            cloudfunc_valid_values = %w[tupu-porn notifier image]
+            unless cloudfunc_valid_values.include? x['cloudfunc'].to_s
+              raise ParameterValueNotAllowedError.new(
+                'cloudfunc',
+                x['cloudfunc'],
+                cloudfunc_valid_values,
+              )
+            end
+          end
+
+          unless x['cloudfunc_args'].nil?
+
+            unless !x['cloudfunc_args']['action'].nil? && !x['cloudfunc_args']['action'].to_s.empty?
+              raise ParameterRequiredError.new('action', 'cloudfunc_args')
+              end
+
+          end
+
+          unless !x['event_types'].nil? && !x['event_types'].empty?
+            raise ParameterRequiredError.new('event_types', 'notification')
+          end
+
+          unless !x['id'].nil? && !x['id'].to_s.empty?
+            raise ParameterRequiredError.new('id', 'notification')
+          end
+        end
+      end
+
+      public
+
       # put_bucket_policy: Set policy information of the bucket.
       # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/policy/put_policy.html
       def put_policy(statement: [])
@@ -790,12 +1505,13 @@ module QingStor
           request_headers:  {
           },
           request_elements: {
-            'statement' => statement,
+            'statement' => statement
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         put_bucket_policy_input_validate input
@@ -807,12 +1523,12 @@ module QingStor
       def put_bucket_policy_input_validate(input)
         input.deep_stringify_keys!
 
-        unless !input['request_elements']['statement'].nil? && !input['request_elements']['statement'].to_s.empty?
+        unless !input['request_elements']['statement'].nil? && !input['request_elements']['statement'].empty?
           raise ParameterRequiredError.new('statement', 'PutBucketPolicyInput')
         end
 
         input['request_elements']['statement'].each do |x|
-          unless !x['action'].nil? && !x['action'].to_s.empty?
+          unless !x['action'].nil? && !x['action'].empty?
             raise ParameterRequiredError.new('action', 'statement')
           end
 
@@ -845,7 +1561,7 @@ module QingStor
           end
 
           if x['effect'] && !x['effect'].to_s.empty?
-            effect_valid_values = %w(allow deny)
+            effect_valid_values = %w[allow deny]
             unless effect_valid_values.include? x['effect'].to_s
               raise ParameterValueNotAllowedError.new(
                 'effect',
@@ -859,13 +1575,112 @@ module QingStor
             raise ParameterRequiredError.new('id', 'statement')
           end
 
-          unless !x['resource'].nil? && !x['resource'].to_s.empty?
-            raise ParameterRequiredError.new('resource', 'statement')
+          unless !x['user'].nil? && !x['user'].empty?
+            raise ParameterRequiredError.new('user', 'statement')
           end
+        end
+      end
 
-          unless !x['user'].nil? && !x['user'].to_s.empty?
-            raise ParameterRequiredError.new('user', 'statement')
+      public
+
+      # put_bucket_replication: Set Replication information of the bucket.
+      # Documentation URL: https://docs.qingcloud.com/qingstor/api/bucket/replication/put_replication.html
+      def put_replication(rules: [])
+        request = put_replication_request rules: rules
+        request.send
+      end
+
+      def put_replication_request(rules: [])
+        input = {
+          config:           config,
+          properties:       properties,
+          api_name:         'PUT Bucket Replication',
+          request_method:   'PUT',
+          request_uri:      '/<bucket-name>?replication',
+          request_params:   {
+          },
+          request_headers:  {
+          },
+          request_elements: {
+            'rules' => rules
+          },
+          request_body:     nil,
+
+          status_code:      [
+            200
+          ]
+        }
+
+        put_bucket_replication_input_validate input
+        Request.new input
+      end
+
+      private
+
+      def put_bucket_replication_input_validate(input)
+        input.deep_stringify_keys!
+
+        unless !input['request_elements']['rules'].nil? && !input['request_elements']['rules'].empty?
+          raise ParameterRequiredError.new('rules', 'PutBucketReplicationInput')
+        end
+
+        input['request_elements']['rules'].each do |x|
+          if x['delete_marker'] && !x['delete_marker'].to_s.empty?
+            delete_marker_valid_values = %w[enabled disabled]
+            unless delete_marker_valid_values.include? x['delete_marker'].to_s
+              raise ParameterValueNotAllowedError.new(
+                'delete_marker',
+                x['delete_marker'],
+                delete_marker_valid_values,
+              )
+            end
+          end
+
+          unless x['destination'].nil?
+
+            unless !x['destination']['bucket'].nil? && !x['destination']['bucket'].to_s.empty?
+              raise ParameterRequiredError.new('bucket', 'destination')
+              end
+
+          end
+
+          if x['destination'].nil?
+            raise ParameterRequiredError.new('destination', 'rules')
+          end
+
+          unless x['filters'].nil?
+
+          end
+
+          if x['filters'].nil?
+            raise ParameterRequiredError.new('filters', 'rules')
+          end
+
+          unless !x['id'].nil? && !x['id'].to_s.empty?
+            raise ParameterRequiredError.new('id', 'rules')
+          end
+
+          if x['status'] && !x['status'].to_s.empty?
+            status_valid_values = %w[enabled disabled]
+            unless status_valid_values.include? x['status'].to_s
+              raise ParameterValueNotAllowedError.new(
+                'status',
+                x['status'],
+                status_valid_values,
+              )
+            end
           end
+
+          next unless x['sync_marker'] && !x['sync_marker'].to_s.empty?
+
+          sync_marker_valid_values = %w[enabled disabled]
+          next if sync_marker_valid_values.include? x['sync_marker'].to_s
+
+          raise ParameterValueNotAllowedError.new(
+            'sync_marker',
+            x['sync_marker'],
+            sync_marker_valid_values,
+          )
         end
       end