Web Apps - Create Or Update Source Control

Servicio:

App Service

Versión de la API:

2025-05-01

Descripción de Actualiza la configuración de control de código fuente de una aplicación.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
name	path	True	string	Nombre de la aplicación.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
kind	string	Tipo de recurso.
properties.branch	string	Nombre de la rama que se va a usar para la implementación.
properties.deploymentRollbackEnabled	boolean	true para habilitar la reversión de la implementación; de lo contrario, false.
properties.gitHubActionConfiguration	GitHubActionConfiguration	Si se selecciona Acción de GitHub, que la configuración asociada.
properties.isGitHubAction	boolean	true si se implementa a través de la acción de GitHub.
properties.isManualIntegration	boolean	true limitar a la integración manual; false para habilitar la integración continua (que configura webhooks en repositorios en línea como GitHub).
properties.isMercurial	boolean	true para un depósito Mercurial; false para un repositorio de Git.
properties.repoUrl	string	Dirección URL del repositorio o del control de código fuente.

Respuestas

Nombre	Tipo	Description
200 OK	SiteSourceControl	Operación de actualización del recurso 'SiteSourceControl' exitosa
201 Created	SiteSourceControl	Recurso 'SiteSourceControl' crear operación exitosa Encabezados Location: string Retry-After: integer
202 Accepted	SiteSourceControl	La solicitud se ha aceptado para su procesamiento, pero el procesamiento aún no se ha completado. Encabezados Location: string Retry-After: integer
Other Status Codes	DefaultErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Definiciones

Nombre	Description
createdByType	El tipo de identidad que creó el recurso.
DefaultErrorResponse	Respuesta de error de App Service.
DefaultErrorResponseError	Modelo de error.
DefaultErrorResponseErrorDetailsItem	Errores detallados.
GitHubActionCodeConfiguration	La configuración del código de acción de GitHub.
GitHubActionConfiguration	La configuración de la acción de GitHub.
GitHubActionContainerConfiguration	La configuración del contenedor de acciones de GitHub.
SiteSourceControl	Configuración de control de código fuente para una aplicación.
systemData	Metadatos relativos a la creación y última modificación del recurso.

createdByType

Enumeración

El tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Objeto

Respuesta de error de App Service.

Nombre	Tipo	Description
error	DefaultErrorResponseError	Modelo de error.

DefaultErrorResponseError

Objeto

Modelo de error.

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar el error mediante programación.
details	DefaultErrorResponseErrorDetailsItem[]	Errores detallados.
innererror	string	Más información para depurar el error.
message	string	Descripción detallada del error e información de depuración.
target	string	Descripción detallada del error e información de depuración.

DefaultErrorResponseErrorDetailsItem

Objeto

Errores detallados.

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar el error mediante programación.
message	string	Descripción detallada del error e información de depuración.
target	string	Descripción detallada del error e información de depuración.

GitHubActionCodeConfiguration

Objeto

La configuración del código de acción de GitHub.

Nombre	Tipo	Description
runtimeStack	string	La pila en tiempo de ejecución se usa para determinar el contenido del archivo de flujo de trabajo para las aplicaciones base de código.
runtimeVersion	string	La versión en tiempo de ejecución se usa para determinar qué versión de compilación se va a establecer en el archivo de flujo de trabajo.

GitHubActionConfiguration

Objeto

La configuración de la acción de GitHub.

Nombre	Tipo	Description
codeConfiguration	GitHubActionCodeConfiguration	Configuración del código de acción de GitHub.
containerConfiguration	GitHubActionContainerConfiguration	Configuración del contenedor de acciones de GitHub.
generateWorkflowFile	boolean	Opción de flujo de trabajo para determinar si el archivo de flujo de trabajo se debe generar y escribir en el repositorio.
isLinux	boolean	Esto ayudará a determinar la configuración del flujo de trabajo que se va a seleccionar.

GitHubActionContainerConfiguration

Objeto

La configuración del contenedor de acciones de GitHub.

Nombre	Tipo	Description
imageName	string	Nombre de la imagen de la compilación.
password	string (password)	Contraseña usada para cargar la imagen en el registro de contenedor.
serverUrl	string	Dirección URL del servidor del registro de contenedor donde se hospedará la compilación.
username	string	Nombre de usuario que se usa para cargar la imagen en el registro de contenedor.

SiteSourceControl

Objeto

Configuración de control de código fuente para una aplicación.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Tipo de recurso.
name	string	Nombre del recurso
properties.branch	string	Nombre de la rama que se va a usar para la implementación.
properties.deploymentRollbackEnabled	boolean	true para habilitar la reversión de la implementación; de lo contrario, false.
properties.gitHubActionConfiguration	GitHubActionConfiguration	Si se selecciona Acción de GitHub, que la configuración asociada.
properties.isGitHubAction	boolean	true si se implementa a través de la acción de GitHub.
properties.isManualIntegration	boolean	true limitar a la integración manual; false para habilitar la integración continua (que configura webhooks en repositorios en línea como GitHub).
properties.isMercurial	boolean	true para un depósito Mercurial; false para un repositorio de Git.
properties.repoUrl	string	Dirección URL del repositorio o del control de código fuente.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	La marca de tiempo de la creación de recursos (UTC).
createdBy	string	La identidad que creó el recurso.
createdByType	createdByType	El tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	La marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	La identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	El tipo de identidad que modificó por última vez el recurso.