Source Control - Update

Служба:: Automation

Версия API:: 2024-10-23

Обновление системы управления версиями.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/sourceControls/{sourceControlName}?api-version=2024-10-23

Параметры URI

Имя	В	Обязательно	Тип	Описание
automationAccountName	path	True	string	Имя учетной записи службы автоматизации.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Имя группы ресурсов Azure.
sourceControlName	path	True	string	Имя системы управления версиями.
subscriptionId	path	True	string	Получает учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы.
api-version	query	True	string	Версия клиентского API.

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

Имя	Тип	Описание
properties.autoSync	boolean	Автоматическая синхронизация системы управления версиями. По умолчанию — false.
properties.branch	string	Ветвь репозитория системы управления версиями.
properties.description	string	Описание пользователя системы управления версиями.
properties.folderPath	string	Путь к папке системы управления версиями. Путь должен быть относительным.
properties.publishRunbook	boolean	Автоматическая публикация системы управления версиями. Значение по умолчанию — истинно.
properties.securityToken	SourceControlSecurityTokenProperties	Маркер авторизации для репозитория системы управления версиями.

Ответы

Имя	Тип	Описание
200 OK	SourceControl	ХОРОШО
Other Status Codes	ErrorResponse	Ответ об ошибке автоматизации, описывающий, почему операция завершилась ошибкой.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

Update a source control

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

HTTP

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/sampleAccount9/sourceControls/sampleSourceControl?api-version=2024-10-23

{
  "properties": {
    "branch": "master",
    "folderPath": "/folderOne/folderTwo",
    "autoSync": true,
    "publishRunbook": true,
    "securityToken": {
      "accessToken": "******",
      "tokenType": "PersonalAccessToken"
    },
    "description": "my description"
  }
}

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

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

{
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/sampleAccount9/sourcecontrols/sampleSourceControl",
  "name": "sampleSourceControl",
  "properties": {
    "creationTime": "2017-03-28T22:59:00.937+00:00",
    "lastModifiedTime": "2017-03-28T22:59:00.937+00:00",
    "repoUrl": "https://sampleUser.visualstudio.com/myProject/_git/myRepository",
    "branch": "master",
    "folderPath": "/folderOne/folderTwo",
    "autoSync": true,
    "publishRunbook": true,
    "sourceType": "VsoGit",
    "description": "my description"
  }
}

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
ErrorResponse	Ответ на ошибку сбоя операции
SourceControl	Определение системы управления версиями.
SourceControlSecurityTokenProperties
SourceControlUpdateParameters	Параметры, предоставленные операции управления версиями обновления.
sourceType	Исходный тип. Должен быть одним из VsoGit, VsoTfvc, GitHub.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
tokenType	Тип токена. Должно быть либо PersonalAccessToken, либо Oauth.

createdByType

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

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

ErrorResponse

Object

Ответ на ошибку сбоя операции

Имя	Тип	Описание
code	string	Код ошибки
message	string	Сообщение об ошибке, указывающее, почему операция завершилась ошибкой.

SourceControl

Object

Определение системы управления версиями.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties.autoSync	boolean	Автоматическая синхронизация системы управления версиями. По умолчанию — false.
properties.branch	string	Ветвь репозитория системы управления версиями. Включите ветвь как пустую строку для VsoTfvc.
properties.creationTime	string (date-time)	Время создания.
properties.description	string	Описание.
properties.folderPath	string	Путь к папке системы управления версиями.
properties.lastModifiedTime	string (date-time)	Время последнего изменения.
properties.publishRunbook	boolean	Автоматическая публикация системы управления версиями. Значение по умолчанию — истинно.
properties.repoUrl	string	URL-адрес репозитория системы управления версиями.
properties.sourceType	sourceType	Исходный тип. Должен быть одним из VsoGit, VsoTfvc, GitHub.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

SourceControlSecurityTokenProperties

Object

Имя	Тип	Описание
accessToken	string maxLength: 1024	Маркер доступа.
refreshToken	string maxLength: 1024	Токен обновления.
tokenType	tokenType	Тип токена. Должно быть либо PersonalAccessToken, либо Oauth.

SourceControlUpdateParameters

Object

Параметры, предоставленные операции управления версиями обновления.

Имя	Тип	Описание
properties.autoSync	boolean	Автоматическая синхронизация системы управления версиями. По умолчанию — false.
properties.branch	string	Ветвь репозитория системы управления версиями.
properties.description	string	Описание пользователя системы управления версиями.
properties.folderPath	string	Путь к папке системы управления версиями. Путь должен быть относительным.
properties.publishRunbook	boolean	Автоматическая публикация системы управления версиями. Значение по умолчанию — истинно.
properties.securityToken	SourceControlSecurityTokenProperties	Маркер авторизации для репозитория системы управления версиями.

sourceType

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

Исходный тип. Должен быть одним из VsoGit, VsoTfvc, GitHub.

Значение	Описание
VsoGit
VsoTfvc
GitHub

systemData

Object

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

tokenType

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

Тип токена. Должно быть либо PersonalAccessToken, либо Oauth.

Значение	Описание
PersonalAccessToken
Oauth

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

Source Control - Update

Параметры URI

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

Ответы

Безопасность

azure_auth

Области

Примеры

Update a source control

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

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

Определения

createdByType

ErrorResponse

SourceControl

SourceControlSecurityTokenProperties

SourceControlUpdateParameters

sourceType

systemData

tokenType