Anfragen stellen mit dem REST API - Amazon Simple Storage Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Anfragen stellen mit dem REST API

Dieser Abschnitt enthält Informationen darüber, wie Sie Anfragen an Amazon S3 S3-Endpunkte mithilfe von stellen können. REST API Eine Liste der Amazon-S3-Endpunkte finden Sie unter Regionen und Endpunkte in der Allgemeine AWS-Referenz.

Konstruieren von S3-Hostnamen für Anfragen REST API

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-Zugriffspunktes3-accesspoint.Region.amazonaws.com

  • Dual-stacks3.dualstack.Region.amazonaws.com

Eine vollständige Liste der Amazon-S3-Regionen und -Endpunkte finden Sie unter Endpunkte und Kontingente von Amazon S3 in der Allgemeine Amazon Web Services-Referenz.

Virtuell gehostete und Pfad-Stil-Anforderungen

Wenn Sie Anfragen mit dem stellen RESTAPI, können Sie URIs für die Amazon S3 S3-Endpunkte den virtuellen Hosted-Stil oder den 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 sowohl virtuell gehosteten Zugriff als auch Pfadzugriff. URL AWS-Regionen Path-Style URLs wird jedoch in future eingestellt. Weitere Informationen finden Sie im folgenden wichtigen Hinweis.

Weitere Informationen zu Anforderungen im Pfadformat finden Sie unter Anforderungen im Pfadformat.

Wichtig

Update (23. September 2020) — Um sicherzustellen, dass Kunden die Zeit haben, die sie für die Umstellung auf virtuell gehostete Systeme benötigen, haben wir beschlossenURLs, die Einstellung von Path-Style zu verzögern. URLs Weitere Informationen finden Sie unter Amazon S3 Path Deprecation Plan – The Rest of the Story im AWS News Blog.

Anfragen an Dual-Stack-Endpunkte stellen mit dem REST API

Wenn Sie den verwenden RESTAPI, können Sie direkt auf einen Dual-Stack-Endpunkt zugreifen, indem Sie einen Endpunktnamen im virtuellen Hosted-Stil oder einen Pfadstil verwenden (). URI Alle Amazon-S3-Dual-Stack-Endpunktnamen enthalten die Region. Im Gegensatz zu den reinen Standardendpunkten IPv4 verwenden sowohl virtuelle Host-Endpoints als auch Pfadendpunkte regionsspezifische Endpunktnamen.

Beispiel Dual-Stack-Endpunkt-Anforderung im virtuell gehosteten Stil

Sie können in Ihrer REST Anfrage einen Endpunkt im Stil eines virtuellen Hosts verwenden, wie im folgenden Beispiel gezeigt, mit dem das Objekt aus dem Bucket abgerufen wird, der in der Region USA West (Oregon) benannt ist. puppy.jpg examplebucket

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 zum Stellen von Anfragen mithilfe von finden Sie in den REST API folgenden Themen.