Install & Compatibility
Where this runs
tested against v17.1.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.732s · 47.4MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 4.0s · import 0.642s · 48MB
47MB installed
● package 47MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
NetAppManagementClient
✓ from azure.mgmt.netapp import NetAppManagementClient
DefaultAzureCredential
✓ from azure.identity import DefaultAzureCredential
This quickstart demonstrates how to authenticate with Azure using `DefaultAzureCredential` and list existing Azure NetApp Files accounts in your subscription. Ensure the necessary environment variables (`AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`, `AZURE_SUBSCRIPTION_ID`) are set for authentication.
import os
from azure.identity import DefaultAzureCredential
from azure.mgmt.netapp import NetAppManagementClient
# Set environment variables for authentication and subscription ID
# AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET, AZURE_SUBSCRIPTION_ID
subscription_id = os.getenv("AZURE_SUBSCRIPTION_ID", "")
if not subscription_id:
raise ValueError("AZURE_SUBSCRIPTION_ID environment variable not set.")
# Authenticate and create a client
credential = DefaultAzureCredential()
client = NetAppManagementClient(credential=credential, subscription_id=subscription_id)
# Example: List NetApp accounts in your subscription
print("Listing NetApp accounts:")
for account in client.accounts.list():
print(f" Account Name: {account.name}, Location: {account.location}")
Debug
Known issues
breakingVersion 15.0.0 introduces new hybrid models with dual dictionary and model nature. Existing code interacting with model properties might need updates.fixRefer to the Azure SDK for Python migration guides for hybrid models (aka.ms/azsdk/python/migrate/hybrid-models) and operation breakings (aka.ms/azsdk/python/migrate/operations). Specific models like `BackupPatch` and `BackupPolicyPatch` had instance variables moved or renamed.
affects: 15.0.0+
gotchaSubnets used for Azure NetApp Files volumes must be delegated to `Microsoft.NetApp/volumes`. Failure to do so will result in volume creation errors.fixEnsure the target subnet is correctly delegated via the Azure portal, Azure CLI, or PowerShell before attempting to create a volume.
affects: All versions
gotchaThe service level of an existing capacity pool cannot be changed if the pool already contains volumes.fixTo change a capacity pool's service level, all volumes within that pool must first be deleted. Alternatively, create a new capacity pool with the desired service level and migrate volumes.
affects: All versions
gotchaWhen using customer-managed keys (CMK) for volume encryption, ensure the Azure Key Vault is in the same region as the NetApp account and configured with appropriate access policies (Get, Encrypt, Decrypt) for the managed identity. The key must be of type RSA, enabled, valid, and active.fixVerify all Key Vault prerequisites and configurations as detailed in the Azure NetApp Files documentation for customer-managed keys.
affects: All versions with CMK support
Upgrade
Version history
17.1.0latest on PyPI · released Jul 23, 2026
Audit
Dependencies
azure-identityrequiredRequired for Azure Active Directory-based authentication.