Static Sites - Update Database Connection

Usługa:: App Service

Wersja interfejsu API:: 2025-05-01

Opis tworzenia lub aktualizowania połączenia z bazą danych dla lokacji statycznej

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseConnectionName	path	True	string pattern: ^[a-zA-Z0-9]+$	Nazwa połączenia z bazą danych.
name	path	True	string	Nazwa witryny statycznej
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
properties.connectionIdentity	string	Jeśli istnieje, tożsamość jest używana w połączeniu z parametrami połączenia w celu nawiązania połączenia z bazą danych. Użycie tożsamości zarządzanej przypisanej przez system jest wskazywane za pomocą ciągu "SystemAssigned", podczas gdy użycie tożsamości zarządzanej przypisanej przez użytkownika jest wskazywane przy użyciu identyfikatora zasobu tożsamości zarządzanej.
properties.connectionString	string	Parametry połączenia używane do nawiązywania połączenia z bazą danych.
properties.region	string	Region zasobu bazy danych.
properties.resourceId	string	Identyfikator zasobu bazy danych.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DatabaseConnection	Operacja platformy Azure została ukończona pomyślnie.
Other Status Codes	DefaultErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Patch a database connection for a static site

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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"
  }
}

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
DatabaseConnection	Zasób Statyczne połączenie z bazą danych lokacji.
DatabaseConnectionPatchRequest	Zasób Właściwości żądania połączenia z bazą danych lokacji statycznej podczas stosowania poprawek
DefaultErrorResponse	Odpowiedź na błąd usługi App Service.
DefaultErrorResponseError	Model błędu.
DefaultErrorResponseErrorDetailsItem	Szczegółowe błędy.
StaticSiteDatabaseConnectionConfigurationFileOverview	Plik konfiguracyjny połączenia z bazą danych
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

DatabaseConnection

Objekt

Zasób Statyczne połączenie z bazą danych lokacji.

Nazwa	Typ	Opis
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Rodzaj zasobu.
name	string	Nazwa zasobu
properties.configurationFiles	StaticSiteDatabaseConnectionConfigurationFileOverview[]	Lista plików konfiguracyjnych skojarzonych z tym połączeniem z bazą danych.
properties.connectionIdentity	string	Jeśli istnieje, tożsamość jest używana w połączeniu z parametrami połączenia w celu nawiązania połączenia z bazą danych. Użycie tożsamości zarządzanej przypisanej przez system jest wskazywane za pomocą ciągu "SystemAssigned", podczas gdy użycie tożsamości zarządzanej przypisanej przez użytkownika jest wskazywane przy użyciu identyfikatora zasobu tożsamości zarządzanej.
properties.connectionString	string	Parametry połączenia używane do nawiązywania połączenia z bazą danych.
properties.region	string	Region zasobu bazy danych.
properties.resourceId	string	Identyfikator zasobu bazy danych.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

DatabaseConnectionPatchRequest

Objekt

Zasób Właściwości żądania połączenia z bazą danych lokacji statycznej podczas stosowania poprawek

Nazwa	Typ	Opis
properties.connectionIdentity	string	Jeśli istnieje, tożsamość jest używana w połączeniu z parametrami połączenia w celu nawiązania połączenia z bazą danych. Użycie tożsamości zarządzanej przypisanej przez system jest wskazywane za pomocą ciągu "SystemAssigned", podczas gdy użycie tożsamości zarządzanej przypisanej przez użytkownika jest wskazywane przy użyciu identyfikatora zasobu tożsamości zarządzanej.
properties.connectionString	string	Parametry połączenia używane do nawiązywania połączenia z bazą danych.
properties.region	string	Region zasobu bazy danych.
properties.resourceId	string	Identyfikator zasobu bazy danych.

DefaultErrorResponse

Objekt

Odpowiedź na błąd usługi App Service.

Nazwa	Typ	Opis
error	DefaultErrorResponseError	Model błędu.

DefaultErrorResponseError

Objekt

Model błędu.

Nazwa	Typ	Opis
code	string	Ustandaryzowany ciąg do programowej identyfikacji błędu.
details	DefaultErrorResponseErrorDetailsItem[]	Szczegółowe błędy.
innererror	string	Więcej informacji na temat debugowania błędu.
message	string	Szczegółowy opis błędu i informacje o debugowaniu.
target	string	Szczegółowy opis błędu i informacje o debugowaniu.

DefaultErrorResponseErrorDetailsItem

Objekt

Szczegółowe błędy.

Nazwa	Typ	Opis
code	string	Ustandaryzowany ciąg do programowej identyfikacji błędu.
message	string	Szczegółowy opis błędu i informacje o debugowaniu.
target	string	Szczegółowy opis błędu i informacje o debugowaniu.

StaticSiteDatabaseConnectionConfigurationFileOverview

Objekt

Plik konfiguracyjny połączenia z bazą danych

Nazwa	Typ	Opis
contents	string	Kodowanie Base64 zawartości pliku.
fileName	string	Nazwa pliku konfiguracyjnego.
type	string	Typ pliku konfiguracyjnego.

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Udostępnij za pośrednictwem

Static Sites - Update Database Connection

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Patch a database connection for a static site

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

createdByType

DatabaseConnection

DatabaseConnectionPatchRequest

DefaultErrorResponse

DefaultErrorResponseError

DefaultErrorResponseErrorDetailsItem

StaticSiteDatabaseConnectionConfigurationFileOverview

systemData