Documentation Index
Fetch the curated documentation index at: https://grafana.com/llms.txt
Fetch the complete documentation index at: https://grafana.com/llms-full.txt
Use this file to discover all available pages before exploring further.
STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: https://grafana.com/docs/k6/next/javascript-api/jslib/aws/s3client/putobject.md (append .md) or send Accept: text/markdown to https://grafana.com/docs/k6/next/javascript-api/jslib/aws/s3client/putobject/. For the curated documentation index, use https://grafana.com/llms.txt. For the complete documentation index, use https://grafana.com/llms-full.txt.
This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.
putObject
S3Client.putObject uploads an object to a bucket.
Parameters
| Parameter | Type | Description |
|---|---|---|
| bucketName | string | Name of the bucket to upload the object to. |
| objectKey | string | Name of the uploaded object. |
| data | string | ArrayBuffer | Content of the object to upload. |
| params | PutObjectParams (optional) | Options for the request. |
PutObjectParams
| Name | Type | Description |
|---|---|---|
| contentDisposition | string (optional) | Specifies presentational information for the object. For more information, see RFC 6266. |
| contentEncoding | string (optional) | Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. For more information, see RFC 2616. |
| contentLength | number (optional) | Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically. |
| contentMD5 | string (optional) | The base64-encoded 128-bit MD5 digest of the message (without the headers) according to RFC 1864. This header can be used as a message integrity check to verify that the received message is identical to the message that was sent. |
| contentType | string (optional) | A standard MIME type describing the format of the object data. For more information, see RFC 2616. |
Returns
| Type | Description |
|---|---|
| Promise< S3UploadedObject> | A Promise that fulfills with an S3UploadedObject containing metadata about the uploaded object, including ETag and optional checksums. |
Example
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,
});
const s3 = new S3Client(awsConfig);
const testBucketName = 'test-jslib-aws';
const testFileKey = 'bonjour.txt';
const testFile = open('./bonjour.txt', 'r');
export default async function () {
// Let's upload our test file to the bucket
const uploadResult = await s3.putObject(testBucketName, testFileKey, testFile, {
contentType: 'text/plain',
contentLength: testFile.length,
});
// Access the upload metadata
console.log('Upload successful! ETag:', uploadResult.eTag);
if (uploadResult.size) {
console.log('Object size:', uploadResult.size);
}
// Check if checksums are available
if (uploadResult.sha256) {
console.log('SHA256 checksum:', uploadResult.sha256);
}
// And let's redownload it to verify it's correct
const obj = await s3.getObject(testBucketName, testFileKey);
console.log(JSON.stringify(obj));
}A k6 script that will upload an object to a S3 bucket
Was this page helpful?
Related resources from Grafana Labs

