qingstor-sdk 2.2.2 → 2.5.0

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

@@ -19,6 +19,7 @@ require 'json'
 require 'net/http'
 
 require 'active_support/core_ext/hash/keys'
+require 'active_support/core_ext/object/blank'
 
 module QingStor
   module SDK
@@ -52,17 +53,28 @@ module QingStor
 
       def sign
         check
+        if Signer.is_anonymous? input
+          Logger.warn 'anonymous api call, skip sign'
+          return
+        end
         self.input = Signer.sign input
       end
 
       def sign_query(timeout_seconds)
         check
+        if Signer.is_anonymous? input
+          Logger.warn 'anonymous api call, skip sign query'
+          return
+        end
         self.input = Signer.sign_query input, Time.now.to_i + timeout_seconds
       end
 
       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 +89,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
@@ -94,10 +106,11 @@ module QingStor
       private
 
       def check
-        unless !input[:config][:access_key_id].nil? && !input[:config][:access_key_id].empty?
+        # ak and sk should be both set or not set
+        if input[:config][:access_key_id].blank? && input[:config][:secret_access_key].present?
           raise SDKError, 'access key not provided'
         end
-        unless !input[:config][:secret_access_key].nil? && !input[:config][:secret_access_key].empty?
+        if input[:config][:secret_access_key].blank? && input[:config][:access_key_id].present?
           raise SDKError, 'secret access key not provided'
         end
       end

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

@@ -18,23 +18,31 @@ require 'base64'
 require 'cgi'
 require 'openssl'
 
+require 'active_support/core_ext/object/blank'
+
 module QingStor
   module SDK
     class Signer
       def self.sign(input)
-        authorization = "QS #{input[:config][:access_key_id]}:#{signature input}"
-        input[:request_headers][:Authorization] = authorization
+        unless is_anonymous? input
+          authorization = "QS #{input[:config][:access_key_id]}:#{signature input}"
+          input[:request_headers][:Authorization] = authorization
+
+          Logger.debug "QingStor request authorization: [#{input[:id]}] #{authorization}"
+        end
 
-        Logger.debug "QingStor request authorization: [#{input[:id]}] #{authorization}"
         input
       end
 
       def self.sign_query(input, expires)
-        input[:request_params][:signature] = query_signature input, expires
-        input[:request_params][:access_key_id] = input[:config][:access_key_id]
-        input[:request_params][:expires] = expires
+        unless is_anonymous? input
+          input[:request_params][:signature] = query_signature input, expires
+          input[:request_params][:access_key_id] = input[:config][:access_key_id]
+          input[:request_params][:expires] = expires
+
+          Logger.debug "QingStor query signature: [#{input[:id]}] #{input[:request_params][:signature]}"
+        end
 
-        Logger.debug "QingStor query signature: [#{input[:id]}] #{input[:request_params][:signature]}"
         input
       end
 
@@ -83,7 +91,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 +106,20 @@ 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
+
+      def self.is_anonymous?(input)
+        if input[:config].nil?
+          return true
+        end
+
+        input[:config][:access_key_id].blank? && input[:config][:secret_access_key].blank?
       end
     end
   end

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

@@ -22,6 +22,7 @@ module QingStor
       attr_accessor :config, :properties
 
       def initialize(config, properties)
+        config.check
         self.config     = config
         self.properties = properties.deep_symbolize_keys
       end
@@ -47,9 +48,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            204, # Bucket deleted
-          ],
+            204
+          ]
         }
 
         delete_bucket_input_validate input
@@ -64,6 +66,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 +131,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            204
+          ]
         }
 
         delete_bucket_cors_input_validate input
@@ -123,9 +170,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            204, # No content
-          ],
+            204
+          ]
         }
 
         delete_bucket_external_mirror_input_validate input
@@ -140,6 +188,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 +326,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            204, # No content
-          ],
+            204
+          ]
         }
 
         delete_bucket_policy_input_validate input
@@ -178,6 +344,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 +406,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 +424,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 +455,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_acl_input_validate input
@@ -266,6 +473,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 +545,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_cors_input_validate input
@@ -325,9 +584,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_external_mirror_input_validate input
@@ -342,6 +602,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 +726,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 +779,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 +818,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         get_bucket_statistics_input_validate input
@@ -439,9 +857,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            200, # OK
-          ],
+            200
+          ]
         }
 
         head_bucket_input_validate input
@@ -459,20 +878,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 +902,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 +958,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 +1004,10 @@ module QingStor
           request_elements: {
           },
           request_body:     nil,
+
           status_code:      [
-            201, # Bucket created
-          ],
+            201
+          ]
         }
 
         put_bucket_input_validate input
@@ -615,12 +1041,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,10 +1059,6 @@ 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?
-          raise ParameterRequiredError.new('acl', 'PutBucketACLInput')
-        end
-
         input['request_elements']['acl'].each do |x|
           unless x['grantee'].nil?
 
@@ -644,7 +1067,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 +1079,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 +1102,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 +1180,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 +1198,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 +1234,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 +1259,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 +1502,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 +1520,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 +1558,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 +1572,116 @@ module QingStor
             raise ParameterRequiredError.new('id', 'statement')
           end
 
-          unless !x['user'].nil? && !x['user'].to_s.empty?
+          unless !x['user'].nil? && !x['user'].empty?
             raise ParameterRequiredError.new('user', 'statement')
           end
         end
       end
 
       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
+
+      public
     end
   end
 end