describe-layers

Описание

Запрашивает описание одного или нескольких слоев в указанном стеке.

Примечание

Этот вызов принимает только один параметр, идентифицирующий ресурс.

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

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

Синтаксис

  describe-layers
[--stack-id <value>]
[--layer-ids <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]

Параметры

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

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

--layer-ids (список)

Массив идентификаторов слоев, определяющих слои, которые нужно описать. Если вы опустите этот параметр, DescribeLayers возвращает описание каждого слоя в указанном стеке.

(строка)

Синтаксис:

"string" "string" ...

--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.

Для описания слоёв стека

Следующая команда describe-layers описывает слои в указанном стеке:

aws opsworks --region us-east-1 describe-layers --stack-id 38ee91e2-abdc-4208-a107-0b7168b3cc7a

Вывод:

{
  "Layers": [
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Type": "db-master",
          "DefaultSecurityGroupNames": [
              "AWS-OpsWorks-DB-Master-Server"
          ],
          "Name": "MySQL",
          "Packages": [],
          "DefaultRecipes": {
              "Undeploy": [],
              "Setup": [
                  "opsworks_initial_setup",
                  "ssh_host_keys",
                  "ssh_users",
                  "mysql::client",
                  "dependencies",
                  "ebs",
                  "opsworks_ganglia::client",
                  "mysql::server",
                  "dependencies",
                  "deploy::mysql"
              ],
              "Configure": [
                  "opsworks_ganglia::configure-client",
                  "ssh_users",
                  "agent_version",
                  "deploy::mysql"
              ],
              "Shutdown": [
                  "opsworks_shutdown::default",
                  "mysql::stop"
              ],
              "Deploy": [
                  "deploy::default",
                  "deploy::mysql"
              ]
          },
          "CustomRecipes": {
              "Undeploy": [],
              "Setup": [],
              "Configure": [],
              "Shutdown": [],
              "Deploy": []
          },
          "EnableAutoHealing": false,
          "LayerId": "41a20847-d594-4325-8447-171821916b73",
          "Attributes": {
              "MysqlRootPasswordUbiquitous": "true",
              "RubygemsVersion": null,
              "RailsStack": null,
              "HaproxyHealthCheckMethod": null,
              "RubyVersion": null,
              "BundlerVersion": null,
              "HaproxyStatsPassword": null,
              "PassengerVersion": null,
              "MemcachedMemory": null,
              "EnableHaproxyStats": null,
              "ManageBundler": null,
              "NodejsVersion": null,
              "HaproxyHealthCheckUrl": null,
              "MysqlRootPassword": "*****FILTERED*****",
              "GangliaPassword": null,
              "GangliaUser": null,
              "HaproxyStatsUrl": null,
              "GangliaUrl": null,
              "HaproxyStatsUser": null
          },
          "Shortname": "db-master",
          "AutoAssignElasticIps": false,
          "CustomSecurityGroupIds": [],
          "CreatedAt": "2013-07-25T18:11:19+00:00",
          "VolumeConfigurations": [
              {
                  "MountPoint": "/vol/mysql",
                  "Size": 10,
                  "NumberOfDisks": 1
              }
          ]
      },
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Type": "custom",
          "DefaultSecurityGroupNames": [
              "AWS-OpsWorks-Custom-Server"
          ],
          "Name": "TomCustom",
          "Packages": [],
          "DefaultRecipes": {
              "Undeploy": [],
              "Setup": [
                  "opsworks_initial_setup",
                  "ssh_host_keys",
                  "ssh_users",
                  "mysql::client",
                  "dependencies",
                  "ebs",
                  "opsworks_ganglia::client"
              ],
              "Configure": [
                  "opsworks_ganglia::configure-client",
                  "ssh_users",
                  "agent_version"
              ],
              "Shutdown": [
                  "opsworks_shutdown::default"
              ],
              "Deploy": [
                  "deploy::default"
              ]
          },
          "CustomRecipes": {
              "Undeploy": [],
              "Setup": [
                  "tomcat::setup"
              ],
              "Configure": [
                  "tomcat::configure"
              ],
              "Shutdown": [],
              "Deploy": [
                  "tomcat::deploy"
              ]
          },
          "EnableAutoHealing": true,
          "LayerId": "e6cbcd29-d223-40fc-8243-2eb213377440",
          "Attributes": {
              "MysqlRootPasswordUbiquitous": null,
              "RubygemsVersion": null,
              "RailsStack": null,
              "HaproxyHealthCheckMethod": null,
              "RubyVersion": null,
              "BundlerVersion": null,
              "HaproxyStatsPassword": null,
              "PassengerVersion": null,
              "MemcachedMemory": null,
              "EnableHaproxyStats": null,
              "ManageBundler": null,
              "NodejsVersion": null,
              "HaproxyHealthCheckUrl": null,
              "MysqlRootPassword": null,
              "GangliaPassword": null,
              "GangliaUser": null,
              "HaproxyStatsUrl": null,
              "GangliaUrl": null,
              "HaproxyStatsUser": null
          },
          "Shortname": "tomcustom",
          "AutoAssignElasticIps": false,
          "CustomSecurityGroupIds": [],
          "CreatedAt": "2013-07-25T18:12:53+00:00",
          "VolumeConfigurations": []
      }
  ]
}

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

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

Вывод

Слои -> (список)

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

(структура)

Описание слоя.

Arn -> (строка)

Amazon Resource Number (ARN) слоя.

StackId -> (строка)

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

LayerId -> (строка)

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

Type -> (строка)

Тип слоя.

Name -> (строка)

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

Shortname -> (строка)

Короткое имя слоя.

Attributes -> (карта)

Атрибуты слоя.

Для атрибутов HaproxyStatsPassword, MysqlRootPassword и GangliaPassword OpsWorks Stacks возвращает *****FILTERED***** вместо фактического значения.

Для слоя ECS Cluster, OpsWorks Stacks устанавливает атрибут EcsClusterArn в ARN кластера.

key -> (строка)

value -> (строка)

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

Настройки конфигурации Amazon CloudWatch Logs для слоя.

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 байт для каждого события журнала.

CustomInstanceProfileArn -> (строка)

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

CustomJson -> (строка)

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

CustomSecurityGroupIds -> (список)

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

(строка)

DefaultSecurityGroupNames -> (список)

Массив, содержащий имена групп безопасности слоя.

(строка)

Packages -> (список)

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

(строка)

VolumeConfigurations -> (список)

Объект 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 - Cold HDD. Тома Cold HDD должны иметь минимальный размер 125 ГБ и максимальный размер 16384 ГБ.

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

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

Encrypted -> (булево)

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

EnableAutoHealing -> (булево)

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

AutoAssignElasticIps -> (булево)

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

AutoAssignPublicIps -> (булево)

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

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

OpsWorks Stacks поддерживает пять событий жизненного цикла: setup, configuration, deploy, undeploy и shutdown. Для каждого слоя OpsWorks Stacks выполняет набор стандартных рецептов для каждого события. Вы также можете предоставить пользовательские рецепты для любых или всех слоёв и событий. OpsWorks Stacks выполняет пользовательские рецепты событий после стандартных рецептов. LayerCustomRecipes указывает пользовательские рецепты для конкретного слоя, которые необходимо выполнить в ответ на каждое из пяти событий.

Для указания рецепта используйте имя каталога кулинарной книги в репозитории, за которым следуют два двоеточия и имя рецепта, которое является именем файла рецепта без расширения .rb. Например, phpapp2::dbsetup указывает рецепт dbsetup.rb в папке phpapp2 репозитория.

Setup -> (список)

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

(строка)

Configure -> (список)

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

(строка)

Deploy -> (список)

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

(строка)

Undeploy -> (список)

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

(строка)

Shutdown -> (список)

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

(строка)

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

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

Setup -> (список)

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

(строка)

Configure -> (список)

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

(строка)

Deploy -> (список)

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

(строка)

Undeploy -> (список)

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

(строка)

Shutdown -> (список)

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

(строка)

CreatedAt -> (строка)

Дата создания слоя.

InstallUpdatesOnBoot -> (булево)

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

Примечание

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

UseEbsOptimizedInstances -> (булево)

Используются ли Amazon EBS-оптимизированные экземпляры?

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

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

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

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

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

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

DelayUntilElbConnectionsDrained -> (булево)

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

END_OF_DOCUMENT_MARKER