Compartir a través de


Blobs - Get Blob

Obtenga un único blob.

Los repositorios tienen un nombre y un identificador. Los identificadores son únicos globalmente, pero varios proyectos pueden contener un repositorio con el mismo nombre. No es necesario incluir el proyecto si especifica un repositorio por identificador. Sin embargo, si especifica un repositorio por nombre, también debe especificar el proyecto (por nombre o identificador).

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
path True

string

El nombre de la organización de Azure DevOps.

repositoryId
path True

string

Nombre o identificador del repositorio.

sha1
path True

string

Hash SHA1 del archivo. Puede obtener el SHA1 de un archivo mediante el punto de conexión "Git/Items/Get Item".

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-preview.1" para usar esta versión de la API.

$format
query

string

Opciones: json, zip, text, octetstream. Si no se establece, el valor predeterminado es el tipo MIME establecido en el encabezado Accept.

download
query

boolean

Si es true, solicite una descarga en lugar de representarla en un explorador. Nota: este valor tiene como valor predeterminado true si $format es zip

fileName
query

string

Proporcione un fileName que se usará para una descarga.

resolveLfs
query

boolean

Si es true, intente resolver un blob en su contenido de LFS, si es un archivo de puntero LFS. Solo es compatible con los encabezados Accept de octet-stream o los tipos de $format

Respuestas

Nombre Tipo Description
200 OK

GitBlobRef

operación correcta

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

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.code Concede la capacidad de leer código fuente y metadatos sobre confirmaciones, conjuntos de cambios, ramas y otros artefactos de control de versiones. También concede la capacidad de buscar código y recibir notificaciones sobre eventos de control de versiones a través de enlaces de servicio.

Ejemplos

Sample Request

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

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

Definiciones

Nombre Description
GitBlobRef
ReferenceLinks

Clase que se va a representar una colección de vínculos de referencia de REST.

GitBlobRef

Nombre Tipo Description
_links

ReferenceLinks

Clase que se va a representar una colección de vínculos de referencia de REST.

objectId

string

Hash SHA1 del objeto git

size

integer

Tamaño del contenido del blob (en bytes)

url

string

Clase que se va a representar una colección de vínculos de referencia de REST.

Nombre Tipo Description
links

object

Vista de lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.