Sensor Data Models - Create Or Update

Referensi

Layanan:: Azure Data Manager for Agriculture

Versi API:: 2023-11-01-preview

Membuat entitas model data sensor.

PATCH {endpoint}/sensor-partners/{sensorPartnerId}/sensor-data-models/{sensorDataModelId}?api-version=2023-11-01-preview

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string uri	Nama host namespace layanan, misalnya admaInstanceName.farmbeats.azure.net
sensorDataModelId	path	True	string	Id model data sensor.
sensorPartnerId	path	True	string	Id mitra sensor.
api-version	query	True	string	Versi API yang diminta

Header Permintaan

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

Nama	Diperlukan	Jenis	Deskripsi
Authorization	True	string	Harap berikan token pembawa yang valid untuk panggilan API resmi. Perhatikan bahwa Anda mungkin perlu menghapus cache browser jika Anda mencoba panggilan yang tidak diautentikasi sebelumnya.

Isi Permintaan

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

Nama	Diperlukan	Jenis	Deskripsi
measures	True	<string, SensorDataModelMeasure>	Peta jenis sensor ke ukuran sensor.
description		string	Deskripsi tekstual dari sumber daya.
manufacturer		string	Produsen sensor.
name		string	Nama untuk mengidentifikasi sumber daya.
productCode		string	ProductCode sensor.
properties			Kumpulan pasangan nilai kunci milik sumber daya. Setiap pasangan tidak boleh memiliki kunci yang lebih besar dari 50 karakter dan tidak boleh memiliki nilai yang lebih besar dari 150 karakter. Catatan: Maksimum 25 pasangan nilai kunci dapat disediakan untuk sumber daya dan hanya nilai string, angka, dan tanggalwaktu (yyyy-MM-ddTHH:mm:ssZ) yang didukung.
status		string	Status sumber daya.
type		string	Jenis sensor.

Respons

Nama	Jenis	Deskripsi
200 OK	SensorDataModel	Berhasil
201 Created	SensorDataModel	Dibuat
Other Status Codes	ErrorResponse	Kesalahan Header x-ms-error-code: string

Nama

Jenis

Deskripsi

200 OK

SensorDataModel

Berhasil

201 Created

SensorDataModel

Dibuat

Other Status Codes

ErrorResponse

Kesalahan

Header

x-ms-error-code: string

Keamanan

Authorization

Harap berikan token pembawa yang valid untuk panggilan API resmi. Perhatikan bahwa Anda mungkin perlu menghapus cache browser jika Anda mencoba panggilan yang tidak diautentikasi sebelumnya.

Jenis: apiKey
Dalam: header

Contoh

SensorDataModels_CreateOrUpdate

Permintaan sampel

HTTP

PATCH {endpoint}/sensor-partners/sp1/sensor-data-models/sdm124?api-version=2023-11-01-preview

{
  "type": "Sensor",
  "manufacturer": "Some sensor manufacturer",
  "productCode": "soil m",
  "measures": {
    "soilMoisture": {
      "description": "measures soil moisture",
      "dataType": "Bool",
      "type": "sm",
      "unit": "none",
      "properties": {
        "abc": "def",
        "elevation": 5
      }
    }
  },
  "status": "new",
  "name": "my sdm for soil moisture",
  "description": "description goes here",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

Respon sampel

Kode status:: 200

{
  "type": "Sensor",
  "manufacturer": "Some sensor manufacturer",
  "productCode": "soil m",
  "measures": {
    "soilMoisture": {
      "description": "measures soil moisture",
      "dataType": "Bool",
      "type": "sm",
      "unit": "none",
      "properties": {
        "abc": "def",
        "elevation": 5
      }
    }
  },
  "sensorPartnerId": "sp1",
  "id": "sdm124",
  "status": "new",
  "createdDateTime": "2022-01-24T06:12:15Z",
  "modifiedDateTime": "2022-01-24T06:12:42Z",
  "eTag": "040161a2-0000-0700-0000-61ee435a0000",
  "name": "my sdm for soil moisture",
  "description": "description goes here",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

Kode status:: 201

{
  "type": "Sensor",
  "manufacturer": "Some sensor manufacturer",
  "productCode": "soil m",
  "measures": {
    "soilMoisture": {
      "description": "measures soil moisture",
      "dataType": "Bool",
      "type": "sm",
      "unit": "none",
      "properties": {
        "abc": "def",
        "elevation": 5
      }
    }
  },
  "sensorPartnerId": "sp1",
  "id": "sdm124",
  "status": "new",
  "createdDateTime": "2022-01-24T06:12:15Z",
  "modifiedDateTime": "2022-01-24T06:12:15Z",
  "eTag": "040158a0-0000-0700-0000-61ee433f0000",
  "name": "my sdm for soil moisture",
  "description": "description goes here",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

Definisi

Nama	Deskripsi
Error	Kesalahan dari layanan Azure AgPlatform.
ErrorResponse	Respons kesalahan dari layanan Azure AgPlatform. Lihat https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses untuk dokumen referensi ErrorResponse.
InnerError	Kesalahan dalam yang berisi daftar kesalahan. Lihat https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object untuk dokumen referensi InnerError.
SensorDataModel	Model API SensorModel.
SensorDataModelMeasure	Detail pengukuran model sensor.
SensorDataType	Jenis data pengukuran sensor.

Error

Kesalahan dari layanan Azure AgPlatform.

Nama	Jenis	Deskripsi
code	string	Sekumpulan kode kesalahan yang ditentukan server.
details	Error[]	Array detail tentang kesalahan tertentu yang menyebabkan kesalahan yang dilaporkan ini.
innererror	InnerError	Kesalahan dalam yang berisi daftar kesalahan. Lihat https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object untuk dokumen referensi InnerError.
message	string	Representasi kesalahan yang dapat dibaca manusia.
target	string	Target kesalahan.

ErrorResponse

Respons kesalahan dari layanan Azure AgPlatform. Lihat https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses untuk dokumen referensi ErrorResponse.

Nama	Jenis	Deskripsi
error	Error	Kesalahan dari layanan Azure AgPlatform.
traceId	string	Id pelacakan unik.

InnerError

Kesalahan dalam yang berisi daftar kesalahan. Lihat https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object untuk dokumen referensi InnerError.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan tertentu daripada yang disediakan oleh kesalahan yang berisi.
innererror	InnerError	Kesalahan dalam yang berisi daftar kesalahan. Lihat https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object untuk dokumen referensi InnerError.

SensorDataModel

Model API SensorModel.

Nama	Jenis	Deskripsi
createdBy	string	Dibuat oleh id pengguna/penyewa.
createdDateTime	string	Tanggal-waktu ketika sumber daya dibuat, format sampel: yyyy-MM-ddTHH:mm:ssZ.
description	string	Deskripsi tekstual dari sumber daya.
eTag	string	Nilai ETag untuk menerapkan konkurensi optimis.
id	string	Id sumber daya.
manufacturer	string	Produsen sensor.
measures	<string, SensorDataModelMeasure>	Peta jenis sensor ke ukuran sensor.
modifiedBy	string	Dimodifikasi oleh id pengguna/penyewa.
modifiedDateTime	string	Tanggal-waktu ketika sumber daya terakhir dimodifikasi, format sampel: yyyy-MM-ddTHH:mm:ssZ.
name	string	Nama untuk mengidentifikasi sumber daya.
productCode	string	ProductCode sensor.
properties		Kumpulan pasangan nilai kunci milik sumber daya. Setiap pasangan tidak boleh memiliki kunci yang lebih besar dari 50 karakter dan tidak boleh memiliki nilai yang lebih besar dari 150 karakter. Catatan: Maksimum 25 pasangan nilai kunci dapat disediakan untuk sumber daya dan hanya nilai string, angka, dan tanggalwaktu (yyyy-MM-ddTHH:mm:ssZ) yang didukung.
sensorPartnerId	string	Id mitra sensor terkait.
status	string	Status sumber daya.
type	string	Jenis sensor.

SensorDataModelMeasure

Detail pengukuran model sensor.

Nama	Jenis	Deskripsi
dataType	SensorDataType	Jenis data pengukuran sensor.
description	string	Deskripsi ukuran sensor.
properties		Kumpulan pasangan nilai kunci untuk model data sensor. Setiap pasangan tidak boleh memiliki kunci yang lebih besar dari 50 karakter dan tidak boleh memiliki nilai yang lebih besar dari 150 karakter. Catatan: Maksimum 25 pasangan nilai kunci dapat disediakan untuk model dan hanya nilai string, angka, dan tanggalwaktu (yyyy-MM-ddTHH:mm:ssZ) yang didukung.
type	string	Jenis pengukuran data sensor.
unit	string	Satuan ukuran sensor.

SensorDataType

Jenis data pengukuran sensor.

Nama	Jenis	Deskripsi
Bool	string
DateTime	string
Double	string
Long	string
String	string

Bagikan melalui

Sensor Data Models - Create Or Update

Parameter URI

Header Permintaan

Isi Permintaan

Respons

Keamanan

Authorization

Contoh

SensorDataModels_CreateOrUpdate

Permintaan sampel

Respon sampel

Definisi

Error

ErrorResponse

InnerError

SensorDataModel

SensorDataModelMeasure

SensorDataType

Sumber Daya Tambahan: