[ aws . cloudformation ]
describe-stack-resources
Описание
Возвращает описания ресурсов Amazon Web Services для работающих и удалённых стеков. Если задан StackName, возвращаются все связанные ресурсы, являющиеся частью стека. Если задан PhysicalResourceId, возвращаются связанные ресурсы стека, к которому принадлежит ресурс.
Примечание
Возвращаются только первые 100 ресурсов. Если ваш стек содержит больше ресурсов, используйтеListStackResources.Для удалённых стеков, DescribeStackResources возвращает информацию о ресурсах в течение 90 дней после удаления стека.
Вы должны указать либо StackName, либо PhysicalResourceId, но не оба. Кроме того, вы можете указать LogicalResourceId для фильтрации результатов. Для получения дополнительной информации о ресурсах, LogicalResourceId и PhysicalResourceId, см. руководство пользователя CloudFormation.
Примечание
ВозвращаетсяValidationError, если вы укажете и StackName, и PhysicalResourceId в одном запросе.См. также: документацию API AWS
Синтаксис
describe-stack-resources
[--stack-name <value>]
[--logical-resource-id <value>]
[--physical-resource-id <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-name (строка)
Имя или уникальный идентификатор стека, связанного со стеком, которые не всегда взаимозаменяемы:
- Работающие стеки: Вы можете указать либо имя стека, либо его уникальный идентификатор.
- Удалённые стеки: Вы должны указать уникальный идентификатор стека.
Обязательный параметр: Условный. Если вы не указываете StackName, вы должны указать PhysicalResourceId.
--logical-resource-id (строка)
--physical-resource-id (строка)
Имя или уникальный идентификатор, соответствующий физическому идентификатору экземпляра поддерживаемого CloudFormation ресурса.
Например, для экземпляра Amazon Elastic Compute Cloud (EC2) PhysicalResourceId соответствует InstanceId. Вы можете передать EC2 InstanceId в DescribeStackResources, чтобы определить, к какому стеку принадлежит экземпляр и какие другие ресурсы являются частью стека.
Обязательный параметр: Условный. Если вы не указываете PhysicalResourceId, вы должны указать StackName.
--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
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать конкретный профиль из файла учетных данных.
--region (строка)
Используемый регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--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.
Получение информации о ресурсе стека
Следующий describe-stack-resources пример отображает подробности ресурсов в указанном стеке.
aws cloudformation describe-stack-resources \
--stack-name my-stack
Вывод:
{
"StackResources": [
{
"StackName": "my-stack",
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
"LogicalResourceId": "bucket",
"PhysicalResourceId": "my-stack-bucket-1vc62xmplgguf",
"ResourceType": "AWS::S3::Bucket",
"Timestamp": "2019-10-02T04:34:11.345Z",
"ResourceStatus": "CREATE_COMPLETE",
"DriftInformation": {
"StackResourceDriftStatus": "IN_SYNC"
}
},
{
"StackName": "my-stack",
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
"LogicalResourceId": "function",
"PhysicalResourceId": "my-function-SEZV4XMPL4S5",
"ResourceType": "AWS::Lambda::Function",
"Timestamp": "2019-10-02T05:34:27.989Z",
"ResourceStatus": "UPDATE_COMPLETE",
"DriftInformation": {
"StackResourceDriftStatus": "IN_SYNC"
}
},
{
"StackName": "my-stack",
"StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
"LogicalResourceId": "functionRole",
"PhysicalResourceId": "my-functionRole-HIZXMPLEOM9E",
"ResourceType": "AWS::IAM::Role",
"Timestamp": "2019-10-02T04:34:06.350Z",
"ResourceStatus": "CREATE_COMPLETE",
"DriftInformation": {
"StackResourceDriftStatus": "IN_SYNC"
}
}
]
}
Вывод
StackResources -> (список)
Список структур StackResource.
(структура)
Тип данных StackResource.
StackName -> (строка)
StackId -> (строка)
LogicalResourceId -> (строка)
PhysicalResourceId -> (строка)
ResourceType -> (строка)
Timestamp -> (метка времени)
ResourceStatus -> (строка)
ResourceStatusReason -> (строка)
Description -> (строка)
DriftInformation -> (структура)
Информация о том, отличается или нет фактическая конфигурация ресурса от ожидаемой конфигурации, как определено в шаблоне стека и любых значениях, указанных в параметрах шаблона. Дополнительную информацию см. в статье Обнаружение необработанных изменений конфигурации стеков и ресурсов с помощью обнаружения дрейфа.
StackResourceDriftStatus -> (строка)
Статус фактической конфигурации ресурса по сравнению с ожидаемой конфигурацией
-
DELETED: Ресурс отличается от ожидаемой конфигурации, так как был удален. -
MODIFIED: Ресурс отличается от ожидаемой конфигурации. -
NOT_CHECKED: CloudFormation еще не проверил, отличается ли ресурс от ожидаемой конфигурации. Любые ресурсы, которые в настоящее время не поддерживают обнаружение дрейфа, имеют статусNOT_CHECKED. Дополнительную информацию см. в разделе Поддержка типов ресурсов для импорта и обнаружения дрейфа. -
IN_SYNC: Фактическая конфигурация ресурса соответствует ожидаемой конфигурации.
LastCheckTimestamp -> (метка времени)
ModuleInfo -> (структура)
Содержит информацию о модуле, из которого был создан ресурс, если ресурс был создан из модуля, включенного в шаблон стека.
TypeHierarchy -> (строка)
Конкатенированный список типа или типов модуля, содержащего ресурс. Типы модулей перечисляются, начиная с самого вложенного модуля и разделены /.
В следующем примере ресурс был создан из модуля типа AWS::First::Example::MODULE, вложенного в родительский модуль типа AWS::Second::Example::MODULE.
AWS::First::Example::MODULE/AWS::Second::Example::MODULELogicalIdHierarchy -> (строка)
Конкатенированный список логических идентификаторов модуля или модулей, содержащих ресурс. Модули перечисляются, начиная с самого внутреннего вложенного модуля, и разделены /.
В следующем примере ресурс был создан из модуля moduleA, вложенного в родительский модуль moduleB.
moduleA/moduleBДополнительную информацию см. в разделе Ссылка на модульные ресурсы в шаблонах CloudFormation в руководстве пользователя CloudFormation.
© Copyright 2025, Amazon Web Services. Created using Sphinx.
|
|