更新或移除 Azure 容器執行個體 的待命集區 （預覽）

重要

Azure 容器執行個體 的待命集區目前為預覽狀態。 若您同意補充的使用規定即可取得預覽。 在公開上市 (GA) 之前，此功能的某些領域可能會變更。

本文逐步說明更新或刪除待命集區以進行 Azure 容器執行個體。

必要條件

使用待命集區之前，請先完成功能註冊，並設定待命集區中所列的角色型訪問控制，以取得 Azure 容器執行個體 概觀頁面。

更新待命集區

隨時都可以更新待命集區。 建立之後可調整的設定包括 maxReadyCapacity 和相關聯的 containerGroupProfile。 如果您更新待命集區的容器群組配置檔，新配置檔也必須位於與待命集區相同的訂用帳戶和位置。 更新配置檔之後，集區將會清空所有現有的實例，並以新的實例取代它們。

CLI

使用 az standby-container-group-pool update 更新現有的待命集區。

az standby-container-group-pool update \
   --resource-group myResourceGroup 
   --location WestCentralUS \
   --name myStandbyPool \
   --max-ready-capacity 20 \
   --refill-policy always \
   --container-profile-id "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile"

PowerShell

使用 Update-AzStandbyContainerGroupPool 更新現有的待命集區。

Update-AzStandbyContainerGroupPool `
   -ResourceGroup myResourceGroup `
   -Location WestCentralUS `
   -Name myStandbyPool `
   -MaxReadyCapacity 20 `
   -RefillPolicy always `
   -ContainerProfileId "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile"

ARM 範本

更新現有的待命集區。 使用 az deployment group create 或 New-AzResourceGroupDeployment 更新您的範本並加以部署。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "location": {
           "type": "string",
           "defaultValue": "West Central US"    
        },
        "name": {
           "type": "string",
           "defaultValue": "myStandbyPool"
        },
        "maxReadyCapacity" : {
           "type": "int",
           "defaultValue": 10
        },
        "refillPolicy" : {
           "type": "string",
           "defaultValue": "always"
        },
        "containerGroupProfile" : {
           "type": "string",
           "defaultValue": "/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile"
        }
    },
    "resources": [ 
        {
            "type": "Microsoft.StandbyPool/standbyContainerGroupPools",
            "apiVersion": "2024-03-01",
            "name": "[parameters('name')]",
            "location": "[parameters('location')]",
            "properties": {
               "elasticityProfile": {
                   "maxReadyCapacity": "[parameters('maxReadyCapacity')]",
                   "refillPolicy": "[parameters('refillPolicy')]"
               },
               "containerGroupProfile": "[parameters('containerGroupProfile')]"
            }
        }
    ]
   }

REST

使用 建立或更新來更新現有的待命集區。

PUT https://management.azure.com/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.StandbyPool/standbyContainerGroupPools/myStandbyPool?api-version=2024-03-01 
 
Request Body
{
    "properties": {
        "elasticityProfile": {
            "maxReadyCapacity": 20,
            "refillPolicy": "always"
        },
        "containerGroupProperties": {
            "containerGroupProfile": {
                "id": "/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile",
                "revision": 1
            }
        }
    },
    "location": "West Central US"
}

刪除待命集區

CLI

使用 az standby-container-group-pool delete 刪除現有的待命集區。

az standby-container-group-pool delete \
   --resource-group myResourceGroup \
   --name myStandbyPool 

PowerShell

使用 Update-AzStandbyContainerGroupPool 刪除現有的待命集區。

Remove-AzStandbyContainerGroupPool `
   -ResourceGroup myResourceGroup `
   -Name myStandbyPool 

REST

使用 Delete 刪除現有的待命集區。

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StandbyPool/standbyContainerGroupPools/{standbyContainerGroupPoolName}?api-version=2024-03-01

下一步

使用待命集區運行時間檢視 API 取得待命集區和容器詳細數據。