在這個快速入門中，你會使用 Python SDK 來配置沙盒群組、啟動沙盒、執行指令，並清理所有建立的資源。
先決條件
- 具有建立資源群組權限的 Azure 訂閱。
- Azure CLI （
az） 安裝並登入。 - uv 搭配 Python 3.13+。
設定您的環境
安裝 SDK，登入 Azure，並為這個快速入門中的腳本撰寫.env檔案。
uv venv
uv pip install azure-containerapps-sandbox azure-mgmt-resource azure-mgmt-authorization
# Sign in so DefaultAzureCredential picks up your identity
az login
cat > .env <<EOF
AZURE_SUBSCRIPTION_ID=$(az account show --query id -o tsv)
AZURE_RESOURCE_GROUP=my-rg
AZURE_SANDBOX_GROUP=my-sandbox-group
AZURE_REGION=eastus2
AZURE_PRINCIPAL_ID=$(az ad signed-in-user show --query id -o tsv)
EOF
建立資源群組和沙箱群組，並授與自己資料平面的存取權。 另存為 setup.py：
import os, uuid
from azure.identity import DefaultAzureCredential
from azure.mgmt.resource import ResourceManagementClient
from azure.mgmt.authorization import AuthorizationManagementClient
from azure.containerapps.sandbox import SandboxGroupManagementClient
credential = DefaultAzureCredential()
sub = os.environ["AZURE_SUBSCRIPTION_ID"]
rg = os.environ["AZURE_RESOURCE_GROUP"]
group = os.environ["AZURE_SANDBOX_GROUP"]
region = os.environ["AZURE_REGION"]
ResourceManagementClient(credential, sub).resource_groups.create_or_update(
rg, {"location": region},
)
SandboxGroupManagementClient(
credential, subscription_id=sub, resource_group=rg,
).begin_create_group(group, location=region).result()
# Container Apps SandboxGroup Data Owner (built-in role)
ROLE_DEF_ID = "c24cf47c-5077-412d-a19c-45202126392c"
scope = f"/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.App/sandboxGroups/{group}"
AuthorizationManagementClient(credential, sub).role_assignments.create(
scope=scope,
role_assignment_name=str(uuid.uuid4()),
parameters={
"properties": {
"roleDefinitionId": f"/subscriptions/{sub}/providers/Microsoft.Authorization/roleDefinitions/{ROLE_DEF_ID}",
"principalId": os.environ["AZURE_PRINCIPAL_ID"],
"principalType": "User",
}
},
)
print(f"Setup complete: rg={rg}, sandbox_group={group}, role granted.")
uv run --env-file .env python setup.py
角色指派需要 30 到 60 秒才會完成傳播。 如果 main.py 回傳 403，請等一分鐘再試一次。
建立並運行沙盒
另存為 main.py：
import os
from azure.identity import DefaultAzureCredential
from azure.containerapps.sandbox import SandboxGroupClient, endpoint_for_region
credential = DefaultAzureCredential()
client = SandboxGroupClient(
endpoint_for_region(os.environ["AZURE_REGION"]), credential,
subscription_id=os.environ["AZURE_SUBSCRIPTION_ID"],
resource_group=os.environ["AZURE_RESOURCE_GROUP"],
sandbox_group=os.environ["AZURE_SANDBOX_GROUP"],
)
# Create a sandbox
sandbox = client.begin_create_sandbox(disk="ubuntu").result()
# Run a command
result = sandbox.exec("echo 'Hello from Azure Container Apps Sandbox.'")
print(result.stdout)
# Clean up
sandbox.delete()
執行腳本：
uv run --env-file .env python main.py
清理資源
若要刪除沙盒群組與資源群組，請將以下程式碼儲存為：teardown.py
import os
from azure.identity import DefaultAzureCredential
from azure.mgmt.resource import ResourceManagementClient
from azure.containerapps.sandbox import SandboxGroupManagementClient
credential = DefaultAzureCredential()
sub = os.environ["AZURE_SUBSCRIPTION_ID"]
rg = os.environ["AZURE_RESOURCE_GROUP"]
SandboxGroupManagementClient(
credential, subscription_id=sub, resource_group=rg,
).begin_delete_group(os.environ["AZURE_SANDBOX_GROUP"]).result()
ResourceManagementClient(credential, sub).resource_groups.begin_delete(rg).result()
print(f"Teardown complete: {rg} deleted.")
執行清理腳本。
uv run --env-file .env python teardown.py