Todos os produtos
Search
Central de documentação

Object Storage Service:put-bucket-transfer-acceleration

Última atualização: Sep 24, 2026

Configura a aceleração de transferência para um bucket. A aceleração de transferência melhora a velocidade de acesso ao OSS por usuários em todo o mundo, sendo ideal para transferências de dados de longa distância e para upload e download de objetos grandes.

Notas de uso

  • Após ativar a aceleração de transferência para um bucket, um endpoint de aceleração ficará disponível além do endpoint padrão. A velocidade de acesso só é acelerada quando você utiliza o endpoint de aceleração.

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

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

Sintaxe do comando

ossutil api put-bucket-transfer-acceleration --bucket value --transfer-acceleration-configuration value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket.

--transfer-acceleration-configuration

string

O contêiner que armazena as configurações de aceleração de transferência.

Nota

O comando put-bucket-transfer-acceleration equivale à operação PutBucketTransferAcceleration. Para obter mais informações sobre a operação da API, consulte PutBucketTransferAcceleration.

--transfer-acceleration-configuration

A opção --transfer-acceleration-configuration aceita os formatos XML e JSON.

  • Formato XML:

    <TransferAccelerationConfiguration>
      <Enabled>boolean</Enabled>
    </TransferAccelerationConfiguration>
  • Formato JSON:

    {
      "Enabled": boolean
    }
Nota

Para obter mais informações, consulte Command-line options.

Exemplos

Ative a aceleração de transferência para um bucket chamado examplebucket.

  • Com um arquivo de configuração XML (neste exemplo, transfer-acceleration-configuration.xml)

    <?xml version="1.0" encoding="UTF-8"?>
    <TransferAccelerationConfiguration>
      <Enabled>true</Enabled>
    </TransferAccelerationConfiguration>
    ossutil api put-bucket-transfer-acceleration --bucket examplebucket --transfer-acceleration-configuration file://transfer-acceleration-configuration.xml
  • Com um arquivo de configuração JSON (neste exemplo, transfer-acceleration-configuration.json)

    {
            "Enabled": "true"
    }
    ossutil api put-bucket-transfer-acceleration --bucket examplebucket --transfer-acceleration-configuration file://transfer-acceleration-configuration.json
  • Com parâmetros JSON diretamente na linha de comando

    ossutil api put-bucket-transfer-acceleration --bucket examplebucket --transfer-acceleration-configuration "{\"Enabled\":\"true\"}"