Static Sites - Create Or Update Static Site Build App Settings

Dienst:

App Service

API-Version:

2025-05-01

Beschreibung für "Erstellt" oder aktualisiert die App-Einstellungen eines statischen Websitebuilds.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
environmentName	path	True	string pattern: ^[a-zA-Z0-9]+$	Die Phasenwebsite-ID.
name	path	True	string	Name der statischen Website.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name	Typ	Beschreibung
kind	string	Art der Ressource.
properties	object	Einstellungen.

Antworten

Name	Typ	Beschreibung
200 OK	StringDictionary	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	DefaultErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

200

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

Definitionen

Name	Beschreibung
DefaultErrorResponse	Fehlerantwort des App-Diensts.
DefaultErrorResponseError	Fehlermodell.
DefaultErrorResponseErrorDetailsItem	Detaillierte Fehler.
StringDictionary	Ressource für das Zeichenfolgenwörterbuch.

DefaultErrorResponse

Objekt

Fehlerantwort des App-Diensts.

Name	Typ	Beschreibung
error	DefaultErrorResponseError	Fehlermodell.

DefaultErrorResponseError

Objekt

Fehlermodell.

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers.
details	DefaultErrorResponseErrorDetailsItem[]	Detaillierte Fehler.
innererror	string	Weitere Informationen zum Debuggen von Fehlern.
message	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.
target	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.

DefaultErrorResponseErrorDetailsItem

Objekt

Detaillierte Fehler.

Name	Typ	Beschreibung
code	string	Standardisierte Zeichenfolge zur programmgesteuerten Identifizierung des Fehlers.
message	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.
target	string	Detaillierte Fehlerbeschreibung und Informationen zum Debuggen.

StringDictionary

Objekt

Ressource für das Zeichenfolgenwörterbuch.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
kind	string	Art der Ressource.
name	string	Ressourcenname.
properties	object	Einstellungen.
type	string	Ressourcentyp.