Partager via


Blobs - Get Blob

Obtenir un objet blob unique.

Les dépôts ont à la fois un nom et un identificateur. Les identificateurs sont globalement uniques, mais plusieurs projets peuvent contenir un dépôt du même nom. Vous n’avez pas besoin d’inclure le projet si vous spécifiez un dépôt par ID. Toutefois, si vous spécifiez un dépôt par son nom, vous devez également spécifier le projet (par nom 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

Paramètres URI

Nom Dans Obligatoire Type Description
organization
path True

string

Nom de l’organisation Azure DevOps.

repositoryId
path True

string

Nom ou ID du dépôt.

sha1
path True

string

Hachage SHA1 du fichier. Vous pouvez obtenir le SHA1 d’un fichier à l’aide du point de terminaison « Git/Items/Get Item ».

project
path

string

ID de projet ou nom du projet

api-version
query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 5.0 » pour utiliser cette version de l’API.

$format
query

string

Options : json, zip, text, octetstream. S’il n’est pas défini, le type MIME est défini par défaut dans l’en-tête Accept.

download
query

boolean

Si la valeur est true, demandez un téléchargement au lieu d’un rendu dans un navigateur. Remarque : cette valeur par défaut est true si $format est zip

fileName
query

string

Fournissez un fileName à utiliser pour un téléchargement.

resolveLfs
query

boolean

Si la valeur est true, essayez de résoudre un objet blob à son contenu LFS, s’il s’agit d’un fichier de pointeur LFS. Compatible uniquement avec les types d’en-têtes ou de $format accepter le flux d’octets

Réponses

Nom Type Description
200 OK

GitBlobRef

opération réussie

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

Sécurité

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

Nom Description
vso.code Permet de lire le code source et les métadonnées sur les commits, les ensembles de modifications, les branches et d’autres artefacts de contrôle de version. Accorde également la possibilité de rechercher du code et d’être informé des événements de contrôle de version via des hooks de service.

Exemples

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

Définitions

Nom Description
GitBlobRef
ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

GitBlobRef

Nom Type Description
_links

ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

objectId

string

Hachage SHA1 de l’objet git

size

integer

Taille du contenu d’objet blob (en octets)

url

string

Classe pour représenter une collection de liens de référence REST.

Nom Type Description
links

object

Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.