# @aws-lite/sqs 中文文档

规范地址：https://npmcn.com/package/%40aws-lite/sqs/

版本：0\.2\.4
npm 元数据更新时间：2026-03-06T19:10:37.036Z
中文译文更新时间：2026-11-07T10:57:20.523Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aws-lite/sqs
原文对照：https://npmcn.com/package/%40aws-lite/sqs/?lang=original
项目主页：https://aws-lite.org/services/sqs
源码仓库：https://github.com/aws-lite/aws-lite

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

- 包体积（解压后）：13 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=16
- 运行依赖：0 个
- 首次发布：2023-10-15T19:49:26.351Z
- 最新版本发布：2024-08-01T16:04:57.457Z
- 近 30 天下载量：218065（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 0 个）

## 中文简介

公务 `aws-lite` sQS 插件

## 安装

```sh
npm install @aws-lite/sqs
```

也可以使用：`pnpm add @aws-lite/sqs`、`yarn add @aws-lite/sqs`、`bun add @aws-lite/sqs`

## README

# [`@aws-lite/sqs`](https://aws-lite.org/services/sqs)

> 公务 `aws-lite` sQS 插件

> 由下列人员维护: [@ architect](https://github.com/architect)

## 安装

```sh
npm i @aws-lite/sqs
```

可选安装类型 :

```sh
npm i -D @aws-lite/sqs-types
```

## 参考文献

[在aws-lite.org提供实例参考文件](https://aws-lite.org/services/sqs)

## 方法

### `SendMessage`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessage.html)

属性 :

-   **`MessageBody` (弦) \[须\]**
    -   从 1b - 256KiB 发送信件
-   **`QueueUrl` (弦) \[须\]**
    -   SQS 队列 URL 发送信件到
-   **`DelaySeconds` (数目)**
    -   从0到900秒延迟消息
-   **`MessageAttributes` (标 题)**
    -   信件属性映射
    -   [更详细情况( AWS)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_MessageAttributeValue.html)
-   **`MessageDeduplicationId` (弦声)**
    -   确保请求具有一元性;只能用于FIFO队列
-   **`MessageGroupId` (弦声)**
    -   指定特定信件组的标记; 只可用于 FIFO 队列
-   **`MessageSystemAttributes` (标 题)**
    -   信件系统属性映射
    -   [更详细情况( AWS)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_MessageSystemAttributeValue.html)

### `GetQueueAttributes`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_GetQueueAttributes.html)

属性 :

-   **`QueueUrl` (弦) \[须\]**
    -   SQS 队列 URL 从中获取属性信息
-   **`AttributeNames` (阵列)**
    -   要检索的属性名称( 字符串) 列表

### `ReceiveMessage`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ReceiveMessage.html)

属性 :

-   **`QueueUrl` (弦) \[须\]**
    -   SQS 队列收到信件的 URL
-   **`AttributeNames` (阵列)**
    -   与每个信件一起返回的属性名称( 字符串) 列表
-   **`MaxNumberOfMessages` (数目)**
    -   要返回的信件的最大数量
-   **`MessageAttributeNames` (阵列)**
    -   信件属性的名称
-   **`MessageSystemAttributeNames` (阵列)**
    -   需要随每个信件一起返回的属性列表
-   **`ReceiveRequestAttemptId` (弦声)**
    -   用于复制的符号 `ReceiveMessage` 电话
-   **`VisibilityTimeout` (数目)**
    -   接收到的信息在被检索后被隐藏在后续检索请求中的时间(以秒计) `ReceiveMessage` 请求
-   **`WaitTimeSeconds` (数目)**
    -   调用的时间( 秒) 等待消息到达队列后返回

### `DeleteMessage`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_DeleteMessage.html)

属性 :

-   **`QueueUrl` (弦) \[须\]**
    -   SQS 队列删除信件的 URL
-   **`ReceiptHandle` (弦) \[须\]**
    -   与要删除的信件相连接的收件控件

### 有待执行的方法

> 请帮忙 [打开 PR](https://github.com/aws-lite/aws-lite#authoring-aws-lite-plugins)来啊!

-   [`AddPermission`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_AddPermission.html)
-   [`CancelMessageMoveTask`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_CancelMessageMoveTask.html)
-   [`ChangeMessageVisibility`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ChangeMessageVisibility.html)
-   [`ChangeMessageVisibilityBatch`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ChangeMessageVisibilityBatch.html)
-   [`CreateQueue`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_CreateQueue.html)
-   [`DeleteMessageBatch`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_DeleteMessageBatch.html)
-   [`DeleteQueue`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_DeleteQueue.html)
-   [`GetQueueUrl`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_GetQueueUrl.html)
-   [`ListDeadLetterSourceQueues`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ListDeadLetterSourceQueues.html)
-   [`ListMessageMoveTasks`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ListMessageMoveTasks.html)
-   [`ListQueues`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ListQueues.html)
-   [`ListQueueTags`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ListQueueTags.html)
-   [`PurgeQueue`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_PurgeQueue.html)
-   [`RemovePermission`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_RemovePermission.html)
-   [`SendMessageBatch`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessageBatch.html)
-   [`SetQueueAttributes`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SetQueueAttributes.html)
-   [`StartMessageMoveTask`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_StartMessageMoveTask.html)
-   [`TagQueue`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_TagQueue.html)
-   [`UntagQueue`](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_UntagQueue.html)

## 学多点

-   [更多关于 `aws-lite` 插件 API](https://aws-lite.org/plugin-api)
-   [学着如何促进这个和其他 `aws-lite` 插件](https://aws-lite.org/contributing)

## 常见问题

### @aws-lite/sqs 是什么？

公务 aws-lite sQS 插件

### 如何安装 @aws-lite/sqs？

在项目目录运行 npm install @aws-lite/sqs，或使用 pnpm add / yarn add / bun add。

### @aws-lite/sqs 支持 TypeScript 吗？

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

### @aws-lite/sqs 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aws-lite/sqs 需要什么版本的 Node\.js？

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

### @aws-lite/sqs 可以商用吗？

@aws-lite/sqs 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aws-lite/sqs 的下载量有多少？

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

### @aws-lite/sqs 还在维护吗？

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