Blobs - Get Blob

Service:

Git

API Version:

7.1-preview.1

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=7.1-preview.1

With optional parameters:

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

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 « 7.1-preview.1 » 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

HTTP

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

Sample Response

Status code:

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

ReferenceLinks

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.