Condividi tramite

Blobs - Get Blob

  • Riferimento
Service:
Git
API Version:
5.0

Ottenere un singolo BLOB.

I repository hanno sia un nome che un identificatore. Gli identificatori sono univoci a livello globale, ma diversi progetti possono contenere un repository dello stesso nome. Non è necessario includere il progetto se si specifica un repository in base all'ID. Tuttavia, se si specifica un repository in base al nome, è necessario specificare anche il progetto (in base al nome o all'ID).

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
 path True

string

Nome dell'organizzazione di Azure DevOps.
repositoryId
 path True

string

Nome o ID del repository.
sha1
 path True

string

HASH SHA1 del file. È possibile ottenere SHA1 di un file usando l'endpoint "Git/Items/Get Item".
project
 path

string

ID progetto o nome progetto
api-version
 query True

string

Versione dell'API da usare. Questa opzione deve essere impostata su '5.0' per usare questa versione dell'API.
$format
 query

string

Opzioni: json, zip, text, octetstream. Se non è impostato, il valore predefinito viene impostato sul tipo MIME impostato nell'intestazione Accetta.
download
 query

boolean

Se true, richiedere un download anziché eseguire il rendering in un browser. Nota: il valore predefinito è true se $format è zip
fileName
 query

string

Specificare un fileName da usare per un download.
resolveLfs
 query

boolean

Se true, provare a risolvere un BLOB nel relativo contenuto LFS, se si tratta di un file di puntatore LFS. Compatibile solo con le intestazioni Di accettazione di ottet-stream o i tipi di $format

Risposte

Nome Tipo Descrizione
200 OK

GitBlobRef

operazione riuscita

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

Sicurezza

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

Nome Descrizione
vso.code Concede la possibilità di leggere codice sorgente e metadati relativi a commit, set di modifiche, rami e altri artefatti di controllo della versione. Concede inoltre la possibilità di cercare codice e ricevere notifiche sugli eventi di controllo della versione tramite gli hook del servizio.

Esempio

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

Definizioni

Nome Descrizione
GitBlobRef
ReferenceLinks

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

GitBlobRef

Nome Tipo Descrizione
_links

ReferenceLinks

Classe da rappresentare una raccolta di collegamenti di riferimento REST.
objectId

string

Hash SHA1 dell'oggetto Git
size

integer

Dimensioni del contenuto BLOB (in byte)
url

string

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di lettura dei collegamenti. Poiché i collegamenti di riferimento sono in sola lettura, si vuole esporre solo i collegamenti di riferimento come sola lettura.