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 组织的名称。 |
repository
|
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 |
|
file
|
query |
string |
提供用于下载的 fileName。 |
|
resolve
|
query |
boolean |
如果为 true,请尝试将 blob 解析为其LFS内容(如果它是LFS指针文件)。 仅与八进制流 Accept 标头或$format类型兼容 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
成功的操作 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"
}
}
}
定义
名称 | 说明 |
---|---|
Git |
|
Reference |
表示 REST 引用链接集合的类。 |
GitBlobRef
名称 | 类型 | 说明 |
---|---|---|
_links |
表示 REST 引用链接集合的类。 |
|
objectId |
string |
git 对象的 SHA1 哈希 |
size |
integer |
blob 内容 (的大小(以字节) 为单位) |
url |
string |
ReferenceLinks
表示 REST 引用链接集合的类。
名称 | 类型 | 说明 |
---|---|---|
links |
object |
链接的只读视图。 由于引用链接是只读的,因此我们只想将其公开为只读。 |