Pushes - Create
Отправка изменений в репозиторий.
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pushes?api-version=7.1-preview.2Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Название организации Azure DevOps. |
|
repository
|
path | True |
string |
Имя или идентификатор репозитория. |
|
project
|
path |
string |
Идентификатор или имя проекта |
|
|
api-version
|
query | True |
string |
Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.2. |
Текст запроса
| Имя | Тип | Описание |
|---|---|---|
| _links |
Класс, представляющий коллекцию ссылок REST. |
|
| commits |
Предоставляет свойства, описывающие фиксацию Git и связанные метаданные. |
|
| date |
string |
|
| pushId |
integer |
|
| pushedBy | ||
| refUpdates | ||
| repository | ||
| url |
string |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
успешная операция |
Безопасность
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_write | Предоставляет возможность чтения, обновления и удаления исходного кода, доступа к метаданным о фиксациях, наборах изменений, ветвях и других артефактах управления версиями. Кроме того, предоставляет возможность создавать запросы на вытягивание и проверки кода и управлять ими, а также получать уведомления о событиях управления версиями с помощью перехватчиков служб. |
Примеры
| 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": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAUDBAQEAwUEBAQFBQUGBwwIBwcHBw8KCwkMEQ8SEhEPERATFhwXExQaFRARGCEYGhwdHx8fExciJCIeJBweHx7/2wBDAQUFBQcGBw4ICA4eFBEUHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh7/wAARCABkAGQDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/8QAtRAAAgEDAwIEAwUFBAQAAAF9AQIDAAQRBRIhMUEGE1FhByJxFDKBkaEII0KxwRVS0fAkM2JyggkKFhcYGRolJicoKSo0NTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqDhIWGh4iJipKTlJWWl5iZmqKjpKWmp6ipqrKztLW2t7i5usLDxMXGx8jJytLT1NXW19jZ2uHi4+Tl5ufo6erx8vP09fb3+Pn6/8QAHwEAAwEBAQEBAQEBAQAAAAAAAAECAwQFBgcICQoL/8QAtREAAgECBAQDBAcFBAQAAQJ3AAECAxEEBSExBhJBUQdhcRMiMoEIFEKRobHBCSMzUvAVYnLRChYkNOEl8RcYGRomJygpKjU2Nzg5OkNERUZHSElKU1RVVldYWVpjZGVmZ2hpanN0dXZ3eHl6goOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4uPk5ebn6Onq8vP09fb3+Pn6/9oADAMBAAIRAxEAPwDyc4ODkVl6/qkWmWxlcby3CqO9LJqGVO2RFX61wms3cmpag7B9yIcKK4KdK71OypUSVkUNVv7jUbpppjjPbsBVeOPI6YratdKkuyNi5Y+1dZo3giSeDMpUNXS6kYIyp0J1fhPPI4WPSpo7R3PAyfSvadM+HNkyZdzvxx7Gt/Sfh7otq4klRpmHXI4rnnjILY66eW1XueH6T4avrqRcQSMD6LXVL4avLaIKtuVOMdOTXtkdhbwRiO2gRFUYAArM1OyUocnkdwK5njW3c7oZWranh2o2c8DGKaHGefmHWs+S1KLmLIU9UzxXqviCyja1fzYg2Bwcc15vdkJMyAbRnFddGtznnYnDuiyhbR4b7u32qjGD9tPHp/OtWbbEpfoO5NZUIP2ksQWUAHj61sjmexclTcsZwfu/1NFPuItvlhCcbB/WipLWxd123is9PaUwFZJThfmrN0i1yqsR8zHHArZ8YJv1SOHnYijiq9nLFA6FuMGiD924nH3tTttA06O3hj+XMhGScV2+kWq7VO0DNct4XuEvEVl7V2FnJt2gCvLxEm20fQYKEeW6R0WnWqGPJIAq+tumMAZHfNZdrcPs+UH6VpQtPMoAVgDx0rl1O61ivcssZIUDpWPeyOWyFzXSHTJCC8vA96ydVuNOsuJZYw4OACapQuNtJXOX1ZFmgII6j0rx/wAXW72eoMCpC5yDXrGpa1YyllQMRnG4DiuO8WWsWp2zsvLqMiuzDvkep5WNgqi0OCnndrRnx8w6d6uWerXiRRBHtmZiAc20bHH1IrMlDwxvEc8AgVDpBYzYPYr/ADr0bOx4V7Ox1H/CQ6nFGgzZtlc82cX/AMTRWTOfli/65j+ZorK3mbJG/wCLIP8ASEuxgIwxmuSupSZ85+UV6DrNqZrV4nGQRlfavPLuIxyvGwwynFOjK8RVotM9B+HszJZbycD+deiWN3bQoHnkVRjPJrzPw+5h0WJoV3MBjj1rpdP0+N4xfaw7eV2jz19sVxVoKUtT1sPVlCmrHeaV4g055/LTc5H93kV2FhqtvIgVFUHsK8z0XWo21iHSLLTIdOTfteWZcsBjO49sH65rTvr97eITCQeYH2jaMbvesJwtsdVKs5bnZ63duIG3MQK4fXEsY7Oe/uNLlvVt1DSEnCjJAH6mrE+pXM0Hzgnp1NOgeS6jIIUjGGU9CPpUU3Z6mtSnKSOdtNSt7qyM8GhRRQlzGfLYMeO/uOaW/wBKh+z/AGiGPYOjCupjEcalFiQL3AXAqjfwM0TFcAY6CrdR82hMKDS1PG/EHh+WXU1itwMzNha5a0t5LTUJ4JhiSJ1Vh7gn/CvW9Yh2PBOow0Uo+uCa4Xx7bC08a3yRKAZPKfHuRzXo0arkrM8fE4ZQ95GXOPli5/5Zj+tFZkl1eHaGMYwMD6ZorTkZxe1R6tcgNHsJ5I4rgPFVnIl2Z0UlWGTjtXb3DFpWAbGDir2i6ZaanPJa3MYYSIdp/ukVz05cj1Onl9o+VGJ4GVZNMjRyABJXoZtrW62Rj5ljwQDXAaLZ3WkXE1hdwNE6SbkB/iXsa7vSJBtDdSe1YV73uj08JFWszegREjKqoBI5asTxDEV2SDPlqdo+tdRpdm904VxgGm+LrCNYLSHb+7VyzsPXt/WseZs7/ZqOph2MT3FmXG4464GataE0a3giuNyK/AfHQ/54q/ot7LZWslpb2IdGON+Af1pk7GKdIp9i85Jx0qHFlOqnobFzo5A3Fty9iKwr+3e2JVjla6m01CGaNY1cHIwKyfEkWbdmB6UkiufQ891e2kmuUt4mAMkqjJ6VwfxSUR+N/M6booyxPsSP6V3HirUTpVsdUWHzfsxEmw9GxXi3izXb3xFq7386BDjaqIeFFelhoN6nhY6to0Xrma1AiG+LPljP1yaK5to5RjK5460V3aHjXkep6VqNreEXSErFES0qsemPfvUvhXXPtT7kPk3EXK+hrhppI0uZorKabyGO0l+rAetaXhC5trbUZJZrlII1jIG/+I1hOmuU6IVXGSZ6Z4nSfU4oNUtUUvCgMy/xFccgD2NTaDdF4UPpWVo+vQ2lvNfQqt7Dg7lRunrxVXw7rEN7e3Jhi+zoXLLHnJArllTdj0o105XR7PoUm6NG74rP8UamoX7PFln9Ki8JXm6IR/xY4yaTXrC4Fs89vEjTA85P9a5LanpupdaDfD5+zWzPLIA7nOCcVYvBFcLny3lK85jUt+tZPh6/1GIGP+zLcksDvlG88Vvzf2ldRKlzdLEhJ+SIBQeOnFXogpxbMjS5LeS+EcJk3J1GPu/WtnWXzpuSTu6VPptnDYISqgZ6nHJ+tVtVlRz5Q6HmsbqT0HUXKecfECMDwzegr1jPT6GvGtGt4pAzMM/Mv9a9g+Kd0LXQLlDjMq7VrybQAPKcf9NFH869TDt8lzwMZZ1LFqaGIJD+5HMY7e5oqxOF8uD/AK5D+ZoqzAzrZ7eC58y4i81OcKD1rPkuooZyxtldMk7C3Aq5BDNOzCFd4WoxaQ3Mz7mxtQtwO47V0LcxauR6drt1ZMfIRQpJyhOQRV3w7rslvrMcrIqxu21gvua19G8F293aid7hwPTbV9PBVlHIrCaTKkEcehrObjYumpKVz0vQbtUEbxv8pP3u1dc2oRSR7GOQ3BxXnOkRXFvCHhXzIv4lz0960odQdJwGYhSe4rzJQu9D2aVRwWp29tbw43eYwX2NXLNEjywXcPUnmuZsr9WAHmZHoK34dSgS3UKMnvms+R9TujXha5Pd3QVSzjoK5PV9RWO5Vg+B3HrU+uaxEpbDBvZeawLK3m1O7zICId2eRyacYqO5z1azm7ROe+JNtNqHhy7vGBUph0HoBXj8d1LEoEcuwnHbqf8AJr6S8U2SPpEtrsARoipFeBWWnQl3jlQb0m2n24rvwc/daPNx9FppmWb64bH75iAMD2FFa8tnbBY9sJ+5yfXk0V1e0XY4PZPuaGkARTx+WMfvFz74NQRW8aXErKOS5J/M0UUnsX1PQvD6BdHXHripZuCo9eKKK56htHc6LwqoMCg8jNWNZsbcPwpH0oorhv7zPVl8BiwkgDaSvPY1oxk+YVJJGOhNFFa9DniX9M021uC8swZipGBnir9lGiXhjVQFXgUUVjM6qK94NaRTEe3vXE+JfCmiw+C11+3t2hvftRRyjna/PUg5557YoorfB7sxzHZHnTH9zCf+mf8AU0UUV2s8k//Z",
"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"
}
}
}Определения
| Имя | Описание |
|---|---|
|
Change |
|
|
Git |
|
|
Git |
Предоставляет свойства, описывающие фиксацию Git и связанные метаданные. |
|
Git |
|
|
Git |
|
|
Git |
|
|
Git |
|
|
Git |
|
|
Git |
Этот класс содержит метаданные службы или расширения, публикующей состояние. |
|
Git |
Контекст состояния, который однозначно идентифицирует состояние. |
|
Git |
Состояние состояния. |
|
Git |
|
|
Git |
Сведения о пользователе и дата для операций Git. |
|
Identity |
|
|
Item |
|
|
Item |
|
|
Project |
Состояние проекта. |
|
Project |
Видимость проекта. |
|
Reference |
Класс, представляющий коллекцию ссылок REST. |
|
Resource |
|
|
Team |
Объект ссылки для TeamProjectCollection. |
|
Team |
Представляет неглубокую ссылку на TeamProject. |
|
Version |
Тип изменения, внесенного в элемент. |
ChangeCountDictionary
GitChange
| Имя | Тип | Описание |
|---|---|---|
| changeId |
integer |
Идентификатор изменения в группе изменений. |
| changeType |
Тип изменения, внесенного в элемент. |
|
| item |
string |
Текущая версия. |
| newContent |
Содержимое элемента после изменения. |
|
| newContentTemplate |
Новый шаблон содержимого, используемый при отправке новых изменений. |
|
| originalPath |
string |
Исходный путь к элементу, если он отличается от текущего пути. |
| sourceServerItem |
string |
Путь к элементу на сервере. |
| url |
string |
URL-адрес для получения элемента. |
GitCommitRef
Предоставляет свойства, описывающие фиксацию Git и связанные метаданные.
| Имя | Тип | Описание |
|---|---|---|
| _links |
Коллекция связанных ссылок на REST. |
|
| author |
Автор фиксации. |
|
| changeCounts |
Количество типов изменений (редактирования, удаления и т. д.), включенных в фиксацию. |
|
| changes |
Перечисление изменений, включенных в фиксацию. |
|
| comment |
string |
Комментарий или сообщение фиксации. |
| commentTruncated |
boolean |
Указывает, усекается ли комментарий из полного сообщения о фиксации Git. |
| commitId |
string |
Идентификатор (SHA-1) фиксации. |
| commitTooManyChanges |
boolean |
Указывает, что фиксация содержит слишком много изменений для отображения |
| committer |
Фиксация фиксации. |
|
| parents |
string[] |
Перечисление идентификаторов родительской фиксации для этой фиксации. |
| push |
Отправка, связанная с этой фиксацией. |
|
| remoteUrl |
string |
Удаленный URL-путь к фиксации. |
| statuses |
Список метаданных состояния из служб и расширений, которые могут связывать дополнительные сведения с фиксацией. |
|
| url |
string |
URL-адрес REST для этого ресурса. |
| workItems |
Список рабочих элементов, связанных с этой фиксацией. |
GitPush
| Имя | Тип | Описание |
|---|---|---|
| _links |
Класс, представляющий коллекцию ссылок REST. |
|
| commits |
Предоставляет свойства, описывающие фиксацию Git и связанные метаданные. |
|
| date |
string |
|
| pushId |
integer |
|
| pushedBy | ||
| refUpdates | ||
| repository | ||
| url |
string |
GitPushRef
| Имя | Тип | Описание |
|---|---|---|
| _links |
Класс, представляющий коллекцию ссылок REST. |
|
| date |
string |
|
| pushId |
integer |
|
| pushedBy | ||
| url |
string |
GitRefUpdate
| Имя | Тип | Описание |
|---|---|---|
| isLocked |
boolean |
|
| name |
string |
|
| newObjectId |
string |
|
| oldObjectId |
string |
|
| repositoryId |
string |
GitRepository
| Имя | Тип | Описание |
|---|---|---|
| _links |
Класс, представляющий коллекцию ссылок REST. |
|
| defaultBranch |
string |
|
| id |
string |
|
| isDisabled |
boolean |
Значение true, если репозиторий отключен. В противном случае — значение false. |
| isFork |
boolean |
Значение true, если репозиторий был создан как вилка. |
| isInMaintenance |
boolean |
Значение true, если репозиторий находится в состоянии обслуживания. В противном случае — значение false. |
| name |
string |
|
| parentRepository | ||
| project |
Представляет неглубокую ссылку на TeamProject. |
|
| remoteUrl |
string |
|
| size |
integer |
Сжатый размер (байты) репозитория. |
| sshUrl |
string |
|
| url |
string |
|
| validRemoteUrls |
string[] |
|
| webUrl |
string |
GitRepositoryRef
| Имя | Тип | Описание |
|---|---|---|
| collection |
Коллекция командных проектов, в которой находится эта вилка |
|
| id |
string |
|
| isFork |
boolean |
Значение true, если репозиторий был создан как вилка |
| name |
string |
|
| project |
Представляет неглубокую ссылку на TeamProject. |
|
| remoteUrl |
string |
|
| sshUrl |
string |
|
| url |
string |
GitStatus
Этот класс содержит метаданные службы или расширения, публикующей состояние.
| Имя | Тип | Описание |
|---|---|---|
| _links |
Ссылки на справочные материалы. |
|
| context |
Контекст состояния. |
|
| createdBy |
Удостоверение, создающее состояние. |
|
| creationDate |
string |
Дата и время создания состояния. |
| description |
string |
Описание состояния. Обычно описывает текущее состояние состояния. |
| id |
integer |
Идентификатор состояния. |
| state |
Состояние состояния. |
|
| targetUrl |
string |
URL-адрес со сведениями о состоянии. |
| updatedDate |
string |
Дата и время последнего обновления состояния. |
GitStatusContext
Контекст состояния, который однозначно идентифицирует состояние.
| Имя | Тип | Описание |
|---|---|---|
| genre |
string |
Жанр состояния. Как правило, имя службы или средства, создающего состояние, может быть пустым. |
| name |
string |
Идентификатор имени состояния не может быть пустым или пустым. |
GitStatusState
Состояние состояния.
| Имя | Тип | Описание |
|---|---|---|
| error |
string |
Состояние с ошибкой. |
| failed |
string |
Сбой состояния. |
| notApplicable |
string |
Состояние неприменимо к целевому объекту. |
| notSet |
string |
Состояние состояния не задано. Состояние по умолчанию. |
| pending |
string |
Состояние ожидается. |
| succeeded |
string |
Состояние выполнено успешно. |
GitTemplate
| Имя | Тип | Описание |
|---|---|---|
| name |
string |
Имя шаблона |
| type |
string |
Тип шаблона |
GitUserDate
Сведения о пользователе и дата для операций Git.
| Имя | Тип | Описание |
|---|---|---|
| date |
string |
Дата операции Git. |
|
string |
Email адрес пользователя, выполняющего операцию Git. |
|
| imageUrl |
string |
URL-адрес аватара пользователя. |
| name |
string |
Имя пользователя, выполняющего операцию Git. |
IdentityRef
| Имя | Тип | Описание |
|---|---|---|
| _links |
Это поле содержит ноль или более интересных ссылок на тему графа. Эти ссылки можно вызывать для получения дополнительных связей или более подробных сведений об этой теме графа. |
|
| descriptor |
string |
Дескриптор является основным способом ссылки на субъект графа во время работы системы. Это поле будет уникальным образом определять один и тот же субъект графа как в учетных записях, так и в организациях. |
| directoryAlias |
string |
Нерекомендуемое — можно получить запрос пользователя Graph, на который ссылается запись self словаря IdentityRef _links. |
| displayName |
string |
Это неуникальное отображаемое имя субъекта графа. Чтобы изменить это поле, необходимо изменить его значение в поставщике источника. |
| id |
string |
|
| imageUrl |
string |
Не рекомендуется — доступно в записи "аватар" словаря IdentityRef "_links" |
| inactive |
boolean |
Нерекомендуемое — можно получить запрос к состоянию членства Graph, на которое ссылается запись "membershipState" словаря GraphUser "_links". |
| isAadIdentity |
boolean |
Нерекомендуемый — может быть выведен из типа субъекта дескриптора (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
| isContainer |
boolean |
Нерекомендуемый — может быть выведен из типа субъекта дескриптора (Descriptor.IsGroupType) |
| isDeletedInOrigin |
boolean |
|
| profileUrl |
string |
Не рекомендуется — не используется в большинстве уже существовающих реализаций ToIdentityRef |
| uniqueName |
string |
Не рекомендуется использовать вместо него домен+principalName. |
| url |
string |
Этот URL-адрес представляет собой полный маршрут к исходному ресурсу этого субъекта графа. |
ItemContent
| Имя | Тип | Описание |
|---|---|---|
| content |
string |
|
| contentType |
ItemContentType
| Имя | Тип | Описание |
|---|---|---|
| base64Encoded |
string |
|
| rawText |
string |
ProjectState
Состояние проекта.
| Имя | Тип | Описание |
|---|---|---|
| all |
string |
Все проекты независимо от состояния, кроме Deleted. |
| createPending |
string |
Проект поставлен в очередь для создания, но процесс еще не запущен. |
| deleted |
string |
Проект удален. |
| deleting |
string |
Project находится в процессе удаления. |
| new |
string |
Проект находится в процессе создания. |
| unchanged |
string |
Проект не был изменен. |
| wellFormed |
string |
Project полностью создан и готов к использованию. |
ProjectVisibility
Видимость проекта.
| Имя | Тип | Описание |
|---|---|---|
| private |
string |
Проект виден только пользователям с явным доступом. |
| public |
string |
Проект виден всем. |
ReferenceLinks
Класс, представляющий коллекцию ссылок REST.
| Имя | Тип | Описание |
|---|---|---|
| links |
object |
Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения. |
ResourceRef
| Имя | Тип | Описание |
|---|---|---|
| id |
string |
|
| url |
string |
TeamProjectCollectionReference
Объект ссылки для TeamProjectCollection.
| Имя | Тип | Описание |
|---|---|---|
| avatarUrl |
string |
URL-адрес аватара коллекции. |
| id |
string |
Идентификатор коллекции. |
| name |
string |
Имя коллекции. |
| url |
string |
URL-адрес REST коллекции. |
TeamProjectReference
Представляет неглубокую ссылку на TeamProject.
| Имя | Тип | Описание |
|---|---|---|
| abbreviation |
string |
Сокращение проекта. |
| defaultTeamImageUrl |
string |
URL-адрес для образа удостоверения команды по умолчанию. |
| description |
string |
Описание проекта (если таковое есть). |
| id |
string |
Идентификатор проекта. |
| lastUpdateTime |
string |
Время последнего обновления проекта. |
| name |
string |
Имя проекта. |
| revision |
integer |
Редакция проекта. |
| state |
Состояние проекта. |
|
| url |
string |
URL-адрес полной версии объекта. |
| visibility |
Видимость проекта. |
VersionControlChangeType
Тип изменения, внесенного в элемент.
| Имя | Тип | Описание |
|---|---|---|
| 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 |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по