你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Model Inference - Get Soil Moisture Model Job

参考

服务:: Azure Data Manager for Agriculture

API 版本:: 2023-07-01-preview

获取 SoilMoisture 模型作业的详细信息。

GET /model-inference/models/microsoft-soil-moisture/infer-data/{jobId}?api-version=2023-07-01-preview

URI 参数

名称	在	必需	类型	说明
jobId	path	True	string	作业的 ID。
api-version	query	True	string	请求的 API 版本

请求头

名称	必需	类型	说明
Authorization	True	string	请为授权的 API 调用提供有效的持有者令牌。请注意，如果之前尝试了未经身份验证的调用，可能需要清除浏览器缓存。

响应

名称	类型	说明
200 OK	SoilMoistureModelJob	成功
Other Status Codes	ErrorResponse	错误标头 x-ms-error-code: string

名称

类型

说明

200 OK

SoilMoistureModelJob

成功

Other Status Codes

ErrorResponse

错误

标头

x-ms-error-code: string

安全性

Authorization

请为授权的 API 调用提供有效的持有者令牌。请注意，如果之前尝试了未经身份验证的调用，可能需要清除浏览器缓存。

类型: apiKey
在: header

示例

ModelInference_GetSoilMoistureModelJob

示例请求

HTTP

GET /model-inference/models/microsoft-soil-moisture/infer-data/JOB123?api-version=2023-07-01-preview

示例响应

状态代码:: 200

{
  "durationInSeconds": 52.4,
  "id": "biomass-job",
  "status": "Succeeded",
  "message": "Successfully calculated soil moisture feature in the given date range and created relevant Insight(s) and InsightAttachment(s).",
  "createdDateTime": "2021-04-16T08:24:50Z",
  "lastActionDateTime": "2021-04-16T08:24:50Z",
  "startTime": "2021-04-16T08:24:50Z",
  "endTime": "2021-04-16T08:24:50Z",
  "name": "string",
  "description": "string",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  },
  "partyId": "string",
  "associatedResource": {
    "type": "Field",
    "id": "FieldId"
  },
  "modelVersion": "string",
  "sensorDataModelId": "string",
  "sensorPartnerId": "string",
  "inferenceStartDateTime": "2020-04-16T10:14:12Z",
  "inferenceEndDateTime": "2020-09-16T10:14:12Z",
  "satelliteProvider": "Microsoft",
  "satelliteSource": "Sentinel_2_L2A",
  "sensorDefinition": {
    "sensorMeasurement": "string",
    "minProperty": "string",
    "maxProperty": "string"
  },
  "imageResolution": 10,
  "imageFormat": "TIF"
}

定义

名称	说明
DataProvider	卫星数据的提供程序。
Error	Azure AgPlatform 服务中的错误。
ErrorResponse	Azure AgPlatform 服务的错误响应。请参阅 errorResponse 参考文档 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。
FarmHierarchyGeoResourceType	资源类型。
GeoResource	用于存储资源类型和资源 ID 的架构。
ImageFormat	场景资源支持的图像格式。
InnerError	包含错误列表的内部错误。请参阅 innerError 参考文档 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object。
SoilMoistureModelJob	土壤湿度模型作业的架构。
SoilMoistureModelSensorDefinition	用于存储传感器定义关键字的架构。
Source	卫星数据的源。

DataProvider

枚举

卫星数据的提供程序。

值	说明
Microsoft

Error

Object

Azure AgPlatform 服务中的错误。

名称	类型	说明
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。

名称	类型	说明
error	Error	Azure AgPlatform 服务中的错误。
traceId	string	唯一跟踪 ID。

FarmHierarchyGeoResourceType

枚举

资源类型。

值	说明
ApplicationData
Field
HarvestData
PlantTissueAnalysis
PlantingData
Prescription
SeasonalField
TillageData
Zone

GeoResource

Object

用于存储资源类型和资源 ID 的架构。

名称	类型	说明
id	string	资源 ID。
type	FarmHierarchyGeoResourceType	资源类型。

ImageFormat

枚举

场景资源支持的图像格式。

值	说明
TIF

InnerError

Object

包含错误列表的内部错误。请参阅 innerError 参考文档 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object。

名称	类型	说明
code	string	包含的错误提供的特定错误代码。
innererror	InnerError	包含错误列表的内部错误。请参阅 innerError 参考文档 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object。

SoilMoistureModelJob

Object

土壤湿度模型作业的架构。

名称	类型	说明
associatedResource	GeoResource	用于存储资源类型和资源 ID 的架构。
createdBy	string	由用户/租户 ID 创建。
createdDateTime	string (date-time)	在 dateTime 创建的作业。示例格式：yyyy-MM-ddTHH：mm：ssZ。
description	string minLength: 0 maxLength: 500	资源的文本说明。
durationInSeconds	number (double)	作业持续时间（以秒为单位）。
endTime	string (date-time)	作业结束时间（可用）。示例格式：yyyy-MM-ddTHH：mm：ssZ。
errorCode	string	作业失败时的错误代码。
id	string	唯一作业 ID。
imageFormat	ImageFormat minLength: 1	ImageFormat。可用值：TIF。
imageResolution	number (double)	ImageResolution（以米为单位）。可用值：10、20、60。
inferenceEndDateTime	string (date-time)	土壤湿度计算的推理结束日期时间。
inferenceStartDateTime	string (date-time)	土壤湿度计算的推理开始日期时间。
lastActionDateTime	string (date-time)	作业在 dateTime 上最后一次执行。示例格式：yyyy-MM-ddTHH：mm：ssZ。
message	string	用于捕获作业更多详细信息的状态消息。
modelVersion	string minLength: 1	要运行的土壤湿度模型的版本。
modifiedBy	string	由用户/租户 ID 修改。
name	string minLength: 0 maxLength: 100	用于标识资源的名称。
partyId	string minLength: 1	群 ID。
properties		属于资源的键值对的集合。每对不能具有大于 50 个字符的键，并且不能具有大于 150 个字符的值。注意：最多可以为资源提供 25 个键值对，仅支持字符串、数字和日期/时间（yyyy-MM-ddTHH：mm：ssZ）值。
satelliteProvider	DataProvider minLength: 1	卫星数据的提供程序。可用值：Microsoft、SentinelHub（由 Sinergise 发送的 Sentinel Hub）。
satelliteSource	Source minLength: 1	卫星数据的源。可用值：Sentinel_2_L2A。
sensorDataModelId	string minLength: 1	传感器数据模型 ID。
sensorDefinition	SoilMoistureModelSensorDefinition	用于存储传感器定义关键字的架构。
sensorPartnerId	string minLength: 1	传感器合作伙伴 ID。
startTime	string (date-time)	作业开始时间（可用）。示例格式：yyyy-MM-ddTHH：mm：ssZ。
status	string	作业的状态。可能的值：“Waiting”、“Running”、“Succeeded”、“Failed”、“Cancelled”。

SoilMoistureModelSensorDefinition

Object

用于存储传感器定义关键字的架构。

名称	类型	说明
maxProperty	string minLength: 1	最大度量值的度量名称。
minProperty	string minLength: 1	最小值度量值的度量名称。
sensorMeasurement	string minLength: 1	sensorDataModel 中传感器度量值的度量名称。

Source

枚举

卫星数据的源。

值	说明
Sentinel_2_L1C
Sentinel_2_L2A

通过

Model Inference - Get Soil Moisture Model Job

URI 参数

请求头

响应

安全性

Authorization

示例

ModelInference_GetSoilMoistureModelJob

示例请求

示例响应

定义

DataProvider

Error

ErrorResponse

FarmHierarchyGeoResourceType

GeoResource

ImageFormat

InnerError

SoilMoistureModelJob

SoilMoistureModelSensorDefinition

Source