Pushes - Create
Nasdílení změn do úložiště
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2Parametry identifikátoru URI
| Name | V | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Název organizace Azure DevOps. |
|
repository
|
path | True |
string |
Název nebo ID úložiště. |
|
project
|
path |
string |
ID projektu nebo název projektu |
|
|
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít. Tato verze rozhraní API by měla být nastavená na 7.1-preview.2. |
Text požadavku
| Name | Typ | Description |
|---|---|---|
| _links |
Třída představující kolekci odkazů REST. |
|
| commits |
Poskytuje vlastnosti, které popisují potvrzení Gitu a přidružená metadata. |
|
| date |
string |
|
| pushId |
integer |
|
| pushedBy | ||
| refUpdates | ||
| repository | ||
| url |
string |
Odpovědi
| Name | Typ | Description |
|---|---|---|
| 200 OK |
úspěšná operace |
Zabezpečení
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
| Name | Description |
|---|---|
| vso.code_write | Umožňuje číst, aktualizovat a odstraňovat zdrojový kód a přistupovat k metadatům o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Poskytuje také možnost vytvářet a spravovat žádosti o přijetí změn a revize kódu a přijímat oznámení o událostech správy verzí prostřednictvím volání služeb. |
Příklady
| 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
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2
{
"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"
}
}
]
}
]
}
Sample Response
{
"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
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2
{
"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"
}
}
]
}
]
}
Sample Response
{
"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
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2
{
"refUpdates": [
{
"name": "refs/heads/master",
"oldObjectId": "fef9b2407969c5921a6ef4f7771a919e1a85de19"
}
],
"commits": [
{
"comment": "Removed default image file.",
"changes": [
{
"changeType": "delete",
"item": {
"path": "/images/people/default.jpg"
}
}
]
}
]
}
Sample Response
{
"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)
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2
{
"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"
}
}
]
}
]
}
Sample Response
{
"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
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2
{
"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"
}
}
]
}
]
}
Sample Response
{
"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
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2
{
"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"
}
}
]
}
]
}
Sample Response
{
"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
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2
{
"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"
}
}
]
}
]
}
Sample Response
{
"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
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2
{
"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"
}
}
]
}
]
}
Sample Response
{
"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
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2
{
"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"
}
}
]
}
]
}
Sample Response
{
"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"
}
}
}Definice
| Name | Description |
|---|---|
|
Change |
|
|
Git |
|
|
Git |
Poskytuje vlastnosti, které popisují potvrzení Gitu a přidružená metadata. |
|
Git |
|
|
Git |
|
|
Git |
|
|
Git |
|
|
Git |
|
|
Git |
Tato třída obsahuje metadata služby nebo rozšíření, které zveřejňuje stav. |
|
Git |
Kontext stavu, který jednoznačně identifikuje stav. |
|
Git |
Stav stavu. |
|
Git |
|
|
Git |
Informace o uživateli a datum operací Gitu |
|
Identity |
|
|
Item |
|
|
Item |
|
|
Project |
Stav projektu. |
|
Project |
Viditelnost projektu. |
|
Reference |
Třída představující kolekci odkazů REST. |
|
Resource |
|
|
Team |
Referenční objekt pro TeamProjectCollection. |
|
Team |
Představuje mělký odkaz na TeamProject. |
|
Version |
Typ změny provedené u položky |
ChangeCountDictionary
GitChange
| Name | Typ | Description |
|---|---|---|
| changeId |
integer |
ID změny v rámci skupiny změn. |
| changeType |
Typ změny provedené u položky |
|
| item |
string |
Aktuální verze. |
| newContent |
Obsah položky po změně. |
|
| newContentTemplate |
Nová šablona obsahu, která se má použít při nabízení nových změn. |
|
| originalPath |
string |
Původní cesta k položce, pokud se liší od aktuální cesty. |
| sourceServerItem |
string |
Cesta k položce na serveru. |
| url |
string |
Adresa URL pro načtení položky |
GitCommitRef
Poskytuje vlastnosti, které popisují potvrzení Gitu a přidružená metadata.
| Name | Typ | Description |
|---|---|---|
| _links |
Kolekce souvisejících odkazů REST. |
|
| author |
Autor potvrzení |
|
| changeCounts |
Počty typů změn (úpravy, odstranění atd.), které jsou součástí potvrzení. |
|
| changes |
Výčet změn zahrnutých s potvrzením. |
|
| comment |
string |
Komentář nebo zpráva potvrzení. |
| commentTruncated |
boolean |
Označuje, jestli je komentář zkrácený od úplné zprávy komentáře k potvrzení Gitu. |
| commitId |
string |
ID (SHA-1) potvrzení. |
| commitTooManyChanges |
boolean |
Označuje, že potvrzení obsahuje příliš mnoho změn, které se dají zobrazit. |
| committer |
Committer potvrzení. |
|
| parents |
string[] |
Výčet ID nadřazeného potvrzení pro toto potvrzení. |
| push |
Nasdílení změn přidružené k tomuto potvrzení |
|
| remoteUrl |
string |
Cesta vzdálené adresy URL k potvrzení. |
| statuses |
Seznam metadat stavu ze služeb a rozšíření, která můžou k potvrzení přidružit další informace. |
|
| url |
string |
Adresa URL REST pro tento prostředek. |
| workItems |
Seznam pracovních položek přidružených k tomuto potvrzení. |
GitPush
| Name | Typ | Description |
|---|---|---|
| _links |
Třída představující kolekci odkazů REST. |
|
| commits |
Poskytuje vlastnosti, které popisují potvrzení Gitu a přidružená metadata. |
|
| date |
string |
|
| pushId |
integer |
|
| pushedBy | ||
| refUpdates | ||
| repository | ||
| url |
string |
GitPushRef
| Name | Typ | Description |
|---|---|---|
| _links |
Třída představující kolekci odkazů REST. |
|
| date |
string |
|
| pushId |
integer |
|
| pushedBy | ||
| url |
string |
GitRefUpdate
| Name | Typ | Description |
|---|---|---|
| isLocked |
boolean |
|
| name |
string |
|
| newObjectId |
string |
|
| oldObjectId |
string |
|
| repositoryId |
string |
GitRepository
| Name | Typ | Description |
|---|---|---|
| _links |
Třída představující kolekci odkazů REST. |
|
| defaultBranch |
string |
|
| id |
string |
|
| isDisabled |
boolean |
True, pokud je úložiště zakázané. V ostatních případech False |
| isFork |
boolean |
Hodnota True, pokud se úložiště vytvořilo jako fork. |
| isInMaintenance |
boolean |
Hodnota True, pokud je úložiště v režimu údržby. V ostatních případech False |
| name |
string |
|
| parentRepository | ||
| project |
Představuje mělký odkaz na TeamProject. |
|
| remoteUrl |
string |
|
| size |
integer |
Komprimovaná velikost (bajty) úložiště. |
| sshUrl |
string |
|
| url |
string |
|
| validRemoteUrls |
string[] |
|
| webUrl |
string |
GitRepositoryRef
| Name | Typ | Description |
|---|---|---|
| collection |
Kolekce týmových projektů, kde se nachází tento fork |
|
| id |
string |
|
| isFork |
boolean |
Hodnota True, pokud se úložiště vytvořilo jako fork |
| name |
string |
|
| project |
Představuje mělký odkaz na TeamProject. |
|
| remoteUrl |
string |
|
| sshUrl |
string |
|
| url |
string |
GitStatus
Tato třída obsahuje metadata služby nebo rozšíření, které zveřejňuje stav.
| Name | Typ | Description |
|---|---|---|
| _links |
Odkazy. |
|
| context |
Kontext stavu |
|
| createdBy |
Identita, která vytvořila stav. |
|
| creationDate |
string |
Datum a čas vytvoření stavu. |
| description |
string |
Popis stavu. Obvykle popisuje aktuální stav stavu. |
| id |
integer |
Identifikátor stavu. |
| state |
Stav stavu. |
|
| targetUrl |
string |
Adresa URL s podrobnostmi o stavu |
| updatedDate |
string |
Datum a čas poslední aktualizace stavu. |
GitStatusContext
Kontext stavu, který jednoznačně identifikuje stav.
| Name | Typ | Description |
|---|---|---|
| genre |
string |
Žánr stavu. Název služby nebo nástroje, který generuje stav, může být obvykle prázdný. |
| name |
string |
Identifikátor názvu stavu nesmí být null ani prázdný. |
GitStatusState
Stav stavu.
| Name | Typ | Description |
|---|---|---|
| error |
string |
Stav s chybou |
| failed |
string |
Stav se nezdařil. |
| notApplicable |
string |
Stav se nevztahuje na cílový objekt. |
| notSet |
string |
Stav není nastavený. Výchozí stav. |
| pending |
string |
Stav čeká na vyřízení. |
| succeeded |
string |
Stav byl úspěšný. |
GitTemplate
| Name | Typ | Description |
|---|---|---|
| name |
string |
Název šablony |
| type |
string |
Typ šablony |
GitUserDate
Informace o uživateli a datum operací Gitu
| Name | Typ | Description |
|---|---|---|
| date |
string |
Datum operace Git. |
|
string |
Email adresu uživatele, který provádí operaci Gitu. |
|
| imageUrl |
string |
Adresa URL avatara uživatele |
| name |
string |
Jméno uživatele, který provádí operaci Git. |
IdentityRef
| Name | Typ | Description |
|---|---|---|
| _links |
Toto pole neobsahuje žádný nebo více zajímavých odkazů na téma grafu. Tyto odkazy mohou být vyvolány za účelem získání dalších relací nebo podrobnějších informací o tomto předmětu grafu. |
|
| descriptor |
string |
Popisovač je primárním způsobem, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejný předmět grafu v rámci účtů i organizací. |
| directoryAlias |
string |
Zastaralé – dá se načíst dotazem na uživatele Graphu odkazovaného v položce "self" slovníku IdentityRef "_links". |
| displayName |
string |
Toto je jedinečný zobrazovaný název předmětu grafu. Chcete-li toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém poskytovateli. |
| id |
string |
|
| imageUrl |
string |
Zastaralé – k dispozici v položce "avatar" ve slovníku IdentityRef "_links" |
| inactive |
boolean |
Zastaralé – Můžete ho načíst dotazem na stav členství v Graphu, na který odkazuje položka membershipState slovníku _links GraphUser. |
| isAadIdentity |
boolean |
Zastaralé – lze odvodit z typu předmětu popisovače (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
| isContainer |
boolean |
Zastaralé – lze odvodit z typu předmětu popisovače (Descriptor.IsGroupType) |
| isDeletedInOrigin |
boolean |
|
| profileUrl |
string |
Zastaralé – nepoužívá se ve většině dříve existujících implementací ToIdentityRef |
| uniqueName |
string |
Zastaralé – místo toho použijte Domain+PrincipalName. |
| url |
string |
Tato adresa URL představuje úplnou trasu ke zdrojovému prostředku tohoto předmětu grafu. |
ItemContent
| Name | Typ | Description |
|---|---|---|
| content |
string |
|
| contentType |
ItemContentType
| Name | Typ | Description |
|---|---|---|
| base64Encoded |
string |
|
| rawText |
string |
ProjectState
Stav projektu.
| Name | Typ | Description |
|---|---|---|
| all |
string |
Všechny projekty bez ohledu na stav s výjimkou Odstraněno. |
| createPending |
string |
Projekt byl zařazen do fronty k vytvoření, ale tento proces ještě nebyl zahájen. |
| deleted |
string |
Projekt byl odstraněn. |
| deleting |
string |
Projekt se právě odstraňuje. |
| new |
string |
Projekt se právě vytváří. |
| unchanged |
string |
Projekt nebyl změněn. |
| wellFormed |
string |
Projekt je zcela vytvořený a připravený k použití. |
ProjectVisibility
Viditelnost projektu.
| Name | Typ | Description |
|---|---|---|
| private |
string |
Projekt je viditelný pouze uživatelům s explicitním přístupem. |
| public |
string |
Projekt je viditelný pro všechny. |
ReferenceLinks
Třída představující kolekci odkazů REST.
| Name | Typ | Description |
|---|---|---|
| links |
object |
Zobrazení odkazů jen pro čtení. Odkazy jsou jen pro čtení, a proto je chceme zveřejnit jen jako odkazy jen pro čtení. |
ResourceRef
| Name | Typ | Description |
|---|---|---|
| id |
string |
|
| url |
string |
TeamProjectCollectionReference
Referenční objekt pro TeamProjectCollection.
| Name | Typ | Description |
|---|---|---|
| avatarUrl |
string |
Adresa URL avatara kolekce. |
| id |
string |
ID kolekce. |
| name |
string |
Název kolekce. |
| url |
string |
Adresa URL REST kolekce. |
TeamProjectReference
Představuje mělký odkaz na TeamProject.
| Name | Typ | Description |
|---|---|---|
| abbreviation |
string |
Zkratka projektu |
| defaultTeamImageUrl |
string |
Adresa URL výchozího obrázku týmové identity |
| description |
string |
Popis projektu (pokud existuje) |
| id |
string |
Identifikátor projektu. |
| lastUpdateTime |
string |
Čas poslední aktualizace projektu. |
| name |
string |
Název projektu. |
| revision |
integer |
Revize projektu. |
| state |
Stav projektu. |
|
| url |
string |
Adresa URL na plnou verzi objektu. |
| visibility |
Viditelnost projektu. |
VersionControlChangeType
Typ změny provedené u položky
| Name | Typ | Description |
|---|---|---|
| add |
string |
|
| all |
string |
|
| branch |
string |
|
| delete |
string |
|
| edit |
string |
|
| encoding |
string |
|
| lock |
string |
|
| merge |
string |
|
| none |
string |
|
| property |
string |
|
| rename |
string |
|
| rollback |
string |
|
| sourceRename |
string |
|
| targetRename |
string |
|
| undelete |
string |
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro