Sdílet prostřednictvím

Attachments - Create

  • Reference
Služba:
Work Item Tracking
Verze rozhraní API:
7.1

Nahraje přílohu.

U účtů s vyššími limity nahrávání příloh (>130 MB) budete muset použít blokované nahrávání. Pokud chcete nahrát přílohu do několika bloků dat, musíte nejprve Spustit blokované nahrávání a poté postupovat podle příkladu v části Nahrát blok dat.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?api-version=7.1
S volitelnými parametry: 
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?fileName={fileName}&uploadType={uploadType}&areaPath={areaPath}&api-version=7.1

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
organization
 path True

string

Název organizace Azure DevOps.
project
 path

string

ID projektu nebo název projektu
api-version
 query True

string

Verze rozhraní API, která se má použít. Pokud chcete použít tuto verzi rozhraní API, měla by být nastavená na hodnotu 7.1.
areaPath
 query

string

Cesta oblasti cílového projektu
fileName
 query

string

Název souboru
uploadType
 query

string

Typ nahrání přílohy: Jednoduché nebo blokované

Text požadavku

Media Types: "application/octet-stream"

Name Typ Description
body

string (Stream)

Streamování k nahrání

Odpovědi

Name Typ Description
200 OK

AttachmentReference

úspěšná operace

Zabezpečení

oauth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL tokenu: 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

Rozsahy

Name Description
vso.work_write Uděluje možnost číst, vytvářet a aktualizovat pracovní položky a dotazy, metadata aktualizačního panelu, oblast čtení a iterace cesty k jiným metadatům souvisejícím se sledováním pracovních položek, spouštění dotazů a přijímání oznámení o událostech pracovních položek prostřednictvím volání služeb.

Příklady

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

Start a Chunked Upload

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

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

"[BINARY FILE CONTENT]"

Ukázková odpověď

Stavový kód:
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

Ukázkový požadavek

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

"User text content to upload"

Ukázková odpověď

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

Definice

AttachmentReference

Objekt
Name Typ Description
id

string (uuid)

url

string