Git - Commit To Git

Служба:: Core

Версия API:: v1

Фиксирует изменения, внесенные в рабочую область, в подключенную удаленную ветвь.
Этот API поддерживает длительные операции (LRO).

Чтобы использовать этот API, учетные данные вызывающего объекта должны быть настроены с помощью API обновления учетных данных Git . Вы можете использовать API получения учетных данных Git для проверки конфигурации учетных данных Git.

Вы можете зафиксировать все изменения или только определенные измененные элементы. Чтобы синхронизировать рабочую область впервые, используйте этот API после API подключения и инициализации подключений .

Разрешения

Вызывающий объект должен иметь роль участника или более поздней рабочей области.

Обязательные делегированные области

Workspace.GitCommit.All.

Идентификаторы, поддерживаемые Microsoft Entra

Этот API поддерживает идентичности Microsoft, перечисленные в этом разделе.

Идентичность	Поддержка
Пользователь	Да
Представитель службы и управляемые удостоверения	Поддерживается только в том случае, если все элементы , участвующие в операции, поддерживают субъекты-службы.

Интерфейс

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/commitToGit

Параметры URI

Имя	В	Обязательно	Тип	Описание
workspaceId	path	True	string (uuid)	Идентификатор рабочей области.

Текст запроса

Имя	Обязательно	Тип	Описание
mode	True	CommitMode	Режим операции фиксации.
comment		string maxLength: 300	Бесплатный комментарий вызывающего абонента для этой фиксации. Максимальная длина — 300 символов. Если вызывающий объект не предоставляет никаких комментариев, используйте комментарий поставщика Git по умолчанию.
items		ItemIdentifier[]	Определенные элементы для фиксации. Это относится только к режиму выборочной фиксации. Элементы можно получить из API состояния Git .
workspaceHead		string	Полный хэш SHA, с которым синхронизируется рабочая область. Хэш можно получить из API состояния Git .

Ответы

Имя	Тип	Описание
200 OK		Запрос успешно завершен.
202 Accepted		Запрос принят, фиксация в Git выполняется. Заголовки Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Распространенные коды ошибок: WorkspaceNotConnectedToGit — Рабочая область не подключена к git. WorkspaceHasNoCapacityAssigned— емкость не перенаправлялась в рабочую область. WorkspaceHeadMismatch — голова в запросе не соответствует голове в системе. WorkspacePreviousOperationInProgresss — предыдущая операция по-прежнему выполняется. НедостаточноPrivileges — вызывающий объект не имеет достаточных разрешений рабочей области. PrincipalTypeNotSupported — тип удостоверения вызывающего объекта не поддерживается.

Имя

Тип

Описание

200 OK

Запрос успешно завершен.

202 Accepted

Запрос принят, фиксация в Git выполняется.

Заголовки

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Распространенные коды ошибок:

WorkspaceNotConnectedToGit — Рабочая область не подключена к git.
WorkspaceHasNoCapacityAssigned— емкость не перенаправлялась в рабочую область.
WorkspaceHeadMismatch — голова в запросе не соответствует голове в системе.
WorkspacePreviousOperationInProgresss — предыдущая операция по-прежнему выполняется.
НедостаточноPrivileges — вызывающий объект не имеет достаточных разрешений рабочей области.
PrincipalTypeNotSupported — тип удостоверения вызывающего объекта не поддерживается.

Примеры

Commit all to Git example

Commit selective items to Git example

Commit all to Git example

Образец запроса

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/1565e6a3-c020-4c0c-dda7-92bafe99eec5/git/commitToGit

{
  "mode": "All",
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "comment": "I'm committing all my changes."
}

Пример ответа

Код состояния:: 200

Код состояния:: 202

Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

Commit selective items to Git example

Образец запроса

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/1565e6a3-c020-4c0c-dda7-92bafe99eec5/git/commitToGit

{
  "mode": "Selective",
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "comment": "I'm committing specific changes.",
  "items": [
    {
      "logicalId": "111e8d7b-4a95-4c02-8ccd-6faef5ba1bd1",
      "objectId": "1153f3b4-dbb8-33c1-a84f-6ae4d776362d"
    },
    {
      "objectId": "7753f3b4-dbb8-44c1-a94f-6ae4d776369e"
    }
  ]
}

Пример ответа

Код состояния:: 200

Код состояния:: 202

Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

Определения

Имя	Описание
CommitMode	Режимы операции фиксации. С течением времени могут добавляться дополнительные режимы.
CommitToGitRequest	Содержит запрос фиксации.
ErrorRelatedResource	Объект сведений об ошибках, связанных с ресурсом.
ErrorResponse	Ответ на ошибку.
ErrorResponseDetails	Сведения об ответе на ошибку.
ItemIdentifier	Содержит идентификатор элемента. Необходимо определить хотя бы одно из свойств.

CommitMode

Перечисление

Режимы операции фиксации. С течением времени могут добавляться дополнительные режимы.

Значение	Описание
All	Зафиксируйте все незафиксированные изменения. Вызывающий объект не требуется предоставить список элементов для фиксации.
Selective	Зафиксируйте указанный список элементов с незафиксированными изменениями.

CommitToGitRequest

Object

Содержит запрос фиксации.

Имя	Тип	Описание
comment	string maxLength: 300	Бесплатный комментарий вызывающего абонента для этой фиксации. Максимальная длина — 300 символов. Если вызывающий объект не предоставляет никаких комментариев, используйте комментарий поставщика Git по умолчанию.
items	ItemIdentifier[]	Определенные элементы для фиксации. Это относится только к режиму выборочной фиксации. Элементы можно получить из API состояния Git .
mode	CommitMode	Режим операции фиксации.
workspaceHead	string	Полный хэш SHA, с которым синхронизируется рабочая область. Хэш можно получить из API состояния Git .

ErrorRelatedResource

Object

Объект сведений об ошибках, связанных с ресурсом.

Имя	Тип	Описание
resourceId	string	Идентификатор ресурса, участвующий в ошибке.
resourceType	string	Тип ресурса, который участвует в ошибке.

ErrorResponse

Object

Ответ на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
moreDetails	ErrorResponseDetails[]	Список дополнительных сведений об ошибке.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.
requestId	string	Идентификатор запроса, связанного с ошибкой.

ErrorResponseDetails

Object

Сведения об ответе на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.

ItemIdentifier

Object

Содержит идентификатор элемента. Необходимо определить хотя бы одно из свойств.

Имя	Тип	Описание
logicalId	string (uuid)	Логический идентификатор элемента. Если логический идентификатор недоступен, так как элемент еще не добавлен в рабочую область, можно использовать идентификатор объекта.
objectId	string (uuid)	Идентификатор объекта элемента. Если идентификатор объекта недоступен, так как элемент был удален из рабочей области, можно использовать логический идентификатор.

Поделиться через

Git - Commit To Git

Разрешения

Обязательные делегированные области

Идентификаторы, поддерживаемые Microsoft Entra

Интерфейс

Параметры URI

Текст запроса

Ответы

Примеры

Commit all to Git example

Образец запроса

Пример ответа

Commit selective items to Git example

Образец запроса

Пример ответа

Определения

CommitMode

CommitToGitRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemIdentifier