Azure Notification Hubs Management

8.0.0 · active · verified Sat Apr 11

Microsoft Azure Notification Hubs Management Client Library for Python, currently at version 8.0.0. This package provides programmatic access to manage Azure Notification Hubs resources, enabling operations like creating and configuring namespaces and notification hubs. It is part of the Azure SDK for Python, which typically follows a monthly or bi-monthly release cadence for updates and bug fixes, with major versions introducing breaking changes.

Warnings

breaking Major breaking changes occurred in version 8.0.0, primarily affecting client instantiation and authentication. Old credential systems (`azure.common.credentials`, `msrestazure.azure_active_directory`) are no longer supported. The `credentials` parameter was renamed to `credential`, and client configuration is now passed as keyword arguments instead of through a `config` attribute.
Fix: Migrate authentication to `azure-identity` classes (e.g., `DefaultAzureCredential`). Update client instantiation to pass `credential` and other configurations as kwargs.
breaking The return type of `list_keys` in `NamespacesOperations` changed from `SharedAccessAuthorizationRuleListResult` to `ResourceListKeys` in version 8.0.0.
Fix: Update code that processes the return value of `list_keys` to expect `ResourceListKeys` type.
deprecated Support for Python 2.7 for Azure SDK Python packages ended on January 1, 2022.
Fix: Ensure your project uses Python 3.7 or newer.
gotcha All Azure management clients, including `NotificationHubsManagementClient`, require an authenticated credential. The recommended approach is to use `azure-identity` to obtain credentials, such as `DefaultAzureCredential`, which simplifies authentication across various Azure environments.
Fix: Always pass a `TokenCredential` instance from `azure.identity` to the client constructor. Avoid hardcoding credentials; use environment variables or Managed Identities.

Install

pip install azure-mgmt-notificationhubs azure-identity Install with pip

Imports

NotificationHubsManagementClient

from azure.mgmt.notificationhubs import NotificationHubsManagementClient

DefaultAzureCredential
```
from azure.identity import DefaultAzureCredential
```
Old credential classes like `azure.common.credentials` or `msrestazure.azure_active_directory` are deprecated and will not work with recent versions of Azure SDK management clients. Use classes from `azure-identity` instead.

Quickstart

This quickstart demonstrates how to instantiate the `NotificationHubsManagementClient` using `DefaultAzureCredential` and list all Notification Hub namespaces within a subscription. Ensure `AZURE_SUBSCRIPTION_ID` and appropriate Azure AD credentials (e.g., `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`, `AZURE_TENANT_ID` for a service principal) are set as environment variables.

import os
from azure.identity import DefaultAzureCredential
from azure.mgmt.notificationhubs import NotificationHubsManagementClient

# Set environment variables for authentication and subscription ID
# AZURE_SUBSCRIPTION_ID
# AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_TENANT_ID (for Service Principal)

subscription_id = os.environ.get("AZURE_SUBSCRIPTION_ID", "<your-subscription-id>")
credential = DefaultAzureCredential()

client = NotificationHubsManagementClient(credential, subscription_id)

print("Listing Notification Hub namespaces...")
for namespace in client.namespaces.list_all():
    print(f"- Namespace: {namespace.name} (Location: {namespace.location})")

print("Quickstart complete.")

view raw JSON →