Azure Container Apps Sandbox Python SDK v0.1.0b1 Early Access

Azure Container Apps Sandbox Python SDK v0.1.0b1 Early Access

Beta — This SDK is in beta preview. The API surface may change without notice.

Prerequisites

• Python >= 3.10
• Azure CLI — run az login once for authentication

Install

pip install https://github.com/microsoft/azure-container-apps/releases/download/python-sdk-v0.1.0b1-early-access/azure_containerapps_sandbox-0.1.0b1-py3-none-any.whl

Quick Start

from azure.identity import DefaultAzureCredential
from azure.containerapps.sandbox import (
    SandboxGroupManagementClient,
    SandboxGroupClient,
    endpoint_for_region,
)

credential = DefaultAzureCredential()
subscription_id = "<your-subscription-id>"
resource_group = "my-rg"
sandbox_group = "my-sandbox-group"
region = "eastus2"

# Create sandbox group (one-time setup)
mgmt = SandboxGroupManagementClient(
    credential, subscription_id=subscription_id, resource_group=resource_group,
)
mgmt.create_group(sandbox_group, location=region)

# Connect to data plane
client = SandboxGroupClient(
    endpoint_for_region(region), credential,
    subscription_id=subscription_id,
    resource_group=resource_group,
    sandbox_group=sandbox_group,
)

# Create a sandbox and run a command
sandbox = client.begin_create_sandbox(disk="ubuntu").result()
result = sandbox.exec("echo hello world && uname -a")
print(result.stdout)

# Clean up
sandbox.delete()
client.close()
mgmt.close()

Three Client Classes

Client	Scope	Purpose
SandboxGroupManagementClient	ARM control plane	Create/delete sandbox groups, manage identity
SandboxGroupClient	Data plane (group)	Create sandboxes, disk images, volumes, secrets, snapshots
SandboxClient	Data plane (sandbox)	Exec, files, ports, egress, lifecycle, stop/resume

Documentation

See the Python SDK README for detailed usage including:

• Resource group creation & role assignment (pure Python)
• Sandbox lifecycle, file operations, ports, egress policies
• Snapshots, disk images, volumes, secrets
• Authentication options (managed identity, service principal, TokenCredential)

Dependencies

• httpx >= 0.25 | websocket-client >= 1.6 | azure-core >= 1.30 | azure-identity >= 1.15

ACA CLI v0.1.0 Early Access

ACA CLI v0.1.0 Early Access

Prerequisites

• Azure CLI must be installed
• Run az login at least once before using aca

Installation

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/microsoft/azure-container-apps/main/docs/early/aca-cli/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/microsoft/azure-container-apps/main/docs/early/aca-cli/install.ps1 | iex

Uninstall

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/microsoft/azure-container-apps/main/docs/early/aca-cli/install.sh | sh -s -- --uninstall

Windows (PowerShell):

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/microsoft/azure-container-apps/main/docs/early/aca-cli/install.ps1))) -Uninstall

Platform Archives

Platform	Archive
Linux x64	aca-cli-v0.1.0-early-access-linux-x64.tar.gz
macOS ARM64	aca-cli-v0.1.0-early-access-osx-arm64.tar.gz
Windows x64	aca-cli-v0.1.0-early-access-win-x64.zip