Virtual Network Subnets - Create Or Update

服务:

Azure Stack HCI

API 版本:

2026-04-01-preview

创建或更新虚拟网络子网的作。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}?api-version=2026-04-01-preview

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。 此名称不区分大小写。
subnetName	path	True	string pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$	虚拟网络子网名称
subscriptionId	path	True	string (uuid)	目标订阅的 ID。 该值必须是 UUID。
virtualNetworkName	path	True	string pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$	虚拟网络的名称
api-version	query	True	string minLength: 1	用于此作的 API 版本。

请求正文

名称	类型	说明
extendedLocation	ExtendedLocation	资源的 extendedLocation。
properties	VirtualNetworkSubnetProperties	此资源的资源特定属性。

响应

名称	类型	说明
200 OK	VirtualNetworkSubnet	资源“VirtualNetworkSubnet”更新作成功
201 Created	VirtualNetworkSubnet	资源“VirtualNetworkSubnet”创建作成功 标头 Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	意外的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流程。

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

PutVirtualNetworkSubnet

示例请求

HTTP

PUT https://management.azure.com/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/test-rg/providers/Microsoft.AzureStackHCI/virtualNetworks/test-vnet/subnets/subnet1?api-version=2026-04-01-preview

{
  "properties": {
    "addressPrefix": "10.0.0.0/28"
  }
}

示例响应

状态代码:

200

{
  "name": "subnet",
  "type": "Microsoft.AzureStackHCI/virtualNetworks/subnets",
  "extendedLocation": {
    "name": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/virtualNetworks/test-vnet/subnets/subnet1",
  "properties": {
    "addressPrefix": "10.0.0.0/28",
    "provisioningState": "Accepted"
  }
}

状态代码:

201

{
  "name": "test-vnet",
  "type": "Microsoft.AzureStackHCI/virtualNetworks",
  "extendedLocation": {
    "name": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/fd3c3665-1729-4b7b-9a38-238e83b0f98b/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/virtualNetworks/test-vnet/subnets/subnet1",
  "properties": {
    "addressPrefix": "10.0.0.0/28",
    "provisioningState": "Succeeded"
  }
}

定义

名称	说明
createdByType	创建资源的标识的类型。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ExtendedLocation	扩展位置的复杂类型。
ExtendedLocationTypes	extendedLocation 的类型。
NatGatewayArmReference	网络安全组的 ARM ID。
NetworkSecurityGroupArmReference	网络安全组的 Azure 资源 ID。
ProvisioningStateEnum	资源的预配状态。
Route	路由 - 路由资源。
RouteTable	路由表资源。
Status	对资源执行的操作的状态 [Succeeded， Failed， InProgress]
systemData	与创建和上次修改资源相关的元数据。
VirtualNetworkSubnet	虚拟网络资源定义。
VirtualNetworkSubnetIpConfigurationReference	Azure 资源 ID 用于子网上资源消耗 IP 的 IP
VirtualNetworkSubnetProperties	VirtualNetwork 子网资源
VirtualNetworkSubnetStatus	虚拟网络子网作状态
VirtualNetworkSubnetStatusProvisioningStatus	虚拟网络子网作状态

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

对象

资源管理错误附加信息。

名称	类型	说明
info	object	附加信息。
type	string	附加信息类型。

ErrorDetail

对象

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

对象

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ExtendedLocation

对象

扩展位置的复杂类型。

名称	类型	说明
name	string	扩展位置的名称。
type	ExtendedLocationTypes	扩展位置的类型。

ExtendedLocationTypes

枚举

extendedLocation 的类型。

值	说明
CustomLocation	自定义扩展位置类型

NatGatewayArmReference

对象

网络安全组的 ARM ID。

名称	类型	说明
resourceId	string (arm-id)	网络安全组的 ARM ID。

NetworkSecurityGroupArmReference

对象

网络安全组的 Azure 资源 ID。

名称	类型	说明
id	string (arm-id)	网络安全组的 Azure 资源 ID。

ProvisioningStateEnum

枚举

资源的预配状态。

值	说明
Succeeded	预配已成功
Failed	预配失败
InProgress	正在进行预配
Accepted	已接受预配
Deleting	正在删除资源
Canceled	已取消预配

Route

对象

路由 - 路由资源。

名称	类型	说明
name	string pattern: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$	名称 - 子网的名称
properties.addressPrefix	string	路由应用到的目标 CIDR。
properties.nextHopIpAddress	string	数据包应转发到的 IP 地址。 只有在下一跃点类型为 VirtualAppliance 的路由中才允许下一跃点值。

RouteTable

对象

路由表资源。

名称	类型	说明
etag	string	一个唯一的只读字符串，每当更新资源时更改。
name	string	资源名称。
properties.routes	Route[]	路由表中包含的路由的集合。
type	string	资源类型。

Status

枚举

对资源执行的操作的状态 [Succeeded， Failed， InProgress]

值	说明
Succeeded	作成功
Failed	作失败
InProgress	作正在进行中

systemData

对象

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	资源上次修改的时间戳 （UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

VirtualNetworkSubnet

对象

虚拟网络资源定义。

名称	类型	说明
extendedLocation	ExtendedLocation	资源的 extendedLocation。
id	string (arm-id)	资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	资源的名称
properties	VirtualNetworkSubnetProperties	此资源的资源特定属性。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

VirtualNetworkSubnetIpConfigurationReference

对象

Azure 资源 ID 用于子网上资源消耗 IP 的 IP

名称	类型	说明
id	string (arm-id)	网络接口的 Azure 资源 ID。

VirtualNetworkSubnetProperties

对象

VirtualNetwork 子网资源

名称	类型	说明
addressPrefix	string	子网 CIDR
ipConfigurations	VirtualNetworkSubnetIpConfigurationReference[]	子网的IP配置列表
natGateway	NatGatewayArmReference	Nat Gateway 连接到子网用于非 VNET 流量。
networkSecurityGroup	NetworkSecurityGroupArmReference	连接到子网的网络安全组。
provisioningState	ProvisioningStateEnum	虚拟网络子网资源的配置状态。
routeTable	RouteTable	路由表定义子网的自定义路由。
status	VirtualNetworkSubnetStatus	虚拟网络子网资源的观察状态。

VirtualNetworkSubnetStatus

对象

虚拟网络子网作状态

名称	类型	说明
errorCode	string	VirtualNetworkSubnet 配置错误代码
errorMessage	string	描述性错误消息
provisioningStatus	VirtualNetworkSubnetStatusProvisioningStatus	公共IP配置状态

VirtualNetworkSubnetStatusProvisioningStatus

对象

虚拟网络子网作状态

名称	类型	说明
operationId	string	虚拟网络子网执行作的ID
status	Status	虚拟网络子网执行作的状态 [成功，失败，进行中]