Partilhar via

Attachments - Create

  • Referência
Service:
Work Item Tracking
API Version:
7.1-preview.3

Carrega um anexo.

Em contas com limites de upload de anexos mais altos (>130 MB), você precisará usar o upload em partes. Para carregar um anexo em várias partes, primeiro você precisa iniciar um upload em partes e, em seguida, seguir o exemplo da seção Carregar Parte .

POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?api-version=7.1-preview.3
With optional parameters: 
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?fileName={fileName}&uploadType={uploadType}&areaPath={areaPath}&api-version=7.1-preview.3

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
 path True

string

O nome da organização do Azure DevOps.
project
 path

string

ID do projeto ou nome do projeto
api-version
 query True

string

Versão da API a ser usada. Isso deve ser definido como '7.1-preview.3' para usar essa versão da API.
areaPath
 query

string

Caminho da área do projeto de destino
fileName
 query

string

O nome do arquivo
uploadType
 query

string

Tipo de carregamento de anexo: simples ou em partes

Corpo da solicitação

Media Types: "application/octet-stream"

Nome Tipo Description
body

string

Fluxo a ser carregado

Respostas

Nome Tipo Description
200 OK

AttachmentReference

operação bem-sucedida

Segurança

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 Description
vso.work_write Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler caminhos de área e iterações de outros itens de trabalho que acompanham metadados relacionados, executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço.

Exemplos

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=7.1-preview.3

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=7.1-preview.3

"[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=7.1-preview.3

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

Definições

AttachmentReference

Nome Tipo Description
id

string

url

string