Todos os produtos
Search
Central de documentação

Object Storage Service:GetBucketLocation

Última atualização: Jul 03, 2026

Consulta a região de um bucket do OSS. Somente o proprietário do bucket pode chamar esta operação.

Sintaxe da requisição

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

Cabeçalhos da requisição

O DescribeRegions utiliza apenas cabeçalhos comuns de requisição. Para obter mais informações, consulte Cabeçalhos comuns de requisição.

Cabeçalhos da resposta

A resposta contém apenas cabeçalhos comuns de resposta. Para obter mais informações, consulte Cabeçalhos comuns de resposta.

Elementos da resposta

Elemento

Tipo

Exemplo

Descrição

LocationConstraint

String

oss-cn-hangzhou

ID da região do bucket, como oss-cn-hangzhou.

Exemplos

Exemplo de requisição

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          

Exemplo de resposta de sucesso

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 >

SDKs do OSS

Use os seguintes SDKs do OSS para chamar o GetBucketLocation:

Códigos de erro

Código de erro

Código de status HTTP

Descrição

AccessDenied

403

Você não tem permissão para consultar a região do bucket. Apenas o proprietário do bucket pode executar esta operação.