# @alicloud/pop-core 中文文档

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

版本：1\.8\.0
npm 元数据更新时间：2024-12-09T05:36:21.487Z
中文译文更新时间：2026-11-05T17:54:26.103Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：24.6 kB，7 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=8\.0\.0
- 运行依赖：5 个
- 首次发布：2017-01-11T08:26:40.683Z
- 最新版本发布：2024-12-09T05:36:21.213Z
- 近 30 天下载量：125255（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 0 个）

## 中文简介

AliCloud POP SDK 芯片

## 安装

```sh
npm install @alicloud/pop-core
```

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

## README

# @ alicloud/ pop- core

POP API的核心SDK.

[![NPM version](https://img.shields.io/npm/v/@alicloud/pop-core.svg?style=flat-square)](https://npmjs.org/package/@alicloud/pop-core) [![build status](https://img.shields.io/travis/aliyun/openapi-core-nodejs-sdk/master.svg?style=flat-square)](https://travis-ci.org/aliyun/openapi-core-nodejs-sdk) [![codecov](https://codecov.io/gh/aliyun/openapi-core-nodejs-sdk/branch/master/graph/badge.svg)](https://codecov.io/gh/aliyun/openapi-core-nodejs-sdk)

## 安装

安装并写入 package.json 依赖性.

```sh
$ npm install @alicloud/pop-core -S
```

## 先决条件

节点.js >= 8.x

### 页:1

你必须知道你的 `AK`(单位:千美元)`accessKeyId/accessKeySecret`),和云产品 `endpoint` 财务报告和审定财务报表 `apiVersion`。 。 。 .

例如,ECS OpenAPI([https://help.aliyun.com/document detail25490.html 页面存档备份,存于互联网档案馆](https://help.aliyun.com/document_detail/25490.html)),API版本为: `2014-05-26`。 。 。 .

终点列表可见于 [这里](https://help.aliyun.com/document_detail/25489.html),中端点为ecs.aliyuncs.com. 添加 http 协议 `http` 或者说 `https`,应该是 `http://ecs.aliyuncs.com/`。 。 。 .

## 重要更新

-   从1.8.0版本开始,支持"身份证明提供商",并更新内部函数的签名逻辑. 改变内部逻辑要求的开发者需要注意这些变化.

## 在线演示

**[API 开发者门户](https://api.aliyun.com/)** 提供在线调用云产品OpenAPI的能力,并动态生成SDK示例代码和快速检索接口,这可以显著地降低使用云API的难度. **高度建议**。 。 。 .

[![](https://img.alicdn.com/tfs/TB12GX6zW6qK1RjSZFmXXX0PFXa-744-122.png)](https://api.aliyun.com/)

## 使用量

RPC 风格客户端 :

```js
var RPCClient = require('@alicloud/pop-core').RPCClient;

var client = new RPCClient({
  accessKeyId: '<accessKeyId>',
  accessKeySecret: '<accessKeySecret>',
  endpoint: '<endpoint>',
  apiVersion: '<apiVersion>'
});

// => returns Promise
client.request(action, params);
// co/yield, async/await

// options
client.request(action, params, {
  timeout: 3000, // default 3000 ms
  formatAction: true, // default true, format the action to Action
  formatParams: true, // default true, format the parameter name to first letter upper case
  method: 'GET', // set the http method, default is GET
  headers: {}, // set the http request headers
});
```

ROA 风格客户端 :

```js
var ROAClient = require('@alicloud/pop-core').ROAClient;

var client = new ROAClient({
  accessKeyId: '<accessKeyId>',
  accessKeySecret: '<secretAccessKey>',
  endpoint: '<endpoint>',
  apiVersion: '<apiVersion>'
});

// => returns Promise
// request(HTTPMethod, uriPath, queries, body, headers, options);
// options => {timeout}
client.request('GET', '/regions');
// co/yield, async/await
```

### 自定义选择

我们提供两种方式来定制选择请求.

一种方法是选择通过客户端构建器。 您应该将通过构建器传递的选项视为默认自定义选项, 因为所有请求都会使用此选项 .

```js
var client = new RPCClient({
  accessKeyId: '<accessKeyId>',
  accessKeySecret: '<accessKeySecret>',
  endpoint: '<endpoint>',
  apiVersion: '<apiVersion>',
  opts: {
    timeout: 3000
  }
});
```

另一种方法是通过函数的参数选择. 当您想要通过特定函数的选择时, 您应该使用这种方式 .

```js
client.request(action, params, {
  timeout: 3000
});
```

在使用两种方式时,选择会被合并. 但对于使用同一种密钥的选取,由函数参数提供的取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取.

### Http 代理支持

```js
var tunnel = require('tunnel-agent');

var RPCClient = require('@alicloud/pop-core').RPCClient;

var client = new RPCClient({
  accessKeyId: '<accessKeyId>',
  accessKeySecret: '<accessKeySecret>',
  endpoint: '<endpoint>',
  apiVersion: '<apiVersion>'
});


client.request(action, params, {
  agent: tunnel.httpOverHttp({
    proxy: {
      host: 'host',
      port: port
    }
  });
});
```

## 许可证

麻省理工学院许可证

## 常见问题

### @alicloud/pop-core 是什么？

AliCloud POP SDK 芯片

### 如何安装 @alicloud/pop-core？

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

### @alicloud/pop-core 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @alicloud/pop-core 支持 ESM 还是 CommonJS？

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

### @alicloud/pop-core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=8\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @alicloud/pop-core 可以商用吗？

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

### @alicloud/pop-core 的下载量有多少？

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

### @alicloud/pop-core 还在维护吗？

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