Udostępnij za pośrednictwem

Blobs - Get Blob

  • Odwołanie
Service:
Git
API Version:
5.0

Pobieranie pojedynczego obiektu blob.

Repozytoria mają zarówno nazwę, jak i identyfikator. Identyfikatory są globalnie unikatowe, ale kilka projektów może zawierać repozytorium o tej samej nazwie. Nie musisz uwzględniać projektu, jeśli określisz repozytorium według identyfikatora. Jeśli jednak określisz repozytorium według nazwy, musisz również określić projekt (według nazwy lub identyfikatora).

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
 path True

string

Nazwa organizacji usługi Azure DevOps.
repositoryId
 path True

string

Nazwa lub identyfikator repozytorium.
sha1
 path True

string

Skrót SHA1 pliku. Sha1 pliku można uzyskać przy użyciu punktu końcowego "Git/Items/Get Item".
project
 path

string

Identyfikator projektu lub nazwa projektu
api-version
 query True

string

Wersja interfejsu API do użycia. Należy ustawić wartość "5.0", aby używać tej wersji interfejsu API.
$format
 query

string

Opcje: json, zip, text, octetstream. Jeśli nie zostanie ustawiona, zostanie ustawiona wartość domyślna typu MIME w nagłówku Accept.
download
 query

boolean

Jeśli wartość true, wyświetl monit o pobranie, a nie renderowanie w przeglądarce. Uwaga: ta wartość domyślna to true, jeśli $format jest zip
fileName
 query

string

Podaj wartość fileName do pobrania.
resolveLfs
 query

boolean

Jeśli wartość true, spróbuj rozpoznać obiekt blob w jego zawartości LFS, jeśli jest to plik wskaźnika LFS. Tylko zgodne z oktet-stream Akceptuj nagłówki lub typy $format

Odpowiedzi

Nazwa Typ Opis
200 OK

GitBlobRef

operacja zakończona powodzeniem

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

Zabezpieczenia

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

Nazwa Opis
vso.code Umożliwia odczytywanie kodu źródłowego i metadanych dotyczących zatwierdzeń, zestawów zmian, gałęzi i innych artefaktów kontroli wersji. Umożliwia również wyszukiwanie kodu i otrzymywanie powiadomień o zdarzeniach kontroli wersji za pośrednictwem punktów zaczepienia usługi.

Przykłady

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

Definicje

Nazwa Opis
GitBlobRef
ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.

GitBlobRef

Nazwa Typ Opis
_links

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.
objectId

string

Skrót SHA1 obiektu git
size

integer

Rozmiar zawartości obiektu blob (w bajtach)
url

string

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa Typ Opis
links

object

Widok linków w trybie tylko do odczytu. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.