az resource

Hantera Azure-resurser.

Kommandon

az resource create

skapa en resurs

az resource delete

Ta bort en resurs.

az resource invoke-action

Anropa en åtgärd på resursen.

az resource link

Hantera länkar mellan resurser.

az resource link create

Skapa en ny länk mellan resurser.

az resource link delete

Ta bort en länk mellan resurser.

az resource link list

Lista resurslänkar.

az resource link show

Hämtar en resurslänk med det angivna ID:t.

az resource link update

Uppdatera länken mellan resurser.

az resource list

Visar resurserna.

az resource lock

Hantera lås på Azure-resursnivå.

az resource lock create

Skapa ett lås på resursnivå.

az resource lock delete

Ta bort ett lås på resursnivå.

az resource lock list

Visa information om lås på resursnivå.

az resource lock show

Visa information om ett lås på resursnivå.

az resource lock update

Uppdatera ett lås på resursnivå.

az resource move

Flyttar resurser från en resursgrupp till en annan (kan finnas under en annan prenumeration).

az resource show

Hämta information om en resurs.

az resource tag

Tagga en resurs.

az resource update

Uppdatera en resurs.

az resource wait

Placera CLI i väntetillstånd tills ett villkor för en resurs uppfylls.

az resource create

skapa en resurs

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

Exempel

Skapa en API-app genom att tillhandahålla en fullständig JSON-konfiguration.

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

Skapa en resurs genom att läsa in JSON-konfigurationen från en fil.

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

Skapa en webbapp med den minsta nödvändiga konfigurationsinformationen.

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

Skapa en resurs med hjälp av den senaste API-versionen, oavsett om den här versionen är en förhandsversion.

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

Skapa ett webbplatstillägg till en webbapp

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

Obligatoriska parametrar

--properties -p

En JSON-formaterad sträng som innehåller resursegenskaper.

Valfria parametrar

--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--id

Resurs-ID.

--is-full-object

Ange att egenskapsobjektet innehåller andra alternativ, till exempel plats, taggar, SKU och/eller plan.

--latest-include-preview -v

Ange att den senaste API-versionen kommer att användas oavsett om den är en förhandsversion (t.ex. 2020-01-01-preview) eller inte. Om den API-version av resursprovidern som stöds till exempel är 2020-01-01-preview och 2019-01-01: när du anger den här parametern används den senaste versionen 2020-01-01-preview, annars kommer den senaste stabila versionen 2019-01-01 att anges utan att den här parametern anges.

--location -l

Plats. Värden från: az account list-locations . Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location> .

--name -n

Resursnamnet. (Till exempel: myC).

--namespace

Providernamnrymd (t.ex. "Microsoft.Provider").

--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med az configure --defaults group=<name> .

--resource-type

Resurstypen (t.ex. "resC"). Kan också acceptera namnrymd/typformat (t.ex. Microsoft.Provider/resC).

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med az account set -s NAME_OR_ID .

az resource delete

Ta bort en resurs.

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

Exempel

Ta bort en virtuell dator med namnet MyVm.

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

Ta bort en webbapp med hjälp av en resursidentifierare.

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

Ta bort ett undernät med hjälp av en resursidentifierare.

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

Ta bort en virtuell dator med namnet "MyVm" med den senaste API-versionen, oavsett om den här versionen är en förhandsversion.

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

Valfria parametrar

--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--ids

Ett eller flera resurs-ID:n (avgränsade med blanksteg). Om det anges ska inga andra "Resurs-ID"-argument anges.

--latest-include-preview -v

Ange att den senaste API-versionen kommer att användas oavsett om den är en förhandsversion (t.ex. 2020-01-01-preview) eller inte. Om den API-version av resursprovidern som stöds till exempel är 2020-01-01-preview och 2019-01-01: när du anger den här parametern används den senaste versionen 2020-01-01-preview, annars kommer den senaste stabila versionen 2019-01-01 att anges utan att den här parametern anges.

--name -n

Resursnamnet. (Till exempel: myC).

--namespace

Providernamnrymd (t.ex. "Microsoft.Provider").

--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med az configure --defaults group=<name> .

--resource-type

Resurstypen (t.ex. "resC"). Kan också acceptera namnrymd/typformat (t.ex. Microsoft.Provider/resC).

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med az account set -s NAME_OR_ID .

az resource invoke-action

Anropa en åtgärd på resursen.

En lista över möjliga åtgärder som motsvarar en resurs finns på https://docs.microsoft.com/rest/api/ . Alla POST-begäranden är åtgärder som kan anropas och anges i slutet av URI-sökvägen. Om du till exempel vill stoppa en virtuell dator är begärans-URI:n https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} och motsvarande åtgärd är powerOff . Du hittar detta på https://docs.microsoft.com/rest/api/compute/virtualmachines/virtualmachines-stop .

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

Exempel

Stänga av en virtuell dator, som anges av ID.

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

Samla in information om en stoppad virtuell dator.

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

Anropa en åtgärd på resursen. (automatiskt genererad)

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

Obligatoriska parametrar

--action

Den åtgärd som ska anropas på den angivna resursen.

Valfria parametrar

--api-version

API-versionen av resursen (utelämna för den senaste stabila versionen).

--ids

Ett eller flera resurs-ID:n (avgränsade med blanksteg). Om det anges ska inga andra "Resurs-ID"-argument anges.

--latest-include-preview -v

Ange att den senaste API-versionen kommer att användas oavsett om den är en förhandsversion (t.ex. 2020-01-01-preview) eller inte. Om den API-version av resursprovidern som stöds till exempel är 2020-01-01-preview och 2019-01-01: när du anger den här parametern används den senaste versionen 2020-01-01-preview, annars kommer den senaste stabila versionen 2019-01-01 att anges utan att den här parametern anges.

--name -n

Resursnamnet. (Till exempel: myC).

--namespace

Providernamnrymd (t.ex. "Microsoft.Provider").

--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--request-body

JSON-kodade parameterargument för åtgärden som skickas vidare i brödtexten efter begäran. Använd @{file} för att läsa in från en fil.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med az configure --defaults group=<name> .

--resource-type

Resurstypen (t.ex. "resC"). Kan också acceptera namnrymd/typformat (t.ex. Microsoft.Provider/resC).

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med az account set -s NAME_OR_ID .

az resource list

Visar resurserna.

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

Exempel

Visa en lista över alla resurser i regionen USA, västra.

az resource list --location westus

Visa en lista över alla resurser med namnet "resourceName".

az resource list --name 'resourceName'

Visa en lista över alla resurser med taggen "test".

az resource list --tag test

Lista alla resurser med en tagg som börjar med "test".

az resource list --tag 'test*'

Lista alla resurser med taggen "test" som har värdet "example".

az resource list --tag test=example

Valfria parametrar

--location -l

Plats. Värden från: az account list-locations . Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location> .

--name -n

Resursnamnet. (Till exempel: myC).

--namespace

Providernamnrymd (t.ex. "Microsoft.Provider").

--query-examples

Rekommendera JMESPath-sträng åt dig. Du kan kopiera en av frågan och klistra in den efter parametern --query inom dubbla citattecken för att se resultatet. Du kan lägga till ett eller flera positionsnyckelord så att vi kan ge förslag baserat på dessa nyckelord.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med az configure --defaults group=<name> .

--resource-type

Resurstypen (t.ex. "resC"). Kan också acceptera namnrymd/typformat (t.ex. Microsoft.Provider/resC).

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med az account set -s NAME_OR_ID .

--tag

En enskild tagg i formatet "key[=value]". Använd "" för att rensa befintliga taggar.

az resource move

Flyttar resurser från en resursgrupp till en annan (kan finnas under en annan prenumeration).

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

Obligatoriska parametrar

--destination-group

Målresursgruppens namn.

--ids

De utrymmesavgränsade resurs-ID:n som ska flyttas.

Valfria parametrar

--destination-subscription-id

Målprenumerationens ID.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID .

az resource show

Hämta information om en resurs.

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

Exempel

Visa en virtuell datorresurs med namnet "MyVm".

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

Visa en webbapp med hjälp av en resursidentifierare.

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

Visa ett undernät.

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

Visa ett undernät med hjälp av en resursidentifierare.

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

Visa en sökvägsregel för programgatewayen.

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

Visa en virtuell datorresurs med namnet "MyVm" med den senaste API-versionen, oavsett om den här versionen är en förhandsversion.

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

Valfria parametrar

--api-version

API-versionen av resursen (utelämnas för den senaste stabila versionen).

--ids

Ett eller flera resurs-ID:n (avgränsade med blanksteg). Om det anges ska inga andra "resurs-ID"-argument anges.

--include-response-body

Använd om standardkommandoutdata inte samlar in alla egenskapsdata.

accepterade värden: false, true
--latest-include-preview -v

Ange att den senaste API-versionen ska användas oavsett om den är en förhandsversion (t.ex. 2020-01-01-preview) eller inte. Om den API-version av resursprovidern som stöds till exempel är 2020-01-01-preview och 2019-01-01: när du anger den här parametern kommer den senaste versionen 2020-01-01-preview att användas, annars kommer den senaste stabila versionen 2019-01-01 att anges utan att den här parametern anges.

--name -n

Resursnamnet. (Till exempel myC).

--namespace

Providernamnrymd (t.ex. "Microsoft.Provider").

--parent

Den överordnade sökvägen (t.ex. "resA/myA/resB/myB").

--query-examples

Rekommendera JMESPath-sträng åt dig. Du kan kopiera en av frågan och klistra in den efter parametern --query inom dubbla citattecken för att se resultatet. Du kan lägga till ett eller flera positionsnyckelord så att vi kan ge förslag baserat på dessa nyckelord.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med az configure --defaults group=<name> .

--resource-type

Resurstypen (t.ex. "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID .

az resource tag

Tagga en resurs.

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

Exempel

Tagga den virtuella datorn "MyVm" med nyckeln "vmlist" och värdet "vm1".

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

Tagga en webbapp med nyckeln "vmlist" och värdet "vm1" med hjälp av en resursidentifierare.

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

Tagga den virtuella datorn "MyVm" med nyckeln "vmlist" och värdet "vm1" inkrementellt. De befintliga taggarna är inte tomma.

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

Tagga den virtuella datorn "MyVm" med nyckeln "vmlist" och värdet "vm1" med hjälp av den senaste API-versionen, oavsett om den här versionen är en förhandsversion.

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

Obligatoriska parametrar

--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

Valfria parametrar

--api-version

API-versionen av resursen (utelämnas för den senaste stabila versionen).

--ids

Ett eller flera resurs-ID:n (avgränsade med blanksteg). Om det anges ska inga andra "resurs-ID"-argument anges.

--is-incremental -i

Alternativet att lägga till taggar stegvis utan att ta bort de ursprungliga taggarna. Om nyckeln för den nya taggen och den ursprungliga taggen dupliceras skrivs det ursprungliga värdet över.

--latest-include-preview -v

Ange att den senaste API-versionen ska användas oavsett om den är en förhandsversion (t.ex. 2020-01-01-preview) eller inte. Om den API-version av resursprovidern som stöds till exempel är 2020-01-01-preview och 2019-01-01: när du anger den här parametern kommer den senaste versionen 2020-01-01-preview att användas, annars kommer den senaste stabila versionen 2019-01-01 att anges utan att den här parametern anges.

--name -n

Resursnamnet. (Till exempel myC).

--namespace

Providernamnrymd (t.ex. "Microsoft.Provider").

--parent

Den överordnade sökvägen (t.ex. "resA/myA/resB/myB").

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med az configure --defaults group=<name> .

--resource-type

Resurstypen (t.ex. "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID .

az resource update

Uppdatera en resurs.

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]
                   [--subscription]

Exempel

Uppdatera en webbapp med hjälp av den senaste API-versionen om den här versionen är en förhandsversion.

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

Uppdatera en resurs. (automatiskt genererad)

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

Uppdatera en resurs. (automatiskt genererad)

az resource update --name myresource --resource-group myresourcegroup --resource-type subnets --set tags.key=value

Valfria parametrar

--add

Lägg till ett -objekt i en lista med objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

--api-version

API-versionen av resursen (utelämnas för den senaste stabila versionen).

--force-string

När du använder "set" eller "add" bevarar du stränglitteraler i stället för att försöka konvertera till JSON.

--ids

Ett eller flera resurs-ID:n (avgränsade med blanksteg). Om det anges ska inga andra "resurs-ID"-argument anges.

--include-response-body

Använd om standardkommandoutdata inte samlar in alla egenskapsdata.

accepterade värden: false, true
--latest-include-preview -v

Ange att den senaste API-versionen ska användas oavsett om den är en förhandsversion (t.ex. 2020-01-01-preview) eller inte. Om den API-version av resursprovidern som stöds till exempel är 2020-01-01-preview och 2019-01-01: när du anger den här parametern kommer den senaste versionen 2020-01-01-preview att användas, annars kommer den senaste stabila versionen 2019-01-01 att anges utan att den här parametern anges.

--name -n

Resursnamnet. (Till exempel myC).

--namespace

Providernamnrymd (t.ex. "Microsoft.Provider").

--parent

Den överordnade sökvägen (t.ex. "resA/myA/resB/myB").

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med az configure --defaults group=<name> .

--resource-type

Resurstypen (t.ex. "resC"). Kan också acceptera namnområde/typformat (t.ex. Microsoft.Provider/resC).

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID .

az resource wait

Placera CLI i väntetillstånd tills ett villkor för en resurs uppfylls.

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

Exempel

Placera CLI i väntetillstånd tills ett villkor för en resurs uppfylls. (automatiskt genererad)

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

Placera CLI i väntetillstånd tills ett villkor för en resurs uppfylls. (automatiskt genererad)

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

Placera CLI i väntetillstånd tills ett villkor för en resurs uppfylls. (automatiskt genererad)

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

Valfria parametrar

--api-version

API-versionen av resursen (utelämnas för den senaste stabila versionen).

--created

Vänta tills den har skapats med "provisioningState" vid "Lyckades".

--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

--exists

Vänta tills resursen finns.

--ids

Ett eller flera resurs-ID:n (avgränsade med blanksteg). Om det anges ska inga andra "resurs-ID"-argument anges.

--include-response-body

Använd om standardkommandoutdata inte samlar in alla egenskapsdata.

accepterade värden: false, true
--interval

Avsökningsintervall i sekunder.

standardvärde: 30
--name -n

Resursnamnet. (Till exempel: myC).

--namespace

Providernamnrymd (t.ex. "Microsoft.Provider").

--parent

Den överordnade sökvägen (till exempel "resA/myA/resB/myB").

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med az configure --defaults group=<name> .

--resource-type

Resurstypen (t.ex. "resC"). Kan också acceptera namnrymd/typformat (t.ex. Microsoft.Provider/resC).

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med az account set -s NAME_OR_ID .

--timeout

Maximal väntetid i sekunder.

standardvärde: 3600
--updated

Vänta tills den har uppdaterats med provisioningState på "Succeeded" (Lyckades).