创建存储网关账户
描述
创建一个存储网关帐号,返回账户id。
请求结构
POST /v{version}/bsgAccount?clientToken={clientToken} HTTP/1.1 
Host: bsg.bj.baidubce.com 
Authorization: authorization string 
 {
  "accountName": accountName,
  "protocolType": protocolType, 
  "nfsFileShareConfig": {
     "ipAddr": ipAddr,
     "rwFlag": rw_flag,
     "squash": squash,
     "sync":sync,
  },
  "smbFileShareConfig": {
     "userName": userName,
     "password": password,
  }
 }
请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号,当前取值1 | 
| clientToken | String | 是 | Query参数 | 幂等性Token | 
| accountName | String | 是 | RequestBody参数 | 账户名称 | 
| protocolType | String | 是 | RequestBody参数 | 账户协议类型,NFS或者SMB | 
| nfsFileShareConfig | nfsFileShareConfig | 否 | RequestBody参数 | 允许NFS协议访问的IP | 
| ipAddr | String | 否 | nfsFileShareConfig | NFS协议允许访问的IP地址,支持CIDR | 
| rwFlag | String | 否 | nfsFileShareConfig | NFS协议账户的读写权限,支持ro只读和rw读写 | 
| squash | String | 否 | nfsFileShareConfig | 支持root_squash限制root用户权限,all_squash限制所有用户权限,no_root_squash不限制root用户权限(缺省值) | 
| sync | String | 否 | nfsFileShareConfig | 支持sync同步写入内存和硬盘,async先写入内存再写入硬盘(缺省值) | 
| smbFileShareConfig | smbFileShareConfig | 否 | RequestBody参数 | SMB协议的账户和密码 | 
| userName | String | 否 | smbFileShareConfig | SMB协议的账户名 | 
| password | String | 否 | smbFileShareConfig | SMB协议的密码 | 
返回状态码
成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 | 
|---|---|---|
| accountId | String | 存储网关账户id | 
| accountName | String | 存储网关账户名 | 
请求示例
																																																	
																																																
POST http://bsg.bj.baidubce.com/v1/bsgAccount?clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676 Host: bsg.bj.baidubce.com Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/
74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
 
 {
 	"accountName": "bsgAccountExample",
 	"protocolType": "NFS",
     "nfsFileShareConfig": {
     	"ipAddr": "0.0.0.0",
     	"rwFlag": "rw",
     	"squash": "all_squash",
     	"sync": "sync"
  	}
 }
																																																
																																																	
																																																
返回示例
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
 
{
 	"accountId": "sg-account-auipmgsvghvq",
    "accountName": "bsgAccountExample"
}
																																																查询存储网关账户列表
描述
返回存储网关账户列表
请求结构
GET /v{version}/bsgAccounts?accountId={accountId} HTTP/1.1 
Host: bsg.bj.baidubce.com 
Authorization: authorization string
{ 
}
																																																请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号,当前取值1 | 
| accountId | String | 否 | Query参数 | 过滤类参数,只返回指定accountId的结果;不指定该参数则为不过滤 | 
返回状态码
成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 | 
|---|---|---|
| marker | String | 标记查询的起始位置 | 
| isTruncated | boolean | true表示后面还有数据,false表示已经是最后一页 | 
| accounts | List | 存储网关账户信息,由accountInfo 组成的集合 | 
请求示例
																																																																						
																																																																					
GET http://bsg.bj.baidubce.com/v1/bsgAccounts 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
 
 {
     "accounts": [
         {
             "accountId": "sg-account-epcmkbzeuqpi", 
             "accountName": "bsgAccountExample", 
             "nfsFileShareConfig": {
                 "ipAddr": "0.0.0.0", 
                 "rwFlag": "rw", 
                 "squash": "all_squash", 
                 "sync": "sync"
             }, 
             "protocolType": "NFS"
         }, 
         {
             "accountId": "sg-account-lantipdyrrvk", 
             "accountName": "account", 
             "nfsFileShareConfig": {
                 "ipAddr": "127.0.0.1", 
                 "rwFlag": "rw", 
                 "squash": "no_root_squash", 
                 "sync": "sync"
             }, 
             "protocolType": "NFS"
         }
 	]
 }
																																																																					删除存储网关账户
描述
删除指定的存储网关账户
请求结构
DELETE /v{version}/bsgAccount/{accountid}?clientToken={clientToken} HTTP/1.1
Host: bsg.bj.baidubce.com
Authorization: authorization string
{ 
}
																																																																					请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号,当前取值1 | 
| clientToken | String | 是 | Query参数 | 幂等性Token | 
| accountId | String | 是 | URL参数 | 待删除的账户id | 
返回状态码
成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数 无
请求示例
																																																																																		
																																																																																	
DELETE http://bsg.bj.baidubce.com/v1/bsgAccount/sg-account-auipmgsvghvq?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
ontent-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
																																																																																	关联存储网关账户和权限组
描述
关联执行的存储账户和权限组
请求结构
PUT /v{version}/bsgGroup/{groupId}?{action} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
 {
   "accountId":
 }
																																																																																	请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号,当前取值1 | 
| groupId | String | 是 | URL参数 | 权限组ID | 
| action | String | 是 | Query参数 | associateAccountToGroup | 
| accountId | String | 是 | RequestBody参数 | 关联到指定权限组的账户id | 
返回状态码
成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数
无
请求示例
PUT http://bsg.bj.baidubce.com/v1/bsgGroup/sg-group-nrndvrpomsyh?associateAccountToGroup Host: bsg.bj.baidubce.com Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host
/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
 
 {
 	"accountId": "sg-account-xngmdzrgecpd"
 }
																																																																																																
																																																																																																返回示例
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
																																																																																																解除存储网关账户和权限组的关联
描述
解除存储账户和权限组的关联关系
请求结构
PUT /v{version}/bsgGroup/{groupId}?{action} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
   "accountId": accountId
}
																																																																																																请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号,当前取值1 | 
| groupId | String | 是 | URL参数 | 权限组ID | 
| action | String | 是 | Query参数 | dissociateAccountFromGroup | 
| accountId | String | 是 | RequestBody参数 | 解除关联的账户id | 
返回状态码
成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数
无
请求示例
																																																																																																																
																																																																																																															
PUT http://bsg.bj.baidubce.com/v1/bsgGroup/sg-group-nrndvrpomsyh?dissociateAccountFromGroup Host: bsg.bj.baidubce.com Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host
/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
 
 {
 	"accountId": "sg-account-xngmdzrgecpd"
 }
																																																																																																															
																																																																																																																
																																																																																																															
返回示例
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
																																																																																																															
																																																																																																																
																																																																																																															






