Azure Service Fabric Managed Clusters Management Client Library for Python

Warnings

• breaking The `sku` parameter of the `ManagedCluster` model became required in version 2.0.0. If you are upgrading from a version older than 2.0.0, ensure this parameter is always provided when creating or updating managed clusters.
  Fix: Ensure the `sku` parameter is always provided for `ManagedCluster` operations.
• breaking Operations `ManagedClusterVersionOperations.get_by_environment` and `ManagedClusterVersionOperations.list_by_environment` gained a new required `environment` parameter in version 2.0.0. Calls to these methods without the `environment` parameter will break.
  Fix: Add the `environment` parameter to calls of `get_by_environment` and `list_by_environment`.
• gotcha There is no in-place migration path from existing (traditional) Azure Service Fabric clusters to Service Fabric Managed Clusters. You must create a new managed cluster resource.
  Fix: Plan for creating new managed cluster resources and migrating applications rather than direct upgrades of traditional clusters.
• gotcha Manual changes to the underlying resources of a Service Fabric managed cluster (e.g., Virtual Machine Scale Sets, Load Balancers) are not supported. Managed clusters are fully encapsulated, and Azure manages these resources on your behalf.
  Fix: Interact with Service Fabric Managed Clusters through the managed cluster resource model and API only; avoid direct manipulation of underlying components.
• gotcha This library requires Python 3.9 or newer. Using older Python versions will result in compatibility issues.
  Fix: Upgrade your Python environment to version 3.9 or higher.

Install

• pip install azure-mgmt-servicefabricmanagedclusters azure-identity Install with pip

Imports

• ServiceFabricManagedClustersManagementClient

  from azure.mgmt.servicefabricmanagedclusters import ServiceFabricManagedClustersManagementClient

• DefaultAzureCredential

  from azure.identity import DefaultAzureCredential

  Old credential classes like `azure.common.credentials` or `msrestazure.azure_active_directory` are deprecated; use classes from `azure.identity` instead.

Quickstart

This quickstart demonstrates how to authenticate with Azure using `DefaultAzureCredential` and then list all Service Fabric Managed Clusters within your Azure subscription. Ensure that the required environment variables (`AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`, and `AZURE_SUBSCRIPTION_ID`) are set for authentication.

import os
from azure.identity import DefaultAzureCredential
from azure.mgmt.servicefabricmanagedclusters import ServiceFabricManagedClustersManagementClient

# Set environment variables for authentication:
# AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET
# And AZURE_SUBSCRIPTION_ID

subscription_id = os.environ.get("AZURE_SUBSCRIPTION_ID", "")
if not subscription_id:
    raise ValueError("AZURE_SUBSCRIPTION_ID environment variable not set.")

# Authenticate using DefaultAzureCredential
credential = DefaultAzureCredential()

# Create a Service Fabric Managed Clusters Management Client
client = ServiceFabricManagedClustersManagementClient(credential, subscription_id)

# Example: List all managed clusters in the subscription
print("Listing Service Fabric Managed Clusters...")
for cluster in client.managed_clusters.list_by_subscription():
    print(f"- {cluster.name} (Resource Group: {cluster.resource_group})")