Sensors - Create Or Update

Ссылка

Служба:: Azure Data Manager for Agriculture

Версия API:: 2023-11-01-preview

Создание сущности датчика.

PATCH {endpoint}/sensor-partners/{sensorPartnerId}/sensors/{sensorId}?api-version=2023-11-01-preview

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string (uri)	Имя узла пространства имен, например admaInstanceName.farmbeats.azure.net
sensorId	path	True	string	Идентификатор ресурса датчика.
sensorPartnerId	path	True	string	Идентификатор партнера датчика.
api-version	query	True	string	Запрошенная версия API

Заголовок запроса

Media Types: "application/merge-patch+json"

Имя	Обязательно	Тип	Описание
Authorization	True	string	Укажите действительный маркер носителя для авторизованных вызовов API. Обратите внимание, что может потребоваться очистить кэш браузера, если вы ранее попытались отменить проверку подлинности вызовов.

Текст запроса

Media Types: "application/merge-patch+json"

Имя	Тип	Описание
depthInMeters	number[] (double)	Глубина каждой измерения датчика в метрах. Как и влажность датчика в 2 м, 4 м, 6 млн.
description	string minLength: 0 maxLength: 500	Текстовое описание ресурса.
deviceId	string	Идентификатор связанного устройства.
hardwareId	string	Идентификатор связанного оборудования.
integrationId	string	Идентификатор интеграции для устройства.
location	Location	Класс модели расположения.
name	string minLength: 0 maxLength: 100	Имя для идентификации ресурса.
port	Port	Схема хранения значений портов.
properties		Коллекция пар значений ключей, принадлежащих ресурсу. Каждая пара не должна иметь ключ больше 50 символов и не должна иметь значение больше 150 символов. Примечание. Поддерживаются не более 25 пар значений ключей для ресурса и только строк, числовых и датовых значений (гггг-ММ-ддTHH:мм:ssZ).
sensorDataModelId	string	Идентификатор связанной модели данных датчика.
status	string minLength: 0 maxLength: 100	Состояние ресурса.
type	string minLength: 0 maxLength: 100	Тип датчика.

Ответы

Имя	Тип	Описание
200 OK	Sensor	Успех
201 Created	Sensor	Создано
Other Status Codes	ErrorResponse	Ошибка Заголовки x-ms-error-code: string

Имя

Тип

Описание

200 OK

Sensor

Успех

201 Created

Sensor

Создано

Other Status Codes

ErrorResponse

Ошибка

Заголовки

x-ms-error-code: string

Безопасность

Authorization

Укажите действительный маркер носителя для авторизованных вызовов API. Обратите внимание, что может потребоваться очистить кэш браузера, если вы ранее попытались отменить проверку подлинности вызовов.

Тип: apiKey
В: header

Примеры

Sensors_CreateOrUpdate

Образец запроса

HTTP

PATCH {endpoint}/sensor-partners/sp1/sensors/s124?api-version=2023-11-01-preview

{
  "sensorDataModelId": "sdm124",
  "integrationId": "string",
  "hardwareId": "SMHD 456",
  "deviceId": "d124",
  "type": "SM",
  "location": {
    "latitude": 23.5,
    "longitude": 42.7
  },
  "port": {
    "name": "measure",
    "type": "digital"
  },
  "status": "sm created",
  "name": "my new sm",
  "description": "description for sensor goes here",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

Пример ответа

Код состояния:: 200

{
  "sensorDataModelId": "sdm124",
  "integrationId": "string",
  "hardwareId": "SMHD-456",
  "deviceId": "d124",
  "type": "SM",
  "location": {
    "latitude": 23.5,
    "longitude": 42.7
  },
  "port": {
    "name": "measure",
    "type": "digital"
  },
  "sensorPartnerId": "sp1",
  "id": "s124",
  "status": "sm created",
  "createdDateTime": "2022-01-24T06:27:05Z",
  "modifiedDateTime": "2022-01-24T06:27:05Z",
  "eTag": "040139eb-0000-0700-0000-61ee46b90000",
  "name": "my new sm",
  "description": "description for sensor goes here",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

Код состояния:: 201

{
  "sensorDataModelId": "sdm124",
  "integrationId": "string",
  "hardwareId": "SMHD-456",
  "deviceId": "d124",
  "type": "SM",
  "location": {
    "latitude": 23.5,
    "longitude": 42.7
  },
  "port": {
    "name": "measure",
    "type": "digital"
  },
  "sensorPartnerId": "sp1",
  "id": "s124",
  "status": "sm created",
  "createdDateTime": "2022-01-24T06:27:05Z",
  "modifiedDateTime": "2022-01-24T06:27:05Z",
  "eTag": "040139eb-0000-0700-0000-61ee46b90000",
  "name": "my new sm",
  "description": "description for sensor goes here",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

Определения

Имя	Описание
Error	Ошибка из службы Azure AgPlatform.
ErrorResponse	Ответ об ошибке службы Azure AgPlatform. Справочный документ ErrorResponse см. в https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
InnerError	Внутренняя ошибка, содержащая список ошибок. См. https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object справочный документ InnerError.
Location	Класс модели расположения.
Port	Схема хранения значений портов.
Sensor	Модель API датчика.

Error

Object

Ошибка из службы Azure AgPlatform.

Имя	Тип	Описание
code	string minLength: 1	Определяемый сервером набор кодов ошибок.
details	Error[]	Массив сведений об определенных ошибках, которые привели к этой сообщаемой ошибке.
innererror	InnerError	Внутренняя ошибка, содержащая список ошибок. См. https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object справочный документ InnerError.
message	string minLength: 1	Читаемое человеком представление ошибки.
target	string	Цель ошибки.

ErrorResponse

Object

Ответ об ошибке службы Azure AgPlatform. Справочный документ ErrorResponse см. в https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Имя	Тип	Описание
error	Error	Ошибка из службы Azure AgPlatform.
traceId	string	Уникальный идентификатор трассировки.

InnerError

Object

Внутренняя ошибка, содержащая список ошибок. См. https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object справочный документ InnerError.

Имя	Тип	Описание
code	string	Определенный код ошибки, чем был предоставлен содержащей ошибкой.
innererror	InnerError	Внутренняя ошибка, содержащая список ошибок. См. https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object справочный документ InnerError.

Location

Object

Класс модели расположения.

Имя	Тип	Описание
latitude	number (double) minimum: -90 maximum: 90	Широта расположения.
longitude	number (double) minimum: -180 maximum: 180	Долгота расположения.

Port

Object

Схема хранения значений портов.

Имя	Тип	Описание
name	string minLength: 1 maxLength: 50	Имя порта.
type	string minLength: 0 maxLength: 100	Тип порта digital/analog.

Sensor

Object

Модель API датчика.

Имя	Тип	Описание
createdBy	string	Создан идентификатором пользователя или клиента.
createdDateTime	string (date-time)	Дата создания ресурса, пример формата: гггг-ММ-ддTHH:мм:ssZ.
depthInMeters	number[] (double)	Глубина каждой измерения датчика в метрах. Как и влажность датчика в 2 м, 4 м, 6 млн.
description	string minLength: 0 maxLength: 500	Текстовое описание ресурса.
deviceId	string	Идентификатор связанного устройства.
eTag	string	Значение ETag для реализации оптимистического параллелизма.
hardwareId	string	Идентификатор связанного оборудования.
id	string	Идентификатор ресурса.
integrationId	string	Идентификатор интеграции для устройства.
location	Location	Класс модели расположения.
modifiedBy	string	Изменен идентификатором пользователя или клиента.
modifiedDateTime	string (date-time)	Дата и время последнего изменения ресурса: формат yy-MM-ddTHH:mm:ssZ.
name	string minLength: 0 maxLength: 100	Имя для идентификации ресурса.
port	Port	Схема хранения значений портов.
properties		Коллекция пар значений ключей, принадлежащих ресурсу. Каждая пара не должна иметь ключ больше 50 символов и не должна иметь значение больше 150 символов. Примечание. Поддерживаются не более 25 пар значений ключей для ресурса и только строк, числовых и датовых значений (гггг-ММ-ддTHH:мм:ssZ).
sensorDataModelId	string	Идентификатор связанной модели данных датчика.
sensorPartnerId	string	Идентификатор связанного партнера датчика.
status	string minLength: 0 maxLength: 100	Состояние ресурса.
type	string minLength: 0 maxLength: 100	Тип датчика.

Поделиться через

Sensors - Create Or Update

Параметры URI

Заголовок запроса

Текст запроса

Ответы

Безопасность

Authorization

Примеры

Sensors_CreateOrUpdate

Образец запроса

Пример ответа

Определения

Error

ErrorResponse

InnerError

Location

Port

Sensor