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

Microsoft.AzureStackHCI 网络接口 2025-04-01-preview

Bicep 资源定义

可以使用目标作部署 networkInterfaces 资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.AzureStackHCI/networkInterfaces 资源,请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.AzureStackHCI/networkInterfaces@2025-04-01-preview' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    createFromLocal: bool
    dnsSettings: {
      dnsServers: [
        'string'
      ]
    }
    ipConfigurations: [
      {
        name: 'string'
        properties: {
          privateIPAddress: 'string'
          subnet: {
            id: 'string'
          }
        }
      }
    ]
    macAddress: 'string'
    networkSecurityGroup: {
      id: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

属性值

Microsoft.AzureStackHCI/networkInterfaces

名字 说明 价值
extendedLocation 资源的 extendedLocation。 扩展位置
位置 资源所在的地理位置 string (必需)
姓名 资源名称 字符串

约束:
模式 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$ (必需)
性能 此资源的资源特定属性。 NetworkInterface属性
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记

扩展位置

名字 说明 价值
姓名 扩展位置的名称。 字符串
类型 扩展位置的类型。 “CustomLocation”

接口DNSSettings

名字 说明 价值
dns服务器 接口的 DNS 服务器 IP 地址列表 字符串[]

IPConfiguration

名字 说明 价值
姓名 名称 - 资源组中唯一的资源的名称。 此名称可用于访问资源。 字符串

约束:
图案 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$
性能 IP 配置的 InterfaceIPConfigurationPropertiesFormat 属性。 IPConfigurationProperties

IPConfigurationProperties

名字 说明 价值
privateIPAddress 地址 PrivateIPAddress - IP 配置的专用 IP 地址。 字符串
子网 子网 - 绑定到 IP 配置的子网的名称。 LogicalNetworkArmReference (逻辑网络Arm引用)

LogicalNetworkArmReference (逻辑网络Arm引用)

名字 说明 价值
身份证 逻辑网络的 ARM ID。 字符串

NetworkInterface属性

名字 说明 价值
createFromLocal 指示这是现有的本地网络接口还是应创建本地网络接口的布尔值。 布尔
dns设置 接口的 DNS 设置 接口DNSSettings
ip配置 IPConfigurations - 网络接口的 IPConfigurations 列表。 IPConfiguration[]
mac地址 MacAddress - 网络接口的 MAC 地址。 字符串
networkSecurityGroup NetworkSecurityGroup - 附加到网络接口的网络安全组。 NetworkSecurityGroupArmReference (网络安全组Arm参考)

NetworkSecurityGroupArmReference (网络安全组Arm参考)

名字 说明 价值
身份证 网络安全组的 ARM ID。 字符串

TrackedResourceTags

名字 说明 价值

用法示例

Azure 验证模块

以下 Azure 验证模块 可用于部署此资源类型。

模块 说明
Azure Stack HCI 网络接口 Azure Stack HCI 网络接口的 AVM 资源模块

Azure 快速入门示例

以下 Azure 快速入门模板 包含用于部署此资源类型的 Bicep 示例。

Bicep 文件 说明
从 Azure Stack HCI 上的库映像创建 Linux VM 此模板基于 Azure Stack HCI 版本 23H2+ 上引用的自定义映像创建简单的 Linux VM
从 Azure Stack HCI 上引用的映像创建 VM 此模板基于 Azure Stack HCI 版本 23H2+ 上引用的 Azure 市场映像创建简单的 Windows VM

ARM 模板资源定义

可以使用目标作部署 networkInterfaces 资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.AzureStackHCI/networkInterfaces 资源,请将以下 JSON 添加到模板。

{
  "type": "Microsoft.AzureStackHCI/networkInterfaces",
  "apiVersion": "2025-04-01-preview",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "createFromLocal": "bool",
    "dnsSettings": {
      "dnsServers": [ "string" ]
    },
    "ipConfigurations": [
      {
        "name": "string",
        "properties": {
          "privateIPAddress": "string",
          "subnet": {
            "id": "string"
          }
        }
      }
    ],
    "macAddress": "string",
    "networkSecurityGroup": {
      "id": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

属性值

Microsoft.AzureStackHCI/networkInterfaces

名字 说明 价值
apiVersion API 版本 “2025-04-01-预览”
extendedLocation 资源的 extendedLocation。 扩展位置
位置 资源所在的地理位置 string (必需)
姓名 资源名称 字符串

约束:
模式 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$ (必需)
性能 此资源的资源特定属性。 NetworkInterface属性
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记
类型 资源类型 “Microsoft.AzureStackHCI/networkInterfaces”

扩展位置

名字 说明 价值
姓名 扩展位置的名称。 字符串
类型 扩展位置的类型。 “CustomLocation”

接口DNSSettings

名字 说明 价值
dns服务器 接口的 DNS 服务器 IP 地址列表 字符串[]

IPConfiguration

名字 说明 价值
姓名 名称 - 资源组中唯一的资源的名称。 此名称可用于访问资源。 字符串

约束:
图案 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$
性能 IP 配置的 InterfaceIPConfigurationPropertiesFormat 属性。 IPConfigurationProperties

IPConfigurationProperties

名字 说明 价值
privateIPAddress 地址 PrivateIPAddress - IP 配置的专用 IP 地址。 字符串
子网 子网 - 绑定到 IP 配置的子网的名称。 LogicalNetworkArmReference (逻辑网络Arm引用)

LogicalNetworkArmReference (逻辑网络Arm引用)

名字 说明 价值
身份证 逻辑网络的 ARM ID。 字符串

NetworkInterface属性

名字 说明 价值
createFromLocal 指示这是现有的本地网络接口还是应创建本地网络接口的布尔值。 布尔
dns设置 接口的 DNS 设置 接口DNSSettings
ip配置 IPConfigurations - 网络接口的 IPConfigurations 列表。 IPConfiguration[]
mac地址 MacAddress - 网络接口的 MAC 地址。 字符串
networkSecurityGroup NetworkSecurityGroup - 附加到网络接口的网络安全组。 NetworkSecurityGroupArmReference (网络安全组Arm参考)

NetworkSecurityGroupArmReference (网络安全组Arm参考)

名字 说明 价值
身份证 网络安全组的 ARM ID。 字符串

TrackedResourceTags

名字 说明 价值

用法示例

Azure 快速入门模板

以下 Azure 快速入门模板 部署此资源类型。

模板 说明
从 Azure Stack HCI 上的库映像创建 Linux VM

部署到 Azure
此模板基于 Azure Stack HCI 版本 23H2+ 上引用的自定义映像创建简单的 Linux VM
从 Azure Stack HCI 上引用的映像创建 VM

部署到 Azure
此模板基于 Azure Stack HCI 版本 23H2+ 上引用的 Azure 市场映像创建简单的 Windows VM

Terraform (AzAPI 提供程序)资源定义

可以使用目标作部署 networkInterfaces 资源类型:

  • 资源组

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.AzureStackHCI/networkInterfaces 资源,请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.AzureStackHCI/networkInterfaces@2025-04-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      createFromLocal = bool
      dnsSettings = {
        dnsServers = [
          "string"
        ]
      }
      ipConfigurations = [
        {
          name = "string"
          properties = {
            privateIPAddress = "string"
            subnet = {
              id = "string"
            }
          }
        }
      ]
      macAddress = "string"
      networkSecurityGroup = {
        id = "string"
      }
    }
  }
}

属性值

Microsoft.AzureStackHCI/networkInterfaces

名字 说明 价值
extendedLocation 资源的 extendedLocation。 扩展位置
位置 资源所在的地理位置 string (必需)
姓名 资源名称 字符串

约束:
模式 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,62}[a-zA-Z0-9]$ (必需)
性能 此资源的资源特定属性。 NetworkInterface属性
标签 资源标记 标记名称和值的字典。
类型 资源类型 “Microsoft.AzureStackHCI/networkInterfaces@2025-04-01-preview”

扩展位置

名字 说明 价值
姓名 扩展位置的名称。 字符串
类型 扩展位置的类型。 “CustomLocation”

接口DNSSettings

名字 说明 价值
dns服务器 接口的 DNS 服务器 IP 地址列表 字符串[]

IPConfiguration

名字 说明 价值
姓名 名称 - 资源组中唯一的资源的名称。 此名称可用于访问资源。 字符串

约束:
图案 = ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-._a-zA-Z0-9]{0,78}[_a-zA-Z0-9]$
性能 IP 配置的 InterfaceIPConfigurationPropertiesFormat 属性。 IPConfigurationProperties

IPConfigurationProperties

名字 说明 价值
privateIPAddress 地址 PrivateIPAddress - IP 配置的专用 IP 地址。 字符串
子网 子网 - 绑定到 IP 配置的子网的名称。 LogicalNetworkArmReference (逻辑网络Arm引用)

LogicalNetworkArmReference (逻辑网络Arm引用)

名字 说明 价值
身份证 逻辑网络的 ARM ID。 字符串

NetworkInterface属性

名字 说明 价值
createFromLocal 指示这是现有的本地网络接口还是应创建本地网络接口的布尔值。 布尔
dns设置 接口的 DNS 设置 接口DNSSettings
ip配置 IPConfigurations - 网络接口的 IPConfigurations 列表。 IPConfiguration[]
mac地址 MacAddress - 网络接口的 MAC 地址。 字符串
networkSecurityGroup NetworkSecurityGroup - 附加到网络接口的网络安全组。 NetworkSecurityGroupArmReference (网络安全组Arm参考)

NetworkSecurityGroupArmReference (网络安全组Arm参考)

名字 说明 价值
身份证 网络安全组的 ARM ID。 字符串

TrackedResourceTags

名字 说明 价值