Dela via


Plant Tissue Analyses - List By Farmer Id

Returnerar en sidnumrerad lista över växtvävnadsanalysresurser under en viss jordbrukare.

GET /farmers/{farmerId}/plant-tissue-analyses?api-version=2021-07-31-preview
GET /farmers/{farmerId}/plant-tissue-analyses?seasonIds={seasonIds}&cropIds={cropIds}&cropVarietiesIds={cropVarietiesIds}&fieldIds={fieldIds}&ids={ids}&names={names}&propertyFilters={propertyFilters}&statuses={statuses}&minCreatedDateTime={minCreatedDateTime}&maxCreatedDateTime={maxCreatedDateTime}&minLastModifiedDateTime={minLastModifiedDateTime}&maxLastModifiedDateTime={maxLastModifiedDateTime}&$maxPageSize={$maxPageSize}&$skipToken={$skipToken}&api-version=2021-07-31-preview

URI-parametrar

Name I Obligatorisk Typ Description
farmerId
path True

string

ID för den associerade bonden.

api-version
query True

string

Den begärda API-versionen

$maxPageSize
query

integer (int32)

minimum: 10
maximum: 1000

Maximalt antal objekt som behövs (inklusive). Minimum = 10, Maximum = 1000, Standardvärde = 50.

$skipToken
query

string

Hoppa över token för att hämta nästa uppsättning resultat.

cropIds
query

string[]

Växtvävnadsanalysernas beskärnings-ID: er.

cropVarietiesIds
query

string[]

Växtvävnadsanalysernas sorters-ID:t.

fieldIds
query

string[]

Fält-ID:er för växtvävnadsanalyserna.

ids
query

string[]

ID:t för resursen.

maxCreatedDateTime
query

string (date-time)

Maximalt skapandedatum för resurs (inklusive).

maxLastModifiedDateTime
query

string (date-time)

Maximalt senast ändrat datum för resursen (inklusive).

minCreatedDateTime
query

string (date-time)

Minsta skapandedatum för resursen (inklusive).

minLastModifiedDateTime
query

string (date-time)

Minsta senaste ändringsdatum för resursen (inklusive).

names
query

string[]

Namn på resursen.

propertyFilters
query

string[]

Filtrerar på nyckel/värde-par i objektet Egenskaper. T.ex. "{testKey} eq {testValue}".

seasonIds
query

string[]

Säsongs-ID:t för växtvävnadsanalyserna.

statuses
query

string[]

Status för resursen.

Begärandehuvud

Name Obligatorisk Typ Description
Authorization True

string

Ange en giltig ägartoken för auktoriserade API-anrop. Observera att du kan behöva rensa webbläsarens cacheminne om du har provat oautentiserade anrop tidigare.

Svar

Name Typ Description
200 OK

PlantTissueAnalysisListResponse

Framgång

Other Status Codes

ErrorResponse

Fel

Sidhuvuden

x-ms-error-code: string

Säkerhet

Authorization

Ange en giltig ägartoken för auktoriserade API-anrop. Observera att du kan behöva rensa webbläsarens cacheminne om du har provat oautentiserade anrop tidigare.

Typ: apiKey
I: header

Exempel

PlantTissueAnalyses_ListByFarmerId

Exempelbegäran

GET /farmers/FARMER123/plant-tissue-analyses?api-version=2021-07-31-preview

Exempelsvar

{
  "value": [
    {
      "farmerId": "FARMER123",
      "id": "PLANTTISSUEANALYSIS123",
      "seasonId": "Season123",
      "cropId": "Crop123",
      "cropVarietyId": "CropVariety123",
      "fieldId": "Field123",
      "plantingDateTime": "2021-04-21T06:49:30Z",
      "plantPart": "PlantPart",
      "plantPosition": "PlantPosition",
      "plantAppearance": "PlantAppearance",
      "sampleCollectionCondition": "SampleCollectionCondition",
      "sampleCollectionDateTime": "2021-04-21T06:49:30Z",
      "sampleReceivedDateTime": "2021-04-22T06:49:30Z",
      "sampleTestResultDateTime": "2021-04-23T06:49:30Z",
      "labDetails": {
        "code": "LabId",
        "name": "Name",
        "address": "Address",
        "description": "Description of the object being created"
      },
      "name": "John Smith's ManagementZone",
      "status": "Active",
      "description": "Some description",
      "properties": {
        "Irrigated": "Yes"
      },
      "createdDateTime": "2021-04-21T06:49:30Z",
      "modifiedDateTime": "2021-04-21T06:49:30Z",
      "eTag": "0f8fad5b-d9cb-469f-a165-70867728950e",
      "attachmentsLink": "https://<resource-name>.farmbeats.azure.net/farmer/{{farmerId}}/attachments?api-version={{apiVersion}}&resourceIds={{plantTissueAnalysisId}}&resourceTypes=PlantTissueAnalysis"
    }
  ],
  "$skipToken": "string",
  "nextLink": "https://{{resourceName}}.farmbeats.azure.net/farmers/{{farmerId}}/plant-tissue-analyses?api-version={{apiVersion}}&$skipToken=%5b%7b%22token%22%3a%22%2bRID%3a%7e23TRC%3a10%23ISA%3d%22%2c%22range%22%3a%7b%22min%22%3a%22%22%2c%22max%22%3a%22FF%22%7d%7d%5d"
}

Definitioner

Name Description
Error

Ett fel från Azure AgPlatform-tjänsten.

ErrorResponse

Ett felsvar från Azure AgPlatform-tjänsten. <se href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses">Referensdokument för ErrorResponse.</se>.

InnerError

Inre fel som innehåller en lista över fel. <se href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object">InnerError referensdokument</se>.

LabDetails

Modell för att representera LabDetails-objekt.

PlantTissueAnalysis

API-modell för växtvävnadsanalysobjekt.

PlantTissueAnalysisListResponse

Sidsidigt svar innehåller en lista över begärda objekt och en URL-länk för att hämta nästa uppsättning resultat.

Error

Ett fel från Azure AgPlatform-tjänsten.

Name Typ Description
code

string

Serverdefinierad uppsättning felkoder.

details

Error[]

Matris med information om specifika fel som ledde till det rapporterade felet.

innererror

InnerError

Inre fel som innehåller en lista över fel. <se href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object">InnerError referensdokument</se>.

message

string

Mänsklig läsbar representation av felet.

target

string

Målet för felet.

ErrorResponse

Ett felsvar från Azure AgPlatform-tjänsten. <se href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses">Referensdokument för ErrorResponse.</se>.

Name Typ Description
error

Error

Ett fel från Azure AgPlatform-tjänsten.

traceId

string

Unikt spårnings-ID.

InnerError

Inre fel som innehåller en lista över fel. <se href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object">InnerError referensdokument</se>.

Name Typ Description
code

string

Specifik felkod än vad som angavs av det innehållande felet.

innererror

InnerError

Inre fel som innehåller en lista över fel. <se href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object">InnerError referensdokument</se>.

LabDetails

Modell för att representera LabDetails-objekt.

Name Typ Description
address

string

minLength: 0
maxLength: 500

Resursens adress.

code

string

minLength: 0
maxLength: 150

Kod för resursen.

description

string

minLength: 0
maxLength: 500

Beskrivning av resursen.

name

string

minLength: 0
maxLength: 100

Namnet på resursen.

PlantTissueAnalysis

API-modell för växtvävnadsanalysobjekt.

Name Typ Description
attachmentsLink

string

Länk för bifogade filer.

createdDateTime

string (date-time)

Datum-tid när resursen skapades, exempelformat: åååå-MM-ddTHH:mm:ssZ.

cropId

string

ID för den associerade grödan.

cropVarietyId

string

ID för den associerade beskärningssorten.

description

string

minLength: 0
maxLength: 500

Textbeskrivning av resursen.

eTag

string

ETag-värdet för att implementera optimistisk samtidighet.

farmerId

string

ID för den associerade bonden.

fieldId

string

ID för det associerade fältet.

growthStage

string

minLength: 0
maxLength: 200

Tillväxtsteg för denna växtvävnadsanalys.

id

string

Unikt resurs-ID.

labDetails

LabDetails

Modell för att representera LabDetails-objekt.

modifiedDateTime

string (date-time)

Datum-tid när resursen senast ändrades, exempelformat: åååå-MM-ddTHH:mm:ssZ.

name

string

minLength: 0
maxLength: 100

Namn för att identifiera resursen.

plantAppearance

string

minLength: 0
maxLength: 500

Växt utseende för denna växt vävnad analys.

plantPart

string

minLength: 0
maxLength: 200

Växtdel för denna växtvävnadsanalys.

plantPosition

string

minLength: 0
maxLength: 200

Växtposition för denna växtvävnadsanalys.

plantingDateTime

string (date-time)

Plantering datetime för denna växtvävnad analys.

properties

En samling nyckelvärdepar som tillhör resursen. Varje par får inte ha en nyckel som är större än 50 tecken och får inte ha ett värde som är större än 150 tecken. Obs! Högst 25 nyckelvärdepar kan anges för en resurs och endast värden för sträng, siffror och datetime (åååå-MM-ddTHH:mm:ssZ) stöds.

sampleCollectionCondition

string

minLength: 0
maxLength: 500

Provinsamlingsvillkor för denna växtvävnadsanalys.

sampleCollectionDateTime

string (date-time)

Exempelinsamling dateTime för den här växtvävnadsanalysen.

sampleReceivedDateTime

string (date-time)

Exempel på mottagna dateTime.

sampleTestResultDateTime

string (date-time)

Provtestresultat dateTime för denna växtvävnadsanalys.

seasonId

string

ID för den associerade säsongen.

source

string

minLength: 2
maxLength: 100

Resursens källa.

status

string

minLength: 0
maxLength: 100

Status för resursen.

PlantTissueAnalysisListResponse

Sidsidigt svar innehåller en lista över begärda objekt och en URL-länk för att hämta nästa uppsättning resultat.

Name Typ Description
$skipToken

string

Token som används för att hämta nästa sida. Om värdet är null finns det inga ytterligare sidor.

nextLink

string

Fortsättningslänk (absolut URI) till nästa sida med resultat i listan.

value

PlantTissueAnalysis[]

Lista över begärda objekt.