Web Apps - Create Or Update Source Control

Служба:

App Service

Версия API:

2025-05-01

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

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/sourcecontrols/web?api-version=2025-05-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
name	path	True	string	Имя приложения.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не зависит от регистра.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

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

Имя	Тип	Описание
kind	string	Тип ресурса.
properties.branch	string	Имя ветви, используемой для развертывания.
properties.deploymentRollbackEnabled	boolean	true для включения отката развертывания; в противном случае, false.
properties.gitHubActionConfiguration	GitHubActionConfiguration	Если выбрано действие GitHub, чем связанная конфигурация.
properties.isGitHubAction	boolean	true если это развернуто с помощью GitHub action.
properties.isManualIntegration	boolean	true ограничить ручную интеграцию; false , чтобы включить непрерывную интеграцию (которая настраивает веб-перехватчики в онлайн-репозиториях, таких как GitHub).
properties.isMercurial	boolean	true для репозитория Mercurial; false для репозитория Git.
properties.repoUrl	string	URL-адрес репозитория или системы управления версиями.

Ответы

Имя	Тип	Описание
200 OK	SiteSourceControl	Операция обновления ресурса 'SiteSourceControl' успешно завершена
201 Created	SiteSourceControl	Операция создания ресурса 'SiteSourceControl' успешно выполнена Заголовки Location: string Retry-After: integer
202 Accepted	SiteSourceControl	Запрос был принят для обработки, но обработка еще не завершена. Заголовки Location: string Retry-After: integer
Other Status Codes	DefaultErrorResponse	Непредвиденное сообщение об ошибке.

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

azure_auth

Поток OAuth2 в Azure Active Directory.

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

Области

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

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
DefaultErrorResponse	Ответ об ошибке службы приложений.
DefaultErrorResponseError	Модель ошибок.
DefaultErrorResponseErrorDetailsItem	Подробные ошибки.
GitHubActionCodeConfiguration	Конфигурация кода действия GitHub.
GitHubActionConfiguration	Конфигурация действий GitHub.
GitHubActionContainerConfiguration	Конфигурация контейнера действий GitHub.
SiteSourceControl	Конфигурация системы управления версиями для приложения.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

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

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

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

DefaultErrorResponse

Объект

Ответ об ошибке службы приложений.

Имя	Тип	Описание
error	DefaultErrorResponseError	Модель ошибок.

DefaultErrorResponseError

Объект

Модель ошибок.

Имя	Тип	Описание
code	string	Стандартизированная строка для программной идентификации ошибки.
details	DefaultErrorResponseErrorDetailsItem[]	Подробные ошибки.
innererror	string	Дополнительная информация об ошибке отладки.
message	string	Подробное описание ошибки и информация об отладке.
target	string	Подробное описание ошибки и информация об отладке.

DefaultErrorResponseErrorDetailsItem

Объект

Подробные ошибки.

Имя	Тип	Описание
code	string	Стандартизированная строка для программной идентификации ошибки.
message	string	Подробное описание ошибки и информация об отладке.
target	string	Подробное описание ошибки и информация об отладке.

GitHubActionCodeConfiguration

Объект

Конфигурация кода действия GitHub.

Имя	Тип	Описание
runtimeStack	string	Стек среды выполнения используется для определения содержимого файла рабочего процесса для базовых приложений кода.
runtimeVersion	string	Версия среды выполнения используется для определения версии сборки, заданной в файле рабочего процесса.

GitHubActionConfiguration

Объект

Конфигурация действий GitHub.

Имя	Тип	Описание
codeConfiguration	GitHubActionCodeConfiguration	Конфигурация кода действия GitHub.
containerConfiguration	GitHubActionContainerConfiguration	Конфигурация контейнера GitHub Action.
generateWorkflowFile	boolean	Параметр рабочего процесса, чтобы определить, должен ли файл рабочего процесса создаваться и записываться в репозиторий.
isLinux	boolean	Это поможет определить конфигурацию рабочего процесса для выбора.

GitHubActionContainerConfiguration

Объект

Конфигурация контейнера действий GitHub.

Имя	Тип	Описание
imageName	string	Имя образа для сборки.
password	string (password)	Пароль, используемый для отправки образа в реестр контейнеров.
serverUrl	string	URL-адрес сервера для реестра контейнеров, в котором будет размещена сборка.
username	string	Имя пользователя, используемое для отправки образа в реестр контейнеров.

SiteSourceControl

Объект

Конфигурация системы управления версиями для приложения.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Тип ресурса.
name	string	Имя ресурса
properties.branch	string	Имя ветви, используемой для развертывания.
properties.deploymentRollbackEnabled	boolean	true для включения отката развертывания; в противном случае, false.
properties.gitHubActionConfiguration	GitHubActionConfiguration	Если выбрано действие GitHub, чем связанная конфигурация.
properties.isGitHubAction	boolean	true если это развернуто с помощью GitHub action.
properties.isManualIntegration	boolean	true ограничить ручную интеграцию; false , чтобы включить непрерывную интеграцию (которая настраивает веб-перехватчики в онлайн-репозиториях, таких как GitHub).
properties.isMercurial	boolean	true для репозитория Mercurial; false для репозитория Git.
properties.repoUrl	string	URL-адрес репозитория или системы управления версиями.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

systemData

Объект

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

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