az resource

  • Ссылка

Управление ресурсами Azure.

Команды

Имя Описание Тип Состояние
az resource create

Создание ресурса.

 Основные сведения Общедоступная версия
az resource delete

Удаление ресурса.

 Основные сведения Общедоступная версия
az resource invoke-action

Вызов действия в ресурсе.

 Основные сведения Общедоступная версия
az resource link

Управление связями между ресурсами.

 Основные сведения Общедоступная версия
az resource link create

Создайте новую связь между ресурсами.

 Основные сведения Общедоступная версия
az resource link delete

Удаление связи между ресурсами.

 Основные сведения Общедоступная версия
az resource link list

Вывод списка ссылок на ресурсы.

 Основные сведения Общедоступная версия
az resource link show

Возвращает ссылку на ресурс с указанным идентификатором.

 Основные сведения Общедоступная версия
az resource link update

Обновление связи между ресурсами.

 Основные сведения Общедоступная версия
az resource list

Перечисление ресурсов.

 Основные сведения Общедоступная версия
az resource lock

Управление блокировками на уровне ресурсов Azure.

 Основные сведения Общедоступная версия
az resource lock create

Создайте блокировку уровня ресурса.

 Основные сведения Общедоступная версия
az resource lock delete

Удаление блокировки на уровне ресурса.

 Основные сведения Общедоступная версия
az resource lock list

Вывод списка сведений о блокировке на уровне ресурса.

 Основные сведения Общедоступная версия
az resource lock show

Отображение сведений о блокировке на уровне ресурса.

 Основные сведения Общедоступная версия
az resource lock update

Обновите блокировку на уровне ресурса.

 Основные сведения Общедоступная версия
az resource move

Перемещение ресурсов из одной группы ресурсов в другую (может находиться в другой подписке).

 Основные сведения Общедоступная версия
az resource patch

Обновление ресурса по запросу PATCH.

 Основные сведения Общедоступная версия
az resource show

Получение сведений о ресурсе.

 Основные сведения Общедоступная версия
az resource tag

Пометьте ресурс.

 Основные сведения Общедоступная версия
az resource update

Обновление ресурса по запросу PUT.

 Основные сведения Общедоступная версия
az resource wait

Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие ресурсов.

 Основные сведения Общедоступная версия

az resource create

Изменить

Создание ресурса.

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

Примеры

Создайте приложение API, предоставив полную конфигурацию 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}\" } }"

Создайте ресурс, загрузив конфигурацию JSON из файла.

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

Создайте веб-приложение с минимальными необходимыми сведениями о конфигурации.

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

Создайте ресурс с помощью последней версии API, является ли эта версия предварительной версией.

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

Создание расширения сайта для веб-приложения

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

Обязательные параметры

--properties -p

Строка в формате JSON, содержащая свойства ресурса.

Необязательные параметры

--api-version

Версия api ресурса (опущена для последней стабильной версии).

--id

Идентификатор ресурса.

--is-full-object

Укажите, что объект свойств включает другие параметры, такие как расположение, теги, sku и/или план.

значение по умолчанию: False
--latest-include-preview -v
Предварительный просмотр

Укажите, что последняя версия API будет использоваться независимо от того, является ли она предварительной версией (например, 2020-01-preview) или нет. Например, если поддерживаемая версия поставщика ресурсов — 2020-01-01-preview и 2019-01-01: при передаче этого параметра будет приниматься последняя версия 2020-01-01-preview, в противном случае она будет принимать последнюю стабильную версию 2019-01-01 без передачи этого параметра.

значение по умолчанию: False
--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--name -n

Имя ресурса. (Ex: myC).

--namespace

Пространство имен поставщика (например, Microsoft.Provider).

--parent

Родительский путь (например: resA/myA/resB/myB/myB).

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--resource-type

Тип ресурса (например, resC). Может также принимать формат пространства имен и типа (например, Microsoft.Provider/resC).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az resource delete

Изменить

Удаление ресурса.

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

Примеры

Удалите виртуальную машину с именем MyVm.

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

Удалите веб-приложение с помощью идентификатора ресурса.

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

Удалите подсеть с помощью идентификатора ресурса.

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

Удалите виртуальную машину с именем MyVm, используя последнюю версию API-версии, является ли эта версия предварительной версией.

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

Необязательные параметры

--api-version

Версия api ресурса (опущена для последней стабильной версии).

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Если задано, другие аргументы "Идентификатор ресурса" не должны быть указаны.

--latest-include-preview -v
Предварительный просмотр

Укажите, что последняя версия API будет использоваться независимо от того, является ли она предварительной версией (например, 2020-01-preview) или нет. Например, если поддерживаемая версия поставщика ресурсов — 2020-01-01-preview и 2019-01-01: при передаче этого параметра будет приниматься последняя версия 2020-01-01-preview, в противном случае она будет принимать последнюю стабильную версию 2019-01-01 без передачи этого параметра.

значение по умолчанию: False
--name -n

Имя ресурса. (Ex: myC).

--namespace

Пространство имен поставщика (например, Microsoft.Provider).

--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--parent

Родительский путь (например: resA/myA/resB/myB/myB).

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--resource-type

Тип ресурса (например, resC). Может также принимать формат пространства имен и типа (например, Microsoft.Provider/resC).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az resource invoke-action

Изменить

Вызов действия в ресурсе.

Список возможных действий, соответствующих ресурсу, можно найти по адресу https://docs.microsoft.com/rest/api/. Все запросы POST — это действия, которые можно вызвать и указать в конце пути URI. Например, чтобы остановить виртуальную машину, URI запроса — https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} и соответствующее действие.powerOff Это можно найти по адресу 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]

Примеры

Выключите виртуальную машину, указанную идентификатором.

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

Сбор сведений об остановленной виртуальной машине.

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

Вызов действия в ресурсе. (автоматическое создание)

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

Обязательные параметры

--action

Действие, которое будет вызываться в указанном ресурсе.

Необязательные параметры

--api-version

Версия api ресурса (опущена для последней стабильной версии).

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Если задано, другие аргументы "Идентификатор ресурса" не должны быть указаны.

--latest-include-preview -v
Предварительный просмотр

Укажите, что последняя версия API будет использоваться независимо от того, является ли она предварительной версией (например, 2020-01-preview) или нет. Например, если поддерживаемая версия поставщика ресурсов — 2020-01-01-preview и 2019-01-01: при передаче этого параметра будет приниматься последняя версия 2020-01-01-preview, в противном случае она будет принимать последнюю стабильную версию 2019-01-01 без передачи этого параметра.

значение по умолчанию: False
--name -n

Имя ресурса. (Ex: myC).

--namespace

Пространство имен поставщика (например, Microsoft.Provider).

--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--parent

Родительский путь (например: resA/myA/resB/myB/myB).

--request-body

Аргументы в кодировке JSON для действия, которое будет передано в тексте запроса после запроса. Используйте @{file} для загрузки из файла.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--resource-type

Тип ресурса (например, resC). Может также принимать формат пространства имен и типа (например, Microsoft.Provider/resC).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az resource list

Изменить

Перечисление ресурсов.

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

Примеры

Список всех ресурсов в регионе "Западная часть США".

az resource list --location westus

Список всех ресурсов с именем resourceName.

az resource list --name 'resourceName'

Вывод списка всех ресурсов с тегом test.

az resource list --tag test

Вывод списка всех ресурсов с тегом, начинающимся с "test".

az resource list --tag 'test*'

Выведите список всех ресурсов с тегом test, имеющим значение example.

az resource list --tag test=example

Необязательные параметры

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--name -n

Имя ресурса. (Ex: myC).

--namespace

Пространство имен поставщика (например, Microsoft.Provider).

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--resource-type

Тип ресурса (например, resC). Может также принимать формат пространства имен и типа (например, Microsoft.Provider/resC).

--tag

Один тег в формате key[=value]. Используйте "" для очистки существующих тегов.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az resource move

Изменить

Перемещение ресурсов из одной группы ресурсов в другую (может находиться в другой подписке).

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

Примеры

Перемещение нескольких ресурсов в целевую группу ресурсов в конечной подписке

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

Обязательные параметры

--destination-group

Имя целевой группы ресурсов.

--ids

Перемещаемые идентификаторы ресурсов, разделенные пробелами.

Необязательные параметры

--destination-subscription-id

Идентификатор целевой подписки.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az resource patch

Изменить

Обновление ресурса по запросу PATCH.

Он поддерживает обновление ресурсов с помощью строки в формате JSON. Если операция исправления завершается ошибкой, попробуйте запустить az resource update.

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

Примеры

Обновите веб-приложение с помощью последней версии API, является ли эта версия предварительной версией.

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

Обновите ресурс с помощью конфигурации JSON из файла.

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

Обновите приложение API, предоставив конфигурацию 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}\" } }"

Обязательные параметры

--properties -p

Строка в формате JSON, содержащая свойства ресурса.

Необязательные параметры

--api-version

Версия api ресурса (опущена для последней стабильной версии).

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Если задано, другие аргументы "Идентификатор ресурса" не должны быть указаны.

--is-full-object

Укажите, что объект свойств включает другие параметры, такие как расположение, теги, sku и/или план.

значение по умолчанию: False
--latest-include-preview -v
Предварительный просмотр

Укажите, что последняя версия API будет использоваться независимо от того, является ли она предварительной версией (например, 2020-01-preview) или нет. Например, если поддерживаемая версия поставщика ресурсов — 2020-01-01-preview и 2019-01-01: при передаче этого параметра будет приниматься последняя версия 2020-01-01-preview, в противном случае она будет принимать последнюю стабильную версию 2019-01-01 без передачи этого параметра.

значение по умолчанию: False
--name -n

Имя ресурса. (Ex: myC).

--namespace

Пространство имен поставщика (например, Microsoft.Provider).

--parent

Родительский путь (например: resA/myA/resB/myB/myB).

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--resource-type

Тип ресурса (например, resC). Может также принимать формат пространства имен и типа (например, Microsoft.Provider/resC).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az resource show

Изменить

Получение сведений о ресурсе.

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

Примеры

Отображение ресурса виртуальной машины с именем MyVm.

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

Отображение веб-приложения с помощью идентификатора ресурса.

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

Отображение подсети.

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

Отображение подсети с помощью идентификатора ресурса.

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

Отображение правила пути шлюза приложений.

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

Отображение ресурса виртуальной машины с именем MyVm с помощью последней версии API, является ли эта версия предварительной версией.

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

Необязательные параметры

--api-version

Версия api ресурса (опущена для последней стабильной версии).

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Если задано, другие аргументы "Идентификатор ресурса" не должны быть указаны.

--include-response-body

Используйте, если выходные данные команды по умолчанию не записывают все данные свойства.

допустимые значения: false, true
значение по умолчанию: False
--latest-include-preview -v
Предварительный просмотр

Укажите, что последняя версия API будет использоваться независимо от того, является ли она предварительной версией (например, 2020-01-preview) или нет. Например, если поддерживаемая версия поставщика ресурсов — 2020-01-01-preview и 2019-01-01: при передаче этого параметра будет приниматься последняя версия 2020-01-01-preview, в противном случае она будет принимать последнюю стабильную версию 2019-01-01 без передачи этого параметра.

значение по умолчанию: False
--name -n

Имя ресурса. (Ex: myC).

--namespace

Пространство имен поставщика (например, Microsoft.Provider).

--parent

Родительский путь (например: resA/myA/resB/myB/myB).

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--resource-type

Тип ресурса (например, resC). Может также принимать формат пространства имен и типа (например, Microsoft.Provider/resC).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az resource tag

Изменить

Пометьте ресурс.

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

Примеры

Пометьте виртуальную машину MyVm ключом vmlist и значением vm1.

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

Пометьте веб-приложение ключом vmlist и значением vm1 с помощью идентификатора ресурса.

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

Пометьте виртуальную машину MyVm с ключом vmlist и значением vm1 постепенно. Он не пустит существующие теги.

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

Пометьте виртуальную машину MyVm с ключом vmlist и значением vm1 с помощью последней версии API, является ли эта версия предварительной версией.

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

Обязательные параметры

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

Необязательные параметры

--api-version

Версия api ресурса (опущена для последней стабильной версии).

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Если задано, другие аргументы "Идентификатор ресурса" не должны быть указаны.

--is-incremental -i

Параметр добавочного добавления тегов без удаления исходных тегов. Если ключ нового тега и исходного тега дублируются, исходное значение будет перезаписан.

--latest-include-preview -v
Предварительный просмотр

Укажите, что последняя версия API будет использоваться независимо от того, является ли она предварительной версией (например, 2020-01-preview) или нет. Например, если поддерживаемая версия поставщика ресурсов — 2020-01-01-preview и 2019-01-01: при передаче этого параметра будет приниматься последняя версия 2020-01-01-preview, в противном случае она будет принимать последнюю стабильную версию 2019-01-01 без передачи этого параметра.

значение по умолчанию: False
--name -n

Имя ресурса. (Ex: myC).

--namespace

Пространство имен поставщика (например, Microsoft.Provider).

--parent

Родительский путь (например: resA/myA/resB/myB/myB).

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--resource-type

Тип ресурса (например, resC). Может также принимать формат пространства имен и типа (например, Microsoft.Provider/resC).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az resource update

Изменить

Обновление ресурса по запросу PUT.

Он поддерживает универсальное обновление (с помощью пути к свойству) для обновления ресурсов. Если операция обновления завершается ошибкой, попробуйте запустить 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]

Примеры

Обновите веб-приложение с помощью последней версии API, является ли эта версия предварительной версией.

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

Обновление ресурса. (автоматическое создание)

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

Обновление ресурса. (автоматическое создание)

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

Необязательные параметры

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

значение по умолчанию: []
--api-version

Версия api ресурса (опущена для последней стабильной версии).

--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

значение по умолчанию: False
--ids

Один или несколько идентификаторов ресурсов (через пробелы). Если задано, другие аргументы "Идентификатор ресурса" не должны быть указаны.

--include-response-body

Используйте, если выходные данные команды по умолчанию не записывают все данные свойства.

допустимые значения: false, true
значение по умолчанию: False
--latest-include-preview -v
Предварительный просмотр

Укажите, что последняя версия API будет использоваться независимо от того, является ли она предварительной версией (например, 2020-01-preview) или нет. Например, если поддерживаемая версия поставщика ресурсов — 2020-01-01-preview и 2019-01-01: при передаче этого параметра будет приниматься последняя версия 2020-01-01-preview, в противном случае она будет принимать последнюю стабильную версию 2019-01-01 без передачи этого параметра.

значение по умолчанию: False
--name -n

Имя ресурса. (Ex: myC).

--namespace

Пространство имен поставщика (например, Microsoft.Provider).

--parent

Родительский путь (например: resA/myA/resB/myB/myB).

--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

значение по умолчанию: []
--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--resource-type

Тип ресурса (например, resC). Может также принимать формат пространства имен и типа (например, Microsoft.Provider/resC).

--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

значение по умолчанию: []
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az resource wait

Изменить

Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие ресурсов.

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]

Примеры

Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие ресурсов. (автоматическое создание)

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

Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие ресурсов. (автоматическое создание)

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

Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие ресурсов. (автоматическое создание)

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

Необязательные параметры

--api-version

Версия api ресурса (опущена для последней стабильной версии).

--created

Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".

значение по умолчанию: False
--custom

Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].

--deleted

Дождитесь удаления.

значение по умолчанию: False
--exists

Подождите, пока ресурс не существует.

значение по умолчанию: False
--ids

Один или несколько идентификаторов ресурсов (через пробелы). Если задано, другие аргументы "Идентификатор ресурса" не должны быть указаны.

--include-response-body

Используйте, если выходные данные команды по умолчанию не записывают все данные свойства.

допустимые значения: false, true
значение по умолчанию: False
--interval

Интервал опроса в секундах.

значение по умолчанию: 30
--name -n

Имя ресурса. (Ex: myC).

--namespace

Пространство имен поставщика (например, Microsoft.Provider).

--parent

Родительский путь (например: resA/myA/resB/myB/myB).

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--resource-type

Тип ресурса (например, resC). Может также принимать формат пространства имен и типа (например, Microsoft.Provider/resC).

--timeout

Максимальное ожидание в секундах.

значение по умолчанию: 3600
--updated

Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".

значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.