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
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
Rubriques
Types de point de terminaison
OpenSearch Serverless prend en charge les formats de point de terminaison de collecte suivants.
| Type de point de terminaison | Format | Description |
|---|---|---|
| Per-collection (NextGen) | |
Identifie la collection à partir du nom d'hôte. Un point de terminaison par collection. |
| Per-account (NextGen) | |
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) | |
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.
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.
Per-collection points de terminaison
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'BatchGetCollectionAPI 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'moviesindex 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
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'moviesindex 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.