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

Microsoft.NetworkCloud 裸机机器 2025-02-01

Bicep 资源定义

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

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

资源格式

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

resource symbolicname 'Microsoft.NetworkCloud/bareMetalMachines@2025-02-01' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    bmcConnectionString: 'string'
    bmcCredentials: {
      password: 'string'
      username: 'string'
    }
    bmcMacAddress: 'string'
    bootMacAddress: 'string'
    machineClusterVersion: 'string'
    machineDetails: 'string'
    machineName: 'string'
    machineSkuId: 'string'
    rackId: 'string'
    rackSlot: int
    serialNumber: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

属性值

Microsoft.NetworkCloud/bareMetalMachines

名字 描述 价值
extendedLocation 与资源关联的群集的扩展位置。 ExtendedLocation (必需)
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

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

AdministrativeCredentials

名字 描述 价值
密码 初始化期间使用的设备的管理员的密码。 字符串

约束:
最小长度 = 1
敏感值。 以安全参数的形式传入。 (必需)
用户名 初始化期间使用的设备的管理员用户名。 字符串

约束:
最小长度 = 1 (必需)

BareMetalMachineProperties

名字 描述 价值
bmcConnectionString 基板管理控制器的连接字符串,包括 IP 地址和协议。 string (必需)
bmc凭证 此裸机计算机上的基板管理控制器的凭据。 AdministrativeCredentials (必需)
bmcMac地址 BMC 设备的 MAC 地址。 字符串

约束:
模式 = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必需)
bootMac地址 连接到 PXE 网络的 NIC 的 MAC 地址。 字符串

约束:
模式 = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必需)
machineClusterVersion 部署或版本更新期间已应用于此计算机的群集版本。 字符串
机器详细信息 客户提供的自定义详细信息。 字符串

约束:
最大长度 = 256 (必需)
机器名称 分配给此计算机的 OS 级主机名。 字符串

约束:
模式 = ^([a-zA-Z0-9][a-zA-Z0-9]{0,62}[a-zA-Z0-9])$ (必需)
machineSkuId 裸机 SKU 的唯一内部标识符。 string (必需)
机架 ID 此裸机所在的机架的资源 ID。 string (必需)
机架插槽 此裸机所在的机架槽,从下到下排序,即最低槽为 1。 int

约束:
最小值 = 1
最大值 = 256 (必需)
序列号 裸机的序列号。 字符串

约束:
最小长度 = 1
最大长度 = 64 (必需)

扩展位置

名字 描述 价值
名字 要在其中创建资源的扩展位置的资源 ID。 string (必需)
类型 扩展的位置类型,例如 CustomLocation。 string (必需)

TrackedResourceTags

名字 描述 价值

ARM 模板资源定义

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

用法示例

资源格式

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

{
  "type": "Microsoft.NetworkCloud/bareMetalMachines",
  "apiVersion": "2025-02-01",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "bmcConnectionString": "string",
    "bmcCredentials": {
      "password": "string",
      "username": "string"
    },
    "bmcMacAddress": "string",
    "bootMacAddress": "string",
    "machineClusterVersion": "string",
    "machineDetails": "string",
    "machineName": "string",
    "machineSkuId": "string",
    "rackId": "string",
    "rackSlot": "int",
    "serialNumber": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

属性值

Microsoft.NetworkCloud/bareMetalMachines

名字 描述 价值
apiVersion API 版本 '2025-02-01'
extendedLocation 与资源关联的群集的扩展位置。 ExtendedLocation (必需)
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

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

AdministrativeCredentials

名字 描述 价值
密码 初始化期间使用的设备的管理员的密码。 字符串

约束:
最小长度 = 1
敏感值。 以安全参数的形式传入。 (必需)
用户名 初始化期间使用的设备的管理员用户名。 字符串

约束:
最小长度 = 1 (必需)

BareMetalMachineProperties

名字 描述 价值
bmcConnectionString 基板管理控制器的连接字符串,包括 IP 地址和协议。 string (必需)
bmc凭证 此裸机计算机上的基板管理控制器的凭据。 AdministrativeCredentials (必需)
bmcMac地址 BMC 设备的 MAC 地址。 字符串

约束:
模式 = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必需)
bootMac地址 连接到 PXE 网络的 NIC 的 MAC 地址。 字符串

约束:
模式 = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必需)
machineClusterVersion 部署或版本更新期间已应用于此计算机的群集版本。 字符串
机器详细信息 客户提供的自定义详细信息。 字符串

约束:
最大长度 = 256 (必需)
机器名称 分配给此计算机的 OS 级主机名。 字符串

约束:
模式 = ^([a-zA-Z0-9][a-zA-Z0-9]{0,62}[a-zA-Z0-9])$ (必需)
machineSkuId 裸机 SKU 的唯一内部标识符。 string (必需)
机架 ID 此裸机所在的机架的资源 ID。 string (必需)
机架插槽 此裸机所在的机架槽,从下到下排序,即最低槽为 1。 int

约束:
最小值 = 1
最大值 = 256 (必需)
序列号 裸机的序列号。 字符串

约束:
最小长度 = 1
最大长度 = 64 (必需)

扩展位置

名字 描述 价值
名字 要在其中创建资源的扩展位置的资源 ID。 string (必需)
类型 扩展的位置类型,例如 CustomLocation。 string (必需)

TrackedResourceTags

名字 描述 价值

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

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

  • 资源组 关于每个API版本中变更属性的列表,请参见 更改日志。

资源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.NetworkCloud/bareMetalMachines@2025-02-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      bmcConnectionString = "string"
      bmcCredentials = {
        password = "string"
        username = "string"
      }
      bmcMacAddress = "string"
      bootMacAddress = "string"
      machineClusterVersion = "string"
      machineDetails = "string"
      machineName = "string"
      machineSkuId = "string"
      rackId = "string"
      rackSlot = int
      serialNumber = "string"
    }
  }
}

属性值

Microsoft.NetworkCloud/bareMetalMachines

名字 描述 价值
extendedLocation 与资源关联的群集的扩展位置。 ExtendedLocation (必需)
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

约束:
模式 = ^([a-zA-Z0-9][a-zA-Z0-9]{0,62}[a-zA-Z0-9])$ (必需)
性能 资源属性的列表。 BareMetalMachineProperties (必需)
标签 资源标记 标记名称和值的字典。
类型 资源类型 “Microsoft.NetworkCloud/bareMetalMachines@2025-02-01”

AdministrativeCredentials

名字 描述 价值
密码 初始化期间使用的设备的管理员的密码。 字符串

约束:
最小长度 = 1
敏感值。 以安全参数的形式传入。 (必需)
用户名 初始化期间使用的设备的管理员用户名。 字符串

约束:
最小长度 = 1 (必需)

BareMetalMachineProperties

名字 描述 价值
bmcConnectionString 基板管理控制器的连接字符串,包括 IP 地址和协议。 string (必需)
bmc凭证 此裸机计算机上的基板管理控制器的凭据。 AdministrativeCredentials (必需)
bmcMac地址 BMC 设备的 MAC 地址。 字符串

约束:
模式 = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必需)
bootMac地址 连接到 PXE 网络的 NIC 的 MAC 地址。 字符串

约束:
模式 = ^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ (必需)
machineClusterVersion 部署或版本更新期间已应用于此计算机的群集版本。 字符串
机器详细信息 客户提供的自定义详细信息。 字符串

约束:
最大长度 = 256 (必需)
机器名称 分配给此计算机的 OS 级主机名。 字符串

约束:
模式 = ^([a-zA-Z0-9][a-zA-Z0-9]{0,62}[a-zA-Z0-9])$ (必需)
machineSkuId 裸机 SKU 的唯一内部标识符。 string (必需)
机架 ID 此裸机所在的机架的资源 ID。 string (必需)
机架插槽 此裸机所在的机架槽,从下到下排序,即最低槽为 1。 int

约束:
最小值 = 1
最大值 = 256 (必需)
序列号 裸机的序列号。 字符串

约束:
最小长度 = 1
最大长度 = 64 (必需)

扩展位置

名字 描述 价值
名字 要在其中创建资源的扩展位置的资源 ID。 string (必需)
类型 扩展的位置类型,例如 CustomLocation。 string (必需)

TrackedResourceTags

名字 描述 价值