共用方式為

Blobs - Get Blob

  • 參考
服務:
Git
API 版本:
7.1

取得單一 Blob。

存放庫同時具有名稱和標識碼。 標識碼是全域唯一的，但數個專案可能包含相同名稱的存放庫。 如果您依標識子指定存放庫，則不需要包含專案。 不過，如果您依名稱指定存放庫，您也必須指定專案（依名稱或標識符）。

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

URI 參數

名稱 位於 必要 類型 Description
organization
 path True

string

Azure DevOps 組織的名稱。
repositoryId
 path True

string

存放庫的名稱或標識碼。
sha1
 path True

string

檔案的SHA1哈希。 您可以使用 「Git/Items/Get Item」 端點取得檔案的 SHA1。
project
 path

string

項目識別碼或項目名稱
api-version
 query True

string

要使用的 API 版本。 這應該設定為 『7.1』 以使用此版本的 API。
$format
 query

string

選項：json、zip、text、octetstream。 如果未設定，預設為 Accept 標頭中設定的 MIME 類型。
download
 query

boolean

如果為 true，請提示下載，而不是在瀏覽器中轉譯。 注意：如果$format為 zip，則此值預設為 true
fileName
 query

string

提供要用於下載的 fileName。
resolveLfs
 query

boolean

如果為 true，請嘗試將 Blob 解析為其 LFS 內容，如果是 LFS 指標檔案。 只與八位數據流接受標頭或$format類型相容

回應

名稱 類型 Description
200 OK

GitBlobRef

成功作業

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

安全性

oauth2

類型: oauth2
Flow: accessCode
授權 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
權杖 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

範圍

名稱 Description
vso.code 授與讀取有關認可、變更集、分支和其他版本控制成品之原始程式碼和元數據的能力。 也授與搜尋程式代碼的能力，並透過服務攔截取得版本控制事件的通知。

範例

範例要求

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

範例回覆

狀態碼:
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"
    }
  }
}

定義

名稱 Description
GitBlobRef
ReferenceLinks

表示 REST 參考連結集合的類別。

GitBlobRef

Object
名稱 類型 Description
_links

ReferenceLinks

表示 REST 參考連結集合的類別。
objectId

string

git 物件的 SHA1 哈希
size

integer (int64)

Blob 內容的大小（以位元組為單位）
url

string

Object

表示 REST 參考連結集合的類別。

名稱 類型 Description
links

object

連結的只讀檢視。 因為參考連結是只讀的，所以我們只想要將其公開為只讀。