Tous les produits
Search
Centre de documentation

Object Storage Service:put-bucket-transfer-acceleration

Dernière mise à jour :Aug 18, 2026

Configurez l'accélération de transfert pour un compartiment (bucket). L'accélération de transfert améliore la vitesse d'accès à OSS pour les utilisateurs du monde entier et convient aux transferts de données sur de longues distances ainsi qu'au chargement et au téléchargement d'objets volumineux.

Notes d'utilisation

  • Une fois l'accélération de transfert activée pour un compartiment, un endpoint d'accélération devient disponible en plus de l'endpoint par défaut. La vitesse d'accès n'est accélérée que si vous utilisez l'endpoint d'accélération.

  • Des frais d'accélération de transfert s'appliquent lorsque vous accédez à un compartiment via l'endpoint d'accélération. Pour plus d'informations, consultez la rubrique Frais d'accélération de transfert.

Pour en savoir plus sur l'accélération de transfert, consultez la rubrique Accéder à OSS via l'accélération de transfert.

Syntaxe de la commande

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

Paramètre

Type

Description

--bucket

string

Nom du compartiment.

--transfer-acceleration-configuration

string

Conteneur stockant les configurations d'accélération de transfert.

Remarque

La commande put-bucket-transfer-acceleration équivaut à l'opération API PutBucketTransferAcceleration. Pour plus d'informations sur cette opération API, consultez la rubrique PutBucketTransferAcceleration.

--transfer-acceleration-configuration

L'option --transfer-acceleration-configuration prend en charge les formats XML et JSON.

  • Format XML :

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

    {
      "Enabled": boolean
    }
Remarque

Pour plus d'informations, consultez la rubrique Options de ligne de commande.

Exemples

Configurez l'accélération de transfert pour un compartiment nommé examplebucket.

  • Utilisez un fichier de configuration XML (transfer-acceleration-configuration.xml dans cet exemple)

    <?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
  • Utilisez un fichier de configuration JSON (transfer-acceleration-configuration.json dans cet exemple)

    {
            "Enabled": "true"
    }
    ossutil api put-bucket-transfer-acceleration --bucket examplebucket --transfer-acceleration-configuration file://transfer-acceleration-configuration.json
  • Utilisez des paramètres JSON directement dans la ligne de commande

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