---
id: azure-mgmt-relay
version: "2.0.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# azure-mgmt-relay — Microsoft Azure Relay Management Client Library for Python

License: permissive · Maintenance: active · Downloads: 1.7M/mo

## What it is and what it does

azure-mgmt-relay is the Microsoft Azure SDK client library for managing Azure Relay resources. It provides programmatic access to create, update, and delete relay namespaces, hybrid connections, and WCF relays, as well as configure network rules and private endpoint connections through the Azure Resource Manager API.

The package is designed for developers building infrastructure-as-code or automation workflows that need to manage relay services in Azure. It authenticates via Microsoft Entra using credentials and exposes operation groups for namespaces, hybrid connections, WCF relays, private endpoints, and network rule sets. Version 2.0.0 introduces hybrid models with dual dictionary/object behavior and adds support for private link resources and network rule management.

Use it for:

- Automate provisioning and configuration of Azure Relay namespaces and hybrid connections in infrastructure-as-code pipelines.
- Manage authorization rules and network access policies for relay resources programmatically.
- Create or update private endpoint connections and network rule sets for relay namespaces.
- Query relay resource properties and operational status as part of monitoring or auditing workflows.
- Integrate relay management into multi-tenant or multi-subscription Azure automation frameworks.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Manages Azure Relay namespaces, hybrid connections, and WCF relays through the Azure Resource Manager API, providing programmatic control over relay infrastructure and network rules.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and is the official Microsoft SDK for Azure Relay management. Install it if you need to manage relay infrastructure programmatically in Python. Be aware that version 2.0.0 introduces breaking changes (hybrid models, client rename); review migration guidance if upgrading from earlier versions.

## Install

pip install azure-mgmt-relay
uv add azure-mgmt-relay
poetry add azure-mgmt-relay

## Installing azure-mgmt-relay

Before you install: Low install friction with a pure-Python wheel. Actively maintained with a recent release (16 days old) and no known vulnerabilities. Requires Python 3.10 or later and depends on three lightweight runtime packages (isodate, azure-mgmt-core, typing-extensions).

License in practice: MIT license permits commercial use, modification, and distribution with minimal restrictions—suitable for most projects.

Quickstart:

pip install azure-mgmt-relay

from azure.mgmt.relay import RelayAPIMgmtClient
from azure.identity import DefaultAzureCredential
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = RelayAPIMgmtClient(credential=DefaultAzureCredential(), subscription_id=sub_id)

Requires Python 3.10+. Authentication depends on environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET, and AZURE_SUBSCRIPTION_ID.

Verify before relying:

- Whether version 2.0.0's breaking changes (hybrid model migration, client rename to RelayAPIMgmtClient) affect existing codebases using earlier versions.
- Scope and maturity of the new private endpoint and network rule features added in 2.0.0.
- Whether azure-identity is required as a runtime dependency or only as an optional authentication helper.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.7M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

azure relay management, azure hybrid connections, wcf relay client, azure namespace management, relay network rules, azure relay sdk, relay private endpoints, azure-sdk, infrastructure-as-code, cloud-management

[View on SkillFed](https://skillfed.io/packages/azure-mgmt-relay) · [View on PyPI](https://pypi.org/project/azure-mgmt-relay/)