Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

get-ipam-discovered-resource-cidrs

Описание

Возвращает CIDR-блоки ресурсов, отслеживаемых в рамках обнаружения ресурсов. Обнаруженный ресурс — это CIDR-блок ресурса, отслеживаемый в рамках обнаружения ресурса. Следующие ресурсы могут быть обнаружены: VPC, общедоступные IPv4-пулы, подсети VPC и IP-адреса Elastic.

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

get-ipam-discovered-resource-cidrs является постраничным запросом. Для получения всего набора результатов может быть отправлено несколько API-запросов. Вы можете отключить постраничный вывод, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничным выводом, аргумент --query должен извлечь данные из результатов следующих выражений запроса: IpamDiscoveredResourceCidrs

Синтаксис

  get-ipam-discovered-resource-cidrs
[--dry-run | --no-dry-run]
--ipam-resource-discovery-id <value>
--resource-region <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.

--ipam-resource-discovery-id (строка)

Идентификатор обнаружения ресурса.

--resource-region (строка)

Регион ресурса.

--filters (список)

Фильтры.

(структура)

Пара имя-значение фильтра, используемая для возврата более конкретного списка результатов из операции 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 (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную загрузку. Если автоматическая постраничная загрузка отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

Выражение JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

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

--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 (boolean)

Отключить постраничную загрузку CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запросить параметры ввода CLI.

Примеры

Примечание

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

Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Просмотр CIDR-блоков IP-адресов, обнаруженных IPAM

В этом примере вы являетесь администратором IPAM, которому делегированы права, и хотите просмотреть сведения, связанные с CIDR-блоками IP-адресов ресурсов, которые IPAM обнаруживает.

Для выполнения этого запроса:

  • Выбранное вами обнаружение ресурса должно быть связано с IPAM.
  • --resource-region — AWS-регион, в котором был создан ресурс.

Следующий get-ipam-discovered-resource-cidrs пример отображает IP-адреса ресурсов, которые IPAM обнаруживает.

aws ec2 get-ipam-discovered-resource-cidrs \
   --ipam-resource-discovery-id ipam-res-disco-0365d2977fc1672fe \
   --resource-region us-east-1

Вывод:

{
    {
        "IpamDiscoveredResourceCidrs": [
        {
            "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe",
            "ResourceRegion": "us-east-1",
            "ResourceId": "vpc-0c974c95ca7ceef4a",
            "ResourceOwnerId": "149977607591",
            "ResourceCidr": "172.31.0.0/16",
            "ResourceType": "vpc",
            "ResourceTags": [],
            "IpUsage": 0.375,
            "VpcId": "vpc-0c974c95ca7ceef4a",
            "SampleTime": "2024-02-09T19:15:16.529000+00:00"
        },
        {
            "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe",
            "ResourceRegion": "us-east-1",
            "ResourceId": "subnet-07fe028119082a8c1",
            "ResourceOwnerId": "149977607591",
            "ResourceCidr": "172.31.0.0/20",
            "ResourceType": "subnet",
            "ResourceTags": [],
            "IpUsage": 0.0012,
            "VpcId": "vpc-0c974c95ca7ceef4a",
            "SampleTime": "2024-02-09T19:15:16.529000+00:00"
        },
        {
            "IpamResourceDiscoveryId": "ipam-res-disco-0365d2977fc1672fe",
            "ResourceRegion": "us-east-1",
            "ResourceId": "subnet-0a96893763984cc4e",
            "ResourceOwnerId": "149977607591",
            "ResourceCidr": "172.31.64.0/20",
            "ResourceType": "subnet",
            "ResourceTags": [],
            "IpUsage": 0.0012,
            "VpcId": "vpc-0c974c95ca7ceef4a",
            "SampleTime": "2024-02-09T19:15:16.529000+00:00"
        }
    }
}

Для получения дополнительной информации см. Отслеживание использования CIDR-блоков по ресурсам в Руководстве пользователя Amazon VPC IPAM.

Вывод

IpamDiscoveredResourceCidrs -> (список)

CIDR диапазоны обнаруженных ресурсов.

(структура)

CIDR диапазон обнаруженного ресурса IPAM. Обнаруженный ресурс — это ресурс CIDR, отслеживаемый при обнаружении ресурсов. Можно обнаруживать следующие ресурсы: VPC, общедоступные IPv4 пулы, подсети VPC и адреса Elastic IP. CIDR диапазон обнаруженного ресурса — это диапазон IP-адресов в CIDR-нотации, связанный с ресурсом.

IpamResourceDiscoveryId -> (строка)

Идентификатор обнаружения ресурсов.

ResourceRegion -> (строка)

Регион ресурса.

ResourceId -> (строка)

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

ResourceOwnerId -> (строка)

Идентификатор владельца ресурса.

ResourceCidr -> (строка)

CIDR диапазон ресурса.

IpSource -> (строка)

Источник, который выделил пространство IP-адресов. byoip или amazon указывает на пространство общедоступных IP-адресов, выделенное Amazon, или пространство, которое вы выделили с помощью Bring your own IP (BYOIP). none указывает на частное пространство.

ResourceType -> (строка)

Тип ресурса.

ResourceTags -> (список)

Теги ресурса.

(структура)

Комбинация ключ/значение тега, назначенного ресурсу. Используйте ключ тега в имени фильтра, а значение тега в качестве значения фильтра. Например, чтобы найти все ресурсы, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.

Key -> (строка)

Ключ тега, назначенного ресурсу. Используйте этот фильтр, чтобы найти все ресурсы, которым назначен тег с определённым ключом, независимо от значения тега.

Value -> (строка)

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

IpUsage -> (двойное значение)

Процент используемого пространства IP-адресов. Для преобразования десятичной дроби в процент, умножьте её на 100. Обратите внимание на следующее:

  • Для ресурсов, которые являются VPC, это процент пространства IP-адресов в VPC, занимаемый подсетевыми CIDR.
  • Для ресурсов, которые являются подсетями, если подсети выделен IPv4 CIDR, это процент пространства IPv4-адресов в подсети, который используется. Если подсети выделен IPv6 CIDR, процент используемого пространства IPv6-адресов не представлен. В настоящее время невозможно вычислить процент используемого пространства IPv6-адресов.
  • Для ресурсов, которые являются общедоступными IPv4-пулами, это процент пространства IP-адресов в пуле, выделенного для адресов Elastic IP (EIPs).

VpcId -> (строка)

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

SubnetId -> (строка)

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

NetworkInterfaceAttachmentStatus -> (строка)

Для эластичных сетевых интерфейсов это статус, прикреплен ли эластичный сетевой интерфейс.

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

Последнее успешное время обнаружения ресурса.

AvailabilityZoneId -> (строка)

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

NextToken -> (строка)

Укажите маркер пагинации из предыдущего запроса, чтобы получить следующую страницу результатов.

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

Spec-Zone.ru

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