# @adaptiveworx/iac-schemas 中文文档

规范地址：https://npmcn.com/package/%40adaptiveworx/iac-schemas/

版本：0\.1\.6
npm 元数据更新时间：2026-10-03T23:03:22.262Z
中文译文更新时间：2026-11-06T18:10:12.196Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40adaptiveworx/iac-schemas
原文对照：https://npmcn.com/package/%40adaptiveworx/iac-schemas/?lang=original
项目主页：https://github.com/AdaptiveWorX/iac-core/tree/main/packages/iac-schemas#readme
源码仓库：https://github.com/AdaptiveWorX/iac-core

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

- 包体积（解压后）：48.7 kB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=26\.0\.0
- 运行依赖：0 个
- peer 依赖：typescript ^6\.0\.0 \|\| ^7\.0\.0
- 首次发布：2026-04-29T14:30:27.376Z
- 最新版本发布：2026-10-03T23:03:21.937Z
- 近 30 天下载量：2504（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：7（近 12 个月 7 个）

## 中文简介

每个供应商的区域代码和名称,以及标准标记键,用于AdaptiveWorXTM基础设施-as-code. 纯数据+类型——无运行时间依赖.

## 安装

```sh
npm install @adaptiveworx/iac-schemas
```

也可以使用：`pnpm add @adaptiveworx/iac-schemas`、`yarn add @adaptiveworx/iac-schemas`、`bun add @adaptiveworx/iac-schemas`

## README

# @ 适应worx/iac- schemas

每个提供者的区域代码和名称以及标准标记键,用于 [适应WorXTM 流](https://adaptiveworx.com/) (原始内容存档于2019-09-31) (英语). staff-as-code.

这个软件包是 **纯数据+类型** ——零运行时间依赖. 这是全区域解析真相的来源 `@adaptiveworx/iac-*` 包并安全地从任何 TypeScript 项目导入.

## 安装

```bash
pnpm add @adaptiveworx/iac-schemas
# or
yarn add @adaptiveworx/iac-schemas
# or
npm install @adaptiveworx/iac-schemas
```

## 使用量

### 区域决议

```ts
import { regions } from "@adaptiveworx/iac-schemas";

// AWS region aliases
regions.aws.aliases.use1; // "us-east-1"
regions.aws.aliases.usw2; // "us-west-2"

// Azure region aliases
regions.azure.aliases.eus2; // "eastus2"

// Available canonical regions per provider
regions.aws.regions; // ["us-east-1", "us-west-2", ...]

// Cloudflare (no regions): the single code glb
regions.cloudflare.aliases.glb; // "global"
```

### 输入的区域数据

```ts
import { AWS_REGION_CODES, AWS_REGION_NAMES, REGIONS } from "@adaptiveworx/iac-schemas";
import type { AwsRegionCode, AwsRegionName } from "@adaptiveworx/iac-schemas";

REGIONS.aws.aliases.use1; // "us-east-1", typed as the literal
const code: AwsRegionCode = "usw2";
```

`REGIONS` (单位:千美元)`src/regions.ts`)是区域数据的唯一来源;iac-core 来源 `AwsRegion` 财务报告和审定财务报表 `AwsRegionSchema` 从它. `config/regions.json` 实值 与JSON相同的数据,通过单位测试保持等值.

### 标准标签密钥

```ts
import { STANDARD_TAG_KEYS } from "@adaptiveworx/iac-schemas";
// Environment, Tenant, AccountPurpose, StackPurpose, TargetEnvironment,
// Workload, ManagedBy, Description
```

`Workload` 命名资源属于( ) 的工作量`flow`, (中文(简体) ), `ztna`; ; ; ; ; `shared` 共享基础设施。 权限边界和 ABAC 其进入范围.

### 直接导入 JSON

对于更喜欢生JSON的工具(如JSON Schema验证器,建造管道):

```ts
import regions from "@adaptiveworx/iac-schemas/regions" with { type: "json" };
```

## 什么样的船

| 路径 | 目录 |
| --- | --- |
| `dist/index.js` + 键 `dist/index.d.ts` | 图书馆条目 : `regions`, (中文(简体) ), `REGIONS`,AWS区域代码/名称清单和类型, `STANDARD_TAG_KEYS` |
| `config/regions.json` | 区域别名数据(也可通过 `./regions` 子路径) |

预生成的 JSON Schemas / OpenAPI / `types.d.ts` 下级 `generated/` 在0.2中被清除:没有东西消耗他们,他们已变成僵尸。 为了JSON 石马,用Zod 4's `z.toJSONSchema()` 直接在iac -core的计画.

## 稳定

这是一个 `0.x` 释放。 形状 `regions.*` 可能改变前向后兼容的方式 `1.0`一次 `1.0` 船,包裹会跟着 [语义版本](https://semver.org/)。 。 。 .

区域别名( N)`use1`, (中文(简体) ), `usw2`等)被认为是稳定的标识符,不会被更名;可能添加新的标识符.

## 许可证

[Apache 2.0 (英语)](https://npmcn.com/package/%40adaptiveworx/iac-schemas/LICENSE)。见 [通知](https://npmcn.com/package/%40adaptiveworx/iac-schemas/NOTICE)。 。 。 .

## 仓库+捐款

此软件包是在 [适应性WorX/iac-worx](https://github.com/AdaptiveWorX/iac-worx) 单重键 : `libs/iac/schemas/`。见 [捐款额](https://github.com/AdaptiveWorX/iac-worx/blob/main/CONTRIBUTING.md) 工作流程惯例和发布程序。 文件问题 [https://github.com/AdaptiveWorX/iac-worx/issues (英语)](https://github.com/AdaptiveWorX/iac-worx/issues)。 。 。 .

## 常见问题

### @adaptiveworx/iac-schemas 是什么？

每个供应商的区域代码和名称,以及标准标记键,用于AdaptiveWorXTM基础设施-as-code\. 纯数据\+类型——无运行时间依赖\.

### 如何安装 @adaptiveworx/iac-schemas？

在项目目录运行 npm install @adaptiveworx/iac-schemas，或使用 pnpm add / yarn add / bun add。

### @adaptiveworx/iac-schemas 支持 TypeScript 吗？

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

### @adaptiveworx/iac-schemas 支持 ESM 还是 CommonJS？

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

### @adaptiveworx/iac-schemas 需要什么版本的 Node\.js？

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

### @adaptiveworx/iac-schemas 可以商用吗？

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

### @adaptiveworx/iac-schemas 的下载量有多少？

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

### @adaptiveworx/iac-schemas 还在维护吗？

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