Spec-Zone.ru › AWS CLI v2

[ aws . forecast ]

создать-анализ-что-если

Описание

Анализ «что если» — это метод моделирования сценариев, в котором вы вносите гипотетические изменения в временной ряд и сравниваете прогнозы, сгенерированные этими изменениями, с базовым, неизменённым временным рядом. Важно помнить, что целью анализа «что если» является понимание того, как прогноз может измениться при различных модификациях базового временного ряда.

Например, представьте, что вы розничный продавец одежды, который рассматривает возможность проведения сезонной распродажи, чтобы освободить место для новых моделей. После создания базового прогноза вы можете использовать анализ «что если», чтобы изучить, как различные стратегии распродажи могут повлиять на ваши цели.

Вы могли бы создать сценарий, где на все товары предоставляется скидка 25%, и другой, где предоставляется фиксированная скидка в долларах. Вы могли бы создать сценарий, где распродажа длится одну неделю, и другой — где она длится месяц. С помощью анализа «что если» можно сравнить множество различных сценариев друг с другом.

Обратите внимание, что анализ «что если» предназначен для отображения того, чему модель прогнозирования научилась и как она будет себя вести в сценариях, которые вы оцениваете. Не используйте результаты анализа «что если» для принятия бизнес-решений бездумно. Например, прогнозы могут быть неточными для новых сценариев, где нет ссылок для определения того, хорош ли прогноз.

Объект TimeSeriesSelector определяет элементы, которые вы хотите включить в анализ «что если».

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

Синтаксис

  create-what-if-analysis
--what-if-analysis-name <value>
--forecast-arn <value>
[--time-series-selector <value>]
[--tags <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]

Параметры

--what-if-analysis-name (строка)

Имя анализа «что если». Каждое имя должно быть уникальным.

--forecast-arn (строка)

Amazon Resource Name (ARN) базового прогноза.

--time-series-selector (структура)

Определяет набор временных рядов, используемых в анализе «что если», с помощью объекта TimeSeriesIdentifiers. Анализ «что если» выполняется только для временных рядов в этом объекте.

Объекту TimeSeriesIdentifiers необходима следующая информация:

  • DataSource
  • Format
  • Schema

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

Подробности о файле импорта, который содержит временные ряды, для которых вы хотите создать прогнозы.

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

Источник ваших данных, роль Identity and Access Management (IAM), которая разрешает Amazon Forecast получать доступ к данным, и, необязательно, ключ Key Management Service (KMS).

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

Путь к данным, хранящимся в ведре Amazon Simple Storage Service (Amazon S3), вместе с учетными данными для доступа к данным.

Path -> (строка)

Путь к ведру Amazon Simple Storage Service (Amazon S3) или файлам в ведре Amazon S3.

RoleArn -> (строка)

ARN роли Identity and Access Management (IAM), которую Amazon Forecast может принять, чтобы получить доступ к ведру Amazon S3 или файлам. Если вы предоставите значение для ключа KMSKeyArn, роль должна разрешать доступ к ключу.

Передача роли между аккаунтами Amazon Web Services не разрешена. Если вы передадите роль, которая не находится в вашем аккаунте, вы получите ошибку InvalidInputException.

KMSKeyArn -> (строка)

Amazon Resource Name (ARN) ключа Key Management Service (KMS).

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

Определяет поля набора данных.

Attributes -> (список)

Массив атрибутов, определяющих имя и тип каждого поля в наборе данных.

(структура)

Атрибут схемы, который определяет поле набора данных. Атрибут схемы требуется для каждого поля в наборе данных. Объект Schema содержит массив объектов SchemaAttribute.

AttributeName -> (строка)

Имя поля набора данных.

AttributeType -> (строка)

Тип данных поля.

Для связанного набора данных временных рядов, кроме даты, item_id и атрибутов измерений прогноза, все атрибуты должны быть числового типа (целое/вещественное).

Format -> (строка)

Формат данных, CSV или PARQUET.

Синтаксис JSON:

{
  "TimeSeriesIdentifiers": {
    "DataSource": {
      "S3Config": {
        "Path": "string",
        "RoleArn": "string",
        "KMSKeyArn": "string"
      }
    },
    "Schema": {
      "Attributes": [
        {
          "AttributeName": "string",
          "AttributeType": "string"|"integer"|"float"|"timestamp"|"geolocation"
        }
        ...
      ]
    },
    "Format": "string"
  }
}

--tags (список)

Список тегов, которые необходимо применить к прогнозу «что если».

(структура)

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

Применяются следующие основные ограничения к тегам:

  • Максимальное количество тегов на ресурс — 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"
  }
  ...
]

--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 (булево)

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

--no-cli-auto-prompt (булево)

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

Вывод

WhatIfAnalysisArn -> (строка)

Amazon Resource Name (ARN) анализа «что если».

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

Spec-Zone.ru

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