Partager via


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

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

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

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

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

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

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

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

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

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

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

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

É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

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

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

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

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