文档简介:
	
	
创建存储网关权限组
描述
创建存储网关权限组,返回权限组id
请求结构
POST /v{version}/bsgGroup?clientToken={clientToken} HTTP/1.1 
Host: bsg.bj.baidubce.com 
Authorization: authorization string 
 {
  "groupName": groupName,
  "protocolType": protocolType
 }
请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号,当前取值1 | 
| clientToken | String | 是 | Query参数 | 幂等性Token | 
| groupName | String | 否 | RequestBody参数 | 
						存储网关账户名称,方便记忆。如果没有指定name,则自动生成, 方式:{storage-gateway-account-八位随机串-序号}。注:随机串从0~9a~z生成。  | 
										
| protocolType | String | 是 | RequestBody参数 | 协议类型,NFS SMB | 
返回状态码
成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 | 
|---|---|---|
| groupId | String | 存储网关权限组id | 
| groupName | String | 存储网关权限组名称 | 
| protocolType | String | 存储网关权限组协议 | 
请求示例
																												
																											
POST http://bsg.bj.baidubce.com/v1/bsgGroup?clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676 Host: bsg.bj.baidubce.com Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host
/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
 
 {
 	"groupName": "bsgGroupExample",
 	"protocolType": "NFS"
 }
																											
																												
																											
返回示例
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
 
 {
     "groupId": "sg-group-nrndvrpomsyh", 
     "groupName": "bsgGroupExample"
 }
																											查询存储网关权限组列表
描述
返回权限组列表
请求结构
GET /v{version}/bsgGroups?groupId={groupId} HTTP/1.1 
Host: bsg.bj.baidubce.com 
Authorization: authorization string
																											请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号,当前取值1 | 
| groupId | String | 否 | Query参数 | 过滤类参数,只返回指定groupId的结果;不指定该参数则为不过滤 | 
返回参数
| 参数名称 | 类型 | 描述 | 
|---|---|---|
| groups | List | 存储网关账户信息,由groupInfo 组成的集合 | 
返回状态码
成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
请求示例
																																											
																																										
GET http://bsg.bj.baidubce.com/v1/bsgGroups 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": [
                 "sg-account-lantipdyrrvk", 
                 "sg-account-frldmthghwqr"
             ], 
             "groupId": "sg-group-hrnilujiyqgv", 
             "groupName": "bsgGroupExample1", 
             "protocolType": "NFS"
         }, 
         {
             "accounts": [
                 ""
             ], 
             "groupId": "sg-group-nrndvrpomsyh", 
             "groupName": "bsgGroupExample", 
             "protocolType": "NFS"
         }
 }
																																										删除存储网关权限组
描述
删除指定的存储网关权限组
请求结构
DELETE /v{version}/bsgGroup/{groupId}?clientToken={clientToken} HTTP/1.1
Host: bsg.bj.baidubce.com
Authorization: authorization string
{ 
}
																																										请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号,当前取值1 | 
| clientToken | String | 是 | Query参数 | 幂等性Token | 
返回状态码
成功返回200,失败返回见错误码
返回头域
除公共头域外,无其他特殊头域
返回参数 无
请求示例
																																																				
																																																			
DELETE http://bsg.bj.baidubce.com/v1/bsgGroup/sg-group-nrndvrpomsyh?clientToken=3A8d84403d-a94b-40ce-9d6a
-f6225dd26676Host: 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
																																																			关联权限组到共享目标
描述
将指定的权限组关联到指定的共享目标。
请求结构
PUT /v{version}/bsgGroup/{groupId}?{action} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
 {
   "bsgId": bsgId,
   "targetId": targetId
 }
																																																			请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号,当前取值1 | 
| groupId | String | 是 | URL参数 | 权限组ID | 
| action | String | 是 | Query参数 | associateGroupToShareTarget | 
| bsgId | String | 是 | RequestBody参数 | 共享目标所在的存储网关id | 
| targetId | String | 是 | RequestBody参数 | 共享目标id | 
返回状态码
成功返回200,失败返回见错误码。
返回头域
除公共头域外,无其他特殊头域
返回参数
无
请求示例
																																																																						
																																																																					
PUT http://bsg.bj.baidubce.com/v1/bsgGroup/sg-group-nrndvrpomsyh?associateGroupToShareTarget&clientToken
=3A8d84403d-a94b-40ce-9d6a-f6225dd26676 Host: bsg.bj.baidubce.com Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host
/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
 
 {
 	"bsgId": "sg-ksrvejrksvcy",
 	"targetId": "sg-target-utlxhrimolyl"
 }
																																																																					
																																																																						
																																																																					
返回示例
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
 {
   "bsgId": bsgId,
   "targetId": targetId
 }
																																																																					请求头域
除公共头域外,无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 | 
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号,当前取值1 | 
| groupId | String | 是 | URL参数 | 权限组ID | 
| action | String | 是 | Query参数 | dissociateGroupFromShareTarget | 
| bsgId | String | 是 | RequestBody参数 | 共享目标所在的存储网关id | 
| targetId | String | 是 | RequestBody参数 | 共享目标id | 
返回状态码
成功返回200,失败返回见错误码。
返回头域
除公共头域外,无其他特殊头域
返回参数
无
请求示例
																																																																																								
																																																																																							
PUT http://bsg.bj.baidubce.com/v1/bsgGroup/sg-group-nrndvrpomsyh?dissociateGroupFromShareTarget&clientToken
=3A8d84403d-a94b-40ce-9d6a-f6225dd26676 Host: bsg.bj.baidubce.com Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host
/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
 
 {
 	"bsgId": "sg-ksrvejrksvcy",
 	"targetId": "sg-target-utlxhrimolyl"
 }
																																																																																							
																																																																																								
																																																																																							
返回示例
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
																																																																																							
																																																																																								
																																																																																							
																																																																																								
																																																																																							






