Static Sites - Update Database Connection

Szolgáltatás:

App Service

API-verzió:

2025-05-01

Leírás Adatbázis-kapcsolat létrehozása vagy frissítése statikus helyhez

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
databaseConnectionName	path	True	string pattern: ^[a-zA-Z0-9]+$	Az adatbázis-kapcsolat neve.
name	path	True	string	A statikus hely neve
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem törzse

Name	Típus	Description
properties.connectionIdentity	string	Ha jelen van, az identitást a kapcsolati sztringgel együtt használja a rendszer az adatbázishoz való csatlakozáshoz. A rendszer által hozzárendelt felügyelt identitás használatát a "SystemAssigned" sztring jelzi, míg a felhasználó által hozzárendelt felügyelt identitás használata a felügyelt identitás erőforrás-azonosítójával van megjelölve.
properties.connectionString	string	Az adatbázishoz való csatlakozáshoz használandó kapcsolati sztring.
properties.region	string	Az adatbázis-erőforrás régiója.
properties.resourceId	string	Az adatbázis erőforrás-azonosítója.

Válaszok

Name	Típus	Description
200 OK	DatabaseConnection	Az Azure-művelet sikeresen befejeződött.
Other Status Codes	DefaultErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Patch a database connection for a static site

Mintakérelem

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

Mintaválasz

Állapotkód:

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

Definíciók

Name	Description
createdByType	Az erőforrást létrehozó identitás típusa.
DatabaseConnection	Statikus helyadatbázis-kapcsolat erőforrása.
DatabaseConnectionPatchRequest	Statikus helyadatbázis-kapcsolatkérelem tulajdonságai erőforrás javításkor
DefaultErrorResponse	App Service-hibaválasz.
DefaultErrorResponseError	Hibamodell.
DefaultErrorResponseErrorDetailsItem	Részletes hibák.
StaticSiteDatabaseConnectionConfigurationFileOverview	Adatbázis-kapcsolat konfigurációs fájlja
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

DatabaseConnection

Tárgy

Statikus helyadatbázis-kapcsolat erőforrása.

Name	Típus	Description
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Erőforrás típusa.
name	string	Az erőforrás neve
properties.configurationFiles	StaticSiteDatabaseConnectionConfigurationFileOverview[]	Az adatbázis-kapcsolathoz társított konfigurációs fájlok listája.
properties.connectionIdentity	string	Ha jelen van, az identitást a kapcsolati sztringgel együtt használja a rendszer az adatbázishoz való csatlakozáshoz. A rendszer által hozzárendelt felügyelt identitás használatát a "SystemAssigned" sztring jelzi, míg a felhasználó által hozzárendelt felügyelt identitás használata a felügyelt identitás erőforrás-azonosítójával van megjelölve.
properties.connectionString	string	Az adatbázishoz való csatlakozáshoz használandó kapcsolati sztring.
properties.region	string	Az adatbázis-erőforrás régiója.
properties.resourceId	string	Az adatbázis erőforrás-azonosítója.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

DatabaseConnectionPatchRequest

Tárgy

Statikus helyadatbázis-kapcsolatkérelem tulajdonságai erőforrás javításkor

Name	Típus	Description
properties.connectionIdentity	string	Ha jelen van, az identitást a kapcsolati sztringgel együtt használja a rendszer az adatbázishoz való csatlakozáshoz. A rendszer által hozzárendelt felügyelt identitás használatát a "SystemAssigned" sztring jelzi, míg a felhasználó által hozzárendelt felügyelt identitás használata a felügyelt identitás erőforrás-azonosítójával van megjelölve.
properties.connectionString	string	Az adatbázishoz való csatlakozáshoz használandó kapcsolati sztring.
properties.region	string	Az adatbázis-erőforrás régiója.
properties.resourceId	string	Az adatbázis erőforrás-azonosítója.

DefaultErrorResponse

Tárgy

App Service-hibaválasz.

Name	Típus	Description
error	DefaultErrorResponseError	Hibamodell.

DefaultErrorResponseError

Tárgy

Hibamodell.

Name	Típus	Description
code	string	Szabványosított sztring a hiba programozott azonosításához.
details	DefaultErrorResponseErrorDetailsItem[]	Részletes hibák.
innererror	string	További információ a hiba hibakereséséről.
message	string	Részletes hibaleírás és hibakeresési információk.
target	string	Részletes hibaleírás és hibakeresési információk.

DefaultErrorResponseErrorDetailsItem

Tárgy

Részletes hibák.

Name	Típus	Description
code	string	Szabványosított sztring a hiba programozott azonosításához.
message	string	Részletes hibaleírás és hibakeresési információk.
target	string	Részletes hibaleírás és hibakeresési információk.

StaticSiteDatabaseConnectionConfigurationFileOverview

Tárgy

Adatbázis-kapcsolat konfigurációs fájlja

Name	Típus	Description
contents	string	A fájl tartalmának Base64 kódolása.
fileName	string	A konfigurációs fájl neve.
type	string	A konfigurációs fájl típusa.

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.