Sensors - Create Or Update

Servizio:

Azure Data Manager for Agriculture

Versione API:

2023-11-01-preview

Creare un'entità sensore.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	Nome host dello spazio dei nomi, ad esempio admaInstanceName.farmbeats.azure.net
sensorId	path	True	string	ID della risorsa del sensore.
sensorPartnerId	path	True	string	ID del partner del sensore.
api-version	query	True	string	Versione dell'API richiesta

Intestazione della richiesta

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

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Specificare un token di connessione valido per le chiamate API autorizzate. Si noti che potrebbe essere necessario cancellare la cache del browser se si è tentato di eseguire chiamate non autenticate prima.

Corpo della richiesta

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

Nome	Tipo	Descrizione
depthInMeters	number[] (double)	Profondità di ogni misura del sensore in metri. Come l'umidità del sensore a 2m, 4m, 6m.
description	string minLength: 0 maxLength: 500	Descrizione testuale della risorsa.
deviceId	string	ID del dispositivo associato.
hardwareId	string	ID dell'hardware associato.
integrationId	string	ID di integrazione per il dispositivo.
location	Location	Classe del modello di posizione.
name	string minLength: 0 maxLength: 100	Nome per identificare la risorsa.
port	Port	Schema per l'archiviazione dei valori di porta.
properties		Raccolta di coppie chiave-valore che appartengono alla risorsa. Ogni coppia non deve avere una chiave maggiore di 50 caratteri e non deve avere un valore maggiore di 150 caratteri. Nota: è possibile specificare un massimo di 25 coppie di valori chiave per una risorsa e solo valori stringa, numerali e datetime (aaaa-MM-ggTHH:mm:ssZ).
sensorDataModelId	string	ID del modello di dati del sensore associato.
status	string minLength: 0 maxLength: 100	Stato della risorsa.
type	string minLength: 0 maxLength: 100	Tipo di sensore.

Risposte

Nome	Tipo	Descrizione
200 OK	Sensor	Successo
201 Created	Sensor	Creato
Other Status Codes	ErrorResponse	Errore Intestazioni x-ms-error-code: string

Sicurezza

Authorization

Specificare un token di connessione valido per le chiamate API autorizzate. Si noti che potrebbe essere necessario cancellare la cache del browser se si è tentato di eseguire chiamate non autenticate prima.

Tipo: apiKey
In: header

Esempio

Sensors_CreateOrUpdate

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

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

Definizioni

Nome	Descrizione
Error	Errore del servizio Azure AgPlatform.
ErrorResponse	Risposta di errore dal servizio Azure AgPlatform. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses per il documento di riferimento ErrorResponse.
InnerError	Errore interno contenente l'elenco degli errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object per il documento di riferimento su InnerError.
Location	Classe del modello di posizione.
Port	Schema per l'archiviazione dei valori di porta.
Sensor	Modello API del sensore.

Error

Object

Errore del servizio Azure AgPlatform.

Nome	Tipo	Descrizione
code	string minLength: 1	Set definito dal server di codici di errore.
details	Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	InnerError	Errore interno contenente l'elenco degli errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object per il documento di riferimento su InnerError.
message	string minLength: 1	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore dal servizio Azure AgPlatform. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses per il documento di riferimento ErrorResponse.

Nome	Tipo	Descrizione
error	Error	Errore del servizio Azure AgPlatform.
traceId	string	ID traccia univoco.

InnerError

Object

Errore interno contenente l'elenco degli errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object per il documento di riferimento su InnerError.

Nome	Tipo	Descrizione
code	string	Codice di errore specifico di quello fornito dall'errore contenitore.
innererror	InnerError	Errore interno contenente l'elenco degli errori. Vedere https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object per il documento di riferimento su InnerError.

Location

Object

Classe del modello di posizione.

Nome	Tipo	Descrizione
latitude	number (double) minimum: -90 maximum: 90	Latitudine della posizione.
longitude	number (double) minimum: -180 maximum: 180	Longitudine della posizione.

Port

Object

Schema per l'archiviazione dei valori di porta.

Nome	Tipo	Descrizione
name	string minLength: 1 maxLength: 50	Nome della porta.
type	string minLength: 0 maxLength: 100	Tipo di porta digitale/analogico.

Sensor

Object

Modello API del sensore.

Nome	Tipo	Descrizione
createdBy	string	Creato dall'ID utente/tenant.
createdDateTime	string (date-time)	Data e ora di creazione della risorsa, formato di esempio: aaaa-MM-ggTHH:mm:ssZ.
depthInMeters	number[] (double)	Profondità di ogni misura del sensore in metri. Come l'umidità del sensore a 2m, 4m, 6m.
description	string minLength: 0 maxLength: 500	Descrizione testuale della risorsa.
deviceId	string	ID del dispositivo associato.
eTag	string	Valore ETag per implementare la concorrenza ottimistica.
hardwareId	string	ID dell'hardware associato.
id	string	ID della risorsa.
integrationId	string	ID di integrazione per il dispositivo.
location	Location	Classe del modello di posizione.
modifiedBy	string	Modificato dall'ID utente/tenant.
modifiedDateTime	string (date-time)	Data e ora dell'ultima modifica della risorsa, formato di esempio: aaaa-MM-ggTHH:mm:ssZ.
name	string minLength: 0 maxLength: 100	Nome per identificare la risorsa.
port	Port	Schema per l'archiviazione dei valori di porta.
properties		Raccolta di coppie chiave-valore che appartengono alla risorsa. Ogni coppia non deve avere una chiave maggiore di 50 caratteri e non deve avere un valore maggiore di 150 caratteri. Nota: è possibile specificare un massimo di 25 coppie di valori chiave per una risorsa e solo valori stringa, numerali e datetime (aaaa-MM-ggTHH:mm:ssZ).
sensorDataModelId	string	ID del modello di dati del sensore associato.
sensorPartnerId	string	ID del partner sensore associato.
status	string minLength: 0 maxLength: 100	Stato della risorsa.
type	string minLength: 0 maxLength: 100	Tipo di sensore.