箴更新的API
Pro Updates API提供了检查、下载和应用最新Metasploit Pro更新的能力。这个API还包括一个重新启动Metasploit Pro服务的方法。
pro.update_available
箴。update_available方法提供了检查Metasploit Pro实例的可用更新的能力。UpdateCheckOptions散列可以为空，也可以包含'proxy_host'、'proxy_port'、'proxy_user'和'proxy_pass'元素，以使用HTTP代理进行检查。返回值包括一个哈希值，该哈希值指示更新是否可用、该更新的版本号以及该更新包含的内容的描述。注意，描述可能包含HTML格式。
请求示例
壳牌
1
(“pro.update_available”，“<标记>”，｛｝］
反应的例子
json
1
｛
2
“状态”＝＞“成功”，
3.
“结果”＝＞“更新”，
4
“当前”＝＞“1”，
5
“版本”＝＞“20120125000001”，
6
“信息”＝＞“此更新添加了新功能和修复…”
7
｝
pro.update\u安装
箴。update_install方法提供按名称安装更新包的能力，该名称通过InstallOptions散列的'version'元素指定。在这个散列中可以提供'proxy_host'， 'proxy_port'， 'proxy_user'和'proxy_pass'元素，以指示应该使用HTTP代理。此方法返回一个散列，指示更新是否已成功启动以及安装的当前状态。下载和安装过程是一个简单的步骤，可以通过调用pro来跟踪进度。update_status方法。注意专业人士。必须调用Restart_service方法来完成更新。
请求示例
壳牌
1
(“pro.update_install”，“<标记>”，｛“版本”＝>“20120125000001”｝］
反应的例子
json
1
｛
2
“状态”＝＞“成功”，
3.
“结果”＝＞“下载”，
4
“错误”＝＞＂＂
5
｝
pro.update_install_offline
箴。Update_install_offline方法提供从本地文件系统安装更新包的能力。需要离线更新的客户应联系Rapid7支持，以获得每个更新包的下载位置通知。离线包安装的状态可以通过调用pro来监控。update_status方法。注意专业人士。必须调用Restart_service方法来完成更新。
请求示例
壳牌
1
(“pro.update_install_offline”，“<标记>”，“/ tmp / metasploit_pro_update.zip”］
反应的例子
json
1
｛
2
“状态”＝＞“成功”，
3.
“结果”＝＞“安装”，
4
“错误”＝＞＂＂
5
｝
pro.update_status
箴。Update_status方法返回一个哈希值，该哈希值指示更新安装过程的当前状态。如果仍在从服务器检索更新，则下载的当前进度将在'download_total'、'download_done'和'download_pcnt'元素中返回。
请求示例
壳牌
1
(“pro.update_status”，“<标记>”］
反应的例子
json
1
｛
2
“状态”＝＞“成功”，
3.
“结果”＝＞“下载”，
4
“错误”＝＞＂＂，
5
“下载总数”＝＞“1000000”，
6
“download_done”＝＞“100000”，
7
“download_pcnt”＝＞“10”
8
｝
pro.update_stop
箴。Update_stop方法强制停止任何现有的更新过程，无论是正在下载更新包还是正在安装内容。
请求示例
壳牌
1
(“pro.update_stop”，“<标记>”］
反应的例子
json
1
｛“状态”＝＞“成功”｝
pro.restart_service
箴。restart_service方法会导致Metasploit Pro RPC Service (prosvc)和Metasploit Pro Web Service重新启动。这是完成更新包安装所必需的。
请求示例
壳牌
1
(“pro.restart_service”，“<标记>”］
反应的例子
json
1
｛“状态”＝＞“成功”｝