Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

создание-сетевого-интерфейса

Описание

Создает сетевой интерфейс в указанной подсети.

Количество IP-адресов, которые можно назначить сетевому интерфейсу, зависит от типа экземпляра.

Дополнительную информацию о сетевых интерфейсах см. в руководстве пользователя Amazon EC2 Сетевые интерфейсы Elastic.

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

Синтаксис

  create-network-interface
[--ipv4-prefixes <value>]
[--ipv4-prefix-count <value>]
[--ipv6-prefixes <value>]
[--ipv6-prefix-count <value>]
[--interface-type <value>]
[--tag-specifications <value>]
[--client-token <value>]
[--enable-primary-ipv6 | --no-enable-primary-ipv6]
[--connection-tracking-specification <value>]
[--operator <value>]
--subnet-id <value>
[--description <value>]
[--private-ip-address <value>]
[--groups <value>]
[--private-ip-addresses <value>]
[--secondary-private-ip-address-count <value>]
[--ipv6-addresses <value>]
[--ipv6-address-count <value>]
[--dry-run | --no-dry-run]
[--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]

Параметры

--ipv4-prefixes (список)

Префиксы IPv4, назначенные сетевому интерфейсу.

Вы не можете указать префиксы IPv4, если вы указали одно из следующего: количество префиксов IPv4, конкретные частные IP-адреса IPv4 или количество частных IP-адресов IPv4.

(структура)

Описание параметра префикса IPv4 для сетевого интерфейса.

Ipv4Prefix -> (строка)

Префикс IPv4. Дополнительную информацию см. в руководстве пользователя Amazon EC2 Назначение префиксов сетевым интерфейсам.

Синтаксис сокращенного вида:

Ipv4Prefix=string ...

Синтаксис JSON:

[
  {
    "Ipv4Prefix": "string"
  }
  ...
]

--ipv4-prefix-count (целое число)

Количество префиксов IPv4, которые Amazon Web Services автоматически назначает сетевому интерфейсу.

Вы не можете указать количество префиксов IPv4, если вы указали одно из следующего: конкретные префиксы IPv4, конкретные частные IP-адреса IPv4 или количество частных IP-адресов IPv4.

--ipv6-prefixes (список)

Префиксы IPv6, назначенные сетевому интерфейсу.

Вы не можете указать префиксы IPv6, если вы указали одно из следующего: количество префиксов IPv6, конкретные IPv6-адреса или количество IPv6-адресов.

(структура)

Описание параметра префикса IPv6 для сетевого интерфейса.

Ipv6Prefix -> (строка)

Префикс IPv6.

Синтаксис сокращенного вида:

Ipv6Prefix=string ...

Синтаксис JSON:

[
  {
    "Ipv6Prefix": "string"
  }
  ...
]

--ipv6-prefix-count (целое число)

Количество префиксов IPv6, которые Amazon Web Services автоматически назначает сетевому интерфейсу.

Вы не можете указать количество префиксов IPv6, если вы указали одно из следующего: конкретные префиксы IPv6, конкретные IPv6-адреса или количество IPv6-адресов.

--interface-type (строка)

Тип сетевого интерфейса. По умолчанию - interface.

Если вы указываете efa-only, не назначайте никакие IP-адреса сетевому интерфейсу. Сетевые интерфейсы только для EFA не поддерживают IP-адреса.

Поддерживаемые значения: interface, efa, efa-only и trunk.

Возможные значения:

  • efa
  • efa-only
  • branch
  • trunk

--tag-specifications (список)

Теги, которые необходимо применить к новому сетевому интерфейсу.

(структура)

Теги, которые необходимо применить к ресурсу при его создании. При указании тега необходимо указать тип ресурса, иначе запрос завершится ошибкой.

Примечание

Список Valid Values содержит все типы ресурсов, которые можно помечать. Однако действие, которое вы используете, может не поддерживать пометку всех этих типов ресурсов. Если вы попытаетесь помечать тип ресурса, который не поддерживается для используемого действия, получите ошибку.

ResourceType -> (строка)

Тип ресурса, который необходимо пометить при создании.

Tags -> (список)

Теги, которые необходимо применить к ресурсу.

(структура)

Описание тега.

Key -> (строка)

Ключ тега.

Ограничения: ключи тегов чувствительны к регистру и могут содержать до 127 символов Юникода. Не может начинаться с aws:.

Value -> (строка)

Значение тега.

Ограничения: значения тегов чувствительны к регистру и могут содержать до 256 символов Юникода.

Синтаксис сокращенного вида:

ResourceType=string,Tags=[{Key=string,Value=string},{Key=string,Value=string}] ...

Синтаксис JSON:

[
  {
    "ResourceType": "capacity-reservation"|"client-vpn-endpoint"|"customer-gateway"|"carrier-gateway"|"coip-pool"|"declarative-policies-report"|"dedicated-host"|"dhcp-options"|"egress-only-internet-gateway"|"elastic-ip"|"elastic-gpu"|"export-image-task"|"export-instance-task"|"fleet"|"fpga-image"|"host-reservation"|"image"|"import-image-task"|"import-snapshot-task"|"instance"|"instance-event-window"|"internet-gateway"|"ipam"|"ipam-pool"|"ipam-scope"|"ipv4pool-ec2"|"ipv6pool-ec2"|"key-pair"|"launch-template"|"local-gateway"|"local-gateway-route-table"|"local-gateway-virtual-interface"|"local-gateway-virtual-interface-group"|"local-gateway-route-table-vpc-association"|"local-gateway-route-table-virtual-interface-group-association"|"natgateway"|"network-acl"|"network-interface"|"network-insights-analysis"|"network-insights-path"|"network-insights-access-scope"|"network-insights-access-scope-analysis"|"outpost-lag"|"placement-group"|"prefix-list"|"replace-root-volume-task"|"reserved-instances"|"route-table"|"security-group"|"security-group-rule"|"service-link-virtual-interface"|"snapshot"|"spot-fleet-request"|"spot-instances-request"|"subnet"|"subnet-cidr-reservation"|"traffic-mirror-filter"|"traffic-mirror-session"|"traffic-mirror-target"|"transit-gateway"|"transit-gateway-attachment"|"transit-gateway-connect-peer"|"transit-gateway-multicast-domain"|"transit-gateway-policy-table"|"transit-gateway-route-table"|"transit-gateway-route-table-announcement"|"volume"|"vpc"|"vpc-endpoint"|"vpc-endpoint-connection"|"vpc-endpoint-service"|"vpc-endpoint-service-permission"|"vpc-peering-connection"|"vpn-connection"|"vpn-gateway"|"vpc-flow-log"|"capacity-reservation-fleet"|"traffic-mirror-filter-rule"|"vpc-endpoint-connection-device-type"|"verified-access-instance"|"verified-access-group"|"verified-access-endpoint"|"verified-access-policy"|"verified-access-trust-provider"|"vpn-connection-device-type"|"vpc-block-public-access-exclusion"|"route-server"|"route-server-endpoint"|"route-server-peer"|"ipam-resource-discovery"|"ipam-resource-discovery-association"|"instance-connect-endpoint"|"verified-access-endpoint-target"|"ipam-external-resource-verification-token"|"mac-modification-task",
    "Tags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }
  ...
]

--client-token (строка)

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете, чтобы гарантировать идемпотентность запроса. Дополнительную информацию см. в разделе Обеспечение идемпотентности.

--enable-primary-ipv6 | --no-enable-primary-ipv6 (булево)

При создании сетевого интерфейса в подсети с двойной адресацией или только IPv6 вы можете назначить первичный IPv6-адрес. Первичный IPv6-адрес — это IPv6-адрес GUA, связанный с ENI, для которого вы включили использование первичного IPv6-адреса. Используйте этот параметр, если экземпляр, к которому будет подключен этот ENI, полагается на неизменность его IPv6-адреса. Amazon Web Services автоматически назначит IPv6-адрес, связанный с ENI, подключенным к вашему экземпляру, в качестве первичного IPv6-адреса. После включения IPv6-адреса GUA в качестве первичного IPv6 его нельзя отключить. При включении IPv6-адреса GUA в качестве первичного IPv6 первый IPv6 GUA станет первичным IPv6-адресом до тех пор, пока экземпляр не будет завершен или сетевой интерфейс не будет отключен. Если у вас несколько IPv6-адресов, связанных с ENI, подключенным к вашему экземпляру, и вы включите первичный IPv6-адрес, первый IPv6-адрес GUA, связанный с ENI, станет первичным IPv6-адресом.

--connection-tracking-specification (структура)

Спецификация отслеживания подключений для сетевого интерфейса.

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

Таймаут (в секундах) для неактивных TCP-соединений в состоянии установленного соединения. Мин.: 60 секунд. Макс.: 432000 секунд (5 дней). По умолчанию: 432000 секунд. Рекомендуется: меньше 432000 секунд.

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

Таймаут (в секундах) для неактивных UDP-потоков, классифицированных как потоки, которые видели более одной транзакции запрос-ответ. Мин.: 60 секунд. Макс.: 180 секунд (3 минуты). По умолчанию: 180 секунд.

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

Таймаут (в секундах) для неактивных UDP-потоков, которые видели трафик только в одном направлении или одной транзакции запрос-ответ. Мин.: 30 секунд. Макс.: 60 секунд. По умолчанию: 30 секунд.

Синтаксис сокращенного вида:

TcpEstablishedTimeout=integer,UdpStreamTimeout=integer,UdpTimeout=integer

Синтаксис JSON:

{
  "TcpEstablishedTimeout": integer,
  "UdpStreamTimeout": integer,
  "UdpTimeout": integer
}

--operator (структура)

Зарезервировано для внутреннего использования.

Principal -> (строка)

Поставщик услуг, управляющий ресурсом.

Синтаксис сокращенного вида:

Principal=string

Синтаксис JSON:

{
  "Principal": "string"
}

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

Идентификатор подсети, которую необходимо ассоциировать с сетевым интерфейсом.

--description (строка)

Описание сетевого интерфейса.

--private-ip-address (строка)

Основной частный IPv4-адрес сетевого интерфейса. Если вы не укажете IPv4-адрес, Amazon EC2 выберет его из диапазона IPv4 CIDR подсети. Если вы укажете IP-адрес, вы не сможете указать какие-либо IP-адреса, указанные в privateIpAddresses, как первичные (только один IP-адрес может быть назначен как первичный).

--groups (список)

Идентификаторы групп безопасности.

(строка)

Синтаксис:

"string" "string" ...

--private-ip-addresses (список)

Частные IP-адреса IPv4.

Вы не можете указать частные IP-адреса IPv4, если вы указали одно из следующего: количество частных IP-адресов IPv4, конкретные префиксы IPv4 или количество префиксов IPv4.

(структура)

Описание дополнительного частного IPv4-адреса для сетевого интерфейса.

Primary -> (булево)

Указывает, является ли частный IPv4-адрес основным частным IPv4-адресом. Только один IPv4-адрес может быть обозначен как первичный.

PrivateIpAddress -> (строка)

Частный IPv4-адрес.

Синтаксис сокращенного вида:

Primary=boolean,PrivateIpAddress=string ...

Синтаксис JSON:

[
  {
    "Primary": true|false,
    "PrivateIpAddress": "string"
  }
  ...
]

--secondary-private-ip-address-count (целое число)

Количество дополнительных частных IPv4-адресов, которые необходимо назначить сетевому интерфейсу. При указании количества дополнительных IPv4-адресов Amazon EC2 выбирает эти IP-адреса в пределах диапазона IPv4 CIDR подсети. Вы не можете указать этот параметр и указать более одного частного IP-адреса с помощью privateIpAddresses.

Вы не можете указать количество частных IPv4-адресов, если вы указали одно из следующего: конкретные частные IPv4-адреса, конкретные префиксы IPv4 или количество префиксов IPv4.

--ipv6-addresses (список)

IPv6-адреса из диапазона IPv6 CIDR вашей подсети.

Вы не можете указать IPv6-адреса с помощью этого параметра, если вы указали одно из следующего: количество IPv6-адресов, конкретные префиксы IPv6 или количество префиксов IPv6.

(структура)

Описание IPv6-адреса.

Ipv6Address -> (строка)

IPv6-адрес.

IsPrimaryIpv6 -> (булево)

Определяет, является ли IPv6-адрес, связанный с сетевым интерфейсом, первичным IPv6-адресом. При включении IPv6-адреса GUA в качестве первичного IPv6, первый IPv6 GUA будет назначен первичным IPv6-адресом до тех пор, пока экземпляр не будет завершен или сетевой интерфейс не будет отключен. Дополнительную информацию см. в разделе RunInstances.

Синтаксис сокращенного вида:

Ipv6Address=string,IsPrimaryIpv6=boolean ...

Синтаксис JSON:

[
  {
    "Ipv6Address": "string",
    "IsPrimaryIpv6": true|false
  }
  ...
]

--ipv6-address-count (целое число)

Количество IPv6-адресов, которые необходимо назначить сетевому интерфейсу. Amazon EC2 автоматически выбирает IPv6-адреса из диапазона подсети.

Вы не можете указать количество IPv6-адресов с помощью этого параметра, если вы указали одно из следующего: конкретные IPv6-адреса, конкретные префиксы IPv6 или количество префиксов IPv6.

Если в вашей подсети установлен атрибут AssignIpv6AddressOnCreation, вы можете переопределить его, указав 0 в качестве количества IPv6-адресов.

--dry-run | --no-dry-run (булево)

Проверяет, есть ли у вас необходимые разрешения для действия, не выполняя фактический запрос, и возвращает ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке будет DryRunOperation. В противном случае это UnauthorizedOperation.

--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 (строка)

Регион для использования. Переопределяет настройки config/env.

--version (строка)

Показать версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • включено
  • выключено
  • автоматически

--no-sign-request (логическое значение)

Не подписывать запросы. Кредиты не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл сертификата CA для использования при проверке сертификатов SSL. Переопределяет настройки config/env.

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

Пример 1: Указание IPv4-адреса для сетевого интерфейса

Следующий create-network-interface пример создает сетевой интерфейс для указанной подсети с указанным первичным IPv4-адресом.

aws ec2 create-network-interface \
    --subnet-id subnet-00a24d0d67acf6333 \
    --description "my network interface" \
    --groups sg-09dfba7ed20cda78b \
    --private-ip-address 10.0.8.17

Вывод:

{
    "NetworkInterface": {
        "AvailabilityZone": "us-west-2a",
        "Description": "my network interface",
        "Groups": [
            {
                "GroupName": "my-security-group",
                "GroupId": "sg-09dfba7ed20cda78b"
            }
        ],
        "InterfaceType": "interface",
        "Ipv6Addresses": [],
        "MacAddress": "06:6a:0f:9a:49:37",
        "NetworkInterfaceId": "eni-0492b355f0cf3b3f8",
        "OwnerId": "123456789012",
        "PrivateDnsName": "ip-10-0-8-18.us-west-2.compute.internal",
        "PrivateIpAddress": "10.0.8.17",
        "PrivateIpAddresses": [
            {
                "Primary": true,
                "PrivateDnsName": "ip-10-0-8-17.us-west-2.compute.internal",
                "PrivateIpAddress": "10.0.8.17"
            }
        ],
        "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE",
        "RequesterManaged": false,
        "SourceDestCheck": true,
        "Status": "pending",
        "SubnetId": "subnet-00a24d0d67acf6333",
        "TagSet": [],
        "VpcId": "vpc-02723a0feeeb9d57b"
    }
}

Пример 2: Создание сетевого интерфейса с IPv4-адресом и IPv6-адресом

Следующий create-network-interface пример создаёт сетевой интерфейс для указанной подсети с IPv4-адресом и IPv6-адресом, которые выбираются Amazon EC2.

aws ec2 create-network-interface \
    --subnet-id subnet-00a24d0d67acf6333 \
    --description "my dual stack network interface" \
    --ipv6-address-count 1 \
    --groups sg-09dfba7ed20cda78b

Вывод:

{
    "NetworkInterface": {
        "AvailabilityZone": "us-west-2a",
        "Description": "my dual stack network interface",
        "Groups": [
            {
                "GroupName": "my-security-group",
                "GroupId": "sg-09dfba7ed20cda78b"
            }
        ],
        "InterfaceType": "interface",
        "Ipv6Addresses": [
            {
                "Ipv6Address": "2600:1f13:cfe:3650:a1dc:237c:393a:4ba7",
                "IsPrimaryIpv6": false
            }
        ],
        "MacAddress": "06:b8:68:d2:b2:2d",
        "NetworkInterfaceId": "eni-05da417453f9a84bf",
        "OwnerId": "123456789012",
        "PrivateDnsName": "ip-10-0-8-18.us-west-2.compute.internal",
        "PrivateIpAddress": "10.0.8.18",
        "PrivateIpAddresses": [
            {
                "Primary": true,
                "PrivateDnsName": "ip-10-0-8-18.us-west-2.compute.internal",
                "PrivateIpAddress": "10.0.8.18"
            }
        ],
        "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE",
        "RequesterManaged": false,
        "SourceDestCheck": true,
        "Status": "pending",
        "SubnetId": "subnet-00a24d0d67acf6333",
        "TagSet": [],
        "VpcId": "vpc-02723a0feeeb9d57b",
        "Ipv6Address": "2600:1f13:cfe:3650:a1dc:237c:393a:4ba7"
    }
}

Пример 3: Создание сетевого интерфейса с параметрами конфигурации отслеживания соединений

Следующий create-network-interface пример создаёт сетевой интерфейс и настраивает таймауты отслеживания неактивных соединений.

aws ec2 create-network-interface \
    --subnet-id subnet-00a24d0d67acf6333 \
    --groups sg-02e57dbcfe0331c1b \
    --connection-tracking-specification TcpEstablishedTimeout=86400,UdpTimeout=60

Вывод:

{
    "NetworkInterface": {
        "AvailabilityZone": "us-west-2a",
        "ConnectionTrackingConfiguration": {
            "TcpEstablishedTimeout": 86400,
            "UdpTimeout": 60
        },
        "Description": "",
        "Groups": [
            {
                "GroupName": "my-security-group",
                "GroupId": "sg-02e57dbcfe0331c1b"
            }
        ],
        "InterfaceType": "interface",
        "Ipv6Addresses": [],
        "MacAddress": "06:4c:53:de:6d:91",
        "NetworkInterfaceId": "eni-0c133586e08903d0b",
        "OwnerId": "123456789012",
        "PrivateDnsName": "ip-10-0-8-94.us-west-2.compute.internal",
        "PrivateIpAddress": "10.0.8.94",
        "PrivateIpAddresses": [
            {
                "Primary": true,
                "PrivateDnsName": "ip-10-0-8-94.us-west-2.compute.internal",
                "PrivateIpAddress": "10.0.8.94"
            }
        ],
        "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE",
        "RequesterManaged": false,
        "SourceDestCheck": true,
        "Status": "pending",
        "SubnetId": "subnet-00a24d0d67acf6333",
        "TagSet": [],
        "VpcId": "vpc-02723a0feeeb9d57b"
    }
}

Пример 4: Создание Elastic Fabric Adapter

Следующий create-network-interface пример создаёт EFA.

aws ec2 create-network-interface \
    --interface-type efa \
    --subnet-id subnet-00a24d0d67acf6333 \
    --description "my efa" \
    --groups sg-02e57dbcfe0331c1b

Вывод:

{
    "NetworkInterface": {
        "AvailabilityZone": "us-west-2a",
        "Description": "my efa",
        "Groups": [
            {
                "GroupName": "my-efa-sg",
                "GroupId": "sg-02e57dbcfe0331c1b"
            }
        ],
        "InterfaceType": "efa",
        "Ipv6Addresses": [],
        "MacAddress": "06:d7:a4:f7:4d:57",
        "NetworkInterfaceId": "eni-034acc2885e862b65",
        "OwnerId": "123456789012",
        "PrivateDnsName": "ip-10-0-8-180.us-west-2.compute.internal",
        "PrivateIpAddress": "10.0.8.180",
        "PrivateIpAddresses": [
            {
                "Primary": true,
                "PrivateDnsName": "ip-10-0-8-180.us-west-2.compute.internal",
                "PrivateIpAddress": "10.0.8.180"
            }
        ],
        "RequesterId": "AIDA4Z3Y7GSXTMEXAMPLE",
        "RequesterManaged": false,
        "SourceDestCheck": true,
        "Status": "pending",
        "SubnetId": "subnet-00a24d0d67acf6333",
        "TagSet": [],
        "VpcId": "vpc-02723a0feeeb9d57b"
    }
}

Для получения дополнительной информации см. Сетевые интерфейсы Elastic в Руководстве пользователя Amazon EC2.

Вывод

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

Информация о сетевом интерфейсе.

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

Информация об ассоциации с эластичным IP-адресом (IPv4), связанным с сетевым интерфейсом.

AllocationId -> (строка)

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

AssociationId -> (строка)

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

IpOwnerId -> (строка)

Идентификатор владельца эластичного IP-адреса.

PublicDnsName -> (строка)

Публичное имя DNS.

PublicIp -> (строка)

Адрес эластичного IP-адреса, привязанного к сетевому интерфейсу.

CustomerOwnedIp -> (строка)

Адрес IP-адреса, принадлежащего клиенту, связанный с сетевым интерфейсом.

CarrierIp -> (строка)

Адрес IP-адреса поставщика услуг, связанный с сетевым интерфейсом.

Этот параметр доступен только в том случае, если сетевой интерфейс находится в подсети, связанной с зоной Wavelength.

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

Прикрепление сетевого интерфейса.

AttachTime -> (метка времени)

Метка времени, указывающая момент начала прикрепления.

AttachmentId -> (строка)

Идентификатор прикрепления сетевого интерфейса.

DeleteOnTermination -> (логическое значение)

Указывает, будет ли сетевой интерфейс удалён при завершении работы экземпляра.

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

Индекс устройства прикрепления сетевого интерфейса на экземпляре.

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

Индекс сетевой карты.

InstanceId -> (строка)

Идентификатор экземпляра.

InstanceOwnerId -> (строка)

Идентификатор учётной записи Amazon Web Services владельца экземпляра.

Status -> (строка)

Состояние прикрепления.

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

Настройка ENA Express для сетевого интерфейса, к которому выполняется прикрепление к экземпляру.

EnaSrdEnabled -> (логическое значение)

Указывает, включена ли ENA Express для сетевого интерфейса.

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

Настройка ENA Express для UDP-сетевого трафика.

EnaSrdUdpEnabled -> (логическое значение)

Указывает, использует ли UDP-трафик к экземпляру и из него ENA Express. Для указания этого параметра необходимо сначала включить ENA Express.

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

Количество очередей ENA, созданных с экземпляром.

AvailabilityZone -> (строка)

Зона доступности.

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

Настройка отслеживания соединений для группы безопасности, которая позволяет задать таймаут для отслеживания соединений на эластичном сетевом интерфейсе. Дополнительную информацию см. в разделе Таймауты отслеживания соединений в руководстве пользователя Amazon EC2.

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

Таймаут (в секундах) для неактивных TCP-соединений в установленном состоянии. Мин.: 60 секунд. Макс.: 432000 секунд (5 дней). По умолчанию: 432000 секунд. Рекомендуется: меньше, чем 432000 секунд.

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

Таймаут (в секундах) для неактивных UDP-потоков, классифицированных как потоки, которые видели более одной транзакции запроса-ответа. Мин.: 60 секунд. Макс.: 180 секунд (3 минуты). По умолчанию: 180 секунд.

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

Таймаут (в секундах) для неактивных UDP-потоков, которые видели трафик только в одном направлении или одной транзакции запроса-ответа. Мин.: 30 секунд. Макс.: 60 секунд. По умолчанию: 30 секунд.

Description -> (строка)

Описание.

Groups -> (список)

Любые группы безопасности для сетевого интерфейса.

(структура)

Описание группы безопасности.

GroupId -> (строка)

Идентификатор группы безопасности.

GroupName -> (строка)

Название группы безопасности.

InterfaceType -> (строка)

Тип сетевого интерфейса.

Ipv6Addresses -> (список)

IPv6-адреса, связанные с сетевым интерфейсом.

(структура)

Описание IPv6-адреса, связанного с сетевым интерфейсом.

Ipv6Address -> (строка)

IPv6-адрес.

PublicIpv6DnsName -> (строка)

Публичное имя хоста IPv6 для сетевого интерфейса. Запросы изнутри VPC или из интернета разрешаются до IPv6 GUA сетевого интерфейса. Дополнительную информацию см. в руководстве пользователя Amazon EC2 по именам хостов, именам DNS и доменам экземпляров EC2.

IsPrimaryIpv6 -> (логическое значение)

Определяет, является ли IPv6-адрес, связанный с сетевым интерфейсом, основным IPv6-адресом. При включении IPv6-адреса GUA в качестве основного IPv6-адреса, первый IPv6 GUA будет сделан основным IPv6-адресом до тех пор, пока экземпляр не будет завершён или сетевой интерфейс не будет отключён. Дополнительную информацию см. в разделе ModifyNetworkInterfaceAttribute.

MacAddress -> (строка)

MAC-адрес.

NetworkInterfaceId -> (строка)

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

OutpostArn -> (строка)

Amazon Resource Name (ARN) Outpost.

OwnerId -> (строка)

Идентификатор учётной записи Amazon Web Services владельца сетевого интерфейса.

PrivateDnsName -> (строка)

Частное имя хоста. Дополнительную информацию см. в руководстве пользователя Amazon EC2 по именам хостов, именам DNS и доменам экземпляров EC2.

PublicDnsName -> (строка)

Публичное имя хоста. Дополнительную информацию см. в руководстве пользователя Amazon EC2 по именам хостов, именам DNS и доменам экземпляров EC2.

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

Параметры типа публичного имени хоста. Дополнительную информацию см. в руководстве пользователя Amazon EC2 по именам хостов, именам DNS и доменам экземпляров EC2.

DnsHostnameType -> (строка)

Тип публичного имени хоста. Дополнительную информацию см. в руководстве пользователя Amazon EC2 по именам хостов, именам DNS и доменам экземпляров EC2.

PublicIpv4DnsName -> (строка)

Публичное имя хоста IPv4 для сетевого интерфейса. Запросы изнутри VPC разрешаются до частного основного IPv4-адреса сетевого интерфейса. Запросы из интернета разрешаются до публичного IPv4-адреса сетевого интерфейса.

PublicIpv6DnsName -> (строка)

Публичное имя хоста IPv6 для сетевого интерфейса. Запросы изнутри VPC или из интернета разрешаются до IPv6 GUA сетевого интерфейса.

PublicDualStackDnsName -> (строка)

Публичное имя хоста двойной стековой для сетевого интерфейса. Запросы изнутри VPC разрешаются как к частному IPv4-адресу, так и к IPv6 Global Unicast Address сетевого интерфейса. Запросы из интернета разрешаются как к публичному IPv4, так и к IPv6 GUA-адресу сетевого интерфейса.

PrivateIpAddress -> (строка)

IPv4-адрес сетевого интерфейса в подсети.

PrivateIpAddresses -> (список)

Частные IPv4-адреса, связанные с сетевым интерфейсом.

(структура)

Описание частного IPv4-адреса сетевого интерфейса.

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

Информация об ассоциации с эластичным IP-адресом (IPv4), связанным с сетевым интерфейсом.

AllocationId -> (строка)

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

AssociationId -> (строка)

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

IpOwnerId -> (строка)

Идентификатор владельца эластичного IP-адреса.

PublicDnsName -> (строка)

Публичное имя DNS.

PublicIp -> (строка)

Адрес эластичного IP-адреса, привязанного к сетевому интерфейсу.

CustomerOwnedIp -> (строка)

Адрес IP-адреса, принадлежащего клиенту, связанный с сетевым интерфейсом.

CarrierIp -> (строка)

Адрес IP-адреса поставщика услуг, связанный с сетевым интерфейсом.

Этот параметр доступен только в том случае, если сетевой интерфейс находится в подсети, связанной с зоной Wavelength.

Primary -> (логическое значение)

Указывает, является ли данный IPv4-адрес основным частным IPv4-адресом сетевого интерфейса.

PrivateDnsName -> (строка)

Частное имя DNS.

PrivateIpAddress -> (строка)

Частный IPv4-адрес.

Ipv4Prefixes -> (список)

IPv4-префиксы, назначенные сетевому интерфейсу.

(структура)

Описание IPv4-префикса.

Ipv4Prefix -> (строка)

IPv4-префикс. Дополнительную информацию см. в разделе Назначение префиксов сетевым интерфейсам в руководстве пользователя Amazon EC2.

Ipv6Prefixes -> (список)

IPv6-префиксы, назначенные сетевому интерфейсу.

(структура)

Описание IPv6-префикса.

Ipv6Prefix -> (строка)

IPv6-префикс.

RequesterId -> (строка)

Псевдоним или идентификатор учётной записи Amazon Web Services принципала или сервиса, создавшего сетевой интерфейс.

RequesterManaged -> (логическое значение)

Указывает, управляется ли сетевой интерфейс Amazon Web Services.

SourceDestCheck -> (логическое значение)

Указывает, включена ли проверка источника/назначения.

Status -> (строка)

Состояние сетевого интерфейса.

SubnetId -> (строка)

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

TagSet -> (список)

Любые метки, назначенные сетевому интерфейсу.

(структура)

Описание метки.

Key -> (строка)

Ключ метки.

Ограничения: Ключи меток регистрозависимые и принимают максимум 127 символов Юникода. Не должно начинаться с aws:.

Value -> (строка)

Значение метки.

Ограничения: Значения меток регистрозависимые и принимают максимум 256 символов Юникода.

VpcId -> (строка)

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

DenyAllIgwTraffic -> (логическое значение)

Указывает, недоступен ли сетевой интерфейс с IPv6-адресом из публичного интернета. Если значение равно true, входящий трафик из интернета отбрасывается, и вы не можете назначить эластичный IP-адрес сетевому интерфейсу. Сетевой интерфейс доступен из сопряжённых VPC и ресурсов, подключенных через шлюз транзита, включая локальные сети.

Ipv6Native -> (логическое значение)

Указывает, является ли этот сетевой интерфейс только IPv6.

Ipv6Address -> (строка)

Глобально уникальный IPv6-адрес, связанный с сетевым интерфейсом.

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

Поставщик услуг, управляющий сетевым интерфейсом.

Managed -> (логическое значение)

Если true, ресурс управляется поставщиком услуг.

Principal -> (строка)

Если managed равен true, то возвращается принципал. Принципал — это поставщик услуг, управляющий ресурсом.

ClientToken -> (строка)

Токен для получения следующей страницы результатов. Это значение равно null, если больше результатов нет.

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

Spec-Zone.ru

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