Boundaries - List

서비스:: Azure Data Manager for Agriculture

API 버전:: 2023-06-01-preview

모든 당사자에 걸쳐 페이지를 매긴 경계 리소스 목록을 반환합니다.

GET /boundaries?api-version=2023-06-01-preview

선택적 매개 변수:

GET /boundaries?parentType={parentType}&type={type}&parentIds={parentIds}&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 매개 변수

Name	In(다음 안에)	필수	형식	Description
api-version	query	True	string	요청된 API 버전
ids	query		string[]	리소스의 ID입니다.
maxArea	query		number (double)	경계의 최대 면적(포함)입니다.
maxCreatedDateTime	query		string (date-time)	리소스의 최대 생성 날짜(포함)입니다.
maxLastModifiedDateTime	query		string (date-time)	마지막으로 수정한 최대 리소스 날짜(포함)입니다.
maxPageSize	query		integer (int32) minimum: 10 maximum: 1000	필요한 최대 항목 수(포함)입니다. 최소 = 10, 최대 = 1000, 기본값 = 50.
minArea	query		number (double)	경계의 최소 영역(포함)입니다.
minCreatedDateTime	query		string (date-time)	리소스의 최소 생성 날짜(포함)입니다.
minLastModifiedDateTime	query		string (date-time)	마지막으로 수정한 리소스의 최소 날짜(포함)입니다.
names	query		string[]	리소스의 이름입니다.
parentIds	query		string[]	리소스의 부모 ID입니다.
parentType	query		string	속해 있는 부모의 형식입니다.
propertyFilters	query		string[]	Properties 개체 내의 키-값 쌍을 필터링합니다. 예. "{testKey} eq {testValue}"입니다.
skipToken	query		string	다음 결과 집합을 가져오기 위한 토큰을 건너뜁니다.
statuses	query		string[]	리소스의 상태입니다.
type	query		string	속해 있는 형식입니다.

요청 헤더

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

응답

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

Name

형식

Description

200 OK

BoundaryMetadataListResponse

성공

Other Status Codes

ErrorResponse

오류

헤더

x-ms-error-code: string

보안

Authorization

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

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

예제

Boundaries_List

샘플 요청

HTTP

GET /boundaries?api-version=2023-06-01-preview

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "parentId": "FIELD123",
      "parentType": "Field",
      "area": {
        "unit": "Acre",
        "value": 60.405
      },
      "name": "John Smith's Boundary",
      "description": "Some description"
    }
  ],
  "skipToken": "string",
  "nextLink": "https://{{resourceName}}.farmbeats.azure.net/parties/{{partyId}}/seasonalFields/{{seasonalFieldId}}?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
BoundaryMetadata	경계 리소스 메타데이터의 스키마입니다.
BoundaryMetadataListResponse	페이징된 응답에는 요청된 개체 목록과 다음 결과 집합을 가져오는 URL 링크가 포함됩니다.
BoundaryParentType	속해 있는 부모의 형식입니다. 즉, Field, SeasonalField, Zone, Prescription, PlantTissueAnalysis, ApplicationData, HarvestData, TillageData, PlantingData.
Error	Azure AgPlatform 서비스의 오류입니다.
ErrorResponse	Azure AgPlatform 서비스의 오류 응답입니다. ErrorResponse 참조 문서는 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 참조하세요.
InnerError	오류 목록을 포함하는 내부 오류입니다. InnerError 참조 문서에 대한 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object 참조하세요.
Measure	측정값 읽기 및 단위를 저장하기 위한 스키마입니다.

BoundaryMetadata

Object

경계 리소스 메타데이터의 스키마입니다.

Name	형식	Description
area	Measure	측정값 읽기 및 단위를 저장하기 위한 스키마입니다.
createdBy	string	사용자/테넌트 ID로 생성됩니다.
createdDateTime	string (date-time)	리소스를 만든 날짜-시간 샘플 형식: yyyy-MM-ddTHH:mm:ssZ.
description	string minLength: 0 maxLength: 500	리소스에 대한 텍스트 설명입니다.
eTag	string	낙관적 동시성을 구현하는 ETag 값입니다.
id	string	고유 리소스 ID입니다.
modifiedBy	string	사용자/테넌트 ID로 수정되었습니다.
modifiedDateTime	string (date-time)	리소스가 마지막으로 수정된 날짜-시간, 샘플 형식: yyyy-MM-ddTHH:mm:ssZ.
name	string minLength: 0 maxLength: 100	리소스를 식별하는 이름입니다.
parentId	string	속한 부모의 ID입니다.
parentType	BoundaryParentType	속해 있는 부모의 형식입니다.
partyId	string	파티 ID입니다.
properties		리소스에 속하는 키 값 쌍의 컬렉션입니다. 각 쌍에는 50자보다 큰 키가 없어야 하며 150자보다 큰 값은 없어야 합니다. 참고: 리소스에 대해 최대 25개의 키 값 쌍을 제공할 수 있으며 문자열, 숫자 및 datetime(yyyy-MM-ddTHH:mm:ssZ) 값만 지원됩니다.
source	string minLength: 2 maxLength: 100	리소스의 원본입니다.
status	string minLength: 0 maxLength: 100	리소스의 상태입니다.
type	string	속해 있는 형식입니다.

BoundaryMetadataListResponse

Object

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

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

BoundaryParentType

열거형

속해 있는 부모의 형식입니다. 즉, Field, SeasonalField, Zone, Prescription, PlantTissueAnalysis, ApplicationData, HarvestData, TillageData, PlantingData.

값	Description
Field
SeasonalField
Zone
Prescription
PlantTissueAnalysis
ApplicationData
PlantingData
TillageData
HarvestData

Error

Object

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

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

ErrorResponse

Object

Azure AgPlatform 서비스의 오류 응답입니다. ErrorResponse 참조 문서는 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 참조하세요.

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

InnerError

Object

오류 목록을 포함하는 내부 오류입니다. InnerError 참조 문서에 대한 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object 참조하세요.

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

Measure

Object

측정값 읽기 및 단위를 저장하기 위한 스키마입니다.

Name	형식	Description
unit	string minLength: 1 maxLength: 50	데이터 단위입니다.
value	number (double)	데이터 값입니다.