npm package: @stedi/sdk-client-exchange-credentials
Description: Stedi SDK for JavaScript that includes Exchange Credentials client for Node.js, Browser and React Native
Author: Stedi Team
Latest version: 0.4.78

<!-- generated file, do not edit directly -->

# @stedi/sdk-client-exchange-credentials

[![NPM version](https://img.shields.io/npm/v/@stedi/sdk-client-exchange-credentials/latest.svg)](https://www.npmjs.com/package/@stedi/sdk-client-exchange-credentials)
[![NPM downloads](https://img.shields.io/npm/dm/@stedi/sdk-client-exchange-credentials.svg)](https://www.npmjs.com/package/@stedi/sdk-client-exchange-credentials)
[![Stability Index](https://img.shields.io/badge/dynamic/json?color=yellow&url=https://unpkg.com/@stedi/sdk-client-exchange-credentials/package.json&query=$.stability&label=stability)](https://github.com/dominictarr/stability)
[![Minimum Node.js version](https://img.shields.io/badge/dynamic/json?color=brightgreen&url=https://unpkg.com/@stedi/sdk-client-exchange-credentials/package.json&query=$.engines.node&label=nodejs)](https://nodejs.org/)

## 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`.

```ts
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`.

```ts
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).

```js
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](http://www.apache.org/licenses/LICENSE-2.0),
see LICENSE for more information.

## Client Commands (Operations List)

<details>
<summary>
GetAwsAccess
</summary>

[Command API Reference](/docs/sdk/clients/exchange-credentials/docs/classes/GetAwsAccessCommand.html) / [Input](/docs/sdk/clients/exchange-credentials/docs/interfaces/GetAwsAccessCommandInput.html) / [Output](/docs/sdk/clients/exchange-credentials/docs/interfaces/GetAwsAccessCommandOutput.html)

</details>