Static Sites - Create Or Update Static Site Build App Settings

服务:

App Service

API 版本:

2026-07-15

有关创建或更新静态站点生成的应用设置的说明。

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

URI 参数

名称	在	必需	类型	说明
environmentName	path	True	string pattern: ^[a-zA-Z0-9]+$	阶段站点标识符。
name	path	True	string	静态站点的名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。 此名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。 该值必须是 UUID。
api-version	query	True	string minLength: 1	用于此操作的 API 版本。

请求正文

名称	类型	说明
kind	string	资源类型。
properties	object	设置。

响应

名称	类型	说明
200 OK	StringDictionary	Azure 运营顺利完成。
Other Status Codes	DefaultErrorResponse	未预期的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流程。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	冒充您的用户账户

示例

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

示例请求

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=2026-07-15

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

示例响应

状态代码:

200

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

定义

名称	说明
DefaultErrorResponse	应用服务错误响应。
DefaultErrorResponseError	错误模型。
DefaultErrorResponseErrorDetailsItem	详细错误。
StringDictionary	字符串字典资源。

DefaultErrorResponse

对象

应用服务错误响应。

名称	类型	说明
error	DefaultErrorResponseError	错误模型。

DefaultErrorResponseError

对象

错误模型。

名称	类型	说明
code	string	标准化字符串，以编程方式识别错误。
details	DefaultErrorResponseErrorDetailsItem[]	详细错误。
innererror	string	调试错误的更多信息。
message	string	详细的错误描述和调试信息。
target	string	详细的错误描述和调试信息。

DefaultErrorResponseErrorDetailsItem

对象

详细错误。

名称	类型	说明
code	string	标准化字符串，以编程方式识别错误。
message	string	详细的错误描述和调试信息。
target	string	详细的错误描述和调试信息。

StringDictionary

对象

字符串字典资源。

名称	类型	说明
id	string	资源 ID。
kind	string	资源类型。
name	string	资源名称。
properties	object	设置。
type	string	资源类型。