# @alicloud/sts-sdk 中文文档

规范地址：https://npmcn.com/package/%40alicloud/sts-sdk/

版本：1\.0\.2
npm 元数据更新时间：2022-04-04T12:58:42.845Z
中文译文更新时间：2026-11-05T22:27:09.232Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40alicloud/sts-sdk
原文对照：https://npmcn.com/package/%40alicloud/sts-sdk/?lang=original
项目主页：https://github.com/aliyun/nodejs-sts-sdk#readme
源码仓库：https://github.com/aliyun/nodejs-sts-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：15.4 kB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2019-02-25T10:10:54.389Z
- 最新版本发布：2019-03-08T03:11:04.394Z
- 近 30 天下载量：12361（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

alibaba 云端客户端

## 安装

```sh
npm install @alicloud/sts-sdk
```

也可以使用：`pnpm add @alicloud/sts-sdk`、`yarn add @alicloud/sts-sdk`、`bun add @alicloud/sts-sdk`

## README

# 节点的 Alibaba Cloud STS 客户端

[![npm version](https://badge.fury.io/js/@alicloud%2fsts-sdk.svg)](https://badge.fury.io/js/@alicloud%2fsts-sdk.svg) [![Travis Build Status](https://api.travis-ci.org/aliyun/nodejs-sts-sdk.png?branch=master)](https://travis-ci.org/aliyun/nodejs-sts-sdk) [![Appveyor Build status](https://ci.appveyor.com/api/projects/status/5ow9oa34730r0wdy?svg=true)](https://ci.appveyor.com/project/hyj1991/nodejs-sts-sdk) [![codecov](https://codecov.io/gh/aliyun/nodejs-sts-sdk/branch/master/graph/badge.svg)](https://codecov.io/gh/aliyun/nodejs-sts-sdk) [![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://npmcn.com/package/%40alicloud/sts-sdk/LICENSE)

## 安装

```bash
npm install @alicloud/sts-sdk
```

**节点.js** 所需经费.

## 使用量

```js
const StsClient = require('@alicloud/sts-sdk');

const sts = new StsClient({
  endpoint: 'sts.aliyuncs.com', // check this from sts console
  accessKeyId: '***************', // check this from aliyun console
  accessKeySecret: '***************', // check this from aliyun console
});

async function demo() {
  const res1 = await sts.assumeRole(`acs:ram::${accountID}:role/${roleName}`, 'xxx');
  console.log(res1);
  const res2 = await sts.getCallerIdentity();
  console.log(res2);
}

demo();
```

## API 文档

### 方法 : `assumeRole()`

#### 参数

-   **角色定义** 字符串 **所需经费** - 阿利云资源名称, `acs:ram::${accountID}:role/${roleName}`
-   **角色会议Name** 字符串 **所需经费** - 区别符号,/^\[a-zA-Z0-9.\].@ \]+$/
-   **政策** 字符串 **选项** - @ 见 [https://help.aliyun.com/document detail/28664.html (中文(简体) )](https://help.aliyun.com/document_detail/28664.html)
-   **持续时间** 数目 **选项** - 指定的过期时间(秒),范围:900~360,默认值为3600

#### 回返

-   **全权证书** 对象 - sts 证书

### 方法 : `getCallerIdentity()`

#### 回返

-   **用户信息** 对象 - 当前调用者的身份

### 方法 **(仅日本)**数字 : `generateSessionAccessKey()`

#### 回返

-   **akInfo 数据** 对象 - 会话密钥( C)

## 测试覆盖( S)

在运行测试或覆盖之前,您应该设定环境变量 。 例如:

-   运行测试

```
ACCESS_KEY=<your access key> SECRET_KEY=<your secret key> ENDPOINT=sts.aliyuncs.com npm run test
```

-   运行代码覆盖

```
ACCESS_KEY=<your access key> SECRET_KEY=<your secret key> ENDPOINT=sts.aliyuncs.com npm run cov
```

## 许可证

[麻省理工学院](https://npmcn.com/package/%40alicloud/sts-sdk/LICENSE)

## 常见问题

### @alicloud/sts-sdk 是什么？

alibaba 云端客户端

### 如何安装 @alicloud/sts-sdk？

在项目目录运行 npm install @alicloud/sts-sdk，或使用 pnpm add / yarn add / bun add。

### @alicloud/sts-sdk 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/alicloud\_\_sts-sdk 是否存在。

### @alicloud/sts-sdk 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @alicloud/sts-sdk 可以商用吗？

@alicloud/sts-sdk 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @alicloud/sts-sdk 的下载量有多少？

根据 npm 官方下载统计，@alicloud/sts-sdk 在 2026/10/06 – 2026/11/04 这 30 天内被下载 12,361 次，日均约 412 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @alicloud/sts-sdk 还在维护吗？

最新版本 1\.0\.2 发布于 2019/03/08（7 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/02/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。