Pushes - Create
Envie alterações por push para o repositório.
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
O nome da organização do Azure DevOps. |
|
repository
|
path | True |
string |
O nome ou a ID do repositório. |
|
project
|
path |
string |
ID do projeto ou nome do projeto |
|
|
api-version
|
query | True |
string |
Versão da API a ser usada. Isso deve ser definido como '7.1' para usar essa versão da api. |
Corpo da solicitação
| Nome | Tipo | Description |
|---|---|---|
| _links |
A classe para representar uma coleção de links de referência REST. |
|
| commits |
Fornece propriedades que descrevem uma confirmação do Git e metadados associados. |
|
| date |
string (date-time) |
|
| pushId |
integer (int32) |
|
| pushedBy | ||
| refUpdates | ||
| repository | ||
| url |
string |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
operação bem-sucedida |
Segurança
oauth2
Tipo:
oauth2
Flow:
accessCode
URL de Autorização:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do Token:
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
Escopos
| Nome | Description |
|---|---|
| vso.code_write | Concede a capacidade de ler, atualizar e excluir código-fonte, acessar metadados sobre confirmações, conjuntos de alterações, branches e outros artefatos de controle de versão. Também concede a capacidade de criar e gerenciar solicitações de pull e revisões de código e receber notificações sobre eventos de controle de versão por meio de ganchos de serviço. |
Exemplos
| Add a binary file |
| Add a text file |
| Delete a file |
| Initial commit (Create a new branch) |
| Move a file |
| Multiple changes |
| Rename a file |
| Update a file |
| Update a file in a new branch |
Add a binary file
Solicitação de exemplo
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1
{
"refUpdates": [
{
"name": "refs/heads/master",
"oldObjectId": "1380164a8118686087e38ce91f36b24b58c2df02"
}
],
"commits": [
{
"comment": "Added new image file.",
"changes": [
{
"changeType": "add",
"item": {
"path": "/images/people/default.jpg"
},
"newContent": {
"content": "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",
"contentType": "base64encoded"
}
}
]
}
]
}
Resposta de exemplo
{
"commits": [
{
"treeId": "8132acc6e22bc93e8ba3d7fd63306017b6730610",
"commitId": "fd1062428e0567cfbfcc28ac59d4bea077ce81c1",
"author": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:50Z"
},
"committer": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:50Z"
},
"comment": "Added new image file.\n",
"parents": [
"1380164a8118686087e38ce91f36b24b58c2df02"
],
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/commits/fd1062428e0567cfbfcc28ac59d4bea077ce81c1"
}
],
"refUpdates": [
{
"repositoryId": "8ee9091d-0f54-4633-9bb2-b5ac74855a46",
"name": "refs/heads/master",
"oldObjectId": "1380164a8118686087e38ce91f36b24b58c2df02",
"newObjectId": "fd1062428e0567cfbfcc28ac59d4bea077ce81c1"
}
],
"pushedBy": {
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
},
"pushId": 85,
"date": "2014-12-16T20:41:50.307555Z",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/85",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/85"
},
"repository": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46"
},
"commits": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/85/commits"
},
"pusher": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
},
"refs": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/refs/refs/heads/master"
}
}
}
Add a text file
Solicitação de exemplo
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1
{
"refUpdates": [
{
"name": "refs/heads/master",
"oldObjectId": "8b67126d2500e28c771f82c9ddc292679978197c"
}
],
"commits": [
{
"comment": "Added task markdown file.",
"changes": [
{
"changeType": "add",
"item": {
"path": "/tasks.md"
},
"newContent": {
"content": "# Tasks\n\n* Item 1\n* Item 2",
"contentType": "rawtext"
}
}
]
}
]
}
Resposta de exemplo
{
"commits": [
{
"treeId": "cf58444311c094fae277a7b30898f0f5b0c3c985",
"commitId": "1380164a8118686087e38ce91f36b24b58c2df02",
"author": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:49Z"
},
"committer": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:49Z"
},
"comment": "Added task markdown file.\n",
"parents": [
"8b67126d2500e28c771f82c9ddc292679978197c"
],
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/commits/1380164a8118686087e38ce91f36b24b58c2df02"
}
],
"refUpdates": [
{
"repositoryId": "8ee9091d-0f54-4633-9bb2-b5ac74855a46",
"name": "refs/heads/master",
"oldObjectId": "8b67126d2500e28c771f82c9ddc292679978197c",
"newObjectId": "1380164a8118686087e38ce91f36b24b58c2df02"
}
],
"pushedBy": {
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
},
"pushId": 84,
"date": "2014-12-16T20:41:49.5419198Z",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/84",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/84"
},
"repository": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46"
},
"commits": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/84/commits"
},
"pusher": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
},
"refs": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/refs/refs/heads/master"
}
}
}
Delete a file
Solicitação de exemplo
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1
{
"refUpdates": [
{
"name": "refs/heads/master",
"oldObjectId": "fef9b2407969c5921a6ef4f7771a919e1a85de19"
}
],
"commits": [
{
"comment": "Removed default image file.",
"changes": [
{
"changeType": "delete",
"item": {
"path": "/images/people/default.jpg"
}
}
]
}
]
}
Resposta de exemplo
{
"commits": [
{
"treeId": "09656595ab4a552c059d1372b589aef7ced5b49a",
"commitId": "7f4fa8e454c196078e1ffca5cd6934515e605c96",
"author": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:51Z"
},
"committer": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:51Z"
},
"comment": "Removed default image file.\n",
"parents": [
"fef9b2407969c5921a6ef4f7771a919e1a85de19"
],
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/commits/7f4fa8e454c196078e1ffca5cd6934515e605c96"
}
],
"refUpdates": [
{
"repositoryId": "8ee9091d-0f54-4633-9bb2-b5ac74855a46",
"name": "refs/heads/master",
"oldObjectId": "fef9b2407969c5921a6ef4f7771a919e1a85de19",
"newObjectId": "7f4fa8e454c196078e1ffca5cd6934515e605c96"
}
],
"pushedBy": {
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
},
"pushId": 87,
"date": "2014-12-16T20:41:51.9325681Z",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/87",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/87"
},
"repository": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46"
},
"commits": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/87/commits"
},
"pusher": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
},
"refs": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/refs/refs/heads/master"
}
}
}
Initial commit (Create a new branch)
Solicitação de exemplo
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1
{
"refUpdates": [
{
"name": "refs/heads/master",
"oldObjectId": "0000000000000000000000000000000000000000"
}
],
"commits": [
{
"comment": "Initial commit.",
"changes": [
{
"changeType": "add",
"item": {
"path": "/readme.md"
},
"newContent": {
"content": "My first file!",
"contentType": "rawtext"
}
}
]
}
]
}
Resposta de exemplo
{
"commits": [
{
"treeId": "404ff66f65520c7a480b343f010b2ce68d7ffbb3",
"commitId": "8b67126d2500e28c771f82c9ddc292679978197c",
"author": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:48Z"
},
"committer": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:48Z"
},
"comment": "Initial commit.\n",
"parents": [],
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/commits/8b67126d2500e28c771f82c9ddc292679978197c"
}
],
"refUpdates": [
{
"repositoryId": "8ee9091d-0f54-4633-9bb2-b5ac74855a46",
"name": "refs/heads/master",
"oldObjectId": "0000000000000000000000000000000000000000",
"newObjectId": "8b67126d2500e28c771f82c9ddc292679978197c"
}
],
"pushedBy": {
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
},
"pushId": 83,
"date": "2014-12-16T20:41:48.9579947Z",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/83",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/83"
},
"repository": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46"
},
"commits": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/83/commits"
},
"pusher": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
},
"refs": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/refs/refs/heads/master"
}
}
}
Move a file
Solicitação de exemplo
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1
{
"refUpdates": [
{
"name": "refs/heads/master",
"oldObjectId": "6e3c1f07d12eaf805a16db1352771816148c24b5"
}
],
"commits": [
{
"comment": "Moving activetasks.md to a new folder.",
"changes": [
{
"changeType": "rename",
"sourceServerItem": "/activetasks.md",
"item": {
"path": "/tasks/content/activetasks.md"
}
}
]
}
]
}
Resposta de exemplo
{
"commits": [
{
"treeId": "5587e0b919b64d9cfd3a57bc0236b5c17ce8e6c8",
"commitId": "b92a68a4cd54506d0d8e264ddddbfe5076dca910",
"author": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:53Z"
},
"committer": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:53Z"
},
"comment": "Moving activetasks.md to a new folder.\n",
"parents": [
"6e3c1f07d12eaf805a16db1352771816148c24b5"
],
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/commits/b92a68a4cd54506d0d8e264ddddbfe5076dca910"
}
],
"refUpdates": [
{
"repositoryId": "8ee9091d-0f54-4633-9bb2-b5ac74855a46",
"name": "refs/heads/master",
"oldObjectId": "6e3c1f07d12eaf805a16db1352771816148c24b5",
"newObjectId": "b92a68a4cd54506d0d8e264ddddbfe5076dca910"
}
],
"pushedBy": {
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
},
"pushId": 89,
"date": "2014-12-16T20:41:53.4638459Z",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/89",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/89"
},
"repository": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46"
},
"commits": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/89/commits"
},
"pusher": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
},
"refs": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/refs/refs/heads/master"
}
}
}
Multiple changes
Solicitação de exemplo
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1
{
"refUpdates": [
{
"name": "refs/heads/master",
"oldObjectId": "b92a68a4cd54506d0d8e264ddddbfe5076dca910"
}
],
"commits": [
{
"comment": "Updating active tasks and adding a few new files.",
"changes": [
{
"changeType": "edit",
"item": {
"path": "/tasks/content/activetasks.md"
},
"newContent": {
"content": "# Tasks\n\n* Item 1\n* Item 2\n* Item 3\n* Item 4\n* Item 5\n* Item 6",
"contentType": "rawtext"
}
},
{
"changeType": "add",
"item": {
"path": "/tasks/content/newtasks.md"
},
"newContent": {
"content": "# New Tasks\n\nTBD",
"contentType": "rawtext"
}
},
{
"changeType": "add",
"item": {
"path": "/tasks/content/inactivetasks.md"
},
"newContent": {
"content": "# Inactive Tasks\n\nTBD",
"contentType": "rawtext"
}
}
]
}
]
}
Resposta de exemplo
{
"commits": [
{
"treeId": "ea40b6cc99f3f155a2c7be135e6aa2c82ae8e779",
"commitId": "2b269bd10e6bd25ec459a0344e8641db395b3219",
"author": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:54Z"
},
"committer": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:54Z"
},
"comment": "Updating active tasks and adding a few new files.\n",
"parents": [
"b92a68a4cd54506d0d8e264ddddbfe5076dca910"
],
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/commits/2b269bd10e6bd25ec459a0344e8641db395b3219"
}
],
"refUpdates": [
{
"repositoryId": "8ee9091d-0f54-4633-9bb2-b5ac74855a46",
"name": "refs/heads/master",
"oldObjectId": "b92a68a4cd54506d0d8e264ddddbfe5076dca910",
"newObjectId": "2b269bd10e6bd25ec459a0344e8641db395b3219"
}
],
"pushedBy": {
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
},
"pushId": 91,
"date": "2014-12-16T20:41:54.7294804Z",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/91",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/91"
},
"repository": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46"
},
"commits": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/91/commits"
},
"pusher": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
},
"refs": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/refs/refs/heads/master"
}
}
}
Rename a file
Solicitação de exemplo
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1
{
"refUpdates": [
{
"name": "refs/heads/master",
"oldObjectId": "7f4fa8e454c196078e1ffca5cd6934515e605c96"
}
],
"commits": [
{
"comment": "Renaming tasks.md to activetasks.md",
"changes": [
{
"changeType": "rename",
"sourceServerItem": "/tasks.md",
"item": {
"path": "/activetasks.md"
}
}
]
}
]
}
Resposta de exemplo
{
"commits": [
{
"treeId": "5e5656e84cd88a8035eaee63c5ab65fba3249d75",
"commitId": "6e3c1f07d12eaf805a16db1352771816148c24b5",
"author": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:52Z"
},
"committer": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:52Z"
},
"comment": "Renaming tasks.md to activetasks.md\n",
"parents": [
"7f4fa8e454c196078e1ffca5cd6934515e605c96"
],
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/commits/6e3c1f07d12eaf805a16db1352771816148c24b5"
}
],
"refUpdates": [
{
"repositoryId": "8ee9091d-0f54-4633-9bb2-b5ac74855a46",
"name": "refs/heads/master",
"oldObjectId": "7f4fa8e454c196078e1ffca5cd6934515e605c96",
"newObjectId": "6e3c1f07d12eaf805a16db1352771816148c24b5"
}
],
"pushedBy": {
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
},
"pushId": 88,
"date": "2014-12-16T20:41:52.6357345Z",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/88",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/88"
},
"repository": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46"
},
"commits": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/88/commits"
},
"pusher": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
},
"refs": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/refs/refs/heads/master"
}
}
}
Update a file
Solicitação de exemplo
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1
{
"refUpdates": [
{
"name": "refs/heads/master",
"oldObjectId": "fd1062428e0567cfbfcc28ac59d4bea077ce81c1"
}
],
"commits": [
{
"comment": "Added a few more items to the task list.",
"changes": [
{
"changeType": "edit",
"item": {
"path": "/tasks.md"
},
"newContent": {
"content": "# Tasks\n\n* Item 1\n* Item 2\n* Item 3\n* Item 4\n\nIf you need to add more, update this file and add them!",
"contentType": "rawtext"
}
}
]
}
]
}
Resposta de exemplo
{
"commits": [
{
"treeId": "bd2aeadd55cbc9794c3fac614ab105d07e20d387",
"commitId": "fef9b2407969c5921a6ef4f7771a919e1a85de19",
"author": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:50Z"
},
"committer": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:50Z"
},
"comment": "Added a few more items to the task list.\n",
"parents": [
"fd1062428e0567cfbfcc28ac59d4bea077ce81c1"
],
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/commits/fef9b2407969c5921a6ef4f7771a919e1a85de19"
}
],
"refUpdates": [
{
"repositoryId": "8ee9091d-0f54-4633-9bb2-b5ac74855a46",
"name": "refs/heads/master",
"oldObjectId": "fd1062428e0567cfbfcc28ac59d4bea077ce81c1",
"newObjectId": "fef9b2407969c5921a6ef4f7771a919e1a85de19"
}
],
"pushedBy": {
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
},
"pushId": 86,
"date": "2014-12-16T20:41:51.1513097Z",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/86",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/86"
},
"repository": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46"
},
"commits": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/86/commits"
},
"pusher": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
},
"refs": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/refs/refs/heads/master"
}
}
}
Update a file in a new branch
Solicitação de exemplo
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1
{
"refUpdates": [
{
"name": "refs/heads/myfirstbranch",
"oldObjectId": "b92a68a4cd54506d0d8e264ddddbfe5076dca910"
}
],
"commits": [
{
"comment": "Updating active tasks, but saving in a new branch.",
"changes": [
{
"changeType": "edit",
"item": {
"path": "/tasks/content/activetasks.md"
},
"newContent": {
"content": "# My Active Tasks\n\n* Item 1\n* Item 2\n* Item 3\n* Item 4\n* Item 5\n",
"contentType": "rawtext"
}
}
]
}
]
}
Resposta de exemplo
{
"commits": [
{
"treeId": "f2c7729b8fce5c5046db163f7bb4ff502d17b53b",
"commitId": "bee67802b97da2a274df88855065b110f232973f",
"author": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:54Z"
},
"committer": {
"name": "Normal Paulk",
"email": "fabrikamfiber16@hotmail.com",
"date": "2014-12-16T20:41:54Z"
},
"comment": "Updating active tasks, but saving in a new branch.\n",
"parents": [
"b92a68a4cd54506d0d8e264ddddbfe5076dca910"
],
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/commits/bee67802b97da2a274df88855065b110f232973f"
}
],
"refUpdates": [
{
"repositoryId": "8ee9091d-0f54-4633-9bb2-b5ac74855a46",
"name": "refs/heads/myfirstbranch",
"oldObjectId": "0000000000000000000000000000000000000000",
"newObjectId": "bee67802b97da2a274df88855065b110f232973f"
}
],
"pushedBy": {
"id": "d6245f20-2af8-44f4-9451-8107cb2767db",
"displayName": "Normal Paulk",
"uniqueName": "fabrikamfiber16@hotmail.com",
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
},
"pushId": 90,
"date": "2014-12-16T20:41:54.0575978Z",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/90",
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/90"
},
"repository": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46"
},
"commits": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/pushes/90/commits"
},
"pusher": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
},
"refs": {
"href": "https://dev.azure.com/fabrikam/_apis/git/repositories/8ee9091d-0f54-4633-9bb2-b5ac74855a46/refs/refs/heads/myfirstbranch"
}
}
}
Definições
| Nome | Description |
|---|---|
|
Change |
|
|
Git |
|
|
Git |
Fornece propriedades que descrevem uma confirmação do Git e metadados associados. |
|
Git |
|
|
Git |
|
|
Git |
|
|
Git |
|
|
Git |
|
|
Git |
Essa classe contém os metadados de um serviço/extensão postando um status. |
|
Git |
Contexto de status que identifica exclusivamente o status. |
|
Git |
Estado do status. |
|
Git |
|
|
Git |
Informações do usuário e data das operações do Git. |
|
Identity |
|
|
Item |
|
|
Item |
|
|
Project |
Estado do projeto. |
|
Project |
Visibilidade do projeto. |
|
Reference |
A classe para representar uma coleção de links de referência REST. |
|
Resource |
|
|
Team |
Objeto de referência para um TeamProjectCollection. |
|
Team |
Representa uma referência superficial a um TeamProject. |
|
Version |
O tipo de alteração feita no item. |
ChangeCountDictionary
GitChange
| Nome | Tipo | Description |
|---|---|---|
| changeId |
integer (int32) |
ID da alteração no grupo de alterações. |
| changeType |
O tipo de alteração feita no item. |
|
| item |
string (T) |
Versão atual. |
| newContent |
Conteúdo do item após a alteração. |
|
| newContentTemplate |
Novo modelo de conteúdo a ser usado ao enviar novas alterações por push. |
|
| originalPath |
string |
Caminho original do item, se diferente do caminho atual. |
| sourceServerItem |
string |
Caminho do item no servidor. |
| url |
string |
URL para recuperar o item. |
GitCommitRef
Fornece propriedades que descrevem uma confirmação do Git e metadados associados.
| Nome | Tipo | Description |
|---|---|---|
| _links |
Uma coleção de links de referência REST relacionados. |
|
| author |
Autor da confirmação. |
|
| changeCounts |
Contagens dos tipos de alterações (edições, exclusões etc.) incluídas na confirmação. |
|
| changes |
Uma enumeração das alterações incluídas na confirmação. |
|
| comment |
string |
Comentário ou mensagem da confirmação. |
| commentTruncated |
boolean |
Indica se o comentário é truncado da mensagem de comentário de confirmação completa do Git. |
| commitId |
string |
ID (SHA-1) da confirmação. |
| commitTooManyChanges |
boolean |
Indica que a confirmação contém muitas alterações a serem exibidas |
| committer |
Committer da confirmação. |
|
| parents |
string[] |
Uma enumeração das IDs de confirmação pai para essa confirmação. |
| push |
O push associado a essa confirmação. |
|
| remoteUrl |
string |
Caminho de URL remoto para a confirmação. |
| statuses |
Uma lista de metadados de status de serviços e extensões que podem associar informações adicionais à confirmação. |
|
| url |
string |
URL REST para esse recurso. |
| workItems |
Uma lista de workitems associados a essa confirmação. |
GitPush
| Nome | Tipo | Description |
|---|---|---|
| _links |
A classe para representar uma coleção de links de referência REST. |
|
| commits |
Fornece propriedades que descrevem uma confirmação do Git e metadados associados. |
|
| date |
string (date-time) |
|
| pushId |
integer (int32) |
|
| pushedBy | ||
| refUpdates | ||
| repository | ||
| url |
string |
GitPushRef
| Nome | Tipo | Description |
|---|---|---|
| _links |
A classe para representar uma coleção de links de referência REST. |
|
| date |
string (date-time) |
|
| pushId |
integer (int32) |
|
| pushedBy | ||
| url |
string |
GitRefUpdate
| Nome | Tipo | Description |
|---|---|---|
| isLocked |
boolean |
|
| name |
string |
|
| newObjectId |
string |
|
| oldObjectId |
string |
|
| repositoryId |
string (uuid) |
GitRepository
| Nome | Tipo | Description |
|---|---|---|
| _links |
A classe para representar uma coleção de links de referência REST. |
|
| defaultBranch |
string |
|
| id |
string (uuid) |
|
| isDisabled |
boolean |
True se o repositório estiver desabilitado. False caso contrário. |
| isFork |
boolean |
True se o repositório foi criado como um fork. |
| isInMaintenance |
boolean |
True se o repositório estiver em manutenção. False caso contrário. |
| name |
string |
|
| parentRepository | ||
| project |
Representa uma referência superficial a um TeamProject. |
|
| remoteUrl |
string |
|
| size |
integer (int64) |
Tamanho compactado (bytes) do repositório. |
| sshUrl |
string |
|
| url |
string |
|
| validRemoteUrls |
string[] |
|
| webUrl |
string |
GitRepositoryRef
| Nome | Tipo | Description |
|---|---|---|
| collection |
Coleção de projetos de equipe em que este Fork reside |
|
| id |
string (uuid) |
|
| isFork |
boolean |
True se o repositório foi criado como um fork |
| name |
string |
|
| project |
Representa uma referência superficial a um TeamProject. |
|
| remoteUrl |
string |
|
| sshUrl |
string |
|
| url |
string |
GitStatus
Essa classe contém os metadados de um serviço/extensão postando um status.
| Nome | Tipo | Description |
|---|---|---|
| _links |
Links de referência. |
|
| context |
Contexto do status. |
|
| createdBy |
Identidade que criou o status. |
|
| creationDate |
string (date-time) |
Data e hora de criação do status. |
| description |
string |
Descrição do status. Normalmente descreve o estado atual do status. |
| id |
integer (int32) |
Identificador de status. |
| state |
Estado do status. |
|
| targetUrl |
string |
URL com detalhes de status. |
| updatedDate |
string (date-time) |
Data e hora da última atualização do status. |
GitStatusContext
Contexto de status que identifica exclusivamente o status.
| Nome | Tipo | Description |
|---|---|---|
| genre |
string |
Gênero do status. Normalmente, o nome do serviço/ferramenta que gera o status pode estar vazio. |
| name |
string |
O identificador de nome do status não pode ser nulo ou vazio. |
GitStatusState
Estado do status.
| Valor | Description |
|---|---|
| error |
Status com um erro. |
| failed |
Falha no status. |
| notApplicable |
O status não é aplicável ao objeto de destino. |
| notSet |
Estado de status não definido. Estado padrão. |
| pending |
Status pendente. |
| succeeded |
Status bem-sucedido. |
GitTemplate
| Nome | Tipo | Description |
|---|---|---|
| name |
string |
Nome do modelo |
| type |
string |
Tipo do modelo |
GitUserDate
Informações do usuário e data das operações do Git.
| Nome | Tipo | Description |
|---|---|---|
| date |
string (date-time) |
Data da operação git. |
|
string |
Endereço de email do usuário que está executando a operação Git. |
|
| imageUrl |
string |
Url para o avatar do usuário. |
| name |
string |
Nome do usuário que está executando a operação Git. |
IdentityRef
| Nome | Tipo | Description |
|---|---|---|
| _links |
Este campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo. |
|
| descriptor |
string |
O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto de grafo em contas e organizações. |
| directoryAlias |
string |
Preterido – pode ser recuperado consultando o usuário do Graph referenciado na entrada "self" do dicionário "_links" identityRef |
| displayName |
string |
Esse é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem. |
| id |
string |
|
| imageUrl |
string |
Preterido – Disponível na entrada "avatar" do dicionário "_links" do IdentityRef |
| inactive |
boolean |
Preterido – pode ser recuperado consultando o estado de associação do Graph referenciado na entrada "membershipState" do dicionário "_links" do GraphUser |
| isAadIdentity |
boolean |
Preterido – pode ser adiado do tipo de assunto do descritor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
| isContainer |
boolean |
Preterido – pode ser inferido do tipo de assunto do descritor (Descriptor.IsGroupType) |
| isDeletedInOrigin |
boolean |
|
| profileUrl |
string |
Preterido - não em uso na maioria das implementações pré-existentes de ToIdentityRef |
| uniqueName |
string |
Preterido – use Domain+PrincipalName em vez disso |
| url |
string |
Essa URL é a rota completa para o recurso de origem desta entidade de grafo. |
ItemContent
| Nome | Tipo | Description |
|---|---|---|
| content |
string |
|
| contentType |
ItemContentType
| Valor | Description |
|---|---|
| base64Encoded | |
| rawText |
ProjectState
Estado do projeto.
| Valor | Description |
|---|---|
| all |
Todos os projetos, independentemente do estado, exceto Excluídos. |
| createPending |
O projeto foi enfileirado para criação, mas o processo ainda não foi iniciado. |
| deleted |
O projeto foi excluído. |
| deleting |
O Project está em processo de exclusão. |
| new |
O Project está em processo de criação. |
| unchanged |
O projeto não foi alterado. |
| wellFormed |
O Project é completamente criado e pronto para uso. |
ProjectVisibility
Visibilidade do projeto.
| Valor | Description |
|---|---|
| private |
O projeto só é visível para usuários com acesso explícito. |
| public |
O projeto é visível para todos. |
ReferenceLinks
A classe para representar uma coleção de links de referência REST.
| Nome | Tipo | Description |
|---|---|---|
| links |
object |
A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura. |
ResourceRef
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
|
| url |
string |
TeamProjectCollectionReference
Objeto de referência para um TeamProjectCollection.
| Nome | Tipo | Description |
|---|---|---|
| avatarUrl |
string |
URL do avatar da coleção. |
| id |
string (uuid) |
ID da coleção. |
| name |
string |
Nome da coleção. |
| url |
string |
URL REST da coleção. |
TeamProjectReference
Representa uma referência superficial a um TeamProject.
| Nome | Tipo | Description |
|---|---|---|
| abbreviation |
string |
Abreviação do projeto. |
| defaultTeamImageUrl |
string |
Url para imagem de identidade de equipe padrão. |
| description |
string |
A descrição do projeto (se houver). |
| id |
string (uuid) |
Identificador de projeto. |
| lastUpdateTime |
string (date-time) |
Hora da última atualização do projeto. |
| name |
string |
Nome do projeto. |
| revision |
integer (int64) |
Revisão do projeto. |
| state |
Estado do projeto. |
|
| url |
string |
Url para a versão completa do objeto. |
| visibility |
Visibilidade do projeto. |
VersionControlChangeType
O tipo de alteração feita no item.
| Valor | Description |
|---|---|
| add | |
| all | |
| branch | |
| delete | |
| edit | |
| encoding | |
| lock | |
| merge | |
| none | |
| property | |
| rename | |
| rollback | |
| sourceRename | |
| targetRename | |
| undelete |