API de stockage d’objets
Stockage d’objets compatible S3. Émettez des identifiants propres à chaque compartiment, connectez directement tout SDK S3 et ne payez aucun trafic sortant pour les lectures.
- Identifiants : Access Key / Secret Key émis pour un seul compartiment et valides uniquement pour lui. Le secret n’est affiché qu’une fois ; une nouvelle clé devient active après environ une minute
- Configuration SDK : région toujours auto, avec adressage par hôte virtuel. Exemples Node.js / Python / Go / PHP / aws-cli
- CORS : requis avant tout envoi ou lecture directe depuis le navigateur ; l’origine doit être un domaine précis, jamais un joker
- URL présignées : disponibles pour les envois et téléchargements, afin de donner au navigateur un lien temporaire plutôt qu’une clé
- Limites et tarifs : 5 GiB par PUT simple et jusqu’à 10000 parties par envoi multipartite. Le stockage est facturé à l’usage quotidien réel ; suppressions et trafic sortant sont gratuits
Vue d’ensemble
Stockage objet compatible S3. Créez des identifiants par compartiment, utilisez-les avec n’importe quel SDK S3, sans frais de trafic sortant.
Votre configuration aws-sdk, boto3, s3cmd ou rclone continue à fonctionner — remplacez le point d’accès et définissez region sur auto.
Identifiants
Créez-les par compartiment dans Stockage objet → Compartiments → Clés. Chaque identifiant est limité à ce compartiment et ne donne pas accès aux autres.
- Endpoint — Point d’accès S3, par ex. https://<account>.r2.cloudflarestorage.com
- Bucket — Nom réel du compartiment (préfixé par la plateforme, différent de l’alias choisi)
- Access Key ID — Access Key ID
- Secret Access Key — Secret Access Key — affichée une seule fois à la création
- Region — Toujours auto. us-east-1 ou une valeur similaire invalide la signature et chaque requête renvoie 403 SignatureDoesNotMatch
Un nouvel identifiant met environ une minute à atteindre les nœuds de stockage ; entre-temps, les appels renvoient 401 Unauthorized. La clé n’est pas incorrecte — patientez et réessayez. C’est une cause fréquente de diagnostic erroné lors de la première intégration.
Nous ne conservons jamais la Secret Access Key ; elle n’est plus récupérable après fermeture de la fenêtre. En cas de perte, il faut supprimer la clé et en créer une autre, ce qui interrompt votre intégration active — enregistrez-la immédiatement dans votre gestionnaire de secrets.
Configuration du SDK
Renseignez les quatre valeurs de la console dans le SDK S3 que vous utilisez déjà.
Utilisez l’adressage virtual-host (par défaut) ; n’activez pas path-style. Une erreur entraîne 404 / NoSuchBucket, ce qui ressemble à une faute dans le nom du compartiment.
CORS
Un navigateur ne peut accéder directement au compartiment (envoi ou lecture depuis votre interface) qu’après configuration de CORS. Sinon, la requête est bloquée avant son envoi : erreur CORS dans la console et aucune trace côté serveur. Configurez-le dans Compartiments → Paramètres → CORS.
Une origine générique permet à tout site de lire et d’écrire dans ce compartiment avec les identifiants de vos visiteurs, sans trace d’accès vérifiable. Listez des domaines précis.
URL présignées
Fournissez au navigateur des URL temporaires plutôt que des identifiants dans l’interface. Les envois et téléchargements peuvent être présignés : les gros fichiers ne passent jamais par vos serveurs.
Limites
- 5 GiB par PUT ; utilisez un envoi multipart pour les fichiers plus volumineux
- Jusqu’à environ 4,995 TiB par objet en multipart, 10 000 parties maximum
- Clés d’objet jusqu’à 1024 octets
- Une écriture simultanée par seconde sur la même clé d’objet
Tarification
Aucun supplément dans les limites de votre forfait ; au-delà, les tarifs suivants s’appliquent.
- Stockage — $0.03 / GB·mois — Facturation selon l’utilisation quotidienne réelle, et non le pic
- $9.00 / 1M — Opérations d’écriture et de liste (PutObject, ListObjects, multipart, …)
- $0.72 / 1M — Opérations de lecture (GetObject, HeadObject, …)
- Trafic sortant — Gratuit — Aucun frais de bande passante à la lecture — la principale différence de coût avec le stockage objet traditionnel
- Suppressions — Gratuit — La suppression d’objets ou de compartiments et l’abandon d’envois multipart sont gratuits
Moins cher par GB, mais avec une conservation minimale de 30 jours (une suppression anticipée reste facturée sur 30 jours) et des frais à chaque lecture. Pour un compartiment lu quotidiennement, la facture augmente ; cette classe convient aux archives et sauvegardes écrites souvent, lues rarement.
Questions fréquentes
Pourquoi de nouveaux identifiants renvoient-ils encore 401 ?
De nouveaux identifiants mettent environ une minute à atteindre les nœuds de stockage. Pendant ce délai, les appels renvoient 401 Unauthorized. La clé n’est pas incorrecte : attendez brièvement puis réessayez. C’est une source fréquente de faux diagnostic lors d’une première intégration.
Quelle région utiliser et qu’est-ce qui provoque SignatureDoesNotMatch ?
La région est toujours auto. Utiliser us-east-1 ou une valeur similaire invalide la signature : chaque requête renvoie 403 SignatureDoesNotMatch. Gardez l’adressage par hôte virtuel et n’activez pas le mode par chemin, qui provoque 404 NoSuchBucket.
Pages connexes: Documentation API · Services cloud Tovanix · Utiliser les domaines
Chargement…