Compartilhar via


Blobs - Get Blob

Obtenha um único blob.

Os repositórios têm um nome e um identificador. Os identificadores são globalmente exclusivos, mas vários projetos podem conter um repositório de mesmo nome. Você não precisará incluir o projeto se especificar um repositório por ID. No entanto, se você especificar um repositório por nome, também deverá especificar o projeto (por nome ou ID).

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/blobs/{sha1}?api-version=5.0
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/blobs/{sha1}?download={download}&fileName={fileName}&$format={$format}&resolveLfs={resolveLfs}&api-version=5.0

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
path True

string

O nome da organização do Azure DevOps.

repositoryId
path True

string

O nome ou a ID do repositório.

sha1
path True

string

Hash SHA1 do arquivo. Você pode obter o SHA1 de um arquivo usando o ponto de extremidade "Git/Items/Get Item".

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 '5.0' para usar essa versão da api.

$format
query

string

Opções: json, zip, text, octetstream. Se não for definido, o padrão será o tipo MIME definido no cabeçalho Aceitar.

download
query

boolean

Se for true, solicite um download em vez de renderizar em um navegador. Observação: esse valor usará como padrão true se $format for zip

fileName
query

string

Forneça um fileName a ser usado para um download.

resolveLfs
query

boolean

Se for true, tente resolve um blob para seu conteúdo LFS, se for um arquivo de ponteiro LFS. Compatível apenas com os cabeçalhos Accept de fluxo de octeto ou tipos de $format

Respostas

Nome Tipo Description
200 OK

GitBlobRef

operação bem-sucedida

Media Types: "application/zip", "application/octet-stream", "application/json"

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.code Concede a capacidade de ler código-fonte e metadados sobre commits, conjuntos de alterações, branches e outros artefatos de controle de versão. Também concede a capacidade de pesquisar código e ser notificado sobre eventos de controle de versão por meio de ganchos de serviço.

Exemplos

Sample Request

GET https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/blobs/{sha1}?api-version=5.0

Sample Response

{
  "objectId": "61a86fdaa79e5c6f5fb6e4026508489feb6ed92c",
  "size": 1486,
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/blobs/61a86fdaa79e5c6f5fb6e4026508489feb6ed92c",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/blobs/61a86fdaa79e5c6f5fb6e4026508489feb6ed92c"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249"
    }
  }
}

Definições

Nome Description
GitBlobRef
ReferenceLinks

A classe para representar uma coleção de links de referência REST.

GitBlobRef

Nome Tipo Description
_links

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

objectId

string

Hash SHA1 do objeto git

size

integer

Tamanho do conteúdo do blob (em bytes)

url

string

A classe para representar uma coleção de links de referência REST.

Nome Tipo Description
links

object

A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.