你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
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
| 名字 | 描述 | 价值 |
|---|