Sensors - Create Or Update

Usługa:

Azure Data Manager for Agriculture

Wersja interfejsu API:

2023-11-01-preview

Tworzenie jednostki czujnika.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string uri	Nazwa hosta przestrzeni nazw, np. admaInstanceName.farmbeats.azure.net
sensorId	path	True	string	Identyfikator zasobu czujnika.
sensorPartnerId	path	True	string	Identyfikator partnera czujnika.
api-version	query	True	string	Żądana wersja interfejsu API

Nagłówek żądania

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

Nazwa	Wymagane	Typ	Opis
Authorization	True	string	Podaj prawidłowy token elementu nośnego dla autoryzowanych wywołań interfejsu API. Pamiętaj, że może być konieczne wyczyszczenie pamięci podręcznej przeglądarki, jeśli wcześniej próbowano wykonać nieuwierzytelnione wywołania.

Treść żądania

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

Nazwa	Typ	Opis
depthInMeters	number[]	Głębokość każdej miary czujnika w metrach. Podobnie jak wilgotność czujnika na 2m, 4m, 6m.
description	string	Tekstowy opis zasobu.
deviceId	string	Identyfikator skojarzonego urządzenia.
hardwareId	string	Identyfikator skojarzonego sprzętu.
integrationId	string	Identyfikator integracji dla urządzenia.
location	Location	Location model class (Klasa modelu lokalizacji).
name	string	Nazwa identyfikującego zasób.
port	Port	Schemat przechowywania wartości portów.
properties		Kolekcja par klucz-wartość, która należy do zasobu. Każda para nie może mieć klucza większego niż 50 znaków i nie może mieć wartości większej niż 150 znaków. Uwaga: dla zasobu można podać maksymalnie 25 par wartości klucza, a obsługiwane są tylko wartości ciągu, liczb i daty/godziny (rrrr-MM-ddTHH:mm:ssZ).
sensorDataModelId	string	Identyfikator skojarzonego modelu danych czujnika.
status	string	Stan zasobu.
type	string	Typ czujnika.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Sensor	Powodzenie
201 Created	Sensor	Utworzone
Other Status Codes	ErrorResponse	Błąd Nagłówki x-ms-error-code: string

Zabezpieczenia

Authorization

Podaj prawidłowy token elementu nośnego dla autoryzowanych wywołań interfejsu API. Pamiętaj, że może być konieczne wyczyszczenie pamięci podręcznej przeglądarki, jeśli wcześniej próbowano wykonać nieuwierzytelnione wywołania.

Typ: apiKey
W: header

Przykłady

Sensors_CreateOrUpdate

Przykładowe żądanie

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
  }
}

Przykładowa odpowiedź

Kod stanu:

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
  }
}

Kod stanu:

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
  }
}

Definicje

Nazwa	Opis
Error	Błąd usługi Azure AgPlatform.
ErrorResponse	Odpowiedź na błąd z usługi Azure AgPlatform. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses dokument referencyjny ErrorResponse.
InnerError	Błąd wewnętrzny zawierający listę błędów. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object dokumentację dotyczącą błędu wewnętrznego.
Location	Location model class (Klasa modelu lokalizacji).
Port	Schemat przechowywania wartości portów.
Sensor	Model interfejsu API czujnika.

Error

Błąd usługi Azure AgPlatform.

Nazwa	Typ	Opis
code	string	Zdefiniowany przez serwer zestaw kodów błędów.
details	Error[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
innererror	InnerError	Błąd wewnętrzny zawierający listę błędów. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object dokumentację dotyczącą błędu wewnętrznego.
message	string	Czytelna dla człowieka reprezentacja błędu.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd z usługi Azure AgPlatform. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses dokument referencyjny ErrorResponse.

Nazwa	Typ	Opis
error	Error	Błąd usługi Azure AgPlatform.
traceId	string	Unikatowy identyfikator śledzenia.

InnerError

Błąd wewnętrzny zawierający listę błędów. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object dokumentację dotyczącą błędu wewnętrznego.

Nazwa	Typ	Opis
code	string	Określony kod błędu niż został dostarczony przez błąd zawierający.
innererror	InnerError	Błąd wewnętrzny zawierający listę błędów. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object dokumentację dotyczącą błędu wewnętrznego.

Location

Location model class (Klasa modelu lokalizacji).

Nazwa	Typ	Opis
latitude	number	Szerokość geograficzna lokalizacji.
longitude	number	Długość geograficzna lokalizacji.

Port

Schemat przechowywania wartości portów.

Nazwa	Typ	Opis
name	string	Nazwa portu.
type	string	Typ portu cyfrowy/analogowy.

Sensor

Model interfejsu API czujnika.

Nazwa	Typ	Opis
createdBy	string	Utworzony przez identyfikator użytkownika/dzierżawy.
createdDateTime	string	Data i godzina utworzenia zasobu, format próbki: rrrr-MM-ddTHH:mm:ssZ.
depthInMeters	number[]	Głębokość każdej miary czujnika w metrach. Podobnie jak wilgotność czujnika na 2m, 4m, 6m.
description	string	Tekstowy opis zasobu.
deviceId	string	Identyfikator skojarzonego urządzenia.
eTag	string	Wartość ETag w celu zaimplementowania optymistycznej współbieżności.
hardwareId	string	Identyfikator skojarzonego sprzętu.
id	string	Identyfikator zasobu.
integrationId	string	Identyfikator integracji dla urządzenia.
location	Location	Location model class (Klasa modelu lokalizacji).
modifiedBy	string	Zmodyfikowane przez identyfikator użytkownika/dzierżawy.
modifiedDateTime	string	Data i godzina ostatniej modyfikacji zasobu, format próbki: rrrr-MM-ddTHH:mm:ssZ.
name	string	Nazwa identyfikującego zasób.
port	Port	Schemat przechowywania wartości portów.
properties		Kolekcja par klucz-wartość, która należy do zasobu. Każda para nie może mieć klucza większego niż 50 znaków i nie może mieć wartości większej niż 150 znaków. Uwaga: dla zasobu można podać maksymalnie 25 par wartości klucza, a obsługiwane są tylko wartości ciągu, liczb i daty/godziny (rrrr-MM-ddTHH:mm:ssZ).
sensorDataModelId	string	Identyfikator skojarzonego modelu danych czujnika.
sensorPartnerId	string	Identyfikator skojarzonego partnera czujnika.
status	string	Stan zasobu.
type	string	Typ czujnika.