[ aws . iotsitewise ]
Получение интерполированных значений свойств актива
Описание
Получение интерполированных значений свойства актива для указанного временного интервала в течение определенного периода времени. Если в вашей временной серии отсутствуют данные в указанном временном интервале, вы можете использовать интерполяцию для оценки отсутствующих данных.
Например, вы можете использовать эту операцию для возврата интерполированных значений температуры для ветряной турбины каждые 24 часа в течение 7 дней.
Для определения свойства актива вы должны указать одно из следующего:
assetIdиpropertyIdсвойства актива.propertyAlias, который является псевдонимом потока данных (например,/company/windfarm/3/turbine/7/temperature). Для определения псевдонима свойства актива см. UpdateAssetProperty.
См. также: Документация AWS API
get-interpolated-asset-property-values — это операция с постраничной загрузкой. Для получения всего набора результатов может потребоваться несколько вызовов API. Вы можете отключить постраничную загрузку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной загрузкой аргумент --query должен извлекать данные из результатов следующих выражений запроса: interpolatedAssetPropertyValues
Синтаксис
get-interpolated-asset-property-values
[--asset-id <value>]
[--property-id <value>]
[--property-alias <value>]
--start-time-in-seconds <value>
[--start-time-offset-in-nanos <value>]
--end-time-in-seconds <value>
[--end-time-offset-in-nanos <value>]
--quality <value>
--interval-in-seconds <value>
--type <value>
[--interval-window-in-seconds <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]
Параметры
--asset-id (строка)
--property-id (строка)
--property-alias (строка)
/company/windfarm/3/turbine/7/temperature). Дополнительную информацию см. в разделе «Сопоставление промышленных потоков данных со свойствами актива» в руководстве пользователя IoT SiteWise.--start-time-in-seconds (целое число)
--start-time-offset-in-nanos (целое число)
startTimeInSeconds.--end-time-in-seconds (целое число)
--end-time-offset-in-nanos (целое число)
endTimeInSeconds.--quality (строка)
Качество значения свойства актива. Вы можете использовать этот параметр в качестве фильтра, чтобы выбрать только значения свойств актива, имеющие определенное качество.
Возможные значения:
GOODBADUNCERTAIN
--interval-in-seconds (целое число)
--type (строка)
Тип интерполяции.
Допустимые значения: LINEAR_INTERPOLATION | LOCF_INTERPOLATION
-
LINEAR_INTERPOLATION— Оценивает отсутствующие данные с помощью линейной интерполяции. Например, вы можете использовать эту операцию для возврата интерполированных значений температуры для ветряной турбины каждые 24 часа в течение 7 дней. Если интерполяция начинается 1 июля 2021 года в 9:00, IoT SiteWise возвращает первое интерполированное значение 2 июля 2021 года в 9:00, второе интерполированное значение 3 июля 2021 года в 9:00 и так далее. -
LOCF_INTERPOLATION— Оценивает отсутствующие данные с помощью интерполяции «последнего наблюдаемого значения». Если для интервала не найдено ни одной точки данных, IoT SiteWise возвращает последнюю наблюдаемую точку данных для предыдущего интервала и продолжает использовать это интерполированное значение до тех пор, пока не будет найдена новая точка данных. Например, вы можете получить состояние клапана включения/выключения каждые 24 часа в течение 7 дней. Если интерполяция начинается 1 июля 2021 года в 9:00, IoT SiteWise возвращает последнюю наблюдаемую точку данных между 1 июля 2021 года в 9:00 и 2 июля 2021 года в 9:00 в качестве первого интерполированного значения. Если точка данных не найдена после 9:00 2 июля 2021 года, IoT SiteWise использует то же интерполированное значение для остальных дней.
--interval-window-in-seconds (целое число)
Интервал запроса для окна в секундах. IoT SiteWise вычисляет каждое интерполированное значение, используя точки данных из отметки времени каждого интервала, минус окно до отметки времени каждого интервала плюс окно. Если не указано, окно варьируется от начального времени минус интервал до конечного времени плюс интервал.
Примечание
- Если вы укажете значение параметра
intervalWindowInSeconds, значение параметраtypeдолжно бытьLINEAR_INTERPOLATION. - Если в указанном окне запроса точка данных не найдена, IoT SiteWise не вернет интерполированное значение для интервала. Это указывает на пробел в точках данных, которые были загружены.
Например, вы можете получить интерполированные значения температуры для ветряной турбины каждые 24 часа в течение 7 дней. Если интерполяция начинается 1 июля 2021 года в 9:00 с окном в 2 часа, IoT SiteWise использует точки данных с 7:00 (9:00 минус 2 часа) до 11:00 (9:00 плюс 2 часа) 2 июля 2021 года для вычисления первого интерполированного значения. Далее IoT SiteWise использует точки данных с 7:00 (9:00 минус 2 часа) до 11:00 (9:00 плюс 2 часа) 3 июля 2021 года для вычисления второго интерполированного значения и так далее.
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные данные с помощью предоставленного JSON-значения, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Маркер, указывающий, где начать постраничную загрузку. Это NextToken из ранее укороченного ответа.
Примеры использования см. в разделе «Постраничная загрузка» в руководстве пользователя AWS CLI.
--page-size (целое число)
Размер каждой страницы для получения данных в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить таймаут вызовов AWS-сервиса.
Примеры использования см. в разделе «Постраничная загрузка» в руководстве пользователя AWS CLI.
--max-items (целое число)
Общее количество элементов, которые нужно вернуть в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды будет предоставлен NextToken. Чтобы продолжить постраничную загрузку, укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе «Постраничная загрузка» в руководстве пользователя AWS CLI.
--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
- text
- таблица
- 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.
Вывод
interpolatedAssetPropertyValues -> (список)
Запрашиваемые интерполированные значения.
(структура)
Содержит информацию об интерполированном значении свойства актива.
timestamp -> (структура)
Содержит отметку времени с необязательной точностью до наносекунд.
timeInSeconds -> (длинное целое)
offsetInNanos .offsetInNanos -> (целое число)
timeInSeconds .value -> (структура)
Содержит значение свойства актива (только одного типа).
stringValue -> (строка)
integerValue -> (целое число)
doubleValue -> (двойное)
booleanValue -> (булево)
nullValue -> (структура)
Тип данных null свойства актива с качествами BAD и UNCERTAIN.
valueType -> (строка)
nextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.