空间API应用示例

本节通过cURL方式调用TICS API，获取TICS相关资源信息为例，介绍使用TICS管理面API的基本流程。

获取用户token
获取用户的token，因为在后续的请求中需要将token放到请求消息头中作为认证。
获取空间列表
获取调用后续接口参数信息，例如可信节点id。

准备数据

在调用API之前(分析类型)，您需要准备如下数据。

表1 准备数据
数据项	名称	说明	样例
云账户信息	项目名	TICS所属的项目名。	Project Name
	项目ID	TICS所属的项目ID。	1551c7f6c808414d8e9f3c514a170f2e
	账户名	用户所属的企业账户名称。	Account Name
	用户名	使用云服务的用户名，该用户需要拥有TICS的操作权限。	Username
	密码	用户密码。	password
Endpoint	IAM的Endpoint	终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同。Endpoint您可以参考终端节点Endpoint获取。	iam_endpoint
Endpoint	TICS的Endpoint		tics_endpoint

获取用户token

调用获取用户TokenAPI获取token。

调用其他API前，需要获取token，并设置成环境变量。

curl -H "Content-Type:application/json" https://{iam_endpoint}/v3/auth/tokens -X POST -d '
{
    "auth": {
        "identity": {
            "methods": [
                "password"
            ],
            "password": {
                "user": {
                    "name": "Username",
                    "password": "password",
                    "domain": {
                        "name": "Account Name"
                    }
                }
            }
        },
        "scope": {
            "project": {
                "id": "1551c7f6c808414d8e9f3c514a170f2e"
            }
        }
    }
}
' -v -k

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

X-Subject-Token:MIIDkgYJKoZIhvcNAQcCoIIDgzCCA38CAQExDTALBglghkgBZQMEAgEwgXXXXX...

使用如下命令将token设置为环境变量，方便后续事项。

export Token = MIIDkgYJKoZIhvcNAQcCoIIDgzCCA38CAQExDTALBglghkgBZQMEAgEwgXXXXX...

获取空间列表

1.调用获取空间列表API获取空间列表信息：

curl -X GET -H 'Content-Type:application/json;charset=utf-8' -H "X-Auth-Token:$Token" https://{tics_endpoint}/v1/1551c7f6c808414d8e9f3c514a170f2e/league-info -k -v

2.查看空间查询结果，成功响应如下：

{ 
  "total" : 1, 
  "lists" : [ { 
    "id" : "ef73b252a0ad4b5db21a12c40a413b2f", 
    "name" : "test", 
    "partners" : 3, 
    "league_status" : "NORMAL", 
    "type" : "OWNER", 
    "creator_id" : "098593b08f00d2a34f64c004408b64bc", 
    "creator_name" : "user01", 
    "create_time" : 1665215103413, 
    "create_date" : "2022-10-08T07:45:03.413+00:00", 
    "expire_time" : 0, 
    "version" : "1.15.1" 
  } ] 
}

父主题：应用示例

上一篇：应用示例

下一篇：计算节点API应用示例