文档首页/ 云搜索服务 CSS/ API参考/ 快速入门
更新时间：2024-10-17 GMT+08:00
查看PDF
分享

快速入门

本节通过调用云搜索服务的API创建CSS服务集群，CSS的接口调用流程如图1所示。

图1 接口调用流程

通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。

涉及API

当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。

  • IAM获取Token的API
  • CSS创建集群的API

具体步骤

  1. 获取Token，发送“POST https://IAM的Endpoint/v3/auth/tokens”。

    Token认证，具体操作请参考认证鉴权。

    在响应Header中获取“X-Subject-Token”的值即为用户Token。

  2. 设置请求消息头，在Request Header中增加“Content-type ”和“X-Auth-Token”。
    • Content-Type：消息体的类型（格式），默认取值为“application/json”。
    • X-Auth-Token：填写1获取的用户Token。
  3. 发送创建集群的请求，在Request Body中传入参数如下： 
    POST /v1.0/6204a5bd270343b5885144cf9c8c158d/clusters
{ 
    "cluster": { 
        "name": "ES-Test",
        "backupStrategy": {
            "period": "16:00 GMT+08:00",
            "prefix": "snapshot",
            "keepday": 7
        },
        "instanceNum": 3,
           "instance": { 
               "flavorRef": "ess.spec-2u16g", 
                  "volume": { 
                         "volume_type": "COMMON", 
                         "size": 100
                  }, 
                  "nics": { 
                         "vpcId": "fccd753c-91c3-40e2-852f-5ddf76d1a1b2",
                         "netId": "af1c65ae-c494-4e24-acd8-81d6b355c9f1", 
                         "securityGroupId": "7e3fed21-1a44-4101-ab29-34e57124f614" 
                  }
           }
    } 
}
    响应消息样例。 
    {
  "cluster": {
    "id": "ef683016-871e-48bc-bf93-74a29d60d214",
    "name": "ES-Test"
  }
}

    请求响应成功后，返回200 OK，表示集群创建成功。

    若请求失败，则会返回错误码及对应的错误信息说明，详细错误码信息请参考状态码。