账户相关接口
所有文档

          存储网关 BSG

          账户相关接口

          创建存储网关账户

          描述

          创建一个存储网关帐号,返回账户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  
          上一篇
          权限组相关接口
          下一篇
          附录