Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

copyObject

S3Client.copyObject copies an object from one bucket to another.

Parameters

ParameterTypeDescription
sourceBucketstringName of the bucket to copy the object from.
sourceKeystringName of the object to copy from the source bucket.
destinationBucketstringName of the bucket to copy the object to.
destinationKeystringName of the destination object.

Returns

TypeDescription
Promise<void>A Promise that fulfills when the object has been copied from one bucket to another.

Example

JavaScript
import exec from 'k6/execution';

import { AWSConfig, S3Client } from 'https://jslib.k6.io/aws/0.11.0/s3.js';

const awsConfig = new AWSConfig({
  region: __ENV.AWS_REGION,
  accessKeyId: __ENV.AWS_ACCESS_KEY_ID,
  secretAccessKey: __ENV.AWS_SECRET_ACCESS_KEY,
});

const testFile = open('./bonjour.txt', 'r');
const s3 = new S3Client(awsConfig);
const testBucketName = 'test-jslib-aws';
const testFileKey = 'bonjour.txt';
const testDestinationBucketName = 'test-jslib-aws-destination';

export default async function () {
  // Let's upload our test file to the bucket
  await s3.putObject(testBucketName, testFileKey, testFile);

  // Let's create our destination bucket
  await s3.copyObject(testBucketName, testFileKey, testDestinationBucketName, testFileKey);
}

A k6 script that will copy an object from a source S3 bucket to a destination bucket