az deployment sub
Управление развертыванием шаблона Azure Resource Manager в области подписки.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
az deployment sub cancel |
Отмена развертывания в области подписки. |
Core | GA |
az deployment sub create |
Запустите развертывание в области подписки. |
Core | GA |
az deployment sub delete |
Удаление развертывания в области подписки. |
Core | GA |
az deployment sub export |
Экспорт шаблона, используемого для развертывания. |
Core | GA |
az deployment sub list |
Вывод списка развертываний в области подписки. |
Core | GA |
az deployment sub show |
Отображение развертывания в области подписки. |
Core | GA |
az deployment sub validate |
Проверьте, является ли шаблон допустимым в области подписки. |
Core | GA |
az deployment sub wait |
Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие развертывания. |
Core | GA |
az deployment sub what-if |
Выполните операцию развертывания What-If в области подписки. |
Core | GA |
az deployment sub cancel
Отмена развертывания в области подписки.
az deployment sub cancel --name
Примеры
Отмена развертывания в области подписки.
az deployment sub cancel -n deployment01
Обязательные параметры
Имя развертывания.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az deployment sub create
Запустите развертывание в области подписки.
Укажите только один из файлов --template-file | --template-URI URI | --template-spec для ввода шаблона ARM.
az deployment sub create --location
[--confirm-with-what-if]
[--handle-extended-json-format]
[--name]
[--no-prompt {false, true}]
[--no-wait]
[--parameters]
[--proceed-if-no-change]
[--query-string]
[--template-file]
[--template-spec]
[--template-uri]
[--what-if]
[--what-if-exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
[--what-if-result-format {FullResourcePayloads, ResourceIdOnly}]
Примеры
Создайте развертывание в области подписки из удаленного файла шаблона с помощью параметров из локального JSON-файла.
az deployment sub create --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
Создайте развертывание в области подписки из локального файла шаблона, используя параметры из строки JSON.
az deployment sub create --location WestUS --template-file azuredeploy.json \
--parameters '{ \"policyName\": { \"value\": \"policy2\" } }'
Создайте развертывание в области подписки из локального шаблона, используя файл параметров, удаленный файл параметров и выборочно переопределяя пары "ключ-значение".
az deployment sub create --location WestUS --template-file azuredeploy.json \
--parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json
Обязательные параметры
Расположение для хранения метаданных развертывания.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Перед выполнением развертывания выполните команду What-If развертывания. Затем он предложит подтвердить изменения ресурсов перед продолжением.
Параметр --handle-extended-json-format/-j не рекомендуется и будет удален в будущем выпуске.
Поддержка обработки расширенного содержимого шаблона, включая многостроочное и примечания в развертывании.
Имя развертывания.
Параметр отключения запроса отсутствующих параметров для шаблона ARM. Если значение равно true, запрос, требующий от пользователей предоставления отсутствующих параметров, будет игнорироваться. По умолчанию используется значение false.
Свойство | Значение |
---|---|
Default value: | False |
Допустимые значения: | false, true |
Не ожидать завершения длительной операции.
Свойство | Значение |
---|---|
Default value: | False |
Укажите значения параметров развертывания.
Параметры могут быть предоставлены из файла с помощью синтаксиса @{path}
, строки JSON или пар <KEY=VALUE>
. Параметры вычисляются в порядке, поэтому при назначении значения дважды используется последнее значение. Рекомендуется сначала указать файл параметров, а затем переопределить выборочно с помощью синтаксиса KEY=VALUE.
Укажите команде выполнить развертывание, если результат What-If не содержит изменений ресурсов. Применимо, если задано значение --confirm-with-what-if.
Строка запроса (маркер SAS), используемая с универсальным кодом шаблона в случае связанных шаблонов.
Путь к файлу шаблона или Bicep-файлу.
Идентификатор ресурса спецификации шаблона.
Универсальный код ресурса (URI) в файл шаблона.
Укажите команду для запуска развертывания What-If.
Разделенный пробелами список типов изменений ресурсов, которые следует исключить из What-If результатов. Применимо, если задано значение --confirm-with-what-if.
Свойство | Значение |
---|---|
Допустимые значения: | Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported |
Формат результатов What-If. Применимо при установке --confirm-with-what-if
.
Свойство | Значение |
---|---|
Default value: | FullResourcePayloads |
Допустимые значения: | FullResourcePayloads, ResourceIdOnly |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az deployment sub delete
Удаление развертывания в области подписки.
az deployment sub delete --name
[--no-wait]
Примеры
Удаление развертывания в области подписки.
az deployment sub delete -n deployment01
Обязательные параметры
Имя развертывания.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Не ожидать завершения длительной операции.
Свойство | Значение |
---|---|
Default value: | False |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az deployment sub export
Экспорт шаблона, используемого для развертывания.
az deployment sub export --name
Примеры
Экспорт шаблона, используемого для развертывания в области подписки.
az deployment sub export --name MyDeployment
Обязательные параметры
Имя развертывания.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az deployment sub list
Вывод списка развертываний в области подписки.
az deployment sub list [--filter]
Примеры
Вывод списка развертываний в области подписки.
az deployment sub list
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Выражение фильтра с помощью нотации OData. Вы можете использовать --filter "provisioningState eq "{state}" для фильтрации подготовкиState. Чтобы получить дополнительные сведения, посетите https://learn.microsoft.com/rest/api/resources/deployments/listatsubscriptionscope#uri-parameters.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az deployment sub show
Отображение развертывания в области подписки.
az deployment sub show --name
Примеры
Отображение развертывания в области подписки.
az deployment sub show -n deployment01
Обязательные параметры
Имя развертывания.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az deployment sub validate
Проверьте, является ли шаблон допустимым в области подписки.
Укажите только один из файлов --template-file | --template-URI URI | --template-spec для ввода шаблона ARM.
az deployment sub validate --location
[--handle-extended-json-format]
[--name]
[--no-prompt {false, true}]
[--parameters]
[--query-string]
[--template-file]
[--template-spec]
[--template-uri]
Примеры
Проверьте, является ли шаблон допустимым в области подписки.
az deployment sub validate --location westus2 --template-file {template-file}
Проверьте, является ли шаблон допустимым в области подписки. (autogenerated)
az deployment sub validate --location westus2 --parameters MyValue=This MyArray=@array.json --template-file azuredeploy.json
Обязательные параметры
Расположение для хранения метаданных развертывания.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Параметр --handle-extended-json-format/-j не рекомендуется и будет удален в будущем выпуске.
Поддержка обработки расширенного содержимого шаблона, включая многостроочное и примечания в развертывании.
Имя развертывания.
Параметр отключения запроса отсутствующих параметров для шаблона ARM. Если значение равно true, запрос, требующий от пользователей предоставления отсутствующих параметров, будет игнорироваться. По умолчанию используется значение false.
Свойство | Значение |
---|---|
Default value: | False |
Допустимые значения: | false, true |
Укажите значения параметров развертывания.
Параметры могут быть предоставлены из файла с помощью синтаксиса @{path}
, строки JSON или пар <KEY=VALUE>
. Параметры вычисляются в порядке, поэтому при назначении значения дважды используется последнее значение. Рекомендуется сначала указать файл параметров, а затем переопределить выборочно с помощью синтаксиса KEY=VALUE.
Строка запроса (маркер SAS), используемая с универсальным кодом шаблона в случае связанных шаблонов.
Путь к файлу шаблона или Bicep-файлу.
Идентификатор ресурса спецификации шаблона.
Универсальный код ресурса (URI) в файл шаблона.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az deployment sub wait
Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие развертывания.
az deployment sub wait --name
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
Примеры
Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие развертывания. (autogenerated)
az deployment sub wait --created --name MyDeployment
Обязательные параметры
Имя развертывания.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Дождитесь удаления.
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Подождите, пока ресурс не существует.
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Интервал опроса в секундах.
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | 30 |
Максимальное ожидание в секундах.
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | 3600 |
Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".
Свойство | Значение |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az deployment sub what-if
Выполните операцию развертывания What-If в области подписки.
Укажите только один из файлов --template-file | --template-URI URI | --template-spec для ввода шаблона ARM.
az deployment sub what-if --location
[--exclude-change-types {Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported}]
[--name]
[--no-pretty-print]
[--no-prompt {false, true}]
[--parameters]
[--query-string]
[--result-format {FullResourcePayloads, ResourceIdOnly}]
[--template-file]
[--template-spec]
[--template-uri]
Примеры
Выполните операцию развертывания What-If в подписке.
az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json
Выполните операцию развертывания What-If в подписке с форматом ResourceIdOnly.
az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --result-format ResourceIdOnly
Выполните операцию развертывания What-If в подписке без красивой печати результата.
az deployment sub what-if --location WestUS --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json --no-pretty-print
Обязательные параметры
Расположение для хранения метаданных операции развертывания What-If.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Разделенный пробелами список типов изменений ресурсов, которые следует исключить из What-If результатов.
Свойство | Значение |
---|---|
Допустимые значения: | Create, Delete, Deploy, Ignore, Modify, NoChange, Unsupported |
Имя развертывания.
Отключите довольно печать для What-If результатов. При установке будет использоваться тип выходного формата.
Параметр отключения запроса отсутствующих параметров для шаблона ARM. Если значение равно true, запрос, требующий от пользователей предоставления отсутствующих параметров, будет игнорироваться. По умолчанию используется значение false.
Свойство | Значение |
---|---|
Default value: | False |
Допустимые значения: | false, true |
Укажите значения параметров развертывания.
Параметры могут быть предоставлены из файла с помощью синтаксиса @{path}
, строки JSON или пар <KEY=VALUE>
. Параметры вычисляются в порядке, поэтому при назначении значения дважды используется последнее значение. Рекомендуется сначала указать файл параметров, а затем переопределить выборочно с помощью синтаксиса KEY=VALUE.
Строка запроса (маркер SAS), используемая с универсальным кодом шаблона в случае связанных шаблонов.
Формат результатов What-If.
Свойство | Значение |
---|---|
Default value: | FullResourcePayloads |
Допустимые значения: | FullResourcePayloads, ResourceIdOnly |
Путь к файлу шаблона или Bicep-файлу.
Идентификатор ресурса спецификации шаблона.
Универсальный код ресурса (URI) в файл шаблона.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |