文档中心
SPOSInstallPara
更新时间： 2026/07/01
在Gitcode上查看源码

ResourceDefinition ​

uris ​

  • /redfish/v1/Managers/manager_id/SPService/SPOSInstallPara/osid

properties ​

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrueOS安装配置资源模型的OData描述信息
@odata.idstringtrueOS安装配置资源的访问路径
@odata.typestringtrueOS安装配置资源的类型
IdstringtrueOS安装配置资源的Id
NamestringtrueOS安装配置资源的名称
InstallModestringfalse安装模式
TemplateNamestringfalse模板名称
OSTypestringfalseOS类型
BootTypestringfalseBIOS启动模式
CDKeystringfalseOS系统安装密钥
RootPwdstringfalse初始管理员密码
HostNamestringfalse主机名
Languagestringfalse语言
TimeZonestringfalse时区
Keyboardstringfalse键盘
CheckFirmware布尔型false固件检查
CheckCompatibility布尔型false兼容性检查
CheckMedia布尔型false光盘系统匹配检查
AutoPosition布尔型false自动选择安装盘
Autopart布尔型false自动分区
MediaTypestringfalse安装介质类型
LVMSettingsobjectfalseLVM参数配置
VGNamestringfalse配置卷组名称
Partitionobjectfalse分区信息
FileSystemstringfalse文件系统
Sizestringfalse分区大小
LVNamestringfalse配置逻辑卷名称
PartitionTypestringfalse指定分区类型
Softwareobjectfalse软件信息
FileNamestringfalse文件名称
NetCfgobjectfalse网络配置信息
Deviceobjectfalse设备信息，Suse系统设备名称和MAC地址必须都指定，其他系统选其中一个填写。
MACstringfalseMAC地址
Silkprintobjectfalse网卡的丝印信息
Locationstringfalse网卡位置信息
DeviceNamestringfalse网卡设备名称
Portstringfalse网卡端口号
IPv4Addressesobjectfalse指定网卡的IPv4信息
Addressstringfalse指定网口的IPv4地址
SubnetMaskstringfalse指定网口的IPv4地址对应的子网掩码
AddressOriginstringfalse指定网口的IPv4地址模式，包括：
● Static
● DHCP
IPv6Addressesobjectfalse指定网口的IPv6信息
PrefixLengthnumberfalse指定网口的IPv6地址对应的前缀长度
Gatewaystringfalse指定网口的网关地址
IPv4RouteSettingsarrayfalse指定网口的IPv4路由信息
Metricnumberfalse路由链路度量
TableIdnumberfalse路由表ID
IPv6RouteSettingsarrayfalse指定网口的IPv6路由信息
DeviceTypestringfalse设备类型
VLANSettingsobjectfalseVLAN配置参数
VLANIdnumberfalseVLANid
ParentInterfaceobjectfalse创建VLAN的网口设备
BondSettingsobjectfalseBond配置参数
WorkModenumberfalseBond工作模式
MonitoringIntervalnumberfalseBond监听频率，单位为ms
BondedInterfacesarrayfalse组Bond的网口设备
HashPolicystringfalseBond哈希策略
BridgeSettingsobjectfalseBridge配置参数
BridgeInterfacesarrayfalse组Bridge的网口设备
STPEnabled布尔型falseSTP使能
Packagesobjectfalse指定Linux系统部署过程中需要安装的模块列表
PackageNamearrayfalse模块列表中package包名称
PatternNamearrayfalse模块列表中pattern组名称
FirstBootScript布尔型false是否执行客户自定义首次启动脚本
UploadFilesobjectfalse上传驱动和固件文件
DriverListarrayfalse上传列表中驱动名称
FirmwareListarrayfalse上传列表中固件名称
FirstBootScriptFilestringfalse上传首次启动脚本的压缩包文件名称
TimeoutSecondsnumberfalse超时时间
BootSettingsobjectfalsegrub参数配置信息
BootEffectivestringfalsegrub参数生效模式，包括：
● Temporary
● Permanent
BootParametersarrayfalsegrub内核参数

supported_methods ​

  • GET

HTTP methods ​

GET ​

命令功能

查询 SP 服务的 OS 安装配置资源

命令格式

URL: https://device_ip/redfish/v1/Managers/manager_id/SPService/SPOSInstallPara/osid

请求头:

X-Auth-Token: auth_value

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址
auth_value请求消息的鉴权参数可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

GA140C机型不支持 SP版本和机型兼容性列表详见Smart Provisioning用户指南

使用实例

请求样例： GET https://device_ip/redfish/v1/Managers/manager_id/SPService/SPOSInstallPara/osid

X-Auth-Token: auth_value 请求消息体：无

响应样例：

json
{
  "@odata.context": "/redfish/v1/$metadata#Managers/Members/1/SPService/SPOSInstallPara/Members/$entity",
  "@odata.id": "/redfish/v1/Managers/1/SPService/SPOSInstallPara/1",
  "@odata.type": "#HwSPOSInstallPara.v1_0_0.HwSPOSInstallPara",
  "Id": "1",
  "Name": "SP OS Install Parameter",
  "InstallMode": "Recommended",
  "TemplateName": "CentOS7_minimal",
  "OSType": "CentOS7U6",
  "BootType": "UEFIBoot",
  "CDKey": "",
  "RootPwd": "******",
  "HostName": "hostname",
  "Language": "en-US.UTF-8",
  "TimeZone": "America/New_York",
  "Keyboard": "us",
  "CheckFirmware": false,
  "CheckCompatibility": true,
  "CheckMedia": true,
  "AutoPosition": true,
  "Autopart": false,
  "MediaType": "LVM",
  "LVMSettings": {
    "VGName": "custom_vg00"
  },
  "Partition": [
    {
      "Name": "/abc",
      "FileSystem": "ext4",
      "Size": "32"
    },
    {
      "Name": "/",
      "FileSystem": "ext4",
      "Size": "32",
      "LVName": "root_lv",
      "PartitionType": "LVM"
    }
  ],
  "Software": [
    {
      "FileName": "iBMA"
    }
  ],
  "NetCfg": [
    {
      "Device": {
        "Name": "eth0",
        "MAC": null,
        "Silkprint": {
          "Location": "mainboard",
          "DeviceName": "PCIeCard1",
          "Port": "1"
        }
      },
      "IPv4Addresses": [
        {
          "Address": "device_ip",
          "SubnetMask": "255.255.0.0",
          "Gateway": "10.10.10.1",
          "AddressOrigin": "Static"
        }
      ],
      "IPv6Addresses": [
        {
          "Address": "fd00:60b:e3:a05:aed1:63de:c500:731a",
          "PrefixLength": "64",
          "Gateway": "::",
          "AddressOrigin": "Static"
        }
      ],
      "NameServers": [
        {
          "DNS": "10.10.10.254"
        },
        {
          "DNS": "10.10.10.253"
        }
      ],
      "IPv4RouteSettings": [
        {
          "Address": "Ipv4_address",
          "SubnetMask": "255.255.255.255",
          "Gateway": "Ipv4_gateway",
          "Metric": 50,
          "TableId": 100
        }
      ],
      "IPv6RouteSettings": [
        {
          "Address": "Ipv6_address",
          "PrefixLength": "64",
          "Gateway": "Ipv6_gateway",
          "Metric": 100,
          "TableId": 200
        }
      ]
    },
    {
      "Device": {
        "Name": "test_vlan",
        "MAC": null
      },
      "DeviceType": "VLAN",
      "VLANSettings": {
        "VLANId": 255,
        "ParentInterface": {
          "Name": "eth1",
          "MAC": null,
          "Silkprint": {
            "DeviceName": "NIC1",
            "Location": "mainboard",
            "Port": "1"
          }
        }
      },
      "IPv4Addresses": [
        {
          "Address": "device_ip",
          "AddressOrigin": "Static",
          "Gateway": "device_gw",
          "SubnetMask": "255.255.0.0"
        }
      ],
      "IPv6Addresses": [],
      "NameServers": []
    },
    {
      "Device": {
        "Name": "test_bond",
        "MAC": null
      },
      "DeviceType": "Bond",
      "BondSettings": {
        "WorkMode": 4,
        "MonitoringInterval": 100,
        "BondedInterfaces": [
          {
            "MAC": null,
            "Name": "eth2"
          }
        ],
        "HashPolicy": "layer2"
      },
      "IPv4Addresses": []
    },
    {
      "Device": {
        "Name": "test_bridge",
        "MAC": null
      },
      "DeviceType": "Bridge",
      "BridgeSettings": {
        "STPEnabled": true,
        "BridgeInterfaces": [
          {
            "MAC": null,
            "Name": "eth3",
            "Silkprint": {}
          },
          {
            "Name": "eth4",
            "MAC": null,
            "Silkprint": {
              "DeviceName": "NIC1",
              "Location": "mainboard",
              "Port": "4"
            }
          }
        ]
      },
      "IPv4Addresses": []
    }
  ],
  "Packages": [
    {
      "PackageName": [
        "gcc",
        "aspell"
      ],
      "PatternName": [
        "x11",
        "base"
      ]
    }
  ],
  "FirstBootScript": true,
  "UploadFiles": {
    "DriverList": [
      "ComputingComponentiDriver-CentOS7.6-Driver-ARM_2.0.3.zip",
      "ComputingComponentiDriver-CentOS7.6-Driver-ARM_2.0.3.zip.asc"
    ],
    "FirmwareList": [],
    "FirstBootScriptFile": "firstboot.zip",
    "TimeoutSeconds": 0
  },
  "BootSettings": {
    "BootEffective": "Permanent",
    "BootParameters": [
      "nosmp"
    ]
  }
}

响应码：200