View a markdown version of this page

Amazon OpenSearch Serverless 的集合端點 - Amazon OpenSearch Service

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

Amazon OpenSearch Serverless 的集合端點

Amazon OpenSearch Serverless NextGen 會在on.aws網域上提供以資源為基礎的端點。您可以使用每個集合端點來存取單一集合,或使用每個帳戶端點來透過一個主機名稱存取 AWS 帳戶 區域中的每個集合。兩個端點皆可透過標準運作 AWS PrivateLink – 從 Amazon VPC 主控台或使用 Amazon EC2 API 建立 VPC CreateVpcEndpoint 端點。

OpenSearch Serverless Classic 在 上使用每個集合端點aoss.amazonaws.com

端點類型

OpenSearch Serverless 支援下列集合端點格式。

OpenSearch Serverless 集合端點格式
端點類型 格式 說明
每個集合 (NextGen) collection-id.aoss.region.on.aws

從主機名稱識別集合。每個集合一個端點。

每個帳戶 (NextGen) account-id.aoss.region.on.aws

從請求標頭識別集合。一個端點會在 AWS 帳戶 區域中為 中的每個集合提供服務。

每次收集 (傳統) collection-id.region.aoss.amazonaws.com

從主機名稱識別集合。每個 Classic 集合一個端點。

這兩種 NextGen 端點格式都使用標準 AWS PrivateLink 進行 VPC 存取。如需有關建立 VPC 端點的詳細資訊,請參閱 透過 的資料平面存取 AWS PrivateLink

在 AWS 區域 支援 FIPS 的 中,OpenSearch Serverless 也提供這些端點的 FIPS 相容變體。如需詳細資訊,請參閱搭配 OpenSearch Serverless 使用 FIPS 端點

每個集合端點

每個集合端點透過包含集合 ID 的主機名稱,以單一集合為目標。端點會顯示在 OpenSearch Serverless 主控台的集合詳細資訊頁面上,並由 collectionEndpoint 欄位中的 BatchGetCollection API 傳回。

格式
  • NextGen: collection-id.aoss.region.on.aws

  • 傳統: collection-id.region.aoss.amazonaws.com

下列請求會將文件編製索引為 1tg2xudton46knx2a95g中集合的movies索引us-east-1

PUT https://1tg2xudton46knx2a95g.aoss.us-east-1.on.aws/movies/_doc/1 { "title": "Shawshank Redemption", "year": 1994 }

每個帳戶端點

每個帳戶端點會透過單一主機名稱 AWS 帳戶 ,以 區域中的每個集合為目標。由於所有集合的主機名稱都相同,因此您可以透過其中一個 HTTP 標頭來識別每個請求上的目標集合 (至少需要一個 ;如果您同時包含兩者,則必須參考相同的集合):

  • x-amz-aoss-collection-name – 客戶指派的集合名稱

  • x-amz-aoss-collection-id – 服務產生的集合 ID

每個帳戶端點可透過 標頭切換每個請求的目標集合,讓單一用戶端跨多個集合共用一個連線集區。這適用於將每個租用戶建模為個別集合的多租用戶應用程式。

使用 x-amz-aoss-collection-name,讓您的應用程式可以使用其已知的名稱來路由請求。您可以略過儲存或查詢服務產生的集合 ID。

每個帳戶端點不會顯示在 OpenSearch Serverless 主控台中。從您的 AWS 帳戶 ID 和 區域建構它。

格式
  • NextGen: account-id.aoss.region.on.aws

下列請求會將文件編製索引至 my-collection123456789012帳戶中的集合movies索引us-east-1

PUT https://123456789012.aoss.us-east-1.on.aws/movies/_doc/1 x-amz-aoss-collection-name: my-collection { "title": "Shawshank Redemption", "year": 1994 }
注意

x-amz-aoss-collection-namex-amz-aoss-collection-id標頭必須是 SigV4-signed. AWS SDKs 會自動執行此操作。