describe-network-interfaces
Описание
Описывает указанные сетевые интерфейсы или все ваши сетевые интерфейсы.
Если у вас большое количество сетевых интерфейсов, операция завершается неудачно, если вы не используете постраничный вывод или один из следующих фильтров: group-id , mac-address , private-dns-name , private-ip-address , subnet-id или vpc-id .
Предупреждение
Настоятельно рекомендуется использовать только постраничные запросы. Непостраничные запросы подвержены ограничению по скорости и таймаутам.См. также: Документация API AWS
describe-network-interfaces - это постраничная операция. Для получения всего набора результатов могут быть отправлены несколько API-запросов. Вы можете отключить постраничный вывод, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничным выводом, аргумент --query должен извлекать данные из результатов следующих запросов: NetworkInterfaces
Синтаксис
describe-network-interfaces
[--dry-run | --no-dry-run]
[--network-interface-ids <value>]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <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]
Параметры
--dry-run | --no-dry-run (boolean)
DryRunOperation . В противном случае, это будет UnauthorizedOperation .--network-interface-ids (список)
Идентификаторы сетевых интерфейсов.
По умолчанию: описывает все ваши сетевые интерфейсы.
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Один или несколько фильтров.
-
association.allocation-id- Идентификатор выделения, возвращённый при выделении адреса Elastic IP (IPv4) для вашего сетевого интерфейса. -
association.association-id- Идентификатор ассоциации, возвращённый при ассоциации сетевого интерфейса с адресом IPv4. -
addresses.association.owner-id- Идентификатор владельца адресов, связанных с сетевым интерфейсом. -
addresses.association.public-ip- Идентификатор ассоциации, возвращённый при ассоциации сетевого интерфейса с адресом Elastic IP (IPv4). -
addresses.primary- Является ли частный IPv4-адрес основным IP-адресом, связанным с сетевым интерфейсом. -
addresses.private-ip-address- Частные IPv4-адреса, связанные с сетевым интерфейсом. -
association.ip-owner-id- Владелец адреса Elastic IP (IPv4), связанного с сетевым интерфейсом. -
association.public-ip- Адрес адреса Elastic IP (IPv4), привязанного к сетевому интерфейсу. -
association.public-dns-name- Публичное доменное имя сетевого интерфейса (IPv4). -
attachment.attach-time- Время подключения сетевого интерфейса к экземпляру. -
attachment.attachment-id- Идентификатор прикрепления интерфейса. -
attachment.delete-on-termination- Указывает, удаляется ли прикрепление при завершении работы экземпляра. -
attachment.device-index- Индекс устройства, к которому прикреплён сетевой интерфейс. -
attachment.instance-id- Идентификатор экземпляра, к которому прикреплён сетевой интерфейс. -
attachment.instance-owner-id- Идентификатор владельца экземпляра, к которому прикреплён сетевой интерфейс. -
attachment.status- Состояние прикрепления (attaching|attached|detaching|detached). -
availability-zone- Зона доступности сетевого интерфейса. -
description- Описание сетевого интерфейса. -
group-id- Идентификатор группы безопасности, связанной с сетевым интерфейсом. -
ipv6-addresses.ipv6-address- IPv6-адрес, связанный с сетевым интерфейсом. -
interface-type- Тип сетевого интерфейса (api_gateway_managed|aws_codestar_connections_managed|branch|ec2_instance_connect_endpoint|efa|efa-only|efs|gateway_load_balancer|gateway_load_balancer_endpoint|global_accelerator_managed|interface|iot_rules_managed|lambda|load_balancer|nat_gateway|network_load_balancer|quicksight|transit_gateway|trunk|vpc_endpoint). -
mac-address- MAC-адрес сетевого интерфейса. -
network-interface-id- Идентификатор сетевого интерфейса. -
operator.managed- Булево значение, указывающее, является ли это управляемым сетевым интерфейсом. -
operator.principal- Субъект, управляющий сетевым интерфейсом. Действительно только для управляемых сетевых интерфейсов, гдеmanagedравноtrue. -
owner-id- Идентификатор учетной записи Amazon Web Services владельца сетевого интерфейса. -
private-dns-name- Частное доменное имя сетевого интерфейса (IPv4). -
private-ip-address- Частный IPv4-адрес или адреса сетевого интерфейса. -
requester-id- Псевдоним или идентификатор учетной записи Amazon Web Services субъекта или сервиса, создавшего сетевой интерфейс. -
requester-managed- Указывает, управляется ли сетевой интерфейс сервисом Amazon Web Services (например, Amazon Web Services Management Console, Auto Scaling и т. д.). -
source-dest-check- Указывает, выполняет ли сетевой интерфейс проверку источника/назначения. Значениеtrueозначает, что проверка включена, аfalseозначает, что проверка отключена. Значение должно бытьfalse, чтобы сетевой интерфейс выполнял трансляцию сетевых адресов (NAT) в вашей VPC. -
status- Состояние сетевого интерфейса. Если сетевой интерфейс не подключен к экземпляру, состояние равноavailable; если сетевой интерфейс подключен к экземпляру, состояние равноin-use. -
subnet-id- Идентификатор подсети для сетевого интерфейса. -
tag:<key> - Пара ключ/значение тега, присвоенного ресурсу. Используйте ключ тега в имени фильтра и значение тега в качестве значения фильтра. Например, чтобы найти все ресурсы, имеющие тег с ключомOwnerи значениемTeamA, укажитеtag:Ownerдля имени фильтра иTeamAдля значения фильтра. -
tag-key- Ключ тега, присвоенного ресурсу. Используйте этот фильтр, чтобы найти все ресурсы, которым присвоен тег с определённым ключом, независимо от значения тега. -
vpc-id- Идентификатор VPC для сетевого интерфейса.
(структура)
Пара имя/значение фильтра, используемая для возврата более специфического списка результатов из операции describe. Фильтры могут использоваться для соответствия набору ресурсов по определённым критериям, таким как теги, атрибуты или идентификаторы.
Если вы указываете несколько фильтров, фильтры объединяются с оператором AND, и запрос возвращает только результаты, соответствующие всем указанным фильтрам.
Дополнительную информацию см. в разделе Список и фильтрация с помощью командной строки и API в Руководстве пользователя Amazon EC2.
Имя -> (строка)
Значения -> (список)
Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с оператором OR, и запрос возвращает все результаты, соответствующие любому из указанных значений.
(строка)
Сокращённый синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["string", ...]
}
...
]
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного JSON, поскольку строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Маркер для указания, с какой точки начать постраничный вывод. Это NextToken из ранее усеченного ответа.
Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS Command Line Interface.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, извлекая меньше элементов в каждом вызове. Это может помочь предотвратить таймауты вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя 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 (boolean)
Включить отладку логирования.
--endpoint-url (string)
Переопределить стандартный URL команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определённый профиль из файла аутентификации.
--region (string)
Регион для использования. Переопределяет настройки из конфигурации/окружения.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/отключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Кредиты не будут загружены, если этот аргумент указан.
--ca-bundle (string)
Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/окружения.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (string)
Стиль форматирования, используемый для бинарных блоков. По умолчанию используется формат 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 (boolean)
Отключить пейджер CLI для вывода.
--cli-auto-prompt (boolean)
Автоматически запросить параметры входных данных CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматический запрос параметров входных данных CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной программы. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Для описания сетевых интерфейсов
В этом примере описываются все ваши сетевые интерфейсы.
Команда:
aws ec2 describe-network-interfaces
Вывод:
{
"NetworkInterfaces": [
{
"Status": "in-use",
"MacAddress": "02:2f:8f:b0:cf:75",
"SourceDestCheck": true,
"VpcId": "vpc-a01106c2",
"Description": "my network interface",
"Association": {
"PublicIp": "203.0.113.12",
"AssociationId": "eipassoc-0fbb766a",
"PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com",
"IpOwnerId": "123456789012"
},
"NetworkInterfaceId": "eni-e5aa89a3",
"PrivateIpAddresses": [
{
"PrivateDnsName": "ip-10-0-1-17.ec2.internal",
"Association": {
"PublicIp": "203.0.113.12",
"AssociationId": "eipassoc-0fbb766a",
"PublicDnsName": "ec2-203-0-113-12.compute-1.amazonaws.com",
"IpOwnerId": "123456789012"
},
"Primary": true,
"PrivateIpAddress": "10.0.1.17"
}
],
"RequesterManaged": false,
"Ipv6Addresses": [],
"PrivateDnsName": "ip-10-0-1-17.ec2.internal",
"AvailabilityZone": "us-east-1d",
"Attachment": {
"Status": "attached",
"DeviceIndex": 1,
"AttachTime": "2013-11-30T23:36:42.000Z",
"InstanceId": "i-1234567890abcdef0",
"DeleteOnTermination": false,
"AttachmentId": "eni-attach-66c4350a",
"InstanceOwnerId": "123456789012"
},
"Groups": [
{
"GroupName": "default",
"GroupId": "sg-8637d3e3"
}
],
"SubnetId": "subnet-b61f49f0",
"OwnerId": "123456789012",
"TagSet": [],
"PrivateIpAddress": "10.0.1.17"
},
{
"Status": "in-use",
"MacAddress": "02:58:f5:ef:4b:06",
"SourceDestCheck": true,
"VpcId": "vpc-a01106c2",
"Description": "Primary network interface",
"Association": {
"PublicIp": "198.51.100.0",
"IpOwnerId": "amazon"
},
"NetworkInterfaceId": "eni-f9ba99bf",
"PrivateIpAddresses": [
{
"Association": {
"PublicIp": "198.51.100.0",
"IpOwnerId": "amazon"
},
"Primary": true,
"PrivateIpAddress": "10.0.1.149"
}
],
"RequesterManaged": false,
"Ipv6Addresses": [],
"AvailabilityZone": "us-east-1d",
"Attachment": {
"Status": "attached",
"DeviceIndex": 0,
"AttachTime": "2013-11-30T23:35:33.000Z",
"InstanceId": "i-0598c7d356eba48d7",
"DeleteOnTermination": true,
"AttachmentId": "eni-attach-1b9db777",
"InstanceOwnerId": "123456789012"
},
"Groups": [
{
"GroupName": "default",
"GroupId": "sg-8637d3e3"
}
],
"SubnetId": "subnet-b61f49f0",
"OwnerId": "123456789012",
"TagSet": [],
"PrivateIpAddress": "10.0.1.149"
}
]
}
В этом примере описываются сетевые интерфейсы, имеющие метку с ключом Purpose и значением Prod.
Команда:
aws ec2 describe-network-interfaces --filters Name=tag:Purpose,Values=Prod
Вывод:
{
"NetworkInterfaces": [
{
"Status": "available",
"MacAddress": "12:2c:bd:f9:bf:17",
"SourceDestCheck": true,
"VpcId": "vpc-8941ebec",
"Description": "ProdENI",
"NetworkInterfaceId": "eni-b9a5ac93",
"PrivateIpAddresses": [
{
"PrivateDnsName": "ip-10-0-1-55.ec2.internal",
"Primary": true,
"PrivateIpAddress": "10.0.1.55"
},
{
"PrivateDnsName": "ip-10-0-1-117.ec2.internal",
"Primary": false,
"PrivateIpAddress": "10.0.1.117"
}
],
"RequesterManaged": false,
"PrivateDnsName": "ip-10-0-1-55.ec2.internal",
"AvailabilityZone": "us-east-1d",
"Ipv6Addresses": [],
"Groups": [
{
"GroupName": "MySG",
"GroupId": "sg-905002f5"
}
],
"SubnetId": "subnet-31d6c219",
"OwnerId": "123456789012",
"TagSet": [
{
"Value": "Prod",
"Key": "Purpose"
}
],
"PrivateIpAddress": "10.0.1.55"
}
]
}
Вывод
NetworkInterfaces -> (список)
Информация о сетевых интерфейсах.
(структура)
Описание сетевого интерфейса.
Association -> (структура)
Информация об ассоциации с адресом Elastic IP (IPv4), связанным с сетевым интерфейсом.
AllocationId -> (строка)
AssociationId -> (строка)
IpOwnerId -> (строка)
PublicDnsName -> (строка)
PublicIp -> (строка)
CustomerOwnedIp -> (строка)
CarrierIp -> (строка)
Адрес IP оператора, связанный с сетевым интерфейсом.
Этот параметр доступен только в том случае, когда сетевой интерфейс находится в подсети, связанной с зоной Wavelength.
Attachment -> (структура)
Присоединение к сетевому интерфейсу.
AttachTime -> (метка времени)
AttachmentId -> (строка)
DeleteOnTermination -> (булево)
DeviceIndex -> (целое число)
NetworkCardIndex -> (целое число)
InstanceId -> (строка)
InstanceOwnerId -> (строка)
Status -> (строка)
EnaSrdSpecification -> (структура)
Настраивает ENA Express для сетевого интерфейса, к которому данное действие присоединяет экземпляр.
EnaSrdEnabled -> (булево)
EnaSrdUdpSpecification -> (структура)
Настраивает ENA Express для UDP-сетевого трафика.
EnaSrdUdpEnabled -> (булево)
EnaQueueCount -> (целое число)
AvailabilityZone -> (строка)
ConnectionTrackingConfiguration -> (структура)
Настройка отслеживания подключений для группы безопасности, которая позволяет устанавливать таймаут для отслеживания подключений на сетевом интерфейсе Elastic. Подробнее см. в руководстве пользователя Amazon EC2 раздел «Таймауты отслеживания подключений».
TcpEstablishedTimeout -> (целое число)
UdpStreamTimeout -> (целое число)
UdpTimeout -> (целое число)
Description -> (строка)
Groups -> (список)
Любые группы безопасности для сетевого интерфейса.
(структура)
Описание группы безопасности.
GroupId -> (строка)
GroupName -> (строка)
InterfaceType -> (строка)
Ipv6Addresses -> (список)
IPv6-адреса, связанные с сетевым интерфейсом.
(структура)
Описание IPv6-адреса, связанного с сетевым интерфейсом.
Ipv6Address -> (строка)
PublicIpv6DnsName -> (строка)
IsPrimaryIpv6 -> (булево)
MacAddress -> (строка)
NetworkInterfaceId -> (строка)
OutpostArn -> (строка)
OwnerId -> (строка)
PrivateDnsName -> (строка)
PublicDnsName -> (строка)
PublicIpDnsNameOptions -> (структура)
Параметры типа общедоступного имени хоста. Дополнительную информацию см. в руководстве пользователя Amazon EC2 в разделе «Имена хостов, имена DNS и домены экземпляров EC2».
DnsHostnameType -> (строка)
PublicIpv4DnsName -> (строка)
PublicIpv6DnsName -> (строка)
PublicDualStackDnsName -> (строка)
PrivateIpAddress -> (строка)
PrivateIpAddresses -> (список)
Частные IPv4-адреса, связанные с сетевым интерфейсом.
(структура)
Описание частного IPv4-адреса сетевого интерфейса.
Association -> (структура)
Информация об ассоциации с адресом Elastic IP (IPv4), связанным с сетевым интерфейсом.
AllocationId -> (строка)
AssociationId -> (строка)
IpOwnerId -> (строка)
PublicDnsName -> (строка)
PublicIp -> (строка)
CustomerOwnedIp -> (строка)
CarrierIp -> (строка)
Адрес IP оператора, связанный с сетевым интерфейсом.
Этот параметр доступен только в том случае, когда сетевой интерфейс находится в подсети, связанной с зоной Wavelength.
Primary -> (булево)
PrivateDnsName -> (строка)
PrivateIpAddress -> (строка)
Ipv4Prefixes -> (список)
IPv4-префиксы, назначенные сетевому интерфейсу.
(структура)
Описание IPv4-префикса.
Ipv4Prefix -> (строка)
Ipv6Prefixes -> (список)
IPv6-префиксы, назначенные сетевому интерфейсу.
(структура)
Описание IPv6-префикса.
Ipv6Prefix -> (строка)
RequesterId -> (строка)
RequesterManaged -> (булево)
SourceDestCheck -> (булево)
Status -> (строка)
SubnetId -> (строка)
TagSet -> (список)
Любые теги, назначенные сетевому интерфейсу.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: ключи тегов чувствительны к регистру и принимают максимум 127 символов Юникода. Не может начинаться с aws: .
Value -> (строка)
Значение тега.
Ограничения: значения тегов чувствительны к регистру и принимают максимум 256 символов Юникода.
VpcId -> (строка)
DenyAllIgwTraffic -> (булево)
true , входящий трафик из интернета отбрасывается, и вы не можете назначить адрес Elastic IP сетевому интерфейсу. Сетевой интерфейс доступен из сопряженных VPC и ресурсов, подключенных через шлюз транзита, включая локальные сети.Ipv6Native -> (булево)
Ipv6Address -> (строка)
Operator -> (структура)
Провайдер услуг, управляющий сетевым интерфейсом.
Managed -> (булево)
true , ресурс управляется провайдером услуг.Principal -> (строка)
managed равно true , то возвращается принципал. Принципал — это провайдер услуг, управляющий ресурсом.NextToken -> (строка)
null, когда больше элементов для возврата нет.
© Copyright 2025, Amazon Web Services. Created using Sphinx.