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

Chemical Products - Create Or Update

参考

Service:: Azure Data Manager for Agriculture

API Version:: 2023-11-01-preview

创建或更新 chemicalProduct 资源。

PATCH {endpoint}/chemical-products/{chemicalProductId}?api-version=2023-11-01-preview

URI 参数

名称	在	必需	类型	说明
chemicalProductId	path	True	string	chemicalProduct 资源的 ID。
endpoint	path	True	string uri	命名空间的主机名，例如 admaInstanceName.farmbeats.azure.net
api-version	query	True	string	请求的 API 版本

请求头

Media Types: "application/merge-patch+json"

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

请求正文

Media Types: "application/merge-patch+json"

名称	类型	说明
activeIngredients	string[]	配方中的活性化学品。
brand	string	化工产品的商业品牌。
company	Company	公司/制造商的详细信息。
cropIds	string[]	与化学产品关联的作物的 ID。注意：最多可以有 25 个作物与 cropProduct 相关联。
description	string	资源的文本说明。
formulation	string	公式说明。基于源的 N、P、K、CA、MG、S、FE、MN、ZN、CU、B、MO、CL (的百分比或其他单位，可用化学元素可能有所不同，但这是) 的典型列表。
location	string	使用化学品的区域。从合规性的角度来看，这一点很重要。
name	string	用于标识资源的名称。
product	string	化工产品的商业产品名称。
properties		属于资源的键值对的集合。每对的键不能超过 50 个字符，并且值不能大于 150 个字符。注意：最多可以为资源提供 25 个键值对，并且仅支持字符串、数字和日期时间 (yyyy-MM-ddTHH：mm：ssZ) 值。
reEntryInterval	integer	应用化学产品后，一个人可以访问现场的天数。
reference	Reference	对数据集记录的引用。
registrationNumber	string	化学品的注册号。这可能因地理位置而异。
source	string	资源的源。
specificGravity	string	特定重力详细信息。
state	string	Liquid/non Liquid。
status	string	资源的状态。
type	string	除草剂、添加剂、杀虫剂、化肥。

响应

名称	类型	说明
200 OK	ChemicalProduct	成功
201 Created	ChemicalProduct	创建
Other Status Codes	ErrorResponse	错误 Headers x-ms-error-code: string

名称

类型

说明

200 OK

ChemicalProduct

成功

201 Created

ChemicalProduct

创建

Other Status Codes

ErrorResponse

错误

Headers

x-ms-error-code: string

安全性

Authorization

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

Type: apiKey
In: header

示例

ChemicalProducts_CreateOrUpdate

Sample Request

HTTP

PATCH {endpoint}/chemical-products/Chemical123?api-version=2023-11-01-preview

{
  "cropIds": [
    "CropId"
  ],
  "reference": {
    "datasetId": "datasetId",
    "recordId": "recordId"
  },
  "brand": "Brand",
  "product": "AGTECH",
  "type": "Herbicide",
  "state": "Liquid",
  "activeIngredients": [
    "NO2"
  ],
  "specificGravity": "string",
  "formulation": "N, P, K",
  "company": {
    "name": "CompanyName",
    "description": "Agriculture Manufacturer",
    "registrationNumber": "1234"
  },
  "location": "US",
  "registrationNumber": "1234",
  "reEntryInterval": 5,
  "status": "Active",
  "source": "Manufacturer",
  "name": "Fertilizer1",
  "description": "string",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  }
}

Sample Response

Status code:: 200

{
  "id": "Chemical123",
  "cropIds": [
    "CropId"
  ],
  "reference": {
    "datasetId": "datasetId",
    "recordId": "recordId"
  },
  "brand": "Brand",
  "product": "AGTECH",
  "type": "Herbicide",
  "state": "Liquid",
  "activeIngredients": [
    "NO2"
  ],
  "specificGravity": "string",
  "formulation": "N, P, K",
  "company": {
    "name": "CompanyName",
    "description": "Agriculture Manufacturer",
    "registrationNumber": "1234"
  },
  "location": "US",
  "registrationNumber": "1234",
  "reEntryInterval": 5,
  "status": "Active",
  "source": "Manufacturer",
  "name": "Fertilizer1",
  "description": "string",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  },
  "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"
}

Status code:: 201

{
  "id": "Chemical123",
  "cropIds": [
    "CropId"
  ],
  "reference": {
    "datasetId": "datasetId",
    "recordId": "recordId"
  },
  "brand": "Brand",
  "product": "AGTECH",
  "type": "Herbicide",
  "state": "Liquid",
  "activeIngredients": [
    "NO2"
  ],
  "specificGravity": "string",
  "formulation": "N, P, K",
  "company": {
    "name": "CompanyName",
    "description": "Agriculture Manufacturer",
    "registrationNumber": "1234"
  },
  "location": "US",
  "registrationNumber": "1234",
  "reEntryInterval": 5,
  "status": "Active",
  "source": "Manufacturer",
  "name": "Fertilizer1",
  "description": "string",
  "properties": {
    "key1": "value1",
    "key2": 123.45
  },
  "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"
}

定义

名称	说明
ChemicalProduct	ChemicalProduct 资源的架构。
Company	公司/制造商的详细信息。
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 。
Reference	对数据集记录的引用。

ChemicalProduct

ChemicalProduct 资源的架构。

名称	类型	说明
activeIngredients	string[]	配方中的活性化学品。
brand	string	化工产品的商业品牌。
company	Company	公司/制造商的详细信息。
createdBy	string	由用户/租户 ID 创建。
createdDateTime	string	创建资源的日期时间，示例格式：yyyy-MM-ddTHH:mm:ssZ。
cropIds	string[]	与化学产品关联的作物的 ID。注意：最多可以有 25 个作物与 cropProduct 相关联。
description	string	资源的文本说明。
eTag	string	用于实现乐观并发的 ETag 值。
formulation	string	公式说明。基于源的 N、P、K、CA、MG、S、FE、MN、ZN、CU、B、MO、CL (的百分比或其他单位，可用化学元素可能有所不同，但这是) 的典型列表。
id	string	唯一的资源 ID。
location	string	使用化学品的区域。从合规性的角度来看，这一点很重要。
modifiedBy	string	由用户/租户 ID 修改。
modifiedDateTime	string	上次修改资源的日期时间，示例格式：yyyy-MM-ddTHH:mm:ssZ。
name	string	用于标识资源的名称。
product	string	化工产品的商业产品名称。
properties		属于资源的键值对的集合。每对的键不能超过 50 个字符，并且值不能大于 150 个字符。注意：最多可以为资源提供 25 个键值对，并且仅支持字符串、数字和日期时间 (yyyy-MM-ddTHH：mm：ssZ) 值。
reEntryInterval	integer	应用化学产品后，一个人可以访问现场的天数。
reference	Reference	对数据集记录的引用。
registrationNumber	string	化学品的注册号。这可能因地理位置而异。
source	string	资源的源。
specificGravity	string	特定重力详细信息。
state	string	Liquid/non Liquid。
status	string	资源的状态。
type	string	除草剂、添加剂、杀虫剂、化肥。

Company

公司/制造商的详细信息。

名称	类型	说明
description	string	制造公司说明。
name	string	制造公司的名称。
registrationNumber	string	公司的注册号。

Error

Azure AgPlatform 服务出错。

名称	类型	说明
code	string	服务器定义的错误代码集。
details	Error[]	有关导致此报告错误的特定错误的详细信息数组。
innererror	InnerError	包含错误列表的内部错误。有关 InnerError 参考文档，请参阅 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object 。
message	string	错误的用户可读表示形式。
target	string	错误的目标。

ErrorResponse

来自 Azure AgPlatform 服务的错误响应。有关 ErrorResponse 参考文档，请参阅 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses 。

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

InnerError

包含错误列表的内部错误。有关 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 。

Reference

对数据集记录的引用。

名称	类型	说明
datasetId	string	数据集 ID。
recordId	string	记录 ID。

通过

Chemical Products - Create Or Update

URI 参数

请求头

请求正文

响应

安全性

Authorization

示例

ChemicalProducts_CreateOrUpdate

Sample Request

Sample Response

定义

ChemicalProduct

Company

Error

ErrorResponse

InnerError

Reference

其他资源