CURL 中的用法示例

已提供使用 curl 生成的若干用法示例以供参考。

有关使用 Python 3 语言生成的用法示例，请参阅入门。有关使用 Perl 编程语言的示例，请参阅 Perl 中的 RESTful API 用法示例。以下用法示例不包括可能对系统对象执行的所有操作。

每个 curl 示例都采用以下格式：
curl -k -X POST -H header_1 -H header_2... -d 
'JSON' https://system_ip:7443/rest/target

其中，以下定义适用：

  • POST 是 Spectrum Virtualize RESTful API 支持的唯一 HTTPS 方法。
  • 头 (header_1 ) 是单独指定的 HTTP 头（例如，Content-Type 和 X-Auth­Username）。
  • -d 后跟 JSON 输入（例如，'{"raid_level": "raid5"}'）。
  • system_ip 是将请求发送到的 IP 地址。
  • target 是命令的目标对象，其中包含任意对象标识、名称和参数。

认证

以下是用于认证的正确过程的示例。通过首先生成认证令牌，然后在所有未来命令中使用该令牌直至会话结束，从而进行认证。有关认证的更多信息，请参阅认证概述和 API 管理。
curl -k -X POST -H 'Content-Type: application/json' -H 'X-Auth-Username: 
superuser' -H 'X-Auth-Password: passw0rd' 
https://192.168.10.109:7443/rest/auth
这将产生用于所有其他命令的认证令牌。
{"token": "38823f60c758dca26f3eaa17dc4664964905a6f058ae2ec92e0f0b63fcf08a3e"}

创建阵列

只有在认证后才能使用命令，包括用于在系统上创建阵列的命令。以下示例说明如何使用令牌来替换认证过程中使用的认证头。
curl -k -X POST -H 'Content-Type: application/json' -H 'X-Auth-Token: 
38823f60c758dca26f3eaa17dc4664964905a6f058ae2ec92e0f0b63fcf08a3e'
-d '{"level": "draid6", "drive": "6:7:8:9:10", "draid6grp"}'
           https://192.168.10.109:7443/rest/mkarray

更改阵列设置

下一个示例显示如何修改阵列成员的属性，以通过对重建区域使用分布式重建来更改新驱动器 15 的成员 24：
curl -k -X POST -H 'Content-Type: application/json' -H 'X-Auth-Token: 
38823f60c758dca26f3eaa17dc4664964905a6f058ae2ec92e0f0b63fcf08a3e'
-d '{"member": "24", "newdrive": "15",
     "immediate": "0"}' https://192.168.10.109:7443/rest/charraymember

移除阵列

最后一个示例显示如何从存储池中移除阵列 MDisk。 有关管理阵列的更多信息，请参阅rmarray。

curl -k -X POST -H 'Content-Type: application/json' -H 'X-Auth-Token: 
38823f60c758dca26f3eaa17dc4664964905a6f058ae2ec92e0f0b63fcf08a3e' 
-d '{"mdisk": "6", "mdiskgrp_10"}' https://192.168.10.109:7443/rest/rmarray