文档

GetBucketResourceGroup

更新时间:

调用GetBucketResourceGroup接口查询存储空间(Bucket)的资源组ID。

注意事项

阿里云账号默认拥有为Bucket配置查询资源组的权限。如果您希望通过RAM用户或者STS的方式进行查询,您必须拥有oss:GetBucketResourceGroup权限。具体操作,请参见为RAM用户授权自定义的权限策略

请求语法

GET /?resourceGroup
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅包含公共请求头。更多信息,请参见公共请求头(Common Request Headers)

响应头

此接口仅包含公共响应头。更多信息,请参见公共响应头(Common Response Headers)

响应元素

名称

类型

示例值

描述

BucketResourceGroupConfiguration

容器

不涉及

显示资源组ID的容器。

子节点:ResourceGroupId

ResourceGroupId

字符串

rg-aek27tc********

Bucket所属的资源组ID。

如果Bucket属于默认资源组,则返回值为rg-default-id。

父节点:BucketResourceGroupConfiguration

示例

请求示例

GET /?resourceGroup
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Sat, 8 May 2021 07:51:28 GMT
Authorization: OSS qn6q**************:77Dv****************

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 8 May 2021 07:51:28 GMT
Connection: keep-alive
Content-Length: 531
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<BucketResourceGroupConfiguration>
  <ResourceGroupId>rg-xxxxxx</ResourceGroupId>
</BucketResourceGroupConfiguration>

错误码

错误码

HTTP状态码

描述

NoSuchBucket

404

请求的目标Bucket不存在。

AccessDenied

403

返回该错误的可能原因如下:

  • 发起请求时没有传入用户验证信息。

  • 没有操作权限。

  • 本页导读 (1)