如何使用 Azure DevOps REST API 更新文件？

Question

我正在尝试更新 Azure DevOps Repo 上托管的 test.json 文件。我正在使用逻辑应用程序。无法从文档中识别操作顺序。

我认为我需要...

1. 向 Items 端点：

   • https://dev.azure.com/myOrg/myProject/_apis/git/repositories/myRepoID/items?scopePath=/data/test.json&$format=json&api-version=6.0< /代码>
   • 回复：

   <代码>{
     “计数”：1，
     “价值”： [
       {
         "objectId": "",
         “gitObjectType”：“blob”，
         "commitId": "",
         “路径”：“/data/test.json”，
         “url”：“https://dev.azure.com/myOrg/longGUID/_apis/git/repositories/myRepoID/items?path=%2Fdata%2Ftest.json&versionType=Branch&versionOptions=None”
       }
     ]
   }
   

2. 使用响应中的objectId向推送端点

   • 正文：

{
  "refUpdates": [
    {
      "name": "refs/heads/main",
      "oldObjectId": "<longGuid from previous response>"
    }
  ],
  "commits": [
    {
      "changes": [
        {
          "changeType": "edit",
          "item": {
            "path": "/data/test.json"
          },
          "newContent": {
            "content": "CHECK CHECK!",
            "contentType": "rawtext"
          }
        }
      ],
      "comment": "My commit message"
    }
  ]
}

错误：

• 状态 409 冲突

{
  "$id": "1",
  "innerException": null,
  "message": "TF401028: The reference 'refs/heads/main' has already been updated by another client, so you cannot update it. Please try again.",
  "typeName": "Microsoft.TeamFoundation.Git.Server.GitReferenceStaleException, Microsoft.TeamFoundation.Git.Server",
  "typeKey": "GitReferenceStaleException",
  "errorCode": 0,
  "eventId": 3000
}

问题：

1. 我的操作顺序正确吗？
2. 我该如何克服这个问题？

修复：（谢谢@Leo_Liu-MSFT）

1. 向 https://dev.azure.com/myOrg/myProject/_apis/git/repositories/repoID/commits 发出请求？ searchCriteria.$top=1&searchCriteria.itemVersion.version=main&api-version=6.0

2. POST 请求至https://dev.azure.com/myOrg/myProject/_apis/git/repositories/repoID/pushes

• 正文：

{
  "commits": [
    {
      "changes": [
        {
          "changeType": "edit",
          "item": {
            "path": "<Your File To Update>"
          },
          "newContent": {
            "content": "CHECK CHECK!",
            "contentType": "rawtext"
          }
        }
      ],
      "comment": "<YOUR COMMIT MSG>"
    }
  ],
  "refUpdates": [
    {
      "name": "refs/heads/main",
      "oldObjectId": "<commitId from previous response>"
    }
  ]
}

Answer 1

如何使用 Azure DevOps REST API 更新文件？

请求正文中的 oldObjectId 不是 objectId 的值。

它应该是分支main的最新提交 SHA。

• 转到代码页>文件
• 选择存储库和分支
• 选择根级别（存储库名称）> 历史记录
• 第一次提交的 点击…>复制完整 SHA

并且在用于创建新分支时，该值应为 create a newbranch 0000000000000000000000000000000000000000。