Freigeben über

Blobs - Get Blob

  • Referenz
Service:
Git
API Version:
5.0

Rufen Sie ein einzelnes Blob ab.

Repositorys haben sowohl einen Namen als auch einen Bezeichner. Bezeichner sind global eindeutig, aber mehrere Projekte können ein Repository mit demselben Namen enthalten. Sie müssen das Projekt nicht einschließen, wenn Sie ein Repository anhand der ID angeben. Wenn Sie jedoch ein Repository anhand des Namens angeben, müssen Sie auch das Projekt (nach Name oder ID) angeben.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/blobs/{sha1}?api-version=5.0
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=5.0

URI-Parameter

Name In Erforderlich Typ Beschreibung
organization
 path True

string

Der Name der Azure DevOps-Organisation.
repositoryId
 path True

string

Der Name oder die ID des Repositorys.
sha1
 path True

string

SHA1-Hash der Datei. Sie können den SHA1 einer Datei mithilfe des Endpunkts "Git/Items/Get Item" abrufen.
project
 path

string

Projekt-ID oder Projektname
api-version
 query True

string

Version der zu verwendenden API. Dies sollte auf "5.0" festgelegt werden, um diese Version der API zu verwenden.
$format
 query

string

Optionen: json, zip, text, octetstream. Wenn nicht festgelegt, wird standardmäßig der MIME-Typ verwendet, der im Accept-Header festgelegt ist.
download
 query

boolean

Wenn true, fordern Sie zu einem Download statt zum Rendern in einem Browser auf. Hinweis: Dieser Wert ist standardmäßig true, wenn $format zip ist.
fileName
 query

string

Geben Sie einen FileName an, der für einen Download verwendet werden soll.
resolveLfs
 query

boolean

Wenn true, versuchen Sie, ein Blob in seinen LFS Inhalt aufzulösen, wenn es sich um eine LFS-Zeigerdatei handelt. Nur kompatibel mit Octet-Stream Accept-Headern oder $format-Typen

Antworten

Name Typ Beschreibung
200 OK

GitBlobRef

Erfolgreicher Vorgang

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

Sicherheit

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

Name Beschreibung
vso.code Ermöglicht das Lesen von Quellcode und Metadaten zu Commits, Changesets, Branches und anderen Versionskontrollartefakten. Bietet außerdem die Möglichkeit, Code zu suchen und über Versionskontrollereignisse über Diensthooks benachrichtigt zu werden.

Beispiele

Sample Request

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

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

Definitionen

Name Beschreibung
GitBlobRef
ReferenceLinks

Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.

GitBlobRef

Name Typ Beschreibung
_links

ReferenceLinks

Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.
objectId

string

SHA1-Hash des Git-Objekts
size

integer

Größe des Blobinhalts (in Bytes)
url

string

Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name Typ Beschreibung
links

object

Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützter Sind, möchten wir sie nur als schreibgeschützter Link verfügbar machen.