快速入门

前提条件

• 已获取IAM的Endpoint和DLV的Endpoint。
• 已获取projectId，具体请参见获取项目ID。

操作步骤

假设已获取前提条件中的信息为如下值（实际操作中您需要根据实际情况替换）：

• IAM的Endpoint：下面示例中以iam_endpoint代替。
• DLV的Endpoint：下面示例中以dlv_endpoint代替。
• 项目编号projectId：下面示例中以project_id代替。

则可以通过如下步骤创建一个大屏。

1. 调用Token认证其他接口前，需要获取Token，并设置成环境变量。

   curl -H "Content-Type:application/json" https://iam_endpoint/v3/auth/tokens -X POST -d '{ 
       "auth": { 
           "identity": { 
               "methods": [ 
                   "password" 
               ], 
               "password": { 
                   "user": { 
                       "name": "testname", 
                       "domain": { 
                           "name": "testname" 
                       }, 
                       "password": "Passw0rd" 
                   } 
               } 
           }, 
           "scope": { 
               "project": { 
                   "name": "aaa"
               } 
           } 
       } 
   }' -v -k

   响应Header中“X-Subject-Token”的值即为Token：

   X-Subject-Token:MIIDkgYJKoZIhvcNAQcCoIIDgzCCA38CAQExDTALBglghkgBZQMEAgEwgXXXXX...

   使用如下命令将Token设置为环境变量，方便后续事项。其中，“X-Auth-Token”的值为上一步骤中获取到的Token值。

   export Token=MIIDkgYJKoZIhvcNAQcCoIIDgzCCA38CAQExDTALBglghkgBZQMEAgEwgXXXXX...

2. 调用新增大屏接口。

   curl -X POST -H 'Content-Type:application/json;charset=utf-8' -H "X-Auth-Token:$Token" -d '{ 
       "name": "my_screen", 
       "alias": "first_screen", 
       "description": "my first screen", 
       "template_id": "453113551",
       "workspaceId":"86ce107974ce4f93b618acb232863027"
       } 
   }' https://dlv_endpoint/v1/project_id/screens -v -k

   参数说明：

   • name：大屏的名称。
   • alias：大屏的别名。
   • description：大屏的描述信息。
   • template_id：用于创建大屏的模板ID。
   • workspaceId：工作空间ID。

   如果返回状态码为200，则说明创建大屏成功。如果失败，异常状态码请参见状态码。