Udostępnij za pośrednictwem

Attachments - Create

  • Odwołanie
Service:
Work Item Tracking
API Version:
5.0

Przekazuje załącznik.

Na kontach z wyższymi limitami przekazywania załączników (>130 MB) należy użyć fragmentowanego przekazywania. Aby przekazać załącznik w wielu fragmentach, najpierw musisz uruchomić fragmentowany przekazywanie , a następnie postępować zgodnie z przykładem w sekcji Przekazywanie fragmentu .

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
 path True

string

Nazwa organizacji usługi Azure DevOps.
project
 path

string

Identyfikator projektu lub nazwa projektu
api-version
 query True

string

Wersja interfejsu API do użycia. Powinno to być ustawione na wartość "5.0", aby używać tej wersji interfejsu API.
areaPath
 query

string

Docelowa ścieżka obszaru projektu
fileName
 query

string

Nazwa pliku
uploadType
 query

string

Typ przekazywania załączników: prosty lub fragmentowany

Treść żądania

Media Types: "application/octet-stream"

Nazwa Typ Opis
body

string

Przesyłanie strumieniowe w celu przekazania

Odpowiedzi

Nazwa Typ Opis
200 OK

AttachmentReference

operacja zakończona powodzeniem

Zabezpieczenia

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

Nazwa Opis
vso.work_write Umożliwia odczytywanie, tworzenie i aktualizowanie elementów roboczych i zapytań, metadanych tablicy aktualizacji, ścieżek obszaru odczytu i iteracji innych metadanych powiązanych elementów roboczych, wykonywania zapytań i odbierania powiadomień o zdarzeniach elementów roboczych za pośrednictwem punktów zaczepienia usługi.

Przykłady

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

Definicje

AttachmentReference

Nazwa Typ Opis
id

string

url

string