Attachments - Create
Charge une pièce jointe.
Sur les comptes avec des limites de chargement de pièces jointes plus élevées (>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 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=5.0
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?fileName={fileName}&uploadType={uploadType}&areaPath={areaPath}&api-version=5.0
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 « 5.0 » pour utiliser cette version de l’API. |
area
|
query |
string |
Chemin de la zone du projet cible |
|
file
|
query |
string |
Nom du fichier |
|
upload
|
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 |
Flux à charger |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
opération réussie |
Sécurité
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
Nom | Description |
---|---|
vso.work_write | Accorde la possibilité de lire, créer et mettre à jour des éléments de travail et des requêtes, mettre à jour les métadonnées du tableau, les zones de lecture et les itérations chemins d’autres métadonnées associées au suivi des éléments de travail, exécuter des requêtes et 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
Sample Request
POST https://dev.azure.com/fabrikam/_apis/wit/attachments?fileName=largefile.zip&uploadType=chunked&api-version=5.0
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=5.0
"[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=5.0
"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"
}
Définitions
AttachmentReference
Nom | Type | Description |
---|---|---|
id |
string |
|
url |
string |