Spec-Zone.ru › AWS CLI v2

[ aws . discovery ]

start-export-task

Описание

Начинает экспорт отчета обнаруженных данных в ведро Amazon S3, управляемое Amazon Web Services.

Примечание

Экспорт может предоставить оценку сборов и экономии на основе определённой предоставляемой вами информации. Оценки сборов не включают какие-либо налоги, которые могут применяться. Ваши фактические сборы и экономия зависят от множества факторов, включая фактическое использование вами сервисов Amazon Web Services, которое может отличаться от оценок, предоставленных в данном отчете.

Если вы не указываете preferences или agentIds в фильтре, генерируется сводка всех серверов, приложений, тегов и производительности. Эти данные представляют собой агрегацию всех данных серверов, собранных с помощью локальных инструментов, импорта файлов, группировки приложений и применения тегов.

Если вы указываете agentIds в фильтре, задача экспортирует до 72 часов подробных данных, собранных идентифицированным агентом Application Discovery Agent, включая данные о сети, процессах и производительности. Диапазон времени для экспортируемых данных агента может быть задан с помощью startTime и endTime. Экспорт подробных данных агента ограничен пятью одновременно выполняемыми экспортами. Экспорт подробных данных агента ограничен двумя экспортами в день.

Если вы включите ec2RecommendationsPreferences в preferences, генерируется экземпляр Amazon EC2, соответствующий характеристикам каждого сервера в Application Discovery Service. Изменение атрибутов ec2RecommendationsPreferences изменяет критерии рекомендации.

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

Синтаксис

  start-export-task
[--export-data-format <value>]
[--filters <value>]
[--start-time <value>]
[--end-time <value>]
[--preferences <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]

Параметры

--export-data-format (список)

Формат файла для возвращаемых данных экспорта. Значение по умолчанию — CSV. Примечание: Параметр GRAPHML был устаревший.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  CSV

--filters (список)

Если фильтр присутствует, он выбирает единственный agentId агента Application Discovery Agent, для которого экспортируются данные. agentId можно найти в результатах API или командной строки DescribeAgents. Если фильтр отсутствует, startTime и endTime игнорируются, и экспортируемые данные включают в себя данные обоих коллекторов Amazon Web Services Application Discovery Service Agentless Collector и сводные данные от агентов Application Discovery Agent.

(структура)

Используется для выбора данных какого агента следует экспортировать. Идентификатор единственного агента может быть выбран для экспорта с помощью действия StartExportTask.

name -> (строка)

Название единственного ExportFilter. Поддерживаемые фильтры: agentIds.

values -> (список)

Уникальный идентификатор агента Discovery Agent. Идентификатор агента можно найти, используя действие DescribeAgents. Обычно идентификатор агента ADS имеет вид o-0123456789abcdef0.

(строка)

condition -> (строка)

Поддерживаемое условие: EQUALS

Сокращенный синтаксис:

name=string,values=string,string,condition=string ...

Синтаксис JSON:

[
  {
    "name": "string",
    "values": ["string", ...],
    "condition": "string"
  }
  ...
]

--start-time (метка времени)

Начальная метка времени для экспортируемых данных от выбранного в фильтрах агента Application Discovery Agent. Если значение не указано, данные экспортируются, начиная с момента сбора данных агентом.

--end-time (метка времени)

Конечная метка времени для экспортируемых данных от выбранного в фильтрах агента Application Discovery Agent. Если значение не указано, экспортируемые данные включают в себя самые последние данные, собранные агентом.

--preferences (структура помеченного объединения)

Указывает тип данных, которые необходимо экспортировать. Только одно ExportPreferences может быть включено в любое время.

Примечание

Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть установлен: ec2RecommendationsPreferences.

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

Если включено, экспортируемые данные включают в себя соответствия типов экземпляров EC2 для локальных серверов, обнаруженных через Amazon Web Services Application Discovery Service.

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

Если установлено в значение true, предпочтения экспорта установлены в Ec2RecommendationsExportPreferences.

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

Рекомендуемый тип экземпляра EC2, соответствующий метрике использования ЦП данных производительности сервера.

name -> (строка)

Метрика использования, которая используется рекомендациями.

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

Указывает процент указанной метрики использования, который используется рекомендациями.

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

Рекомендуемый тип экземпляра EC2, соответствующий метрике использования памяти данных производительности сервера.

name -> (строка)

Метрика использования, которая используется рекомендациями.

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

Указывает процент указанной метрики использования, который используется рекомендациями.

tenancy -> (строка)

Целевая аренда для использования рекомендуемых экземпляров EC2.

excludedInstanceTypes -> (список)

Массив типов экземпляров, которые следует исключить из рекомендаций.

(строка)

preferredRegion -> (строка)

Целевой регион Amazon Web Services для рекомендаций. Вы можете использовать любой из доступных кодов региона для выбранной службы, как перечислены в конечных точках служб Amazon Web Services в Amazon Web Services General Reference.

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

Тип контракта для зарезервированного экземпляра. Если пусто, предполагается, что экземпляр On-Demand предпочтительнее.

purchasingOption -> (строка)

Планируемая схема платежей для вашего зарезервированного экземпляра.

offeringClass -> (строка)

Гибкость изменения типов экземпляров, необходимых для вашего зарезервированного экземпляра.

termLength -> (строка)

Предпочтительная продолжительность срока действия зарезервированного экземпляра.

Сокращенный синтаксис:

ec2RecommendationsPreferences={enabled=boolean,cpuPerformanceMetricBasis={name=string,percentageAdjust=double},ramPerformanceMetricBasis={name=string,percentageAdjust=double},tenancy=string,excludedInstanceTypes=[string,string],preferredRegion=string,reservedInstanceOptions={purchasingOption=string,offeringClass=string,termLength=string}}

Синтаксис JSON:

{
  "ec2RecommendationsPreferences": {
    "enabled": true|false,
    "cpuPerformanceMetricBasis": {
      "name": "string",
      "percentageAdjust": double
    },
    "ramPerformanceMetricBasis": {
      "name": "string",
      "percentageAdjust": double
    },
    "tenancy": "DEDICATED"|"SHARED",
    "excludedInstanceTypes": ["string", ...],
    "preferredRegion": "string",
    "reservedInstanceOptions": {
      "purchasingOption": "ALL_UPFRONT"|"PARTIAL_UPFRONT"|"NO_UPFRONT",
      "offeringClass": "STANDARD"|"CONVERTIBLE",
      "termLength": "ONE_YEAR"|"THREE_YEAR"
    }
  }
}

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

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

--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 для вывода.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

exportId -> (строка)

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

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

Spec-Zone.ru

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