Git - Update My Git Credentials

Служба:

Core

Версия API:

v1

Обновляет сведения о конфигурации учетных данных пользователя Git.
Каждый пользователь в рабочей области имеет собственные учетные данные Git. Вы можете использовать API получения учетных данных Git для получения конфигурации учетных данных Git.

Чтобы получить идентификатор подключения, см. статью "Автоматизация интеграции Git".

Разрешения

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

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

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

Workspace.ReadWrite.All

Поддерживаемые удостоверения Microsoft Entra

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

Идентичность	Поддержка
Пользователь	Да
учетные записи службы и управляемые удостоверения	Не поддерживается, если поставщик Git — AzureDevOps и учетные данные автоматически

Интерфейс

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/myGitCredentials

Параметры URI

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

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

Текст запроса может быть таким:

Имя	Описание
UpdateGitCredentialsToAutomaticRequest	Содержит данные запроса для автоматического обновления учетных данных Git.
UpdateGitCredentialsToConfiguredConnectionRequest	Содержит данные запроса для обновления учетных данных Git для настройки подключения.
UpdateGitCredentialsToNoneRequest	Содержит данные запроса для обновления учетных данных Git на нет.

UpdateGitCredentialsToAutomaticRequest

Содержит данные запроса для автоматического обновления учетных данных Git.

Имя	Обязательно	Тип	Описание
source	True	string: Automatic	Источник учетных данных Git.

UpdateGitCredentialsToConfiguredConnectionRequest

Содержит данные запроса для обновления учетных данных Git для настройки подключения.

Имя	Обязательно	Тип	Описание
connectionId	True	string (uuid)	Идентификатор объекта подключения.
source	True	string: ConfiguredConnection	Источник учетных данных Git.

UpdateGitCredentialsToNoneRequest

Содержит данные запроса для обновления учетных данных Git на нет.

Имя	Обязательно	Тип	Описание
source	True	string: None	Источник учетных данных Git.

Ответы

Имя	Тип	Описание
200 OK	GitCredentialsConfigurationResponse: AutomaticGitCredentialsResponse NoneGitCredentialsResponse ConfiguredConnectionGitCredentialsResponse	Запрос успешно завершен.
Other Status Codes	ErrorResponse	Распространенные коды ошибок: UnknownError — произошла ошибка. НедостаточноPrivileges — вызывающий имеет недостаточно разрешений рабочей области. WorkspaceNotConnectedToGit — Рабочая область не подключена к git. ConnectionNotFound — указанное соединение не найдено. ConnectionMismatch — подключение не соответствует сведениям о поставщике Git. PrincipalTypeNotSupported — тип удостоверения вызывающего объекта не поддерживается.

Примеры

Update user's Git credentials to Automatic example

Update user's Git credentials to ConfiguredConnection example

Update user's Git credentials to None example

Update user's Git credentials to Automatic example

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

HTTP

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

{
  "source": "Automatic"
}

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

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

200

{
  "source": "Automatic"
}

Update user's Git credentials to ConfiguredConnection example

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

HTTP

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

{
  "source": "ConfiguredConnection",
  "connectionId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
}

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

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

200

{
  "source": "ConfiguredConnection",
  "connectionId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
}

Update user's Git credentials to None example

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

HTTP

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

{
  "source": "None"
}

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

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

200

{
  "source": "None"
}

Определения

Имя	Описание
AutomaticGitCredentialsResponse	Автоматические учетные данные Git.
ConfiguredConnectionGitCredentialsResponse	Настроенные учетные данные подключения Git.
ErrorRelatedResource	Объект сведений об ошибках, связанных с ресурсом.
ErrorResponse	Ответ на ошибку.
ErrorResponseDetails	Сведения об ответе на ошибку.
GitCredentialsSource	Источник учетных данных Git. С течением времени могут добавляться дополнительные источники учетных данных Git.
NoneGitCredentialsResponse	Не настроены учетные данные Git.
UpdateGitCredentialsToAutomaticRequest	Содержит данные запроса для автоматического обновления учетных данных Git.
UpdateGitCredentialsToConfiguredConnectionRequest	Содержит данные запроса для обновления учетных данных Git для настройки подключения.
UpdateGitCredentialsToNoneRequest	Содержит данные запроса для обновления учетных данных Git на нет.

AutomaticGitCredentialsResponse

Object

Автоматические учетные данные Git.

Имя	Тип	Описание
source	string: Automatic	Источник учетных данных Git.

ConfiguredConnectionGitCredentialsResponse

Object

Настроенные учетные данные подключения Git.

Имя	Тип	Описание
connectionId	string (uuid)	Идентификатор объекта подключения.
source	string: ConfiguredConnection	Источник учетных данных 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	Сведения об ошибках, связанных с ресурсом.

GitCredentialsSource

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

Источник учетных данных Git. С течением времени могут добавляться дополнительные источники учетных данных Git.

Значение	Описание
Automatic	Учетные данные Git автоматически получаются системой, используя учетные данные по умолчанию, если они доступны.
ConfiguredConnection	Учетные данные Git получаются через настроенное подключение.
None	Учетные данные Git не настроены.

NoneGitCredentialsResponse

Object

Не настроены учетные данные Git.

Имя	Тип	Описание
source	string: None	Источник учетных данных Git.

UpdateGitCredentialsToAutomaticRequest

Object

Содержит данные запроса для автоматического обновления учетных данных Git.

Имя	Тип	Описание
source	string: Automatic	Источник учетных данных Git.

UpdateGitCredentialsToConfiguredConnectionRequest

Object

Содержит данные запроса для обновления учетных данных Git для настройки подключения.

Имя	Тип	Описание
connectionId	string (uuid)	Идентификатор объекта подключения.
source	string: ConfiguredConnection	Источник учетных данных Git.

UpdateGitCredentialsToNoneRequest

Object

Содержит данные запроса для обновления учетных данных Git на нет.

Имя	Тип	Описание
source	string: None	Источник учетных данных Git.