[ aws . marketplace-catalog ]
start-change-set
Описание
Позволяет запросить изменения для ваших сущностей. В рамках одного набора изменений вы не можете несколько раз инициировать изменения одного типа для одной и той же сущности. Кроме того, когда выполняется набор изменений, все сущности, на которые направлены различные изменения, блокируются до завершения набора изменений (успешно, отменено или неудачно). Если вы попытаетесь запустить набор изменений, содержащий изменения для сущности, которая уже заблокирована, вы получите ошибку.
Например, вы не можете запустить изменения, описанные в примере ниже в этой теме, потому что они содержат два изменения одного типа ( ) для одной и той же сущности ( ).
Дополнительную информацию о работе с наборами изменений см. в разделе Работа с наборами изменений . Информацию о типах изменений для продуктов с одним AMI см. в разделе Работа с продуктами с одним AMI . Также дополнительную информацию о типах изменений, доступных для продуктов на основе контейнеров, см. в разделе Работа с продуктами на основе контейнеров .
См. также: Документацию API AWS
Использует значения типа документа. Типы документов следуют модели данных JSON, где допустимые значения: строки, числа, булевы значения, null, массивы и объекты. Для ввода команд, параметров и вложенных параметров, помеченных типом , необходимо предоставить JSON. Краткая форма не поддерживает типы документов.
Синтаксис
start-change-set
--catalog <value>
--change-set <value>
[--change-set-name <value>]
[--client-request-token <value>]
[--change-set-tags <value>]
[--intent <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]
Параметры
--catalog (строка)
AWSMarketplace
--change-set (список)
Массив объектов change .
(структура)
Объект, содержащий ChangeType , Details и Entity .
ChangeType -> (строка)
EntityType, предоставленного в области действия изменения. Дополнительную информацию о типах изменений, доступных для продуктов с одним AMI, см. в разделе Работа с продуктами с одним AMI . Также дополнительную информацию о типах изменений, доступных для продуктов на основе контейнеров, см. в разделе Работа с продуктами на основе контейнеров .Entity -> (структура)
Сущность, подлежащая изменению.
Type -> (строка)
Identifier -> (строка)
EntityTags -> (список)
Теги, связанные с изменением.
(структура)
Список объектов, указывающих имя и значение каждого ключа.
Key -> (строка)
Value -> (строка)
Details -> (строка)
DetailsDocument -> (документ)
ChangeType деталей. Вы можете использовать либо Details, либо DetailsDocument, но не оба.ChangeName -> (строка)
Краткая форма:
ChangeType=string,Entity={Type=string,Identifier=string},EntityTags=[{Key=string,Value=string},{Key=string,Value=string}],Details=string,ChangeName=string ...
Синтаксис JSON:
[
{
"ChangeType": "string",
"Entity": {
"Type": "string",
"Identifier": "string"
},
"EntityTags": [
{
"Key": "string",
"Value": "string"
}
...
],
"Details": "string",
"DetailsDocument": {...},
"ChangeName": "string"
}
...
]
--change-set-name (строка)
--client-request-token (строка)
--change-set-tags (список)
Список объектов, указывающих имя и значение каждого ключа для свойства ChangeSetTags .
(структура)
Список объектов, указывающих имя и значение каждого ключа.
Key -> (строка)
Value -> (строка)
Краткая форма:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--intent (строка)
Намерение, связанное с запросом. По умолчанию APPLY . Чтобы протестировать запрос перед применением изменений к сущностям, используйте VALIDATE . Эта функция в настоящее время доступна для добавления версий к продуктам с одним AMI. Дополнительную информацию см. в разделе Добавление новой версии .
Возможные значения:
VALIDATEAPPLY
--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
- text
- таблица
- 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.
Вывод
ChangeSetId -> (строка)
ChangeSetArn -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.