文档首页> 存储容灾服务 SDRS> API参考> 快速入门
更新时间：2023-11-21 GMT+08:00
查看PDF

快速入门

本节通过调用API创建保护组。

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

涉及API

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

  • IAM获取token的API
  • SDRS创建保护组的API

具体步骤

  1. Token认证，具体操作请参考认证鉴权。
  2. 发送“POST https://SDRS的Endpoint/v1/{project_id}/server-groups”。
  3. 在Request Header中增加“X-Auth-Token”。
  4. 在Request Body中传入参数如下：
    {
    "server_group": {               
        "name":"testname",    // 保护组名称           
        "description":"description",      //保护组描述信息         
        "source_availability_zone": "az1.ac1",    //保护组的生产站点可用区名称          
        "target_availability_zone": "az2.ac2",    //保护组的容灾站点可用区名称
        "domain_id":"bccc426c-7dc4-4196-b4d8-372051f306fa",     //指定双活域ID          
        "source_vpc_id":"a9497554-3137-4a04-92bf-4be0ccdc8afe",   //生产站点虚拟私有云ID             
        "dr_type":"migration"     //保护组的部署模式    
    } 
}

    请求响应成功后，返回job_id。

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

  1. 根据job_id查询job详情，具体操作请参考查询job状态。

    查询job详情返回状态status为“SUCCESS”，则表示保护组创建成功。

  2. 查询job详情的body体中可以获取到保护组ID，根据获取到的保护组ID可对保护组进行查询、删除、更新保护组名称操作。