@ediri/azapi

中文文档
1.12.2发布于 2024/05/11Apache-2.0TypeScript构建来源已验证近 30 天下载 3.6万

A Pulumi package for creating and managing Azapi resources

原始使用文档
文档目录7 节
  1. Installing
  2. Node.js (JavaScript/TypeScript)
  3. Python
  4. Go
  5. .NET
  6. Configuration
  7. Reference

AzAPI Resource Provider

AzAPI

The AzAPI Resource Provider lets you manage AzAPI resources.

Installing

This package is available for several languages/platforms:

Node.js (JavaScript/TypeScript)

To use from JavaScript or TypeScript in Node.js, install using either npm:

npm install @ediri/azapi

or yarn:

yarn add @ediri/azapi

Python

To use from Python, install using pip:

pip install ediri_azapi

Go

To use from Go, use go get to grab the latest version of the library:

go get github.com/dirien/pulumi-azapi/sdk

.NET

To use from .NET, install using dotnet add package:

dotnet add package ediri.Azapi

Configuration

The following configuration points are supported for the AzAPI provider:

  • ClientId - (Optional) The Client ID which should be used. This can also be sourced from the ARM_CLIENT_ID Environment Variable.

  • Environment - (Optional) The Cloud Environment which should be used. Possible values are public, usgovernment and china. Defaults to public. This can also be sourced from the ARM_ENVIRONMENT Environment Variable.

  • SubscriptionId - (Optional) The Subscription ID which should be used. This can also be sourced from the ARM_SUBSCRIPTION_ID Environment Variable.

  • TenantId - (Optional) The Tenant ID should be used. This can also be sourced from the ARM_TENANT_ID Environment Variable.


It's possible to configure the behaviour of certain resources using the following properties:

  • DefaultTags - (Optional) A mapping of tags which should be assigned to the azure resource as default tags. tags in each resource block can override the default_tags.

  • DefaultLocation - (Optional) The default Azure Region where the azure resource should exist. location in each resource block can override the default_location. Changing this forces new resources to be created.


When authenticating as a Service Principal using a Client Certificate, the following fields can be set:

  • ClientCertificatePassword - (Optional) The password associated with the Client Certificate. This can also be sourced from the ARM_CLIENT_CERTIFICATE_PASSWORD Environment Variable.

  • ClientCertificatePath - (Optional) The path to the Client Certificate associated with the Service Principal which should be used. This can also be sourced from the ARM_CLIENT_CERTIFICATE_PATH Environment Variable.


When authenticating as a Service Principal using a Client Secret, the following fields can be set:

  • ClientSecret - (Optional) The Client Secret which should be used. This can also be sourced from the ARM_CLIENT_SECRET Environment Variable.

When authenticating as a Service Principal using Open ID Connect, the following fields can be set:

  • OidcRequestToken - (Optional) The bearer token for the request to the OIDC provider. This can also be sourced from the ARM_OIDC_REQUEST_TOKEN or ACTIONS_ID_TOKEN_REQUEST_TOKEN Environment Variables.

  • OidcRequestUrl - (Optional) The URL for the OIDC provider from which to request an ID token. This can also be sourced from the ARM_OIDC_REQUEST_URL or ACTIONS_ID_TOKEN_REQUEST_URL Environment Variables.

  • OidcToken - (Optional) The ID token when authenticating using OpenID Connect (OIDC). This can also be sourced from the ARM_OIDC_TOKEN environment Variable.

  • OidcTokenFilePath - (Optional) The path to a file containing an ID token when authenticating using OpenID Connect (OIDC). This can also be sourced from the ARM_OIDC_TOKEN_FILE_PATH environment Variable.

  • UseOidc - (Optional) Should OIDC be used for Authentication? This can also be sourced from the ARM_USE_OIDC Environment Variable. Defaults to false.


For some advanced scenarios, such as where more granular permissions are necessary - the following properties can be set:

  • DisableCorrelationRequestId - (Optional) Disable sending the x-ms-correlation-request-id header. This can also be sourced from the ARM_DISABLE_CORRELATION_REQUEST_ID environment variable. Defaults to false.

  • DisableTerraformPartnerId - (Optional) Disable sending the Terraform Partner ID if a custom partner_id isn't specified, which allows Microsoft to better understand the usage of Terraform. The Partner ID does not give HashiCorp any direct access to usage information. This can also be sourced from the ARM_DISABLE_TERRAFORM_PARTNER_ID environment variable. Defaults to false.

  • PartnerId - (Optional) A GUID/UUID that is registered with Microsoft to facilitate partner resource usage attribution. This can also be sourced from the ARM_PARTNER_ID Environment Variable.

  • SkipProviderRegistration - (Optional) Should the Provider skip registering the Resource Providers it supports? This can also be sourced from the ARM_SKIP_PROVIDER_REGISTRATION Environment Variable. Defaults to false.

Reference

For detailed reference documentation, please visit the Pulumi registry.

版本与发布记录

@ediri/azapi 共发布 15 个版本,首次发布于 2023/02/19;过去 12 个月发布了 0 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.12.2latest2024/05/112 年前
1.12.12024/03/042 年前
1.12.02024/01/292 年前
1.11.02023/12/272 年前
1.10.02023/11/152 年前
1.9.02023/09/183 年前

关于 @ediri/azapi 的常见问题

@ediri/azapi 是什么?

A Pulumi package for creating and managing Azapi resources

如何安装 @ediri/azapi?

在项目目录运行 npm install @ediri/azapi,或使用 pnpm add / yarn add / bun add。

@ediri/azapi 支持 TypeScript 吗?

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

@ediri/azapi 可以商用吗?

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

@ediri/azapi 的下载量有多少?

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

@ediri/azapi 还在维护吗?

最新版本 1.12.2 发布于 2024/05/11(2 年前);至今共发布 15 个版本,其中过去 12 个月发布了 0 个;首次发布于 2023/02/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。