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