翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon OpenSearch Serverless のコレクションエンドポイント
<a name="serverless-collection-endpoints"></a>

Amazon OpenSearch Serverless NextGen は、`on.aws`ドメインにリソースベースのエンドポイントを提供します。コレクションごとのエンドポイントを使用して単一のコレクションにアクセスするか、アカウントごとのエンドポイントを使用して AWS アカウント 、1 つのホスト名を介してリージョン内の のすべてのコレクションにアクセスできます。どちらのエンドポイントも標準で動作します AWS PrivateLink 。Amazon VPC コンソールまたは Amazon `CreateVpcEndpoint` Amazon EC2 API を使用して VPC エンドポイントを作成します。

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 | ホスト名からコレクションを識別します。コレクションごとに 1 つのエンドポイント。 | 
| アカウントごと (NextGen) | {{account-id}}.aoss.{{region}}.on.aws | リクエストヘッダーからコレクションを識別します。1 つのエンドポイントは、リージョン内の のすべてのコレクション AWS アカウント を提供します。 | 
| コレクションごと (クラシック) | {{collection-id}}.{{region}}.aoss.amazonaws.com | ホスト名からコレクションを識別します。Classic コレクションごとに 1 つのエンドポイント。 | 

どちらの NextGen エンドポイント形式も VPC アクセス AWS PrivateLink に標準を使用します。VPC エンドポイントの作成の詳細については、「[を介したデータプレーンアクセス AWS PrivateLink](serverless-vpc.md)」を参照してください。

FIPS AWS リージョン をサポートする 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`
+ Classic: `{{collection-id}}.{{region}}.aoss.amazonaws.com`

次のリクエストは、ドキュメントを のコレクションの`movies`インデックスにインデックス`1tg2xudton46knx2a95g`化します`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 ヘッダーのいずれかを使用して各リクエストでターゲットコレクションを識別します (少なくとも 1 つ必要です。両方を含める場合は、同じコレクションを参照する必要があります）。
+ `x-amz-aoss-collection-name` – お客様が割り当てたコレクション名
+ `x-amz-aoss-collection-id` – サービスによって生成されたコレクション ID

アカウントごとのエンドポイントを使用すると、 ヘッダーを介してリクエストごとにターゲットコレクションを切り替えることで、1 つのクライアントが複数のコレクション間で 1 つの接続プールを共有できます。これは、各テナントを個別のコレクションとしてモデル化するマルチテナントアプリケーションに役立ちます。

を使用すると、アプリケーションは既知の名前でリクエストをルーティング`x-amz-aoss-collection-name`できます。サービスで生成されたコレクション ID の保存または検索をスキップします。

アカウントごとのエンドポイントは、OpenSearch Serverless コンソールには表示されません。 AWS アカウント ID とリージョンから作成します。

形式  
+ NextGen: `{{account-id}}.aoss.{{region}}.on.aws`

次のリクエストは、 の`my-collection`アカウントのコレクションの`movies`インデックスにドキュメントをインデックス`123456789012`化します`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は自動的にこれを行います。