aliyun-oss-sdk 0.1.1 → 0.1.2

data/README.md

@@ -1,13 +1,13 @@
 # Aliyun OSS SDK
 
-[![Build Status](https://travis-ci.org/zlx/aliyun-oss-sdk.svg)](https://travis-ci.org/zlx/aliyun-oss-sdk)
-[![Code Climate](https://codeclimate.com/github/zlx/aliyun-oss-sdk/badges/gpa.svg)](https://codeclimate.com/github/zlx/aliyun-oss-sdk)
-[![Coverage Status](https://coveralls.io/repos/zlx/aliyun-oss-sdk/badge.svg?branch=master&service=github)](https://coveralls.io/github/zlx/aliyun-oss-sdk?branch=master)
+[![Build Status](https://travis-ci.org/zlx/aliyun-oss-sdk.svg?branch=develop)](https://travis-ci.org/zlx/aliyun-oss-sdk)
+[![Code Climate](https://codeclimate.com/repos/56349060695680028b00b4a5/badges/fccd40948ea96a4eb507/gpa.svg)](https://codeclimate.com/repos/56349060695680028b00b4a5/feed)
+[![Coverage Status](https://coveralls.io/repos/zlx/aliyun-oss-sdk/badge.svg?branch=develop&service=github)](https://coveralls.io/github/zlx/aliyun-oss-sdk?branch=develop)
 
 -----
 
 
-It provide One-to-one Ruby interface for Aliyun OSS Restful API. I try to keep things natural and reasonable, but there are always some places are leaky, welcome to give me advice and modification. Enjoy it!
+It is a full-featured Ruby Library for Aliyun OSS API. We provide two ways to help you use the API: Function based and Object based. Besides, We try to keep things natural and reasonable, but there are always some leaky, welcome to give us advice and modification. Enjoy it!
 
 
 
@@ -25,11 +25,47 @@ And run:
 
     bundle install  
 
+## Document
+
+Here is original Restful API, It has the most detailed and authoritative explanation for every API.
+
++ [https://docs.aliyun.com/#/pub/oss/api-reference/overview](https://docs.aliyun.com/#/pub/oss/api-reference/overview)
+
+Here is thr RDoc Document for this Library, use to find mostly usage for methods.
+
++ [RDoc Document](http://www.rubydoc.info/gems/aliyun-oss-sdk/0.1.1)
+
+
+Here are some more guides for help you. Welcome to advice.
+
+### Function Based
+
++ [Installation](./wiki/installation.md)
++ [Getting Started](./wiki/get_start.md)
++ [Bucket](./wiki/bucket.md)
++ [Object](./wiki/object.md)
++ [Multipart Upload](./wiki/multipart.md)
++ [CORS](./wiki/cors.md)
++ [LifeCycle](./wiki/lifecycle.md)
++ [Error](./wiki/error.md)
+
+### Object Based
+
++ [Installation](./wiki/object_based/installation.md)
++ [Getting Started](./wiki/object_based/get_start.md)
++ [Bucket](./wiki/object_based/bucket.md)
++ [Object](./wiki/object_based/object.md)
++ [Multipart Upload](./wiki/object_based/multipart.md)
++ [CORS](./wiki/object_based/cors.md)
++ [LifeCycle](./wiki/object_based/lifecycle.md)
++ [Error](./wiki/error.md)
 
 ## Usage
 
 ### Quick Start
 
+#### Function Based
+
     require 'aliyun/oss'
     
     # ACCESS_KEY/SECRET_KEY is your access credentials
@@ -40,18 +76,46 @@ And run:
 	client = Aliyun::OSS::Client.new('ACCESS_KEY', 'SECRET_KEY', host: 'oss-cn-hangzhou.aliyuncs.com', bucket: 'oss-sdk-dev-hangzhou')
 	
 	
-	# Upload objects
+	# Upload object
 	client.bucket_create_object('image.png', File.new('path/to/image.png'), { 'Content-Type' => 'image/png' })
 	
 	# Get Object
 	client.bucket_get_object('image.png')
 	
 	
-	
 	# Get all objects in this bucket
 	# use prefix，marker，delimiter, max-keys to filter results
 	client.bucket_list_objects()
+
+#### Object Based
+
+    require 'aliyun/oss'
     
+    # ACCESS_KEY/SECRET_KEY is your access credentials
+    # host: your bucket's data center host, eg: oss-cn-hangzhou.aliyuncs.com
+    # Details: https://docs.aliyun.com/#/pub/oss/product-documentation/domain-region#menu2
+    # bucket: your bucket name
+	
+	client = Aliyun::OSS::Client.new('ACCESS_KEY', 'SECRET_KEY', host: 'oss-cn-hangzhou.aliyuncs.com', bucket: 'oss-sdk-dev-hangzhou')
+	
+	
+	# Upload object
+	client.bucket_objects.create('image.png', File.new('path/to/image.png'), { 'Content-Type' => 'image/png' })
+	
+	# Get Object
+	client.bucket_objects.get('image.png')
+	
+	# Get all objects in this bucket
+	# use prefix，marker，delimiter, max-keys to filter results
+	client.bucket_objects.list()
+	
+	#### Objects #####        
+	buckets = client.buckets
+	bucket_objects = client.bucket_objects
+	bucket_multiparts = client.bucket_multiparts
+	bucket = client.buckets.list.first  || Aliyun::Oss::Struct::Bucket.new(name: bucket_name, client: client)
+	multipart = client.bucket_multiparts.list.first || Aliyun::Oss::Struct::Multipart.new(upload_id: upload_id, key: object_key, client: client)
+	bucket_object = client.bucket_objects.list.first || Aliyun::Oss::Struct::Object.new(key: object_key, client: client)
 
 ### Share your files
 
@@ -78,151 +142,73 @@ With Post Form, we need Post Policy to restrict permissions, here we provide two
      client.get_policy_signature(SECRET_KEY, policy)
 
 
-### Full API
-
-
-    ###### Bucket #####
-    
-    # Get all buckets information
-	client.list_buckets
-	
-	# Create new buckets
-	client.bucket_create('oss-sdk-dev-beijing-no1', 'oss-cn-beijing', 'public-read')
-	
-	# Delete bucket
-	client.bucket_delete(name)
-	
-	# Get all objects in this bucket
-	# use prefix，marker，delimiter, max-keys to filter results
-	client.bucket_list_objects()
-	
-		
-	#### Get information of this bucket  ####
-	
-	client.bucket_get_acl
-	client.bucket_get_cors
-	client.bucket_get_lifecycle
-	client.bucket_get_location
-	client.bucket_get_logging
-	client.bucket_get_referer
-	client.bucket_get_website
-	
-	
-	##### Set the bucket properties  ####
-	
-	# set cors for bucket
-	rule = Aliyun::Oss::Struct::Cors.new({ allowed_methods: ['get'], allowed_origins: ['*'] })
-	client.bucket_enable_cors([rule])
-	client.bucket_disable_cors	# Disable and remove existing cors
-	
-	# Set lifecycle for bucket
-	rule1 = Aliyun::Oss::Struct::LifeCycle.new({ prefix: 'logs-prod-', days: 7, enable: true })
-	rule2 = Aliyun::Oss::Struct::LifeCycle.new({ prefix: 'logs-dev', date: Time.now + 24*60*60, enable: true })
-	client.bucket_enable_lifecycle([rule1, rule2])
-	client.bucket_disable_lifecycle  # Disable and remove existing lifecycle
-	
-	# Enable  access logging for bucket
-	client.bucket_enable_logging('logs-oss-sdk', 'logs-')
-	client.bucket_disable_logging  # Disable logging
-	
-	# Set bucket to static web sites hosted mode.
-	client.bucket_enable_website('index.html', 'error.html')
-	client.bucket_disable_website  # Disable static web sites hosted mode
-	
-	# Set Referer for this bucket
-	client.bucket_set_referer(['http://www.aliyun.com'], false)
-	
-	# Set ACL for bucket
-	# supported value: public-read-write | public-read | private
-	client.bucket_set_acl('public-read')
-	
-	
-	#### Object ####
-	
-	# Upload object to bucket
-	client.bucket_create_object("image.png", File.new("path/to/image.png"), { 'Content-Type' => 'image/png' })
-	
-	# Copy object from other bucket
-	client.bucket_copy_object('new_image.png', 'origin-bucket-name', 'origin.png', { 'x-oss-metadata-directive' => 'REPLACE' })
-	
-	# Get a Object
-	client.bucket_get_object("image.png")
-	
-	# Get meta information of object
-	client.bucket_get_meta_object("image.png")
-	
-	# Get object ACL
-	client.bucket_get_object_acl("image.png")
-	
-	# Set object ACL
-	client.bucket_set_object_acl("image.png", 'public-read-write')
-	
-	# upload object with append
-	# it will create a Appendable object
-	# https://docs.aliyun.com/#/pub/oss/api-reference/object&AppendObject
-	client.bucket_append_object("secret.zip", Bin Data, 0)  # return the last position, 100203
-	client.bucket_append_object("secret.zip", Bin Data, 100203)
-	
-	# Delete Object
-	client.bucket_delete_object('secret.zip)
-	
-	# Delete Multiple objects
-	client.bucket_delete_objects(['secret.zip', 'image.png'], true)
-	
-	
-	
-	#### Multipart Upload  ####  
-	
-	# Init a Multipart Upload event
-	client.bucket_init_multipart("Exciting-Ruby.mp4", { 'Content-Type' => 'video/mp4' })  # return upload ID "98A6524428734723BE8F81D72B5295EE"
-	
-	# Upload files
-	client.bucket_multipart_upload("Exciting-Ruby.mp4", 1, "98A6524428734723BE8F81D72B5295EE", file1)  # return etag for use later
-	client.bucket_multipart_upload("Exciting-Ruby.mp4", 2, "98A6524428734723BE8F81D72B5295EE", file2)
-	client.bucket_multipart_upload("Exciting-Ruby.mp4", 3, "98A6524428734723BE8F81D72B5295EE", file3)
-	
-	# Copy from existing object
-	client.bucket_multipart_copy_upload("Exciting-Ruby.mp4", 4, "98A6524428734723BE8F81D72B5295EE", source_bucket: 'original-bucket-name', source_key: 'original-file', range: 'bytes=0-10000')
-	
-	# List uploaded parts for a Multipart Upload event
-	client.bucket_list_parts("sample_multipart.data", "98A6524428734723BE8F81D72B5295EE")  
-	
-	# Complete a Multipart Upload event
-	part1 = Aliyun::Oss::Struct::Part.new({ number: 1, etag: 'etag1' })
-	part2 = Aliyun::Oss::Struct::Part.new({ number: 2, etag: 'etag2' })
-	part3 = Aliyun::Oss::Struct::Part.new({ number: 3, etag: 'etag3' })
-	client.bucket_complete_multipart("Exciting-Ruby.mp4", "98A6524428734723BE8F81D72B5295EE", [part1, part2, part3])
-	
-	# Abort a Multipart Upload event
-	# abort will remove all uploaded parts
-	# invoke a few time to confirm all parts are deleted for concurrency access
-	client.bucket_abort_multipart("Exciting-Ruby.mp4", "9FB6F32C2DC24E04B813963B58E29E68")
-
-
-
-
-## Document
-
-Here is original Restful API, It has the most detailed and authoritative explanation for every API.
-
-+ [https://docs.aliyun.com/#/pub/oss/api-reference/overview](https://docs.aliyun.com/#/pub/oss/api-reference/overview)
-
-Here is thr Ruby Document for this Library, use to find more usage for methods.
-
-+ [Ruby API Document](http://www.rubydoc.info/gems/aliyun-oss-sdk/0.0.1)
-
-
-Here are some more guides for help you. Welcome to advice.
-
-+ [Installation](./wiki/installation.md)
-+ [Getting Started](./wiki/get_start.md)
-+ [Bucket](./wiki/bucket.md)
-+ [Object](./wiki/object.md)
-+ [Multipart Upload](./wiki/multipart.md)
-+ [CORS](./wiki/cors.md)
-+ [LifeCycle](./wiki/lifecycle.md)
-+ [Error](./wiki/error.md)
-
+### API Mapping
+
+We provide two type API: Function Based, Object Based. To help you find your needed methods, here list a mapping from Original Restful API to our methods.
+
+Note: 
+
++ All Function Based API are instance methods of `Aliyun::Oss::Client`
++ Object Based API belongs to some other class list below:
+
+  + buckets: `Aliyun::Oss::Client::BucketsService`
+  + bucket_objects: `Aliyun::Oss::Client::BucketObjectsService`
+  + bucket_multiparts: `Aliyun::Oss::Client::BucketMultipartsService`
+  + bucket: `Aliyun::Oss::Struct::Bucket`
+  + multipart: `Aliyun::Oss::Struct::Multipart`
+  + object: `Aliyun::Oss::Struct::Object`
+
+
+| Restful API  |  Function Based |  Object Based |
+|---|---|
+|[GetService (ListBucket)](https://docs.aliyun.com/#/pub/oss/api-reference/service&GetService)	|bucket_list	|buckets#list	|
+|[Put Bucket](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucket)		|bucket_create	|	buckets#create|
+|[Put Bucket Acl](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketACL)	|bucket_set_acl	|	bucket#set_acl|
+|[Put Bucket Logging](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketLogging)|bucket_enable_logging	|	bucket#enable_logging|
+|[Put Bucket Website](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketWebsite)	|bucket_enable_website	|	bucket#enable_website|
+|[Put Bucket Referer](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketReferer)	|bucket_set_referer	|	bucket#set_referer|
+|[Put Bucket Lifecycle](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&PutBucketLifecycle)	|	bucket_enable_lifecycle|	bucket#enable_lifecycle|
+|[Get Bucket (List Object)](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucket)	|	bucket_list_objects|	bucket_objects#list|
+|[Get Bucket ACL](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketAcl)	|	bucket_get_acl|	bucket#acl!|
+|[Get Bucket Location](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketLocation)|	bucket_get_location|	bucket#location!|
+|[Get Bucket Logging](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketLogging)	|	bucket_get_logging|	bucket#logging!|
+|[Get Bucket Website](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketWebsite)	|	bucket_get_website|	bucket#website!|
+|[Get Bucket Referer](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketReferer)	|	bucket_get_referer|	bucket#referer!|
+|[Get Bucket Lifecycle](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&GetBucketLifecycle)	|	bucket_get_lifecycle|	bucket#lifecycle!|
+|[Delete Bucket](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucket)	|	bucket_delete|	buckets#delete|
+|[Delete Bucket Logging](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucketLogging)	|	bucket_disable_logging|	bucket#disable_logging|
+|[Delete Bucket Website](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucketWebsite)	|	bucket_disable_website|	bucket#disable_website|
+|[Delete Bucket Lifecycle](https://docs.aliyun.com/#/pub/oss/api-reference/bucket&DeleteBucketLifecycle)	|	bucket_disable_lifecycle|	bucket#disable_lifecycle|
+|[Put Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&PutObject)|	bucket_create_object|	bucket_objects#create|
+|[Copy Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&CopyObject)	|	bucket_copy_object|	bucket_objects#copy|
+|[Get Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&GetObject)	|	bucket_get_object|	bucket_objects#get|
+|[Append Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&AppendObject)|	bucket_append_object|	bucket_objects#append|
+|[Delete Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&DeleteObject)|	bucket_delete_object|	bucket_objects#delete|
+|[Delete Multiple Objects](https://docs.aliyun.com/#/pub/oss/api-reference/object&DeleteMultipleObjects)|	bucket_delete_objects|	bucket_objects#delete_multiple|
+|[Head Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&HeadObject)	|	bucket_preflight|	bucket#preflight, bucket#options|
+|[Put Object ACL](https://docs.aliyun.com/#/pub/oss/api-reference/object&PutObjectACL)	|	bucket_set_object_acl|	object#set_acl|
+|[Get Object ACL](https://docs.aliyun.com/#/pub/oss/api-reference/object&GetObjectACL)	|	bucket_get_object_acl|	object#acl!|
+|[Post Object](https://docs.aliyun.com/#/pub/oss/api-reference/object&PostObject)	|	...|	...|
+|[Initiate Multipart Upload](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&InitiateMultipartUpload)	|	bucket_init_multipart|	bucket_multiparts#init|
+|[Upload Part](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&UploadPart)	|	bucket_multipart_upload|	multipart#upload|
+|[Upload Part Copy](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&UploadPartCopy)	|	bucket_multipart_copy_upload|	multipart#copy|
+|[Complete Multipart Upload](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&CompleteMultipartUpload)	|	bucket_complete_multipart|	multipart#complete|
+|[Abort Multipart Upload](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&AbortMultipartUpload)	|	bucket_abort_multipart|	multipart#abort|
+|[List Multipart Uploads](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&ListMultipartUploads)	|	bucket_list_multiparts|	bucket_multiparts#list|
+|[List Parts](https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&ListParts)	|	bucket_list_parts|	multipart#list_parts|
+|[Put Bucket cors](https://docs.aliyun.com/#/pub/oss/api-reference/cors&PutBucketcors)	|	bucket_enable_cors|	bucket#enable_cors|
+|[Get Bucket cors](https://docs.aliyun.com/#/pub/oss/api-reference/cors&GetBucketcors)	|	bucket_get_cors|	bucket#cors!|
+|[Delete Bucket cors](https://docs.aliyun.com/#/pub/oss/api-reference/cors&DeleteBucketcors)	|	bucket_disable_cors|	bucket#disable_cors|
+|[OPTIONS Object](https://docs.aliyun.com/#/pub/oss/api-reference/cors&OptionObject)|	bucket_get_meta_object|	object#meta!|
+
+
+## Test
+
+We use minitest for test and rubocop for Syntax checker, If you want to make contribute to this library. Confirm below Command is success:
+
+```
+bundle exec rake test
+```
 
 
 ## Authors && Contributors

data/aliyun-oss.gemspec

@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
 
   spec.summary       = 'Aliyun OSS Ruby SDK'
   spec.description   = 'Aliyun OSS Ruby SDK'
-  spec.homepage      = 'http://github.com/zlx/ruby-oss-sdk'
+  spec.homepage      = 'https://github.com/zlx/aliyun-oss-sdk'
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   spec.bindir        = 'exe'
@@ -25,7 +25,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'minitest'
   spec.add_development_dependency 'mocha'
-  spec.add_development_dependency 'pry-byebug'
   spec.add_development_dependency 'webmock'
   spec.add_development_dependency 'timecop'
   spec.add_development_dependency 'rubocop'

data/lib/aliyun/oss/api/bucket_multiparts.rb

@@ -0,0 +1,184 @@
+module Aliyun
+  module Oss
+    module Api
+      module BucketMultiparts
+        # Initialize a Multipart Upload event, before using Multipart Upload mode to transmit data, we has to call the interface to notify the OSS initialize a Multipart Upload events.
+        #
+        # @see https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&InitiateMultipartUpload Initiate Multipart Upload
+        #
+        # @param key [String] object name
+        # @param headers [Hash] headers
+        # @option headers [String] :Content-Type ('application/x-www-form-urlencoded') Specify Content-Type for the object
+        # @option headers [String] :Cache-Control Specify the caching behavior when download from browser, ref https://www.ietf.org/rfc/rfc2616.txt?spm=5176.730001.3.128.Y5W4bu&file=rfc2616.txt RFC2616}
+        # @option headers [String] :Content-Disposition Specify the name when download, ref https://www.ietf.org/rfc/rfc2616.txt?spm=5176.730001.3.128.Y5W4bu&file=rfc2616.txt RFC2616}
+        # @option headers [String] :Content-Encoding Specify the content encoding when download, ref https://www.ietf.org/rfc/rfc2616.txt?spm=5176.730001.3.128.Y5W4bu&file=rfc2616.txt RFC2616}
+        # @option headers [Integer] :Expires Specify the expiration time (milliseconds)
+        # @option headers [String] :x-oss-server-side-encryption Specify the oss server-side encryption algorithm when the object was created. supported value: 'AES256'#
+        #
+        # @return [Response]
+        def bucket_init_multipart(key, headers = {})
+          Utils.stringify_keys!(headers)
+          query = { 'uploads' => true }
+          http.post("/#{key}", query: query, headers: headers, bucket: bucket, key: key)
+        end
+
+        # Upload object in part.
+        #
+        # @see https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&UploadPart Upload Part
+        #
+        # @param key [String] object name
+        # @param number [Integer] the part number, Range in 1~10000.
+        # @param upload_id [String] the upload ID return by #bucket_init_multipart
+        # @param file [File, bin data] the upload data
+        #
+        # @raise [RequestError]
+        # @raise [MultipartPartNumberEmptyError]
+        # @raise [MultipartUploadIdEmptyError]
+        #
+        # @return [Response]
+        def bucket_multipart_upload(upload_id, key, number, file)
+          fail MultipartPartNumberEmptyError if number.nil?
+          fail MultipartUploadIdEmptyError if upload_id.nil? || upload_id.empty?
+
+          query = { 'partNumber' => number.to_s, 'uploadId' => upload_id }
+
+          http.put("/#{key}", query: query, body: Utils.to_data(file), bucket: bucket, key: key)
+        end
+
+        # Upload a Part from an existing Object Copy data.
+        #
+        # @see https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&UploadPartCopy Upload Part Copy
+        #
+        # @param key [String] object name
+        # @param number [Integer] the part number, Range in 1~10000.
+        # @param upload_id [String] the upload ID return by #bucket_init_multipart
+        # @param options [Hash] options
+        # @option options [String] :source_bucket the source bucket name
+        # @option options [String] :source_key the source object name
+        # @option options [String] :range the Range bytes, not set means the whole object, eg: bytes=100-6291756
+        # @option options [String] :x-oss-copy-source-if-match If the specified ETag match the source object ETag, normal transfer and return 200; Otherwise return 412(precondition)
+        # @option options [String] :x-oss-copy-source-if-none-match If the specified ETag not match the source object ETag, normal transfer and return 200; Otherwise return 304(Not Modified)
+        # @option options [String] :x-oss-copy-source-if-unmodified-since If the specified time is equal to or later than the source object last modification time, normal transfer ans return 200; Otherwise returns 412(precondition)
+        # @option options [String] :x-oss-copy-source-if-modified-since If the specified time is earlier than the source object last modification time, normal transfer ans return 200; Otherwise returns 304(not modified)
+        #
+        # @raise [RequestError]
+        # @raise [MultipartSourceBucketEmptyError]
+        # @raise [MultipartSourceKeyEmptyError]
+        #
+        # @return [Response]
+        def bucket_multipart_copy_upload(upload_id, key, number, options = {})
+          Utils.stringify_keys!(options)
+          source_bucket = options.delete('source_bucket').to_s
+          source_key = options.delete('source_key').to_s
+          range = options.delete('range')
+
+          fail MultipartSourceBucketEmptyError if source_bucket.empty?
+          fail MultipartSourceKeyEmptyError if source_key.empty?
+
+          query = { 'partNumber' => number, 'uploadId' => upload_id }
+          headers = copy_upload_headers(source_bucket, source_key, range, options)
+
+          http.put("/#{key}", query: query, headers: headers, bucket: bucket, key: key)
+        end
+
+        # Complete a Multipart Upload event.
+        #
+        # @see https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&CompleteMultipartUpload Complete Multipart Upload
+        #
+        # @param key [String] object name
+        # @param upload_id [String] the upload ID return by #bucket_init_multipart
+        # @param parts [Array<Aliyun::Oss::Multipart:Part>] parts
+        #
+        # @raise [RequestError]
+        # @raise [MultipartPartsEmptyError]
+        # @raise [MultipartUploadIdEmptyError]
+        #
+        # @return [Response]
+        def bucket_complete_multipart(upload_id, key, parts = [])
+          fail MultipartPartsEmptyError if parts.nil? || parts.empty?
+          fail MultipartUploadIdEmptyError if upload_id.nil?
+
+          query = { 'uploadId' => upload_id }
+
+          body = XmlGenerator.generate_complete_multipart_xml(parts)
+
+          http.post("/#{key}", query: query, body: body, bucket: bucket, key: key)
+        end
+
+        # Abort a Multipart Upload event
+        #
+        # @note After abort the Multipart Upload, the Uploaded data will be deleted
+        # @note When abort a Multipart Upload event, if there are still part upload belonging to this event, then theree parts will not be removed. So if there is a concurrent access, in order to release the space on the OSS completely, you need to call #bucket_abort_multipart a few times.
+        #
+        # @see https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&AbortMultipartUpload Abort Multipart Upload
+        #
+        # @param key [String] the object name
+        # @param upload_id [String] the upload ID return by #bucket_init_multipart
+        #
+        # @raise [RequestError]
+        #
+        # @return [Response]
+        def bucket_abort_multipart(upload_id, key)
+          query = { 'uploadId' => upload_id }
+          http.delete("/#{key}", query: query, bucket: bucket, key: key)
+        end
+
+        # List existing opened Multipart Upload event.
+        #
+        # @see https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&ListMultipartUploads List Multipart Uploads
+        #
+        # @param options [Hash] options
+        # @option options [String] :prefix Filter objects with prefix
+        # @option options [String] :delimiter Used to group objects with delimiter
+        # @option options [Integer] :max-uploads (1000) Limit number of Multipart Upload events, the maxinum should <= 1000
+        # @option options [String] :encoding-type Encoding type used for unsupported character
+        # @option options [String] :key-marker with upload-id-marker used to specify the result range.
+        # @option options [String] :upload-id-marker with key-marker used to specify the result range.
+        #
+        # @return [Response]
+        def bucket_list_multiparts(options = {})
+          Utils.stringify_keys!(options)
+          accepted_keys = ['prefix', 'key-marker', 'upload-id-marker', 'max-uploads', 'delimiter', 'encoding-type']
+
+          query = Utils.hash_slice(options, *accepted_keys)
+                  .merge('uploads' => true)
+
+          http.get('/', query: query, bucket: bucket)
+        end
+
+        # List uploaded parts for Multipart Upload event
+        #
+        # @see https://docs.aliyun.com/#/pub/oss/api-reference/multipart-upload&ListParts List Parts
+        #
+        # @param key [String] the object name
+        # @param upload_id [Integer] the upload ID return by #bucket_init_multipart
+        # @param options [Hash] options
+        # @option options [Integer] :max-parts (1000) Limit number of parts, the maxinum should <= 1000
+        # @option options [Integer] :part-number-marker Specify the start part, return parts which number large than the specified value
+        # @option options [String] :encoding-type Encoding type used for unsupported character in xml 1.0
+        #
+        # @return [Response]
+        def bucket_list_parts(upload_id, key, options = {})
+          Utils.stringify_keys!(options)
+          accepted_keys = ['max-parts', 'part-number-marker', 'encoding-type']
+
+          query = Utils.hash_slice(options, *accepted_keys).merge('uploadId' => upload_id)
+
+          http.get("/#{key}", query: query, bucket: bucket, key: key)
+        end
+
+        private
+
+        def copy_upload_headers(source_bucket, source_key, range, options)
+          copy_source = "/#{source_bucket}/#{source_key}"
+
+          headers = {}
+          headers.merge!('x-oss-copy-source' => copy_source)
+          headers.merge!('x-oss-copy-source-range' => range) if range
+          headers.merge!(options)
+          headers
+        end
+      end
+    end
+  end
+end