Menanyakan wilayah dari sebuah bucket Object Storage Service (OSS). Hanya pemilik bucket yang dapat menanyakan wilayah bucket tersebut.
Sintaks permintaan
GET /?location HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueHeader permintaan
Semua header dalam permintaan DescribeRegions merupakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.
Header respons
Semua header dalam respons terhadap permintaan DescribeRegions merupakan header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.
Elemen respons
Elemen | Tipe | Contoh | Deskripsi |
LocationConstraint | String | oss-cn-hangzhou | ID wilayah OSS, yang menentukan wilayah tempat bucket berada. |
Contoh
Contoh Permintaan
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 Contoh Respons Sukses
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 >OSS SDK
Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil GetBucketLocation:
Kode kesalahan
Kode kesalahan | Status HTTP | Deskripsi |
AccessDenied | 403 | Anda tidak memiliki izin untuk menanyakan wilayah bucket. Hanya pemilik bucket yang dapat menanyakan wilayah tempat bucket tersebut berada. |