PATCH – 更新 BMC 以太网配置

使用 PATCH 方法更新 BMC 的以太网接口资源中的属性。

请求 URL

PATCH https://<BMC_IPADDR>/redfish/v1/Managers/1/EthernetInterfaces/NIC

请求正文

要更新的属性如下所示：

字段		类型	描述
InterfaceEnabled		布尔	指示是否启用此接口的布尔值。
MACAddress		字符串	（逻辑端口）接口当前配置的 MAC 地址。
SpeedMbps		字符串	此 XCC2 接口的当前速度（单位：Mbps，即 Mbit/s）此属性仅允许值为 10 或 100。
AutoNeg		布尔	指示是否在此 XCC2 接口上自动协商和配置速度和双工： True。启用速度和双工自动协商。 False。禁用速度和双工自动协商。
FullDuplex		布尔	此 XCC2 接口上以太网连接的双工状态： True。处于全双工模式。 False。未处于全双工模式。
MTUSize		数字	此 XCC2 接口上当前配置的最大传输单元（MTU）（以字节为单位）。
HostName		字符串	此 XCC2 接口的主机名，不含任何域信息。
IPv4StaticAddresses		数组	用于表示此 XCC2 接口的 IPv4 连接特征的对象数组。
IPv6StaticAddresses		数组	用于表示此 XCC2 接口的 IPv6 静态连接特征的对象数组。
IPv6StaticDefaultGateways		数组	用于表示此 XCC2 接口的 IPv6 静态默认网关的对象数组。
	Address	字符串	网关地址。
VLAN		链接	此属性的值应是此接口的 VLAN。如果此接口支持多个 VLAN，则不应存在 VLAN 属性，而应存在 VLANS 集合链接。
	VLANEnable	布尔	VLAN 的属性是否为启用。
	VLANId	数字	VLAN 的 ID。
DHCPv4		对象	已展开
	DHCPEnabled	布尔	是否启用 DHCP。
	UseDNSServers	布尔	是否使用 DNS 服务器。
	UseDomainName	布尔	是否使用域名。
	FallbackAddress	字符串	此接口的 DHCPv4 回退地址方法。有效值：None、Static。
DHCPv6		对象	已展开
	OperatingMode	字符串	运行模式的属性。值应为“Stateful”或“Disabled”。
	UseDNSServers	布尔	是否使用 DNS 服务器。
	UseDomainName	布尔	是否使用域名。
StaticNameServers		数组	此字符串数组允许 6 个条目。前三项用于 IPv4 DNS 服务器，后三项用于 IPv6 DNS 服务器。项：字符串项数：6
StatelessAddressAutoConfig		对象	已展开
	IPv6AutoConfigEnabled	布尔	是否启用 IPv6 自动配置。

响应正文

响应返回的内容与 GET 操作相同，但更新了属性。

状态代码

HTTP 状态代码	错误消息 ID
400	PropertyValueNotInList、PropertyValueFormatError、PropertyValueTypeError、PropertyNotWritable
500	InternalError

示例

以下示例是 PATCH 正文。

{
    "MTUSize": 1490,
    "SpeedMbps": 100,
    "FullDuplex": true
}

返回更新后的资源。

{
    "DHCPv6": {
        "UseNTPServers": null,
        "OperatingMode": "Disabled",
        "UseDNSServers": false,
        "UseDomainName": false,
        "UseRapidCommit": null
    },
    "Links": {
        "Chassis": {
            "@odata.id": "/redfish/v1/Chassis/1"
        }
    },
    "VLAN": {
        "VLANEnable": false,
        "VLANId": 1
    },
    "Oem": {
        "Lenovo": {
            "@odata.type": "#LenovoEthernetInterface.v1_0_0.LenovoEthernetInterfaceProperties",
            "DomainName": "",
            "IPv4Enabled": true,
            "IPv4AddressAssignedby": "Static",
            "InterfaceNicMode": "Dedicated",
            "NetworkSettingSync": true,
            "IPv6AddressAssignedby": [],
            "InterfaceFailoverMode": "Shared",
            "IPv6Enabled": false
        }
    },
    "IPv6Addresses": [],
    "Status": {
        "Health": null,
        "State": "Enabled"
    },
    "IPv6DefaultGateway": "::",
    "IPv6StaticDefaultGateways": [
        {
            "Address": "::",
            "PrefixLength": 0
        }
    ],
    "StaticNameServers": [
        "0.0.0.0",
        "0.0.0.0",
        "0.0.0.0",
        "::",
        "::",
        "::"
    ],
    "MTUSize": 1490,
    "FullDuplex": true,
    "IPv4StaticAddresses": [
        {
            "AddressOrigin": "Static",
            "Gateway": "192.168.0.1",
            "Address": "192.168.0.41",
            "SubnetMask": "255.255.255.0"
        }
    ],
    "IPv6AddressPolicyTable": [
        {
            "Label": 0,
            "Precedence": 50,
            "Prefix": "::1/128"
        },
        {
            "Label": 3,
            "Precedence": 11,
            "Prefix": "::/96"
        },
        {
            "Label": 4,
            "Precedence": 35,
            "Prefix": "::ffff:0.0.0.0/96"
        },
        {
            "Label": 6,
            "Precedence": 10,
            "Prefix": "2001::/32"
        },
        {
            "Label": 7,
            "Precedence": 10,
            "Prefix": "2001:10::/28"
        },
        {
            "Label": 12,
            "Precedence": 1,
            "Prefix": "3ffe::/16"
        },
        {
            "Label": 2,
            "Precedence": 30,
            "Prefix": "2002::/16"
        },
        {
            "Label": 11,
            "Precedence": 1,
            "Prefix": "fec0::/10"
        },
        {
            "Label": 5,
            "Precedence": 5,
            "Prefix": "fc00::/7"
        },
        {
            "Label": 1,
            "Precedence": 40,
            "Prefix": "::/0"
        }
    ],
    "PermanentMACAddress": "7c:d3:0a:5e:22:65",
    "StatelessAddressAutoConfig": {
        "IPv4AutoConfigEnabled": null,
        "IPv6AutoConfigEnabled": false
    },
    "NameServers": [
        "",
        "",
        "",
        "::",
        "::",
        "::"
    ],
    "Name": "Manager Ethernet Interface",
    "AutoNeg": true,
    "@odata.etag": "\"24596c8504c398d843823abc542140fa\"",
    "EthernetInterfaceType": "Physical",
    "MACAddress": "7c:d3:0a:5e:22:65",
    "FQDN": "XCC-7X00-1234567890",
    "Description": "Manager Ethernet Interface",
    "@odata.type": "#EthernetInterface.v1_5_0.EthernetInterface",
    "InterfaceEnabled": true,
    "Id": "NIC",
    "LinkStatus": "LinkUp",
    "DHCPv4": {
        "UseNTPServers": null,
        "UseDNSServers": true,
        "UseGateway": null,
        "FallbackAddress": "None",
        "DHCPEnabled": false,
        "UseDomainName": true,
        "UseStaticRoutes": null
    },
    "IPv6StaticAddresses": [
        {
            "Address": "::",
            "PrefixLength": 64
        }
    ],
    "HostName": "XCC-7X00-1234567890",
    "@odata.id": "/redfish/v1/Managers/1/EthernetInterfaces/NIC",
    "IPv4Addresses": [
        {
            "AddressOrigin": "Static",
            "Gateway": "192.168.0.1",
            "Address": "192.168.0.41",
            "SubnetMask": "255.255.255.0"
        }
    ],
    "MaxIPv6StaticAddresses": 1,
    "SpeedMbps": 100
}

提供反馈

PATCH – 更新 BMC 以太网配置

请求 URL​

请求正文​

响应正文​

状态代码​

示例​

请求 URL

请求正文

响应正文

状态代码

示例