Bagikan melalui

Attachments - Create

  • Referensi
Service:
Work Item Tracking
API Version:
5.0

Mengunggah lampiran.

Pada akun dengan batas unggahan lampiran yang lebih tinggi (>130MB), Anda harus menggunakan unggahan yang dipotong. Untuk mengunggah lampiran dalam beberapa gugus, Anda harus terlebih dahulu Memulai Unggahan Yang Dipotong lalu ikuti contoh dari bagian Unggah Gugus .

POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?api-version=5.0
With optional parameters: 
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?fileName={fileName}&uploadType={uploadType}&areaPath={areaPath}&api-version=5.0

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
organization
 path True

string

Nama organisasi Azure DevOps.
project
 path

string

ID proyek atau nama proyek
api-version
 query True

string

Versi API yang akan digunakan. Ini harus diatur ke '5.0' untuk menggunakan versi api ini.
areaPath
 query

string

Jalur Area proyek target
fileName
 query

string

Nama file
uploadType
 query

string

Jenis unggahan lampiran: Sederhana atau Dipotong

Isi Permintaan

Media Types: "application/octet-stream"

Nama Jenis Deskripsi
body

string

Streaming untuk diunggah

Respons

Nama Jenis Deskripsi
200 OK

AttachmentReference

operasi berhasil

Keamanan

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token 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

Scopes

Nama Deskripsi
vso.work_write Memberikan kemampuan untuk membaca, membuat, dan memperbarui item dan kueri kerja, memperbarui metadata papan, membaca area dan jalur perulangan item kerja lainnya yang melacak metadata terkait, menjalankan kueri, dan untuk menerima pemberitahuan tentang peristiwa item kerja melalui kait layanan.

Contoh

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

Start a Chunked Upload

Sample Request

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

Sample Response

Status code:
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

Sample Request

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

"[BINARY FILE CONTENT]"

Sample Response

Status code:
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

Sample Request

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

"User text content to upload"

Sample Response

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

Definisi

AttachmentReference

Nama Jenis Deskripsi
id

string

url

string