Freigeben über


Blobs - Get Blob

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

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

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.