使用 REST API 提出要求 - Amazon Simple Storage Service

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

使用 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 提出請求的詳細資訊,請參閱下方的主題。