Partager via

Attachments - Create

  • Référence
Service:
Work Item Tracking
Version d'API:
7.1

Charge une pièce jointe.

Sur les comptes avec des limites de chargement de pièces jointes supérieures (>130 Mo), vous devez utiliser le chargement en bloc. Pour charger une pièce jointe en plusieurs blocs, vous devez d’abord Démarrer un de chargement en bloc, puis suivre l’exemple de la section Charger le bloc.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?api-version=7.1
Avec des paramètres facultatifs: 
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?fileName={fileName}&uploadType={uploadType}&areaPath={areaPath}&api-version=7.1

Paramètres URI

Nom Dans Obligatoire Type Description
organization
 path True

string

Nom de l’organisation Azure DevOps.
project
 path

string

ID de projet ou nom du projet
api-version
 query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1 » pour utiliser cette version de l’API.
areaPath
 query

string

Chemin d’accès à la zone du projet cible
fileName
 query

string

Nom du fichier
uploadType
 query

string

Type de chargement de pièce jointe : simple ou segmenté

Corps de la demande

Media Types: "application/octet-stream"

Nom Type Description
body

string (Stream)

Flux à charger

Réponses

Nom Type Description
200 OK

AttachmentReference

opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom Description
vso.work_write Octroie la possibilité de lire, de créer et de mettre à jour des éléments de travail et des requêtes, de mettre à jour des métadonnées de carte, de lire des zones de lecture et des itérations chemins d’accès à d’autres métadonnées associées au suivi des éléments de travail, d’exécuter des requêtes et de recevoir des notifications sur les événements d’élément de travail via des hooks de service.

Exemples

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

Start a Chunked Upload

Exemple de requête

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

Exemple de réponse

Code d’état:
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

Exemple de requête

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

"[BINARY FILE CONTENT]"

Exemple de réponse

Code d’état:
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

Exemple de requête

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

"User text content to upload"

Exemple de réponse

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

Définitions

AttachmentReference

Object
Nom Type Description
id

string (uuid)

url

string