Copy Object

Updated at：2025-11-03

Simply Copy Object

Basic workflow

Instantiate the BOSClient class.
Call the BOSClient.copyObject() method.
The method returns a CopyObjectResponse instance. The eTag and last modification time can be obtained through getETag() and getLastModified().

Example code

                Java
                
                // Copy Object
 CopyObjectResponse copyObjectResponse = client.copyObject(<SrcBucketName>, <SrcKey>, <DestBucketName>, <DestKey>);  //SrcBucketName, SrcKey are the source addresses，DestBucketName, DestKey are the destination addresses to which the copy is made
 // Print results
System.out.println("ETag: " + copyObjectResponse.getETag() + " LastModified: " + copyObjectResponse.getLastModified());

Complete example

                Java
                
            

                import android.app.Activity;
import android.os.Bundle;
import com.baidubce.BceClientException;
import com.baidubce.BceServiceException;
import com.baidubce.auth.DefaultBceCredentials;
import com.baidubce.demo.R;
import com.baidubce.services.bos.BosClient;
import com.baidubce.services.bos.BosClientConfiguration;
import com.baidubce.services.bos.model.CopyObjectResponse;
public class ExampleActivity extends Activity {
private String srcBucketName = <SrcBucketName>;
private String srcKey = <SrcKey>;
private String destBucketName = <DestBucketName>;
private String destKey = <DestKey>;
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    new Thread(new Runnable() {
        @Override
        public void run() {
            try {
                BosClientConfiguration config = new BosClientConfiguration();
                config.setCredentials(new DefaultBceCredentials(<AccessKeyID>, <SecretAccessKey>));
                config.setEndpoint(<EndPoint>);
                BosClient client = new BosClient(config);
 // Copy Object
                CopyObjectResponse copyObjectResponse = client.copyObject(<SrcBucketName>, <SrcKey>, <DestBucketName>, <DestKey>);
 // Print results
                System.out.println("ETag: " + copyObjectResponse.getETag() + " LastModified: " + copyObjectResponse.getLastModified());
            } catch (BceServiceException e) {
                System.out.println("Error ErrorCode: " + e.getErrorCode());
                System.out.println("Error RequestId: " + e.getRequestId());
                System.out.println("Error StatusCode: " + e.getStatusCode());
                System.out.println("Error Message: " + e.getMessage());
                System.out.println("Error ErrorType: " + e.getErrorType());
            } catch (BceClientException e) {
                System.out.println("Error Message: " + e.getMessage());
            }
        }
    }).start();
}}
            

Note: The copyObject method returns a CopyObjectResponse object containing the new object's ETag and modification time.

Copy Object via CopyObjectRequest

You can also copy object via CopyObjectRequest This function is typically used in the following scenarios:

Copy an object while resetting its metadata.
Reset the metadata of an existing object (set the source and destination to the same object).

Basic workflow

Create an instance of the CopyObjectRequest class, and pass in the parameters <SrcBucketName>, <SrcKey>, <DestBucketName>, <DestKey>.
Create an ObjectMetadata instance.
The method returns a CopyObjectResponse instance. The eTag and last modification time can be obtained through getETag() and getLastModified().

Example code

                Java
                
            

                // Create CopyObjectRequest object
CopyObjectRequest copyObjectRequest = new CopyObjectRequest(<SrcBucketName>, <SrcKey>, <DestBucketName>, <DestKey>);
 // Set new Metadata
Map<String, String> userMetadata = new HashMap<String, String>();
userMetadata.put(<UserMetaKey>,<UserMetaValue>);
meta.setUserMetadata(userMetadata);
copyObjectRequest.setNewObjectMetadata(meta);
 // Copy Object
CopyObjectResponse copyObjectResponse = client.copyObject(copyObjectRequest);
System.out.println("ETag: " + copyObjectResponse.getETag() + " LastModified: " + copyObjectResponse.getLastModified());
            

Note:CopyObjectRequest allows users to modify the ObjectMeta of the target object and also provides the setting of the MatchingETagConstraints parameter.

View the object in the bucket

Upload Object

BOS

BOS

Copy Object

Simply Copy Object

Basic workflow

Example code

Complete example

Copy Object via CopyObjectRequest

Basic workflow

Example code