Object Storage Service:PutBucketTransferAcceleration

Observações de uso

• Ao ativar a aceleração de transferência em um bucket, um accelerate endpoint fica disponível além do endpoint padrão. A velocidade de acesso só aumenta quando você utiliza o accelerate endpoint.

• O uso do accelerate endpoint para acessar um bucket gera taxas de aceleração de transferência. Para mais informações, consulte Taxas de aceleração de transferência.

Para obter mais detalhes sobre a aceleração de transferência, consulte Acessar o OSS usando aceleração de transferência.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a essa conta não têm nenhuma permissão inicialmente. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

Estrutura da solicitação

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

Parâmetros da solicitação

Para mais informações sobre cabeçalhos comuns em solicitações PutBucketTransferAcceleration, como Authorization e Content-Length, consulte Cabeçalhos comuns de solicitação.

Cabeçalhos de resposta

A resposta contém apenas cabeçalhos comuns, como x-oss-request-id e Date. Para mais detalhes, consulte Cabeçalhos comuns de resposta.

Exemplos

• Exemplos de solicitação

  A solicitação abaixo ativa a aceleração de transferência para um bucket chamado examplebucket:

  PUT /?transferAcceleration HTTP/1.1
  Date: Fri, 30 Apr 2021 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
  <TransferAccelerationConfiguration>
    <Enabled>true</Enabled>
  </TransferAccelerationConfiguration>

• Exemplos de resposta

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674A4D890****
  Date: Thu, 17 Apr 2025 13:08:38 GMT
  Content-Length: 443
  Connection: keep-alive
  Server: AliyunOSS

SDKs do OSS

Use os SDKs do OSS nas linguagens de programação a seguir para chamar esta operação:

• Java

• Go V2

ossutil

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

Códigos de erro