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

# Amazon OpenSearch Serverless 的集合端點
<a name="serverless-collection-endpoints"></a>

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

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

**Topics**
+ [端點類型](#serverless-collection-endpoints-types)
+ [每個集合端點](#serverless-per-collection-endpoint)
+ [每個帳戶端點](#serverless-per-account-endpoint)

## 端點類型
<a name="serverless-collection-endpoints-types"></a>

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](serverless-vpc.md)。

在 AWS 區域 支援 FIPS 的 中，OpenSearch Serverless 也提供這些端點的 FIPS 相容變體。如需詳細資訊，請參閱[搭配 OpenSearch Serverless 使用 FIPS 端點](fips-compliance-opensearch-serverless.md#using-fips-endpoints-opensearch-serverless)。

## 每個集合端點
<a name="serverless-per-collection-endpoint"></a>

每個集合端點透過包含集合 ID 的主機名稱，以單一集合為目標。端點會顯示在 OpenSearch Serverless 主控台的集合詳細資訊頁面上，並由 `collectionEndpoint` 欄位中的 [https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_BatchGetCollection.html](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_BatchGetCollection.html) 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
}
```

## 每個帳戶端點
<a name="serverless-per-account-endpoint"></a>

每個帳戶端點會透過單一主機名稱 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-collection``123456789012`帳戶中的集合`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 會自動執行此操作。