@stedi/sdk-client-exchange-credentials

@stedi/sdk-client-exchange-credentials

Description

Stedi ExchangeCredentials SDK for JavaScript.

Service to exchange Stedi credentials for Web Identity to access AWS account.

Installing

To install the this package, simply type add or install @stedi/sdk-client-exchange-credentials using your favorite package manager:

• npm install @stedi/sdk-client-exchange-credentials
• yarn add @stedi/sdk-client-exchange-credentials
• pnpm add @stedi/sdk-client-exchange-credentials

Getting Started

Initialize the client

First, create a new ExchangeCredentialsClient.

import { ExchangeCredentialsClient, GetAwsAccessCommand } from "@stedi/sdk-client-exchange-credentials";

const client = new ExchangeCredentialsClient({
  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 GetAwsAccessCommand.

import { ExchangeCredentialsClient, GetAwsAccessCommand } from "@stedi/sdk-client-exchange-credentials";

const client = new ExchangeCredentialsClient({
  region: "us",
  apiKey: "my-api-key",
});

const params = {
  /** input parameters */
};

const command = new GetAwsAccessCommand(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)

GetAwsAccess

Command API Reference / Input / Output