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

Attachments - Create Or Update

Service:

Azure Data Manager for Agriculture

API Version:

2023-11-01-preview

创建或更新特定参与方下的附件资源。

PATCH {endpoint}/parties/{partyId}/attachments/{attachmentId}?api-version=2023-11-01-preview

URI 参数

名称	在	必需	类型	说明
createdBy	formData		string	由用户/租户 ID 创建。
createdDateTime	formData		string date-time	创建资源的日期。
description	formData		string	资源的文字说明。
eTag	formData		string	用于实现乐观并发的 ETag 值。
file	formData		file binary	要上传的文件。
id	formData		string	唯一 ID。
modifiedBy	formData		string	由用户/租户 ID 修改。
modifiedDateTime	formData		string date-time	上次修改资源的日期。
name	formData		string	用于标识资源的名称。
originalFileName	formData		string	此附件的原始文件名。
resourceId	formData		string	此附件的关联资源 ID。
resourceType	formData		string	此附件的关联资源类型。
source	formData		string	资源的源。
status	formData		string	资源的状态。
attachmentId	path	True	string	附件资源的 ID。
endpoint	path	True	string uri	命名空间的主机名，例如 admaInstanceName.farmbeats.azure.net
partyId	path	True	string	关联方资源的 ID。
api-version	query	True	string	请求的 API 版本

请求头

Media Types: "multipart/form-data"

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

响应

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

安全性

Authorization

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

Type: apiKey
In: header

示例

Attachments_CreateOrUpdate

Sample Request

HTTP

PATCH {endpoint}/parties/PARTY123/attachments/ATTACHMENT123?api-version=2023-11-01-preview

Sample Response

Status code:

200

{
  "id": "ATTACHMENT123",
  "partyId": "PARTY123",
  "resourceId": "PARTY123",
  "resourceType": "Party",
  "originalFileName": "attachment-file",
  "name": "John Smith's Field",
  "status": "Active",
  "description": "Some description",
  "source": "source",
  "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": "ATTACHMENT123",
  "partyId": "PARTY123",
  "resourceId": "PARTY123",
  "resourceType": "Party",
  "originalFileName": "attachment-file",
  "name": "John Smith's Field",
  "status": "Active",
  "description": "Some description",
  "source": "source",
  "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"
}

定义

名称	说明
Attachment	附件资源的架构。
AttachmentResourceType	此附件的关联资源类型。
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 。

Attachment

附件资源的架构。

名称	类型	说明
createdBy	string	由用户/租户 ID 创建。
createdDateTime	string	创建资源的日期。
description	string	资源的文字说明。
eTag	string	用于实现乐观并发的 ETag 值。
id	string	唯一 ID。
modifiedBy	string	由用户/租户 ID 修改。
modifiedDateTime	string	上次修改资源的日期。
name	string	用于标识资源的名称。
originalFileName	string	此附件的原始文件名。
partyId	string	此附件的 PartyId ID。
resourceId	string	此附件的关联资源 ID。
resourceType	AttachmentResourceType	此附件的关联资源类型。
source	string	资源的源。
status	string	资源的状态。

AttachmentResourceType

此附件的关联资源类型。

名称	类型	说明
ApplicationData	string
Farm	string
Field	string
HarvestData	string
Party	string
PlantTissueAnalysis	string
PlantingData	string
Prescription	string
SeasonalField	string
TillageData	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 。