文档
注册

配置网管资源信息

命令功能

配置网管资源信息。

该接口配置最长时间为4分钟左右,请耐心等待。

命令格式

操作类型:POST

URL:https://device_ip/redfish/v1/NetManager

请求头:

X-Auth-Token: auth_value
Content-Type: header_type
请求消息体:
{
    "ManagerType": manager_type,
    "NetIP": ip_address,
    "Port": port,
    "NetAccount": net_account,
    "NetPassword": net_password,
    "NodeId": node_id,
    "ServerName": server_name,
    "test": is_test
}

请求参数

表1 请求参数

参数名

是否必选

参数说明

取值

ManagerType

必选

网管模式

字符串类型,取值为:

  • Web:本地Web管理
  • FusionDirector:FusionDirector管理

NetIP

是否必选取决于ManagerType

  • ManagerType为Web时:可选
  • ManagerType为FusionDirector:必选

对接IP地址

字符串类型,取值为IPv4地址。

Port

是否必选取决于ManagerType

  • ManagerType为Web时:可选
  • ManagerType为FusionDirector:必选

对接端口号

数字类型,取值范围为1~65535,目前只支持443。

NetAccount

是否必选取决于ManagerType

  • ManagerType为Web时:可选
  • ManagerType为FusionDirector:必选

对接账号

字符串类型,取值只能包含小写字母(a~z)、大写字母(A~Z)、数字(0~9)、中划线(-)、下划线(_),长度为1~256字节。

NetPassword

是否必选取决于ManagerType

  • ManagerType为Web时:可选
  • ManagerType为FusionDirector:必选

对接密码

字符串类型,长度为8~32字符,遵循密码复杂度的规则。

NodeId

是否必选取决于ManagerType

  • ManagerType为Web时:可选
  • ManagerType为FusionDirector时:必选

节点ID

字符串,当前仅支持一种格式:UUID,长度为36字节。如e6a47e30-3a09-11ea-9218-a8494df5f123。

说明:

字符取值为数字(0~9)、中划线(-)、小写字符(a~f)有效。

ServerName

是否必选取决于ManagerType

  • ManagerType为Web时:可选
  • ManagerType为FusionDirector:可选

服务器名称

FusionDirector模式:取值只能包含小写字母(a~z)、大写字母(A~Z)、数字(0~9)、中划线(-)、英文点(.),长度范围为0~64字节。并且不能为/etc/hosts中127.0.0.1、::1对应的域名,包括但不仅限于localhost、localhost.localdomain、localhost4、localhost4.localdomain4、localhost6、localhost6.localdomain6。

test

是否必选取决于ManagerType

  • ManagerType为Web时:可选
  • ManagerType为FusionDirector:必选

是否需要在网管生效前测试网管是否可用

布尔类型,取值为:
  • true:需要测试
  • false:不需要测试

使用指南

用户使用端口号时,如果曾多次配置端口号,以最近一次配置的端口号为准。

使用实例

请求样例:

POST https://10.10.10.10/redfish/v1/NetManager

请求头:

X-Auth-Token: auth_value
请求消息体:
  • 配置成Web模式:
    {
        "ManagerType":"Web"
    }
  • 配置成FusionDirector模式:
    {
        "ManagerType": "FusionDirector",
        "NetIP": "xx.xx.xx.xx",
        "Port": 443,
        "NetAccount": "EdgeAccount",
        "NetPassword": "****",
        "NodeId": "e6a47e30-3a09-11ea-9218-a8494df5f123",
        "ServerName": "",
        "test": true
    }
响应样例:
  • 网管模式为Web模式
    {
        "@odata.context": "/redfish/v1/$metadata#NetManager",
        "@odata.id": "/redfish/v1/NetManager",
        "@odata.type": "#MindXEdgeNetManager.v1_0_0.MindXEdgeNetManager",
        "Id": "NetManager",
        "Name": "NetManager",
        "NetManager": "Web",
        "NetIP": "",
        "Port": "",
        "NetAccount": "",
        "ServerName": "",
        "ConnectStatus": "not_configured",
        "NodeID": {
            "@odata.id": "/redfish/v1/NetManager/NodeID"
        },
        "QueryFdCert": {
            "@odata.id": "/redfish/v1/NetManager/QueryFdCert"
        },
        "Actions": {
            "#ImportFdCert": {
                "target": "/redfish/v1/NetManager/ImportFdCert"
            },
            "#ImportFdCrl": {
                "target": "/redfish/v1/NetManager/ImportFdCrl"
            }
        }
    }
  • 网管模式为FusionDirector模式
    {
        "@odata.context": "/redfish/v1/$metadata#NetManager",
        "@odata.id": "/redfish/v1/NetManager",
        "@odata.type": "#MindXEdgeNetManager.v1_0_0.MindXEdgeNetManager",
        "Id": "NetManager",
        "Name": "NetManager",
        "NetManager": "FusionDirector",
        "NetIP": "xx.xx.xx.xx",
        "Port": "443",
        "NetAccount": "2102312NNUN0L6000008",
        "ServerName": "fd.fusiondirector.huawei.com",
        "ConnectStatus": "connected",
        "NodeID": {
            "@odata.id": "/redfish/v1/NetManager/NodeID"
        },
        "QueryFdCert": {
            "@odata.id": "/redfish/v1/NetManager/QueryFdCert"
        },
        "Actions": {
            "#ImportFdCert": {
                "target": "/redfish/v1/NetManager/ImportFdCert"
            },
            "#ImportFdCrl": {
                "target": "/redfish/v1/NetManager/ImportFdCrl"
            }
        }
    }

响应码:200

输出说明

表2 操作输出说明

字段

类型

说明

@odata.context

字符串

北向接口固定字段,当前资源模型的OData描述信息。

@odata.id

字符串

北向接口固定字段,当前资源节点的访问路径。

@odata.type

字符串

北向接口固定字段,当前资源类型。

Id

字符串

北向接口固定字段,当前资源的ID。

Name

字符串

北向接口固定字段,当前资源的名称。

NetManager

字符串

网管模式,分为以下几种:

  • Web:本地Web管理
  • FusionDirector:FusionDirector管理

NetIP

字符串

对接IP地址,仅FusionDirector模式有效。

Port

字符串

对接端口号,仅FusionDirector模式有效。

NetAccount

字符串

对接帐号,仅FusionDirector模式有效。

ServerName

字符串

服务器名称,仅FusionDirector模式有效。

ConnectStatus

字符串

对接状态,取值为:
  • not_configured:未配置
  • connecting:连接中
  • connected:已连接
  • error_configured:配置错误

NodeID

对象

NodeID接口资源的访问路径。

QueryFdCert

对象

根证书接口资源的访问路径。

Actions

对象

可执行的操作。

Actions.#ImportFdCert

对象

导入根证书的访问路径。

Actions.#ImportFdCrl

对象

导入吊销列表的访问路径。

搜索结果
找到“0”个结果

当前产品无相关内容

未找到相关内容,请尝试其他搜索词