通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Web Apps - Create Or Update Site Container

服务:
App Service
API 版本:
2025-03-01

创建或更新站点的站点容器或部署槽。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/sitecontainers/{containerName}?api-version=2025-03-01

URI 参数

名称 在 必需 类型 说明
containerName
 path True

string

pattern: (^[a-zA-Z0-9]$)|(^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]$)

站点容器名称
name
 path True

string

应用的名称。
resourceGroupName
 path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+[^\.]$

资源所属的资源组的名称。
subscriptionId
 path True

string

Azure 订阅 ID。 这是 GUID 格式的字符串（例如 000000000-0000-0000-0000-00000000000000）。
api-version
 query True

string

API 版本

请求正文

名称 必需 类型 说明
properties.image True

string

映像名称
properties.isMain True

boolean

true 如果集装箱是主站点集装箱; false 否则。
kind

string

资源类型。
properties.authType

AuthType

身份验证类型
properties.environmentVariables

EnvironmentVariable[]

环境变量列表
properties.inheritAppSettingsAndConnectionStrings

boolean

true 如果所有 AppSettings 和 ConnectionStrings 都必须作为环境变量传递给容器; false 否则。
properties.passwordSecret

string

密码密码
properties.startUpCommand

string

StartUp 命令
properties.targetPort

string

目标端口
properties.userManagedIdentityClientId

string

UserManagedIdentity 客户端 ID
properties.userName

string

用户名
properties.volumeMounts

VolumeMount[]

卷装载列表

响应

名称 类型 说明
200 OK

SiteContainer

站点容器已更新。
201 Created

SiteContainer

站点容器已创建。
Other Status Codes

DefaultErrorResponse

应用服务错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

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

作用域

名称 说明
user_impersonation 模拟用户帐户

定义

名称 说明
AuthType

身份验证类型
DefaultErrorResponse

应用服务错误响应。
Details
EnvironmentVariable
Error

错误模型。
SiteContainer

站点的容器
VolumeMount

AuthType

枚举

身份验证类型

值 说明
Anonymous
UserCredentials
SystemIdentity
UserAssigned

DefaultErrorResponse

Object

应用服务错误响应。

名称 类型 说明
error

Error

错误模型。

Details

Object
名称 类型 说明
code

string

标准化字符串，以编程方式识别错误。
message

string

详细的错误描述和调试信息。
target

string

详细的错误描述和调试信息。

EnvironmentVariable

Object
名称 类型 说明
name

string

环境变量名称
value

string

此环境变量的值必须是 AppSetting 的名称。 容器中环境变量的实际值将在运行时从指定的 AppSetting 中检索。 如果未找到 AppSetting，则在运行时将该值设置为容器中的空字符串。

Error

Object

错误模型。

名称 类型 说明
code

string

标准化字符串，以编程方式识别错误。
details

Details[]

详细错误。
innererror

string

调试错误的更多信息。
message

string

详细的错误描述和调试信息。
target

string

详细的错误描述和调试信息。

SiteContainer

Object

站点的容器

名称 类型 说明
id

string

资源 ID。
kind

string

资源类型。
name

string

资源名称。
properties.authType

AuthType

身份验证类型
properties.createdTime

string (date-time)

创建时间
properties.environmentVariables

EnvironmentVariable[]

环境变量列表
properties.image

string

映像名称
properties.inheritAppSettingsAndConnectionStrings

boolean

true 如果所有 AppSettings 和 ConnectionStrings 都必须作为环境变量传递给容器; false 否则。
properties.isMain

boolean

true 如果集装箱是主站点集装箱; false 否则。
properties.lastModifiedTime

string (date-time)

上次修改时间
properties.passwordSecret

string

密码密码
properties.startUpCommand

string

StartUp 命令
properties.targetPort

string

目标端口
properties.userManagedIdentityClientId

string

UserManagedIdentity 客户端 ID
properties.userName

string

用户名
properties.volumeMounts

VolumeMount[]

卷装载列表
type

string

资源类型。

VolumeMount

Object
名称 类型 说明
containerMountPath

string

装载卷的容器上的目标路径
data

string

配置要装载在卷上的数据
readOnly

boolean

指定装载是否在容器上为只读的布尔值
volumeSubPath

string

卷中装载卷的子路径。