Condividi tramite

Blobs - Get Blob

  • Riferimento
Service:
Git
API Version:
7.1-preview.1

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

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 del progetto
api-version
 query True

string

Versione dell'API da usare. Deve essere impostato su '7.1-preview.1' per usare questa versione dell'API.
$format
 query

string

Opzioni: json, zip, text, octetstream. Se non impostato, per impostazione predefinita viene impostato il tipo MIME nell'intestazione Accept.
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 accept o i tipi di $format octet-stream

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 il codice sorgente e i metadati relativi a commit, insiemi di modifiche, rami e altri artefatti del controllo della versione. Concede inoltre la possibilità di cercare il codice e ricevere notifiche sugli eventi di controllo della versione tramite hook del servizio.

Esempio

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

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 per rappresentare una raccolta di collegamenti di riferimento REST.

GitBlobRef

Nome Tipo Descrizione
_links

ReferenceLinks

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

string

Hash SHA1 dell'oggetto Git
size

integer

Dimensioni del contenuto del BLOB (in byte)
url

string

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.