qingstor-sdk 2.2.4 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8062121127a0b59b8bc4fed69806437307a405579bca0414ace52576e40300d
-  data.tar.gz: c35611b2ded99e65fdde787cf9abbb4404bb06b6d47014fa67e6400b2b59ff23
+  metadata.gz: f96fbe4a96c1158586ba3178388d9e1d718a87bc8a85dc948e1f93c39e5af9b5
+  data.tar.gz: ab161d6e76bf701a178189549f929c79838537faa8559a4af4ec4ffe11f8afbb
 SHA512:
-  metadata.gz: 914c6b4166f5051070db12e4404cfe7a474be1278b038c947b51f06a86fef4b61b59109aee01853b75df26b2e0a92288454f62633280f60106d1f93da8ab7ff1
-  data.tar.gz: f3130ce98410ee9479a5465c17cafbb3724850048dbcffff4e7924ac7e68b059b998d9a03c10a39496703c06d73195c451d75eed0da306baf6f54f41e6237511
+  metadata.gz: 56d0d535ce815915faf22f7e38a635a22b5d7009cf121a29b08b18c728b982d0d618fac8f9e2c2dcb767d2809f8a5b4a42cd494113c7aa85e01e1d0f402e1723
+  data.tar.gz: fef1d45a4891cadf79569fd44591f3a8adc747ff7c2f7dc0845fc3927d5d316e4a3a543928888436af97b78fb32dc70f6a74938479dd1b518f3fc12daff26559

data/README.md

@@ -167,6 +167,20 @@ log_level: 'warn'
 ## Change Log
 All notable changes to QingStor SDK for Ruby will be documented here.
 
+### [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
@@ -244,6 +258,7 @@ 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.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

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
-        %i(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,13 @@ module QingStor
           input[:request_headers][:'Content-MD5'] = Base64.encode64(Digest::MD5.digest(input[:request_body])).strip
         end
 
+        if input[:request_headers][:'X-QS-MetaData'].is_a?(Hash) && !input[:request_headers][:'X-QS-MetaData'].empty?
+          input[:request_headers][:'X-QS-MetaData'].each do |k, v|
+            input[:request_headers][:"#{k}"] = v
+          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 +134,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

@@ -80,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

@@ -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:      [
-            204, # 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
@@ -201,12 +366,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
@@ -249,9 +415,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_acl_input_validate input
@@ -266,6 +433,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 +505,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_cors_input_validate input
@@ -325,9 +544,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_external_mirror_input_validate input
@@ -342,6 +562,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
@@ -363,9 +700,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_policy_input_validate input
@@ -401,9 +739,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_statistics_input_validate input
@@ -439,9 +778,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         head_bucket_input_validate input
@@ -459,20 +799,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 +823,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 +879,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 +925,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            201, # Bucket created
-          ],
+            201
+          ]
         }
 
         put_bucket_input_validate input
@@ -615,12 +962,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
@@ -644,7 +992,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 +1004,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 +1027,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 +1105,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
@@ -747,12 +1159,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 +1184,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'].to_s.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'].to_s.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'].to_s.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 +1427,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
@@ -845,7 +1483,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',