Aracılığıyla paylaş


Harvest Data - List

Tüm taraflar arasında toplanan veri kaynaklarının sayfalandırılmış bir listesini döndürür.

GET /harvest-data?api-version=2023-06-01-preview
GET /harvest-data?minTotalYield={minTotalYield}&maxTotalYield={maxTotalYield}&minAvgYield={minAvgYield}&maxAvgYield={maxAvgYield}&minTotalWetMass={minTotalWetMass}&maxTotalWetMass={maxTotalWetMass}&minAvgWetMass={minAvgWetMass}&maxAvgWetMass={maxAvgWetMass}&minAvgMoisture={minAvgMoisture}&maxAvgMoisture={maxAvgMoisture}&minAvgSpeed={minAvgSpeed}&maxAvgSpeed={maxAvgSpeed}&sources={sources}&associatedBoundaryIds={associatedBoundaryIds}&minOperationStartDateTime={minOperationStartDateTime}&maxOperationStartDateTime={maxOperationStartDateTime}&minOperationEndDateTime={minOperationEndDateTime}&maxOperationEndDateTime={maxOperationEndDateTime}&minOperationModifiedDateTime={minOperationModifiedDateTime}&maxOperationModifiedDateTime={maxOperationModifiedDateTime}&minArea={minArea}&maxArea={maxArea}&ids={ids}&names={names}&propertyFilters={propertyFilters}&statuses={statuses}&minCreatedDateTime={minCreatedDateTime}&maxCreatedDateTime={maxCreatedDateTime}&minLastModifiedDateTime={minLastModifiedDateTime}&maxLastModifiedDateTime={maxLastModifiedDateTime}&maxPageSize={maxPageSize}&skipToken={skipToken}&api-version=2023-06-01-preview

URI Parametreleri

Name İçinde Gerekli Tür Description
api-version
query True

string

İstenen API sürümü

associatedBoundaryIds
query

string[]

İşlem verileriyle ilişkili sınır kimlikleri.

ids
query

string[]

Kaynağın kimlikleri.

maxArea
query

number

double

İşlemin uygulandığı en büyük alan (dahil).

maxAvgMoisture
query

number

double

Maksimum AvgMoisture değeri (dahil).

maxAvgSpeed
query

number

double

Maksimum AvgSpeed değeri (dahil).

maxAvgWetMass
query

number

double

Maksimum AvgWetMass değeri (dahil).

maxAvgYield
query

number

double

Maksimum AvgYield değeri (dahil).

maxCreatedDateTime
query

string

date-time

Kaynağın oluşturma tarihi üst sınırı (dahil).

maxLastModifiedDateTime
query

string

date-time

Kaynağın son değiştirme tarihi üst sınırı (dahil).

maxOperationEndDateTime
query

string

date-time

İşlem verilerinin bitiş tarihi-saati üst sınırı, örnek biçimi: yyyy-MM-ddTHH:mm:ssZ (dahil).

maxOperationModifiedDateTime
query

string

date-time

İşlem verilerinin değiştirme tarihi-saati üst sınırı, örnek biçimi: yyyy-MM-ddTHH:mm:ssZ (dahil).

maxOperationStartDateTime
query

string

date-time

İşlem verilerinin başlangıç tarihi-saati üst sınırı, örnek biçimi: yyyy-MM-ddTHH:mm:ssZ (dahil).

maxPageSize
query

integer

int32

Gereken en fazla öğe sayısı (dahil). Minimum = 10, Maksimum = 1000, Varsayılan değer = 50.

maxTotalWetMass
query

number

double

Maksimum Toplam WetMass değeri (dahil).

maxTotalYield
query

number

double

Maksimum Verim değeri (dahil).

minArea
query

number

double

İşlemin uygulandığı minimum alan (dahil).

minAvgMoisture
query

number

double

Minimum AvgMoisture değeri (dahil).

minAvgSpeed
query

number

double

Minimum AvgSpeed değeri (dahil).

minAvgWetMass
query

number

double

Minimum AvgWetMass değeri (dahil).

minAvgYield
query

number

double

Minimum AvgYield değeri (dahil).

minCreatedDateTime
query

string

date-time

Kaynağın en düşük oluşturma tarihi (dahil).

minLastModifiedDateTime
query

string

date-time

Kaynağın en son değiştirilme tarihi (dahil).

minOperationEndDateTime
query

string

date-time

İşlem verilerinin en düşük bitiş tarihi-saati, örnek biçimi: yyyy-MM-ddTHH:mm:ssZ (dahil).

minOperationModifiedDateTime
query

string

date-time

İşlem verilerinin en düşük değiştirme tarihi-saati, örnek biçimi: yyyy-MM-ddTHH:mm:ssZ (dahil).

minOperationStartDateTime
query

string

date-time

İşlem verilerinin en düşük başlangıç tarihi-saati, örnek biçimi: yyyy-MM-ddTHH:mm:ssZ (dahil).

minTotalWetMass
query

number

double

Minimum Toplam WetMass değeri (dahil).

minTotalYield
query

number

double

Minimum Verim değeri (dahil).

names
query

string[]

Kaynağın adları.

propertyFilters
query

string[]

Özellikler nesnesi içindeki anahtar-değer çiftlerinde filtreler. Örneğin "{testKey} eq {testValue}".

skipToken
query

string

Sonraki sonuç kümesini almak için belirteci atlayın.

sources
query

string[]

İşlem verilerinin kaynakları.

statuses
query

string[]

Kaynağın durumları.

İstek Başlığı

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.

Yanıtlar

Name Tür Description
200 OK

HarvestDataListResponse

Başarılı

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

HarvestData_List

Örnek isteği

GET /harvest-data?api-version=2023-06-01-preview

Örnek yanıt

{
  "value": [
    {
      "partyId": "PARTY123",
      "id": "HARVESTOP123",
      "source": "Manual",
      "name": "Harvest data for North Farm",
      "description": "some description",
      "status": "Active",
      "operationStartDateTime": "2021-04-21T06:49:30Z",
      "operationEndDateTime": "2021-04-21T06:49:30Z",
      "operationModifiedDateTime": "2021-04-21T06:49:30Z",
      "associatedBoundaryId": "NORTHFARM2021CORNBOUNDARY",
      "area": {
        "unit": "acre",
        "value": 50
      },
      "totalYield": {
        "unit": "kilos",
        "value": 1400
      },
      "avgYield": {
        "unit": "kilosperacre",
        "value": 28
      },
      "totalWetMass": {
        "unit": "kilos",
        "value": 500
      },
      "avgWetMass": {
        "unit": "kilosperacre",
        "value": 10
      },
      "avgMoisture": {
        "unit": "percent",
        "value": 14.61
      },
      "avgSpeed": {
        "unit": "kmsperhour",
        "value": 7.2
      },
      "harvestProductDetails": [
        {
          "productName": "VAR1",
          "area": {
            "unit": "acre",
            "value": 30
          },
          "totalYield": {
            "unit": "kilos",
            "value": 900
          },
          "avgYield": {
            "unit": "kilosperacre",
            "value": 30
          },
          "totalWetMass": {
            "unit": "kilos",
            "value": 300
          },
          "avgWetMass": {
            "unit": "kilosperacre",
            "value": 10
          },
          "avgMoisture": {
            "unit": "percent",
            "value": 16.4
          }
        }
      ],
      "properties": {
        "Region": "Europe",
        "CountyCode": 123
      },
      "attachmentsLink": "https://<resource-name>.farmbeats.azure.net/party/{{partyId}}/attachments?api-version={{apiVersion}}&resourceIds={{harvestDataId}}&resourceTypes=HarvestData",
      "createdDateTime": "2021-04-21T06:49:30Z",
      "modifiedDateTime": "2021-04-21T06:49:30Z",
      "eTag": "cb00a3ac-0000-0100-0000-601d21ec0000"
    }
  ],
  "skipToken": "string",
  "nextLink": "https:/{{resourceName}}.farmbeats.azure.net/parties/{{partyId}}/harvestData?api-version={{apiVersion}}&skipToken=%5b%7b%22token%22%3a%22%2bRID%3a%7ehK8eAKzdo1MNnwcAAAAAAA%3d%3d%23RT%3a1%23TRC%3a10%23ISV%3a2%23IEO%3a65551%23FPC%3aAQ2fBwAAAAAAD58HAAAAAAA%3d%22%2c%22range%22%3a%7b%22min%22%3a%22%22%2c%22max%22%3a%22FF%22%7d%7d%5d"
}

Tanımlar

Name Description
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 .

HarvestData

Toplama veri kaynağının şeması.

HarvestDataListResponse

Disk belleğine alınan yanıt, istenen nesnelerin listesini ve bir sonraki sonuç kümesini almak için bir URL bağlantısı içerir.

HarvestProductDetail

Hasat sırasında kullanılan ürünün şeması.

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 .

Measure

Ölçüm okuma ve birimi depolama şeması.

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.

HarvestData

Toplama veri kaynağının şeması.

Name Tür Description
area

Measure

Ölçüm okuma ve birimi depolama şeması.

associatedBoundaryId

string

İşlemin uygulandığı alanın isteğe bağlı sınır kimliği.

attachmentsLink

string

Ekler için bağlantı.

avgMoisture

Measure

Ölçüm okuma ve birimi depolama şeması.

avgSpeed

Measure

Ölçüm okuma ve birimi depolama şeması.

avgWetMass

Measure

Ölçüm okuma ve birimi depolama şeması.

avgYield

Measure

Ölçüm okuma ve birimi depolama şeması.

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.

description

string

Kaynağın metinsel açıklaması.

eTag

string

İyimser eşzamanlılık uygulamak için ETag değeri.

harvestProductDetails

HarvestProductDetail[]

Ürün ayrıntılarını hasat edin.

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.

operationEndDateTime

string

İşlem verilerinin bitiş tarih-saati, örnek biçimi: yyyy-MM-ddTHH:mm:ssZ.

operationModifiedDateTime

string

İşlem verilerinin değiştirildiği tarih-saat, örnek biçimi: yyyy-MM-ddTHH:mm:ssZ. Not: Bu, kaynak sağlayıcının kendisi tarafından belirtilir.

operationStartDateTime

string

İşlem verilerinin başlangıç tarih-saati, örnek biçimi: yyyy-MM-ddTHH:mm:ssZ.

partyId

string

İşlem verilerine ait olan taraf kimliği.

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.

source

string

Kaynağın kaynağı.

status

string

Kaynağın durumu.

totalWetMass

Measure

Ölçüm okuma ve birimi depolama şeması.

totalYield

Measure

Ölçüm okuma ve birimi depolama şeması.

HarvestDataListResponse

Disk belleğine alınan yanıt, istenen nesnelerin listesini ve bir sonraki sonuç kümesini almak için bir URL bağlantısı içerir.

Name Tür Description
nextLink

string

Listenin bir sonraki sonuç sayfasına devamlılık bağlantısı (mutlak URI).

skipToken

string

Sonraki sayfa alınırken kullanılan belirteç. Null ise, başka sayfa yoktur.

value

HarvestData[]

İstenen nesnelerin listesi.

HarvestProductDetail

Hasat sırasında kullanılan ürünün şeması.

Name Tür Description
area

Measure

Ölçüm okuma ve birimi depolama şeması.

avgMoisture

Measure

Ölçüm okuma ve birimi depolama şeması.

avgWetMass

Measure

Ölçüm okuma ve birimi depolama şeması.

avgYield

Measure

Ölçüm okuma ve birimi depolama şeması.

productName

string

Ürünün adı.

totalWetMass

Measure

Ölçüm okuma ve birimi depolama şeması.

totalYield

Measure

Ölçüm okuma ve birimi depolama şeması.

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 .

Measure

Ölçüm okuma ve birimi depolama şeması.

Name Tür Description
unit

string

Veri birimi.

value

number

Veri değeri.