---
title: "createMultipartUpload | Grafana k6 documentation"
description: "S3Client.createMultipartUpload creates a multipart upload for an object key to a bucket"
---

# createMultipartUpload

`S3Client.createMultipartUpload` creates a new multipart upload for a given an object key in a bucket.

Expand table

| Parameter  | Type   | Description                                 |
|------------|--------|---------------------------------------------|
| bucketName | string | Name of the bucket to upload the object to. |
| objectKey  | string | Name of the uploaded object.                |

### Returns

Expand table

| Type                                                                                                      | Description                                                                                                                                                  |
|-----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Promise< [S3MultipartUpload](/docs/k6/latest/javascript-api/jslib/aws/s3client/s3multipartupload/)> | A Promise that fulfills with a [S3MultipartUpload](/docs/k6/latest/javascript-api/jslib/aws/s3client/s3multipartupload/) representing a S3 Multipart Upload. |

### Example

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

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

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

const s3 = new S3Client(awsConfig);

const testBucketName = 'test-jslib-aws';
const testFileKey = 'multipart.txt';

export default async function () {
  // Initialize a multipart upload
  const multipartUpload = await s3.createMultipartUpload(testBucketName, testFileKey);

  // Abort multipart upload
  await s3.abortMultipartUpload(testBucketName, testFileKey, multipartUpload.uploadId);
}
```

*A k6 script that will create a multipart upload to an S3 bucket*