本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 支援下列集合端點格式。
| 端點類型 | 格式 | 說明 |
|---|---|---|
| 每個集合 (NextGen) | |
從主機名稱識別集合。每個集合一個端點。 |
| 每個帳戶 (NextGen) | |
從請求標頭識別集合。一個端點會在 AWS 帳戶 區域中為 中的每個集合提供服務。 |
| 每次收集 (傳統) | |
從主機名稱識別集合。每個 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-name 和 x-amz-aoss-collection-id標頭必須是 SigV4-signed. AWS SDKs 會自動執行此操作。