Dataset Records - Create Or Update

Başvuru

Hizmet:: Azure Data Manager for Agriculture

API Sürümü:: 2023-11-01-preview

Bir veri kümesi kaydı oluşturur veya güncelleştirir.

PATCH {endpoint}/datasets/{datasetId}/records/{recordId}?api-version=2023-11-01-preview

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
datasetId	path	True	string	Veri kümesi kaynağının kimliği.
endpoint	path	True	string uri	Ad alanının ana bilgisayar adı, örneğin admaInstanceName.farmbeats.azure.net
recordId	path	True	string	Veri kümesi kayıt kaynağının kimliği.
api-version	query	True	string	İstenen API sürümü

İstek Başlığı

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

Name	Gerekli	Tür	Description
Authorization	True	string	Lütfen yetkili API çağrıları için geçerli bir taşıyıcı belirteci sağlayın. Kimliği doğrulanmamış çağrıları daha önce denediyseniz tarayıcı önbelleğinizi temizlemeniz gerekebileceğini unutmayın.

İstek Gövdesi

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

Name	Tür	Description
description	string	Kaynağın metinsel açıklaması.
name	string	Kaynağı tanımlamak için ad.
properties		Kaynağa ait anahtar değer çiftleri koleksiyonu. Her çiftin anahtarı 50 karakterden büyük olmamalıdır ve 150 karakterden büyük bir değere sahip olmamalıdır. Not: Bir kaynak için en fazla 25 anahtar değer çifti sağlanabilir ve yalnızca dize, sayı ve tarih saat (yyyy-MM-ddTHH:mm:ssZ) değerleri desteklenir.
record		Kayıt nesnesi.
source	string	Kaynağın kaynağı.
status	string	Kaynağın durumu.

Yanıtlar

Name	Tür	Description
200 OK	DatasetRecord	Başarılı
201 Created	DatasetRecord	Oluşturulan
Other Status Codes	ErrorResponse	Hata Üst Bilgiler x-ms-error-code: string

Name

Tür

Description

200 OK

DatasetRecord

Başarılı

201 Created

DatasetRecord

Oluşturulan

Other Status Codes

ErrorResponse

Hata

Üst Bilgiler

x-ms-error-code: string

Güvenlik

Authorization

Lütfen yetkili API çağrıları için geçerli bir taşıyıcı belirteci sağlayın. Kimliği doğrulanmamış çağrıları daha önce denediyseniz tarayıcı önbelleğinizi temizlemeniz gerekebileceğini unutmayın.

Tür: apiKey
İçinde: header

Örnekler

DatasetRecords_CreateOrUpdate

Örnek isteği

HTTP

PATCH {endpoint}/datasets/Dataset1/records/Record1?api-version=2023-11-01-preview

{
  "record": {
    "name": "Cimegra",
    "code": "cimegra",
    "Company": "BASF",
    "MatterStateCode": "liquid",
    "RegulatorNumbers": [
      "33666"
    ],
    "ChemicalTypeCodes": [
      "insecticide"
    ],
    "ChemicalTypeNames": [
      "Insecticide"
    ],
    "SubstanceCodes": [
      "broflanilide"
    ],
    "SubstanceNames": [
      "Broflanilide"
    ],
    "SubstancePercentages": 10,
    "CreatedAtDate": "2023-05-30T11:10:21Z",
    "UpdatedAtDate": "2023-06-30T11:10:21Z"
  },
  "status": "string",
  "source": "string",
  "name": "string",
  "description": "string",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

Örnek yanıt

Durum kodu:: 200

{
  "datasetId": "Dataset1",
  "record": {
    "name": "Cimegra",
    "code": "cimegra",
    "Company": "BASF",
    "MatterStateCode": "liquid",
    "RegulatorNumbers": [
      "33666"
    ],
    "ChemicalTypeCodes": [
      "insecticide"
    ],
    "ChemicalTypeNames": [
      "Insecticide"
    ],
    "SubstanceCodes": [
      "broflanilide"
    ],
    "SubstanceNames": [
      "Broflanilide"
    ],
    "SubstancePercentages": 10,
    "CreatedAtDate": "2023-05-30T11:10:21Z",
    "UpdatedAtDate": "2023-06-30T11:10:21Z"
  },
  "id": "Record1",
  "status": "string",
  "source": "string",
  "name": "string",
  "description": "string",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  },
  "createdDateTime": "2021-04-21T06:49:30Z",
  "modifiedDateTime": "2021-04-21T06:49:30Z",
  "createdBy": "00000000-0000-0000-0000-000000000000",
  "modifiedBy": "00000000-0000-0000-0000-000000000000",
  "eTag": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

Durum kodu:: 201

{
  "datasetId": "Dataset1",
  "record": {
    "name": "Cimegra",
    "code": "cimegra",
    "Company": "BASF",
    "MatterStateCode": "liquid",
    "RegulatorNumbers": [
      "33666"
    ],
    "ChemicalTypeCodes": [
      "insecticide"
    ],
    "ChemicalTypeNames": [
      "Insecticide"
    ],
    "SubstanceCodes": [
      "broflanilide"
    ],
    "SubstanceNames": [
      "Broflanilide"
    ],
    "SubstancePercentages": 10,
    "CreatedAtDate": "2023-05-30T11:10:21Z",
    "UpdatedAtDate": "2023-06-30T11:10:21Z"
  },
  "id": "Record1",
  "status": "string",
  "source": "string",
  "name": "string",
  "description": "string",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  },
  "createdDateTime": "2021-04-21T06:49:30Z",
  "modifiedDateTime": "2021-04-21T06:49:30Z",
  "createdBy": "00000000-0000-0000-0000-000000000000",
  "modifiedBy": "00000000-0000-0000-0000-000000000000",
  "eTag": "0f8fad5b-d9cb-469f-a165-70867728950e"
}

Tanımlar

Name	Description
DatasetRecord	Veri kümesi kayıtlarının şeması.
Error	Azure AgPlatform hizmetinden bir hata.
ErrorResponse	Azure AgPlatform hizmetinden bir hata yanıtı. ErrorResponse başvuru belgesi için bkz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses .
InnerError	Hata listesini içeren iç hata. InnerError başvuru belgesi için bkz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object .

DatasetRecord

Veri kümesi kayıtlarının şeması.

Name	Tür	Description
createdBy	string	Kullanıcı/kiracı kimliği tarafından oluşturuldu.
createdDateTime	string	Kaynağın oluşturulduğu tarih-saat, örnek biçim: yyyy-MM-ddTHH:mm:ssZ.
datasetId	string	Bu kaydın Veri Kümesi Kimliği.
description	string	Kaynağın metinsel açıklaması.
eTag	string	İyimser eşzamanlılık uygulamak için ETag değeri.
id	string	Benzersiz kaynak kimliği.
modifiedBy	string	Kullanıcı/kiracı kimliği tarafından değiştirildi.
modifiedDateTime	string	Kaynağın en son değiştirildiği tarih-saat, örnek biçim: yyyy-MM-ddTHH:mm:ssZ.
name	string	Kaynağı tanımlamak için ad.
properties		Kaynağa ait anahtar değer çiftleri koleksiyonu. Her çiftin anahtarı 50 karakterden büyük olmamalıdır ve 150 karakterden büyük bir değere sahip olmamalıdır. Not: Bir kaynak için en fazla 25 anahtar değer çifti sağlanabilir ve yalnızca dize, sayı ve tarih saat (yyyy-MM-ddTHH:mm:ssZ) değerleri desteklenir.
record		Kayıt nesnesi.
source	string	Kaynağın kaynağı.
status	string	Kaynağın durumu.

Error

Azure AgPlatform hizmetinden bir hata.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesi.
details	Error[]	Bu bildirilen hataya yol açan belirli hatalarla ilgili ayrıntılar dizisi.
innererror	InnerError	Hata listesini içeren iç hata. InnerError başvuru belgesi için bkz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object .
message	string	Hatanın insan tarafından okunabilen gösterimi.
target	string	Hatanın hedefi.

ErrorResponse

Azure AgPlatform hizmetinden bir hata yanıtı. ErrorResponse başvuru belgesi için bkz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses .

Name	Tür	Description
error	Error	Azure AgPlatform hizmetinden bir hata.
traceId	string	Benzersiz izleme kimliği.

InnerError

Hata listesini içeren iç hata. InnerError başvuru belgesi için bkz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object .

Name	Tür	Description
code	string	İçeren hata tarafından sağlanandan özel hata kodu.
innererror	InnerError	Hata listesini içeren iç hata. InnerError başvuru belgesi için bkz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object .

Aracılığıyla paylaş

Dataset Records - Create Or Update

URI Parametreleri

İstek Başlığı

İstek Gövdesi

Yanıtlar

Güvenlik

Authorization

Örnekler

DatasetRecords_CreateOrUpdate

Örnek isteği

Örnek yanıt

Tanımlar

DatasetRecord

Error

ErrorResponse

InnerError

Ek kaynaklar