S3Client aus dem AWS SDK.
Die Beispiele verwenden den Client blob aus Client erstellen.
Beide Methoden benötigen einen API-Schlüssel. Ein mit einem Upload-Token erstellter Client erhält
403 UPLOAD_TOKEN_NOT_ALLOWED.s3()
s3() gibt einen S3Client aus @aws-sdk/client-s3 zurück, bereits konfiguriert mit Endpoint, Region und Zugangsdaten des Gateways sowie mit forcePathStyle: true.
@aws-sdk/client-s3 ist eine optionale Peer-Abhängigkeit: Installiere sie nur, wenn du s3() verwendest. Sie wird erst bei Bedarf geladen, sodass das SDK selbst frei von Abhängigkeiten bleibt. Ohne sie wirft s3() einen einfachen Error, der erklärt, wie du sie installierst oder s3Credentials() an einen anderen S3-Client übergibst. s3() ist nur für Node.js: Wie s3Credentials() braucht es einen API-Schlüssel, der nie in den Browser gelangen darf.
- npm
- yarn
- pnpm
- bun
Buckets
Wie S3-Keys auf Objekte abgebildet werden, erfährst du unter Buckets und Keys, und was das Gateway akzeptiert, unter Unterstützte Operationen.
Ein
PutObject wird als ein einziges Objekt gespeichert, daher ist sein ETag der MD5-Hash des Inhalts.
s3Credentials()
Für andere S3-Clients (aws-cli, rclone, boto3, …) gibt s3Credentials() das rohe Schlüsselpaar zurück:
Verwende bei jedem anderen Client Path-Style-Adressierung.
Caching
Das Paar ist pro API-Schlüssel deterministisch, daher cacht das SDK es pro Client-Instanz:s3Credentials() und s3() rufen die API einmal auf, und spätere Aufrufe verwenden das Ergebnis wieder. Ein fehlgeschlagener Aufruf wird nicht gecacht, sodass der nächste Aufruf es erneut versucht.
API-Referenz: S3 Credentials.
Nächste Schritte
Fehler
Fehlercodes und die Wiederholungsrichtlinie.
S3-Kompatibilität
Was das S3-Gateway unterstützt.

