Static Sites - Create Or Update Static Site Build App Settings

Service:

App Service

Version d'API:

2025-05-01

Description pour Créer ou mettre à jour les paramètres d’application d’une build de site statique.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/config/appsettings?api-version=2025-05-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
environmentName	path	True	string pattern: ^[a-zA-Z0-9]+$	Identificateur de site intermédiaire.
name	path	True	string	Nom du site statique.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
kind	string	Type de ressource.
properties	object	Paramètres.

Réponses

Nom	Type	Description
200 OK	StringDictionary	L’opération Azure s’est terminée avec succès.
Other Status Codes	DefaultErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Creates or updates the function app settings of a static site build.

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/staticSites/testStaticSite0/builds/12/config/appsettings?api-version=2025-05-01

{
  "properties": {
    "setting1": "someval",
    "setting2": "someval2"
  }
}

Java

import com.azure.resourcemanager.appservice.fluent.models.StringDictionaryInner;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for StaticSites CreateOrUpdateStaticSiteBuildAppSettings.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-05-01/CreateOrUpdateStaticSiteBuildAppSettings.json
     */
    /**
     * Sample code: Creates or updates the function app settings of a static site build.
     * 
     * @param manager Entry point to AppServiceManager.
     */
    public static void createsOrUpdatesTheFunctionAppSettingsOfAStaticSiteBuild(
        com.azure.resourcemanager.appservice.AppServiceManager manager) {
        manager.serviceClient().getStaticSites().createOrUpdateStaticSiteBuildAppSettingsWithResponse("rg",
            "testStaticSite0", "12",
            new StringDictionaryInner().withProperties(mapOf("setting1", "someval", "setting2", "someval2")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

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/azcore/to"
	"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/CreateOrUpdateStaticSiteBuildAppSettings.json
func ExampleStaticSitesClient_CreateOrUpdateStaticSiteBuildAppSettings() {
	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().CreateOrUpdateStaticSiteBuildAppSettings(ctx, "rg", "testStaticSite0", "12", armappservice.StringDictionary{
		Properties: map[string]*string{
			"setting1": to.Ptr("someval"),
			"setting2": to.Ptr("someval2"),
		},
	}, 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.StaticSitesClientCreateOrUpdateStaticSiteBuildAppSettingsResponse{
	// 	StringDictionary: &armappservice.StringDictionary{
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/staticSites/testStaticSite0/builds/12/config/appSettings"),
	// 		Properties: map[string]*string{
	// 			"setting1": to.Ptr("someval"),
	// 			"setting2": to.Ptr("someval2"),
	// 		},
	// 	},
	// }
}

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

Exemple de réponse

Code d’état:

200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.Web/staticSites/testStaticSite0/builds/12/config/appSettings",
  "properties": {
    "setting1": "someval",
    "setting2": "someval2"
  }
}

Définitions

Nom	Description
DefaultErrorResponse	Réponse d’erreur App Service.
DefaultErrorResponseError	Modèle d’erreur.
DefaultErrorResponseErrorDetailsItem	Erreurs détaillées.
StringDictionary	Ressource de dictionnaire de chaînes.

DefaultErrorResponse

Objet

Réponse d’erreur App Service.

Nom	Type	Description
error	DefaultErrorResponseError	Modèle d’erreur.

DefaultErrorResponseError

Objet

Modèle d’erreur.

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
details	DefaultErrorResponseErrorDetailsItem[]	Erreurs détaillées.
innererror	string	Plus d’informations pour déboguer l’erreur.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

DefaultErrorResponseErrorDetailsItem

Objet

Erreurs détaillées.

Nom	Type	Description
code	string	Chaîne standardisée pour identifier l’erreur par programmation.
message	string	Description détaillée de l’erreur et informations de débogage.
target	string	Description détaillée de l’erreur et informations de débogage.

StringDictionary

Objet

Ressource de dictionnaire de chaînes.

Nom	Type	Description
id	string	ID de ressource.
kind	string	Type de ressource.
name	string	Nom de la ressource.
properties	object	Paramètres.
type	string	Type de ressource.