# @aws-lite/sns 中文文档

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

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

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

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

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

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

## 中文简介

公务 `aws-lite` sNS 插件

## 安装

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

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

## README

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

> 公务 `aws-lite` sNS 插件

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

## 安装

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

可选安装类型 :

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

## 参考文献

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

## 方法

### `Publish`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/sns/latest/api/API_Publish.html)

属性 :

-   **`Message` (弦) \[须\]**
    -   要发送的信件有效载荷
-   **`MessageAttributes` (弦声)**
    -   字符串到信件属性值对象映射
-   **`MessageDeduplicationId` (弦声)**
    -   确保请求具有一元性;只能用于FIFO专题
-   **`MessageGroupId` (弦声)**
    -   指定特定信件组的标记; 只能用于 FIFO 主题
-   **`MessageStructure` (弦声)**
    -   可能设定为 `json` 发布 JSON 有效载荷
-   **`PhoneNumber` (弦声)**
    -   E.164格式的短信接收者的电话号码;如果没有指定,必须指定 `TargetArn` 或者说 `TargetArn`
-   **`Subject` (弦声)**
    -   电子邮件主题行
-   **`TargetArn` (弦声)**
    -   如果没有指定,则必须指定 `PhoneNumber` 或者说 `TopicArn`
-   **`TopicArn` (弦声)**
    -   要公布的主题的 ARN; 如果没有指定, 您必须指定 `PhoneNumber` 或者说 `TargetArn`

### 有待执行的方法

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

-   [`AddPermission`](https://docs.aws.amazon.com/sns/latest/api/API_AddPermission.html)
-   [`CheckIfPhoneNumberIsOptedOut`](https://docs.aws.amazon.com/sns/latest/api/API_CheckIfPhoneNumberIsOptedOut.html)
-   [`ConfirmSubscription`](https://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)
-   [`CreatePlatformApplication`](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)
-   [`CreatePlatformEndpoint`](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)
-   [`CreateSMSSandboxPhoneNumber`](https://docs.aws.amazon.com/sns/latest/api/API_CreateSMSSandboxPhoneNumber.html)
-   [`CreateTopic`](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)
-   [`DeleteEndpoint`](https://docs.aws.amazon.com/sns/latest/api/API_DeleteEndpoint.html)
-   [`DeletePlatformApplication`](https://docs.aws.amazon.com/sns/latest/api/API_DeletePlatformApplication.html)
-   [`DeleteSMSSandboxPhoneNumber`](https://docs.aws.amazon.com/sns/latest/api/API_DeleteSMSSandboxPhoneNumber.html)
-   [`DeleteTopic`](https://docs.aws.amazon.com/sns/latest/api/API_DeleteTopic.html)
-   [`GetDataProtectionPolicy`](https://docs.aws.amazon.com/sns/latest/api/API_GetDataProtectionPolicy.html)
-   [`GetEndpointAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_GetEndpointAttributes.html)
-   [`GetPlatformApplicationAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)
-   [`GetSMSAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_GetSMSAttributes.html)
-   [`GetSMSSandboxAccountStatus`](https://docs.aws.amazon.com/sns/latest/api/API_GetSMSSandboxAccountStatus.html)
-   [`GetSubscriptionAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)
-   [`GetTopicAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_GetTopicAttributes.html)
-   [`ListEndpointsByPlatformApplication`](https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)
-   [`ListOriginationNumbers`](https://docs.aws.amazon.com/sns/latest/api/API_ListOriginationNumbers.html)
-   [`ListPhoneNumbersOptedOut`](https://docs.aws.amazon.com/sns/latest/api/API_ListPhoneNumbersOptedOut.html)
-   [`ListPlatformApplications`](https://docs.aws.amazon.com/sns/latest/api/API_ListPlatformApplications.html)
-   [`ListSMSSandboxPhoneNumbers`](https://docs.aws.amazon.com/sns/latest/api/API_ListSMSSandboxPhoneNumbers.html)
-   [`ListSubscriptions`](https://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptions.html)
-   [`ListSubscriptionsByTopic`](https://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptionsByTopic.html)
-   [`ListTagsForResource`](https://docs.aws.amazon.com/sns/latest/api/API_ListTagsForResource.html)
-   [`ListTopics`](https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html)
-   [`OptInPhoneNumber`](https://docs.aws.amazon.com/sns/latest/api/API_OptInPhoneNumber.html)
-   [`PublishBatch`](https://docs.aws.amazon.com/sns/latest/api/API_PublishBatch.html)
-   [`PutDataProtectionPolicy`](https://docs.aws.amazon.com/sns/latest/api/API_PutDataProtectionPolicy.html)
-   [`RemovePermission`](https://docs.aws.amazon.com/sns/latest/api/API_RemovePermission.html)
-   [`SetEndpointAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_SetEndpointAttributes.html)
-   [`SetPlatformApplicationAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)
-   [`SetSMSAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_SetSMSAttributes.html)
-   [`SetSubscriptionAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_SetSubscriptionAttributes.html)
-   [`SetTopicAttributes`](https://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html)
-   [`Subscribe`](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)
-   [`TagResource`](https://docs.aws.amazon.com/sns/latest/api/API_TagResource.html)
-   [`Unsubscribe`](https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)
-   [`UntagResource`](https://docs.aws.amazon.com/sns/latest/api/API_UntagResource.html)
-   [`VerifySMSSandboxPhoneNumber`](https://docs.aws.amazon.com/sns/latest/api/API_VerifySMSSandboxPhoneNumber.html)

## 学多点

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

## 常见问题

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

公务 aws-lite sNS 插件

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

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

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

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

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

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

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

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

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

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

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

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

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

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