如何使用BlueData REST进行会话？

Question

我想使用BlueData API以编程方式管理BlueData安装。

我已经看到了一些文档这里 --我似乎需要从开始获取会话，但是我希望在获取会话之前创建一个会话。

如何创建会话并在后续操作中使用？

Answer 1

引言

问题中列出的API文档没有显示创建会话的API调用。但是，创建会话的说明可以找到这里，但我也会在这个答案中添加细节，以防链接消失。

请注意，如果您有正在运行的BlueData安装，您可以浏览完整的BlueData API文档：

http://<controller-ip>/apidocs/

无论如何，创建会话并在后续调用(如检索所有租户)中使用会话的步骤如下：

创建会话

编写login.json文件：

cat <<EOF> ./login.json
{
     "name": "admin",
     "password": "admin123"
}
EOF

设置控制器IP：

# Set this to your controller IP address

CONTROLLER_IP=10.0.0.1 

然后，您可以提交登录请求：

curl -i -X POST -d@login.json http://${CONTROLLER_IP}:8080/api/v1/login

返回

HTTP/1.1 201 Created Server: BlueData EPIC 3.7位置:BlueData日期: Mon，2017月15日16:47:54 GMT内容-类型:文本/普通内容-长度: 13访问-控制-允许-原产地：* 201创建

设置会话ID：

SESSION_ID=/api/v1/session/df1bfacb-xxxx-xxxx-xxxx-c8f57d8f3c71

使用会话获取租户列表

在后续调用中使用会话ID。

curl -X GET -H "X-BDS-SESSION:${SESSION_ID}" http://${CONTROLLER_IP}:8080/api/v1/tenant

对于我来说，这个示例返回：

{"_links":{"self":{"href":"/api/v1/tenant"}}，

另请参阅：

• https://bluedata.zendesk.com/hc/en-us/sections/115000519533-RESTful-APIs-Site-Admin-API-v1
• https://bluedata.zendesk.com/hc/en-us/sections/115000518194-RESTful-APIs-Tenant-Admin