Static Sites - Update Database Connection

Service:: App Service

API-versie:: 2025-05-01

Beschrijving voor Een databaseverbinding maken of bijwerken voor een statische site

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

URI-parameters

Name	In	Vereist	Type	Description
databaseConnectionName	path	True	string pattern: ^[a-zA-Z0-9]+$	Naam van de databaseverbinding.
name	path	True	string	Naam van de statische site
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
properties.connectionIdentity	string	Indien aanwezig, wordt de identiteit gebruikt in combinatie met de 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.
properties.connectionString	string	De verbindingsreeks die moet worden gebruikt om verbinding te maken met de database.
properties.region	string	De regio van de databaseresource.
properties.resourceId	string	De resource-id van de database.

Antwoorden

Name	Type	Description
200 OK	DatabaseConnection	Azure-bewerking is voltooid.
Other Status Codes	DefaultErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

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

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Patch a database connection for a static site

Voorbeeldaanvraag

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

{
  "properties": {}
}


import com.azure.resourcemanager.appservice.models.DatabaseConnectionPatchRequest;

/**
 * Samples for StaticSites UpdateDatabaseConnection.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-05-01/PatchStaticSiteDatabaseConnection.json
     */
    /**
     * Sample code: Patch a database connection for a static site.
     * 
     * @param manager Entry point to AppServiceManager.
     */
    public static void
        patchADatabaseConnectionForAStaticSite(com.azure.resourcemanager.appservice.AppServiceManager manager) {
        manager.serviceClient().getStaticSites().updateDatabaseConnectionWithResponse("rg", "testStaticSite0",
            "default", new DatabaseConnectionPatchRequest(), com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armappservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appservice/armappservice/v6"
)

// Generated from example definition: 2025-05-01/PatchStaticSiteDatabaseConnection.json
func ExampleStaticSitesClient_UpdateDatabaseConnection() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappservice.NewClientFactory("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewStaticSitesClient().UpdateDatabaseConnection(ctx, "rg", "testStaticSite0", "default", armappservice.DatabaseConnectionPatchRequest{
		Properties: &armappservice.DatabaseConnectionPatchRequestProperties{},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armappservice.StaticSitesClientUpdateDatabaseConnectionResponse{
	// 	DatabaseConnection: &armappservice.DatabaseConnection{
	// 		Name: to.Ptr("default"),
	// 		Type: to.Ptr("Microsoft.Web/staticSites/databaseConnections"),
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/staticSites/testStaticSite0/databaseConnections/default"),
	// 		Properties: &armappservice.DatabaseConnectionProperties{
	// 			ConnectionIdentity: to.Ptr("SystemAssigned"),
	// 			Region: to.Ptr("West US 2"),
	// 			ResourceID: to.Ptr("/subscription/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/databaseRG/providers/Microsoft.DocumentDB/databaseAccounts/exampleDatabaseName"),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:: 200

{
  "name": "default",
  "type": "Microsoft.Web/staticSites/databaseConnections",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/staticSites/testStaticSite0/databaseConnections/default",
  "properties": {
    "connectionIdentity": "SystemAssigned",
    "region": "West US 2",
    "resourceId": "/subscription/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/databaseRG/providers/Microsoft.DocumentDB/databaseAccounts/exampleDatabaseName"
  }
}

Definities

Name	Description
createdByType	Het type identiteit waarmee de resource is gemaakt.
DatabaseConnection	Bron voor statische sitedatabaseverbinding.
DatabaseConnectionPatchRequest	Bron Eigenschappen van Statische sitedatabase-verbindingsaanvraag bij het patchen
DefaultErrorResponse	Foutreactie van App Service.
DefaultErrorResponseError	Foutmodel.
DefaultErrorResponseErrorDetailsItem	Gedetailleerde fouten.
StaticSiteDatabaseConnectionConfigurationFileOverview	Een configuratiebestand voor databaseverbindingen
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DatabaseConnection

Object

Bron voor statische sitedatabaseverbinding.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
kind	string	Soort resource.
name	string	De naam van de resource
properties.configurationFiles	StaticSiteDatabaseConnectionConfigurationFileOverview[]	Een lijst met configuratiebestanden die aan deze databaseverbinding zijn gekoppeld.
properties.connectionIdentity	string	Indien aanwezig, wordt de identiteit gebruikt in combinatie met de 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.
properties.connectionString	string	De verbindingsreeks die moet worden gebruikt om verbinding te maken met de database.
properties.region	string	De regio van de databaseresource.
properties.resourceId	string	De resource-id van de database.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
type	string	Het type bron. Bijv. "Microsoft.Compute/virtualMachines" of "Microsoft.Storage/storageAccounts"

DatabaseConnectionPatchRequest

Object

Bron Eigenschappen van Statische sitedatabase-verbindingsaanvraag bij het patchen

Name	Type	Description
properties.connectionIdentity	string	Indien aanwezig, wordt de identiteit gebruikt in combinatie met de 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.
properties.connectionString	string	De verbindingsreeks die moet worden gebruikt om verbinding te maken met de database.
properties.region	string	De regio van de databaseresource.
properties.resourceId	string	De resource-id van de database.

DefaultErrorResponse

Object

Foutreactie van App Service.

Name	Type	Description
error	DefaultErrorResponseError	Foutmodel.

DefaultErrorResponseError

Object

Foutmodel.

Name	Type	Description
code	string	Gestandaardiseerde tekenreeks om de fout programmatisch te identificeren.
details	DefaultErrorResponseErrorDetailsItem[]	Gedetailleerde fouten.
innererror	string	Meer informatie om fouten op te sporen.
message	string	Gedetailleerde foutbeschrijving en foutopsporingsinformatie.
target	string	Gedetailleerde foutbeschrijving en foutopsporingsinformatie.

DefaultErrorResponseErrorDetailsItem

Object

Gedetailleerde fouten.

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.

StaticSiteDatabaseConnectionConfigurationFileOverview

Object

Een configuratiebestand voor databaseverbindingen

Name	Type	Description
contents	string	De Base64-codering van de inhoud van het bestand.
fileName	string	De naam van het configuratiebestand.
type	string	Het type configuratiebestand.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

Delen via

Static Sites - Update Database Connection

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Patch a database connection for a static site

Voorbeeldaanvraag

Voorbeeldrespons

Definities

createdByType

DatabaseConnection

DatabaseConnectionPatchRequest

DefaultErrorResponse

DefaultErrorResponseError

DefaultErrorResponseErrorDetailsItem

StaticSiteDatabaseConnectionConfigurationFileOverview

systemData