全部產品
Search
文件中心

Object Storage Service:GetBucketLocation

更新時間:May 07, 2025

GetBucketLocation介面用於查看儲存空間(Bucket)的位置資訊。只有Bucket的擁有者才能查看Bucket的位置資訊。

請求文法

GET /?location HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

要求標頭

此介面僅涉及公用要求標頭。更多資訊,請參見公用要求標頭(Common Request Headers)

回應標頭

此介面僅涉及公用回應標頭。更多資訊,請參見公用回應標頭(Common Response Headers)

響應元素

名稱

類型

樣本值

描述

LocationConstraint

字串

oss-cn-hangzhou

Bucket所在地區,格式為OSS專用Region ID。

樣本

請求樣本

Get /?location HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 05:31:04 GMT  
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e          

返回樣本

HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 15 Mar 2013 05:31:04 GMT
Connection: keep-alive
Content-Length: 90 
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<LocationConstraint>oss-cn-hangzhou</LocationConstraint >

SDK

此介面所對應的各語言SDK如下:

命令列工具ossutil

GetBucketLocation介面所對應的ossutil命令,請參見get-bucket-location

錯誤碼

錯誤碼

HTTP狀態代碼

描述

AccessDenied

403

沒有查看Bucket位置資訊的許可權。只有Bucket的擁有者才能查看Bucket的位置資訊。