az resource

  • Odwołanie

Zarządzanie zasobami platformy Azure.

Polecenia

Nazwa Opis Typ Stan
az resource create

Utwórz zasób.

 Podstawowe funkcje Ogólna dostępność
az resource delete

Usuń zasób.

 Podstawowe funkcje Ogólna dostępność
az resource invoke-action

Wywołaj akcję dla zasobu.

 Podstawowe funkcje Ogólna dostępność
az resource link

Zarządzanie łączami między zasobami.

 Podstawowe funkcje Ogólna dostępność
az resource link create

Utwórz nowy link między zasobami.

 Podstawowe funkcje Ogólna dostępność
az resource link delete

Usuń łącze między zasobami.

 Podstawowe funkcje Ogólna dostępność
az resource link list

Wyświetlanie listy łączy zasobów.

 Podstawowe funkcje Ogólna dostępność
az resource link show

Pobiera link zasobu z określonym identyfikatorem.

 Podstawowe funkcje Ogólna dostępność
az resource link update

Zaktualizuj łącze między zasobami.

 Podstawowe funkcje Ogólna dostępność
az resource list

Wyświetla listę zasobów.

 Podstawowe funkcje Ogólna dostępność
az resource lock

Zarządzanie blokadami na poziomie zasobów platformy Azure.

 Podstawowe funkcje Ogólna dostępność
az resource lock create

Utwórz blokadę na poziomie zasobu.

 Podstawowe funkcje Ogólna dostępność
az resource lock delete

Usuń blokadę na poziomie zasobu.

 Podstawowe funkcje Ogólna dostępność
az resource lock list

Wyświetlanie listy informacji o blokadzie na poziomie zasobu.

 Podstawowe funkcje Ogólna dostępność
az resource lock show

Pokaż szczegóły blokady na poziomie zasobu.

 Podstawowe funkcje Ogólna dostępność
az resource lock update

Zaktualizuj blokadę na poziomie zasobu.

 Podstawowe funkcje Ogólna dostępność
az resource move

Przenoszenie zasobów z jednej grupy zasobów do innej (może być w ramach innej subskrypcji).

 Podstawowe funkcje Ogólna dostępność
az resource patch

Zaktualizuj zasób według żądania PATCH.

 Podstawowe funkcje Ogólna dostępność
az resource show

Uzyskaj szczegółowe informacje o zasobie.

 Podstawowe funkcje Ogólna dostępność
az resource tag

Tagowanie zasobu.

 Podstawowe funkcje Ogólna dostępność
az resource update

Zaktualizuj zasób według żądania PUT.

 Podstawowe funkcje Ogólna dostępność
az resource wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku zasobów.

 Podstawowe funkcje Ogólna dostępność

az resource create

Edytuj

Utwórz zasób.

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

Przykłady

Utwórz aplikację interfejsu API, udostępniając pełną konfigurację 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}\" } }"

Utwórz zasób, ładując konfigurację JSON z pliku.

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

Utwórz aplikację internetową z minimalnymi wymaganymi informacjami o konfiguracji.

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

Utwórz zasób przy użyciu najnowszej wersji interfejsu API, czy ta wersja jest wersją zapoznawcza.

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

Tworzenie rozszerzenia witryny w aplikacji internetowej

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

Parametry wymagane

--properties -p

Ciąg sformatowany w formacie JSON zawierający właściwości zasobu.

Parametry opcjonalne

--api-version

Wersja interfejsu API zasobu (pomijanie najnowszej stabilnej wersji).

--id

Identyfikator zasobu.

--is-full-object

Wskaż, że obiekt właściwości zawiera inne opcje, takie jak lokalizacja, tagi, jednostka SKU i/lub plan.

wartość domyślna: False
--latest-include-preview -v
Wersja zapoznawcza

Wskaż, że najnowsza wersja interfejsu API będzie używana niezależnie od tego, czy jest to wersja zapoznawcza (na przykład 2020-01-01-preview) czy nie. Jeśli na przykład obsługiwana wersja interfejsu API dostawcy zasobów to 2020-01-01-preview i 2019-01-01: podczas przekazywania tego parametru zostanie pobrana najnowsza wersja 2020-01-01-preview, w przeciwnym razie zostanie pobrana najnowsza stabilna wersja 2019-01-01 bez przekazywania tego parametru.

wartość domyślna: False
--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--name -n

Nazwa zasobu. (Np. myC).

--namespace

Przestrzeń nazw dostawcy (np. "Microsoft.Provider").

--parent

Ścieżka nadrzędna (np. "resA/myA/resB/myB").

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--resource-type

Typ zasobu (np. "resC"). Może również akceptować format przestrzeni nazw/typu (np. "Microsoft.Provider/resC").

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az resource delete

Edytuj

Usuń zasób.

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

Przykłady

Usuń maszynę wirtualną o nazwie "MyVm".

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

Usuń aplikację internetową przy użyciu identyfikatora zasobu.

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

Usuń podsieć przy użyciu identyfikatora zasobu.

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

Usuń maszynę wirtualną o nazwie "MyVm" przy użyciu najnowszej wersji interfejsu API, czy ta wersja jest wersją zapoznawcza.

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

Parametry opcjonalne

--api-version

Wersja interfejsu API zasobu (pomijanie najnowszej stabilnej wersji).

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). W przypadku podania nie należy określać żadnych innych argumentów "Identyfikator zasobu".

--latest-include-preview -v
Wersja zapoznawcza

Wskaż, że najnowsza wersja interfejsu API będzie używana niezależnie od tego, czy jest to wersja zapoznawcza (na przykład 2020-01-01-preview) czy nie. Jeśli na przykład obsługiwana wersja interfejsu API dostawcy zasobów to 2020-01-01-preview i 2019-01-01: podczas przekazywania tego parametru zostanie pobrana najnowsza wersja 2020-01-01-preview, w przeciwnym razie zostanie pobrana najnowsza stabilna wersja 2019-01-01 bez przekazywania tego parametru.

wartość domyślna: False
--name -n

Nazwa zasobu. (Np. myC).

--namespace

Przestrzeń nazw dostawcy (np. "Microsoft.Provider").

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--parent

Ścieżka nadrzędna (np. "resA/myA/resB/myB").

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--resource-type

Typ zasobu (np. "resC"). Może również akceptować format przestrzeni nazw/typu (np. "Microsoft.Provider/resC").

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az resource invoke-action

Edytuj

Wywołaj akcję dla zasobu.

Listę możliwych akcji odpowiadających zasobowi można znaleźć pod adresem https://docs.microsoft.com/rest/api/. Wszystkie żądania POST to akcje, które można wywołać i są określone na końcu ścieżki identyfikatora URI. Na przykład aby zatrzymać maszynę wirtualną, identyfikator URI żądania to https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} , a odpowiednią akcją jest powerOff. Można to znaleźć na stronie 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]

Przykłady

Wyłącz maszynę wirtualną określoną przez identyfikator.

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

Przechwyć informacje dotyczące zatrzymanej maszyny wirtualnej.

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

Wywołaj akcję dla zasobu. (automatycznie wygenerowane)

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

Parametry wymagane

--action

Akcja, która zostanie wywołana w określonym zasobie.

Parametry opcjonalne

--api-version

Wersja interfejsu API zasobu (pomijanie najnowszej stabilnej wersji).

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). W przypadku podania nie należy określać żadnych innych argumentów "Identyfikator zasobu".

--latest-include-preview -v
Wersja zapoznawcza

Wskaż, że najnowsza wersja interfejsu API będzie używana niezależnie od tego, czy jest to wersja zapoznawcza (na przykład 2020-01-01-preview) czy nie. Jeśli na przykład obsługiwana wersja interfejsu API dostawcy zasobów to 2020-01-01-preview i 2019-01-01: podczas przekazywania tego parametru zostanie pobrana najnowsza wersja 2020-01-01-preview, w przeciwnym razie zostanie pobrana najnowsza stabilna wersja 2019-01-01 bez przekazywania tego parametru.

wartość domyślna: False
--name -n

Nazwa zasobu. (Np. myC).

--namespace

Przestrzeń nazw dostawcy (np. "Microsoft.Provider").

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--parent

Ścieżka nadrzędna (np. "resA/myA/resB/myB").

--request-body

Argumenty parametrów zakodowanych w formacie JSON dla akcji, która zostanie przekazana w treści żądania post. Użyj @{file} do załadowania z pliku.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--resource-type

Typ zasobu (np. "resC"). Może również akceptować format przestrzeni nazw/typu (np. "Microsoft.Provider/resC").

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az resource list

Edytuj

Wyświetla listę zasobów.

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

Przykłady

Wyświetl listę wszystkich zasobów w regionie Zachodnie stany USA.

az resource list --location westus

Wyświetl listę wszystkich zasobów o nazwie "resourceName".

az resource list --name 'resourceName'

Wyświetl listę wszystkich zasobów z tagiem "test".

az resource list --tag test

Wyświetl listę wszystkich zasobów z tagiem rozpoczynającym się od "test".

az resource list --tag 'test*'

Wyświetl listę wszystkich zasobów z tagiem "test", który ma wartość "example".

az resource list --tag test=example

Parametry opcjonalne

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--name -n

Nazwa zasobu. (Np. myC).

--namespace

Przestrzeń nazw dostawcy (np. "Microsoft.Provider").

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--resource-type

Typ zasobu (np. "resC"). Może również akceptować format przestrzeni nazw/typu (np. "Microsoft.Provider/resC").

--tag

Pojedynczy tag w formacie "key[=value]". Użyj ciągu "", aby wyczyścić istniejące tagi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az resource move

Edytuj

Przenoszenie zasobów z jednej grupy zasobów do innej (może być w ramach innej subskrypcji).

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

Przykłady

Przenoszenie wielu zasobów do docelowej grupy zasobów w ramach subskrypcji docelowej

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

Parametry wymagane

--destination-group

Nazwa docelowej grupy zasobów.

--ids

Identyfikatory zasobów rozdzielone spacjami, które mają zostać przeniesione.

Parametry opcjonalne

--destination-subscription-id

Identyfikator subskrypcji docelowej.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az resource patch

Edytuj

Zaktualizuj zasób według żądania PATCH.

Obsługuje aktualizowanie zasobów przy użyciu ciągu w formacie JSON. Jeśli operacja stosowania poprawek nie powiedzie się, spróbuj zamiast tego uruchomić polecenie "az resource update".

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

Przykłady

Zaktualizuj aplikacje internetowe przy użyciu najnowszej wersji interfejsu API, czy ta wersja jest wersją zapoznawcza.

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

Zaktualizuj zasób przy użyciu konfiguracji JSON z pliku.

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

Zaktualizuj aplikację interfejsu API, podając konfigurację 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}\" } }"

Parametry wymagane

--properties -p

Ciąg sformatowany w formacie JSON zawierający właściwości zasobu.

Parametry opcjonalne

--api-version

Wersja interfejsu API zasobu (pomijanie najnowszej stabilnej wersji).

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). W przypadku podania nie należy określać żadnych innych argumentów "Identyfikator zasobu".

--is-full-object

Wskaż, że obiekt właściwości zawiera inne opcje, takie jak lokalizacja, tagi, jednostka SKU i/lub plan.

wartość domyślna: False
--latest-include-preview -v
Wersja zapoznawcza

Wskaż, że najnowsza wersja interfejsu API będzie używana niezależnie od tego, czy jest to wersja zapoznawcza (na przykład 2020-01-01-preview) czy nie. Jeśli na przykład obsługiwana wersja interfejsu API dostawcy zasobów to 2020-01-01-preview i 2019-01-01: podczas przekazywania tego parametru zostanie pobrana najnowsza wersja 2020-01-01-preview, w przeciwnym razie zostanie pobrana najnowsza stabilna wersja 2019-01-01 bez przekazywania tego parametru.

wartość domyślna: False
--name -n

Nazwa zasobu. (Np. myC).

--namespace

Przestrzeń nazw dostawcy (np. "Microsoft.Provider").

--parent

Ścieżka nadrzędna (np. "resA/myA/resB/myB").

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--resource-type

Typ zasobu (np. "resC"). Może również akceptować format przestrzeni nazw/typu (np. "Microsoft.Provider/resC").

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az resource show

Edytuj

Uzyskaj szczegółowe informacje o zasobie.

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

Przykłady

Pokaż zasób maszyny wirtualnej o nazwie "MyVm".

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

Pokaż aplikację internetową przy użyciu identyfikatora zasobu.

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

Pokaż podsieć.

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

Pokaż podsieć przy użyciu identyfikatora zasobu.

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

Pokaż regułę ścieżki bramy aplikacji.

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

Pokaż zasób maszyny wirtualnej o nazwie "MyVm" przy użyciu najnowszej wersji interfejsu API, czy ta wersja jest wersją zapoznawcza.

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

Parametry opcjonalne

--api-version

Wersja interfejsu API zasobu (pomijanie najnowszej stabilnej wersji).

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). W przypadku podania nie należy określać żadnych innych argumentów "Identyfikator zasobu".

--include-response-body

Użyj polecenia , jeśli domyślne dane wyjściowe polecenia nie przechwytują wszystkich danych właściwości.

akceptowane wartości: false, true
wartość domyślna: False
--latest-include-preview -v
Wersja zapoznawcza

Wskaż, że najnowsza wersja interfejsu API będzie używana niezależnie od tego, czy jest to wersja zapoznawcza (na przykład 2020-01-01-preview) czy nie. Jeśli na przykład obsługiwana wersja interfejsu API dostawcy zasobów to 2020-01-01-preview i 2019-01-01: podczas przekazywania tego parametru zostanie pobrana najnowsza wersja 2020-01-01-preview, w przeciwnym razie zostanie pobrana najnowsza stabilna wersja 2019-01-01 bez przekazywania tego parametru.

wartość domyślna: False
--name -n

Nazwa zasobu. (Np. myC).

--namespace

Przestrzeń nazw dostawcy (np. "Microsoft.Provider").

--parent

Ścieżka nadrzędna (np. "resA/myA/resB/myB").

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--resource-type

Typ zasobu (np. "resC"). Może również akceptować format przestrzeni nazw/typu (np. "Microsoft.Provider/resC").

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az resource tag

Edytuj

Tagowanie zasobu.

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

Przykłady

Oznacz maszynę wirtualną "MyVm" kluczem "vmlist" i wartością "vm1".

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

Oznaczanie aplikacji internetowej kluczem "vmlist" i wartością "vm1" przy użyciu identyfikatora zasobu.

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

Oznaczanie maszyny wirtualnej "MyVm" kluczem "vmlist" i wartością "vm1" przyrostowo. Nie powoduje opróżniania istniejących tagów.

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

Oznacz maszynę wirtualną "MyVm" kluczem "vmlist" i wartością "vm1" przy użyciu najnowszej wersji interfejsu API, czy ta wersja jest wersją zapoznawcza.

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

Parametry wymagane

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [key[=value] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

Parametry opcjonalne

--api-version

Wersja interfejsu API zasobu (pomijanie najnowszej stabilnej wersji).

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). W przypadku podania nie należy określać żadnych innych argumentów "Identyfikator zasobu".

--is-incremental -i

Opcja dodawania tagów przyrostowo bez usuwania oryginalnych tagów. Jeśli klucz nowego tagu i oryginalnego tagu zostaną zduplikowane, oryginalna wartość zostanie zastąpiona.

--latest-include-preview -v
Wersja zapoznawcza

Wskaż, że najnowsza wersja interfejsu API będzie używana niezależnie od tego, czy jest to wersja zapoznawcza (na przykład 2020-01-01-preview) czy nie. Jeśli na przykład obsługiwana wersja interfejsu API dostawcy zasobów to 2020-01-01-preview i 2019-01-01: podczas przekazywania tego parametru zostanie pobrana najnowsza wersja 2020-01-01-preview, w przeciwnym razie zostanie pobrana najnowsza stabilna wersja 2019-01-01 bez przekazywania tego parametru.

wartość domyślna: False
--name -n

Nazwa zasobu. (Np. myC).

--namespace

Przestrzeń nazw dostawcy (np. "Microsoft.Provider").

--parent

Ścieżka nadrzędna (np. "resA/myA/resB/myB").

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--resource-type

Typ zasobu (np. "resC"). Może również akceptować format przestrzeni nazw/typu (np. "Microsoft.Provider/resC").

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az resource update

Edytuj

Zaktualizuj zasób według żądania PUT.

Obsługuje ona aktualizację ogólną (przy użyciu ścieżki właściwości) w celu zaktualizowania zasobów. Jeśli operacja aktualizacji nie powiedzie się, spróbuj zamiast tego uruchomić polecenie "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]

Przykłady

Zaktualizuj aplikacje internetowe przy użyciu najnowszej wersji interfejsu API, czy ta wersja jest wersją zapoznawcza.

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

Aktualizowanie zasobu. (automatycznie wygenerowane)

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

Aktualizowanie zasobu. (automatycznie wygenerowane)

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

Parametry opcjonalne

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

wartość domyślna: []
--api-version

Wersja interfejsu API zasobu (pomijanie najnowszej stabilnej wersji).

--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

wartość domyślna: False
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). W przypadku podania nie należy określać żadnych innych argumentów "Identyfikator zasobu".

--include-response-body

Użyj polecenia , jeśli domyślne dane wyjściowe polecenia nie przechwytują wszystkich danych właściwości.

akceptowane wartości: false, true
wartość domyślna: False
--latest-include-preview -v
Wersja zapoznawcza

Wskaż, że najnowsza wersja interfejsu API będzie używana niezależnie od tego, czy jest to wersja zapoznawcza (na przykład 2020-01-01-preview) czy nie. Jeśli na przykład obsługiwana wersja interfejsu API dostawcy zasobów to 2020-01-01-preview i 2019-01-01: podczas przekazywania tego parametru zostanie pobrana najnowsza wersja 2020-01-01-preview, w przeciwnym razie zostanie pobrana najnowsza stabilna wersja 2019-01-01 bez przekazywania tego parametru.

wartość domyślna: False
--name -n

Nazwa zasobu. (Np. myC).

--namespace

Przestrzeń nazw dostawcy (np. "Microsoft.Provider").

--parent

Ścieżka nadrzędna (np. "resA/myA/resB/myB").

--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

wartość domyślna: []
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--resource-type

Typ zasobu (np. "resC"). Może również akceptować format przestrzeni nazw/typu (np. "Microsoft.Provider/resC").

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

wartość domyślna: []
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az resource wait

Edytuj

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku zasobów.

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]

Przykłady

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku zasobów. (automatycznie wygenerowane)

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

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku zasobów. (automatycznie wygenerowane)

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

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku zasobów. (automatycznie wygenerowane)

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

Parametry opcjonalne

--api-version

Wersja interfejsu API zasobu (pomijanie najnowszej stabilnej wersji).

--created

Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".

wartość domyślna: False
--custom

Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Poczekaj na usunięcie.

wartość domyślna: False
--exists

Zaczekaj, aż zasób istnieje.

wartość domyślna: False
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). W przypadku podania nie należy określać żadnych innych argumentów "Identyfikator zasobu".

--include-response-body

Użyj polecenia , jeśli domyślne dane wyjściowe polecenia nie przechwytują wszystkich danych właściwości.

akceptowane wartości: false, true
wartość domyślna: False
--interval

Interwał sondowania w sekundach.

wartość domyślna: 30
--name -n

Nazwa zasobu. (Np. myC).

--namespace

Przestrzeń nazw dostawcy (np. "Microsoft.Provider").

--parent

Ścieżka nadrzędna (np. "resA/myA/resB/myB").

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--resource-type

Typ zasobu (np. "resC"). Może również akceptować format przestrzeni nazw/typu (np. "Microsoft.Provider/resC").

--timeout

Maksymalny czas oczekiwania w sekundach.

wartość domyślna: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

wartość domyślna: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.