• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. API Reference (OBS)
  4. Operations on Objects
  5. Initiate Multipart Upload
  6. Responses

Responses

Syntax

HTTP/1.1 status_code 
 Server: server 
 x-amz-id-2: id 
 x-amz-request-id: request id 
 x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc 
 Content-Type: type    
 Content-Length: length 
 Date: date  

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
 <InitiateMultipartUploadResult xmlns="http://obs.example.com/doc/2015-06-30/"> 
 <Bucket>BucketName</Bucket>  
 <Key>ObjectName</Key>  
 <UploadId>uploadID</UploadId> 
 </InitiateMultipartUploadResult> 

Response Headers

This response uses common headers. For details about common response headers, see section Common Response Headers.

Table 1 Response Headers

Header

Description

x-amz-server-side-encryption

This header is included in a response if SSE-KMS is used.

Type: string

Example: x-amz-server-side-encryption:aws:kms

x-amz-server-side-encryption-aws-kms-key-id

Indicates the master key ID. This header is included in a response if SSE-KMS is used.

Example: x-amz-server-side-encryption-aws-kms-key-id:arn:aws:kms:sichuan:domainiddomainiddomainiddoma0001:key/4f1cd4de-ab64-4807-920a-47fc42e7f0d0

x-amz-server-side-encryption-customer-algorithm

Indicates an encryption algorithm. This header is included in a response if SSE-C is used.

Type: string

Example: x-amz-server-side-encryption-customer-algorithm:AES256

x-amz-server-side-encryption-customer-key-MD5

Indicates the MD5 value of a key used to encrypt objects. This header is included in a response if SSE-C is used.

Type: string

Example: x-amz-server-side-encryption-customer-key-MD5:4XvB3tbNTN+tIEVa0/fGaQ==

Response Elements

This response contains elements to indicate the upload ID and the key (name) of the object (bucket) for which the multipart upload was initiated. The returned information is used in the subsequent Upload Part and Complete Multipart Upload operations. Table 2 describes the elements.

Table 2 Response elements

Element

Description

InitiateMultipartUploadResult

Indicates the container for the response.

Type: XML

Bucket

Indicates the name of the bucket for which the multipart upload was initiated.

Type: String

Key

Indicates the key of the object for which the multipart upload was initiated.

Type: String

UploadId

Indicates the ID for the initiated multipart upload. This ID is used for the subsequent Upload Part operation.

Type: String

Error Responses

  • If an AK or signature is invalid, OBS returns status code 403 Forbidden and error code AccessDenied.
  • If the requested bucket does not exist, OBS returns status code 404 Not Found and error code NoSuchBucket.
  • If the requester does not have WRITE permission for the requested bucket, OBS returns status code 403 Forbidden and error code AccessDenied.

For details about other error responses, see Table 1.