本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 會自動執行此操作。