get-instances
Описание
Возвращает информацию обо всех виртуальных серверах Amazon Lightsail, или инстансах.
См. также: Документацию API AWS
get-instances является постраничной операцией. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничную обработку, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной обработкой, аргумент --query должен извлекать данные из результатов следующих выражений запроса: instances
Синтаксис
get-instances
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--max-items <value>]
[--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]
Параметры
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения перекроют значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного JSON-значения, так как строка будет интерпретироваться буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Токен, указывающий, где начать постраничную обработку. Это NextToken из ранее укороченного ответа.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.
--max-items (целое число)
Общее количество элементов, которые нужно вернуть в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничной обработки необходимо указать значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.
--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.
Для получения информации обо всех инстансах
Следующий get-instances пример отображает подробности обо всех инстансах в настроенном AWS-регионе.
aws lightsail get-instances
Вывод:
{
"instances": [
{
"name": "Windows_Server_2022-1",
"arn": "arn:aws:lightsail:us-west-2:111122223333:Instance/0f44fbb9-8f55-4e47-a25e-EXAMPLE04763",
"supportCode": "62EXAMPLE362/i-0bEXAMPLE71a686b9",
"createdAt": 1571332358.665,
"location": {
"availabilityZone": "us-west-2a",
"regionName": "us-west-2"
},
"resourceType": "Instance",
"tags": [],
"blueprintId": "windows_server_2022",
"blueprintName": "Windows Server 2022",
"bundleId": "large_win_3_0",
"isStaticIp": false,
"privateIpAddress": "192.0.2.0",
"publicIpAddress": "192.0.2.0",
"hardware": {
"cpuCount": 1,
"disks": [
{
"createdAt": 1571332358.665,
"sizeInGb": 160,
"isSystemDisk": true,
"iops": 180,
"path": "/dev/sda1",
"attachedTo": "Windows_Server_2022-1",
"attachmentState": "attached"
},
{
"name": "my-disk-for-windows-server",
"arn": "arn:aws:lightsail:us-west-2:111122223333:Disk/4123a81c-484c-49ea-afea-5EXAMPLEda87",
"supportCode": "6EXAMPLE3362/vol-0EXAMPLEb2b99ca3d",
"createdAt": 1571355063.494,
"location": {
"availabilityZone": "us-west-2a",
"regionName": "us-west-2"
},
"resourceType": "Disk",
"tags": [],
"sizeInGb": 128,
"isSystemDisk": false,
"iops": 384,
"path": "/dev/xvdf",
"state": "in-use",
"attachedTo": "Windows_Server_2022-1",
"isAttached": true,
"attachmentState": "attached"
}
],
"ramSizeInGb": 8.0
},
"networking": {
"monthlyTransfer": {
"gbPerMonthAllocated": 3072
},
"ports": [
{
"fromPort": 80,
"toPort": 80,
"protocol": "tcp",
"accessFrom": "Anywhere (0.0.0.0/0)",
"accessType": "public",
"commonName": "",
"accessDirection": "inbound"
},
{
"fromPort": 22,
"toPort": 22,
"protocol": "tcp",
"accessFrom": "Anywhere (0.0.0.0/0)",
"accessType": "public",
"commonName": "",
"accessDirection": "inbound"
},
{
"fromPort": 3389,
"toPort": 3389,
"protocol": "tcp",
"accessFrom": "Anywhere (0.0.0.0/0)",
"accessType": "public",
"commonName": "",
"accessDirection": "inbound"
}
]
},
"state": {
"code": 16,
"name": "running"
},
"username": "Administrator",
"sshKeyName": "LightsailDefaultKeyPair"
},
{
"name": "MEAN-1",
"arn": "arn:aws:lightsail:us-west-2:111122223333:Instance/bd470fc5-a68b-44c5-8dbc-8EXAMPLEbada",
"supportCode": "6EXAMPLE3362/i-0EXAMPLEa407c97d3",
"createdAt": 1570635023.124,
"location": {
"availabilityZone": "us-west-2a",
"regionName": "us-west-2"
},
"resourceType": "Instance",
"tags": [],
"blueprintId": "mean",
"blueprintName": "MEAN",
"bundleId": "medium_3_0",
"isStaticIp": false,
"privateIpAddress": "192.0.2.0",
"publicIpAddress": "192.0.2.0",
"hardware": {
"cpuCount": 2,
"disks": [
{
"name": "Disk-1",
"arn": "arn:aws:lightsail:us-west-2:111122223333:Disk/c21cfb0a-07f2-44ae-9a23-bEXAMPLE8096",
"supportCode": "6EXAMPLE3362/vol-0EXAMPLEf2f88b32f",
"createdAt": 1566585439.587,
"location": {
"availabilityZone": "us-west-2a",
"regionName": "us-west-2"
},
"resourceType": "Disk",
"tags": [
{
"key": "test"
}
],
"sizeInGb": 8,
"isSystemDisk": false,
"iops": 240,
"path": "/dev/xvdf",
"state": "in-use",
"attachedTo": "MEAN-1",
"isAttached": true,
"attachmentState": "attached"
},
{
"createdAt": 1570635023.124,
"sizeInGb": 80,
"isSystemDisk": true,
"iops": 240,
"path": "/dev/sda1",
"attachedTo": "MEAN-1",
"attachmentState": "attached"
}
],
"ramSizeInGb": 4.0
},
"networking": {
"monthlyTransfer": {
"gbPerMonthAllocated": 4096
},
"ports": [
{
"fromPort": 80,
"toPort": 80,
"protocol": "tcp",
"accessFrom": "Anywhere (0.0.0.0/0)",
"accessType": "public",
"commonName": "",
"accessDirection": "inbound"
},
{
"fromPort": 22,
"toPort": 22,
"protocol": "tcp",
"accessFrom": "Anywhere (0.0.0.0/0)",
"accessType": "public",
"commonName": "",
"accessDirection": "inbound"
},
{
"fromPort": 443,
"toPort": 443,
"protocol": "tcp",
"accessFrom": "Anywhere (0.0.0.0/0)",
"accessType": "public",
"commonName": "",
"accessDirection": "inbound"
}
]
},
"state": {
"code": 16,
"name": "running"
},
"username": "bitnami",
"sshKeyName": "MyTestKey"
}
]
}
Вывод
instances -> (список)
Массив пар ключ-значение, содержащих информацию о ваших экземплярах.
(структура)
Описание экземпляра (виртуального частного сервера).
name -> (строка)
Amazon_Linux_2023-1).arn -> (строка)
arn:aws:lightsail:us-east-2:123456789101:Instance/244ad76f-8aad-4741-809f-12345EXAMPLE).supportCode -> (строка)
createdAt -> (метка времени)
1479734909.17) в формате Unix.location -> (структура)
Название региона и зоны доступности, в которой расположен экземпляр.
availabilityZone -> (строка)
us-east-2a (регистрозависимый).regionName -> (строка)
resourceType -> (строка)
Instance).tags -> (список)
Ключи тегов и необязательные значения для ресурса. Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.
(структура)
Описание ключа тега и необязательного значения, назначенного ресурсу Amazon Lightsail.
Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.
key -> (строка)
Ключ тега.
Ограничения: Ключи тегов принимают максимум 128 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @
value -> (строка)
Значение тега.
Ограничения: Значения тегов принимают максимум 256 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @
blueprintId -> (строка)
amazon_linux_2023).blueprintName -> (строка)
Amazon Linux 2023).bundleId -> (строка)
micro_x_x).addOns -> (список)
Массив объектов, представляющих плагины, включенные в экземпляр.
(структура)
Описание плагина, включенного в ресурс Amazon Lightsail.
name -> (строка)
status -> (строка)
snapshotTimeOfDay -> (строка)
Ежедневное время создания автоматической резервной копии.
Время показано в формате HH:00 и в формате Coordinated Universal Time (UTC).
Резервная копия автоматически создается между указанным временем и через 45 минут после него.
nextSnapshotTimeOfDay -> (строка)
Следующее ежедневное время создания автоматической резервной копии.
Время показано в формате HH:00 и в формате Coordinated Universal Time (UTC).
Резервная копия автоматически создается между указанным временем и через 45 минут после него.
threshold -> (строка)
Пороговое значение триггера действия.
Предупреждение
Этот плагин применим только к ресурсам Lightsail for Research.duration -> (строка)
Время простоя в минутах, после которого ваше виртуальное устройство автоматически остановится.
Предупреждение
Этот плагин применим только к ресурсам Lightsail for Research.isStaticIp -> (логическое)
privateIpAddress -> (строка)
publicIpAddress -> (строка)
ipv6Addresses -> (список)
IP-адреса IPv6 экземпляра.
(строка)
ipAddressType -> (строка)
Тип IP-адреса экземпляра.
Возможные значения — ipv4 для только IPv4, ipv6 для только IPv6 и dualstack для IPv4 и IPv6.
hardware -> (структура)
Размер vCPU и объем оперативной памяти для экземпляра.
cpuCount -> (целое число)
disks -> (список)
Диски, подключенные к экземпляру.
(структура)
Описание диска блочного хранения.
name -> (строка)
arn -> (строка)
supportCode -> (строка)
createdAt -> (метка времени)
location -> (структура)
AWS-регион и зона доступности, в которой находится диск.
availabilityZone -> (строка)
us-east-2a (регистрозависимый).regionName -> (строка)
resourceType -> (строка)
Disk).tags -> (список)
Ключи тегов и необязательные значения для ресурса. Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.
(структура)
Описание ключа тега и необязательного значения, назначенного ресурсу Amazon Lightsail.
Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.
key -> (строка)
Ключ тега.
Ограничения: Ключи тегов принимают максимум 128 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @
value -> (строка)
Значение тега.
Ограничения: Значения тегов принимают максимум 256 символов, цифр, пробелов в UTF-8 или следующие символы: + - = . _ : / @
addOns -> (список)
Массив объектов, представляющих плагины, включенные в диск.
(структура)
Описание плагина, включенного в ресурс Amazon Lightsail.
name -> (строка)
status -> (строка)
snapshotTimeOfDay -> (строка)
Ежедневное время создания автоматической резервной копии.
Время показано в формате HH:00 и в формате Coordinated Universal Time (UTC).
Резервная копия автоматически создается между указанным временем и через 45 минут после него.
nextSnapshotTimeOfDay -> (строка)
Следующее ежедневное время создания автоматической резервной копии.
Время показано в формате HH:00 и в формате Coordinated Universal Time (UTC).
Резервная копия автоматически создается между указанным временем и через 45 минут после него.
threshold -> (строка)
Пороговое значение триггера действия.
Предупреждение
Этот плагин применим только к ресурсам Lightsail for Research.duration -> (строка)
Время простоя в минутах, после которого ваше виртуальное устройство автоматически остановится.
Предупреждение
Этот плагин применим только к ресурсам Lightsail for Research.sizeInGb -> (целое число)
isSystemDisk -> (логическое)
iops -> (целое число)
path -> (строка)
state -> (строка)
attachedTo -> (строка)
isAttached -> (логическое)
attachmentState -> (строка)
(Устаревшее) Состояние подключения диска.
Примечание
В версиях до 14 ноября 2017 года этот параметр возвращалattached для системных дисков в ответе API. Сейчас он устарел, но по-прежнему включен в ответ. Используйте isAttached вместо него.gbInUse -> (целое число)
(Устаревшее) Количество используемых ГБ диска.
Примечание
В версиях до 14 ноября 2017 года этот параметр не был включен в ответ API. Сейчас он устарел.autoMountStatus -> (строка)
Состояние автоматического подключения диска хранения к виртуальному компьютеру.
Предупреждение
Этот параметр применим только к ресурсам Lightsail for Research.ramSizeInGb -> (вещественное число)
1.0).networking -> (структура)
Информация о публичных портах и ежемесячных скоростях передачи данных для экземпляра.
monthlyTransfer -> (структура)
Объем данных в ГБ, выделенных для ежемесячной передачи данных.
gbPerMonthAllocated -> (целое число)
ports -> (список)
Массив пар ключ-значение, содержащих информацию о портах на экземпляре.
(структура)
Описание информации о портах для экземпляра Amazon Lightsail.
fromPort -> (целое число)
Первый порт в диапазоне открытых портов на экземпляре.
Разрешенные порты:
- TCP и UDP -
0до65535 - ICMP - Тип ICMP для адресов IPv4. Например, укажите
8в качествеfromPort(тип ICMP), и-1в качествеtoPort(код ICMP), чтобы включить ICMP Ping. Для получения дополнительной информации см. Управляющие сообщения на Wikipedia . - ICMPv6 - Тип ICMP для адресов IPv6. Например, укажите
128в качествеfromPort(тип ICMPv6), и0в качествеtoPort(код ICMPv6). Для получения дополнительной информации см. Протокол управления сообщениями Интернета для IPv6 .
toPort -> (целое число)
Последний порт в диапазоне открытых портов на экземпляре.
Разрешенные порты:
- TCP и UDP -
0до65535 - ICMP - Код ICMP для адресов IPv4. Например, укажите
8в качествеfromPort(тип ICMP), и-1в качествеtoPort(код ICMP), чтобы включить ICMP Ping. Для получения дополнительной информации см. Управляющие сообщения на Wikipedia . - ICMPv6 - Код ICMP для адресов IPv6. Например, укажите
128в качествеfromPort(тип ICMPv6), и0в качествеtoPort(код ICMPv6). Для получения дополнительной информации см. Протокол управления сообщениями Интернета для IPv6 .
protocol -> (строка)
Название IP-протокола.
Название может быть одним из следующих:
-
tcp- Протокол управления передачей (TCP) обеспечивает надежную, упорядоченную и проверенную на ошибки доставку потоковых данных между приложениями, работающими на хостах, взаимодействующих через IP-сеть. Если ваше приложение не требует надежной службы потоковой передачи данных, используйте UDP. -
all- Все типы протоколов транспортного уровня. Для более общей информации см. Транспортный уровень на Wikipedia . -
udp- С помощью Протокола пользовательских датаграмм (UDP) компьютерные приложения могут отправлять сообщения (или датаграммы) другим хостам в сети Интернет-протокола (IP). Предварительные коммуникации не требуются для настройки каналов передачи или путей данных. Приложения, которым не нужна надежная служба потоковой передачи данных, могут использовать UDP, который предоставляет беспроводную службу датаграмм, делающую упор на снижение задержки вместо надежности. Если вам нужна надежная служба потоковой передачи данных, используйте TCP. -
icmp- Протокол управления сообщениями Интернета (ICMP) используется для отправки сообщений об ошибках и оперативной информации, указывающей на успех или неудачу при взаимодействии с экземпляром. Например, ошибка указывается, когда экземпляр не был доступен. При указанииicmpв качествеprotocol, необходимо указать тип ICMP с помощью параметраfromPortи код ICMP с помощью параметраtoPort. -
icmp6- Протокол управления сообщениями Интернета (ICMP) для IPv6. При указанииicmp6в качествеprotocol, необходимо указать тип ICMP с помощью параметраfromPortи код ICMP с помощью параметраtoPort.
accessFrom -> (строка)
Anywhere (0.0.0.0/0) или Custom, если разрешен конкретный IP-адрес или диапазон IP-адресов.accessType -> (строка)
Public или Private).commonName -> (строка)
accessDirection -> (строка)
Направление доступа (inbound или outbound).
Примечание
Lightsail в настоящее время поддерживает толькоinbound направление доступа.cidrs -> (список)
IPv4-адрес или диапазон IPv4-адресов (в нотации CIDR), которые разрешено подключаться к экземпляру через порты и протокол.
Примечание
Параметрipv6Cidrs перечисляет IPv6-адреса, которые разрешено подключаться к экземпляру.Для получения дополнительной информации о нотации CIDR см. Классовую междоменную маршрутизацию на Wikipedia .
(строка)
ipv6Cidrs -> (список)
IPv6-адрес или диапазон IPv6-адресов (в нотации CIDR), которые разрешено подключаться к экземпляру через порты и протокол. Только устройства с IPv6-адресом могут подключаться к экземпляру через IPv6; в противном случае следует использовать IPv4.
Примечание
Параметрcidrs перечисляет IPv4-адреса, которые разрешено подключаться к экземпляру.Для получения дополнительной информации о нотации CIDR см. Классовую междоменную маршрутизацию на Wikipedia .
(строка)
cidrListAliases -> (список)
Псевдоним, который определяет доступ для предварительно настроенного диапазона IP-адресов.
В настоящее время поддерживается только псевдоним lightsail-connect, который позволяет IP-адресам браузерного RDP/SSH-клиента в консоли Lightsail подключаться к вашему экземпляру.
(строка)
state -> (структура)
Код состояния и состояние (running ) для экземпляра.
code -> (целое число)
name -> (строка)
running или pending).username -> (строка)
ec2-user).sshKeyName -> (строка)
LightsailDefaultKeyPair).metadataOptions -> (структура)
Параметры метаданных для экземпляра Amazon Lightsail.
state -> (строка)
Состояние изменений параметров метаданных.
Возможны следующие состояния:
-
pending- Параметры метаданных обновляются. Экземпляр еще не готов обрабатывать трафик метаданных с новым выбором. -
applied- Параметры метаданных успешно применены к экземпляру.
httpTokens -> (строка)
Состояние использования токенов для ваших запросов к метаданным экземпляра.
Если состояние optional, вы можете выбрать, получать ли метаданные экземпляра с заголовок подписанного токена в вашем запросе. Если вы получаете учетные данные роли IAM без токена, возвращаются учетные данные роли версии 1.0. Если вы получаете учетные данные роли IAM с помощью действительного подписанного токена, возвращаются учетные данные роли версии 2.0.
Если состояние required, вы должны отправлять заголовок подписанного токена со всеми запросами получения метаданных экземпляра. В этом состоянии получение учетных данных роли IAM всегда возвращает учетные данные версии 2.0. Учетные данные версии 1.0 недоступны.
Предупреждение
Не все шаблоны экземпляров в Lightsail поддерживают учетные данные версии 2.0. Используйте метрику экземпляраMetadataNoToken, чтобы отслеживать количество вызовов службы метаданных экземпляра, использующих учетные данные версии 1.0. Для получения дополнительной информации см. Просмотр метрик экземпляра в Amazon Lightsail в руководстве разработчика Amazon Lightsail .httpEndpoint -> (строка)
httpPutResponseHopLimit -> (целое число)
httpProtocolIpv6 -> (строка)
nextPageToken -> (строка)
Токен для перехода к следующей странице результатов вашего запроса.
Токен следующей страницы не возвращается, если больше результатов отобразить не удается.
Чтобы получить следующую страницу результатов, выполните другой запрос GetInstances и укажите токен следующей страницы с помощью параметра pageToken.
© Copyright 2025, Amazon Web Services. Created using Sphinx.