跳到主要内容

PATCH – 更新 BMC 以太网配置

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

请求 URL​

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

请求正文​

要更新的属性如下所示：
字段类型描述

InterfaceEnabled

布尔

指示是否启用此接口的布尔值。

MACAddress

字符串

（逻辑端口）接口当前配置的 MAC 地址。

SpeedMbps

字符串

此 XCC 接口的当前速度（单位：Mbps，即 Mbit/s）

该属性应介于 10 到 100 之间。

AutoNeg

布尔

指示是否在此 XCC 接口上自动协商和配置速度和双工：

True：启用速度和双工自动协商。

False：禁用速度和双工自动协商。

FullDuplex

布尔

此 XCC 接口上以太网连接的双工状态：

True：处于全双工模式。

False：未处于全双工模式。

MTUSize

数字

此 XCC 接口上当前配置的最大传输单元（MTU）（以字节为单位）

HostName

字符串

此 XCC 接口的主机名，不含任何域信息。

IPv4StaticAddresses

数组

用于表示此 XCC 接口的 IPv4 连接特征的对象数组

IPv6StaticAddresses

数组

用于表示此 XCC 接口的 IPv6 静态连接特征的对象数组

IPv6StaticDefaultGateways

数组

用于表示此 XCC 接口的 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

StatelessAddressAutoConfig

对象

已展开

 

IPv6AutoConfigEnabled

布尔

是否启用 IPv6 自动配置。

响应正文​

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

状态代码​

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

示例​

以下示例是 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
}