创建存储网关
描述
- 创建一个存储网关,返回分配的服务地址以及实例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
		





