全部產品
Search
文件中心

Object Storage Service:GetBucketResourceGroup

更新時間:Jun 19, 2024

調用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

返回該錯誤的可能原因如下:

  • 發起請求時沒有傳入使用者驗證資訊。

  • 沒有操作許可權。