Spec-Zone.ru › AWS CLI v2

[ aws . opsworks ]

обновить-слой

Описание

Обновляет указанный слой.

Требуемые разрешения : для использования этого действия пользователь IAM должен иметь уровень разрешений «Управление стеком» или прикреплённую политику, которая явно предоставляет разрешения. Дополнительную информацию о разрешениях пользователей см. в разделе Управление разрешениями пользователей .

См. также: Документация API AWS

Синтаксис

  update-layer
--layer-id <value>
[--name <value>]
[--shortname <value>]
[--attributes <value>]
[--cloud-watch-logs-configuration <value>]
[--custom-instance-profile-arn <value>]
[--custom-json <value>]
[--custom-security-group-ids <value>]
[--packages <value>]
[--volume-configurations <value>]
[--enable-auto-healing | --no-enable-auto-healing]
[--auto-assign-elastic-ips | --no-auto-assign-elastic-ips]
[--auto-assign-public-ips | --no-auto-assign-public-ips]
[--custom-recipes <value>]
[--install-updates-on-boot | --no-install-updates-on-boot]
[--use-ebs-optimized-instances | --no-use-ebs-optimized-instances]
[--lifecycle-event-configuration <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]

Параметры

--layer-id (строка)

Идентификатор слоя.

--name (строка)

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

--shortname (строка)

Только для пользовательских слоёв, используйте этот параметр для указания короткого имени слоя, которое используется внутри OpsWorks Stacks и Chef. Короткое имя также используется в качестве имени каталога, где установлены файлы вашего приложения. Оно может содержать не более 32 символов и должно быть в формате: /A[a-z0-9-_.]+Z/.

Встроенные короткие имена слоёв определяются OpsWorks Stacks. Дополнительную информацию см. в справочнике по слоям в руководстве пользователя OpsWorks.

--attributes (массив)

Один или несколько определённых пользователем пар ключ-значение, которые должны быть добавлены к атрибутам стека.

ключ -> (строка)

значение -> (строка)

Краткая запись:

  KeyName1=string,KeyName2=string

Where valid key names are:
  EcsClusterArn
  EnableHaproxyStats
  HaproxyStatsUrl
  HaproxyStatsUser
  HaproxyStatsPassword
  HaproxyHealthCheckUrl
  HaproxyHealthCheckMethod
  MysqlRootPassword
  MysqlRootPasswordUbiquitous
  GangliaUrl
  GangliaUser
  GangliaPassword
  MemcachedMemory
  NodejsVersion
  RubyVersion
  RubygemsVersion
  ManageBundler
  BundlerVersion
  RailsStack
  PassengerVersion
  Jvm
  JvmVersion
  JvmOptions
  JavaAppServer
  JavaAppServerVersion

Формат JSON:

{"EcsClusterArn"|"EnableHaproxyStats"|"HaproxyStatsUrl"|"HaproxyStatsUser"|"HaproxyStatsPassword"|"HaproxyHealthCheckUrl"|"HaproxyHealthCheckMethod"|"MysqlRootPassword"|"MysqlRootPasswordUbiquitous"|"GangliaUrl"|"GangliaUser"|"GangliaPassword"|"MemcachedMemory"|"NodejsVersion"|"RubyVersion"|"RubygemsVersion"|"ManageBundler"|"BundlerVersion"|"RailsStack"|"PassengerVersion"|"Jvm"|"JvmVersion"|"JvmOptions"|"JavaAppServer"|"JavaAppServerVersion": "string"
  ...}

--cloud-watch-logs-configuration (структура)

Указывает параметры конфигурации CloudWatch Logs для слоя. Дополнительную информацию см. в CloudWatchLogsLogStream .

Enabled -> (булево)

Включён ли CloudWatch Logs для слоя.

LogStreams -> (список)

Список параметров конфигурации CloudWatch Logs.

(структура)

Описывает конфигурацию CloudWatch Logs для слоя. Подробную информацию о членах этого типа данных см. в Справочнике по агенту CloudWatch Logs .

LogGroupName -> (строка)

Указывает целевую группу журналов. Группа журналов создаётся автоматически, если она ещё не существует. Имена групп журналов могут быть длиной от 1 до 512 символов. Разрешённые символы включают a-z, A-Z, 0-9, «_» (нижняя черта), «-» (дефис), «/» (косая черта) и «.» (точка).

DatetimeFormat -> (строка)

Указывает, как извлекается метка времени из журналов. Дополнительную информацию см. в Справочнике по агенту CloudWatch Logs .

TimeZone -> (строка)

Указывает часовой пояс меток времени событий журналов.

File -> (строка)

Указывает файлы журналов, которые вы хотите передать в CloudWatch Logs.

File может указывать на определённый файл или несколько файлов (с использованием символов подстановки, таких как /var/log/system.log* ). В CloudWatch Logs передаётся только последний файл, на основе времени изменения файла. Рекомендуется использовать символы подстановки для указания серии файлов одного типа, таких как access_log.2014-06-01-01 , access_log.2014-06-01-02 и так далее, используя шаблон, подобный access_log.* . Не используйте символ подстановки для сопоставления нескольких типов файлов, таких как access_log_80 и access_log_443 . Для указания нескольких различных типов файлов добавьте другой элемент log stream в конфигурационный файл, чтобы каждый тип файла журналов хранился в другой группе журналов.

Архивированные файлы не поддерживаются.

FileFingerprintLines -> (строка)

Указывает диапазон строк для идентификации файла. Допустимые значения — одно число или два числа, разделённые дефисом, например, «1», «2-5». Значение по умолчанию — «1», то есть используется первая строка для расчёта отпечатков. Строки отпечатков не отправляются в CloudWatch Logs, если не все указанные строки доступны.

MultiLineStartPattern -> (строка)

Указывает шаблон для идентификации начала сообщения журнала.

InitialPosition -> (строка)

Указывает, с чего начать чтение данных (начало_файла или конец_файла). По умолчанию — начало_файла. Эта настройка используется только в том случае, если для данного потока журнала нет сохранённого состояния.

Encoding -> (строка)

Указывает кодировку файла журнала для корректного его чтения. Значение по умолчанию — utf_8 . Здесь можно использовать кодировки, поддерживаемые Python codecs.decode().

BufferDuration -> (целое число)

Указывает временную длительность для группировки событий журналов. Минимальное значение — 5000 мс, значение по умолчанию — 5000 мс.

BatchCount -> (целое число)

Указывает максимальное количество событий журналов в пакете, до 10000. Значение по умолчанию — 1000.

BatchSize -> (целое число)

Указывает максимальный размер событий журнала в пакете в байтах, до 1048576 байт. Значение по умолчанию — 32768 байт. Этот размер рассчитывается как сумма всех сообщений событий в UTF-8 плюс 26 байт для каждого события журнала.

Краткая запись:

Enabled=boolean,LogStreams=[{LogGroupName=string,DatetimeFormat=string,TimeZone=string,File=string,FileFingerprintLines=string,MultiLineStartPattern=string,InitialPosition=string,Encoding=string,BufferDuration=integer,BatchCount=integer,BatchSize=integer},{LogGroupName=string,DatetimeFormat=string,TimeZone=string,File=string,FileFingerprintLines=string,MultiLineStartPattern=string,InitialPosition=string,Encoding=string,BufferDuration=integer,BatchCount=integer,BatchSize=integer}]

Формат JSON:

{
  "Enabled": true|false,
  "LogStreams": [
    {
      "LogGroupName": "string",
      "DatetimeFormat": "string",
      "TimeZone": "LOCAL"|"UTC",
      "File": "string",
      "FileFingerprintLines": "string",
      "MultiLineStartPattern": "string",
      "InitialPosition": "start_of_file"|"end_of_file",
      "Encoding": "ascii"|"big5"|"big5hkscs"|"cp037"|"cp424"|"cp437"|"cp500"|"cp720"|"cp737"|"cp775"|"cp850"|"cp852"|"cp855"|"cp856"|"cp857"|"cp858"|"cp860"|"cp861"|"cp862"|"cp863"|"cp864"|"cp865"|"cp866"|"cp869"|"cp874"|"cp875"|"cp932"|"cp949"|"cp950"|"cp1006"|"cp1026"|"cp1140"|"cp1250"|"cp1251"|"cp1252"|"cp1253"|"cp1254"|"cp1255"|"cp1256"|"cp1257"|"cp1258"|"euc_jp"|"euc_jis_2004"|"euc_jisx0213"|"euc_kr"|"gb2312"|"gbk"|"gb18030"|"hz"|"iso2022_jp"|"iso2022_jp_1"|"iso2022_jp_2"|"iso2022_jp_2004"|"iso2022_jp_3"|"iso2022_jp_ext"|"iso2022_kr"|"latin_1"|"iso8859_2"|"iso8859_3"|"iso8859_4"|"iso8859_5"|"iso8859_6"|"iso8859_7"|"iso8859_8"|"iso8859_9"|"iso8859_10"|"iso8859_13"|"iso8859_14"|"iso8859_15"|"iso8859_16"|"johab"|"koi8_r"|"koi8_u"|"mac_cyrillic"|"mac_greek"|"mac_iceland"|"mac_latin2"|"mac_roman"|"mac_turkish"|"ptcp154"|"shift_jis"|"shift_jis_2004"|"shift_jisx0213"|"utf_32"|"utf_32_be"|"utf_32_le"|"utf_16"|"utf_16_be"|"utf_16_le"|"utf_7"|"utf_8"|"utf_8_sig",
      "BufferDuration": integer,
      "BatchCount": integer,
      "BatchSize": integer
    }
    ...
  ]
}

--custom-instance-profile-arn (строка)

ARN профиля IAM, который будет использоваться для всех EC2-инстансов слоя. Дополнительную информацию об ARN IAM см. в разделе Использование идентификаторов .

--custom-json (строка)

Строка в формате JSON, содержащая пользовательскую конфигурацию стека и атрибуты развёртывания, которые необходимо установить на инстансах слоя. Дополнительную информацию см. в Использование пользовательского JSON .

--custom-security-group-ids (список)

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

(строка)

Синтаксис:

"string" "string" ...

--packages (список)

Массив объектов Package, описывающих пакеты слоя.

(строка)

Синтаксис:

"string" "string" ...

--volume-configurations (список)

Объект VolumeConfigurations, описывающий тома Amazon EBS слоя.

(структура)

Описание конфигурации тома Amazon EBS.

MountPoint -> (строка)

Точка монтирования тома. Например, «/dev/sdh».

RaidLevel -> (целое число)

Уровень RAID тома.

NumberOfDisks -> (целое число)

Количество дисков в томе.

Size -> (целое число)

Размер тома.

VolumeType -> (строка)

Тип тома. Дополнительную информацию см. в Типы томов Amazon EBS .

  • standard - Магнитный. Магнитные тома должны иметь минимальный размер 1 ГБ и максимальный размер 1024 ГБ.
  • io1 - Provisioned IOPS (SSD). PIOPS-тома должны иметь минимальный размер 4 ГБ и максимальный размер 16384 ГБ.
  • gp2 - Общего назначения (SSD). Тома общего назначения должны иметь минимальный размер 1 ГБ и максимальный размер 16384 ГБ.
  • st1 - Жесткий диск с высокой пропускной способностью (HDD). Тома HDD с высокой пропускной способностью должны иметь минимальный размер 125 ГБ и максимальный размер 16384 ГБ.
  • sc1 - Холодный HDD. Тома холодного HDD должны иметь минимальный размер 125 ГБ и максимальный размер 16384 ГБ.

Iops -> (целое число)

Для PIOPS-томов — количество IOPS на диск.

Encrypted -> (булево)

Указывает, зашифрован ли том Amazon EBS. Дополнительную информацию см. в Шифрование Amazon EBS .

Краткая запись:

MountPoint=string,RaidLevel=integer,NumberOfDisks=integer,Size=integer,VolumeType=string,Iops=integer,Encrypted=boolean ...

Формат JSON:

[
  {
    "MountPoint": "string",
    "RaidLevel": integer,
    "NumberOfDisks": integer,
    "Size": integer,
    "VolumeType": "string",
    "Iops": integer,
    "Encrypted": true|false
  }
  ...
]

--enable-auto-healing | --no-enable-auto-healing (булево)

Отключить автоматическое исправление для слоя.

--auto-assign-elastic-ips | --no-auto-assign-elastic-ips (булево)

Автоматически назначать Elastic IP-адрес инстансам слоя. Дополнительную информацию см. в Как изменить слой .

--auto-assign-public-ips | --no-auto-assign-public-ips (булево)

Для стеков, работающих в VPC, автоматически назначать общедоступный IP-адрес инстансам слоя. Дополнительную информацию см. в Как изменить слой .

--custom-recipes (структура)

Объект LayerCustomRecipes, который определяет пользовательские рецепты слоя.

Setup -> (список)

Массив имён пользовательских рецептов, которые будут выполняться после события setup.

(строка)

Configure -> (список)

Массив имён пользовательских рецептов, которые будут выполняться после события configure.

(строка)

Deploy -> (список)

Массив имён пользовательских рецептов, которые будут выполняться после события deploy.

(строка)

Undeploy -> (список)

Массив имён пользовательских рецептов, которые будут выполняться после события undeploy.

(строка)

Shutdown -> (список)

Массив имён пользовательских рецептов, которые будут выполняться после события shutdown.

(строка)

Краткая запись:

Setup=string,string,Configure=string,string,Deploy=string,string,Undeploy=string,string,Shutdown=string,string

Формат JSON:

{
  "Setup": ["string", ...],
  "Configure": ["string", ...],
  "Deploy": ["string", ...],
  "Undeploy": ["string", ...],
  "Shutdown": ["string", ...]
}

--install-updates-on-boot | --no-install-updates-on-boot (булево)

Устанавливать обновления операционной системы и пакетов при запуске инстанса. Значение по умолчанию — true . Для управления установкой обновлений установите это значение в false . После этого вам нужно будет обновить инстансы вручную, используя команду CreateDeployment для запуска стека update_dependencies или вручную запустив yum (Amazon Linux) или apt-get (Ubuntu) на инстансах.

Примечание

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

--use-ebs-optimized-instances | --no-use-ebs-optimized-instances (булево)

Использовать оптимизированные для Amazon EBS инстансы.

--lifecycle-event-configuration (структура)

Shutdown -> (структура)

Объект ShutdownEventConfiguration, который определяет конфигурацию события Shutdown.

ExecutionTimeout -> (целое число)

Время в секундах, которое OpsWorks Stacks ожидает после запуска события Shutdown перед выключением инстанса.

DelayUntilElbConnectionsDrained -> (булево)

Включить отключение соединений Elastic Load Balancing. Дополнительную информацию см. в разделе Отключение соединений

Краткая запись:

Shutdown={ExecutionTimeout=integer,DelayUntilElbConnectionsDrained=boolean}

Формат JSON:

{
  "Shutdown": {
    "ExecutionTimeout": integer,
    "DelayUntilElbConnectionsDrained": true|false
  }
}

--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-auto-prompt (логическое значение)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. См. руководство по началу работы в Руководстве пользователя AWS CLI для получения дополнительной информации.

Если не указано иное, все примеры используют правила цитирования, аналогичные unix-системе. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для обновления слоя

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

aws opsworks --region us-east-1 update-layer --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4 --use-ebs-optimized-instances

Вывод: Нет.

Дополнительная информация

Для получения дополнительной информации см. Изменение конфигурации слоя OpsWorks в Руководстве пользователя AWS OpsWorks.

Вывод

Нет

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API