文档简介:
创建存储网关权限组
描述
创建存储网关权限组,返回权限组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