Freigeben über


Attachments - Create

Lädt eine Anlage hoch.

Bei Konten mit höheren Grenzwerten für das Hochladen von Anlagen (>130 MB) müssen Sie den blockierten Upload verwenden. Um eine Anlage in mehreren Blöcken hochzuladen, müssen Sie zunächst einen Blockupload starten und dann dem Beispiel im Abschnitt Block hochladen folgen.

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

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-preview.3" festgelegt werden, um diese Version der API zu verwenden.

areaPath
query

string

Zielprojektbereichspfad

fileName
query

string

Der Name der Datei

uploadType
query

string

Anlageuploadtyp: Einfach oder blockiert

Anforderungstext

Media Types: "application/octet-stream"

Name Typ Beschreibung
body

string

Streamen zum Hochladen

Antworten

Name Typ Beschreibung
200 OK

AttachmentReference

Erfolgreicher Vorgang

Sicherheit

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

Name Beschreibung
vso.work_write Ermöglicht das Lesen, Erstellen und Aktualisieren von Arbeitselementen und Abfragen, Aktualisieren von Boardmetadaten, Lesebereichs- und Iterationspfaden für andere Metadaten zur Nachverfolgung von Arbeitselementen, Ausführen von Abfragen und das Empfangen von Benachrichtigungen über Arbeitselementereignisse über Diensthaken.

Beispiele

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=7.1-preview.3

Sample Response

{
  "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=7.1-preview.3

"[BINARY FILE CONTENT]"

Sample Response

{
  "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=7.1-preview.3

"User text content to upload"

Sample Response

{
  "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

Name Typ Beschreibung
id

string

url

string