This package allows Node.js developers to write software that interacts with IBM Cloud Object Storage. It is a fork of the AWS SDK for JS v3 library and can stand as a drop-in replacement for applications that use S3-compatible APIs and do not depend on other AWS services.
We value your feedback! Please report any bugs or issues in the GitHub Issues section. Suggestions for enhancements and reports of unexpected behavior are welcome.
IBM has added a Language Support Policy. Language versions will be deprecated on the published schedule without additional notice.
For release notes, see the CHANGELOG.
You'll need:
Writer permissions.These values can be found in the IBM Cloud UI by generating a service credential.
You can automatically archive objects after a specified length of time or after a specified date. Once archived, a temporary copy of an object can be restored for access as needed. Restore time may take up to 15 hours.
An archive policy is set at the bucket level by calling the PutBucketLifecycleConfiguration method on a client instance.
A newly added or modified archive policy applies to new objects uploaded and does not affect existing objects.
For more detail, see the IBM Cloud documentation.
Users can set an archive rule that would allow data restore from an archive in 2 hours or 12 hours.
Users can configure buckets with an Immutable Object Storage policy to prevent objects from being modified or deleted for a defined period of time. The retention period can be specified on a per-object basis, or objects can inherit a default retention period set on the bucket. It is also possible to set open-ended and permanent retention periods. Immutable Object Storage meets the rules set forth by the SEC governing record retention, and IBM Cloud administrators are unable to bypass these restrictions. For more detail, see the IBM Cloud documentation.
Note: Immutable Object Storage does not support Aspera transfers via the SDK to upload objects or directories at this stage.
The preferred way to install the IBM COS SDK for Node.js is to use the npm package manager for Node.js. Simply type the following into a terminal window:
npm install ibm-cos-sdk-v2
The following example demonstrates how to create a bucket using IAM authentication in IBM Cloud Object Storage using the v2 SDK and S3-compatible APIs.
The SDK requires a minimum version of Node.js 18 or newer.
const { S3Client, CreateBucketCommand } = require('ibm-cos-sdk-v2');
async function createBucket() {
try {
// Initialize client
const client = new S3Client({
endpoint: 'https://s3.us-south.cloud-object-storage.appdomain.cloud',
region: 'us-south',
credentials: {
apiKey: API_KEY,
serviceInstanceId: SERVICE_INSTANCE_ID,
},
});
// Create bucket
console.log('Creating bucket: ' + BUCKET_NAME);
const command = new CreateBucketCommand({
Bucket: BUCKET_NAME
});
await client.send(command);
console.log('Bucket created successfully');
} catch (error) {
console.error('Error: ' + error.message);
process.exit(1);
}
}
node BucketCreate.js
More examples can be found in example directory.
Feel free to use GitHub issues for tracking bugs and feature requests, but for help please use one of the following resources:
ibm and object-storage.IBM supports current LTS releases. IBM will deprecate language versions 90 days after a version reaches end-of-life. All clients will need to upgrade to a supported version before the end of the grace period.
This SDK is distributed under the Apache License, Version 2.0, see LICENSE.txt and NOTICE.txt for more information.