Azure NetApp Files Skill

SkillFiles & storage

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, AzAcSnap backups, CRR/RP replication, or object REST API, and other Azure NetApp Files related development tasks. Not for Azure Elastic SAN (use azure-elastic-san), Azure Managed Lustre (use azure-managed-lustre), Azure Blob Storage (use azure-blob-storage), Azure Files (use azure-files).

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Azure NetApp Files Skill skill

What this skill tells your AI

The instructions your AI receives, as published by microsoftdocs/agent-skills in skills/azure-netapp-files/SKILL.md and read by ahel’s review.

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

CategoryLinesDescription
TroubleshootingL37-L58Diagnosing and fixing Azure NetApp Files issues: networking, NFS/SMB auth and locks, latency, capacity pools, snapshots, CMK encryption, app volume groups, and RP/CRR errors.
Best PracticesL59-L79Performance and configuration best practices for Azure NetApp Files: tuning Linux/SMB/NFS, VM and AVS choices, Oracle/AVD setups, quotas, cloning, AzAcSnap, Terraform, and benchmarking.
Decision MakingL80-L94Cost, 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 PatternsL95-L103Designing and deploying Azure NetApp Files for SAP HANA/Oracle, AVS datastores, VNet and AD topology, and high‑performance, multi-volume application architectures.
Limits & QuotasL104-L130Limits, quotas, and performance for Azure NetApp Files: volume size/throughput, cache and large-volume limits, user/group/inode quotas, SAP/Oracle/Linux benchmarks, regional capacity, replication, and path/charset constraints.
SecurityL131-L168Security, encryption, and access control for Azure NetApp Files: keys (CMK/HSM/double), Kerberos/LDAP/AD, NFS/SMB permissions, ransomware protection, and secure API/control-plane configuration.
ConfigurationL169-L210Configuring Azure NetApp Files accounts, volumes (NFS/SMB/dual-protocol), backups, caching, networking/AD/LDAP, AzAcSnap, and Elastic zone-redundant pools for apps like SAP HANA and Oracle.
Integrations & Coding PatternsL211-L225Using 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.
DeploymentL226-L239Deploying 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

TopicURL
Troubleshoot common AzAcSnap tool issueshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-troubleshoot
Diagnose Azure NetApp Files Resource Provider errors and workaroundshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-troubleshoot-resource-provider-errors
Resolve stale file locks on ANF cache volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/break-file-locks-cache-volume
Resolve Azure NetApp Files networking issueshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-networking
Resolve Azure NetApp Files NFS protocol issueshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-nfs
Resolve common SMB issues in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-smb
Reset SMB computer account password for NetApp cache volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/reset-password-cache-volumes
Diagnose and fix Azure NetApp Files application volume group errorshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-application-volume-groups
Resolve SMB authentication and CIFS password reset failures in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-authentication-password-reset-failure
Resolve Azure NetApp Files capacity pool errorshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-capacity-pools
Troubleshoot Azure NetApp Files cross-region replication issueshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-cross-region-replication
Fix customer-managed key encryption issues in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-customer-managed-keys
Troubleshoot Azure NetApp Files with Diagnose and Solvehttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-diagnose-solve-problems
Clear stale file locks on Azure NetApp Files NFS and SMB volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-file-locks
Diagnose and fix Azure NetApp Files latencyhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-latency-issues
Resolve Azure NetApp Files snapshot policy management errorshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-snapshot-policies
Troubleshoot LDAP user access issues on Azure NetApp Files volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-user-access-ldap
Diagnose and fix Azure NetApp Files volume errorshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/troubleshoot-volumes

Best Practices

TopicURL
Apply practical tips for using AzAcSnaphttps://learn.microsoft.com/en-us/azure/azure-netapp-files/azacsnap-tips
Run performance benchmark tests on Azure NetApp Files volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-performance-metrics-volumes
Apply SMB performance best practices for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-smb-performance
Use Azure NetApp Files cloning safely and effectivelyhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-clone
Optimize Azure NetApp Files datastores for AVS performancehttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-azure-vmware-solution-datastore
Optimize Linux NFS concurrency on Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-linux-concurrency-session-slots
Tune Linux direct I/O for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-linux-direct-io
Optimize Linux filesystem cache for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-linux-filesystem-cache
Configure Linux NFS mount options for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-linux-mount-options
Adjust Linux NFS read-ahead for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-linux-nfs-read-ahead
Select Azure VM SKUs for Azure NetApp Files performancehttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-virtual-machine-sku
Optimize Oracle dNFS with Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/solutions-benefits-azure-netapp-files-oracle-database
Deploy Azure Virtual Desktop with NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/solutions-windows-virtual-desktop
Safely update Terraform-managed Azure NetApp Files resourceshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/terraform-manage-volume
Apply Azure NetApp Files performance testing methodologyhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/testing-methodology
Plan Active Directory Domain Services for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/understand-guidelines-active-directory-domain-service-site
Plan and manage Azure NetApp Files volume hard quotashttps://learn.microsoft.com/en-us/azure/azure-netapp-files/volume-hard-quota-guidelines

Decision Making

TopicURL
Optimize Azure NetApp Files costs and billinghttps://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-cost-model
Choose Azure NetApp Files service levels by throughputhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-service-levels
Understand Azure NetApp Files backup capabilities and cost modelhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/backup-introduction
Choose Azure NetApp Files data protection optionshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/data-protection-disaster-recovery-options
Change Azure NetApp Files volume service level dynamicallyhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/dynamic-change-volume-service-level
Enable SMB Continuous Availability on Azure NetApp Files volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/enable-continuous-availability-existing-smb
Evaluate performance trade-offs of Azure NetApp Files cool accesshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-considerations-cool-access
Choose Azure NetApp Files replication modelhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/replication
Optimize Azure NetApp Files costs with reservationshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/reservations
Assess SQL Server TCO with Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/solutions-benefits-azure-netapp-files-sql-server
Choose Azure NetApp Files volume types by workloadhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/workload-types

Architecture & Design Patterns

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

Limits & Quotas

TopicURL
Add SAP HANA hosts using Azure NetApp Files application volume grouphttps://learn.microsoft.com/en-us/azure/azure-netapp-files/application-volume-group-add-hosts
Configure auxiliary NFS groups and limits in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/auxiliary-groups
Plan Azure NetApp Files volume throughput and quotashttps://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-performance-considerations
Manage Azure NetApp Files resource limits and quotashttps://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-netapp-files-resource-limits
Apply resize limits for ANF cache volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/cache-volumes-resize-guidelines
Enable LDAP extended groups for Azure NetApp Files NFS volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-ldap-extended-groups
Configure user and group quotas on Azure NetApp Files volumeshttps://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 Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/directory-sizes-concept
Understand Azure NetApp Files performance limitshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-performance
Review Azure NetApp Files large volume limitshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/large-volumes
Understand Azure NetApp Files large volume limitshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/large-volumes-requirements-considerations
Manage user and group quotas on Azure NetApp Files volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/manage-default-individual-user-group-quotas
Manage maxfiles limits and inode quotas in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/maxfiles-concept
Use Azure NetApp Files AVS datastore performance benchmarkshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-benchmarks-azure-vmware-solution
Review Azure NetApp Files Linux performance benchmarkshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-benchmarks-linux
Review breakthrough mode performance limits for Azure NetApp Files large volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-large-volume-breakthrough-mode-linux
Understand large volume performance limits on Azure NetApp Files for Linuxhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-large-volumes-linux
Assess Oracle performance on a single Azure NetApp Files volumehttps://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-oracle-single-volumes
Understand Azure NetApp Files regional capacity quotashttps://learn.microsoft.com/en-us/azure/azure-netapp-files/regional-capacity-quota
Check Azure NetApp Files replication requirements and limitshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/replication-requirements
Restore individual Azure NetApp Files from backuphttps://learn.microsoft.com/en-us/azure/azure-netapp-files/restore-single-file-backup
Understand file and path length limits in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/understand-path-lengths
Configure volume language and character set limits in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/understand-volume-languages

Security

TopicURL
Use Azure Policy definitions with Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/azure-policy-definitions
Configure NFSv4.1 access control lists in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-access-control-lists
Configure customer-managed encryption keys for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-customer-managed-keys
Secure Azure NetApp Files with HSM-backed customer-managed keyshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-customer-managed-keys-hardware
Configure NFSv4.1 Kerberos encryption for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-kerberos-encryption
Secure Azure NetApp Files with AD DS LDAP over TLShttps://learn.microsoft.com/en-us/azure/azure-netapp-files/configure-ldap-over-tls
Manage Azure NetApp Files control plane security and accesshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/control-plane-security
Configure cross-tenant customer-managed keys for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/customer-managed-keys-cross-tenant
Configure Azure NetApp Files data plane security optionshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/data-plane-security
Disable NFS showmount for Azure NetApp Files securityhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/disable-showmount
Configure double encryption at rest for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/double-encryption-at-rest
Choose dual-protocol security styles and permissions in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/dual-protocol-permission-behaviors
Configure AD connection for Elastic SMB volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/elastic-active-directory
Configure CMK encryption for Elastic NetApp volumeshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/elastic-customer-managed-keys
Understand AES encryption behavior in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/faq-advanced-encryption-standard
Join Linux VM to Microsoft Entra Domainhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/join-active-directory-domain
Use Kerberos authentication with Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/kerberos
Understand LDAP usage and directory access for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/lightweight-directory-access-protocol
Use local NFS users with LDAP in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/lightweight-directory-access-protocol-local-users
Configure LDAP name mapping rules for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/lightweight-directory-access-protocol-name-mapping
Configure LDAP schemas for Azure NetApp Files directory lookupshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/lightweight-directory-access-protocol-schemas
Manage SMB share ACLs for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/manage-smb-share-access-control-lists
Manage NAS file and folder permissions in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/network-attached-file-permissions
Configure NFS mode-bit file permissions in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/network-attached-file-permissions-nfs
Configure SMB NTFS file permissions in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/network-attached-file-permissions-smb
Configure NAS share permissions for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/network-attached-storage-permissions
Manage NFS group memberships and supplemental groups for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/network-file-system-group-memberships
Use NFSv4.x ACLs for access control in Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/nfs-access-control-lists
Configure Azure NetApp Files object REST API securelyhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/object-rest-api-access-configure
Understand Kerberos security and performance impact on Azure NetApp Files NFSv4.1https://learn.microsoft.com/en-us/azure/azure-netapp-files/performance-impact-kerberos
Configure advanced ransomware protection for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/ransomware-configure
Meet requirements for Azure NetApp Files ransomware protectionhttps://learn.microsoft.com/en-us/azure/azure-netapp-files/ransomware-protection-requirements
Configure AES-based Kerberos encryption for Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/azure-netapp-files/understand-advanced-encryption-standard
Configure data encryption for Azure NetApp Files at rest and in transithttps://learn.microsoft.com/en-us/azure/azure-netapp-files/understand-data-encryption

Shortened here. Read the whole file on GitHub.

Signals

GitHub stars
740
Forks
119
Last commit
Sep 2026

ahel review

  • S4info
    community integration — published by microsoftdocs, not azure

Automated review, not a security audit. Ruleset v1.

Advanced
Catalog kind
skill
Gateway key
azure-netapp-files
Source
github.com/microsoftdocs/agent-skills