Static Sites - Update Database Connection

Serviço:: App Service

Versão da API:: 2025-05-01

Descrição para Criar ou atualizar uma conexão de banco de dados para um site estático

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
databaseConnectionName	path	True	string pattern: ^[a-zA-Z0-9]+$	Nome da conexão do banco de dados.
name	path	True	string	Nome do site estático
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Tipo	Description
properties.connectionIdentity	string	Se presente, a identidade é usada em conjunto com a cadeia de conexão para se conectar ao banco de dados. O uso da identidade gerenciada atribuída ao sistema é indicado com a cadeia de caracteres 'SystemAssigned', enquanto o uso de uma identidade gerenciada atribuída pelo usuário é indicado com a id do recurso de identidade gerenciada.
properties.connectionString	string	A cadeia de conexão a ser usada para se conectar ao banco de dados.
properties.region	string	A região do recurso de banco de dados.
properties.resourceId	string	A id do recurso do banco de dados.

Respostas

Name	Tipo	Description
200 OK	DatabaseConnection	Operação do Azure concluída com êxito.
Other Status Codes	DefaultErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Patch a database connection for a static site

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Definições

Name	Description
createdByType	O tipo de identidade que criou o recurso.
DatabaseConnection	Recurso de Conexão de Banco de Dados de Site Estático.
DatabaseConnectionPatchRequest	Recurso Propriedades de Solicitação de Conexão de Banco de Dados de Site Estático ao aplicar patches
DefaultErrorResponse	Resposta de erro do Serviço de Aplicativo.
DefaultErrorResponseError	Modelo de erro.
DefaultErrorResponseErrorDetailsItem	Erros detalhados.
StaticSiteDatabaseConnectionConfigurationFileOverview	Um arquivo de configuração de conexão de banco de dados
systemData	Metadados referentes à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DatabaseConnection

Object

Recurso de Conexão de Banco de Dados de Site Estático.

Name	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Tipo de recurso.
name	string	O nome do recurso
properties.configurationFiles	StaticSiteDatabaseConnectionConfigurationFileOverview[]	Uma lista de arquivos de configuração associados a essa conexão de banco de dados.
properties.connectionIdentity	string	Se presente, a identidade é usada em conjunto com a cadeia de conexão para se conectar ao banco de dados. O uso da identidade gerenciada atribuída ao sistema é indicado com a cadeia de caracteres 'SystemAssigned', enquanto o uso de uma identidade gerenciada atribuída pelo usuário é indicado com a id do recurso de identidade gerenciada.
properties.connectionString	string	A cadeia de conexão a ser usada para se conectar ao banco de dados.
properties.region	string	A região do recurso de banco de dados.
properties.resourceId	string	A id do recurso do banco de dados.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

DatabaseConnectionPatchRequest

Object

Recurso Propriedades de Solicitação de Conexão de Banco de Dados de Site Estático ao aplicar patches

Name	Tipo	Description
properties.connectionIdentity	string	Se presente, a identidade é usada em conjunto com a cadeia de conexão para se conectar ao banco de dados. O uso da identidade gerenciada atribuída ao sistema é indicado com a cadeia de caracteres 'SystemAssigned', enquanto o uso de uma identidade gerenciada atribuída pelo usuário é indicado com a id do recurso de identidade gerenciada.
properties.connectionString	string	A cadeia de conexão a ser usada para se conectar ao banco de dados.
properties.region	string	A região do recurso de banco de dados.
properties.resourceId	string	A id do recurso do banco de dados.

DefaultErrorResponse

Object

Resposta de erro do Serviço de Aplicativo.

Name	Tipo	Description
error	DefaultErrorResponseError	Modelo de erro.

DefaultErrorResponseError

Object

Modelo de erro.

Name	Tipo	Description
code	string	String padronizada para identificar programaticamente o erro.
details	DefaultErrorResponseErrorDetailsItem[]	Erros detalhados.
innererror	string	Mais informações para depurar erro.
message	string	Descrição detalhada do erro e informações de depuração.
target	string	Descrição detalhada do erro e informações de depuração.

DefaultErrorResponseErrorDetailsItem

Object

Erros detalhados.

Name	Tipo	Description
code	string	String padronizada para identificar programaticamente o erro.
message	string	Descrição detalhada do erro e informações de depuração.
target	string	Descrição detalhada do erro e informações de depuração.

StaticSiteDatabaseConnectionConfigurationFileOverview

Object

Um arquivo de configuração de conexão de banco de dados

Name	Tipo	Description
contents	string	A codificação Base64 do conteúdo do arquivo.
fileName	string	O nome do arquivo de configuração.
type	string	O tipo de arquivo de configuração.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Partilhar via

Static Sites - Update Database Connection

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Patch a database connection for a static site

Pedido de amostra

Resposta da amostra

Definições

createdByType

DatabaseConnection

DatabaseConnectionPatchRequest

DefaultErrorResponse

DefaultErrorResponseError

DefaultErrorResponseErrorDetailsItem

StaticSiteDatabaseConnectionConfigurationFileOverview

systemData