Pulumi Azure Native

Warnings

• breaking Pulumi Azure Native frequently introduces breaking changes due to its direct mapping to the evolving Azure Resource Manager (ARM) API. These changes often involve the removal, renaming, or type modification of resource input properties and output properties.
  Fix: Review release notes before upgrading and test thoroughly. Consult the official Pulumi Azure Native API documentation for the correct resource schemas for your target version. Adjust resource definitions to match updated property names or types.
• gotcha Pulumi uses logical resource names for its state, which are distinct from the physical resource names deployed in Azure. The first argument to a resource constructor is the logical name, while an explicit property (e.g., `resource_group_name`) sets the actual Azure resource name.
  Fix: Always provide distinct logical names for Pulumi resources in your code. Explicitly set the `name` or `*_name` property if you require a specific physical name in Azure. For example, `azure_native.resources.ResourceGroup("my-rg-logic", resource_group_name="my-actual-rg")`.
• gotcha Resource properties are often Pulumi 'Output' types (futures) which resolve asynchronously. Attempting to use a raw Output object as a string or a direct value will result in unexpected behavior.
  Fix: When passing an Output property to another Pulumi resource's input, pass the Output directly. Pulumi handles the dependency. If you need to transform or print an Output value, use its `.apply(lambda value: ...)` method or `pulumi.Output.all()` for multiple outputs.
• gotcha Pulumi Azure Native relies on pre-configured Azure authentication. It does not manage your Azure credentials directly, but rather uses credentials available to the underlying Azure SDK (typically via Azure CLI login or environment variables).
  Fix: Ensure you are authenticated to Azure before running `pulumi up`. This usually involves running `az login` via the Azure CLI, or setting appropriate environment variables like `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`, `AZURE_TENANT_ID`, and `AZURE_SUBSCRIPTION_ID`.

Install

• pip install pulumi-azure-native Install Pulumi Azure Native

Imports

• ResourceGroup

  from pulumi_azure_native import resources

  Azure resources are organized into namespaces, typically accessed as submodules (e.g., `resources`, `storage`, `network`). It's common to import the module and then access the resource class (e.g., `resources.ResourceGroup`).
• StorageAccount

  from pulumi_azure_native import storage

  Specific Azure services like 'Storage' or 'Network' have their own submodules under `pulumi_azure_native`.
• SkuArgs

  from pulumi_azure_native.storage import SkuArgs

  Configuration arguments for complex types within resources are often available directly under the service submodule or by accessing `service_module.ClassNameArgs` (e.g., `storage.SkuArgs`).

Quickstart

This quickstart deploys an Azure Resource Group and a Storage Account using `pulumi-azure-native`. Ensure you have Pulumi CLI installed, Azure CLI logged in (`az login`), and set a default Azure location (`pulumi config set azure-native:location eastus`). The `stack_suffix` is used to ensure globally unique names for resources like storage accounts.

import pulumi
import pulumi_azure_native as azure_native
import os

# Pulumi requires Azure credentials to be configured (e.g., via `az login` or environment variables).
# The Azure location is usually set via `pulumi config set azure-native:location eastus`.

# Define a unique suffix for resource names to avoid conflicts
# In a real project, this might come from pulumi.StackReference or config.
stack_suffix = os.environ.get("PULUMI_STACK_SUFFIX", "dev").lower()

# Create an Azure Resource Group
resource_group = azure_native.resources.ResourceGroup("my-resource-group",
    resource_group_name=f"my-pulumi-rg-{stack_suffix}",
    location="EastUS") # Location often configured globally via 'pulumi config set azure-native:location'

# Create an Azure Storage Account
# Note: Storage account names must be globally unique and lowercase.
storage_account = azure_native.storage.StorageAccount("mystorageaccount",
    resource_group_name=resource_group.name, # Pulumi automatically unwraps output properties
    account_name=f"mypulumiaccount{stack_suffix}123",
    location=resource_group.location,
    sku=azure_native.storage.SkuArgs(name="Standard_LRS"),
    kind="StorageV2")

pulumi.export("resource_group_name", resource_group.name)
pulumi.export("storage_account_name", storage_account.name)
pulumi.export("storage_account_primary_blob_endpoint", storage_account.primary_endpoints.apply(lambda endpoints: endpoints.blob))