View a markdown version of this page

Endpoint di raccolta per Amazon Serverless OpenSearch - OpenSearch Servizio Amazon

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Endpoint di raccolta per Amazon Serverless OpenSearch

Amazon OpenSearch Serverless NextGen fornisce endpoint basati sulle risorse sul dominio. on.aws Puoi utilizzare un endpoint per raccolta per accedere a una singola raccolta o un endpoint per account per accedere a tutte le raccolte presenti in una regione tramite un solo nome host. Account AWS Entrambi gli endpoint funzionano tramite standard AWS PrivateLink : crea endpoint VPC dalla console Amazon VPC o con l'API Amazon EC2. CreateVpcEndpoint

OpenSearch Serverless Classic utilizza un endpoint per raccolta su. aoss.amazonaws.com

Tipi di endpoint

OpenSearch Serverless supporta i seguenti formati di endpoint di raccolta.

OpenSearch Formati di endpoint di raccolta serverless
Tipo di endpoint Formato Description
Per-collection (NextGen) collection-id.aoss.region.on.aws

Identifica la raccolta a partire dal nome host. Un endpoint per raccolta.

Per-account (NextGen) account-id.aoss.region.on.aws

Identifica la raccolta dall'intestazione di una richiesta. Un endpoint serve ogni raccolta presente in una regione Account AWS .

Per-collection (Classico) collection-id.region.aoss.amazonaws.com

Identifica la raccolta a partire dal nome host. Un endpoint per collezione Classic.

Entrambi i formati NextGen di endpoint utilizzano lo standard AWS PrivateLink per l'accesso al VPC. Per maggiori informazioni su come creare un endpoint VPC, consulta Accesso al piano dati tramite AWS PrivateLink.

Oltre al Regioni AWS supporto FIPS, OpenSearch Serverless offre anche FIPS-compliant varianti di questi endpoint. Per informazioni dettagliate, vedi Utilizzo degli endpoint FIPS con Serverless OpenSearch.

Per-collection endpoint

Un endpoint per raccolta ha come target una singola raccolta tramite un nome host che include l'ID della raccolta. L'endpoint viene visualizzato nella pagina dei dettagli della raccolta nella console OpenSearch Serverless e restituito dall'API sul campo. BatchGetCollectioncollectionEndpoint

Formato
  • NextGen: collection-id.aoss.region.on.aws

  • Classico: collection-id.region.aoss.amazonaws.com

La seguente richiesta indicizza un documento nell'moviesindice di raccolta 1tg2xudton46knx2a95g in: us-east-1

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

Per-account endpoint

Un endpoint per account indirizza ogni raccolta presente in una regione tramite un Account AWS unico nome host. Poiché il nome host è lo stesso per tutte le raccolte, identifichi la raccolta di destinazione su ogni richiesta tramite una di queste intestazioni HTTP (almeno una è obbligatoria; se le includi entrambe, devono fare riferimento alla stessa raccolta):

  • x-amz-aoss-collection-name— il nome della raccolta assegnato dal cliente

  • x-amz-aoss-collection-id— l'ID di raccolta generato dal servizio

L'endpoint per account consente a un singolo client di condividere un pool di connessioni tra più raccolte cambiando la raccolta di destinazione per richiesta tramite l'intestazione. Ciò è utile per le applicazioni multi-tenant che modellano ogni tenant come una raccolta separata.

Utilizzalo x-amz-aoss-collection-name in modo che l'applicazione possa instradare le richieste con nomi che già conosce. Non devi archiviare o cercare l'ID di raccolta generato dal servizio.

L'endpoint per account non viene visualizzato nella console Serverless. OpenSearch Costruiscilo in base al tuo Account AWS ID e alla regione.

Formato
  • NextGen: account-id.aoss.region.on.aws

La seguente richiesta indicizza un documento nell'moviesindice di raccolta in account my-collection in: 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 }
Nota

Le x-amz-aoss-collection-id intestazioni x-amz-aoss-collection-name e devono essere. SigV4-signed AWS Gli SDK lo fanno automaticamente.