Sdílet prostřednictvím


az resource

Správa prostředků Azure

Příkazy

Name Description Typ Stav
az resource create

Vytvořte prostředek.

Základ GA
az resource delete

Odstraňte prostředek.

Základ GA
az resource invoke-action

Vyvolá akci u prostředku.

Základ GA
az resource link

Umožňuje spravovat propojení mezi prostředky.

Základ GA
az resource link create

Vytvořte nové propojení mezi prostředky.

Základ GA
az resource link delete

Odstraňte propojení mezi prostředky.

Základ GA
az resource link list

Výpis odkazů na zdroje

Základ GA
az resource link show

Získá odkaz na prostředek se zadaným ID.

Základ GA
az resource link update

Umožňuje aktualizovat propojení mezi prostředky.

Základ GA
az resource list

Vypíše prostředky.

Základ GA
az resource lock

Správa zámků na úrovni prostředků Azure

Základ GA
az resource lock create

Vytvořte zámek na úrovni prostředku.

Základ GA
az resource lock delete

Odstraňte zámek na úrovni prostředku.

Základ GA
az resource lock list

Výpis informací o uzamčení na úrovni prostředku

Základ GA
az resource lock show

Zobrazí podrobnosti o zámku na úrovni prostředku.

Základ GA
az resource lock update

Aktualizujte zámek na úrovni prostředku.

Základ GA
az resource move

Přesun prostředků z jedné skupiny prostředků do jiné (může být pod jiným předplatným).

Základ GA
az resource patch

Aktualizujte prostředek podle požadavku PATCH.

Základ GA
az resource show

Získejte podrobnosti o prostředku.

Základ GA
az resource tag

Označte prostředek.

Základ GA
az resource update

Aktualizujte prostředek podle požadavku PUT.

Základ GA
az resource wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka prostředků.

Základ GA

az resource create

Vytvořte prostředek.

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

Příklady

Vytvořte aplikaci API tím, že poskytnete úplnou konfiguraci JSON.

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}\" } }"

Vytvořte prostředek načtením konfigurace JSON ze souboru.

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

Vytvořte webovou aplikaci s minimálními požadovanými konfiguračními informacemi.

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

Vytvořte prostředek pomocí nejnovější verze api-version, jestli se jedná o verzi Preview.

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

Vytvoření rozšíření webu pro webovou aplikaci

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\" }"

Povinné parametry

--properties -p

Řetězec ve formátu JSON obsahující vlastnosti prostředku.

Volitelné parametry

--api-version

Verze rozhraní API prostředku (vynechána pro nejnovější stabilní verzi).

--id

ID prostředku.

--is-full-object

Označuje, že objekt vlastností obsahuje další možnosti, jako je umístění, značky, skladová položka nebo plán.

Default value: False
--latest-include-preview -v
Preview

Uveďte, že se bude používat nejnovější verze api bez ohledu na to, jestli se jedná o verzi Preview (například 2020-01-01-preview), nebo ne. Pokud je například podporovaná verze api-version poskytovatele prostředků 2020-01-01-preview a 2019-01-01: při předávání tohoto parametru bude trvat nejnovější verzi 2020-01-01-preview, jinak bude trvat nejnovější stabilní verzi 2019-01-01 bez předání tohoto parametru.

Default value: False
--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--name -n

Název prostředku. (Příklad: myC).

--namespace

Obor názvů zprostředkovatele (např. Microsoft.Provider).

--parent

Nadřazená cesta (např. resA/myA/resB/myB).

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--resource-type

Typ prostředku (např. resC). Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Provider/resC).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az resource delete

Odstraňte prostředek.

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

Příklady

Odstraňte virtuální počítač s názvem MyVm.

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

Odstraňte webovou aplikaci pomocí identifikátoru prostředku.

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

Odstraňte podsíť pomocí identifikátoru prostředku.

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

Odstraňte virtuální počítač s názvem MyVm pomocí nejnovější verze api-version, jestli se jedná o verzi Preview.

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

Volitelné parametry

--api-version

Verze rozhraní API prostředku (vynechána pro nejnovější stabilní verzi).

--ids

Jedno nebo více ID prostředků (oddělených mezerami) V případě zadání by neměly být zadány žádné další argumenty ID prostředku.

--latest-include-preview -v
Preview

Uveďte, že se bude používat nejnovější verze api bez ohledu na to, jestli se jedná o verzi Preview (například 2020-01-01-preview), nebo ne. Pokud je například podporovaná verze api-version poskytovatele prostředků 2020-01-01-preview a 2019-01-01: při předávání tohoto parametru bude trvat nejnovější verzi 2020-01-01-preview, jinak bude trvat nejnovější stabilní verzi 2019-01-01 bez předání tohoto parametru.

Default value: False
--name -n

Název prostředku. (Příklad: myC).

--namespace

Obor názvů zprostředkovatele (např. Microsoft.Provider).

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--parent

Nadřazená cesta (např. resA/myA/resB/myB).

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--resource-type

Typ prostředku (např. resC). Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Provider/resC).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az resource invoke-action

Vyvolá akci u prostředku.

Seznam možných akcí odpovídajících prostředku najdete na adrese https://docs.microsoft.com/rest/api/. Všechny požadavky POST jsou akce, které lze vyvolat a jsou zadány na konci cesty URI. Pokud například chcete zastavit virtuální počítač, identifikátor URI požadavku je https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} a odpovídající akce je powerOff. Najdete ji na adrese 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]

Příklady

Vypněte virtuální počítač určený ID.

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

Zachytávání informací o zastavených virtuálních počítačích

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

Vyvolá akci u prostředku. (automaticky vygenerováno)

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

Povinné parametry

--action

Akce, která bude vyvolána u zadaného prostředku.

Volitelné parametry

--api-version

Verze rozhraní API prostředku (vynechána pro nejnovější stabilní verzi).

--ids

Jedno nebo více ID prostředků (oddělených mezerami) V případě zadání by neměly být zadány žádné další argumenty ID prostředku.

--latest-include-preview -v
Preview

Uveďte, že se bude používat nejnovější verze api bez ohledu na to, jestli se jedná o verzi Preview (například 2020-01-01-preview), nebo ne. Pokud je například podporovaná verze api-version poskytovatele prostředků 2020-01-01-preview a 2019-01-01: při předávání tohoto parametru bude trvat nejnovější verzi 2020-01-01-preview, jinak bude trvat nejnovější stabilní verzi 2019-01-01 bez předání tohoto parametru.

Default value: False
--name -n

Název prostředku. (Příklad: myC).

--namespace

Obor názvů zprostředkovatele (např. Microsoft.Provider).

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--parent

Nadřazená cesta (např. resA/myA/resB/myB).

--request-body

Argumenty parametrů kódované kódem JSON pro akci, která se předá v textu požadavku post. K načtení ze souboru použijte @{file}.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--resource-type

Typ prostředku (např. resC). Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Provider/resC).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az resource list

Vypíše prostředky.

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

Příklady

Zobrazí seznam všech prostředků v oblasti USA – západ.

az resource list --location westus

Zobrazí seznam všech prostředků s názvem resourceName.

az resource list --name 'resourceName'

Zobrazí seznam všech prostředků se značkou Test.

az resource list --tag test

Zobrazí seznam všech prostředků se značkou, která začíná na "test".

az resource list --tag 'test*'

Vypíše všechny prostředky se značkou "test", která má hodnotu example.

az resource list --tag test=example

Volitelné parametry

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--name -n

Název prostředku. (Příklad: myC).

--namespace

Obor názvů zprostředkovatele (např. Microsoft.Provider).

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--resource-type

Typ prostředku (např. resC). Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Provider/resC).

--tag

Jedna značka ve formátu key[=value]. K vymazání existujících značek použijte "".

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az resource move

Přesun prostředků z jedné skupiny prostředků do jiné (může být pod jiným předplatným).

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

Příklady

Přesun více prostředků do cílové skupiny prostředků v cílovém předplatném

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

Povinné parametry

--destination-group

Název cílové skupiny prostředků.

--ids

ID prostředků oddělených mezerami, které se mají přesunout.

Volitelné parametry

--destination-subscription-id

Identifikátor cílového předplatného.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az resource patch

Aktualizujte prostředek podle požadavku PATCH.

Podporuje aktualizaci prostředků pomocí řetězce ve formátu JSON. Pokud operace opravy selže, zkuste místo toho spustit příkaz az resource update.

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

Příklady

Aktualizujte webovou aplikaci pomocí nejnovější verze rozhraní API, jestli se jedná o verzi Preview.

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

Aktualizujte prostředek pomocí konfigurace JSON ze souboru.

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

Aktualizujte aplikaci API tím, že poskytnete konfiguraci 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}\" } }"

Povinné parametry

--properties -p

Řetězec ve formátu JSON obsahující vlastnosti prostředku.

Volitelné parametry

--api-version

Verze rozhraní API prostředku (vynechána pro nejnovější stabilní verzi).

--ids

Jedno nebo více ID prostředků (oddělených mezerami) V případě zadání by neměly být zadány žádné další argumenty ID prostředku.

--is-full-object

Označuje, že objekt vlastností obsahuje další možnosti, jako je umístění, značky, skladová položka nebo plán.

Default value: False
--latest-include-preview -v
Preview

Uveďte, že se bude používat nejnovější verze api bez ohledu na to, jestli se jedná o verzi Preview (například 2020-01-01-preview), nebo ne. Pokud je například podporovaná verze api-version poskytovatele prostředků 2020-01-01-preview a 2019-01-01: při předávání tohoto parametru bude trvat nejnovější verzi 2020-01-01-preview, jinak bude trvat nejnovější stabilní verzi 2019-01-01 bez předání tohoto parametru.

Default value: False
--name -n

Název prostředku. (Příklad: myC).

--namespace

Obor názvů zprostředkovatele (např. Microsoft.Provider).

--parent

Nadřazená cesta (např. resA/myA/resB/myB).

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--resource-type

Typ prostředku (např. resC). Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Provider/resC).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az resource show

Získejte podrobnosti o prostředku.

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

Příklady

Zobrazí prostředek virtuálního počítače s názvem MyVm.

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

Umožňuje zobrazit webovou aplikaci pomocí identifikátoru prostředku.

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

Zobrazení podsítě

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

Zobrazení podsítě pomocí identifikátoru prostředku

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

Zobrazení pravidla cesty ke službě Application Gateway

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

Pomocí nejnovější verze api-version zobrazte prostředek virtuálního počítače s názvem MyVm, jestli se jedná o verzi Preview.

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

Volitelné parametry

--api-version

Verze rozhraní API prostředku (vynechána pro nejnovější stabilní verzi).

--ids

Jedno nebo více ID prostředků (oddělených mezerami) V případě zadání by neměly být zadány žádné další argumenty ID prostředku.

--include-response-body

Použijte, pokud výchozí výstup příkazu nezachytí všechna data vlastností.

Přípustné hodnoty: false, true
Default value: False
--latest-include-preview -v
Preview

Uveďte, že se bude používat nejnovější verze api bez ohledu na to, jestli se jedná o verzi Preview (například 2020-01-01-preview), nebo ne. Pokud je například podporovaná verze api-version poskytovatele prostředků 2020-01-01-preview a 2019-01-01: při předávání tohoto parametru bude trvat nejnovější verzi 2020-01-01-preview, jinak bude trvat nejnovější stabilní verzi 2019-01-01 bez předání tohoto parametru.

Default value: False
--name -n

Název prostředku. (Příklad: myC).

--namespace

Obor názvů zprostředkovatele (např. Microsoft.Provider).

--parent

Nadřazená cesta (např. resA/myA/resB/myB).

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--resource-type

Typ prostředku (např. resC). Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Provider/resC).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az resource tag

Označte prostředek.

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

Příklady

Označte virtuální počítač MyVm klíčem vmlist a hodnotou vm1.

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

Označte webovou aplikaci pomocí klíče vmlist a hodnoty vm1 pomocí identifikátoru prostředku.

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

Označte virtuální počítač MyVm pomocí klíče vmlist a hodnoty vm1 přírůstkově. Stávající značky nevyprázdní.

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

Označte virtuální počítač MyVm klíčem vmlist a hodnotou vm1 pomocí nejnovější verze api-version, jestli se jedná o verzi Preview.

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

Povinné parametry

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

Volitelné parametry

--api-version

Verze rozhraní API prostředku (vynechána pro nejnovější stabilní verzi).

--ids

Jedno nebo více ID prostředků (oddělených mezerami) V případě zadání by neměly být zadány žádné další argumenty ID prostředku.

--is-incremental -i

Možnost přidávat značky přírůstkově bez odstranění původních značek. Pokud je klíč nové značky a původní značky duplikován, původní hodnota se přepíše.

--latest-include-preview -v
Preview

Uveďte, že se bude používat nejnovější verze api bez ohledu na to, jestli se jedná o verzi Preview (například 2020-01-01-preview), nebo ne. Pokud je například podporovaná verze api-version poskytovatele prostředků 2020-01-01-preview a 2019-01-01: při předávání tohoto parametru bude trvat nejnovější verzi 2020-01-01-preview, jinak bude trvat nejnovější stabilní verzi 2019-01-01 bez předání tohoto parametru.

Default value: False
--name -n

Název prostředku. (Příklad: myC).

--namespace

Obor názvů zprostředkovatele (např. Microsoft.Provider).

--parent

Nadřazená cesta (např. resA/myA/resB/myB).

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--resource-type

Typ prostředku (např. resC). Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Provider/resC).

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az resource update

Aktualizujte prostředek podle požadavku PUT.

Podporuje obecnou aktualizaci (pomocí cesty vlastností) k aktualizaci prostředků. Pokud operace aktualizace selže, zkuste místo toho spustit příkaz az resource patch.

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]

Příklady

Aktualizujte webovou aplikaci pomocí nejnovější verze rozhraní API, jestli se jedná o verzi Preview.

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

Aktualizace prostředku. (automaticky vygenerováno)

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

Aktualizace prostředku. (automaticky vygenerováno)

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

Volitelné parametry

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

Default value: []
--api-version

Verze rozhraní API prostředku (vynechána pro nejnovější stabilní verzi).

--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

Default value: False
--ids

Jedno nebo více ID prostředků (oddělených mezerami) V případě zadání by neměly být zadány žádné další argumenty ID prostředku.

--include-response-body

Použijte, pokud výchozí výstup příkazu nezachytí všechna data vlastností.

Přípustné hodnoty: false, true
Default value: False
--latest-include-preview -v
Preview

Uveďte, že se bude používat nejnovější verze api bez ohledu na to, jestli se jedná o verzi Preview (například 2020-01-01-preview), nebo ne. Pokud je například podporovaná verze api-version poskytovatele prostředků 2020-01-01-preview a 2019-01-01: při předávání tohoto parametru bude trvat nejnovější verzi 2020-01-01-preview, jinak bude trvat nejnovější stabilní verzi 2019-01-01 bez předání tohoto parametru.

Default value: False
--name -n

Název prostředku. (Příklad: myC).

--namespace

Obor názvů zprostředkovatele (např. Microsoft.Provider).

--parent

Nadřazená cesta (např. resA/myA/resB/myB).

--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--resource-type

Typ prostředku (např. resC). Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Provider/resC).

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

Default value: []
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az resource wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka prostředků.

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]

Příklady

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka prostředků. (automaticky vygenerováno)

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

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka prostředků. (automaticky vygenerováno)

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

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka prostředků. (automaticky vygenerováno)

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

Volitelné parametry

--api-version

Verze rozhraní API prostředku (vynechána pro nejnovější stabilní verzi).

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

Default value: False
--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Počkejte na odstranění.

Default value: False
--exists

Počkejte, až prostředek existuje.

Default value: False
--ids

Jedno nebo více ID prostředků (oddělených mezerami) V případě zadání by neměly být zadány žádné další argumenty ID prostředku.

--include-response-body

Použijte, pokud výchozí výstup příkazu nezachytí všechna data vlastností.

Přípustné hodnoty: false, true
Default value: False
--interval

Interval dotazování v sekundách

Default value: 30
--name -n

Název prostředku. (Příklad: myC).

--namespace

Obor názvů zprostředkovatele (např. Microsoft.Provider).

--parent

Nadřazená cesta (např. resA/myA/resB/myB).

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--resource-type

Typ prostředku (např. resC). Může také přijmout formát oboru názvů nebo typu (např. Microsoft.Provider/resC).

--timeout

Maximální čekání v sekundách.

Default value: 3600
--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.