azure-service-bus

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Azure Service Bus Skill

Azure Service Bus 技能

This skill provides expert guidance for Azure Service Bus. 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.
本技能为Azure Service Bus提供专业指导,涵盖故障排查、最佳实践、决策制定、架构与设计模式、限制与配额、安全、配置、集成与编码模式以及部署。它结合了本地快速参考内容与远程文档获取能力。

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.
Agent 重要提示:使用下方的分类索引定位相关章节。对于带有行范围的分类(如
L35-L120
),使用
read_file
读取指定行;对于带有文件链接的分类(如
[security.md](security.md)
),使用
read_file
读取链接的参考文件
Agent 重要提示:如果
metadata.generated_at
已超过3个月,建议用户从仓库拉取最新版本。如果
mcp_microsoftdocs
工具不可用,建议用户安装该工具:安装指南
本技能需要网络访问权限来获取文档内容:
  • 首选方式:使用
    mcp_microsoftdocs:microsoft_docs_fetch
    ,查询字符串为
    from=learn-agent-skill
    ,返回Markdown格式内容。
  • 备用方式:使用
    fetch_webpage
    ,查询字符串为
    from=learn-agent-skill&accept=text/markdown
    ,返回Markdown格式内容。

Category Index

分类索引

CategoryLinesDescription
TroubleshootingL37-L46Diagnosing and fixing Service Bus issues: AMQP errors, tracing requests end-to-end, handling deprecated/current SDK exceptions, ARM/Resource Manager errors, and common runtime problems.
Best PracticesL47-L61Guidance on reliable Service Bus messaging: ordering, sessions, TTL/expiration, duplicate detection, dead-lettering, locks/settlement, serialization, and performance tuning (prefetch, throughput).
Decision MakingL62-L72Guidance on choosing Service Bus vs other messaging services/tiers, configuring autoforwarding, geo-disaster recovery/replication, and migrating from Standard to Premium.
Architecture & Design PatternsL73-L81Patterns for designing resilient, federated, multi-namespace Service Bus systems, including partitioning, replication, and using NServiceBus for message-driven architectures.
Limits & QuotasL82-L87Service Bus message, entity, and namespace quotas (size, connections, throughput) and how throttling works, including limits, behaviors under load, and mitigation strategies.
SecurityL88-L110Securing Service Bus: identity-based auth, SAS, keys and encryption, TLS, network isolation (VNet, Private Link, firewalls), policies, compliance, and passwordless/managed identities.
ConfigurationL111-L134Configuring Service Bus entities, filters, sessions, partitioning, monitoring, and management via portal, PowerShell, ARM, and local emulator, plus message browsing, counts, and replication.
Integrations & Coding PatternsL135-L151Patterns and code for integrating Service Bus with JMS, AMQP, RabbitMQ, Event Grid/Logic Apps/Functions, subscription filters, and batch message operations/migration scenarios
DeploymentL152-L162Deploying and scaling Service Bus: autoscaling Premium messaging units and creating/moving namespaces, queues, topics, subscriptions, and rules using ARM templates or Bicep.
分类行范围描述
故障排查L37-L46诊断并修复Service Bus问题:AMQP错误、端到端请求追踪、处理已弃用/当前SDK异常、ARM/资源管理器错误以及常见运行时问题。
最佳实践L47-L61可靠Service Bus消息传递指南:排序、会话、TTL/过期、重复检测、死信队列、锁/结算、序列化以及性能调优(预取、吞吐量)。
决策制定L62-L72关于选择Service Bus与其他消息服务/层级、配置自动转发、异地灾难恢复/复制以及从标准层迁移到高级层的指导。
架构与设计模式L73-L81设计弹性、联邦、多命名空间Service Bus系统的模式,包括分区、复制以及使用NServiceBus构建消息驱动架构。
限制与配额L82-L87Service Bus消息、实体和命名空间的配额(大小、连接数、吞吐量)以及限流机制的工作原理,包括限制、负载下的行为以及缓解策略。
安全L88-L110保护Service Bus:基于身份的认证、SAS、密钥与加密、TLS、网络隔离(VNet、Private Link、防火墙)、策略、合规以及无密码/托管身份。
配置L111-L134配置Service Bus实体、筛选器、会话、分区、监控,以及通过门户、PowerShell、ARM和本地模拟器进行管理,还包括消息浏览、计数和复制。
集成与编码模式L135-L151Service Bus与JMS、AMQP、RabbitMQ、Event Grid/Logic Apps/Functions集成的模式与代码,订阅筛选器以及批量消息操作/迁移场景。
部署L152-L162部署与缩放Service Bus:自动缩放高级层消息单元,使用ARM模板或Bicep创建/移动命名空间、队列、主题、订阅和规则。

Troubleshooting

故障排查

Best Practices

最佳实践

TopicURL
Configure and use Azure Service Bus duplicate detectionhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/duplicate-detection
Defer and later retrieve Azure Service Bus messageshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-deferral
Configure message expiration and TTL in Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-expiration
Use sequencing and timestamps in Service Bus messageshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-sequencing
Implement FIFO and request-response with Service Bus sessionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-sessions
Handle Service Bus message transfers, locks, and settlement correctlyhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-transfers-locks-settlement
Prepare Service Bus namespaces for planned maintenancehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/prepare-for-planned-maintenance
Use Azure Service Bus dead-letter queues for message handlinghttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-dead-letter-queues
Handle messages and serialization in Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messages-payloads
Optimize Azure Service Bus messaging performancehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-performance-improvements
Tune Azure Service Bus prefetch for performancehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-prefetch

Decision Making

决策制定

Architecture & Design Patterns

架构与设计模式

Limits & Quotas

限制与配额

Security

安全

TopicURL
Authenticate applications to Azure Service Bus with Entra IDhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/authenticate-application
Enable confidential computing for Service Bus Premiumhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/confidential-computing
Configure customer-managed keys for Service Bus encryptionhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/configure-customer-managed-key
Disable SAS local authentication for Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/disable-local-authentication
Configure network security for Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security
Associate Service Bus with a network security perimeterhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security-perimeter
Apply Azure Policy definitions to Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/policy-reference
Integrate Service Bus with Azure Private Linkhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/private-link-service
Apply regulatory compliance policies to Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/security-controls-policy
Configure authentication and authorization for Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-authentication-and-authorization
Configure IP firewall rules for Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-ip-filtering
Authenticate to Azure Service Bus with managed identitieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-managed-service-identity
Migrate Service Bus apps to passwordless Entra ID authhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-migrate-azure-credentials
Create Service Bus authorization rules with ARM templateshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-auth-rule
Secure Service Bus with Shared Access Signatureshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-sas
Configure Service Bus virtual network service endpointshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-service-endpoints
Audit Service Bus TLS minimum version compliance with Azure Policyhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-audit-minimum-version
Configure minimum TLS version for a Service Bus namespacehttps://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-configure-minimum-version
Enforce minimum TLS version for Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-enforce-minimum-version
主题URL
使用Entra ID认证应用到Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/authenticate-application
为Service Bus高级层启用机密计算https://learn.microsoft.com/en-us/azure/service-bus-messaging/confidential-computing
为Service Bus加密配置客户管理密钥https://learn.microsoft.com/en-us/azure/service-bus-messaging/configure-customer-managed-key
禁用Azure Service Bus的SAS本地认证https://learn.microsoft.com/en-us/azure/service-bus-messaging/disable-local-authentication
为Azure Service Bus配置网络安全https://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security
将Service Bus与网络安全边界关联https://learn.microsoft.com/en-us/azure/service-bus-messaging/network-security-perimeter
为Service Bus应用Azure Policy定义https://learn.microsoft.com/en-us/azure/service-bus-messaging/policy-reference
将Service Bus与Azure Private Link集成https://learn.microsoft.com/en-us/azure/service-bus-messaging/private-link-service
为Service Bus应用监管合规策略https://learn.microsoft.com/en-us/azure/service-bus-messaging/security-controls-policy
为Service Bus配置认证与授权https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-authentication-and-authorization
为Azure Service Bus配置IP防火墙规则https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-ip-filtering
使用托管身份认证到Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-managed-service-identity
将Service Bus应用迁移到无密码Entra ID认证https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-migrate-azure-credentials
使用ARM模板创建Service Bus授权规则https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-resource-manager-namespace-auth-rule
使用共享访问签名(SAS)保护Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-sas
为Service Bus配置虚拟网络服务端点https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-service-endpoints
使用Azure Policy审计Service Bus TLS最低版本合规性https://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-audit-minimum-version
为Service Bus命名空间配置最低TLS版本https://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-configure-minimum-version
为Service Bus强制实施最低TLS版本https://learn.microsoft.com/en-us/azure/service-bus-messaging/transport-layer-security-enforce-minimum-version

Configuration

配置

TopicURL
Map classic Service Bus management APIs to ARMhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/deprecate-service-bus-management
Configure auto-forwarding for Service Bus queues and subscriptionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-auto-forward
Enable dead-lettering for Service Bus queues and subscriptionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-dead-letter
Configure duplicate detection for Service Bus entitieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-duplicate-detection
Enable and configure Service Bus message sessionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-message-sessions
Enable partitioning in Basic and Standard Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-partitions-basic-standard
Suspend and reactivate Azure Service Bus entitieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/entity-suspend
Use Service Bus Explorer in Azure portal for data operationshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/explorer
Use Azure Service Bus message browsing and peek operationshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-browsing
Retrieve Service Bus queue and subscription message countshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/message-counters
Configure monitoring for Azure Service Bus with Azure Monitorhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus
Reference for Azure Service Bus monitoring metrics and logshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus-reference
Use AMQP request/response operations in Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-request-response
Configure Azure Functions-based Service Bus replication taskshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-configuration
Use Azure Monitor insights for Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-insights
Manage Service Bus resources with Azure PowerShellhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-manage-with-ps
Programmatically manage Service Bus namespaces and entitieshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-management-libraries
Use SQL filter syntax for Service Bus subscription ruleshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-sql-filter
Use SQL action syntax for Service Bus subscription ruleshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-sql-rule-action
Configure and use the Azure Service Bus emulator locallyhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/test-locally-with-service-bus-emulator
主题URL
将经典Service Bus管理API映射到ARMhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/deprecate-service-bus-management
为Service Bus队列与订阅配置自动转发https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-auto-forward
为Service Bus队列与订阅启用死信队列https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-dead-letter
为Service Bus实体配置重复检测https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-duplicate-detection
启用并配置Service Bus消息会话https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-message-sessions
在基础层与标准层Service Bus中启用分区https://learn.microsoft.com/en-us/azure/service-bus-messaging/enable-partitions-basic-standard
暂停并重新激活Azure Service Bus实体https://learn.microsoft.com/en-us/azure/service-bus-messaging/entity-suspend
在Azure门户中使用Service Bus Explorer进行数据操作https://learn.microsoft.com/en-us/azure/service-bus-messaging/explorer
使用Azure Service Bus消息浏览与查看操作https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-browsing
获取Service Bus队列与订阅的消息计数https://learn.microsoft.com/en-us/azure/service-bus-messaging/message-counters
使用Azure Monitor为Azure Service Bus配置监控https://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus
Azure Service Bus监控指标与日志参考https://learn.microsoft.com/en-us/azure/service-bus-messaging/monitor-service-bus-reference
在Service Bus中使用AMQP请求/响应操作https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-request-response
配置基于Azure Functions的Service Bus复制任务https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-configuration
使用Azure Monitor Insights监控Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-insights
使用Azure PowerShell管理Service Bus资源https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-manage-with-ps
以编程方式管理Service Bus命名空间与实体https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-management-libraries
为Service Bus订阅规则使用SQL筛选器语法https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-sql-filter
为Service Bus订阅规则使用SQL操作语法https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-messaging-sql-rule-action
在本地配置并使用Azure Service Bus模拟器https://learn.microsoft.com/en-us/azure/service-bus-messaging/test-locally-with-service-bus-emulator

Integrations & Coding Patterns

集成与编码模式

TopicURL
Programmatically delete Service Bus messages in batcheshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/batch-delete
Use JMS 2.0 API with Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/how-to-use-java-message-service-20
Develop with Azure Service Bus using JMS 2.0https://learn.microsoft.com/en-us/azure/service-bus-messaging/jms-developer-guide
Migrate JMS apps from ActiveMQ to Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/migrate-jms-activemq-to-servicebus
Use legacy .NET Service Bus library with AMQPhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-dotnet
AMQP 1.0 protocol details for Service Bus and Event Hubshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-protocol-guide
Build Service Bus replication tasks with Azure Functionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-replicator-functions
Define Azure Service Bus subscription filters and actionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-filter-examples
Integrate RabbitMQ with Azure Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-integrate-with-rabbitmq
Use JMS 1.1 with AMQP on Service Bus Standardhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-java-how-to-use-jms-api-amqp
Integrate Azure Service Bus with Event Gridhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-concept
Integrate Service Bus events with Event Grid and Logic Appshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-example
Handle Service Bus events via Event Grid and Azure Functionshttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-function
主题URL
以编程方式批量删除Service Bus消息https://learn.microsoft.com/en-us/azure/service-bus-messaging/batch-delete
将JMS 2.0 API与Azure Service Bus结合使用https://learn.microsoft.com/en-us/azure/service-bus-messaging/how-to-use-java-message-service-20
使用JMS 2.0开发Azure Service Bus应用https://learn.microsoft.com/en-us/azure/service-bus-messaging/jms-developer-guide
将JMS应用从ActiveMQ迁移到Service Bushttps://learn.microsoft.com/en-us/azure/service-bus-messaging/migrate-jms-activemq-to-servicebus
将传统.NET Service Bus库与AMQP结合使用https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-dotnet
Service Bus与Event Hubs的AMQP 1.0协议细节https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-amqp-protocol-guide
使用Azure Functions构建Service Bus复制任务https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-federation-replicator-functions
定义Azure Service Bus订阅筛选器与操作https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-filter-examples
将RabbitMQ与Azure Service Bus集成https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-integrate-with-rabbitmq
在Service Bus标准层中使用JMS 1.1与AMQPhttps://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-java-how-to-use-jms-api-amqp
将Azure Service Bus与Event Grid集成https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-concept
将Service Bus事件与Event Grid和Logic Apps集成https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-example
通过Event Grid和Azure Functions处理Service Bus事件https://learn.microsoft.com/en-us/azure/service-bus-messaging/service-bus-to-event-grid-integration-function

Deployment

部署