Поделиться через

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 и/или план.

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

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

Default value: False
--location -l

Местоположение. Значения из: 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
Default value: 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 без передачи этого параметра.

Default value: False
--name -n

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

--namespace

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

--no-wait

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

Default value: 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
Default value: json
--query

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

--subscription

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

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az resource invoke-action

Изменить

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

Список возможных действий, соответствующих ресурсу, можно найти в https://learn.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://learn.microsoft.com/rest/api/compute/virtualmachines/virtualmachines-stop.

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

Примеры

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

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 без передачи этого параметра.

Default value: False
--name -n

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

--namespace

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

--no-wait

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

Default value: 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
Default value: 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

Местоположение. Значения из: 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
Default value: 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
Default value: 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 и/или план.

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

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

Default value: 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
Default value: 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
Default value: False
--latest-include-preview -v
Предварительный просмотр

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

Default value: 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
Default value: 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 без передачи этого параметра.

Default value: 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
Default value: 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>.

Default value: []
--api-version

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

--force-string

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

Default value: False
--ids

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

--include-response-body

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

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

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

Default value: False
--name -n

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

--namespace

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

--parent

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

--remove

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

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

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

--resource-type

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

--set

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

Default value: []
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

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

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: 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 по адресу "Успешно".

Default value: False
--custom

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

--deleted

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

Default value: False
--exists

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

Default value: False
--ids

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

--include-response-body

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

Допустимые значения: false, true
Default value: False
--interval

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

Default value: 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

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

Default value: 3600
--updated

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

Default value: False
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.