Management Zones - List By Farmer Id

서비스:

Azure Data Manager for Agriculture

API 버전:

2021-07-31-preview

특정 농부 아래에 페이지를 매긴 관리 영역 리소스 목록을 반환합니다.

GET /farmers/{farmerId}/management-zones?api-version=2021-07-31-preview

선택적 매개 변수:

GET /farmers/{farmerId}/management-zones?types={types}&cropIds={cropIds}&seasonIds={seasonIds}&fieldIds={fieldIds}&sources={sources}&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 매개 변수

Name	In(다음 안에)	필수	형식	Description
farmerId	path	True	string	관련 농부의 ID입니다.
api-version	query	True	string	요청된 API 버전
$maxPageSize	query		integer (int32) minimum: 10 maximum: 1000	필요한 최대 항목 수(포함)입니다. 최소 = 10, 최대 = 1000, 기본값 = 50.
$skipToken	query		string	다음 결과 집합을 가져오기 위한 토큰을 건너뜁니다.
cropIds	query		string[]	ManagementZone의 CropIds입니다.
fieldIds	query		string[]	ManagementZone의 FieldIds입니다.
ids	query		string[]	리소스의 ID입니다.
maxCreatedDateTime	query		string (date-time)	리소스의 최대 생성 날짜(포함)입니다.
maxLastModifiedDateTime	query		string (date-time)	마지막으로 수정한 최대 리소스 날짜(포함)입니다.
minCreatedDateTime	query		string (date-time)	리소스의 최소 생성 날짜(포함)입니다.
minLastModifiedDateTime	query		string (date-time)	마지막으로 수정한 리소스의 최소 날짜(포함)입니다.
names	query		string[]	리소스의 이름입니다.
propertyFilters	query		string[]	Properties 개체 내의 키-값 쌍을 필터링합니다. 예. "{testKey} eq {testValue}"입니다.
seasonIds	query		string[]	ManagementZone의 SeasonIds입니다.
sources	query		string[]	ManagementZone의 원본입니다.
statuses	query		string[]	리소스의 상태입니다.
types	query		string[]	ManagementZone의 형식입니다.

요청 헤더

Name	필수	형식	Description
Authorization	True	string	권한 있는 API 호출에 유효한 전달자 토큰을 제공하세요. 이전에 인증되지 않은 호출을 시도한 경우 브라우저 캐시를 지워야 할 수 있습니다.

응답

Name	형식	Description
200 OK	ManagementZoneListResponse	성공
Other Status Codes	ErrorResponse	오류 헤더 x-ms-error-code: string

보안

Authorization

권한 있는 API 호출에 유효한 전달자 토큰을 제공하세요. 이전에 인증되지 않은 호출을 시도한 경우 브라우저 캐시를 지워야 할 수 있습니다.

형식: apiKey
In(다음 안에): header

예제

ManagementZones_ListByFarmerId

샘플 요청

HTTP

GET /farmers/FARMER123/management-zones?api-version=2021-07-31-preview

샘플 응답

상태 코드:

200

{
  "value": [
    {
      "farmerId": "FARMER123",
      "id": "ManagementZone123",
      "type": "Nutrient rich",
      "seasonId": "Season123",
      "cropId": "Crop123",
      "fieldId": "Field123",
      "source": "Agronomist",
      "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"
    }
  ],
  "$skipToken": "string",
  "nextLink": "https://{{resourceName}}.farmbeats.azure.net/farmers/{{farmerId}}/management-zones?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"
}

정의

Name	Description
Error	Azure AgPlatform 서비스의 오류입니다.
ErrorResponse	Azure AgPlatform 서비스의 오류 응답입니다. <href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses"를 참조하십시오.>ErrorResponse 참조 문서.</참조>.
InnerError	오류 목록을 포함하는 내부 오류입니다. <href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object"를 참조하십시오.>InnerError 참조 문서</참조>.
ManagementZone	ManagementZone 개체에 대한 Api Model입니다.
ManagementZoneListResponse	페이징된 응답에는 요청된 개체 목록과 다음 결과 집합을 가져오는 URL 링크가 포함됩니다.

Error

Object

Azure AgPlatform 서비스의 오류입니다.

Name	형식	Description
code	string	서버에서 정의한 오류 코드 집합입니다.
details	Error[]	이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.
innererror	InnerError	오류 목록을 포함하는 내부 오류입니다. <href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object"를 참조하십시오.>InnerError 참조 문서</참조>.
message	string	사람이 읽을 수 있는 오류 표현입니다.
target	string	오류의 대상입니다.

ErrorResponse

Object

Azure AgPlatform 서비스의 오류 응답입니다. <href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses"를 참조하십시오.>ErrorResponse 참조 문서.</참조>.

Name	형식	Description
error	Error	Azure AgPlatform 서비스의 오류입니다.
traceId	string	고유 추적 ID입니다.

InnerError

Object

오류 목록을 포함하는 내부 오류입니다. <href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object"를 참조하십시오.>InnerError 참조 문서</참조>.

Name	형식	Description
code	string	포함된 오류에서 제공한 것보다 구체적인 오류 코드입니다.
innererror	InnerError	오류 목록을 포함하는 내부 오류입니다. <href="https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object"를 참조하십시오.>InnerError 참조 문서</참조>.

ManagementZone

Object

ManagementZone 개체에 대한 Api Model입니다.

Name	형식	Description
createdDateTime	string (date-time)	리소스를 만든 날짜-시간 샘플 형식: yyyy-MM-ddTHH:mm:ssZ.
cropId	string	ManagementZone과 연결된 자르기 ID입니다.
description	string minLength: 0 maxLength: 500	리소스에 대한 텍스트 설명입니다.
eTag	string	낙관적 동시성을 구현하는 ETag 값입니다.
farmerId	string	ManagementZone과 연결된 Farmer ID입니다.
fieldId	string	ManagementZone과 연결된 필드 ID입니다.
id	string	고유 리소스 ID입니다.
modifiedDateTime	string (date-time)	리소스가 마지막으로 수정된 날짜-시간, 샘플 형식: yyyy-MM-ddTHH:mm:ssZ.
name	string minLength: 0 maxLength: 100	리소스를 식별하는 이름입니다.
properties		리소스에 속하는 키 값 쌍의 컬렉션입니다. 각 쌍에는 50자보다 큰 키가 없어야 하며 150자보다 큰 값은 없어야 합니다. 참고: 리소스에 대해 최대 25개의 키 값 쌍을 제공할 수 있으며 문자열, 숫자 및 datetime(yyyy-MM-ddTHH:mm:ssZ) 값만 지원됩니다.
seasonId	string	ManagementZone과 연결된 시즌 ID입니다.
source	string minLength: 2 maxLength: 100	리소스의 원본입니다.
status	string minLength: 0 maxLength: 100	리소스의 상태입니다.
type	string minLength: 0 maxLength: 100	ManagementZone의 형식입니다.

ManagementZoneListResponse

Object

페이징된 응답에는 요청된 개체 목록과 다음 결과 집합을 가져오는 URL 링크가 포함됩니다.

Name	형식	Description
$skipToken	string	다음 페이지를 검색하는 데 사용되는 토큰입니다. null이면 추가 페이지가 없습니다.
nextLink	string	목록의 결과 다음 페이지에 대한 연속 링크(절대 URI)입니다.
value	ManagementZone[]	요청된 개체 목록입니다.