Object Storage Service:GetBucketTransferAcceleration

Observações de uso

• Somente o proprietário de um bucket ou usuários RAM com a permissão oss:PutBucketTransferAcceleration podem iniciar solicitações para consultar as configurações de aceleração de transferência de um bucket.

• Se a aceleração de transferência não estiver configurada para o bucket ao qual você envia a solicitação GetBucketTransferAcceleration, nenhuma configuração será retornada.

Para mais informações sobre aceleração de transferência, consulte Access OSS using transfer acceleration no Guia do Desenvolvedor.

Estrutura da solicitação

GET /?transferAcceleration HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue

Parâmetros de resposta

Para mais informações sobre outros cabeçalhos de resposta comuns, como x-oss-request-id e Date, presentes na resposta de uma solicitação GetBucketTransferAcceleration, consulte Common response headers.

Exemplos

• Exemplos de solicitação

  A solicitação de exemplo a seguir consulta o status da aceleração de transferência de um bucket chamado examplebucket:

  GET /?transferAcceleration HTTP/1.1
  Date: Thu, 17 Apr 2025 13:08:38 GMT
  Content-Length：443
  Content-Type: application/xml
  Host: examplebucket.oss.aliyuncs.com
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

• Exemplos de resposta

  A resposta a seguir indica que a aceleração de transferência está ativa para o examplebucket:

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674E88A4D8906****
  Date: Fri , 30 Apr 2021 13:08:38 GMT
  <TransferAccelerationConfiguration>
   <Enabled>true</Enabled>
  </TransferAccelerationConfiguration>

SDKs do OSS

Use os SDKs do OSS para as seguintes linguagens de programação para chamar a operação GetBucketTransferAcceleration:

• Java

• Go V2

ossutil

Para informações sobre o comando ossutil correspondente à operação GetBucketTransferAcceleration, consulte get-bucket-transfer-acceleration.

Códigos de erro