Sensors - Create Or Update

Referens

Tjänst:: Azure Data Manager for Agriculture

API-version:: 2023-11-01-preview

Skapa en sensorentitet.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string uri	Namnområdets värdnamn, t.ex. admaInstanceName.farmbeats.azure.net
sensorId	path	True	string	ID för sensorresursen.
sensorPartnerId	path	True	string	ID för sensorpartnern.
api-version	query	True	string	Den begärda API-versionen

Begärandehuvud

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

Name	Obligatorisk	Typ	Description
Authorization	True	string	Ange en giltig ägartoken för auktoriserade API-anrop. Observera att du kan behöva rensa webbläsarens cacheminne om du har provat oautentiserade anrop tidigare.

Begärandetext

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

Name	Typ	Description
depthInMeters	number[]	Djup för varje sensormått i mätare. Som sensorfuktighet på 2m, 4m, 6m.
description	string	Textbeskrivning av resursen.
deviceId	string	ID för den associerade enheten.
hardwareId	string	ID för den associerade maskinvaran.
integrationId	string	Integrations-ID för enheten.
location	Location	Platsmodellklass.
name	string	Namn för att identifiera resurs.
port	Port	Schema för lagring av portvärden.
properties		En samling nyckelvärdepar som tillhör resursen. Varje par får inte ha en nyckel som är större än 50 tecken och får inte ha ett värde som är större än 150 tecken. Obs! Högst 25 nyckelvärdepar kan anges för en resurs och endast värden för sträng, siffror och datetime (åååå-MM-ddTHH:mm:ssZ) stöds.
sensorDataModelId	string	ID för den associerade sensordatamodellen.
status	string	Status för resursen.
type	string	Typ av sensor.

Svar

Name	Typ	Description
200 OK	Sensor	Klart
201 Created	Sensor	Skapad
Other Status Codes	ErrorResponse	Fel Sidhuvuden x-ms-error-code: string

Name

Typ

Description

200 OK

Sensor

Klart

201 Created

Sensor

Skapad

Other Status Codes

ErrorResponse

Fel

Sidhuvuden

x-ms-error-code: string

Säkerhet

Authorization

Ange en giltig ägartoken för auktoriserade API-anrop. Observera att du kan behöva rensa webbläsarens cacheminne om du har provat oautentiserade anrop tidigare.

Typ: apiKey
I: header

Exempel

Sensors_CreateOrUpdate

Exempelbegäran

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

Exempelsvar

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

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

Definitioner

Name	Description
Error	Ett fel från Azure AgPlatform-tjänsten.
ErrorResponse	Ett felsvar från Azure AgPlatform-tjänsten. Se https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses för ErrorResponse-referensdokument.
InnerError	Inre fel som innehåller en lista över fel. Mer information https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object finns i referensdokumentet för InnerError.
Location	Platsmodellklass.
Port	Schema för lagring av portvärden.
Sensor	Sensor-API-modell.

Error

Ett fel från Azure AgPlatform-tjänsten.

Name	Typ	Description
code	string	Serverdefinierad uppsättning felkoder.
details	Error[]	Matris med information om specifika fel som ledde till det rapporterade felet.
innererror	InnerError	Inre fel som innehåller en lista över fel. Mer information https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object finns i referensdokumentet för InnerError.
message	string	Mänsklig läsbar representation av felet.
target	string	Målet för felet.

ErrorResponse

Ett felsvar från Azure AgPlatform-tjänsten. Se https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses för ErrorResponse-referensdokument.

Name	Typ	Description
error	Error	Ett fel från Azure AgPlatform-tjänsten.
traceId	string	Unikt spårnings-ID.

InnerError

Inre fel som innehåller en lista över fel. Mer information https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object finns i referensdokumentet för InnerError.

Name	Typ	Description
code	string	Specifik felkod än vad som angavs av det innehållande felet.
innererror	InnerError	Inre fel som innehåller en lista över fel. Mer information https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object finns i referensdokumentet för InnerError.

Location

Platsmodellklass.

Name	Typ	Description
latitude	number	Latitud för platsen.
longitude	number	Longitud för platsen.

Port

Schema för lagring av portvärden.

Name	Typ	Description
name	string	Namnet på porten.
type	string	Typ av port digital/analog.

Sensor

Sensor-API-modell.

Name	Typ	Description
createdBy	string	Skapat av användar-/klient-ID.
createdDateTime	string	Datum-tid när resursen skapades, exempelformat: ååå-MM-ddTHH:mm:ssZ.
depthInMeters	number[]	Djup för varje sensormått i mätare. Som sensorfuktighet på 2m, 4m, 6m.
description	string	Textbeskrivning av resursen.
deviceId	string	ID för den associerade enheten.
eTag	string	ETag-värdet för att implementera optimistisk samtidighet.
hardwareId	string	ID för den associerade maskinvaran.
id	string	ID för resursen.
integrationId	string	Integrations-ID för enheten.
location	Location	Platsmodellklass.
modifiedBy	string	Ändrat av användar-/klientorganisations-ID.
modifiedDateTime	string	Datum-tid när resursen senast ändrades, exempelformat: ååååå-MM-ddTHH:mm:ssZ.
name	string	Namn för att identifiera resurs.
port	Port	Schema för lagring av portvärden.
properties		En samling nyckelvärdepar som tillhör resursen. Varje par får inte ha en nyckel som är större än 50 tecken och får inte ha ett värde som är större än 150 tecken. Obs! Högst 25 nyckelvärdepar kan anges för en resurs och endast värden för sträng, siffror och datetime (åååå-MM-ddTHH:mm:ssZ) stöds.
sensorDataModelId	string	ID för den associerade sensordatamodellen.
sensorPartnerId	string	ID för den associerade sensorpartnern.
status	string	Status för resursen.
type	string	Typ av sensor.

Dela via

Sensors - Create Or Update

URI-parametrar

Begärandehuvud

Begärandetext

Svar

Säkerhet

Authorization

Exempel

Sensors_CreateOrUpdate

Exempelbegäran

Exempelsvar

Definitioner

Error

ErrorResponse

InnerError

Location

Port

Sensor

Ytterligare resurser