az group deployment

Gérer les déploiements azure Resource Manager.

Commandes

az group deployment cancel

Annule un déploiement de modèle en cours d’exécution.

az group deployment create

Démarre un déploiement.

az group deployment delete

Supprime un déploiement de l’historique de déploiement.

az group deployment export

Exporte le modèle utilisé pour un déploiement.

az group deployment list

Répertorie tous les déploiements d’un groupe de ressources.

az group deployment operation

Gérer les opérations de déploiement.

az group deployment operation list

Obtient toutes les opérations de déploiement pour un déploiement.

az group deployment operation show

Obtenez l’opération d’un déploiement.

az group deployment show

Obtient un déploiement.

az group deployment validate

Vérifiez si un modèle est syntactiquement correct.

az group deployment wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de déploiement soit remplie.

az group deployment cancel

Annule un déploiement de modèle en cours d’exécution.

Vous pouvez annuler un déploiement uniquement si l’approvisionnementState est accepté ou en cours d’exécution. Une fois le déploiement annulé, l’approvisionnementState est défini sur Canceled. L'annulation d'un déploiement de modèle arrête le déploiement du modèle en cours d'exécution, et laisse le groupe de ressources partiellement déployé.

az group deployment cancel --name
                           --resource-group

Paramètres obligatoires

--name -n

Le nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

az group deployment create

Démarre un déploiement.

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-uri]

Exemples

Créez un déploiement à partir d’un fichier de modèle distant à l’aide de paramètres à partir d’un fichier JSON local.

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

Créez un déploiement à partir d’un fichier de modèle local à l’aide de paramètres à partir d’une chaîne JSON.

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

Créez un déploiement à partir d’un modèle local, à l’aide d’un fichier de paramètres local, d’un fichier de paramètres distant et de substitution sélective de paires clé/valeur.

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--aux-subs

Abonnements auxiliaires qui seront utilisés pendant le déploiement entre les locataires.

--aux-tenants

Locataires auxiliaires qui seront utilisés pendant le déploiement entre les locataires.

--handle-extended-json-format -j

Prise en charge de la gestion du contenu de modèle étendu, y compris les commentaires et les multilignes dans le déploiement.

--mode

Incrémentiel (ajouter uniquement des ressources au groupe de ressources) ou Terminer (supprimer des ressources supplémentaires du groupe de ressources).

valeurs acceptées: Complete, Incremental
valeur par défaut: Incremental
--name -n

Le nom du déploiement. Nom de base du fichier de modèle par défaut.

--no-prompt

Option permettant de désactiver l’invite de paramètres manquants pour le modèle ARM. Lorsque la valeur est true, l’invite demandant aux utilisateurs de fournir un paramètre manquant est ignorée. La valeur par défaut est false.

valeurs acceptées: false, true
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

--parameters -p

Fournissez des valeurs de paramètre de déploiement.

--rollback-on-error

Nom d’un déploiement à restaurer sur l’erreur ou utiliser comme indicateur pour restaurer le dernier déploiement réussi.

--template-file -f

Chemin d’accès à un fichier de modèle ou à un fichier Bicep dans le système de fichiers.

--template-uri -u

Uri d’un fichier de modèle distant.

az group deployment delete

Supprime un déploiement de l’historique de déploiement.

Il n'est pas possible de supprimer un déploiement du modèle en cours d'exécution. La suppression d'un déploiement de modèle a pour effet de supprimer les opérations de déploiement associées. La suppression d'un déploiement de modèle n'affecte pas l'état du groupe de ressources. Il s’agit d’une opération asynchrone qui retourne un état de 202 jusqu’à ce que le déploiement du modèle soit supprimé avec succès. L’en-tête de réponse Location contient l’URI utilisé pour obtenir l’état du processus. Pendant l’exécution du processus, un appel à l’URI dans l’en-tête Location retourne un état de 202. Une fois le processus terminé, l’URI dans l’en-tête Location retourne un état de 204 sur la réussite. Si la requête asynchrone a échoué, l’URI dans l’en-tête Location retourne un code d’état au niveau de l’erreur.

az group deployment delete --name
                           --resource-group
                           [--no-wait]

Paramètres obligatoires

--name -n

Le nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

az group deployment export

Exporte le modèle utilisé pour un déploiement.

az group deployment export --name
                           --resource-group

Exemples

Exporte le modèle utilisé pour un déploiement. (généré automatiquement)

az group deployment export --name MyDeployment --resource-group MyResourceGroup

Paramètres obligatoires

--name -n

Le nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

az group deployment list

Répertorie tous les déploiements d’un groupe de ressources.

az group deployment list --resource-group
                         [--filter]
                         [--top]

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--filter

Filtre à appliquer sur l’opération. Par exemple, vous pouvez utiliser $filter=provisioningState eq '{state}'. La valeur par défaut est Aucun.

--top

Nombre de résultats à obtenir. Si la valeur null est passée, retourne tous les déploiements. La valeur par défaut est Aucun.

az group deployment show

Obtient un déploiement.

az group deployment show --name
                         --resource-group

Paramètres obligatoires

--name -n

Le nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

az group deployment validate

Vérifiez si un modèle est syntaxiquement correct.

az group deployment validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-uri]

Exemples

Vérifiez si un modèle est syntaxiquement correct. (généré automatiquement)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

Paramètres obligatoires

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--handle-extended-json-format -j

Prise en charge de la gestion du contenu de modèle étendu, y compris le multiligne et les commentaires dans le déploiement.

--mode

Incrémentiel (ajoutez uniquement des ressources au groupe de ressources) ou Terminé (supprimez les ressources supplémentaires du groupe de ressources).

valeurs acceptées: Complete, Incremental
valeur par défaut: Incremental
--no-prompt

Option permettant de désactiver l’invite de paramètres manquants pour le modèle ARM. Lorsque la valeur est true, l’invite demandant aux utilisateurs de fournir un paramètre manquant est ignorée. La valeur par défaut est false.

valeurs acceptées: false, true
--parameters -p

Fournissez les valeurs des paramètres de déploiement.

--rollback-on-error

Nom d’un déploiement à restaurer en cas d’erreur ou utiliser comme indicateur pour restaurer le dernier déploiement réussi.

--template-file -f

Chemin d’accès à un fichier de modèle ou à un fichier Bicep dans le système de fichiers.

--template-uri -u

URI vers un fichier de modèle distant.

az group deployment wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de déploiement soit remplie.

az group deployment wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--timeout]
                         [--updated]

Exemples

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de déploiement soit remplie. (généré automatiquement)

az group deployment wait --name MyDeployment --resource-group MyResourceGroup --updated

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition de déploiement soit remplie. (généré automatiquement)

az group deployment wait --created --name MyDeployment --resource-group MyResourceGroup

Paramètres obligatoires

--name -n

Le nom du déploiement.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendez la suppression.

--exists

Attendez que la ressource existe.

--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--timeout

Attente maximale en secondes.

valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Succeeded ».