Freigeben über

Attachments - Create

  • Referenz
Dienst:
Work Item Tracking
API-Version:
7.1

Lädt eine Anlage hoch.

Bei Konten mit höheren Uploadbeschränkungen für Anlagen (>130 MB) müssen Sie den blockierten Upload verwenden. Um eine Anlage in mehreren Abschnitten hochzuladen, müssen Sie zuerst "Blockupload starten" und dann dem Beispiel aus dem Abschnitt "Block hochladen" folgen.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?api-version=7.1
Mit optionalen Parametern: 
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?fileName={fileName}&uploadType={uploadType}&areaPath={areaPath}&api-version=7.1

URI-Parameter

Name In Erforderlich Typ Beschreibung
organization
 path True

string

Der Name der Azure DevOps-Organisation.
project
 path

string

Projekt-ID oder Projektname
api-version
 query True

string

Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.
areaPath
 query

string

Zielprojektbereichspfad
fileName
 query

string

Der Name der Datei
uploadType
 query

string

Typ des Anlagenuploads: Einfach oder blockiert

Anforderungstext

Media Types: "application/octet-stream"

Name Typ Beschreibung
body

string (Stream)

Stream zum Hochladen

Antworten

Name Typ Beschreibung
200 OK

AttachmentReference

Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

Name Beschreibung
vso.work_write Gewährt die Möglichkeit, Arbeitsaufgaben und Abfragen zu lesen, zu erstellen und zu aktualisieren, Boardmetadaten zu aktualisieren, Bereiche und Iterationspfade für andere Pfade für die Nachverfolgung verwandter Arbeitsaufgaben zu aktualisieren, Abfragen auszuführen und Benachrichtigungen über Arbeitsaufgabenereignisse über Diensthaken zu erhalten.

Beispiele

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

Start a Chunked Upload

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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

Beispielanforderung

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

"[BINARY FILE CONTENT]"

Beispiel für eine Antwort

Statuscode:
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

Beispielanforderung

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

"User text content to upload"

Beispiel für eine Antwort

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

Definitionen

AttachmentReference

Objekt
Name Typ Beschreibung
id

string (uuid)

url

string