Management Zones - List

Servicio:

Azure Data Manager for Agriculture

Versión de la API:

2023-11-01-preview

Devuelve una lista paginada de recursos de zona de administración en todas las partes.

GET {endpoint}/management-zones?api-version=2023-11-01-preview

Con parámetros opcionales:

GET {endpoint}/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=2023-11-01-preview

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (uri)	Nombre de host del espacio de nombres, por ejemplo, admaInstanceName.farmbeats.azure.net
api-version	query	True	string	La versión de API solicitada
cropIds	query		string[]	CropIds de ManagementZone.
fieldIds	query		string[]	FieldIds de managementZone.
ids	query		string[]	Identificadores del recurso.
maxCreatedDateTime	query		string (date-time)	Fecha máxima de creación del recurso (inclusivo).
maxLastModifiedDateTime	query		string (date-time)	Fecha máxima de última modificación del recurso (inclusive).
maxPageSize	query		integer (int32) minimum: 10 maximum: 1000	Número máximo de elementos necesarios (ambos incluidos). Mínimo = 10, Máximo = 1000, Valor predeterminado = 50.
minCreatedDateTime	query		string (date-time)	Fecha de creación mínima del recurso (inclusivo).
minLastModifiedDateTime	query		string (date-time)	Fecha mínima de última modificación del recurso (inclusive).
names	query		string[]	Nombres del recurso.
propertyFilters	query		string[]	Filtra los pares clave-valor dentro del objeto Properties. Eg. "{testKey} eq {testValue}".
seasonIds	query		string[]	SeasonIds de managementZone.
skipToken	query		string	Omita el token para obtener el siguiente conjunto de resultados.
sources	query		string[]	Orígenes de ManagementZone.
statuses	query		string[]	Estados del recurso.
types	query		string[]	Tipos de ManagementZone.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Authorization	True	string	Proporcione un token de portador válido para las llamadas API autorizadas. Tenga en cuenta que es posible que tenga que borrar la memoria caché del explorador si ha intentado realizar llamadas no autenticadas antes.

Respuestas

Nombre	Tipo	Description
200 OK	ManagementZoneListResponse	Éxito
Other Status Codes	ErrorResponse	Error Encabezados x-ms-error-code: string

Seguridad

Authorization

Proporcione un token de portador válido para las llamadas API autorizadas. Tenga en cuenta que es posible que tenga que borrar la memoria caché del explorador si ha intentado realizar llamadas no autenticadas antes.

Tipo: apiKey
En: header

Ejemplos

ManagementZones_List

Solicitud de ejemplo

HTTP

GET {endpoint}/management-zones?api-version=2023-11-01-preview

Respuesta de muestra

status code:

200

{
  "value": [
    {
      "partyId": "PARTY123",
      "id": "ManagementZone123",
      "type": "Nutrient rich",
      "seasonId": "Season123",
      "cropId": "Crop123",
      "fieldId": "Field123",
      "name": "John Smith's ManagementZone",
      "status": "Active",
      "description": "Some description",
      "source": "source",
      "properties": {
        "Irrigated": "Yes"
      },
      "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"
    }
  ],
  "skipToken": "string",
  "nextLink": "https://{{resourceName}}.farmbeats.azure.net/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"
}

Definiciones

Nombre	Description
Error	Error del servicio Azure AgPlatform.
ErrorResponse	Respuesta de error del servicio Azure AgPlatform. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses para ver el documento de referencia ErrorResponse.
InnerError	Error interno que contiene la lista de errores. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object documento de referencia de InnerError.
ManagementZone	Modelo de API para el objeto ManagementZone.
ManagementZoneListResponse	La respuesta paginada contiene una lista de objetos solicitados y un vínculo de dirección URL para obtener el siguiente conjunto de resultados.

Error

Object

Error del servicio Azure AgPlatform.

Nombre	Tipo	Description
code	string minLength: 1	Conjunto definido por el servidor de códigos de error.
details	Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	InnerError	Error interno que contiene la lista de errores. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object documento de referencia de InnerError.
message	string minLength: 1	Representación legible del error.
target	string	Destino del error.

ErrorResponse

Object

Respuesta de error del servicio Azure AgPlatform. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses para ver el documento de referencia ErrorResponse.

Nombre	Tipo	Description
error	Error	Error del servicio Azure AgPlatform.
traceId	string	Identificador de seguimiento único.

InnerError

Object

Error interno que contiene la lista de errores. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object documento de referencia de InnerError.

Nombre	Tipo	Description
code	string	Código de error específico del proporcionado por el error contenedor.
innererror	InnerError	Error interno que contiene la lista de errores. Consulte https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object documento de referencia de InnerError.

ManagementZone

Object

Modelo de API para el objeto ManagementZone.

Nombre	Tipo	Description
createdBy	string	Creado por el identificador de usuario o inquilino.
createdDateTime	string (date-time)	Fecha y hora en que se creó el recurso, formato de ejemplo: aaaa-MM-ddTHH:mm:ssZ.
cropId	string	Id. de recorte asociado a ManagementZone.
description	string minLength: 0 maxLength: 500	Descripción textual del recurso.
eTag	string	Valor ETag para implementar la simultaneidad optimista.
fieldId	string	Identificador de campo asociado a ManagementZone.
id	string	Identificador de recurso único.
modifiedBy	string	Modificado por identificador de usuario o inquilino.
modifiedDateTime	string (date-time)	Fecha y hora en que el recurso se modificó por última vez, formato de ejemplo: aaaa-MM-ddTHH:mm:ssZ.
name	string minLength: 0 maxLength: 100	Nombre para identificar el recurso.
partyId	string	Id. de entidad asociado a ManagementZone.
properties		Colección de pares clave-valor que pertenece al recurso. Cada par no debe tener una clave superior a 50 caracteres y no debe tener un valor superior a 150 caracteres. Nota: Se pueden proporcionar un máximo de 25 pares clave-valor para un recurso y solo se admiten valores string, numeral y datetime (aaaa-MM-ddTHH:mm:ssZ).
seasonId	string	Id. de temporada asociado a ManagementZone.
source	string minLength: 2 maxLength: 100	Origen del recurso.
status	string minLength: 0 maxLength: 100	Estado del recurso.
type	string minLength: 0 maxLength: 100	Tipo de ManagementZone.

ManagementZoneListResponse

Object

La respuesta paginada contiene una lista de objetos solicitados y un vínculo de dirección URL para obtener el siguiente conjunto de resultados.

Nombre	Tipo	Description
nextLink	string	Vínculo de continuación (URI absoluto) a la siguiente página de resultados en la lista.
skipToken	string	Token usado para recuperar la página siguiente. Si es null, no hay páginas adicionales.
value	ManagementZone[]	Lista de objetos solicitados.