Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Points de terminaison de collecte pour Amazon Serverless OpenSearch
<a name="serverless-collection-endpoints"></a>

Amazon OpenSearch Serverless NextGen fournit des points de terminaison basés sur les ressources sur le domaine. `on.aws` Vous pouvez utiliser un point de terminaison par collection pour accéder à une seule collection, ou un point de terminaison par compte pour accéder à toutes les collections de votre Compte AWS région via un seul nom d'hôte. Les deux points de terminaison fonctionnent conformément à la norme AWS PrivateLink  : créez des points de terminaison VPC depuis la console Amazon VPC ou avec l'API Amazon EC2. `CreateVpcEndpoint`

OpenSearch Serverless Classic utilise un point de terminaison par collection activé. `aoss.amazonaws.com`

**Topics**
+ [Types de point de terminaison](#serverless-collection-endpoints-types)
+ [Per-collection points de terminaison](#serverless-per-collection-endpoint)
+ [Per-account point de terminaison](#serverless-per-account-endpoint)

## Types de point de terminaison
<a name="serverless-collection-endpoints-types"></a>

OpenSearch Serverless prend en charge les formats de point de terminaison de collecte suivants.


**OpenSearch Formats de point de terminaison de collecte sans serveur**  

| Type de point de terminaison | Format | Description | 
| --- | --- | --- | 
| Per-collection (NextGen) | {{collection-id}}.aoss.{{region}}.on.aws | Identifie la collection à partir du nom d'hôte. Un point de terminaison par collection. | 
| Per-account (NextGen) | {{account-id}}.aoss.{{region}}.on.aws | Identifie la collection à partir d'un en-tête de demande. Un point de terminaison dessert toutes les collections Compte AWS de votre région. | 
| Per-collection (Classique) | {{collection-id}}.{{region}}.aoss.amazonaws.com | Identifie la collection à partir du nom d'hôte. Un point de terminaison par collection classique. | 

Les deux formats de point de NextGen terminaison utilisent AWS PrivateLink la norme pour l'accès aux VPC. Pour plus d’informations sur la création d’un point de terminaison de VPC, consultez la section [Accès au plan de données via AWS PrivateLink](serverless-vpc.md).

Dans le cadre de Régions AWS cette prise en charge de la norme FIPS, OpenSearch Serverless propose également des FIPS-compliant variantes de ces points de terminaison. Pour en savoir plus, consultez [Utilisation de points de terminaison FIPS avec Serverless OpenSearch](fips-compliance-opensearch-serverless.md#using-fips-endpoints-opensearch-serverless).

## Per-collection points de terminaison
<a name="serverless-per-collection-endpoint"></a>

Un point de terminaison par collection cible une seule collection via un nom d'hôte qui inclut l'ID de collection. Le point de terminaison est affiché sur la page des détails de la collecte de la console OpenSearch Serverless et renvoyé par l'[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 `collectionEndpoint` sur le terrain.

Format  
+ NextGen: `{{collection-id}}.aoss.{{region}}.on.aws`
+ Classique : `{{collection-id}}.{{region}}.aoss.amazonaws.com`

La requête suivante indexe un document dans l'`movies`index de collection `1tg2xudton46knx2a95g` dans `us-east-1` :

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

## Per-account point de terminaison
<a name="serverless-per-account-endpoint"></a>

Un point de terminaison par compte cible chaque collection de votre Compte AWS région via un nom d'hôte unique. Le nom d'hôte étant le même pour toutes les collections, vous identifiez la collection cible sur chaque requête via l'un de ces en-têtes HTTP (au moins un est requis ; si vous incluez les deux, ils doivent faire référence à la même collection) :
+ `x-amz-aoss-collection-name`— le nom de collection attribué par le client
+ `x-amz-aoss-collection-id`— l'identifiant de collecte généré par le service

Le point de terminaison par compte permet à un seul client de partager un pool de connexions entre plusieurs collections en changeant la collection cible par demande via l'en-tête. Cela est utile pour les applications multi-locataires qui modélisent chaque locataire comme une collection distincte.

Utilisez-le `x-amz-aoss-collection-name` pour que votre application puisse acheminer des demandes avec des noms qu'elle connaît déjà. Vous ignorez le stockage ou la recherche de l'identifiant de collection généré par le service.

Le point de terminaison par compte n'apparaît pas dans la console OpenSearch Serverless. Construisez-le à partir de votre Compte AWS identifiant et de la région.

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

La requête suivante indexe un document dans l'`movies`index de collection pris `my-collection` en compte `123456789012` dans `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
}
```

**Note**  
Les `x-amz-aoss-collection-id` en-têtes `x-amz-aoss-collection-name` et doivent être. SigV4-signed AWS Les SDK le font automatiquement.