存储网关相关接口
所有文档

          存储网关 BSG

          存储网关相关接口

          创建存储网关

          描述

          • 创建一个存储网关,返回分配的服务地址以及实例ID。
          • 付费方式为后付费。

          请求结构

          POST /v{version}/bsg?clientToken={clientToken} HTTP/1.1
          Host: bsg.bj.baidubce.com
          Authorization: authorization string
           
           {
               "bsgName": "name",
               "zoneName": zoneName,
               "flavor":flavor
           }

          请求头域

          除公共头域外,无其他特殊头域

          请求参数

          参数名称 类型 是否必须 参数位置 描述
          version String URL参数 API版本号,当前取值1
          clientToken String Query参数 幂等性Token
          bsgName String RequestBody参数 存储网关的名称,方便记忆。如果没有指定name,则自动生成,方式:{storage-gateway-八位随机串-序号}。注:随机串从0~9a~z生成。
          zoneName String RequestBody参数 指定可用区信息,默认为空,由系统自动分配。
          flavor String RequestBody参数 指定网关规格(套餐),目前只支持STANDARD
          vpcId string RequestBody参数 将网关创建在指定的VPC内

          返回状态码

          成功返回200,失败返回见错误码

          返回头域

          除公共头域外,无其他特殊头域

          返回参数

          参数名称 类型 描述
          bsgId String 存储网关id,由系统自动生成,方式:{sg-12位随机串}。注:随机串从0~9a~z生成。
          bsgName String 存储网关名称

          请求示例

          POST http://bsg.bj.baidubce.com/v1/bsg?clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: bsg.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
           
           {
           	"bsgName": "bsgExample"
           }

          返回示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
             
           {   
               "bsgId": "sg-kjeptejekuqf"
           }

          查询存储网关列表

          描述

          返回存储网关列表

          请求结构

          GET /v{version}/bsgs?bsgId={bsgId} HTTP/1.1 
          Host: bsg.bj.baidubce.com 
          Authorization: authorization string
          { 
          }

          请求头域

          除公共头域外,无其他特殊头域

          请求参数

          参数名称 类型 是否必须 参数位置 描述
          version String URL参数 API版本号,当前取值1
          bsgId String Query参数 过滤类参数,只返回指定bsgId的结果;不指定该参数则为不过滤

          返回头域

          除公共头域外,无其他特殊头域

          返回参数

          参数名称 类型 描述
          storageGateways List 返回的存储网关信息列表

          请求示例

          GET http://bsg.bj.baidubce.com/v1/bsgs
          Host: bsg.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
           
          { 
          }

          返回示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
            
           {
               "storageGateways": [
                   {
                       "bsgId": "sg-yntceqcsjvha", 
                       "bsgName": "nas20170324183844", 
                       "domain": "popukrorbcwf.bsg.bj.bce.qa.sandbox.baidu.com", 
                       "eip": "", 
                       "status": "running", 
                       "targets": [
                           {
                               "bucketName": "nastest2", 
                               "groupId": "sg-group-hrnilujiyqgv", 
                               "protocolType": "NFS", 
                               "targetId": "sg-target-cznqajasztre"
                           }, 
                           {
                               "bucketName": "nastest1", 
                               "groupId": "sg-group-hrnilujiyqgv", 
                               "protocolType": "NFS", 
                               "targetId": "sg-target-fatxxyyirrju"
                           }, 
                           {
                               "bucketName": "nastest3", 
                               "groupId": "", 
                               "protocolType": "NFS", 
                               "targetId": "sg-target-npwawdxhrifx"
                           }
                       ]
                   }, 
                   {
                       "bsgId": "sg-znknskuetgpu", 
                       "bsgName": "bsgExample", 
                       "domain": "nenwteqhhqqs.bsg.bj.bce.qa.sandbox.baidu.com", 
                       "eip": "", 
                       "status": "creating", 
                       "targets": []
                   }
               ]
           }

          释放存储网关

          描述

          释放指定的存储网关,被释放的存储网关无法找回。

          请求结构

          DELETE /v{version}/bsg/{bsgId}?clientToken={clientToken} HTTP/1.1
          Host: bsg.bj.baidubce.com
          Authorization: authorization string
          { 
          }

          请求头域

          除公共头域外,无其他特殊头域

          请求参数

          参数名称 类型 是否必须 参数位置 描述
          version String URL参数 API版本号,当前取值1
          bsgId String URL参数 待释放的存储网关id
          clientToken String Query参数 幂等性Token

          返回状态码

          成功返回200,失败返回见错误码。

          返回头域

          除公共头域外,无其他特殊头域

          返回参数

          请求示例

          DELETE http://bsg.bj.baidubce.com/v1/bsg/sg-kjeptejekuqf?clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
          Host: bsg.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
           
          { 
          } 

          返回示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
              

          绑定EIP到存储网关

          描述

          挂载指定的EIP到指定存储网关。

          请求结构

          PUT /v{version}/bsg/{bsgId}?{action} HTTP/1.1
          Host: bcc.bj.baidubce.com
          Authorization: authorization string
           {
             "eip": eip
           }

          请求参数

          参数名称 类型 是否必须 参数位置 描述
          version String URL参数 API版本号,当前取值1
          bsgId String URL参数 待查询存储网关的id
          action String Query参数 bindEip
          eip String RequestBody参数 eip

          请求示例

          PUT /v{version}/bsg/sg-ksrvejrksvcy?bindEip HTTP/1.1
          Host: bcc.bj.baidubce.com
          Authorization: authorization string
           {
              "eip":"180.76.0.0"
           }

          返回示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS

          解除EIP绑定

          描述

          解除指定存储网关的IP绑定。

          请求结构

          PUT /v{version}/bsg/{bsgId}?{action} HTTP/1.1
          Host: bcc.bj.baidubce.com
          Authorization: authorization string
           {
             "eip": eip
           }

          请求参数

          参数名称 类型 是否必须 参数位置 描述
          version String URL参数 API版本号,当前取值1
          bsgId String URL参数 待查询存储网关的id
          action String Query参数 unbindEip
          eip String RequestBody参数 eip

          返回状态码

          成功返回200,失败返回见错误码。

          请求示例

          PUT /v{version}/bsg/sg-ksrvejrksvcy?unbindEip HTTP/1.1
           Host: bcc.bj.baidubce.com
           Authorization: authorization string
           {
              "eip":"180.76.0.0"
           }

          返回示例

          HTTP/1.1 200 OK
          Content-Type: application/json;charset=UTF-8
          Date: Wed, 08 Jul 2015 03:28:11 GMT
          x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
          Server: BWS
            
          上一篇
          公共头和错误返回
          下一篇
          共享目标相关接口