[ aws . cloudformation ]
validate-template
Описание
Проверяет указанную шаблон. CloudFormation сначала проверяет, является ли шаблон допустимым JSON. Если нет, CloudFormation проверяет, является ли шаблон допустимым YAML. Если оба этих проверки не пройдут, CloudFormation возвращает ошибку проверки шаблона.
См. также: Документация API AWS
Синтаксис
validate-template
[--template-body <value>]
[--template-url <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--template-body (строка)
Структура, содержащая тело шаблона с минимальной длиной 1 байт и максимальной длиной 51 200 байт.
Условие: Вы должны передать TemplateURL или TemplateBody . Если оба переданы, используется только TemplateBody.
--template-url (строка)
URL файла, содержащего тело шаблона. URL должен указывать на шаблон (максимальный размер: 1 МБ), который находится в ведре Amazon S3 или документе Systems Manager. Путь к ведру Amazon S3 должен начинаться с https:// .
Условие: Вы должны передать TemplateURL или TemplateBody . Если оба переданы, используется только TemplateBody.
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения из JSON. Невозможно передавать произвольные двоичные значения, используя предоставленное JSON-значение, так как строка будет взята дословно. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-каркас в стандартный вывод без отправки запроса к API. Если предоставлено без значения или со значением input, выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, при предоставлении yaml-input, он выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. При предоставлении значения output, он проверяет входные данные команды и возвращает пример JSON-выхода для этой команды. Сгенерированный JSON-каркас нестабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-каркасе.
Глобальные параметры
--debug (логическое значение)
Включить отладочную запись в журнал.
--endpoint-url (строка)
Переопределить URL по умолчанию команды указанным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при взаимодействии с сервисами AWS. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.
--no-paginate (логическое значение)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла ключей.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить вывод цвета.
- вкл
- выкл
- авто
--no-sign-request (логическое значение)
Не подписывать запросы. Ключи не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Набор сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (строка)
Стиль форматирования для двоичных блоков. Формат по умолчанию - base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного параметра cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить вывод пейджера CLI.
--cli-auto-prompt (логическое значение)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматический запрос параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров, вы должны иметь установленный и настроенный AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.
Если не указано иное, во всех примерах используются правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Для проверки шаблона AWS CloudFormation
Следующая validate-template команда проверяет шаблон sampletemplate.json:
aws cloudformation validate-template --template-body file://sampletemplate.json
Вывод:
{
"Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.",
"Parameters": [],
"Capabilities": []
}
Для получения дополнительной информации см. Работа с шаблонами AWS CloudFormation в руководстве пользователя AWS CloudFormation.
Вывод
Параметры -> (список)
Список структур TemplateParameter.
(структура)
Тип данных TemplateParameter.
ParameterKey -> (строка)
DefaultValue -> (строка)
NoEcho -> (логическое значение)
Description -> (строка)
Description -> (строка)
Capabilities -> (список)
Функциональные возможности, обнаруженные в шаблоне. Если шаблон содержит ресурсы IAM, необходимо указать значение CAPABILITY_IAM или CAPABILITY_NAMED_IAM для этого параметра при использовании действий CreateStack или UpdateStack со своим шаблоном; в противном случае эти действия возвращают ошибку InsufficientCapabilities.
Дополнительную информацию см. в разделе Признание ресурсов IAM в шаблонах CloudFormation.
(строка)
CapabilitiesReason -> (строка)
Capabilities.DeclaredTransforms -> (список)
Список преобразований, объявленных в шаблоне.
(строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.