Compartir a través de


Static Sites - Update Static Site

Descripción para Crea un nuevo sitio estático en un grupo de recursos existente o actualiza un sitio estático existente.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}?api-version=2023-12-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
name
path True

string

Nombre del sitio estático que se va a crear o actualizar.

resourceGroupName
path True

string

Nombre del grupo de recursos al que pertenece el recurso.

Patrón de Regex: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True

string

Su identificador de suscripción de Azure. Se trata de una cadena con formato GUID (por ejemplo, 000000000-0000-0000-0000-000000000000000).

api-version
query True

string

Versión de la API

Cuerpo de la solicitud

Nombre Tipo Description
kind

string

Tipo de recurso.

properties.allowConfigFileUpdates

boolean

false si el archivo de configuración está bloqueado para esta aplicación web estática; de lo contrario, true.

properties.branch

string

Rama de destino en el repositorio.

properties.buildProperties

StaticSiteBuildProperties

Cree propiedades para configurar en el repositorio.

properties.enterpriseGradeCdnStatus

EnterpriseGradeCdnStatus

Estado que indica el estado de la red CDN de nivel empresarial que atiende el tráfico a la aplicación web estática.

properties.provider

string

Proveedor que envió la última implementación al entorno principal del sitio estático.

properties.publicNetworkAccess

string

Estado que indica si se permite o no el tráfico público para una aplicación web estática. Valores permitidos: 'Enabled', 'Disabled' o una cadena vacía.

properties.repositoryToken

string

Token del repositorio de GitHub de un usuario. Se usa para configurar el archivo de flujo de trabajo de Acciones de Github y los secretos de API.

properties.repositoryUrl

string

Dirección URL del repositorio del sitio estático.

properties.stagingEnvironmentPolicy

StagingEnvironmentPolicy

Estado que indica si se permiten o no entornos de ensayo para una aplicación web estática.

properties.templateProperties

StaticSiteTemplateOptions

Opciones de plantilla para generar un nuevo repositorio.

Respuestas

Nombre Tipo Description
200 OK

StaticSiteARMResource

Aceptar.

202 Accepted

StaticSiteARMResource

Operación asincrónica en curso.

Other Status Codes

DefaultErrorResponse

App Service respuesta de error.

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 suplantación de su cuenta de usuario

Ejemplos

Patch a static site

Solicitud de ejemplo

PATCH https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/staticSites/testStaticSite0?api-version=2023-12-01

{
  "properties": {}
}

Respuesta de muestra

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/staticSites/testStaticSite0",
  "name": "testStaticSite0",
  "type": "Microsoft.Web/staticSites",
  "location": "West US 2",
  "properties": {
    "defaultHostname": "happy-sea-15afae3e.azurestaticwebsites.net",
    "repositoryUrl": "https://github.com/username/RepoName",
    "branch": "demo",
    "customDomains": [],
    "privateEndpointConnections": [],
    "contentDistributionEndpoint": "",
    "keyVaultReferenceIdentity": "SystemAssigned",
    "userProvidedFunctionApps": [],
    "stagingEnvironmentPolicy": "Enabled",
    "allowConfigFileUpdates": true
  },
  "sku": {
    "name": "Basic",
    "tier": "Basic"
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.Web/locations/westus2/operationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2019-01-01
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/staticSites/testStaticSite0",
  "name": "testStaticSite0",
  "type": "Microsoft.Web/staticSites",
  "location": "West US 2",
  "properties": {
    "defaultHostname": "happy-sea-15afae3e.azurestaticwebsites.net",
    "repositoryUrl": "https://github.com/username/RepoName",
    "branch": "demo",
    "customDomains": [],
    "privateEndpointConnections": [],
    "contentDistributionEndpoint": "",
    "keyVaultReferenceIdentity": "SystemAssigned",
    "userProvidedFunctionApps": [],
    "stagingEnvironmentPolicy": "Enabled",
    "allowConfigFileUpdates": true
  },
  "sku": {
    "name": "Basic",
    "tier": "Basic"
  }
}

Definiciones

Nombre Description
ArmIdWrapper

Contenedor para un identificador de recurso de ARM

ArmPlan

El objeto de plan de Azure Resource Manager representa un plan de Marketplace.

Capability

Describe las funcionalidades o características permitidas para una SKU específica.

DatabaseConnectionOverview

Introducción a la conexión de base de datos de sitio estático.

DefaultErrorResponse

App Service respuesta de error.

Details
EnterpriseGradeCdnStatus

Estado que indica el estado de la red CDN de nivel empresarial que atiende el tráfico a la aplicación web estática.

Error

Modelo de error.

ErrorEntity

Cuerpo de la respuesta de error devuelta desde la API.

ManagedServiceIdentity

Identidad de servicio administrada.

ManagedServiceIdentityType

Tipo de identidad de servicio administrada.

PrivateLinkConnectionState

Estado de una conexión de vínculo privado

RemotePrivateEndpointConnection

Una conexión de punto de conexión privado remoto

ResponseMessageEnvelope[RemotePrivateEndpointConnection]

Sobre de mensaje que contiene las propiedades comunes de Azure Resource Manager y el contenido específico del proveedor de recursos.

SkuCapacity

Descripción de las opciones de escalado del plan de App Service.

SkuDescription

Descripción de una SKU para un recurso escalable.

StagingEnvironmentPolicy

Estado que indica si se permiten o no entornos de ensayo para una aplicación web estática.

StaticSiteARMResource

Recurso de ARM de sitio estático.

StaticSiteBuildProperties

Cree propiedades para el sitio estático.

StaticSiteDatabaseConnectionConfigurationFileOverview

Un archivo de configuración de conexión de base de datos

StaticSiteLinkedBackend

Recurso arm de back-end vinculado de sitio estático.

StaticSitePatchResource

Recurso de ARM para un sitio estático al aplicar revisiones

StaticSiteTemplateOptions

Opciones de plantilla para el sitio estático.

StaticSiteUserProvidedFunctionApp

Función proporcionada por un usuario de sitio estático.

userAssignedIdentity

Identidad asignada por el usuario.

ArmIdWrapper

Contenedor para un identificador de recurso de ARM

Nombre Tipo Description
id

string

ArmPlan

El objeto de plan de Azure Resource Manager representa un plan de Marketplace.

Nombre Tipo Description
name

string

Nombre.

product

string

El producto.

promotionCode

string

El código de la promoción.

publisher

string

Publicador.

version

string

Versión del producto.

Capability

Describe las funcionalidades o características permitidas para una SKU específica.

Nombre Tipo Description
name

string

Nombre de la funcionalidad de SKU.

reason

string

Motivo de la funcionalidad de SKU.

value

string

Valor de la funcionalidad de SKU.

DatabaseConnectionOverview

Introducción a la conexión de base de datos de sitio estático.

Nombre Tipo Description
configurationFiles

StaticSiteDatabaseConnectionConfigurationFileOverview[]

Lista de archivos de configuración asociados a esta conexión de base de datos.

connectionIdentity

string

Si está presente, la identidad se usa junto con cadena de conexión para conectarse a la base de datos. El uso de la identidad administrada asignada por el sistema se indica con la cadena "SystemAssigned", mientras que el uso de una identidad administrada asignada por el usuario se indica con el identificador de recurso del recurso de identidad administrada.

name

string

Si está presente, el nombre de este recurso de conexión de base de datos.

region

string

Región del recurso de base de datos.

resourceId

string

Identificador de recurso de la base de datos.

DefaultErrorResponse

App Service respuesta de error.

Nombre Tipo Description
error

Error

Modelo de error.

Details

Nombre Tipo Description
code

string

Cadena estandarizada para identificar mediante programación 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.

EnterpriseGradeCdnStatus

Estado que indica el estado de la red CDN de nivel empresarial que atiende el tráfico a la aplicación web estática.

Nombre Tipo Description
Disabled

string

Disabling

string

Enabled

string

Enabling

string

Error

Modelo de error.

Nombre Tipo Description
code

string

Cadena estandarizada para identificar mediante programación el error.

details

Details[]

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.

ErrorEntity

Cuerpo de la respuesta de error devuelta desde la API.

Nombre Tipo Description
code

string

Código de error básico.

details

ErrorEntity[]

Detalles del error.

extendedCode

string

Tipo de error.

innerErrors

ErrorEntity[]

Errores internos.

message

string

Cualquier detalle del error.

messageTemplate

string

Plantilla de mensaje.

parameters

string[]

Parámetros de la plantilla.

target

string

Destino del error.

ManagedServiceIdentity

Identidad de servicio administrada.

Nombre Tipo Description
principalId

string

Identificador de entidad de seguridad de la identidad de servicio administrada.

tenantId

string

Inquilino de la identidad de servicio administrada.

type

ManagedServiceIdentityType

Tipo de identidad de servicio administrada.

userAssignedIdentities

<string,  userAssignedIdentity>

Lista de identidades asignadas por el usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}

ManagedServiceIdentityType

Tipo de identidad de servicio administrada.

Nombre Tipo Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

PrivateLinkConnectionState

Estado de una conexión de vínculo privado

Nombre Tipo Description
actionsRequired

string

ActionsRequired para una conexión de vínculo privado

description

string

Descripción de una conexión de vínculo privado

status

string

Estado de una conexión de vínculo privado

RemotePrivateEndpointConnection

Una conexión de punto de conexión privado remoto

Nombre Tipo Description
id

string

Identificador de recurso.

kind

string

Tipo de recurso.

name

string

Nombre del recurso.

properties.ipAddresses

string[]

IP privadaAddresses asignada al punto de conexión privado remoto

properties.privateEndpoint

ArmIdWrapper

PrivateEndpoint de una conexión de punto de conexión privado remoto

properties.privateLinkServiceConnectionState

PrivateLinkConnectionState

Estado de una conexión de vínculo privado

properties.provisioningState

string

type

string

Tipo de recurso.

ResponseMessageEnvelope[RemotePrivateEndpointConnection]

Sobre de mensaje que contiene las propiedades comunes de Azure Resource Manager y el contenido específico del proveedor de recursos.

Nombre Tipo Description
error

ErrorEntity

Azure-AsyncOperation Información de error.

id

string

Identificador de recurso. Normalmente, el identificador solo se rellena para las respuestas a las solicitudes GET. El autor de la llamada es responsable de pasar este valor solo para las solicitudes GET. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupId}/providers/Microsoft.Web/sites/{sitename}

identity

ManagedServiceIdentity

Recurso MSI

location

string

El recurso de región geográfica pertenece a, por ejemplo, SouthCentralUS, SouthEastAsia.

name

string

Nombre del recurso.

plan

ArmPlan

Plan de Azure Resource Manager.

properties

RemotePrivateEndpointConnection

Propiedades específicas del recurso.

sku

SkuDescription

Descripción de la SKU del recurso.

status

string

Azure-AsyncOperation Información de estado.

tags

object

Etiquetas asociadas al recurso.

type

string

Tipo de recurso, por ejemplo, "Microsoft.Web/sites".

zones

string[]

Availability Zones lógico en el que se hospeda el servicio

SkuCapacity

Descripción de las opciones de escalado del plan de App Service.

Nombre Tipo Description
default

integer

Número predeterminado de trabajos para esta SKU de plan de App Service.

elasticMaximum

integer

Número máximo de trabajos elásticos para esta SKU de plan de App Service.

maximum

integer

Número máximo de trabajos para esta SKU de plan de App Service.

minimum

integer

Número mínimo de trabajos para esta SKU de plan de App Service.

scaleType

string

Configuraciones de escala disponibles para un plan de App Service.

SkuDescription

Descripción de una SKU para un recurso escalable.

Nombre Tipo Description
capabilities

Capability[]

¿Las funcionalidades de la SKU, por ejemplo, están habilitados los administradores de tráfico?

capacity

integer

Número actual de instancias asignadas al recurso.

family

string

Código de familia de la SKU de recursos.

locations

string[]

Ubicaciones de la SKU.

name

string

Nombre de la SKU del recurso.

size

string

Especificador de tamaño de la SKU del recurso.

skuCapacity

SkuCapacity

Valores de escala mínimo, máximo y predeterminados de la SKU.

tier

string

Nivel de servicio de la SKU de recursos.

StagingEnvironmentPolicy

Estado que indica si se permiten o no entornos de ensayo para una aplicación web estática.

Nombre Tipo Description
Disabled

string

Enabled

string

StaticSiteARMResource

Recurso de ARM de sitio estático.

Nombre Tipo Description
id

string

Identificador de recurso.

identity

ManagedServiceIdentity

Identidad de servicio administrada.

kind

string

Tipo de recurso.

location

string

Ubicación del recurso.

name

string

Nombre del recurso.

properties.allowConfigFileUpdates

boolean

false si el archivo de configuración está bloqueado para esta aplicación web estática; de lo contrario, true.

properties.branch

string

Rama de destino en el repositorio.

properties.buildProperties

StaticSiteBuildProperties

Cree propiedades para configurar en el repositorio.

properties.contentDistributionEndpoint

string

Punto de conexión de distribución de contenido para el sitio estático.

properties.customDomains

string[]

Dominios personalizados asociados a este sitio estático.

properties.databaseConnections

DatabaseConnectionOverview[]

Conexiones de base de datos para el sitio estático

properties.defaultHostname

string

Nombre de host generado automáticamente predeterminado para el sitio estático.

properties.enterpriseGradeCdnStatus

EnterpriseGradeCdnStatus

Estado que indica el estado de la red CDN de nivel empresarial que atiende el tráfico a la aplicación web estática.

properties.keyVaultReferenceIdentity

string

Identidad que se va a usar para la autenticación de referencia de Key Vault.

properties.linkedBackends

StaticSiteLinkedBackend[]

Back-end vinculados al lado estático

properties.privateEndpointConnections

ResponseMessageEnvelope[RemotePrivateEndpointConnection][]

Conexiones de punto de conexión privado

properties.provider

string

Proveedor que envió la última implementación al entorno principal del sitio estático.

properties.publicNetworkAccess

string

Estado que indica si se permite o no el tráfico público para una aplicación web estática. Valores permitidos: 'Enabled', 'Disabled' o una cadena vacía.

properties.repositoryToken

string

Token del repositorio de GitHub de un usuario. Se usa para configurar el archivo de flujo de trabajo de Acciones de Github y los secretos de API.

properties.repositoryUrl

string

Dirección URL del repositorio del sitio estático.

properties.stagingEnvironmentPolicy

StagingEnvironmentPolicy

Estado que indica si se permiten o no entornos de ensayo para una aplicación web estática.

properties.templateProperties

StaticSiteTemplateOptions

Opciones de plantilla para generar un nuevo repositorio.

properties.userProvidedFunctionApps

StaticSiteUserProvidedFunctionApp[]

Aplicaciones de función proporcionadas por el usuario registradas con el sitio estático

sku

SkuDescription

Descripción de una SKU para un recurso escalable.

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso.

StaticSiteBuildProperties

Cree propiedades para el sitio estático.

Nombre Tipo Description
apiBuildCommand

string

Comando personalizado que se ejecutará durante la implementación de la aplicación de API de Azure Functions.

apiLocation

string

Ruta de acceso al código de API dentro del repositorio.

appArtifactLocation

string

En desuso: ruta de acceso de los artefactos de la aplicación después de la compilación (en desuso en favor de OutputLocation)

appBuildCommand

string

Comando personalizado que se ejecutará durante la implementación de la aplicación de contenido estático.

appLocation

string

Ruta de acceso al código de la aplicación dentro del repositorio.

githubActionSecretNameOverride

string

Invalidación del nombre del secreto de acción de Github.

outputLocation

string

Ruta de acceso de salida de la aplicación después de la compilación.

skipGithubActionWorkflowGeneration

boolean

Omita la generación del flujo de trabajo de acción de Github.

StaticSiteDatabaseConnectionConfigurationFileOverview

Un archivo de configuración de conexión de base de datos

Nombre Tipo Description
contents

string

Codificación base64 del contenido del archivo.

fileName

string

Nombre del archivo de configuración.

type

string

Tipo de archivo de configuración.

StaticSiteLinkedBackend

Recurso arm de back-end vinculado de sitio estático.

Nombre Tipo Description
backendResourceId

string

El identificador de recurso del back-end vinculado al sitio estático

createdOn

string

Fecha y hora en la que se vinculó el back-end al sitio estático.

provisioningState

string

Estado de aprovisionamiento del proceso de vinculación.

region

string

La región del back-end vinculada al sitio estático

StaticSitePatchResource

Recurso de ARM para un sitio estático al aplicar revisiones

Nombre Tipo Description
id

string

Identificador de recurso.

kind

string

Tipo de recurso.

name

string

Nombre del recurso.

properties.allowConfigFileUpdates

boolean

false si el archivo de configuración está bloqueado para esta aplicación web estática; de lo contrario, true.

properties.branch

string

Rama de destino en el repositorio.

properties.buildProperties

StaticSiteBuildProperties

Cree propiedades para configurar en el repositorio.

properties.contentDistributionEndpoint

string

Punto de conexión de distribución de contenido para el sitio estático.

properties.customDomains

string[]

Dominios personalizados asociados a este sitio estático.

properties.databaseConnections

DatabaseConnectionOverview[]

Conexiones de base de datos para el sitio estático

properties.defaultHostname

string

Nombre de host generado automáticamente predeterminado para el sitio estático.

properties.enterpriseGradeCdnStatus

EnterpriseGradeCdnStatus

Estado que indica el estado de la red CDN de nivel empresarial que atiende el tráfico a la aplicación web estática.

properties.keyVaultReferenceIdentity

string

Identidad que se va a usar para la autenticación de referencia de Key Vault.

properties.linkedBackends

StaticSiteLinkedBackend[]

Back-end vinculados al lado estático

properties.privateEndpointConnections

ResponseMessageEnvelope[RemotePrivateEndpointConnection][]

Conexiones de punto de conexión privado

properties.provider

string

Proveedor que envió la última implementación al entorno principal del sitio estático.

properties.publicNetworkAccess

string

Estado que indica si se permite o no el tráfico público para una aplicación web estática. Valores permitidos: 'Enabled', 'Disabled' o una cadena vacía.

properties.repositoryToken

string

Token del repositorio de GitHub de un usuario. Se usa para configurar el archivo de flujo de trabajo de Acciones de Github y los secretos de API.

properties.repositoryUrl

string

Dirección URL del repositorio del sitio estático.

properties.stagingEnvironmentPolicy

StagingEnvironmentPolicy

Estado que indica si se permiten o no entornos de ensayo para una aplicación web estática.

properties.templateProperties

StaticSiteTemplateOptions

Opciones de plantilla para generar un nuevo repositorio.

properties.userProvidedFunctionApps

StaticSiteUserProvidedFunctionApp[]

Aplicaciones de función proporcionadas por el usuario registradas con el sitio estático

type

string

Tipo de recurso.

StaticSiteTemplateOptions

Opciones de plantilla para el sitio estático.

Nombre Tipo Description
description

string

Descripción del repositorio recién generado.

isPrivate

boolean

Indica si el repositorio recién generado es un repositorio privado. El valor predeterminado es false (es decir, público).

owner

string

Propietario del repositorio recién generado.

repositoryName

string

Nombre del repositorio recién generado.

templateRepositoryUrl

string

Dirección URL del repositorio de plantillas. El repositorio recién generado se basará en este.

StaticSiteUserProvidedFunctionApp

Función proporcionada por un usuario de sitio estático.

Nombre Tipo Description
id

string

Identificador de recurso.

kind

string

Tipo de recurso.

name

string

Nombre del recurso.

properties.createdOn

string

Fecha y hora en la que se registró la aplicación de funciones con el sitio estático.

properties.functionAppRegion

string

Región de la aplicación de funciones registrada con el sitio estático

properties.functionAppResourceId

string

Identificador de recurso de la aplicación de funciones registrada con el sitio estático

type

string

Tipo de recurso.

userAssignedIdentity

Identidad asignada por el usuario.

Nombre Tipo Description
clientId

string

Identificador de cliente de la identidad asignada por el usuario

principalId

string

Identificador de entidad de seguridad de la identidad asignada por el usuario