@stedi/sdk-client-buckets
v0.4.78
Published
Stedi SDK for JavaScript that includes Buckets client for Node.js, Browser and React Native
Downloads
5,517
Readme
@stedi/sdk-client-buckets
Description
Stedi Buckets SDK for JavaScript.
Installing
To install the this package, simply type add or install @stedi/sdk-client-buckets using your favorite package manager:
npm install @stedi/sdk-client-buckets
yarn add @stedi/sdk-client-buckets
pnpm add @stedi/sdk-client-buckets
Getting Started
Initialize the client
First, create a new BucketsClient
.
import { BucketsClient, CheckBucketNameAvailabilityCommand } from "@stedi/sdk-client-buckets";
const client = new BucketsClient({
region: "us",
apiKey: "my-api-key",
});
Usage
Once the client is initiated, you may use it to send multiple commands.
If you are using a custom http handler, you may call destroy()
to close open connections.
Create a command by creating a new CheckBucketNameAvailabilityCommand
.
import { BucketsClient, CheckBucketNameAvailabilityCommand } from "@stedi/sdk-client-buckets";
const client = new BucketsClient({
region: "us",
apiKey: "my-api-key",
});
const params = {
/** input parameters */
};
const command = new CheckBucketNameAvailabilityCommand(params);
try {
const data = await client.send(command);
// process data.
} catch (error) {
// error handling.
} finally {
// finally.
}
Troubleshooting
When the service returns an exception, the error will include the exception information, as well as response metadata (e.g. request id).
try {
const data = await client.send(command);
// process data.
} catch (error) {
const { requestId, cfId, extendedRequestId } = error.$metadata;
console.log({ requestId, cfId, extendedRequestId });
/**
* The keys within exceptions are also parsed.
* You can access them by checking if it is a certain instance of exception:
* if (error instanceof SomeServiceException) {
* const value = error.specialKeyInException;
* }
*/
}
License
This SDK is distributed under the Apache License, Version 2.0, see LICENSE for more information.
Client Commands (Operations List)
Command API Reference / Input / Output
Command API Reference / Input / Output
Command API Reference / Input / Output
Command API Reference / Input / Output
Command API Reference / Input / Output
Command API Reference / Input / Output
Command API Reference / Input / Output
Command API Reference / Input / Output
Command API Reference / Input / Output
Command API Reference / Input / Output