Żądanie kontenera z puli rezerwowej dla usługi Azure Container Instances (wersja zapoznawcza)

Ważne

Pule rezerwowe dla usługi Azure Container Instances są obecnie dostępne w wersji zapoznawczej. Wersje zapoznawcze są udostępniane pod warunkiem udzielenia zgody na dodatkowe warunki użytkowania. Niektóre cechy funkcji mogą ulec zmianie, zanim stanie się ona ogólnie dostępna.

W tym artykule opisano procedurę żądania grupy kontenerów z puli rezerwowej dla usługi Azure Container Instances.

Wymagania wstępne

Przed użyciem pul rezerwowych ukończ rejestrację funkcji i skonfiguruj mechanizmy kontroli dostępu opartej na rolach wymienione na stronie Przegląd pul rezerwowych dla usługi Azure Container Instances .

Żądanie kontenera z puli rezerwowej

Interfejs wiersza polecenia

Zażądaj grupy kontenerów z puli rezerwowej przy użyciu polecenia az container create i określenia profilu puli rezerwowej i grupy kontenerów. Aby uzyskać więcej informacji na temat używania map konfiguracji podczas żądań kontenera, zobacz używanie map konfiguracji.

az container create \
    --resource-group myResourceGroup \
    --name mycontainer \ 
    --location WestCentralUS \
    --config-map key1=value1 key2=value2 \
    --container-group-profile-id "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile" \
    --container-group-profile-revision 1 \
    --standby-pool-profile-id "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.StandbyPool/standbyContainerGroupPools/myStandbyPool" 

Program PowerShell

Zażądaj grupy kontenerów z puli rezerwowej przy użyciu polecenia New-AzContainerGroup i określ profil puli rezerwowej i grupy kontenerów. Aby uzyskać więcej informacji na temat używania map konfiguracji podczas żądań kontenera, zobacz używanie map konfiguracji.

$container = New-AzContainerInstancenoDefaultObject -Name mycontainer -ConfigMapKeyValuePair @{"key1"="value1"}

New-AzContainerGroup `
    -ResourceGroupName myResourceGroup `
    -Name mycontainergroup`
    -Container $container `
    -Location "WestCentralUS" `
    -ContainerGroupProfileId "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile" `
    -ContainerGroupProfileRevision 1 `
    -StandbyPoolProfileId "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.StandbyPool/standbyContainerGroupPools/myStandbyPool" 

Szablon usługi ARM

Zażądaj grupy kontenerów z puli rezerwowej przy użyciu polecenia az deployment group create lub New-AzResourceGroupDeployment i określenia profilu puli rezerwowej i grupy kontenerów. Aby uzyskać więcej informacji na temat używania map konfiguracji podczas żądań kontenera, zobacz używanie map konfiguracji.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "subscriptionId": {
      "type": "string",
      "metadata": {
        "description": "The subscription ID."
      }
    },
    "resourceGroup": {
      "type": "string",
      "metadata": {
        "description": "The name of the resource group."
      }
    },
    "location": {
      "type": "string",
      "metadata": {
        "description": "Location for the resource."
      },
      "defaultValue": "West Central US"
    },
    "containerGroupName": {
      "type": "string",
      "metadata": {
        "description": "The name of the container group."
      }
    },
    "standbyPoolName": {
      "type": "string",
      "metadata": {
        "description": "The name of the standby pool."
      }
    },
    "containerGroupProfileName": {
      "type": "string",
      "metadata": {
        "description": "The name of the container group profile."
      }
    },
    "myContainerProfile": {
      "type": "string",
      "metadata": {
        "description": "The name of the container profile."
      }
    },
    "newKey": {
      "type": "string",
      "metadata": {
        "description": "The new key for the config map."
      }
    },
    "newValue": {
      "type": "string",
      "metadata": {
        "description": "The new value for the config map."
      }
    },
    "revisionNumber": {
      "type": "int",
      "metadata": {
        "description": "The revision number for the container group profile."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.ContainerInstance/containerGroups",
      "apiVersion": "2024-05-01-preview",
      "name": "[parameters('containerGroupName')]",
      "location": "[parameters('location')]",
      "properties": {
        "standByPoolProfile": {
          "id": "[concat('/subscriptions/', parameters('subscriptionId'), '/resourceGroups/', parameters('resourceGroup'), '/providers/Microsoft.StandbyPool/standbyContainerGroupPools/', parameters('standbyPoolName'))]"
        },
        "containerGroupProfile": {
          "id": "[concat('/subscriptions/', parameters('subscriptionId'), '/resourceGroups/', parameters('resourceGroup'), '/providers/Microsoft.ContainerInstance/mycontainergroupprofile/', parameters('containerGroupProfileName'))]",
          "revision": "[parameters('revisionNumber')]"
        },
        "containers": [
          {
            "name": "[parameters('mycontainergroupprofile')]",
            "properties": {
              "configMap": {
                "keyValuePairs": {
                  "[parameters('newKey')]": "[parameters('newValue')]"
                }
              }
            }
          }
        ]
      }
    }
  ],
  "outputs": {
    "containerGroupId": {
      "type": "string",
      "value": "[resourceId('Microsoft.ContainerInstance/containerGroups', parameters('containerGroupName'))]"
    }
  }
}

REST

Zażądaj grupy kontenerów z puli rezerwowej przy użyciu polecenia Utwórz lub Zaktualizuj i określ profil puli rezerwowej i grupy kontenerów. Aby uzyskać więcej informacji na temat używania map konfiguracji podczas żądań kontenera, zobacz używanie map konfiguracji.

PUT
https://management.azure.com/subscriptions/{SubscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroups/myContainerGroup?api-version=2024-05-01-preview 

Request Body
{
   "location": "{location}",
   "properties": {
       "standByPoolProfile":{
               "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.StandbyPool/standbyContainerGroupPools/myStandbyPool"
           },
           "containerGroupProfile": {
               "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.ContainerInstance/containerGroupProfiles/mycontainergroupprofile",
               "revision": {revisionNumber}
           },
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": {
              "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity}": {}
            },
           "containers": [
               {
                   "name": "{mycontainergroupprofile}",
                   "properties": {
                       "configMap": {
                           "keyValuePairs": {
                               "{newKey}": "{newValue}"
                           }
                       }
                   }
               }
           ]
       }
    }    
}

Następne kroki

• Pobierz szczegóły puli rezerwowej i kontenera przy użyciu interfejsów API widoku środowiska uruchomieniowego puli rezerwowej.
• Aktualizowanie lub usuwanie puli rezerwowej dla usługi Azure Container Instances.