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

az resource

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

Команды

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

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

 Core GA
az resource delete

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

 Core GA
az resource invoke-action

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

 Core GA
az resource link

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

 Core GA
az resource link create

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

 Core GA
az resource link delete

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

 Core GA
az resource link list

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

 Core GA
az resource link show

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

 Core GA
az resource link update

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

 Core GA
az resource list

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

 Core GA
az resource lock

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

 Core GA
az resource lock create

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

 Core GA
az resource lock delete

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

 Core GA
az resource lock list

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

 Core GA
az resource lock show

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

 Core GA
az resource lock update

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

 Core GA
az resource move

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

 Core GA
az resource patch

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

 Core GA
az resource show

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

 Core GA
az resource tag

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

 Core GA
az resource update

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

 Core GA
az resource wait

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

 Core GA

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 ресурса (опущена для последней стабильной версии).

Свойство Значение
Группа параметров: Resource Id Arguments
--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 без передачи этого параметра.

Свойство Значение
Группа параметров: Resource Id Arguments
Default value: False
--location -l

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

--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--namespace

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

Свойство Значение
Группа параметров: Resource Id Arguments
--parent

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-type

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

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

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 ресурса (опущена для последней стабильной версии).

Свойство Значение
Группа параметров: Resource Id Arguments
--ids

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

Свойство Значение
Группа параметров: Resource Id Arguments
--latest-include-preview -v
Предварительный просмотр

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

Свойство Значение
Группа параметров: Resource Id Arguments
Default value: False
--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--namespace

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

Свойство Значение
Группа параметров: Resource Id Arguments
--no-wait

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

Свойство Значение
Default value: False
--parent

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-type

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

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

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

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

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

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

--action

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

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--api-version

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

Свойство Значение
Группа параметров: Resource Id Arguments
--ids

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

Свойство Значение
Группа параметров: Resource Id Arguments
--latest-include-preview -v
Предварительный просмотр

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

Свойство Значение
Группа параметров: Resource Id Arguments
Default value: False
--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--namespace

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

Свойство Значение
Группа параметров: Resource Id Arguments
--no-wait

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

Свойство Значение
Default value: False
--parent

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

Свойство Значение
Группа параметров: Resource Id Arguments
--request-body

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

--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-type

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

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

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 Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-type

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

Свойство Значение
Группа параметров: Resource Id Arguments
--tag

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

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

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

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

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

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 ресурса (опущена для последней стабильной версии).

Свойство Значение
Группа параметров: Resource Id Arguments
--ids

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

Свойство Значение
Группа параметров: Resource Id Arguments
--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 без передачи этого параметра.

Свойство Значение
Группа параметров: Resource Id Arguments
Default value: False
--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--namespace

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

Свойство Значение
Группа параметров: Resource Id Arguments
--parent

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-type

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

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

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 ресурса (опущена для последней стабильной версии).

Свойство Значение
Группа параметров: Resource Id Arguments
--ids

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

Свойство Значение
Группа параметров: Resource Id Arguments
--include-response-body

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

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

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

Свойство Значение
Группа параметров: Resource Id Arguments
Default value: False
--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--namespace

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

Свойство Значение
Группа параметров: Resource Id Arguments
--parent

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-type

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

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

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 ресурса (опущена для последней стабильной версии).

Свойство Значение
Группа параметров: Resource Id Arguments
--ids

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

Свойство Значение
Группа параметров: Resource Id Arguments
--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 без передачи этого параметра.

Свойство Значение
Группа параметров: Resource Id Arguments
Default value: False
--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--namespace

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

Свойство Значение
Группа параметров: Resource Id Arguments
--parent

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-type

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

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

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

Обновление ресурса. (autogenerated)

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

Обновление ресурса. (autogenerated)

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>.

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: []
--api-version

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

Свойство Значение
Группа параметров: Resource Id Arguments
--force-string

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

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: False
--ids

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

Свойство Значение
Группа параметров: Resource Id Arguments
--include-response-body

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

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

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

Свойство Значение
Группа параметров: Resource Id Arguments
Default value: False
--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--namespace

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

Свойство Значение
Группа параметров: Resource Id Arguments
--parent

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

Свойство Значение
Группа параметров: Resource Id Arguments
--remove

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

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: []
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-type

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

Свойство Значение
Группа параметров: Resource Id Arguments
--set

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

Свойство Значение
Группа параметров: Generic Update Arguments
Default value: []
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

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]

Примеры

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

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

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

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

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

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

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--api-version

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

Свойство Значение
Группа параметров: Resource Id Arguments
--created

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

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
--custom

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

Свойство Значение
Группа параметров: Wait Condition Arguments
--deleted

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

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
--exists

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

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
--ids

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

Свойство Значение
Группа параметров: Resource Id Arguments
--include-response-body

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

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

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

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: 30
--name -n

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

Свойство Значение
Группа параметров: Resource Id Arguments
--namespace

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

Свойство Значение
Группа параметров: Resource Id Arguments
--parent

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

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

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-type

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

Свойство Значение
Группа параметров: Resource Id Arguments
--timeout

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

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: 3600
--updated

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

Свойство Значение
Группа параметров: Wait Condition Arguments
Default value: False
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False