Chemical Products - Create Or Update

Usługa:: Azure Data Manager for Agriculture

Wersja interfejsu API:: 2023-11-01-preview

Tworzy lub aktualizuje zasób chemicalProduct.

PATCH {endpoint}/chemical-products/{chemicalProductId}?api-version=2023-11-01-preview

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
chemicalProductId	path	True	string	Identyfikator zasobu chemicalProduct.
endpoint	path	True	string (uri)	Nazwa hosta przestrzeni nazw, np. admaInstanceName.farmbeats.azure.net
api-version	query	True	string	Żądana wersja interfejsu API

Nagłówek żądania

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

Nazwa	Wymagane	Typ	Opis
Authorization	True	string	Podaj prawidłowy token elementu nośnego dla autoryzowanych wywołań interfejsu API. Pamiętaj, że może być konieczne wyczyszczenie pamięci podręcznej przeglądarki, jeśli wcześniej próbowano wykonać nieuwierzytelnione wywołania.

Treść żądania

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

Nazwa	Typ	Opis
activeIngredients	string[]	Substancje chemiczne aktywne w formule.
brand	string	Komercyjna marka produktu chemicznego.
company	Company	Szczegóły firmy/producenta.
cropIds	string[]	Identyfikatory upraw skojarzonych z produktem chemicznym. Uwaga: z uprawą można skojarzyć maksymalnie 25 upraw.
description	string minLength: 0 maxLength: 500	Tekstowy opis zasobu.
formulation	string	Opis formuły. Procent lub inna jednostka N, P, K, CA, MG, S, FE, MN, ZN, CU, B, MO, CL (na podstawie źródła dostępne elementy chemiczne mogą się różnić, ale jest to typowa lista).
location	string	Obszar, w którym stosuje się substancję chemiczną. Jest to ważne z punktu widzenia zgodności.
name	string minLength: 0 maxLength: 100	Nazwa identyfikującego zasób.
product	string	Komercyjna nazwa produktu chemicznego.
properties		Kolekcja par klucz-wartość, która należy do zasobu. Każda para nie może mieć klucza większego niż 50 znaków i nie może mieć wartości większej niż 150 znaków. Uwaga: Dla zasobu można podać maksymalnie 25 par wartości klucza, a obsługiwane są tylko wartości ciągu, liczb i daty/godziny (rrrr-MM-ddTHH:mm:ssZ).
reEntryInterval	integer (int32)	Liczba dni, po których osoba może odwiedzić pole po zastosowaniu produktu chemicznego.
reference	Reference	Odwołanie do rekordu zestawu danych.
registrationNumber	string	Numer rejestracyjny substancji chemicznej. Może się to różnić w zależności od lokalizacji geograficznej.
source	string minLength: 2 maxLength: 100	Źródło zasobu.
specificGravity	string	Szczegóły specyficznej grawitacji.
state	string	Płynny/niepłynny.
status	string minLength: 0 maxLength: 100	Stan zasobu.
type	string	Herbicyd, addytywne, środki owadobójcze, nawozy.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ChemicalProduct	Powodzenie
201 Created	ChemicalProduct	Utworzono
Other Status Codes	ErrorResponse	Błąd Nagłówki x-ms-error-code: string

Nazwa

Typ

Opis

200 OK

ChemicalProduct

Powodzenie

201 Created

ChemicalProduct

Utworzono

Other Status Codes

ErrorResponse

Błąd

Nagłówki

x-ms-error-code: string

Zabezpieczenia

Authorization

Podaj prawidłowy token elementu nośnego dla autoryzowanych wywołań interfejsu API. Pamiętaj, że może być konieczne wyczyszczenie pamięci podręcznej przeglądarki, jeśli wcześniej próbowano wykonać nieuwierzytelnione wywołania.

Typ: apiKey
W: header

Przykłady

ChemicalProducts_CreateOrUpdate

Przykładowe żądanie

HTTP

PATCH {endpoint}/chemical-products/Chemical123?api-version=2023-11-01-preview

{
  "cropIds": [
    "CropId"
  ],
  "reference": {
    "datasetId": "datasetId",
    "recordId": "recordId"
  },
  "brand": "Brand",
  "product": "AGTECH",
  "type": "Herbicide",
  "state": "Liquid",
  "activeIngredients": [
    "NO2"
  ],
  "specificGravity": "string",
  "formulation": "N, P, K",
  "company": {
    "name": "CompanyName",
    "description": "Agriculture Manufacturer",
    "registrationNumber": "1234"
  },
  "location": "US",
  "registrationNumber": "1234",
  "reEntryInterval": 5,
  "status": "Active",
  "source": "Manufacturer",
  "name": "Fertilizer1",
  "description": "string",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

Przykładowa odpowiedź

Kod stanu:: 200

{
  "id": "Chemical123",
  "cropIds": [
    "CropId"
  ],
  "reference": {
    "datasetId": "datasetId",
    "recordId": "recordId"
  },
  "brand": "Brand",
  "product": "AGTECH",
  "type": "Herbicide",
  "state": "Liquid",
  "activeIngredients": [
    "NO2"
  ],
  "specificGravity": "string",
  "formulation": "N, P, K",
  "company": {
    "name": "CompanyName",
    "description": "Agriculture Manufacturer",
    "registrationNumber": "1234"
  },
  "location": "US",
  "registrationNumber": "1234",
  "reEntryInterval": 5,
  "status": "Active",
  "source": "Manufacturer",
  "name": "Fertilizer1",
  "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"
}

Kod stanu:: 201

{
  "id": "Chemical123",
  "cropIds": [
    "CropId"
  ],
  "reference": {
    "datasetId": "datasetId",
    "recordId": "recordId"
  },
  "brand": "Brand",
  "product": "AGTECH",
  "type": "Herbicide",
  "state": "Liquid",
  "activeIngredients": [
    "NO2"
  ],
  "specificGravity": "string",
  "formulation": "N, P, K",
  "company": {
    "name": "CompanyName",
    "description": "Agriculture Manufacturer",
    "registrationNumber": "1234"
  },
  "location": "US",
  "registrationNumber": "1234",
  "reEntryInterval": 5,
  "status": "Active",
  "source": "Manufacturer",
  "name": "Fertilizer1",
  "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"
}

Definicje

Nazwa	Opis
ChemicalProduct	Schemat zasobu ChemicalProduct.
Company	Szczegóły firmy/producenta.
Error	Błąd usługi Azure AgPlatform.
ErrorResponse	Odpowiedź na błąd z usługi Azure AgPlatform. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses, aby zapoznać się z dokumentem referencyjnym ErrorResponse.
InnerError	Wewnętrzny błąd zawierający listę błędów. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object, aby zapoznać się z dokumentem referencyjnym InnerError.
Reference	Odwołanie do rekordu zestawu danych.

ChemicalProduct

Objekt

Schemat zasobu ChemicalProduct.

Nazwa	Typ	Opis
activeIngredients	string[]	Substancje chemiczne aktywne w formule.
brand	string	Komercyjna marka produktu chemicznego.
company	Company	Szczegóły firmy/producenta.
createdBy	string	Utworzony przez identyfikator użytkownika/dzierżawy.
createdDateTime	string (date-time)	Data i godzina utworzenia zasobu, przykładowy format: rrrr-MM-ddTHH:mm:ssZ.
cropIds	string[]	Identyfikatory upraw skojarzonych z produktem chemicznym. Uwaga: z uprawą można skojarzyć maksymalnie 25 upraw.
description	string minLength: 0 maxLength: 500	Tekstowy opis zasobu.
eTag	string	Wartość ETag w celu zaimplementowania optymistycznej współbieżności.
formulation	string	Opis formuły. Procent lub inna jednostka N, P, K, CA, MG, S, FE, MN, ZN, CU, B, MO, CL (na podstawie źródła dostępne elementy chemiczne mogą się różnić, ale jest to typowa lista).
id	string	Unikatowy identyfikator zasobu.
location	string	Obszar, w którym stosuje się substancję chemiczną. Jest to ważne z punktu widzenia zgodności.
modifiedBy	string	Zmodyfikowany przez identyfikator użytkownika/dzierżawy.
modifiedDateTime	string (date-time)	Data i godzina ostatniej modyfikacji zasobu, format próbki: rrrr-MM-ddTHH:mm:ssZ.
name	string minLength: 0 maxLength: 100	Nazwa identyfikującego zasób.
product	string	Komercyjna nazwa produktu chemicznego.
properties		Kolekcja par klucz-wartość, która należy do zasobu. Każda para nie może mieć klucza większego niż 50 znaków i nie może mieć wartości większej niż 150 znaków. Uwaga: Dla zasobu można podać maksymalnie 25 par wartości klucza, a obsługiwane są tylko wartości ciągu, liczb i daty/godziny (rrrr-MM-ddTHH:mm:ssZ).
reEntryInterval	integer (int32)	Liczba dni, po których osoba może odwiedzić pole po zastosowaniu produktu chemicznego.
reference	Reference	Odwołanie do rekordu zestawu danych.
registrationNumber	string	Numer rejestracyjny substancji chemicznej. Może się to różnić w zależności od lokalizacji geograficznej.
source	string minLength: 2 maxLength: 100	Źródło zasobu.
specificGravity	string	Szczegóły specyficznej grawitacji.
state	string	Płynny/niepłynny.
status	string minLength: 0 maxLength: 100	Stan zasobu.
type	string	Herbicyd, addytywne, środki owadobójcze, nawozy.

Company

Objekt

Szczegóły firmy/producenta.

Nazwa	Typ	Opis
description	string	Opis firmy produkcyjnej.
name	string	Nazwa firmy produkcyjnej.
registrationNumber	string	Numer rejestracyjny firmy.

Error

Objekt

Błąd usługi Azure AgPlatform.

Nazwa	Typ	Opis
code	string minLength: 1	Zdefiniowany przez serwer zestaw kodów błędów.
details	Error[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
innererror	InnerError	Wewnętrzny błąd zawierający listę błędów. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object, aby zapoznać się z dokumentem referencyjnym InnerError.
message	string minLength: 1	Czytelna dla człowieka reprezentacja błędu.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd z usługi Azure AgPlatform. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses, aby zapoznać się z dokumentem referencyjnym ErrorResponse.

Nazwa	Typ	Opis
error	Error	Błąd usługi Azure AgPlatform.
traceId	string	Unikatowy identyfikator śledzenia.

InnerError

Objekt

Wewnętrzny błąd zawierający listę błędów. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object, aby zapoznać się z dokumentem referencyjnym InnerError.

Nazwa	Typ	Opis
code	string	Określony kod błędu niż został dostarczony przez błąd zawierający.
innererror	InnerError	Wewnętrzny błąd zawierający listę błędów. Zobacz https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object, aby zapoznać się z dokumentem referencyjnym InnerError.

Reference

Objekt

Odwołanie do rekordu zestawu danych.

Nazwa	Typ	Opis
datasetId	string minLength: 0 maxLength: 100	Identyfikator zestawu danych.
recordId	string minLength: 0 maxLength: 100	Identyfikator rekordu.