你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

Azure Provisioning Core library for JavaScript

@azure/provisioning-core为 Azure 配置资源库提供了共享创作模型。

入门

创建一个部署栈,然后将资源附加到该栈或其他配置组件上:

import { Stack, ResourceGroup, fn } from "@azure/provisioning-core";

const stack = new Stack("application");
new ResourceGroup(stack, {
  name: fn.concat("rg-", fn.uniqueString("application")),
  location: "eastus",
});

使用核心 Resource API 直接将 密钥保管库 资源附加到资源组:

import { Stack, ResourceGroup, Resource, fn } from "@azure/provisioning-core";

const stack = new Stack("keyvault-deployment");
const resourceGroup = new ResourceGroup(stack, {
  name: "rg-keyvault",
  location: "eastus",
});
new Resource(resourceGroup, {
  type: "Microsoft.KeyVault/vaults",
  apiVersion: "2024-11-01",
  name: fn.concat("kv-", fn.uniqueString(resourceGroup.id)),
  location: resourceGroup.location,
  properties: {
    tenantId: "00000000-0000-0000-0000-000000000000",
    sku: { family: "A", name: "standard" },
  },
});

关于服务特定的类型资源类,请参见 密钥保管库 配置示例。

配置定义是在部署前编写的。 只读资源属性仍可作为布线输出和依赖资源的表达式使用,而只能分配可写属性。

部署时间判别器

判别器属性使用文字类型,以便 TypeScript 能够选择正确的联合成员。 当判别子来自部署时表达式时,使用 以 asDiscriminator 选择预期变体,同时保留类型检查其其他属性:

import { ParameterCollection, asDiscriminator } from "@azure/provisioning-core";

type Rule =
  | {
      kind: "cache";
      cacheKind: "long" | "short";
      days: number;
    }
  | {
      kind: "redirect";
      url: string;
    };
const ruleKind = new ParameterCollection().add("ruleKind", "string", {
  allowed: ["cache"],
});
const widget: {
  properties: {
    primaryRule?: Rule;
  };
} = {
  properties: {},
};
widget.properties.primaryRule = {
  kind: asDiscriminator(ruleKind),
  cacheKind: "long",
  days: 7,
};

尽可能倾向于字面上的区分者。 asDiscriminator 不验证部署时间值;使用限制 allowed参数至预期文字。