Farm Equipments - Create Or Update

Referencia

Szolgáltatás:: Azure Data Manager for Agriculture

API-verzió:: 2023-11-01-preview

Létrehoz vagy frissít egy farmeszköz-erőforrást.

PATCH {endpoint}/farm-equipments/{farmEquipmentId}?api-version=2023-11-01-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	A névtér gazdagépneve, például admaInstanceName.farmbeats.azure.net
farmEquipmentId	path	True	string	A farmeszköz-erőforrás azonosítója.
api-version	query	True	string	A kért API-verzió

Kérelem fejléce

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

Name	Kötelező	Típus	Description
Authorization	True	string	Adjon meg érvényes tulajdonosi jogkivonatot az engedélyezett API-hívásokhoz. Vegye figyelembe, hogy előfordulhat, hogy törölnie kell a böngésző gyorsítótárát, ha korábban nem hitelesített hívásokat próbált meg.

Kérelem törzse

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

Name	Típus	Description
brand	string	A vegyi termék kereskedelmi márkája.
company	Company	A vállalat/gyártó adatai.
cropIds	string[]	A vegyi termékhez társított növények azonosítói. Megjegyzés: A cropProduct termékhez legfeljebb 25 növény társítható.
description	string minLength: 0 maxLength: 500	Az erőforrás szöveges leírása.
location	string	Terület, ahol a berendezést használják.
model	string	A farmberendezés modellszáma.
name	string minLength: 0 maxLength: 100	Az erőforrás azonosítására szolgáló név.
ownership	string	Saját tulajdonú, bérelt, megosztott stb.
properties		Az erőforráshoz tartozó kulcsértékpárok gyűjteménye. Minden párnak nem lehet 50 karakternél nagyobb kulcsa, és nem lehet 150 karakternél nagyobb érték. Megjegyzés: Egy erőforráshoz legfeljebb 25 kulcsértékpár adható meg, és csak a sztring, a szám és a datetime (yyyy-MM-ddTHH:mm:ssZ) értékek támogatottak.
reference	Reference	Hivatkozás adathalmazrekordra.
serial	string	A farmberendezés sorozatszáma.
series	string	A farmberendezés sorozatszáma.
source	string minLength: 2 maxLength: 100	Az erőforrás forrása.
status	string minLength: 0 maxLength: 100	Az erőforrás állapota.
type	string	A mezőgazdasági berendezések típusa (Tiller, Sower, harvester, Sprayer, ...).

Válaszok

Name	Típus	Description
200 OK	FarmEquipment	Siker
201 Created	FarmEquipment	Létrehozott
Other Status Codes	ErrorResponse	Hiba Fejlécek x-ms-error-code: string

Name

Típus

Description

200 OK

FarmEquipment

Siker

201 Created

FarmEquipment

Létrehozott

Other Status Codes

ErrorResponse

Hiba

Fejlécek

x-ms-error-code: string

Biztonság

Authorization

Adjon meg érvényes tulajdonosi jogkivonatot az engedélyezett API-hívásokhoz. Vegye figyelembe, hogy előfordulhat, hogy törölnie kell a böngésző gyorsítótárát, ha korábban nem hitelesített hívásokat próbált meg.

Típus: apiKey
In: header

Példák

FarmEquipments_CreateOrUpdate

Mintakérelem

HTTP

PATCH {endpoint}/farm-equipments/Equipment123?api-version=2023-11-01-preview

{
  "cropIds": [
    "CropId"
  ],
  "reference": {
    "datasetId": "datasetId",
    "recordId": "recordId"
  },
  "brand": "string",
  "series": "H",
  "model": "1234",
  "serial": "1234",
  "type": "Harvester",
  "ownership": "Personal",
  "location": "US",
  "company": {
    "name": "Company123",
    "description": "Equipment manufacturer",
    "registrationNumber": "1234"
  },
  "status": "Active",
  "source": "Manufacturer",
  "name": "Equipment1",
  "description": "string",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "Equipment123",
  "cropIds": [
    "CropId"
  ],
  "reference": {
    "datasetId": "datasetId",
    "recordId": "recordId"
  },
  "brand": "string",
  "series": "H",
  "model": "1234",
  "serial": "1234",
  "type": "Harvester",
  "ownership": "Personal",
  "location": "US",
  "company": {
    "name": "Company123",
    "description": "Equipment manufacturer",
    "registrationNumber": "1234"
  },
  "status": "Active",
  "source": "Manufacturer",
  "name": "Equipment1",
  "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"
}

Állapotkód:: 201

{
  "id": "Equipment123",
  "cropIds": [
    "CropId"
  ],
  "reference": {
    "datasetId": "datasetId",
    "recordId": "recordId"
  },
  "brand": "string",
  "series": "H",
  "model": "1234",
  "serial": "1234",
  "type": "Harvester",
  "ownership": "Personal",
  "location": "US",
  "company": {
    "name": "Company123",
    "description": "Equipment manufacturer",
    "registrationNumber": "1234"
  },
  "status": "Active",
  "source": "Manufacturer",
  "name": "Equipment1",
  "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"
}

Definíciók

Name	Description
Company	A vállalat/gyártó adatai.
Error	Az Azure AgPlatform szolgáltatás hibája.
ErrorResponse	Hibaválasz az Azure AgPlatform szolgáltatástól. Az ErrorResponse referenciadokumentumának https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
FarmEquipment	FarmEquipment-erőforrás sémája.
InnerError	A hibák listáját tartalmazó belső hiba. Lásd az InnerError-referenciadokumentum https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object.
Reference	Hivatkozás adathalmazrekordra.

Company

Objektum

A vállalat/gyártó adatai.

Name	Típus	Description
description	string	Gyártó vállalat leírása.
name	string	A gyártó vállalat neve.
registrationNumber	string	A vállalat regisztrációs száma.

Error

Objektum

Az Azure AgPlatform szolgáltatás hibája.

Name	Típus	Description
code	string minLength: 1	Kiszolgáló által definiált hibakódok.
details	Error[]	A jelentett hibához vezető konkrét hibák részleteinek tömbje.
innererror	InnerError	A hibák listáját tartalmazó belső hiba. Lásd az InnerError-referenciadokumentum https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object.
message	string minLength: 1	A hiba emberi olvasásra alkalmas ábrázolása.
target	string	A hiba célja.

ErrorResponse

Objektum

Hibaválasz az Azure AgPlatform szolgáltatástól. Az ErrorResponse referenciadokumentumának https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name	Típus	Description
error	Error	Az Azure AgPlatform szolgáltatás hibája.
traceId	string	Egyedi nyomkövetési azonosító.

FarmEquipment

Objektum

FarmEquipment-erőforrás sémája.

Name	Típus	Description
brand	string	A vegyi termék kereskedelmi márkája.
company	Company	A vállalat/gyártó adatai.
createdBy	string	A felhasználó/bérlő azonosítója hozza létre.
createdDateTime	string (date-time)	Az erőforrás létrehozásának dátuma, mintaformátum: yyyy-MM-ddTHH:mm:ssZ.
cropIds	string[]	A vegyi termékhez társított növények azonosítói. Megjegyzés: A cropProduct termékhez legfeljebb 25 növény társítható.
description	string minLength: 0 maxLength: 500	Az erőforrás szöveges leírása.
eTag	string	Az ETag értéke az optimista egyidejűség megvalósításához.
id	string	Egyedi erőforrás-azonosító.
location	string	Terület, ahol a berendezést használják.
model	string	A farmberendezés modellszáma.
modifiedBy	string	Módosítva a felhasználó/bérlő azonosítója.
modifiedDateTime	string (date-time)	Az erőforrás utolsó módosításának dátuma, mintaformátum: yyyy-MM-ddTHH:mm:ssZ.
name	string minLength: 0 maxLength: 100	Az erőforrás azonosítására szolgáló név.
ownership	string	Saját tulajdonú, bérelt, megosztott stb.
properties		Az erőforráshoz tartozó kulcsértékpárok gyűjteménye. Minden párnak nem lehet 50 karakternél nagyobb kulcsa, és nem lehet 150 karakternél nagyobb érték. Megjegyzés: Egy erőforráshoz legfeljebb 25 kulcsértékpár adható meg, és csak a sztring, a szám és a datetime (yyyy-MM-ddTHH:mm:ssZ) értékek támogatottak.
reference	Reference	Hivatkozás adathalmazrekordra.
serial	string	A farmberendezés sorozatszáma.
series	string	A farmberendezés sorozatszáma.
source	string minLength: 2 maxLength: 100	Az erőforrás forrása.
status	string minLength: 0 maxLength: 100	Az erőforrás állapota.
type	string	A mezőgazdasági berendezések típusa (Tiller, Sower, harvester, Sprayer, ...).

InnerError

Objektum

A hibák listáját tartalmazó belső hiba. Lásd az InnerError-referenciadokumentum https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object.

Name	Típus	Description
code	string	A hibát tartalmazó hiba által megadottnál meghatározott hibakód.
innererror	InnerError	A hibák listáját tartalmazó belső hiba. Lásd az InnerError-referenciadokumentum https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object.

Reference

Objektum

Hivatkozás adathalmazrekordra.

Name	Típus	Description
datasetId	string minLength: 0 maxLength: 100	Adathalmaz azonosítója.
recordId	string minLength: 0 maxLength: 100	Rekordazonosító.

Megosztás a következőn keresztül:

Farm Equipments - Create Or Update

URI-paraméterek

Kérelem fejléce

Kérelem törzse

Válaszok

Biztonság

Authorization

Példák

FarmEquipments_CreateOrUpdate

Mintakérelem

Mintaválasz

Definíciók

Company

Error

ErrorResponse

FarmEquipment

InnerError

Reference