Attachments - Create
Carga un archivo adjunto.
En las cuentas con límites de carga de datos adjuntos superiores (>130 MB), deberá usar la carga fragmentada. Para cargar datos adjuntos en varios fragmentos, primero debe iniciar una carga fragmentada y, a continuación, seguir el ejemplo de la sección Cargar fragmento .
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
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
organization
|
path | True |
string |
El nombre de la organización de Azure DevOps. |
project
|
path |
string |
Id. de proyecto o nombre del proyecto |
|
api-version
|
query | True |
string |
Versión de la API que se va a usar. Debe establecerse en "5.0" para usar esta versión de la API. |
area
|
query |
string |
Ruta de acceso del área del proyecto de destino |
|
file
|
query |
string |
Nombre del archivo |
|
upload
|
query |
string |
Tipo de carga de datos adjuntos: Simple o Fragmentado |
Cuerpo de la solicitud
Media Types: "application/octet-stream"
Nombre | Tipo | Description |
---|---|---|
body |
string |
Transmisión para cargar |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
operación correcta |
Seguridad
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
Nombre | Description |
---|---|
vso.work_write | Concede la capacidad de leer, crear y actualizar elementos de trabajo y consultas, actualizar metadatos del panel, leer áreas de lectura e iteraciones rutas de acceso a otros metadatos relacionados de seguimiento de elementos de trabajo, ejecutar consultas y recibir notificaciones sobre eventos de elementos de trabajo a través de enlaces de servicio. |
Ejemplos
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"
}
Definiciones
AttachmentReference
Nombre | Tipo | Description |
---|---|---|
id |
string |
|
url |
string |