Delen via


Static Sites - Update Static Site

Beschrijving voor Hiermee maakt u een nieuwe statische site in een bestaande resourcegroep of werkt u een bestaande statische site bij.

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

URI-parameters

Name In Vereist Type Description
name
path True

string

Naam van de statische site die moet worden gemaakt of bijgewerkt.

resourceGroupName
path True

string

Naam van de resourcegroep waartoe de resource behoort.

Regex-patroon: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True

string

Uw Azure-abonnements-id. Dit is een tekenreeks met GUID-indeling (bijvoorbeeld 00000000-0000-0000-0000-000000000000).

api-version
query True

string

API-versie

Aanvraagbody

Name Type Description
kind

string

Soort resource.

properties.allowConfigFileUpdates

boolean

false als het configuratiebestand is vergrendeld voor deze statische web-app; anders, true.

properties.branch

string

De doelbranch in de opslagplaats.

properties.buildProperties

StaticSiteBuildProperties

Bouweigenschappen om te configureren in de opslagplaats.

properties.enterpriseGradeCdnStatus

EnterpriseGradeCdnStatus

Status die de status aangeeft van het CDN op ondernemingsniveau dat verkeer naar de statische web-app afhandelt.

properties.provider

string

De provider die de laatste implementatie heeft verzonden naar de primaire omgeving van de statische site.

properties.publicNetworkAccess

string

Status die aangeeft of openbaar verkeer is toegestaan voor een statische web-app. Toegestane waarden: Ingeschakeld, Uitgeschakeld of een lege tekenreeks.

properties.repositoryToken

string

Het token van de github-opslagplaats van een gebruiker. Dit wordt gebruikt voor het instellen van het werkstroombestand en de API-geheimen van Github Actions.

properties.repositoryUrl

string

URL voor de opslagplaats van de statische site.

properties.stagingEnvironmentPolicy

StagingEnvironmentPolicy

Status die aangeeft of faseringsomgevingen wel of niet zijn toegestaan voor een statische web-app.

properties.templateProperties

StaticSiteTemplateOptions

Sjabloonopties voor het genereren van een nieuwe opslagplaats.

Antwoorden

Name Type Description
200 OK

StaticSiteARMResource

OK.

202 Accepted

StaticSiteARMResource

Asynchrone bewerking wordt uitgevoerd.

Other Status Codes

DefaultErrorResponse

App Service foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation uw gebruikersaccount imiteren

Voorbeelden

Patch a static site

Voorbeeldaanvraag

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

{
  "properties": {}
}

Voorbeeldrespons

{
  "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"
  }
}

Definities

Name Description
ArmIdWrapper

Een wrapper voor een ARM-resource-id

ArmPlan

Het plan-object in Azure Resource Manager vertegenwoordigt een Marketplace-plan.

Capability

Hierin worden de mogelijkheden/functies beschreven die zijn toegestaan voor een specifieke SKU.

DatabaseConnectionOverview

Overzicht van statische sitedatabaseverbinding.

DefaultErrorResponse

App Service foutreactie.

Details
EnterpriseGradeCdnStatus

Status die de status aangeeft van het CDN op ondernemingsniveau dat verkeer naar de statische web-app afhandelt.

Error

Foutmodel.

ErrorEntity

Hoofdtekst van het foutbericht dat is geretourneerd door de API.

ManagedServiceIdentity

Beheerde service-identiteit.

ManagedServiceIdentityType

Type beheerde service-identiteit.

PrivateLinkConnectionState

De status van een Private Link-verbinding

RemotePrivateEndpointConnection

Een verbinding met een extern privé-eindpunt

ResponseMessageEnvelope[RemotePrivateEndpointConnection]

Berichtenvelop met de algemene eigenschappen van Azure Resource Manager en de specifieke inhoud van de resourceprovider.

SkuCapacity

Beschrijving van de schaalopties voor App Service plannen.

SkuDescription

Beschrijving van een SKU voor een schaalbare resource.

StagingEnvironmentPolicy

Status die aangeeft of faseringsomgevingen wel of niet zijn toegestaan voor een statische web-app.

StaticSiteARMResource

ARM-resource voor statische site.

StaticSiteBuildProperties

Bouweigenschappen voor de statische site.

StaticSiteDatabaseConnectionConfigurationFileOverview

Een configuratiebestand voor een databaseverbinding

StaticSiteLinkedBackend

Arm-resource voor gekoppelde back-end van statische site.

StaticSitePatchResource

ARM-resource voor een statische site bij het patchen

StaticSiteTemplateOptions

Sjabloonopties voor de statische site.

StaticSiteUserProvidedFunctionApp

Een statische sitegebruiker heeft een functie opgegeven.

userAssignedIdentity

Door de gebruiker toegewezen identiteit.

ArmIdWrapper

Een wrapper voor een ARM-resource-id

Name Type Description
id

string

ArmPlan

Het plan-object in Azure Resource Manager vertegenwoordigt een Marketplace-plan.

Name Type Description
name

string

De naam.

product

string

Het product.

promotionCode

string

De promotiecode.

publisher

string

De uitgever.

version

string

Versie van het product.

Capability

Hierin worden de mogelijkheden/functies beschreven die zijn toegestaan voor een specifieke SKU.

Name Type Description
name

string

Naam van de SKU-mogelijkheid.

reason

string

Reden van de SKU-mogelijkheid.

value

string

Waarde van de SKU-mogelijkheid.

DatabaseConnectionOverview

Overzicht van statische sitedatabaseverbinding.

Name Type Description
configurationFiles

StaticSiteDatabaseConnectionConfigurationFileOverview[]

Een lijst met configuratiebestanden die zijn gekoppeld aan deze databaseverbinding.

connectionIdentity

string

Indien aanwezig, wordt de identiteit gebruikt in combinatie met verbindingsreeks om verbinding te maken met de database. Het gebruik van de door het systeem toegewezen beheerde identiteit wordt aangegeven met de tekenreeks 'SystemAssigned', terwijl het gebruik van een door de gebruiker toegewezen beheerde identiteit wordt aangegeven met de resource-id van de beheerde identiteitsresource.

name

string

Indien aanwezig, de naam van deze databaseverbindingsresource.

region

string

De regio van de databaseresource.

resourceId

string

De resource-id van de database.

DefaultErrorResponse

App Service foutreactie.

Name Type Description
error

Error

Foutmodel.

Details

Name Type Description
code

string

Gestandaardiseerde tekenreeks om de fout programmatisch te identificeren.

message

string

Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

target

string

Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

EnterpriseGradeCdnStatus

Status die de status aangeeft van het CDN op ondernemingsniveau dat verkeer naar de statische web-app afhandelt.

Name Type Description
Disabled

string

Disabling

string

Enabled

string

Enabling

string

Error

Foutmodel.

Name Type Description
code

string

Gestandaardiseerde tekenreeks om de fout programmatisch te identificeren.

details

Details[]

Gedetailleerde fouten.

innererror

string

Meer informatie over foutopsporing.

message

string

Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

target

string

Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

ErrorEntity

Hoofdtekst van het foutbericht dat is geretourneerd door de API.

Name Type Description
code

string

Basisfoutcode.

details

ErrorEntity[]

Foutdetails.

extendedCode

string

Type fout.

innerErrors

ErrorEntity[]

Interne fouten.

message

string

Eventuele details van de fout.

messageTemplate

string

Berichtsjabloon.

parameters

string[]

Parameters voor de sjabloon.

target

string

Het foutdoel.

ManagedServiceIdentity

Beheerde service-identiteit.

Name Type Description
principalId

string

Principal-id van beheerde service-identiteit.

tenantId

string

Tenant van beheerde service-identiteit.

type

ManagedServiceIdentityType

Type beheerde service-identiteit.

userAssignedIdentities

<string,  userAssignedIdentity>

De lijst met door de gebruiker toegewezen identiteiten die zijn gekoppeld aan de resource. De sleutelverwijzingen naar de gebruikersidentiteitswoordenlijst zijn ARM-resource-id's in de vorm: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}

ManagedServiceIdentityType

Type beheerde service-identiteit.

Name Type Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

PrivateLinkConnectionState

De status van een Private Link-verbinding

Name Type Description
actionsRequired

string

ActionsRequired for a Private Link connection (ActionsRequired for a Private Link Connection Connection)

description

string

Beschrijving van een Private Link-verbinding

status

string

Status van een Private Link-verbinding

RemotePrivateEndpointConnection

Een verbinding met een extern privé-eindpunt

Name Type Description
id

string

Resource-id.

kind

string

Soort resource.

name

string

Resourcenaam.

properties.ipAddresses

string[]

Privé-IP-adressen die zijn toegewezen aan het externe privé-eindpunt

properties.privateEndpoint

ArmIdWrapper

PrivateEndpoint van een verbinding met een extern privé-eindpunt

properties.privateLinkServiceConnectionState

PrivateLinkConnectionState

De status van een Private Link-verbinding

properties.provisioningState

string

type

string

Resourcetype.

ResponseMessageEnvelope[RemotePrivateEndpointConnection]

Berichtenvelop met de algemene eigenschappen van Azure Resource Manager en de specifieke inhoud van de resourceprovider.

Name Type Description
error

ErrorEntity

Azure-AsyncOperation foutinformatie.

id

string

Resource-id. Doorgaans wordt de id alleen ingevuld voor antwoorden op GET-aanvragen. De beller is alleen verantwoordelijk voor het doorgeven van deze waarde voor GET-aanvragen. Bijvoorbeeld: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupId}/providers/Microsoft.Web/sites/{sitename}

identity

ManagedServiceIdentity

MSI-resource

location

string

De geografische regioresource behoort bijvoorbeeld tot SouthCentralUS, SouthEastAsia.

name

string

Naam van resource.

plan

ArmPlan

Azure Resource Manager-plan.

properties

RemotePrivateEndpointConnection

Resourcespecifieke eigenschappen.

sku

SkuDescription

SKU-beschrijving van de resource.

status

string

Azure-AsyncOperation statusinformatie.

tags

object

Tags die zijn gekoppeld aan resource.

type

string

Type resource, bijvoorbeeld 'Microsoft.Web/sites'.

zones

string[]

Logische Beschikbaarheidszones de service wordt gehost in

SkuCapacity

Beschrijving van de schaalopties voor App Service plannen.

Name Type Description
default

integer

Standaardaantal werkrollen voor deze App Service plan-SKU.

elasticMaximum

integer

Maximum aantal elastische werkrollen voor deze App Service plan-SKU.

maximum

integer

Maximum aantal werkrollen voor deze App Service plan-SKU.

minimum

integer

Minimum aantal werkrollen voor deze App Service plan-SKU.

scaleType

string

Beschikbare schaalconfiguraties voor een App Service-plan.

SkuDescription

Beschrijving van een SKU voor een schaalbare resource.

Name Type Description
capabilities

Capability[]

Mogelijkheden van de SKU, bijvoorbeeld, is Traffic Manager ingeschakeld?

capacity

integer

Huidig aantal exemplaren dat is toegewezen aan de resource.

family

string

Familiecode van de resource-SKU.

locations

string[]

Locaties van de SKU.

name

string

Naam van de resource-SKU.

size

string

Grootteaanduiding van de resource-SKU.

skuCapacity

SkuCapacity

Minimum-, maximum- en standaardschaalwaarden van de SKU.

tier

string

Servicelaag van de resource-SKU.

StagingEnvironmentPolicy

Status die aangeeft of faseringsomgevingen wel of niet zijn toegestaan voor een statische web-app.

Name Type Description
Disabled

string

Enabled

string

StaticSiteARMResource

ARM-resource voor statische site.

Name Type Description
id

string

Resource-id.

identity

ManagedServiceIdentity

Beheerde service-identiteit.

kind

string

Soort resource.

location

string

Resourcelocatie.

name

string

Resourcenaam.

properties.allowConfigFileUpdates

boolean

false als het configuratiebestand is vergrendeld voor deze statische web-app; anders, true.

properties.branch

string

De doelbranch in de opslagplaats.

properties.buildProperties

StaticSiteBuildProperties

Bouweigenschappen om te configureren in de opslagplaats.

properties.contentDistributionEndpoint

string

Het eindpunt voor inhoudsdistributie voor de statische site.

properties.customDomains

string[]

De aangepaste domeinen die zijn gekoppeld aan deze statische site.

properties.databaseConnections

DatabaseConnectionOverview[]

Databaseverbindingen voor de statische site

properties.defaultHostname

string

De standaard automatisch gegenereerde hostnaam voor de statische site.

properties.enterpriseGradeCdnStatus

EnterpriseGradeCdnStatus

Status die de status aangeeft van het CDN op ondernemingsniveau dat verkeer naar de statische web-app afhandelt.

properties.keyVaultReferenceIdentity

string

Identiteit die moet worden gebruikt voor Key Vault Referentieverificatie.

properties.linkedBackends

StaticSiteLinkedBackend[]

Back-ends die zijn gekoppeld aan de statische zijde

properties.privateEndpointConnections

ResponseMessageEnvelope[RemotePrivateEndpointConnection][]

Privé-eindpuntverbindingen

properties.provider

string

De provider die de laatste implementatie heeft verzonden naar de primaire omgeving van de statische site.

properties.publicNetworkAccess

string

Status die aangeeft of openbaar verkeer is toegestaan voor een statische web-app. Toegestane waarden: Ingeschakeld, Uitgeschakeld of een lege tekenreeks.

properties.repositoryToken

string

Het token van de github-opslagplaats van een gebruiker. Dit wordt gebruikt voor het instellen van het werkstroombestand en de API-geheimen van Github Actions.

properties.repositoryUrl

string

URL voor de opslagplaats van de statische site.

properties.stagingEnvironmentPolicy

StagingEnvironmentPolicy

Status die aangeeft of faseringsomgevingen wel of niet zijn toegestaan voor een statische web-app.

properties.templateProperties

StaticSiteTemplateOptions

Sjabloonopties voor het genereren van een nieuwe opslagplaats.

properties.userProvidedFunctionApps

StaticSiteUserProvidedFunctionApp[]

Door de gebruiker verstrekte functie-apps die zijn geregistreerd bij de statische site

sku

SkuDescription

Beschrijving van een SKU voor een schaalbare resource.

tags

object

Resourcetags.

type

string

Resourcetype.

StaticSiteBuildProperties

Bouweigenschappen voor de statische site.

Name Type Description
apiBuildCommand

string

Een aangepaste opdracht die moet worden uitgevoerd tijdens de implementatie van de Azure Functions API-toepassing.

apiLocation

string

Het pad naar de API-code in de opslagplaats.

appArtifactLocation

string

Afgeschaft: het pad van de app-artefacten na het bouwen (afgeschaft ten gunste van OutputLocation)

appBuildCommand

string

Een aangepaste opdracht die moet worden uitgevoerd tijdens de implementatie van de toepassing voor statische inhoud.

appLocation

string

Het pad naar de app-code in de opslagplaats.

githubActionSecretNameOverride

string

Naam van github-actiegeheim overschrijven.

outputLocation

string

Het uitvoerpad van de app na het bouwen.

skipGithubActionWorkflowGeneration

boolean

Het genereren van github action-werkstromen overslaan.

StaticSiteDatabaseConnectionConfigurationFileOverview

Een configuratiebestand voor een databaseverbinding

Name Type Description
contents

string

De Base64-codering van de bestandsinhoud.

fileName

string

De naam van het configuratiebestand.

type

string

Het type configuratiebestand.

StaticSiteLinkedBackend

Arm-resource voor gekoppelde back-end van statische site.

Name Type Description
backendResourceId

string

De resource-id van de back-end die is gekoppeld aan de statische site

createdOn

string

De datum en tijd waarop de back-end is gekoppeld aan de statische site.

provisioningState

string

De inrichtingsstatus van het koppelingsproces.

region

string

De regio van de back-end die is gekoppeld aan de statische site

StaticSitePatchResource

ARM-resource voor een statische site bij het patchen

Name Type Description
id

string

Resource-id.

kind

string

Soort resource.

name

string

Resourcenaam.

properties.allowConfigFileUpdates

boolean

false als het configuratiebestand is vergrendeld voor deze statische web-app; anders, true.

properties.branch

string

De doelbranch in de opslagplaats.

properties.buildProperties

StaticSiteBuildProperties

Bouweigenschappen om te configureren in de opslagplaats.

properties.contentDistributionEndpoint

string

Het eindpunt voor inhoudsdistributie voor de statische site.

properties.customDomains

string[]

De aangepaste domeinen die zijn gekoppeld aan deze statische site.

properties.databaseConnections

DatabaseConnectionOverview[]

Databaseverbindingen voor de statische site

properties.defaultHostname

string

De standaard automatisch gegenereerde hostnaam voor de statische site.

properties.enterpriseGradeCdnStatus

EnterpriseGradeCdnStatus

Status die de status aangeeft van het CDN op ondernemingsniveau dat verkeer naar de statische web-app afhandelt.

properties.keyVaultReferenceIdentity

string

Identiteit die moet worden gebruikt voor Key Vault Referentieverificatie.

properties.linkedBackends

StaticSiteLinkedBackend[]

Back-ends die zijn gekoppeld aan de statische zijde

properties.privateEndpointConnections

ResponseMessageEnvelope[RemotePrivateEndpointConnection][]

Privé-eindpuntverbindingen

properties.provider

string

De provider die de laatste implementatie heeft verzonden naar de primaire omgeving van de statische site.

properties.publicNetworkAccess

string

Status die aangeeft of openbaar verkeer is toegestaan voor een statische web-app. Toegestane waarden: Ingeschakeld, Uitgeschakeld of een lege tekenreeks.

properties.repositoryToken

string

Het token van de github-opslagplaats van een gebruiker. Dit wordt gebruikt voor het instellen van het werkstroombestand en de API-geheimen van Github Actions.

properties.repositoryUrl

string

URL voor de opslagplaats van de statische site.

properties.stagingEnvironmentPolicy

StagingEnvironmentPolicy

Status die aangeeft of faseringsomgevingen wel of niet zijn toegestaan voor een statische web-app.

properties.templateProperties

StaticSiteTemplateOptions

Sjabloonopties voor het genereren van een nieuwe opslagplaats.

properties.userProvidedFunctionApps

StaticSiteUserProvidedFunctionApp[]

Door de gebruiker verstrekte functie-apps die zijn geregistreerd bij de statische site

type

string

Resourcetype.

StaticSiteTemplateOptions

Sjabloonopties voor de statische site.

Name Type Description
description

string

Beschrijving van de zojuist gegenereerde opslagplaats.

isPrivate

boolean

Of de zojuist gegenereerde opslagplaats een privéopslagplaats is of niet. Standaard ingesteld op false (openbaar).

owner

string

Eigenaar van de zojuist gegenereerde opslagplaats.

repositoryName

string

Naam van de zojuist gegenereerde opslagplaats.

templateRepositoryUrl

string

URL van de sjabloonopslagplaats. De zojuist gegenereerde opslagplaats wordt op deze opslagplaats gebaseerd.

StaticSiteUserProvidedFunctionApp

Een statische sitegebruiker heeft een functie opgegeven.

Name Type Description
id

string

Resource-id.

kind

string

Soort resource.

name

string

Resourcenaam.

properties.createdOn

string

De datum en tijd waarop de functie-app is geregistreerd bij de statische site.

properties.functionAppRegion

string

De regio van de functie-app die is geregistreerd bij de statische site

properties.functionAppResourceId

string

De resource-id van de functie-app die is geregistreerd bij de statische site

type

string

Resourcetype.

userAssignedIdentity

Door de gebruiker toegewezen identiteit.

Name Type Description
clientId

string

Client-id van door de gebruiker toegewezen identiteit

principalId

string

Principal-id van door de gebruiker toegewezen identiteit