Catalog
MicrosoftDocs/azure-private-link

MicrosoftDocs

azure-private-link

Expert knowledge for Azure Private Link development including best practices, decision making, architecture & design patterns, limits & quotas, security, and configuration. Use when configuring Private Endpoints, DNS zones, SNAT bypass, Network Security Perimeters, or Azure Private Resolver, and other Azure Private Link related development tasks. Not for Azure Virtual Network (use azure-virtual-network), Azure VPN Gateway (use azure-vpn-gateway), Azure ExpressRoute (use azure-expressroute), Azure Virtual WAN (use azure-virtual-wan).

v1.0Latest
New~1.6kUpdated Jun 26, 2026

Azure Private Link Skill

This skill provides expert guidance for Azure Private Link. Covers best practices, decision making, architecture & design patterns, limits & quotas, security, and configuration. 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
Best Practices L34-L38 DNS design and configuration guidance for private endpoints, including zone setup, name resolution patterns, split-horizon DNS, and avoiding common DNS misconfigurations with Private Link
Decision Making L39-L44 Guidance on choosing perimeter access modes and designing Azure Private Link setups, focusing on security tradeoffs, cost optimization, and migration/transition considerations.
Architecture & Design Patterns L45-L49 Designing DNS architectures for Private Endpoints using Azure Private Resolver, including name resolution patterns, forwarding rules, and integration with on-premises or hybrid networks
Limits & Quotas L50-L56 Details on Private Link/Endpoint capacity limits, per‑VNet scaling (High Scale), resource availability checks, and common behaviors/FAQs around quotas and constraints
Security L57-L64 RBAC setup, security best practices, and traffic inspection/control for Private Endpoints and Private Link using Azure roles, Network Security Perimeters, and Azure Firewall.
Configuration L65-L76 Configuring Private Link/Endpoint behavior: subnet and service network policies, DNS records, SNAT bypass, routing, NSPs, diagnostics, and monitoring data for secure connectivity.

Best Practices

Topic URL
Apply DNS integration best practices for Azure Private Endpoints https://learn.microsoft.com/en-us/azure/private-link/private-endpoint-dns-integration

Decision Making

Topic URL
Choose and transition Azure network security perimeter access modes https://learn.microsoft.com/en-us/azure/private-link/network-security-perimeter-transition
Optimize Azure Private Link design for cost and security https://learn.microsoft.com/en-us/azure/private-link/private-link-cost-optimization

Architecture & Design Patterns

Topic URL
Design DNS infrastructure for Private Endpoints with Azure Private Resolver https://learn.microsoft.com/en-us/azure/private-link/tutorial-dns-on-premises-private-resolver

Limits & Quotas

Topic URL
Check Azure Private Link service availability by resource https://learn.microsoft.com/en-us/azure/private-link/availability
Increase Azure Private Endpoint per‑VNet limits with High Scale https://learn.microsoft.com/en-us/azure/private-link/increase-private-endpoint-vnet-limits
Azure Private Link limits, behaviors, and FAQs https://learn.microsoft.com/en-us/azure/private-link/private-link-faq

Security

Topic URL
Configure RBAC permissions for Azure Network Security Perimeter operations https://learn.microsoft.com/en-us/azure/private-link/network-security-perimeter-role-based-access-control-requirements
Assign Azure RBAC roles for Private Endpoint and Private Link deployment https://learn.microsoft.com/en-us/azure/private-link/rbac-permissions
Apply security best practices to Azure Private Link https://learn.microsoft.com/en-us/azure/private-link/secure-private-link
Inspect and control Private Endpoint traffic using Azure Firewall https://learn.microsoft.com/en-us/azure/private-link/tutorial-inspect-traffic-azure-firewall

Configuration

Topic URL
Configure Private Link service Direct Connect routing https://learn.microsoft.com/en-us/azure/private-link/configure-private-link-service-direct-connect
Create and manage network security perimeters with Azure CLI https://learn.microsoft.com/en-us/azure/private-link/create-network-security-perimeter-cli
Configure subnet network policies for private endpoints https://learn.microsoft.com/en-us/azure/private-link/disable-private-endpoint-network-policy
Configure privateLinkServiceNetworkPolicies for Private Link https://learn.microsoft.com/en-us/azure/private-link/disable-private-link-service-network-policy
Configure and manage Azure Private Endpoint properties https://learn.microsoft.com/en-us/azure/private-link/manage-private-endpoint
Reference for Azure Private Link monitoring data https://learn.microsoft.com/en-us/azure/private-link/monitor-private-link-reference
Enable and store Network Security Perimeter diagnostic logs https://learn.microsoft.com/en-us/azure/private-link/network-security-perimeter-diagnostic-logs
Configure private DNS zone records for Azure Private Endpoints https://learn.microsoft.com/en-us/azure/private-link/private-endpoint-dns
Configure SNAT bypass tags for Private Endpoint traffic via NVA https://learn.microsoft.com/en-us/azure/private-link/private-link-disable-snat
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

82/100

Grade

B

Good

Safety

85

Quality

82

Clarity

85

Completeness

76

Summary

This is a reference skill for Azure Private Link development that provides expert guidance on best practices, decision-making, architecture patterns, limits, security, and configuration. It functions as a documentation navigator and knowledge aggregator, using network-based tools (mcp_microsoftdocs or fetch_webpage) to retrieve Microsoft Learn documentation on-demand without making any modifications to user systems.

Detected Capabilities

read documentation from remote sources (mcp_microsoftdocs, fetch_webpage)network access for fetching Microsoft Learn articlesread local skill content using read_file

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

azure private linkprivate endpoint dnsconfigure private endpointazure network security perimeterprivate resolver setupazure firewall traffic inspection

Risk Signals

INFO

Network access to learn.microsoft.com for documentation retrieval

Skill description, How to Use section
INFO

Metadata staleness check suggests pulling updates from GitHub

Line: 'If metadata.generated_at is more than 3 months old'

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Design private endpoint DNS architectures with Azure Private Resolver
  • Choose between Azure network security perimeter access modes based on security and cost tradeoffs
  • Configure RBAC permissions for Private Link and NSP operations
  • Debug and inspect Private Endpoint traffic using Azure Firewall
  • Optimize Private Link deployments for cost and security
  • Understand Azure Private Link limits, quotas, and high-scale configurations

Quality Notes

  • Skill is well-structured with clear category index mapping sections to content ranges, enabling efficient agent navigation
  • Includes explicit fallback mechanism (mcp_microsoftdocs preferred, fetch_webpage fallback) with query parameters for tracking agent usage
  • Provides actionable guidance on tool availability and installation (MCP installation link)
  • References are curated to specific Microsoft Learn articles with clear URLs, reducing discovery friction
  • Scope is well-bounded: clearly states what it covers (Private Link, Endpoints, Private Resolver, NSP) and explicitly excludes related but separate services (VNet, VPN, ExpressRoute, VWAN)
  • Metadata-based versioning check helps keep guidance current (suggests refresh if >3 months old)
  • Category descriptions are concise and explain the practical value of each section
  • Skill provides no direct hands-on configuration examples, which is appropriate for a guidance/reference skill
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use MicrosoftDocs/azure-private-link in your dev environment

Command Palette

Search for a command to run...