Skip to content


Slack NPM version Python version NuGet version PkgGoDev License

Native Azure Pulumi Provider

The Azure Native provider for Pulumi lets you use Azure resources in your cloud programs. This provider uses the Azure Resource Manager REST API directly and therefore provides full access to the ARM API.

The Azure Native provider is the recommended provider for projects targeting Azure.

To use this package, install the Pulumi CLI.


This package is available in many languages in the standard packaging formats.

Node.js (Java/TypeScript)

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

npm install @pulumi/azure-native

or yarn:

yarn add @pulumi/azure-native


To use from Python, install using pip:

pip install pulumi_azure_native


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

go get


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

dotnet add package Pulumi.AzureNative


The @pulumi/azure-native package provides a strongly-typed means to build cloud applications that create and interact closely with Azure resources. Resources are exposed for the entire Azure surface area, including (but not limited to) 'compute', 'keyvault', 'network', 'storage', and more.

The Azure Native provider works directly with the Azure Resource Manager (ARM) platform instead of depending on a handwritten layer as with the classic provider. This approach ensures higher quality and higher fidelity with the Azure platform.

Configuring credentials

To learn how to configure credentials refer to the Azure configuration options.

Other Configuration

In addition to the configuration options in the official documentation linked above, the following environment variables can be used to tweak lower-level behavior of the provider:

  • PULUMI_FORCE_NEW_FROM_SUBTYPES: if, after a change in your program, the provider does not replace a resource that should be replaced because it cannot be updated, setting this variable to true might allow the provider to infer the correct behavior. For more details please see PR #2970. We're planning to make this behavior the default in the future.


See contributing for details on how to build and contribute to this provider.


For further information, visit Azure Native in the Pulumi Registry or for detailed API reference documentation, visit Azure Native API Docs in the Pulumi Registry.