Static Sites - Update Database Connection

Tjänst:

App Service

API-version:

2025-05-01

Beskrivning för Skapa eller uppdatera en databasanslutning för en statisk plats

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
databaseConnectionName	path	True	string pattern: ^[a-zA-Z0-9]+$	Namnet på databasanslutningen.
name	path	True	string	Namnet på den statiska platsen
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
properties.connectionIdentity	string	Om den finns används identiteten tillsammans med anslutningssträngen för att ansluta till databasen. Användning av den systemtilldelade hanterade identiteten anges med strängen "SystemAssigned", medan användning av en användartilldelad hanterad identitet anges med resurs-ID för den hanterade identitetsresursen.
properties.connectionString	string	Anslutningssträngen som ska användas för att ansluta till databasen.
properties.region	string	Databasresursens region.
properties.resourceId	string	Databasens resurs-ID.

Svar

Name	Typ	Description
200 OK	DatabaseConnection	Azure-åtgärden har slutförts.
Other Status Codes	DefaultErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Patch a database connection for a static site

Exempelbegäran

HTTP

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

Java

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

Go

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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
DatabaseConnection	Anslutningsresurs för statisk platsdatabas.
DatabaseConnectionPatchRequest	Resurs för egenskaper för begäran om statisk platsdatabasanslutning vid korrigering
DefaultErrorResponse	App Service-felsvar.
DefaultErrorResponseError	Felmodell.
DefaultErrorResponseErrorDetailsItem	Detaljerade fel.
StaticSiteDatabaseConnectionConfigurationFileOverview	En konfigurationsfil för databasanslutning
systemData	Metadata som rör skapande och senaste ändring av resursen.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

DatabaseConnection

Objekt

Anslutningsresurs för statisk platsdatabas.

Name	Typ	Description
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Typ av resurs.
name	string	Namnet på resursen
properties.configurationFiles	StaticSiteDatabaseConnectionConfigurationFileOverview[]	En lista över konfigurationsfiler som är associerade med den här databasanslutningen.
properties.connectionIdentity	string	Om den finns används identiteten tillsammans med anslutningssträngen för att ansluta till databasen. Användning av den systemtilldelade hanterade identiteten anges med strängen "SystemAssigned", medan användning av en användartilldelad hanterad identitet anges med resurs-ID för den hanterade identitetsresursen.
properties.connectionString	string	Anslutningssträngen som ska användas för att ansluta till databasen.
properties.region	string	Databasresursens region.
properties.resourceId	string	Databasens resurs-ID.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

DatabaseConnectionPatchRequest

Objekt

Resurs för egenskaper för begäran om statisk platsdatabasanslutning vid korrigering

Name	Typ	Description
properties.connectionIdentity	string	Om den finns används identiteten tillsammans med anslutningssträngen för att ansluta till databasen. Användning av den systemtilldelade hanterade identiteten anges med strängen "SystemAssigned", medan användning av en användartilldelad hanterad identitet anges med resurs-ID för den hanterade identitetsresursen.
properties.connectionString	string	Anslutningssträngen som ska användas för att ansluta till databasen.
properties.region	string	Databasresursens region.
properties.resourceId	string	Databasens resurs-ID.

DefaultErrorResponse

Objekt

App Service-felsvar.

Name	Typ	Description
error	DefaultErrorResponseError	Felmodell.

DefaultErrorResponseError

Objekt

Felmodell.

Name	Typ	Description
code	string	Standardiserad sträng för att programmatiskt identifiera felet.
details	DefaultErrorResponseErrorDetailsItem[]	Detaljerade fel.
innererror	string	Mer information för att felsöka fel.
message	string	Detaljerad felbeskrivning och felsökningsinformation.
target	string	Detaljerad felbeskrivning och felsökningsinformation.

DefaultErrorResponseErrorDetailsItem

Objekt

Detaljerade fel.

Name	Typ	Description
code	string	Standardiserad sträng för att programmatiskt identifiera felet.
message	string	Detaljerad felbeskrivning och felsökningsinformation.
target	string	Detaljerad felbeskrivning och felsökningsinformation.

StaticSiteDatabaseConnectionConfigurationFileOverview

Objekt

En konfigurationsfil för databasanslutning

Name	Typ	Description
contents	string	Base64-kodningen av filinnehållet.
fileName	string	Namnet på konfigurationsfilen.
type	string	Typ av konfigurationsfil.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.