Blobs - Get Blob

获取单个 Blob。

存储库具有名称和标识符。 标识符是全局唯一的,但多个项目可能包含同名的存储库。 如果按 ID 指定存储库,则无需包含项目。 但是,如果按名称指定存储库,则还必须按名称或 ID) 指定项目 (。

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

URI 参数

名称 必需 类型 说明
organization
path True

string

Azure DevOps 组织的名称。

repositoryId
path True

string

存储库的名称或 ID。

sha1
path True

string

文件的 SHA1 哈希。 可以使用“Git/Items/Get Item”终结点获取文件的 SHA1。

project
path

string

项目 ID 或项目名称

api-version
query True

string

要使用的 API 版本。 应将其设置为“5.0”才能使用此版本的 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指针文件)。 仅与八进制流 Accept 标头或$format类型兼容

响应

名称 类型 说明
200 OK

GitBlobRef

成功的操作

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

安全性

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

名称 说明
vso.code 授予读取有关提交、更改集、分支和其他版本控制项目的源代码和元数据的能力。 此外,还授予搜索代码的功能,并通过服务挂钩获取有关版本控制事件的通知。

示例

Sample Request

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

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

定义

名称 说明
GitBlobRef
ReferenceLinks

表示 REST 引用链接集合的类。

GitBlobRef

名称 类型 说明
_links

ReferenceLinks

表示 REST 引用链接集合的类。

objectId

string

git 对象的 SHA1 哈希

size

integer

blob 内容 (的大小(以字节) 为单位)

url

string

表示 REST 引用链接集合的类。

名称 类型 说明
links

object

链接的只读视图。 由于引用链接是只读的,因此我们只想将其公开为只读。