配置镜像下载信息

命令功能

用于配置第三方镜像仓库地址和账号密码，仓库服务器地址支持域名或者IP地址。重复调用接口时，会更新已有的镜像下载信息配置。

镜像下载信息将会被MEF Center传递到K8s和kubeedge中，后者会将数据保存在K8s中和MEF Edge设备的edgecore数据库中。用户可根据需要，通过定制K8s和kubeedge的方式，对镜像仓库的账号密码进行安全加固。
建议用户使用可信的第三方镜像仓库。如果配置了不安全的第三方镜像仓库地址，可能会存在不安全的传输过程。

当使用域名时，需要在边缘设备MEF Edge的主机目录“/etc/hosts”中，配置域名和IP地址的映射关系，具体操作请参考配置本地域名映射。

命令格式

操作类型：POST

URL：https://{ip}:{port}/edgemanager/v1/image/config

请求消息体：

{
    "domain": domain
    "ip": ip,
    "port": port,
    "account": account,
    "password": password
}

请求参数

表1 参数说明
参数	是否必选	参数说明	取值
domain	可选	镜像仓服务器的域名	字符串，合法的域名。支持长度3~63位，大小写字母、数字和符号（.-）的组合，且只能以大小写字母、数字开头和结尾，不能为全数字。取值不能为localhost。 domain和IP参数至少需要传入一个。同时提供两个参数时，以域名为准。
ip	可选	镜像仓服务器的IP地址	字符串，合法的IPV4地址，不能为全零或者全255，不能为回环地址127.0.0.1，且不能为MEF Edge设备主机地址。 domain和IP参数至少需要传入一个。同时提供两个参数时，以域名为准。
port	必选	镜像仓对外提供服务的端口号	数字，只能为1-65535之间的整数。
account	必选	镜像下载账号	字符串，长度最大256个字符。支持大小写字母、数字、下划线（_）、短横线（-），下划线和短横线不能在开头结尾。
password	必选	镜像下载密码	字节数组，数组长度为[8，20]。镜像仓密码不支持英文冒号。说明：密码复杂度建议满足如下要求，若设置的密码不符合以下规则，可能存在安全风险。密码长度至少需要8个字符。密码必须包含如下至少两种字符的组合：至少一个小写字母。至少一个大写字母。至少一个数字。至少一个特殊字符：`~!@#$%^&*()-_=+\\|[{}];:'",<.>/?和空格密码不能和账号一样。

使用样例

请求样例：

POST https://10.10.10.10:30035/edgemanager/v1/image/config

请求消息体：

{
    "domain": "xxx.huawei.com",
    "ip": "10.10.10.10",
    "port": 6443,
    "account": "ImageRepository",
    "password": [72, 117, 97, 119, 101, 105, 49, 50, 35, 36]
}

响应样例：

{
    "status": "00000000",
    "msg": "success"
}

响应状态码：200

输出说明

表2 操作输出说明
参数	类型	参数说明
status	字符串	错误码
msg	字符串	描述信息

父主题： 配置接口