create-forecast
Описание
Создаёт прогноз для каждого элемента в наборе данных TARGET_TIME_SERIES, который использовался для обучения предиктора. Это известно как инференс. Чтобы получить прогноз для одного элемента с низкой задержкой, используйте операцию. Чтобы экспортировать весь прогноз в свой Amazon Simple Storage Service (Amazon S3) бакет, используйте операцию CreateForecastExportJob.
Диапазон прогноза определяется значением ForecastHorizon, которое вы указываете в запросе CreatePredictor. При запросе прогноза вы можете запросить определённый диапазон дат в рамках прогноза.
Чтобы получить список всех своих прогнозов, используйте операцию ListForecasts.
Примечание
Прогнозы, сгенерированные Amazon Forecast, находятся в той же часовой зоне, что и набор данных, который использовался для создания предиктора.Для получения дополнительной информации, см. howitworks-forecast.
Примечание
Status прогноза должен быть ACTIVE, прежде чем вы сможете запросить или экспортировать прогноз. Используйте операцию DescribeForecast, чтобы получить статус.По умолчанию прогноз включает предсказания для каждого элемента (item_id) в группе наборов данных, которая использовалась для обучения предиктора. Однако вы можете использовать объект TimeSeriesSelector для генерации прогноза по подмножеству временных рядов. Создание прогноза пропускается для любых временных рядов, которые вы укажете, которые не находятся в входном наборе данных. Файл экспорта прогноза не будет содержать эти временные ряды или их прогнозируемые значения.
См. также: Документация API AWS
Синтаксис
create-forecast
--forecast-name <value>
--predictor-arn <value>
[--forecast-types <value>]
[--tags <value>]
[--time-series-selector <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]
Параметры
--forecast-name (строка)
--predictor-arn (строка)
--forecast-types (список)
Квантили, в которых генерируются вероятностные прогнозы. Вы можете указать до 5 квантилей на прогноз. Допустимые значения включают 0.01 to 0.99 (приращения только 0.01) и mean. Средний прогноз отличается от медианы (0.50), когда распределение несимметрично (например, Бета и отрицательный биномиальный).
По умолчанию квантили — это квантили, которые вы указали при создании предиктора. Если вы не указали квантили, значения по умолчанию — ["0.1", "0.5", "0.9"].
(строка)
Синтаксис:
"string" "string" ...
--tags (список)
Необязательные метаданные, которые вы применяете к прогнозу, чтобы помочь в их категоризации и организации. Каждый тег состоит из ключа и необязательного значения, которые вы определяете.
Применяются следующие основные ограничения к тегам:
- Максимальное количество тегов на ресурс — 50.
- Для каждого ресурса каждый ключ тега должен быть уникальным, и каждый ключ тега может иметь только одно значение.
- Максимальная длина ключа — 128 символов Юникода в UTF-8.
- Максимальная длина значения — 256 символов Юникода в UTF-8.
- Если ваша схема тегов используется в нескольких службах и ресурсах, помните, что другие службы могут иметь ограничения на разрешенные символы. В целом, разрешёнными символами являются: буквы, цифры и пробелы, представляемые в UTF-8, а также следующие символы: + - = . _ : / @.
- Ключи и значения тегов чувствительны к регистру.
- Не используйте
aws:,AWS:или любые комбинации верхнего и нижнего регистра таких, как префикс для ключей, так как они зарезервированы для использования Amazon Web Services. Вы не можете редактировать или удалять ключи тегов с этим префиксом. Значения могут иметь этот префикс. Если значение тега имеетawsв качестве префикса, но ключ нет, то Forecast рассматривает его как пользовательский тег и будет учитывать его при лимите в 50 тегов. Теги с только префиксом ключаawsне учитываются при лимите тегов на ресурс.
(структура)
Необязательные метаданные, которые вы применяете к ресурсу, чтобы помочь в их категоризации и организации. Каждый тег состоит из ключа и необязательного значения, которые вы определяете.
Применяются следующие основные ограничения к тегам:
- Максимальное количество тегов на ресурс — 50.
- Для каждого ресурса каждый ключ тега должен быть уникальным, и каждый ключ тега может иметь только одно значение.
- Максимальная длина ключа — 128 символов Юникода в UTF-8.
- Максимальная длина значения — 256 символов Юникода в UTF-8.
- Если ваша схема тегов используется в нескольких службах и ресурсах, помните, что другие службы могут иметь ограничения на разрешенные символы. В целом, разрешёнными символами являются: буквы, цифры и пробелы, представляемые в UTF-8, а также следующие символы: + - = . _ : / @.
- Ключи и значения тегов чувствительны к регистру.
- Не используйте
aws:,AWS:или любые комбинации верхнего и нижнего регистра таких, как префикс для ключей, так как они зарезервированы для использования Amazon Web Services. Вы не можете редактировать или удалять ключи тегов с этим префиксом. Значения могут иметь этот префикс. Если значение тега имеетawsв качестве префикса, но ключ нет, то Forecast рассматривает его как пользовательский тег и будет учитывать его при лимите в 50 тегов. Теги с только префиксом ключаawsне учитываются при лимите тегов на ресурс.
Ключ -> (строка)
Значение -> (строка)
Сокращённый синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--time-series-selector (структура)
Определяет набор временных рядов, используемых для создания прогнозов в объекте TimeSeriesIdentifiers.
Объекту TimeSeriesIdentifiers нужна следующая информация:
DataSourceFormatSchema
TimeSeriesIdentifiers -> (структура)
Подробная информация об импортируемом файле, содержащем временные ряды, для которых необходимо создать прогнозы.
DataSource -> (структура)
Источник данных, роль Identity and Access Management (IAM), которая позволяет Amazon Forecast получать доступ к данным, и, необязательно, ключ Key Management Service (KMS).
S3Config -> (структура)
Путь к данным, хранящимся в бакете Amazon Simple Storage Service (Amazon S3), вместе с учетными данными для доступа к данным.
Путь -> (строка)
RoleArn -> (строка)
ARN роли Identity and Access Management (IAM), которую Amazon Forecast может принять, чтобы получить доступ к бакетам или файлам Amazon S3. Если вы предоставляете значение для ключа KMSKeyArn, роль должна разрешать доступ к ключу.
Передача роли между учётными записями Amazon Web Services не разрешена. Если вы передаёте роль, которая не в вашей учётной записи, вы получите ошибку InvalidInputException.
KMSKeyArn -> (строка)
Схема -> (структура)
Определяет поля набора данных.
Атрибуты -> (список)
Массив атрибутов, определяющих имя и тип каждого поля в наборе данных.
(структура)
Атрибут схемы, определяющий поле набора данных. Атрибут схемы требуется для каждого поля в наборе данных. Объект схемы содержит массив объектов SchemaAttribute.
AttributeName -> (строка)
AttributeType -> (строка)
Тип данных поля.
Для связанного набора данных временных рядов, кроме дат, item_id и атрибутов измерений прогноза, все атрибуты должны быть числового типа (целое число/вещественное число).
Формат -> (строка)
Синтаксис JSON:
{
"TimeSeriesIdentifiers": {
"DataSource": {
"S3Config": {
"Path": "string",
"RoleArn": "string",
"KMSKeyArn": "string"
}
},
"Schema": {
"Attributes": [
{
"AttributeName": "string",
"AttributeType": "string"|"integer"|"float"|"timestamp"|"geolocation"
}
...
]
},
"Format": "string"
}
}
--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 (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)
Файл с сертификатами доверенных центров сертификации для проверки 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 pager) для вывода.
--cli-auto-prompt (boolean)
Автоматически запрашивать входные параметры CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы входных параметров CLI.
Вывод
ForecastArn -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.