@aws-sdk/client-ecr-public

中文文档
3.1164.0发布于 2026/11/07Apache-2.0TypeScriptESM + CJS近 30 天下载 24.3万

JavaScript Ecr 节点公共客户端的 AWS SDK, 浏览器和 React Independent

中文使用文档
文档目录10 节
  1. 说明
  2. 安装
  3. 开始
  4. 导入
  5. 使用量
  6. 解决问题
  7. 获取帮助
  8. 捐款
  9. 许可证
  10. 客户端命令( 操作列表)

@aws-sdk/ 客户端- ecr- public

说明

JavaScript 的 AWS SDK 为 Node.js 的 ECRPUBLIC 客户端, 浏览器和 React Industrial.

亚马逊弹性集装箱登记处

亚马逊弹性集装箱登记公共(Amazon ECR Public)是一个管理下的集装箱图像登记服务. 亚马逊ECR提供两者 用于存储您的容器图像的公共和私人注册。 您可以使用多克CLI或 您的首选客户端可以按下、拉出和管理图像。 Amazon ECR提供一种安全可扩展的, 和您的 Docker 或 开放式集装箱倡议图像的可靠注册。 亚马逊 ECR 用此 API 支持公共寄存器 。 关于 Amazon ECR API 的私人信息 仓库,见 亚马逊弹性集装箱登记簿。 。 。 .

安装

要安装此软件包, 请使用您最喜欢的软件包管理器的 CLI :

  • npm install @aws-sdk/client-ecr-public
  • yarn add @aws-sdk/client-ecr-public
  • pnpm add @aws-sdk/client-ecr-public

开始

导入

AWS SDK由客户端和命令进行调制. 要发送请求,只需导入 ECRPUBLICClient 财务报告和审定财务报表 例如,您需要的命令 ListTagsForResourceCommand数字 :

// ES5 example
const { ECRPUBLICClient, ListTagsForResourceCommand } = require("@aws-sdk/client-ecr-public");
// ES6+ example
import { ECRPUBLICClient, ListTagsForResourceCommand } from "@aws-sdk/client-ecr-public";

使用量

发出请求:

  • 以配置(如证书,区域)为客户端提供证据.
  • 以输入参数证明命令 .
  • 打电话 send 操作客户端,以输入方式提供命令对象.
const client = new ECRPUBLICClient({ region: "REGION" });

const params = { /** input parameters */ };
const command = new ListTagsForResourceCommand(params);

自动/等待

我们建议使用 等待时 运算符等待通过发送操作返回的承诺如下:

// async/await.
try {
  const data = await client.send(command);
  // process data.
} catch (error) {
  // error handling.
} finally {
  // finally.
}

承诺

您还可以使用 承诺连锁。 。 。 .

client
  .send(command)
  .then((data) => {
    // process data.
  })
  .catch((error) => {
    // error handling.
  })
  .finally(() => {
    // finally.
  });

合并客户端

归集客户端类别从同套件中导出,但没有"Client"后缀.

ECRPUBLIC 扩展 ECRPUBLICClient 并额外支持所有操作,服务员, 和活人作为方法. 这种风格可能从JavaScript v2的AWS SDK中为您所熟悉.

如果你正在捆绑 AWS SDK, 我们建议只使用赤骨客户端(ECRPUBLICClient) (中文(简体) ). 更多详情见博客文章: javaScript 的 AWS SDK 模块包。 。 。 .

import { ECRPUBLIC } from "@aws-sdk/client-ecr-public";

const client = new ECRPUBLIC({ region: "REGION" });

// async/await.
try {
  const data = await client.listTagsForResource(params);
  // process data.
} catch (error) {
  // error handling.
}

// Promises.
client
  .listTagsForResource(params)
  .then((data) => {
    // process data.
  })
  .catch((error) => {
    // error handling.
  });

// callbacks (not recommended).
client.listTagsForResource(params, (err, data) => {
  // process err and data.
});

解决问题

当服务返回例外时,错误将包括例外信息, 以及响应元数据(如请求编号).

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 specifying exception names:
   * if (error.name === 'SomeServiceException') {
   *     const value = error.specialKeyInException;
   * }
   */
}

另见 文档/错误。 。 。 .

获取帮助

请利用这些社区资源获得帮助. 我们使用 GitHub 问题来跟踪错误和特性请求,但处理它们的带宽有限.

为了测试您在Node.js中通用的JavaScript代码,浏览器和反应本地环境, 拜访我们 代码样本 repo。 。 。 .

捐款

此客户端代码是自动生成的. 任何修改在下次修改时都会被覆盖 @aws-sdk/client-ecr-public 软件包正在更新. 为了帮助客户,你可以检查我们 生成客户端脚本。 。 。 .

许可证

此 SDK 分布于 Apache 许可证,2.0版本, (中文(简体) ), 更多信息见LICENSE.

客户端命令( 操作列表)

批量检查Layer可用性

命令 API 引用 编号 : 投入 编号 : 产出

批量删除图像

命令 API 引用 编号 : 投入 编号 : 产出

完成 Layer 卸载

命令 API 引用 编号 : 投入 编号 : 产出

创建仓库

命令 API 引用 编号 : 投入 编号 : 产出

删除仓库

命令 API 引用 编号 : 投入 编号 : 产出

删除仓库政策

命令 API 引用 编号 : 投入 编号 : 产出

说明

命令 API 引用 编号 : 投入 编号 : 产出

描述图像标签

命令 API 引用 编号 : 投入 编号 : 产出

描述 注册

命令 API 引用 编号 : 投入 编号 : 产出

描述仓库

命令 API 引用 编号 : 投入 编号 : 产出

获取认证

命令 API 引用 编号 : 投入 编号 : 产出

获取RegistryCatalog数据

命令 API 引用 编号 : 投入 编号 : 产出

获取仓库CatalogData

命令 API 引用 编号 : 投入 编号 : 产出

获取仓库政策

命令 API 引用 编号 : 投入 编号 : 产出

启动 Layer 上载

命令 API 引用 编号 : 投入 编号 : 产出

列表标签格式资源

命令 API 引用 编号 : 投入 编号 : 产出

配置图

命令 API 引用 编号 : 投入 编号 : 产出

PutRegistryCatalog 数据

命令 API 引用 编号 : 投入 编号 : 产出

安装仓库CatalogData

命令 API 引用 编号 : 投入 编号 : 产出

设置仓库政策

命令 API 引用 编号 : 投入 编号 : 产出

标签资源

命令 API 引用 编号 : 投入 编号 : 产出

调和资源

命令 API 引用 编号 : 投入 编号 : 产出

上传Layer 组件

命令 API 引用 编号 : 投入 编号 : 产出

版本与发布记录

@aws-sdk/client-ecr-public 共发布 687 个版本,首次发布于 2020/12/05;过去 12 个月发布了 221 个版本。

版本发布日期距今
3.1164.0latest2026/11/07今天
3.1163.02026/11/061 天前
3.1162.02026/11/052 天前
3.1161.02026/10/318 天前
3.1160.02026/10/309 天前
3.1159.02026/10/2910 天前

其他发布通道:rc → 3.5.1-rc.0。

关于 @aws-sdk/client-ecr-public 的常见问题

@aws-sdk/client-ecr-public 是什么?

JavaScript Ecr 节点公共客户端的 AWS SDK, 浏览器和 React Independent

如何安装 @aws-sdk/client-ecr-public?

在项目目录运行 npm install @aws-sdk/client-ecr-public,或使用 pnpm add / yarn add / bun add。

@aws-sdk/client-ecr-public 支持 TypeScript 吗?

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

@aws-sdk/client-ecr-public 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@aws-sdk/client-ecr-public 需要什么版本的 Node.js?

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

@aws-sdk/client-ecr-public 可以商用吗?

@aws-sdk/client-ecr-public 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@aws-sdk/client-ecr-public 的下载量有多少?

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

@aws-sdk/client-ecr-public 还在维护吗?

最新版本 3.1164.0 发布于 2026/11/07(今天);至今共发布 687 个版本,其中过去 12 个月发布了 221 个;首次发布于 2020/12/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。