az resource

Gérer les ressources Azure.

Commandes

Nom	Description	Type	État
az resource create	Créez une ressource.	Core	GA
az resource delete	Supprimez 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	List resources.	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éez 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--id

Resource ID.

--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.

Propriété	Valeur
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.

Propriété	Valeur
Parameter group:	Resource Id Arguments
Valeur par défaut:	False

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--name -n

Nom de la ressource. (Ex: myC).

Propriété	Valeur
Parameter group:	Resource Id Arguments

--namespace

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--parent

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-type

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az resource delete

Modifier

Supprimez 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--ids

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--latest-include-preview -v

Préversion

Propriété	Valeur
Parameter group:	Resource Id Arguments
Valeur par défaut:	False

--name -n

Nom de la ressource. (Ex: myC).

Propriété	Valeur
Parameter group:	Resource Id Arguments

--namespace

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--no-wait

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

Propriété	Valeur
Valeur par défaut:	False

--parent

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-type

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az resource invoke-action

Modifier

Appelez une action sur la ressource.

Vous trouverez la liste des actions possibles correspondant à une ressource à https://learn.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 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 à https://learn.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. (autogenerated)

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--ids

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--latest-include-preview -v

Préversion

Propriété	Valeur
Parameter group:	Resource Id Arguments
Valeur par défaut:	False

--name -n

Nom de la ressource. (Ex: myC).

Propriété	Valeur
Parameter group:	Resource Id Arguments

--namespace

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--no-wait

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

Propriété	Valeur
Valeur par défaut:	False

--parent

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--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 à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-type

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

az resource list

Modifier

List resources.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--name -n

Nom de la ressource. (Ex: myC).

--namespace

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-type

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--tag

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

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--destination-subscription-id

Identificateur d’abonnement de destination.

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--ids

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--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.

Propriété	Valeur
Valeur par défaut:	False

--latest-include-preview -v

Préversion

Propriété	Valeur
Parameter group:	Resource Id Arguments
Valeur par défaut:	False

--name -n

Nom de la ressource. (Ex: myC).

Propriété	Valeur
Parameter group:	Resource Id Arguments

--namespace

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--parent

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-type

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--ids

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--include-response-body

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

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--latest-include-preview -v

Préversion

Propriété	Valeur
Parameter group:	Resource Id Arguments
Valeur par défaut:	False

--name -n

Nom de la ressource. (Ex: myC).

Propriété	Valeur
Parameter group:	Resource Id Arguments

--namespace

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--parent

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-type

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--ids

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--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

Propriété	Valeur
Parameter group:	Resource Id Arguments
Valeur par défaut:	False

--name -n

Nom de la ressource. (Ex: myC).

Propriété	Valeur
Parameter group:	Resource Id Arguments

--namespace

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--parent

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-type

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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

Mettez à jour une ressource. (autogenerated)

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

Mettez à jour une ressource. (autogenerated)

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

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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>.

Propriété	Valeur
Parameter group:	Generic Update Arguments
Valeur par défaut:	[]

--api-version

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--force-string

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

Propriété	Valeur
Parameter group:	Generic Update Arguments
Valeur par défaut:	False

--ids

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--include-response-body

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

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--latest-include-preview -v

Préversion

Propriété	Valeur
Parameter group:	Resource Id Arguments
Valeur par défaut:	False

--name -n

Nom de la ressource. (Ex: myC).

Propriété	Valeur
Parameter group:	Resource Id Arguments

--namespace

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--parent

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--remove

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

Propriété	Valeur
Parameter group:	Generic Update Arguments
Valeur par défaut:	[]

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-type

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--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>.

Propriété	Valeur
Parameter group:	Generic Update Arguments
Valeur par défaut:	[]

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

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. (autogenerated)

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. (autogenerated)

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. (autogenerated)

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

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--created

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

Propriété	Valeur
Parameter group:	Wait Condition Arguments
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'].

Propriété	Valeur
Parameter group:	Wait Condition Arguments

--deleted

Attendez la suppression.

Propriété	Valeur
Parameter group:	Wait Condition Arguments
Valeur par défaut:	False

--exists

Attendez que la ressource existe.

Propriété	Valeur
Parameter group:	Wait Condition Arguments
Valeur par défaut:	False

--ids

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--include-response-body

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

Propriété	Valeur
Valeur par défaut:	False
Valeurs acceptées:	false, true

--interval

Intervalle d’interrogation en secondes.

Propriété	Valeur
Parameter group:	Wait Condition Arguments
Valeur par défaut:	30

--name -n

Nom de la ressource. (Ex: myC).

Propriété	Valeur
Parameter group:	Resource Id Arguments

--namespace

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--parent

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété	Valeur
Parameter group:	Resource Id Arguments

--resource-type

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

Propriété	Valeur
Parameter group:	Resource Id Arguments

--timeout

Délai maximal d’attente en secondes.

Propriété	Valeur
Parameter group:	Wait Condition Arguments
Valeur par défaut:	3600

--updated

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

Propriété	Valeur
Parameter group:	Wait Condition Arguments
Valeur par défaut:	False

Paramètres globaux

--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété	Valeur
Valeur par défaut:	False

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété	Valeur
Valeur par défaut:	False

--output -o

Output format.

Propriété	Valeur
Valeur par défaut:	json
Valeurs acceptées:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété	Valeur
Valeur par défaut:	False

Partager via

az resource

Commandes

az resource create

Exemples

Paramètres obligatoires

Paramètres facultatifs

az resource delete

Exemples

Paramètres facultatifs

az resource invoke-action

Exemples

Paramètres obligatoires

Paramètres facultatifs

az resource list

Exemples

Paramètres facultatifs

az resource move

Exemples

Paramètres obligatoires

Paramètres facultatifs

az resource patch

Exemples

Paramètres obligatoires

Paramètres facultatifs

az resource show

Exemples

Paramètres facultatifs

az resource tag

Exemples

Paramètres obligatoires

Paramètres facultatifs

az resource update

Exemples

Paramètres facultatifs

az resource wait

Exemples

Paramètres facultatifs

Commentaires