Condividi tramite

Attachments - Create

  • Riferimento
Service:
Work Item Tracking
API Version:
5.0

Carica un allegato.

Per gli account con limiti di caricamento degli allegati superiori (>130 MB), è necessario usare il caricamento in blocchi. Per caricare un allegato in più blocchi, è prima necessario avviare un caricamento in blocchi e quindi seguire l'esempio dalla sezione Carica blocchi .

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
 path True

string

Nome dell'organizzazione di Azure DevOps.
project
 path

string

ID progetto o nome del progetto
api-version
 query True

string

Versione dell'API da usare. Deve essere impostato su '5.0' per usare questa versione dell'API.
areaPath
 query

string

Percorso area progetto di destinazione
fileName
 query

string

Nome del file
uploadType
 query

string

Tipo di caricamento degli allegati: semplice o in blocchi

Corpo della richiesta

Media Types: "application/octet-stream"

Nome Tipo Descrizione
body

string

Flusso da caricare

Risposte

Nome Tipo Descrizione
200 OK

AttachmentReference

operazione riuscita

Sicurezza

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

Nome Descrizione
vso.work_write Concede la possibilità di leggere, creare e aggiornare elementi di lavoro e query, aggiornare i metadati della scheda, l'area di lettura e le iterazioni dei percorsi di altri metadati correlati al rilevamento degli elementi di lavoro, eseguire query e ricevere notifiche sugli eventi degli elementi di lavoro tramite hook del servizio.

Esempio

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

Definizioni

AttachmentReference

Nome Tipo Descrizione
id

string

url

string