View a markdown version of this page

使用 REST API 提出要求 - Amazon Simple Storage Service
為 REST API 請求建構 S3 主機名稱虛擬主辦式和路徑式請求雙重堆疊端點 (REST API)

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 REST API 提出要求

本節包含如何使用 REST API 向 Amazon S3 端點提出請求的資訊。如需 Amazon S3 端點的清單，請參閱《AWS 一般參考》中的區域與端點。

為 REST API 請求建構 S3 主機名稱

Amazon S3 端點遵循如下所示的結構：

s3.Region.amazonaws.com

Amazon S3 存取點端點和雙堆疊端點也遵循標準結構：

  • Amazon S3 存取點 ‐s3-accesspoint.Region.amazonaws.com

  • 雙堆疊 ‐ s3.dualstack.Region.amazonaws.com

如需 Amazon S3 區域和端點的完整清單，請參閱《Amazon Web Services 一般參考》中的 Amazon S3 端點和配額。

虛擬主辦式和路徑式請求

使用 REST API 提出請求時，可以使用 Amazon S3 端點的虛擬託管式或路徑式 URI。如需詳細資訊，請參閱路徑樣式請求 。

範例虛擬託管式請求

下例是從美國西部 (奧勒岡) 區域中名為 puppy.jpg 的儲存貯體中刪除 examplebucket 檔案的虛擬託管式請求。如需虛擬託管樣式請求的詳細資訊，請參閱路徑樣式請求 。

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
範例路徑型要求

下例是相同要求的路徑型版本。

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

Amazon S3 目前支援所有 AWS 區域中的虛擬託管樣式 URL 與路徑樣式 URL 存取權。但是，將來會停產路徑樣式 URL。如需詳細資訊，請參閱下列 Important (重要) 注意事項。

如需路徑樣式請求的詳細資訊，請參閱路徑樣式請求。

重要

更新 (2020 年 9 月 23 日) – 我們決定將棄用路徑樣式 URL 的日期延後，以確保客戶有足夠時間轉換為虛擬託管樣式 URL。如需詳細資訊，請參閱 AWS 新聞部落格中的 Amazon S3 路徑廢除計畫 - 其他故事。

使用 REST API 提出雙重堆疊端點要求

使用 REST API 時，可以使用虛擬託管型或路徑型端點名稱 (URI)，直接存取雙重堆疊端點。所有 Amazon S3 雙重堆疊端點名稱，在名稱中都包含區域。與標準型僅 IPv4 端點不同，虛擬託管型和路徑型端點都會使用區域專屬的端點名稱。

範例虛擬託管式雙重堆疊端點請求

您可在 REST 請求中使用虛擬託管式端點 (如下例所示)，從美國西部 (奧勒岡) 區域中名為 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
範例路徑型雙重堆疊端點要求

或者，您可在要求中使用路徑型端點，如下例所示。

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

如需雙重堆疊端點的詳細資訊，請參閱「使用 Amazon S3 雙堆疊端點」。

如需使用 REST API 提出請求的詳細資訊，請參閱下列主題。

主題