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

az group deployment

  • Не рекомендуется
  • Ссылка

Эта группа команд устарела и будет удалена в будущем выпуске. Вместо этого используйте группу развертывания.

Управление развертываниями Azure Resource Manager.

Команды

Имя Описание Тип Состояние
az group deployment cancel

Отменяет текущее развертывание шаблона.

 Основные сведения Устарело
az group deployment create

Запускает развертывание.

 Основные сведения Устарело
az group deployment delete

Удаляет развертывание из журнала развертывания.

 Основные сведения Устарело
az group deployment export

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

 Основные сведения Устарело
az group deployment list

Выводит все развертывания для группы ресурсов.

 Основные сведения Устарело
az group deployment operation

Управление операциями развертывания.

 Основные сведения Устарело
az group deployment operation list

Возвращает все операции развертывания для развертывания.

 Основные сведения Устарело
az group deployment operation show

Получение операции развертывания.

 Основные сведения Устарело
az group deployment show

Возвращает развертывание.

 Основные сведения Устарело
az group deployment validate

Проверьте, является ли шаблон синтаксически правильным.

 Основные сведения Устарело
az group deployment wait

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

 Основные сведения Устарело

az group deployment cancel

Изменить
Не рекомендуется

Эта команда неявно устарела, так как группа команд "групповое развертывание" устарела и будет удалена в будущем выпуске. Вместо этого используйте группу развертывания.

Отменяет текущее развертывание шаблона.

Развертывание можно отменить только в том случае, если параметр provisioningState принимается или выполняется. После отмены развертывания параметр provisioningState имеет значение Canceled. Отмена развертывания шаблона останавливает текущее развертывание шаблона и оставляет группу ресурсов частично развернутой.

az group deployment cancel --name
                           --resource-group

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

--name -n

Имя развертывания.

--resource-group -g

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

Глобальные параметры
--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 group deployment create

Изменить
Не рекомендуется

Эта команда неявно устарела, так как группа команд "групповое развертывание" устарела и будет удалена в будущем выпуске. Вместо этого используйте группу развертывания.

Запускает развертывание.

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--template-file]
                           [--template-uri]

Примеры

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

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

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

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

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

--resource-group -g

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

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

--aux-subs
Не рекомендуется

Параметр "--aux-subs" устарел и будет удален в будущем выпуске. Вместо этого используйте "--aux-tenants".

Вспомогательные подписки, которые будут использоваться во время развертывания в клиентах.

--aux-tenants

Вспомогательные клиенты, которые будут использоваться во время развертывания между клиентами.

--handle-extended-json-format -j
Не рекомендуется

Параметр --handle-extended-json-format/-j не рекомендуется и будет удален в будущем выпуске.

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

--mode

Добавочный (только добавление ресурсов в группу ресурсов) или "Завершение" (удаление дополнительных ресурсов из группы ресурсов).

Допустимые значения: Complete, Incremental
Default value: Incremental
--name -n

Имя развертывания. По умолчанию используется базовое имя файла шаблона.

--no-prompt

Параметр отключения запроса отсутствующих параметров для шаблона ARM. Если значение равно true, запрос, требующий от пользователей предоставления отсутствующих параметров, будет игнорироваться. По умолчанию используется значение false.

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

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

Default value: False
--parameters -p

Укажите значения параметров развертывания.

Параметры могут быть предоставлены из файла с помощью синтаксиса @{path} , строки JSON или <пар KEY=VALUE> . Параметры вычисляются в порядке, поэтому при назначении значения дважды используется последнее значение. Рекомендуется сначала указать файл параметров, а затем переопределить выборочно с помощью синтаксиса KEY=VALUE.

--rollback-on-error

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

--template-file -f

Путь к файлу шаблона или Bicep-файлу в файловой системе.

--template-uri -u

Универсальный код ресурса (URI) для удаленного файла шаблона.

Глобальные параметры
--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 group deployment delete

Изменить
Не рекомендуется

Эта команда неявно устарела, так как группа команд "групповое развертывание" устарела и будет удалена в будущем выпуске. Вместо этого используйте группу развертывания.

Удаляет развертывание из журнала развертывания.

Развертывание шаблона, выполняемое в настоящее время, невозможно удалить. При удалении развертывания шаблона удаляются связанные операции развертывания. Удаление развертывания шаблона не влияет на состояние группы ресурсов. Это асинхронная операция, которая возвращает состояние 202, пока развертывание шаблона не будет успешно удалено. Заголовок ответа location содержит универсальный код ресурса (URI), используемый для получения состояния процесса. Во время выполнения процесса вызов URI в заголовке location возвращает состояние 202. По завершении процесса URI в заголовке location возвращает состояние 204 по успешному выполнению. Если не удалось выполнить асинхронный запрос, URI в заголовке location возвращает код состояния уровня ошибки.

az group deployment delete --name
                           --resource-group
                           [--no-wait]

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

--name -n

Имя развертывания.

--resource-group -g

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

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

--no-wait

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

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.

az group deployment export

Изменить
Не рекомендуется

Эта команда неявно устарела, так как группа команд "групповое развертывание" устарела и будет удалена в будущем выпуске. Вместо этого используйте группу развертывания.

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

az group deployment export --name
                           --resource-group

Примеры

Экспортирует шаблон, который использовался для развертывания. (автоматическое создание)

az group deployment export --name MyDeployment --resource-group MyResourceGroup

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

--name -n

Имя развертывания.

--resource-group -g

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

Глобальные параметры
--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 group deployment list

Изменить
Не рекомендуется

Эта команда неявно устарела, так как группа команд "групповое развертывание" устарела и будет удалена в будущем выпуске. Вместо этого используйте группу развертывания.

Выводит все развертывания для группы ресурсов.

az group deployment list --resource-group
                         [--filter]
                         [--top]

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

--resource-group -g

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

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

--filter

Фильтр, применяемый к операции. Например, можно использовать $filter=provisioningState eq "{state}". Значение по умолчанию — None.

--top

Количество результатов, которые нужно получить. Если значение NULL передается, возвращает все развертывания. Значение по умолчанию — None.

Глобальные параметры
--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 group deployment show

Изменить
Не рекомендуется

Эта команда неявно устарела, так как группа команд "групповое развертывание" устарела и будет удалена в будущем выпуске. Вместо этого используйте группу развертывания.

Возвращает развертывание.

az group deployment show --name
                         --resource-group

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

--name -n

Имя развертывания.

--resource-group -g

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

Глобальные параметры
--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 group deployment validate

Изменить
Не рекомендуется

Эта команда неявно устарела, так как группа команд "групповое развертывание" устарела и будет удалена в будущем выпуске. Вместо этого используйте группу развертывания.

Проверьте, является ли шаблон синтаксически правильным.

az group deployment validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--rollback-on-error]
                             [--template-file]
                             [--template-uri]

Примеры

Проверьте, является ли шаблон синтаксически правильным. (автоматическое создание)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

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

--resource-group -g

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

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

--handle-extended-json-format -j
Не рекомендуется

Параметр --handle-extended-json-format/-j не рекомендуется и будет удален в будущем выпуске.

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

--mode

Добавочный (только добавление ресурсов в группу ресурсов) или "Завершение" (удаление дополнительных ресурсов из группы ресурсов).

Допустимые значения: Complete, Incremental
Default value: Incremental
--no-prompt

Параметр отключения запроса отсутствующих параметров для шаблона ARM. Если значение равно true, запрос, требующий от пользователей предоставления отсутствующих параметров, будет игнорироваться. По умолчанию используется значение false.

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

Укажите значения параметров развертывания.

Параметры могут быть предоставлены из файла с помощью синтаксиса @{path} , строки JSON или <пар KEY=VALUE> . Параметры вычисляются в порядке, поэтому при назначении значения дважды используется последнее значение. Рекомендуется сначала указать файл параметров, а затем переопределить выборочно с помощью синтаксиса KEY=VALUE.

--rollback-on-error

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

--template-file -f

Путь к файлу шаблона или Bicep-файлу в файловой системе.

--template-uri -u

Универсальный код ресурса (URI) для удаленного файла шаблона.

Глобальные параметры
--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 group deployment wait

Изменить
Не рекомендуется

Эта команда неявно устарела, так как группа команд "групповое развертывание" устарела и будет удалена в будущем выпуске. Вместо этого используйте группу развертывания.

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

az group deployment wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--timeout]
                         [--updated]

Примеры

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

az group deployment wait --name MyDeployment --resource-group MyResourceGroup --updated

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

az group deployment wait --created --name MyDeployment --resource-group MyResourceGroup

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

--name -n

Имя развертывания.

--resource-group -g

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

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

--created

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

Default value: False
--custom

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

--deleted

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

Default value: False
--exists

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

Default value: False
--interval

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

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