Compartilhar via

Attachments - Create

  • Referência
Serviço:
Work Item Tracking
Versão da API:
7.1

Carrega um anexo.

Em contas com limites de carregamento 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 de carregamento 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
Com parâmetros opcionais: 
POST https://dev.azure.com/{organization}/{project}/_apis/wit/attachments?fileName={fileName}&uploadType={uploadType}&areaPath={areaPath}&api-version=7.1

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' 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 (Stream)

Transmitir para carregar

Respostas

Nome Tipo Description
200 OK

AttachmentReference

operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do 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

Escopos

Nome Description
vso.work_write Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler área e iterações caminhos de outros metadados relacionados ao item de trabalho, 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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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

Solicitação de exemplo

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

"[BINARY FILE CONTENT]"

Resposta de exemplo

Código de status:
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

Solicitação de exemplo

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

"User text content to upload"

Resposta de exemplo

Código de status:
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

Objeto
Nome Tipo Description
id

string (uuid)

url

string