az resource

  • Référence

Gérer les ressources Azure.

Commandes

Nom Description Type Statut
az resource create

Créer une ressource.

 Core GA
az resource delete

Supprimer une ressource.

 Core GA
az resource invoke-action

Appelez une action sur la ressource.

 Core GA
az resource link

Gérer les liens entre les ressources.

 Core GA
az resource link create

Créez un lien entre les ressources.

 Core GA
az resource link delete

Supprimez un lien entre les ressources.

 Core GA
az resource link list

Répertorier les liens de ressources.

 Core GA
az resource link show

Obtient un lien de ressource avec l’ID spécifié.

 Core GA
az resource link update

Mettre à jour le lien entre les ressources.

 Core GA
az resource list

Répertoriez les ressources.

 Core GA
az resource lock

Gérer les verrous au niveau des ressources Azure.

 Core GA
az resource lock create

Créez un verrou au niveau de la ressource.

 Core GA
az resource lock delete

Supprimez un verrou au niveau de la ressource.

 Core GA
az resource lock list

Répertorier les informations de verrouillage au niveau de la ressource.

 Core GA
az resource lock show

Affichez les détails d’un verrou au niveau de la ressource.

 Core GA
az resource lock update

Mettez à jour un verrou au niveau des ressources.

 Core GA
az resource move

Déplacez des ressources d’un groupe de ressources vers un autre (peut se trouver sous un autre abonnement).

 Core GA
az resource patch

Mettez à jour une ressource par requête PATCH.

 Core GA
az resource show

Obtenez les détails d’une ressource.

 Core GA
az resource tag

Étiquetez une ressource.

 Core GA
az resource update

Mettez à jour une ressource par demande PUT.

 Core GA
az resource wait

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

 Core GA

az resource create

Modifier

Créer une ressource.

az resource create --properties
                   [--api-version]
                   [--id]
                   [--is-full-object]
                   [--latest-include-preview]
                   [--location]
                   [--name]
                   [--namespace]
                   [--parent]
                   [--resource-group]
                   [--resource-type]

Exemples

Créez une application API en fournissant une configuration JSON complète.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites \
    --is-full-object --properties "{ \"kind\": \"api\", \"location\": \
        \"West US\", \"properties\": { \"serverFarmId\": \
            \"/subscriptions/{SubID}/resourcegroups/{ResourceGroup} \
                /providers/Microsoft.Web/serverfarms/{ServicePlan}\" } }"

Créez une ressource en chargeant la configuration JSON à partir d’un fichier.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile

Créez une application web avec les informations de configuration minimales requises.

az resource create -g myRG -n myWeb --resource-type Microsoft.web/sites \
    --properties "{ \"serverFarmId\":\"/subscriptions/{SubID}/resourcegroups/ \
        {ResourceGroup}/providers/Microsoft.Web/serverfarms/{ServicePlan}\" }"

Créez une ressource à l’aide de la dernière version d’API si cette version est une préversion.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile --latest-include-preview

Créer une extension de site pour une application web

az resource create -g myRG --api-version "2018-02-01" \
    --name "{sitename+slot}/siteextensions/Contrast.NetCore.Azure.SiteExtension"  \
        --resource-type Microsoft.Web/sites/siteextensions --is-full-object \
            --properties "{ \"id\": \"Contrast.NetCore.Azure.SiteExtension\", \
                \"location\": \"West US\", \"version\": \"1.9.0\" }"

Paramètres obligatoires

--properties -p

Chaîne au format JSON contenant des propriétés de ressource.

Paramètres facultatifs

--api-version

Version de l’API de la ressource (omettez la dernière version stable).

--id

ID de la ressource

--is-full-object

Indiquez que l’objet de propriétés inclut d’autres options telles que l’emplacement, les balises, la référence SKU et/ou le plan.

valeur par défaut: False
--latest-include-preview -v
Préversion

Indiquez que la dernière version de l’API sera utilisée, qu’il s’agisse d’une préversion (par exemple, 2020-01-01-preview) ou non. Par exemple, si la version api-version prise en charge du fournisseur de ressources est 2020-01-01-preview et 2019-01-01 : lors de la transmission de ce paramètre, elle prend la dernière version 2020-01-01-preview, sinon elle prend la dernière version stable 2019-01-01 sans passer ce paramètre.

valeur par défaut: False
--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--name -n

Nom de la ressource. (Ex : myC).

--namespace

Espace de noms du fournisseur (par exemple : « Microsoft.Provider »).

--parent

Chemin d’accès parent (ex : « resA/myA/resB/myB »).

--resource-group -g

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

--resource-type

Type de ressource (ex : « resC »). Peut également accepter le format d’espace de noms/type (par exemple : « Microsoft.Provider/resC »).

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az resource delete

Modifier

Supprimer une ressource.

az resource delete [--api-version]
                   [--ids]
                   [--latest-include-preview]
                   [--name]
                   [--namespace]
                   [--no-wait]
                   [--parent]
                   [--resource-group]
                   [--resource-type]

Exemples

Supprimez une machine virtuelle nommée « MyVm ».

az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Supprimez une application web à l’aide d’un identificateur de ressource.

az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp

Supprimez un sous-réseau à l’aide d’un identificateur de ressource.

az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet

Supprimez une machine virtuelle nommée « MyVm » à l’aide de la dernière version d’API si cette version est une préversion.

az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Paramètres facultatifs

--api-version

Version de l’API de la ressource (omettez la dernière version stable).

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). S’il est fourni, aucun autre argument « ID de ressource » ne doit être spécifié.

--latest-include-preview -v
Préversion

Indiquez que la dernière version de l’API sera utilisée, qu’il s’agisse d’une préversion (par exemple, 2020-01-01-preview) ou non. Par exemple, si la version api-version prise en charge du fournisseur de ressources est 2020-01-01-preview et 2019-01-01 : lors de la transmission de ce paramètre, elle prend la dernière version 2020-01-01-preview, sinon elle prend la dernière version stable 2019-01-01 sans passer ce paramètre.

valeur par défaut: False
--name -n

Nom de la ressource. (Ex : myC).

--namespace

Espace de noms du fournisseur (par exemple : « Microsoft.Provider »).

--no-wait

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

valeur par défaut: False
--parent

Chemin d’accès parent (ex : « resA/myA/resB/myB »).

--resource-group -g

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

--resource-type

Type de ressource (ex : « resC »). Peut également accepter le format d’espace de noms/type (par exemple : « Microsoft.Provider/resC »).

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az resource invoke-action

Modifier

Appelez une action sur la ressource.

Vous trouverez la liste des actions possibles correspondant à une ressource à l’adresse https://docs.microsoft.com/rest/api/. Toutes les requêtes POST sont des actions qui peuvent être appelées et qui sont spécifiées à la fin du chemin d’URI. Par exemple, pour arrêter une machine virtuelle, l’URI de la requête est https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} et l’action correspondante est powerOff. Vous trouverez cela à l’adresse https://docs.microsoft.com/rest/api/compute/virtualmachines/virtualmachines-stop.

az resource invoke-action --action
                          [--api-version]
                          [--ids]
                          [--latest-include-preview]
                          [--name]
                          [--namespace]
                          [--no-wait]
                          [--parent]
                          [--request-body]
                          [--resource-group]
                          [--resource-type]

Exemples

Désactiver une machine virtuelle, spécifiée par ID.

az resource invoke-action --action powerOff \
  --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VMName}

Capturez des informations pour une machine virtuelle arrêtée.

az resource invoke-action --action capture \
  --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/ \
    Microsoft.Compute/virtualMachines/{VMName} \
  --request-body "{ \"vhdPrefix\": \"myPrefix\", \"destinationContainerName\": \
    \"myContainer\", \"overwriteVhds\": true }"

Appelez une action sur la ressource. (généré automatiquement)

az resource invoke-action --action capture --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites

Paramètres obligatoires

--action

Action qui sera appelée sur la ressource spécifiée.

Paramètres facultatifs

--api-version

Version de l’API de la ressource (omettez la dernière version stable).

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). S’il est fourni, aucun autre argument « ID de ressource » ne doit être spécifié.

--latest-include-preview -v
Préversion

Indiquez que la dernière version de l’API sera utilisée, qu’il s’agisse d’une préversion (par exemple, 2020-01-01-preview) ou non. Par exemple, si la version api-version prise en charge du fournisseur de ressources est 2020-01-01-preview et 2019-01-01 : lors de la transmission de ce paramètre, elle prend la dernière version 2020-01-01-preview, sinon elle prend la dernière version stable 2019-01-01 sans passer ce paramètre.

valeur par défaut: False
--name -n

Nom de la ressource. (Ex : myC).

--namespace

Espace de noms du fournisseur (par exemple : « Microsoft.Provider »).

--no-wait

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

valeur par défaut: False
--parent

Chemin d’accès parent (ex : « resA/myA/resB/myB »).

--request-body

Arguments de paramètre encodés JSON pour l’action qui sera transmise dans le corps de la requête post. Utilisez @{file} pour charger à partir d’un fichier.

--resource-group -g

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

--resource-type

Type de ressource (ex : « resC »). Peut également accepter le format d’espace de noms/type (par exemple : « Microsoft.Provider/resC »).

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az resource list

Modifier

Répertoriez les ressources.

az resource list [--location]
                 [--name]
                 [--namespace]
                 [--resource-group]
                 [--resource-type]
                 [--tag]

Exemples

Répertorier toutes les ressources de la région USA Ouest.

az resource list --location westus

Répertoriez toutes les ressources portant le nom « resourceName ».

az resource list --name 'resourceName'

Répertoriez toutes les ressources avec la balise « test ».

az resource list --tag test

Répertoriez toutes les ressources avec une balise qui commence par « test ».

az resource list --tag 'test*'

Répertoriez toutes les ressources avec la balise « test » qui ont la valeur « example ».

az resource list --tag test=example

Paramètres facultatifs

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--name -n

Nom de la ressource. (Ex : myC).

--namespace

Espace de noms du fournisseur (par exemple : « Microsoft.Provider »).

--resource-group -g

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

--resource-type

Type de ressource (ex : « resC »). Peut également accepter le format d’espace de noms/type (par exemple : « Microsoft.Provider/resC »).

--tag

Balise unique au format « key[=value] ». Utilisez « » pour effacer les balises existantes.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az resource move

Modifier

Déplacez des ressources d’un groupe de ressources vers un autre (peut se trouver sous un autre abonnement).

az resource move --destination-group
                 --ids
                 [--destination-subscription-id]

Exemples

Déplacer plusieurs ressources vers le groupe de ressources de destination sous l’abonnement de destination

az resource move --destination-group ResourceGroup --destination-subscription-id SubscriptionId --ids "ResourceId1" "ResourceId2" "ResourceId3"

Paramètres obligatoires

--destination-group

Nom du groupe de ressources de destination.

--ids

ID de ressource séparés par l’espace à déplacer.

Paramètres facultatifs

--destination-subscription-id

Identificateur d’abonnement de destination.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az resource patch

Modifier

Mettez à jour une ressource par requête PATCH.

Il prend en charge la mise à jour des ressources avec une chaîne au format JSON. Si l’opération de correctif échoue, essayez d’exécuter « az resource update » à la place.

az resource patch --properties
                  [--api-version]
                  [--ids]
                  [--is-full-object]
                  [--latest-include-preview]
                  [--name]
                  [--namespace]
                  [--parent]
                  [--resource-group]
                  [--resource-type]

Exemples

Mettez à jour une application web à l’aide de la dernière version d’API si cette version est une préversion.

az resource patch --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} \
  --latest-include-preview --is-full-object --properties "{ \"tags\": { \"key\": \"value\" } }"

Mettez à jour une ressource à l’aide de la configuration JSON à partir d’un fichier.

az resource patch --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
  --is-full-object --properties @jsonConfigFile

Mettez à jour une application API en fournissant une configuration JSON.

az resource patch --name MyApiApp --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
    --is-full-object --properties "{ \"kind\": \"api\", \"properties\": { \"serverFarmId\": \
            \"/subscriptions/{SubID}/resourcegroups/{ResourceGroup} \
                /providers/Microsoft.Web/serverfarms/{ServicePlan}\" } }"

Paramètres obligatoires

--properties -p

Chaîne au format JSON contenant des propriétés de ressource.

Paramètres facultatifs

--api-version

Version de l’API de la ressource (omettez la dernière version stable).

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). S’il est fourni, aucun autre argument « ID de ressource » ne doit être spécifié.

--is-full-object

Indiquez que l’objet de propriétés inclut d’autres options telles que l’emplacement, les balises, la référence SKU et/ou le plan.

valeur par défaut: False
--latest-include-preview -v
Préversion

Indiquez que la dernière version de l’API sera utilisée, qu’il s’agisse d’une préversion (par exemple, 2020-01-01-preview) ou non. Par exemple, si la version api-version prise en charge du fournisseur de ressources est 2020-01-01-preview et 2019-01-01 : lors de la transmission de ce paramètre, elle prend la dernière version 2020-01-01-preview, sinon elle prend la dernière version stable 2019-01-01 sans passer ce paramètre.

valeur par défaut: False
--name -n

Nom de la ressource. (Ex : myC).

--namespace

Espace de noms du fournisseur (par exemple : « Microsoft.Provider »).

--parent

Chemin d’accès parent (ex : « resA/myA/resB/myB »).

--resource-group -g

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

--resource-type

Type de ressource (ex : « resC »). Peut également accepter le format d’espace de noms/type (par exemple : « Microsoft.Provider/resC »).

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az resource show

Modifier

Obtenez les détails d’une ressource.

az resource show [--api-version]
                 [--ids]
                 [--include-response-body {false, true}]
                 [--latest-include-preview]
                 [--name]
                 [--namespace]
                 [--parent]
                 [--resource-group]
                 [--resource-type]

Exemples

Afficher une ressource de machine virtuelle nommée « MyVm ».

az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Afficher une application web à l’aide d’un identificateur de ressource.

az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp

Afficher un sous-réseau.

az resource show -g MyResourceGroup -n MySubnet --namespace Microsoft.Network --parent virtualnetworks/MyVnet --resource-type subnets

Afficher un sous-réseau à l’aide d’un identificateur de ressource.

az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet

Afficher une règle de chemin d’accès application gateway.

az resource show -g MyResourceGroup --namespace Microsoft.Network --parent applicationGateways/ag1/urlPathMaps/map1 --resource-type pathRules -n rule1

Affichez une ressource de machine virtuelle nommée « MyVm » à l’aide de la dernière version api si cette version est une préversion.

az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Paramètres facultatifs

--api-version

Version de l’API de la ressource (omettez la dernière version stable).

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). S’il est fourni, aucun autre argument « ID de ressource » ne doit être spécifié.

--include-response-body

Utilisez si la sortie de commande par défaut ne capture pas toutes les données de propriété.

valeurs acceptées: false, true
valeur par défaut: False
--latest-include-preview -v
Préversion

Indiquez que la dernière version de l’API sera utilisée, qu’il s’agisse d’une préversion (par exemple, 2020-01-01-preview) ou non. Par exemple, si la version api-version prise en charge du fournisseur de ressources est 2020-01-01-preview et 2019-01-01 : lors de la transmission de ce paramètre, elle prend la dernière version 2020-01-01-preview, sinon elle prend la dernière version stable 2019-01-01 sans passer ce paramètre.

valeur par défaut: False
--name -n

Nom de la ressource. (Ex : myC).

--namespace

Espace de noms du fournisseur (par exemple : « Microsoft.Provider »).

--parent

Chemin d’accès parent (ex : « resA/myA/resB/myB »).

--resource-group -g

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

--resource-type

Type de ressource (ex : « resC »). Peut également accepter le format d’espace de noms/type (par exemple : « Microsoft.Provider/resC »).

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az resource tag

Modifier

Étiquetez une ressource.

az resource tag --tags
                [--api-version]
                [--ids]
                [--is-incremental]
                [--latest-include-preview]
                [--name]
                [--namespace]
                [--parent]
                [--resource-group]
                [--resource-type]

Exemples

Étiquetez la machine virtuelle « MyVm » avec la clé « vmlist » et la valeur « vm1 ».

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

Étiquetez une application web avec la clé « vmlist » et la valeur « vm1 », à l’aide d’un identificateur de ressource.

az resource tag --tags vmlist=vm1 --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}

Étiquetez la machine virtuelle « MyVm » avec la clé « vmlist » et la valeur « vm1 » de manière incrémentielle. Elle ne vide pas les balises existantes.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" -i

Étiquetez la machine virtuelle « MyVm » avec la clé « vmlist » et la valeur « vm1 » à l’aide de la dernière version api si cette version est une préversion.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

Paramètres obligatoires

--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

Paramètres facultatifs

--api-version

Version de l’API de la ressource (omettez la dernière version stable).

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). S’il est fourni, aucun autre argument « ID de ressource » ne doit être spécifié.

--is-incremental -i

Option permettant d’ajouter des balises de manière incrémentielle sans supprimer les balises d’origine. Si la clé de nouvelle balise et la balise d’origine sont dupliquées, la valeur d’origine est remplacée.

--latest-include-preview -v
Préversion

Indiquez que la dernière version de l’API sera utilisée, qu’il s’agisse d’une préversion (par exemple, 2020-01-01-preview) ou non. Par exemple, si la version api-version prise en charge du fournisseur de ressources est 2020-01-01-preview et 2019-01-01 : lors de la transmission de ce paramètre, elle prend la dernière version 2020-01-01-preview, sinon elle prend la dernière version stable 2019-01-01 sans passer ce paramètre.

valeur par défaut: False
--name -n

Nom de la ressource. (Ex : myC).

--namespace

Espace de noms du fournisseur (par exemple : « Microsoft.Provider »).

--parent

Chemin d’accès parent (ex : « resA/myA/resB/myB »).

--resource-group -g

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

--resource-type

Type de ressource (ex : « resC »). Peut également accepter le format d’espace de noms/type (par exemple : « Microsoft.Provider/resC »).

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az resource update

Modifier

Mettez à jour une ressource par demande PUT.

Il prend en charge la mise à jour générique (à l’aide du chemin de propriété) pour mettre à jour les ressources. Si l’opération de mise à jour échoue, essayez d’exécuter « az resource patch » à la place.

az resource update [--add]
                   [--api-version]
                   [--force-string]
                   [--ids]
                   [--include-response-body {false, true}]
                   [--latest-include-preview]
                   [--name]
                   [--namespace]
                   [--parent]
                   [--remove]
                   [--resource-group]
                   [--resource-type]
                   [--set]

Exemples

Mettez à jour une application web à l’aide de la dernière version d’API si cette version est une préversion.

az resource update --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --set tags.key=value --latest-include-preview

Mettre à jour une ressource. (généré automatiquement)

az resource update --ids $id --set properties.connectionType=Proxy

Mettre à jour une ressource. (généré automatiquement)

az resource update --name MyResource --resource-group MyResourceGroup --resource-type subnets --set tags.key=value

Paramètres facultatifs

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

valeur par défaut: []
--api-version

Version de l’API de la ressource (omettez la dernière version stable).

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

valeur par défaut: False
--ids

Un ou plusieurs ID de ressource (délimités par des espaces). S’il est fourni, aucun autre argument « ID de ressource » ne doit être spécifié.

--include-response-body

Utilisez si la sortie de commande par défaut ne capture pas toutes les données de propriété.

valeurs acceptées: false, true
valeur par défaut: False
--latest-include-preview -v
Préversion

Indiquez que la dernière version de l’API sera utilisée, qu’il s’agisse d’une préversion (par exemple, 2020-01-01-preview) ou non. Par exemple, si la version api-version prise en charge du fournisseur de ressources est 2020-01-01-preview et 2019-01-01 : lors de la transmission de ce paramètre, elle prend la dernière version 2020-01-01-preview, sinon elle prend la dernière version stable 2019-01-01 sans passer ce paramètre.

valeur par défaut: False
--name -n

Nom de la ressource. (Ex : myC).

--namespace

Espace de noms du fournisseur (par exemple : « Microsoft.Provider »).

--parent

Chemin d’accès parent (ex : « resA/myA/resB/myB »).

--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

valeur par défaut: []
--resource-group -g

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

--resource-type

Type de ressource (ex : « resC »). Peut également accepter le format d’espace de noms/type (par exemple : « Microsoft.Provider/resC »).

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

valeur par défaut: []
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az resource wait

Modifier

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

az resource wait [--api-version]
                 [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--include-response-body {false, true}]
                 [--interval]
                 [--name]
                 [--namespace]
                 [--parent]
                 [--resource-group]
                 [--resource-type]
                 [--timeout]
                 [--updated]

Exemples

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

az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}

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

az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --include-response-body true

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

az resource wait --exists --name MyResource --resource-group MyResourceGroup --resource-type subnets

Paramètres facultatifs

--api-version

Version de l’API de la ressource (omettez la dernière version stable).

--created

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

valeur par défaut: False
--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.

valeur par défaut: False
--exists

Attendez que la ressource existe.

valeur par défaut: False
--ids

Un ou plusieurs ID de ressource (délimités par des espaces). S’il est fourni, aucun autre argument « ID de ressource » ne doit être spécifié.

--include-response-body

Utilisez si la sortie de commande par défaut ne capture pas toutes les données de propriété.

valeurs acceptées: false, true
valeur par défaut: False
--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--name -n

Nom de la ressource. (Ex : myC).

--namespace

Espace de noms du fournisseur (par exemple : « Microsoft.Provider »).

--parent

Chemin d’accès parent (ex : « resA/myA/resB/myB »).

--resource-group -g

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

--resource-type

Type de ressource (ex : « resC »). Peut également accepter le format d’espace de noms/type (par exemple : « Microsoft.Provider/resC »).

--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.