initialize接口

接口功能

初始化MindIO Client。

若不使用TLS认证特性，可以不调用此接口，直接使用load/save相关接口访问MindIO服务。
若使用TLS认证特性，则必须在调用其它MindIO接口之前调用此初始化接口，创建TLS连接。

接口格式

torch_mindio.initialize(tls_open=True, cert_path='', ca_path='', pri_key_path='', key_pass_path='', pmt_path='')

接口参数

参数	是否必选	说明	取值要求
tls_open	可选	是否开启TLS认证的开关，默认值为True。	False：不开启TLS认证。 True：开启TLS认证。
cert_path	可选	开启TLS认证时，Client端证书保存路径。不开启TLS认证时，忽略此参数。	有效的证书文件路径。
ca_path	可选	开启TLS认证时，Client端用于验证Server端证书的CA保存路径。不开启TLS认证时，忽略此参数。	有效的CA文件路径。
pri_key_path	可选	开启TLS认证时，Client端私钥保存路径。不开启TLS认证时，忽略此参数。	有效的私钥文件路径。
key_pass_path	可选	开启TLS认证时，Client端密钥文件的口令文件，里面保存的是加密后的口令。不开启TLS认证时，忽略此参数。	有效的口令文件路径。
pmt_path	可选	开启TLS认证时，Client端密码仓路径。不开启TLS认证时，忽略此参数。	有效的密码仓路径。

使用样例1

>>> # Initialize without TLS
>>> torch_mindio.initialize(tls_open=False)

使用样例2

>>> # Initialize with TLS
>>> torch_mindio.initialize(tls_open=True, cert_path='/home/certs/client.pem', ca_path='/home/certs/ca.crt', pri_key_path='/home/keys/client_key.pem', pmt_path='/home/sec_dir/tools/pmt', key_pass_path='{user.homedir}/crypt_repo/password.txt')

返回值

0：成功。
-1：失败。

父主题： Torch