通过

Attachments - Create

  • 参考
服务:
Work Item Tracking
API 版本:
7.1

上传附件。

在附件上传限制较高的帐户（>130MB），需要使用分块上传。 若要在多个区块中上传附件，首先需要 启动分块上传，然后按照 上传区块 部分中的示例进行作。

POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?api-version=7.1
具有可选参数: 
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?fileName={fileName}&uploadType={uploadType}&areaPath={areaPath}&api-version=7.1

URI 参数

名称 在 必需 类型 说明
organization
 path True

string

Azure DevOps 组织的名称。
project
 path

string

项目 ID 或项目名称
api-version
 query True

string

要使用的 API 版本。 这应设置为“7.1”才能使用此版本的 API。
areaPath
 query

string

目标项目区域路径
fileName
 query

string

文件的名称
uploadType
 query

string

附件上传类型：简单或分块

请求正文

Media Types: "application/octet-stream"

名称 类型 说明
body

string (Stream)

要上传的流

响应

名称 类型 说明
200 OK

AttachmentReference

成功作

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

作用域

名称 说明
vso.work_write 授予读取、创建和更新工作项和查询、更新板元数据、读取区域和迭代路径、其他工作项跟踪相关元数据、执行查询以及通过服务挂钩接收有关工作项事件的通知的能力。

示例

Start a Chunked Upload
Upload a binary file
Upload a text file

Start a Chunked Upload

示例请求

POST https://dev.azure.com/fabrikam/_apis/wit/attachments?fileName=largefile.zip&uploadType=chunked&api-version=7.1

示例响应

状态代码:
201 
{
  "id": "de471719-27b2-40ab-ac40-4890f3eb1443",
  "url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/de471719-27b2-40ab-ac40-4890f3eb1443?fileName=test.txt"
}

Upload a binary file

示例请求

POST https://dev.azure.com/fabrikam/_apis/wit/attachments?fileName=imageAsFileAttachment.png&api-version=7.1

"[BINARY FILE CONTENT]"

示例响应

状态代码:
201 
{
  "id": "a5cedde4-2dd5-4fcf-befe-fd0977dd3433",
  "url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/a5cedde4-2dd5-4fcf-befe-fd0977dd3433?fileName=imageAsFileAttachment.png"
}

Upload a text file

示例请求

POST https://dev.azure.com/fabrikam/_apis/wit/attachments?fileName=textAsFileAttachment.txt&api-version=7.1

"User text content to upload"

示例响应

状态代码:
201 
{
  "id": "6b2266bf-a155-4582-a475-ca4da68193ef",
  "url": "https://dev.azure.com/fabrikam/_apis/wit/attachments/6b2266bf-a155-4582-a475-ca4da68193ef?fileName=textAsFileAttachment.txt"
}

定义

AttachmentReference

Object
名称 类型 说明
id

string (uuid)

url

string