Compartir a través de

Attachments - Create

  • Referencia
Servicio:
Work Item Tracking
Versión de la API:
7.1

Carga datos adjuntos.

En las cuentas con mayores límites de carga de datos adjuntos (>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 de.

POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?api-version=7.1
Con parámetros opcionales: 
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?fileName={fileName}&uploadType={uploadType}&areaPath={areaPath}&api-version=7.1

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
 path True

string

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 "7.1" para usar esta versión de la API.
areaPath
 query

string

Ruta de acceso del área del proyecto de destino
fileName
 query

string

Nombre del archivo
uploadType
 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 (Stream)

Transmisión para cargar

Respuestas

Nombre Tipo Description
200 OK

AttachmentReference

operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

Nombre Description
vso.work_write Concede la capacidad de leer, crear y actualizar elementos de trabajo y consultas, actualizar metadatos del panel de actualización, áreas de lectura e iteraciones rutas de acceso a otros metadatos relacionados con el seguimiento de elementos de trabajo, ejecutar consultas y recibir notificaciones sobre eventos de elemento 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

Solicitud de ejemplo

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

Respuesta de muestra

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

Solicitud de ejemplo

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

"[BINARY FILE CONTENT]"

Respuesta de muestra

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

Solicitud de ejemplo

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

"User text content to upload"

Respuesta de muestra

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

Definiciones

AttachmentReference

Object
Nombre Tipo Description
id

string (uuid)

url

string