Partager via

Blobs - Get Blob

  • Référence
Service:
Git
Version d'API:
7.1

Obtenez un objet blob unique.

Les référentiels ont à la fois un nom et un identificateur. Les identificateurs sont globalement uniques, mais plusieurs projets peuvent contenir un référentiel du même nom. Vous n’avez pas besoin d’inclure le projet si vous spécifiez un référentiel par ID. Toutefois, si vous spécifiez un référentiel par 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=7.1
Avec des paramètres facultatifs: 
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

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 référentiel.
sha1
 path True

string

Hachage SHA1 du fichier. Vous pouvez obtenir 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 « 7.1 » pour utiliser cette version de l’API.
$format
 query

string

Options : json, zip, text, octetstream. Si ce n’est pas le cas, la valeur par défaut est définie sur le type MIME défini dans l’en-tête Accept.
download
 query

boolean

Si la valeur est true, invitez un téléchargement plutôt qu’un rendu dans un navigateur. Remarque : cette valeur a la valeur 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 en son contenu LFS, s’il s’agit d’un fichier de pointeur LFS. Compatible uniquement avec les en-têtes Accept d’octets ou les types d'$format

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
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom Description
vso.code Accorde la possibilité de lire le code source et les métadonnées sur les validations, 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 averti des événements de contrôle de version via des hooks de service.

Exemples

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "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 à représenter une collection de liens de référence REST.

GitBlobRef

Object
Nom Type Description
_links

ReferenceLinks

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

string

Hachage SHA1 de l’objet Git
size

integer (int64)

Taille du contenu d’objet blob (en octets)
url

string

Object

Classe à 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.