create-auto-predictor
Описание
Создаёт предиктор Amazon Forecast.
Amazon Forecast создаёт предикторы с помощью AutoPredictor, что предполагает применение оптимальной комбинации алгоритмов к каждой временной серии в ваших наборах данных. Вы можете использовать CreateAutoPredictor для создания новых предикторов или обновления/переобучения существующих.
Следующие параметры необходимы при создании нового предиктора:
-
PredictorName- Уникальное имя для предиктора. -
DatasetGroupArn- ARN группы наборов данных, используемых для обучения предиктора. -
ForecastFrequency- Разрешение прогнозов (почасовая, ежедневная, еженедельная и т.д.). -
ForecastHorizon- Количество временных шагов, которые модель прогнозирует. Горизонт прогноза также называется длиной прогноза.
При создании нового предиктора не указывайте значение для ReferencePredictorArn.
Следующие параметры необходимы при переобучении или обновлении предиктора:
-
PredictorName- Уникальное имя для предиктора. -
ReferencePredictorArn- ARN предиктора для переобучения или обновления.
При обновлении или переобучении предиктора указывайте только значения для ReferencePredictorArn и PredictorName.
См. также: Документация API AWS
Синтаксис
create-auto-predictor
--predictor-name <value>
[--forecast-horizon <value>]
[--forecast-types <value>]
[--forecast-dimensions <value>]
[--forecast-frequency <value>]
[--data-config <value>]
[--encryption-config <value>]
[--reference-predictor-arn <value>]
[--optimization-metric <value>]
[--explain-predictor | --no-explain-predictor]
[--tags <value>]
[--monitor-config <value>]
[--time-alignment-boundary <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]
Параметры
--predictor-name (строка)
--forecast-horizon (целое число)
Количество временных шагов, которые модель прогнозирует. Горизонт прогноза также называется длиной прогноза.
Максимальный горизонт прогноза — это меньшее из 500 временных шагов или 1/4 длины набора данных TARGET_TIME_SERIES. Если вы переобучаете существующий AutoPredictor, то максимальный горизонт прогноза — это меньшее из 500 временных шагов или 1/3 длины набора данных TARGET_TIME_SERIES.
Если вы обновляете AutoPredictor или переобучаете существующий AutoPredictor, вы не можете обновить параметр горизонта прогноза. Вы можете удовлетворить этому требованию, предоставив более длинные временные ряды в наборе данных.
--forecast-types (список)
Типы прогнозов, используемые для обучения предиктора. Вы можете указать до пяти типов прогнозов. Типы прогнозов могут быть квантилями от 0,01 до 0,99 с шагом 0,01 или более. Вы также можете указать средний прогноз с помощью mean.
(строка)
Синтаксис:
"string" "string" ...
--forecast-dimensions (список)
Массив имён полей размерности (поля), которые указывают, как сгруппировать сгенерированный прогноз.
Например, если вы генерируете прогнозы продаж товаров по всем вашим магазинам, и ваш набор данных содержит поле store_id, вы бы указали store_id как размерность для группировки прогнозов продаж для каждого магазина.
(строка)
Синтаксис:
"string" "string" ...
--forecast-frequency (строка)
Частота прогнозов в прогнозе.
Допустимые интервалы — это целое число, за которым следуют Y (год), M (месяц), W (неделя), D (день), H (час) и min (минута). Например, «1D» означает каждый день, а «15min» означает каждые 15 минут. Вы не можете указать значение, которое перекрывалось бы с последующей более крупной частотой. То есть, например, вы не можете указать частоту в 60 минут, потому что это эквивалентно 1 часу. Допустимые значения для каждой частоты следующие:
- Минута - 1-59
- Час - 1-23
- День - 1-6
- Неделя - 1-4
- Месяц - 1-11
- Год - 1
Таким образом, если вам нужны прогнозы через каждую другую неделю, укажите «2W». Или, если вам нужны прогнозы на квартал, укажите «3M».
Частота должна быть больше или равна частоте набора данных TARGET_TIME_SERIES.
Когда предоставляется набор данных RELATED_TIME_SERIES, частота должна быть равна частоте набора данных RELATED_TIME_SERIES.
--data-config (структура)
Настройка данных для вашей группы наборов данных и любых дополнительных наборов данных.
DatasetGroupArn -> (строка)
AttributeConfigs -> (список)
Параметры агрегирования и заполнения для атрибутов в вашей группе наборов данных.
(структура)
Предоставляет информацию о методе преобразования атрибутов.
Ниже приведён пример с использованием домена RETAIL:
{
"AttributeName": "demand",
"Transformations": {"aggregation": "sum", "middlefill": "zero", "backfill": "zero"}
}
AttributeName -> (строка)
demand.Transformations -> (карта)
Параметры метода (пара ключ-значение), которые являются картой параметров переопределения. Укажите эти параметры для переопределения значений по умолчанию. Атрибуты Связанных временных рядов не принимают параметры агрегирования.
Следующий список показывает параметры и их допустимые значения для метода «заполнения» для набора данных «Целевой временной ряд». Значения по умолчанию выделены полужирным шрифтом.
-
aggregation: сумма ,avg,first,min,max -
frontfill: нет -
middlefill: ноль ,nan(не число),value,median,mean,min,max -
backfill: ноль ,nan,value,median,mean,min,max
Следующий список показывает параметры и их допустимые значения для метода фейтуризации «Связанный временной ряд» (нет значений по умолчанию):
-
middlefill:zero,value,median,mean,min,max -
backfill:zero,value,median,mean,min,max -
futurefill:zero,value,median,mean,min,max
Для установки метода заполнения на конкретное значение установите параметр fill в value и определите значение в соответствующем параметре _value. Например, для установки обратного заполнения на значение 2, включите следующее: "backfill": "value" и "backfill_value":"2".
key -> (строка)
value -> (строка)
AdditionalDatasets -> (список)
Дополнительные встроенные наборы данных, такие как Праздники и Индекс погоды.
(структура)
Описывает дополнительный набор данных. Этот объект является частью объекта DataConfig. Forecast поддерживает дополнительные наборы данных Индекс погоды и Праздники.
Индекс погоды Amazon Forecast — это встроенный набор данных, который включает историческую и прогнозируемую информацию о погоде в вашей модели. Индекс погоды дополняет ваши наборы данных более чем двумя годами исторических данных о погоде и до 14 дней прогнозируемых данных о погоде. Дополнительную информацию см. в разделе Индекс погоды Amazon Forecast.
Праздники — это встроенный набор данных, который включает информацию о национальных праздниках в вашей модели. Он предоставляет встроенную поддержку календарей праздников 66 стран. Чтобы просмотреть календари праздников, см. библиотеку Jollyday. Дополнительную информацию см. в разделе Фейтуризация праздников.
Name -> (строка)
"holiday" и "weather".Configuration -> (карта)
Для включения Индекса погоды не указывайте значения для Configuration.
Праздники
Праздники
Для включения Праздников установите CountryCode на один из следующих двухбуквенных кодов страны:
- «AL» - АЛБАНИЯ
- «AR» - АРГЕНТИНА
- «AT» - АВСТРИЯ
- …
key -> (строка)
value -> (список)
Синтаксис JSON:
{
"DatasetGroupArn": "string",
"AttributeConfigs": [
{
"AttributeName": "string",
"Transformations": {"string": "string"
...}
}
...
],
"AdditionalDatasets": [
{
"Name": "string",
"Configuration": {"string": ["string", ...]
...}
}
...
]
}
--encryption-config (структура)
Ключ службы управления ключами (KMS) и роль управления доступом и идентификацией (IAM), которую Amazon Forecast может принять для доступа к ключу. Вы можете указать этот необязательный объект в запросах CreateDataset и CreatePredictor.
RoleArn -> (строка)
ARN роли IAM, которую Amazon Forecast может принять для доступа к ключу KMS.
Передача роли между учётными записями Amazon Web Services запрещена. Если вы передадите роль, которая не находится в вашей учётной записи, вы получите ошибку InvalidInputException.
KMSKeyArn -> (строка)
Сокращённый синтаксис:
RoleArn=string,KMSKeyArn=string
Синтаксис JSON:
{
"RoleArn": "string",
"KMSKeyArn": "string"
}
--reference-predictor-arn (строка)
ARN предиктора для переобучения или обновления. Этот параметр используется только при переобучении или обновлении предиктора. При создании нового предиктора не указывайте значение для этого параметра.
При обновлении или переобучении предиктора укажите только значения для ReferencePredictorArn и PredictorName . Значение для PredictorName должно быть уникальным именем предиктора.
--optimization-metric (строка)
Метрика точности, используемая для оптимизации предиктора.
Возможные значения:
WAPERMSEAverageWeightedQuantileLossMASEMAPE
--explain-predictor | --no-explain-predictor (логическое значение)
--tags (список)
Дополнительные метаданные, помогающие категоризировать и организовать ваши предикторы. Каждый тег состоит из ключа и необязательного значения, оба задаваемые вами. Ключи и значения тегов чувствительны к регистру.
Применяются следующие ограничения к тегам:
- Для каждого ресурса каждый ключ тега должен быть уникальным, и каждый ключ тега должен иметь одно значение.
- Максимальное количество тегов на ресурс: 50.
- Максимальная длина ключа: 128 символов Юникода в UTF-8.
- Максимальная длина значения: 256 символов Юникода в UTF-8.
- Допустимые символы: все буквы и цифры, пробелы, представимые в UTF-8, а также + - = . _ : / @. Если ваша схема тегирования используется в других сервисах и ресурсах, также применяются ограничения на символы этих сервисов.
- Префиксы ключей не могут включать в себя любую комбинацию строчных или заглавных букв
aws:илиAWS:. Значения могут иметь этот префикс. Если значение тега имеет префиксaws, но ключ не имеет, Forecast рассматривает его как пользовательский тег и учитывает его в лимите 50 тегов. Теги с только префиксом ключаawsне учитываются в лимите тегов на ресурс. Вы не можете редактировать или удалять ключи тегов с этим префиксом.
(структура)
Дополнительные метаданные, которые вы применяете к ресурсу, чтобы помочь вам категоризировать и организовать их. Каждый тег состоит из ключа и необязательного значения, оба задаваемые вами.
Применяются следующие основные ограничения к тегам:
- Максимальное количество тегов на ресурс - 50.
- Для каждого ресурса каждый ключ тега должен быть уникальным, и каждый ключ тега может иметь только одно значение.
- Максимальная длина ключа - 128 символов Юникода в UTF-8.
- Максимальная длина значения - 256 символов Юникода в UTF-8.
- Если ваша схема тегирования используется в нескольких сервисах и ресурсах, помните, что другие сервисы могут иметь ограничения на допустимые символы. Обычно разрешены: буквы, цифры и пробелы, представимые в UTF-8, а также следующие символы: + - = . _ : / @.
- Ключи и значения тегов чувствительны к регистру.
- Не используйте
aws:,AWS:или любую комбинацию строчных или заглавных букв в качестве префикса для ключей, так как он зарезервирован для использования Amazon Web Services. Вы не можете редактировать или удалять ключи тегов с этим префиксом. Значения могут иметь этот префикс. Если значение тега имеетawsв качестве префикса, но ключ не имеет, Forecast рассматривает его как пользовательский тег и учитывает его в лимите 50 тегов. Теги с только префиксом ключаawsне учитываются в вашем лимите тегов на ресурс.
Ключ -> (строка)
key — это общее метка, которая действует как категория для более конкретных значений тегов.Значение -> (строка)
value действует как описание в категории тега (ключ).Сокращенная синтаксическая запись:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--monitor-config (структура)
Подробности конфигурации для мониторинга предиктора. Укажите имя ресурса монитора для включения мониторинга предиктора.
Мониторинг предиктора позволяет вам увидеть, как изменяется производительность вашего предиктора с течением времени. Для получения дополнительной информации см. Мониторинг предиктора.
MonitorName -> (строка)
Сокращенная синтаксическая запись:
MonitorName=string
Синтаксис JSON:
{
"MonitorName": "string"
}
--time-alignment-boundary (структура)
Границы времени, которые Forecast использует для выравнивания и агрегации любых данных, которые не соответствуют частоте вашего прогноза. Укажите единицу измерения времени и границу времени в виде пары ключ-значение. Дополнительную информацию о задании границы времени см. в разделе Определение временной границы. Если вы не предоставите границу времени, Forecast использует набор стандартных временных границ.
Month -> (строка)
DayOfMonth -> (целое число)
DayOfWeek -> (строка)
Hour -> (целое число)
Сокращенная синтаксическая запись:
Month=string,DayOfMonth=integer,DayOfWeek=string,Hour=integer
Синтаксис JSON:
{
"Month": "JANUARY"|"FEBRUARY"|"MARCH"|"APRIL"|"MAY"|"JUNE"|"JULY"|"AUGUST"|"SEPTEMBER"|"OCTOBER"|"NOVEMBER"|"DECEMBER",
"DayOfMonth": integer,
"DayOfWeek": "MONDAY"|"TUESDAY"|"WEDNESDAY"|"THURSDAY"|"FRIDAY"|"SATURDAY"|"SUNDAY",
"Hour": integer
}
--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-auto-prompt (булево)
Автоматически запрашивать параметры ввода командной строки.
--no-cli-auto-prompt (булево)
Отключить автоматическое запросить параметры ввода командной строки.
Вывод
PredictorArn -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.