Senden von Anforderungen unter Verwendung der REST-API
In diesem Abschnitt finden Sie Informationen zum Senden von Anfragen an Amazon-S3-Endpunkte über die REST-API. Eine Liste der Amazon-S3-Endpunkte finden Sie unter Regions and Endpoints (Regionen und Endpunkte) in der Allgemeinen AWS-Referenz.
Erstellen von S3-Hostnamen für REST-API-Anforderungen
Amazon-S3-Endpunkte folgen der folgenden Struktur:
s3.Region.amazonaws.com
Amazon-S3-Zugriffspunkte-Endpunkte und Dual-Stack-Endpunkte folgen ebenfalls der Standardstruktur:
-
Amazon-S3-Zugriffspunkte ‐
s3-accesspoint.Region.amazonaws.com -
Dual-stack ‐
s3.dualstack.Region.amazonaws.com
Eine vollständige Liste der Amazon-S3-Regionen und -Endpunkte finden Sie unter Amazon-S3-Endpunkte und -Quoten in der Allgemeinen Referenz zu Amazon Web Services.
Virtuell gehostete und Pfad-Stil-Anforderungen
Wenn Sie Anforderungen über die REST-API senden, können Sie für die Amazon-S3-Endpunkte URIs im virtuell gehosteten oder im Pfad-Stil verwenden. Weitere Informationen finden Sie unter Virtuelles Hosting bei Buckets.
Beispiel Anforderung im virtuell gehosteten Stil
Nachfolgend finden Sie ein Beispiel für eine virtuell gehostete Anforderung zum Löschen der Datei puppy.jpg aus dem Bucket examplebucket in der Region USA West (Oregon). Weitere Informationen zum Wiederholen von Anforderungen finden Sie unter Anforderungen im virtuellen Hosting-Format.
DELETE /puppy.jpg HTTP/1.1 Host: examplebucket.s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:authorization string
Beispiel Pfadanforderung
Im Folgenden finden Sie ein Beispiel für eine Path-Style-Version derselben Anfrage.
DELETE /examplebucket/puppy.jpg HTTP/1.1 Host: s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:authorization string
Derzeit unterstützt Amazon S3 den URL-Zugriff in allen AWS-Regionen sowohl im virtuellem Hosting- als auch im Pfadformat. URLs im Pfadformat werden jedoch in naher Zukunft eingestellt. Weitere Informationen finden Sie im folgenden wichtigen Hinweis.
Weitere Informationen zu Anforderungen im Pfadformat finden Sie unter Anforderungen im Pfadformat.
Update (23. September 2020) – Wir haben das Veralten von URLs im Pfadformat verschoben, um sicherzustellen, dass Kunden genügend Zeit haben, um zu URLs im virtuellen Hosting-Format zu wechseln. Weitere Informationen finden Sie unter Amazon S3 Path Deprecation Plan – The Rest of the Story
Senden von Anforderungen an Dual-Stack-Endpunkte unter Verwendung der REST-API
Wenn Sie die REST-API verwenden, können Sie direkt auf einen Dual-Stack-Endpunkt zugreifen, indem Sie einen Virtual-Hosted-Style- oder Path-Style-Endpunktnamen (URI) verwenden. Alle Amazon-S3-Dual-Stack-Endpunktnamen enthalten die Region. Anders als im Fall von Standardendpunkten, die nur IPv4 verwenden, verwenden sowohl Virtual-Hosted-Style- als auch Path-Style-Endpunkte regionsspezifische Endpunktnamen.
Beispiel Dual-Stack-Endpunkt-Anforderung im virtuell gehosteten Stil
Sie können in Ihrer REST-Anforderung einen virtuell gehosteten Endpunkt wie im folgenden Beispiel gezeigt verwenden, der das Objekt puppy.jpg aus dem Bucket examplebucket in der Region USA West (Oregon) abruft.
GET /puppy.jpg HTTP/1.1 Host: examplebucket.s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:authorization string
Beispiel Pfadanforderungen für Dual-Stack-Endpunkte
Sie können auch wie im folgenden Beispiel gezeigt einen Path-Style-Endpunkt in Ihrer Anfrage verwenden.
GET /examplebucket/puppy.jpg HTTP/1.1 Host: s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:authorization string
Weitere Informationen zu Dual-Stack-Endpunkten finden Sie unter Verwenden von Amazon-S3-Dual-Stack-Endpunkten.
Weitere Informationen über das Senden von Anfragen mit der REST-API finden Sie in den folgenden Themen.
