azure-netapp-files

name	azure-netapp-files
description	Expert knowledge for Azure NetApp Files development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying ANF for SAP HANA/Oracle, AVS datastores, cross-region replication, AzAcSnap, or object REST API, and other Azure NetApp Files related development tasks. Not for Azure Blob Storage (use azure-blob-storage), Azure Files (use azure-files), Azure Elastic SAN (use azure-elastic-san), Azure Managed Lustre (use azure-managed-lustre).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-09","generator":"docs2skills/1.0.0"}

Azure NetApp Files Skill

This skill provides expert guidance for Azure NetApp Files. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L37-L57	Diagnosing and fixing ANF issues: RP and volume errors, networking/NFS/SMB/LDAP/auth, locks, snapshots, capacity pools, CMK encryption, replication, and AzAcSnap tool problems.
Best Practices	L58-L78	Performance and reliability best practices for Azure NetApp Files: sizing, VM/AVD/AVS choices, NFS/SMB/Linux tuning, cloning, quotas, AD/DNS, Oracle dNFS, AzAcSnap, and Terraform-safe changes.
Decision Making	L79-L93	Cost, performance, and protection design for Azure NetApp Files: choosing service levels, volume types, replication and backup options, reservations, SMB CA, cool access, and SQL Server TCO.
Architecture & Design Patterns	L94-L102	Designing and deploying Azure NetApp Files for SAP HANA/Oracle, AVS datastores, VNet and AD topology, and high‑performance, multi-volume application architectures.
Limits & Quotas	L103-L129	Limits, quotas, and performance behavior of Azure NetApp Files: volume/user quotas, maxfiles/inodes, large-volume and cache limits, performance benchmarks, and file/path/charset constraints.
Security	L130-L167	Security, encryption, and access control for Azure NetApp Files: CMK/HSM keys, Kerberos/LDAP/AD, NFS/SMB permissions, ransomware protection, and secure API/control-plane configuration.
Configuration	L168-L209	Configuring Azure NetApp Files: accounts, pools, volumes (NFS/SMB/dual-protocol), backups, caching, networking/AD/LDAP, AzAcSnap for SAP/Oracle, replication, logging, and QoS.
Integrations & Coding Patterns	L210-L224	Using azacsnap with Azure NetApp Files, REST API and PowerShell operations, and integrating ANF with SAP HANA/Oracle AVGs, S3 clients, Databricks, and OneLake via object REST API.
Deployment	L225-L238	Deploying and configuring Azure NetApp Files for SAP HANA and Oracle (AVGs, HSR, DR, backups), managing cross-region replication, zone changes, ONTAP migration, and regional access.

Troubleshooting

Topic	URL
Troubleshoot common AzAcSnap tool issues	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-troubleshoot
Diagnose Azure NetApp Files Resource Provider errors and workarounds	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-troubleshoot-resource-provider-errors
Resolve stale file locks on ANF cache volumes	https://learn.microsoft.com/en-us/azure/azure-netapp-files/break-file-locks-cache-volume
Resolve Azure NetApp Files networking issues	https://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-networking
Resolve Azure NetApp Files NFS protocol issues	https://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-nfs
Resolve common SMB issues in Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-smb
Reset SMB computer account password for NetApp cache volumes	https://learn.microsoft.com/en-us/azure/azure-netapp-files/reset-password-cache-volumes
Diagnose and fix Azure NetApp Files application volume group errors	https://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-application-volume-groups
Resolve SMB authentication and CIFS password reset failures in Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-authentication-password-reset-failure
Resolve Azure NetApp Files capacity pool errors	https://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-capacity-pools

Best Practices

Topic	URL
Apply practical tips for using AzAcSnap	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-tips
Run performance benchmark tests on Azure NetApp Files volumes	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-performance-metrics-volumes
Apply SMB performance best practices for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-smb-performance
Use Azure NetApp Files cloning safely and effectively	https://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-clone
Optimize Azure NetApp Files datastores for AVS performance	https://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-azure-vmware-solution-datastore
Tune NFS session slots and concurrency for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-linux-concurrency-session-slots
Tune Linux direct I/O for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-linux-direct-io
Optimize Linux filesystem cache for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-linux-filesystem-cache
Configure Linux NFS mount options for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-linux-mount-options
Adjust Linux NFS read-ahead for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-linux-nfs-read-ahead

Decision Making

Topic	URL
Optimize Azure NetApp Files costs and billing	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-cost-model
Choose Azure NetApp Files service levels by throughput	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-service-levels
Understand Azure NetApp Files backup capabilities and cost model	https://learn.microsoft.com/en-us/azure/azure-netapp-files/backup-introduction
Choose Azure NetApp Files data protection options	https://learn.microsoft.com/en-us/azure/azure-netapp-files/data-protection-disaster-recovery-options
Change Azure NetApp Files volume service level dynamically	https://learn.microsoft.com/en-us/azure/azure-netapp-files/dynamic-change-volume-service-level
Enable SMB Continuous Availability on Azure NetApp Files volumes	https://learn.microsoft.com/en-us/azure/azure-netapp-files/enable-continuous-availability-existing-smb
Evaluate performance trade-offs of Azure NetApp Files cool access	https://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-considerations-cool-access
Choose Azure NetApp Files replication model	https://learn.microsoft.com/en-us/azure/azure-netapp-files/replication
Optimize Azure NetApp Files costs with reservations	https://learn.microsoft.com/en-us/azure/azure-netapp-files/reservations
Assess SQL Server TCO with Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/solutions-benefits-azure-netapp-files-sql-server

Architecture & Design Patterns

Topic	URL
Use Azure NetApp Files application volume groups for workload deployment	https://learn.microsoft.com/en-us/azure/azure-netapp-files/application-volume-group-concept
Deploy SAP HANA using Azure NetApp Files application volume groups	https://learn.microsoft.com/en-us/azure/azure-netapp-files/application-volume-group-introduction
Deploy Oracle using Azure NetApp Files application volume groups	https://learn.microsoft.com/en-us/azure/azure-netapp-files/application-volume-group-oracle-introduction
Plan Azure NetApp Files virtual network topologies	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-network-topologies
Architect high-performance Oracle on multiple Azure NetApp Files volumes	https://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-oracle-multiple-volumes

Limits & Quotas

Topic	URL
Add SAP HANA hosts using Azure NetApp Files application volume group	https://learn.microsoft.com/en-us/azure/azure-netapp-files/application-volume-group-add-hosts
Configure auxiliary NFS groups and limits in Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/auxiliary-groups
Plan Azure NetApp Files performance quotas and throughput	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-performance-considerations
Manage Azure NetApp Files resource limits and quotas	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-resource-limits
Apply resize limits for ANF cache volumes	https://learn.microsoft.com/en-us/azure/azure-netapp-files/cache-volumes-resize-guidelines
Enable LDAP extended groups for Azure NetApp Files NFS volumes	https://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-ldap-extended-groups
Configure user and group quotas on Azure NetApp Files volumes	https://learn.microsoft.com/en-us/azure/azure-netapp-files/default-individual-user-group-quotas-introduction
Understand directory size growth and metadata overhead in Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/directory-sizes-concept
Understand Azure NetApp Files performance limits	https://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-performance
Review Azure NetApp Files large volume limits	https://learn.microsoft.com/en-us/azure/azure-netapp-files/large-volumes

Security

Topic	URL
Use Azure Policy definitions with Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-policy-definitions
Configure NFSv4.1 access control lists in Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-access-control-lists
Configure customer-managed encryption keys for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-customer-managed-keys
Secure Azure NetApp Files with HSM-backed customer-managed keys	https://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-customer-managed-keys-hardware
Configure NFSv4.1 Kerberos encryption for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-kerberos-encryption
Configure AD DS LDAP over TLS for NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-ldap-over-tls
Manage Azure NetApp Files control plane security and access	https://learn.microsoft.com/en-us/azure/azure-netapp-files/control-plane-security
Configure cross-tenant customer-managed keys for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/customer-managed-keys-cross-tenant
Configure Azure NetApp Files data plane security options	https://learn.microsoft.com/en-us/azure/azure-netapp-files/data-plane-security
Disable NFS showmount for Azure NetApp Files security	https://learn.microsoft.com/en-us/azure/azure-netapp-files/disable-showmount

Configuration

Topic	URL
Meet requirements for SAP HANA application volume groups on Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/application-volume-group-considerations
Meet requirements for Oracle application volume groups on Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/application-volume-group-oracle-considerations
Use AzAcSnap backup command for snapshots	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-cmd-ref-backup
Run AzAcSnap configure command correctly	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-cmd-ref-configure
Run AzAcSnap test command and validate setup	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-cmd-ref-test
Configure databases for AzAcSnap snapshots	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-configure-database
Configure Azure storage for AzAcSnap usage	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-configure-storage
Configure AzAcSnap 11 preview features for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-preview
Use Azure NetApp Files in Azure Government regions	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-government
Configure NFS export policies for Azure NetApp Files volumes	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-configure-export-policy

Integrations & Coding Patterns

Topic	URL
Use azacsnap delete command for Azure NetApp Files snapshots	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-cmd-ref-delete
Use azacsnap details command with Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-cmd-ref-details
Restore data using azacsnap with Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-cmd-ref-restore
Configure azacsnap runbefore and runafter hooks for Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-cmd-ref-runbefore-runafter
Use Azure NetApp Files REST API for storage operations	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-develop-with-rest-api
Configure SAP HANA AVGs on Azure NetApp Files via REST	https://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-application-volume-group-sap-hana-api
Configure Oracle AVGs on Azure NetApp Files via REST	https://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-application-volume-oracle-api
Call Azure NetApp Files REST API using PowerShell	https://learn.microsoft.com/en-us/azure/azure-netapp-files/develop-rest-api-powershell
Access Azure NetApp Files object REST API volumes with S3 clients	https://learn.microsoft.com/en-us/azure/azure-netapp-files/object-rest-api-browser
Connect Azure Databricks to Azure NetApp Files via object REST API	https://learn.microsoft.com/en-us/azure/azure-netapp-files/object-rest-api-databricks

Deployment

Topic	URL
Add SAP HANA secondary system for HSR with Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/application-volume-group-add-volume-secondary
Deploy first SAP HANA host with Azure NetApp Files application volume group	https://learn.microsoft.com/en-us/azure/azure-netapp-files/application-volume-group-deploy-first-host
Configure SAP HANA disaster recovery with Azure NetApp Files cross-region replication	https://learn.microsoft.com/en-us/azure/azure-netapp-files/application-volume-group-disaster-recovery
Perform disaster recovery with AzAcSnap on ALI	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-disaster-recovery
Install AzAcSnap for Azure NetApp Files backups	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-get-started
Install AzAcSnap on Azure and Large Instances	https://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-installation
Deploy Oracle AVGs on Azure NetApp Files with ARM	https://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-application-volume-oracle-azure-resource-manager
Manage disaster recovery with Azure NetApp Files replication	https://learn.microsoft.com/en-us/azure/azure-netapp-files/cross-region-replication-manage-disaster-recovery
Change availability zones for Elastic capacity pools	https://learn.microsoft.com/en-us/azure/azure-netapp-files/elastic-change-zones
Migrate ONTAP volumes to Azure NetApp Files	https://learn.microsoft.com/en-us/azure/azure-netapp-files/migrate-volumes