View a markdown version of this page

Puntos de enlace de recopilación para Amazon Serverless OpenSearch - OpenSearch Servicio Amazon

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Puntos de enlace de recopilación para Amazon Serverless OpenSearch

Amazon OpenSearch Serverless NextGen proporciona puntos de enlace basados en recursos en el dominio. on.aws Puede utilizar un punto de enlace por colección para acceder a una sola colección o un punto de enlace por cuenta para acceder a todas las colecciones de una región a través de un nombre de host Cuenta de AWS . Ambos puntos de enlace funcionan de forma estándar AWS PrivateLink : cree puntos de enlace de VPC desde la consola de Amazon VPC o con la API de Amazon EC2. CreateVpcEndpoint

OpenSearch Serverless Classic utiliza un punto final por colección activado. aoss.amazonaws.com

Tipo de punto de conexión

OpenSearch Serverless admite los siguientes formatos de punto final de recopilación.

OpenSearch Formatos de punto final de recopilación sin servidor
Tipo de punto de conexión Formato Description (Descripción)
Per-collection (NextGen) collection-id.aoss.region.on.aws

Identifica la colección a partir del nombre de host. Un punto final por colección.

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

Identifica la colección a partir del encabezado de una solicitud. Un punto final sirve a todas las colecciones Cuenta de AWS de una región.

Per-collection (Clásico) collection-id.region.aoss.amazonaws.com

Identifica la colección a partir del nombre del servidor. Un punto final por colección clásica.

Ambos formatos de NextGen punto final utilizan el estándar AWS PrivateLink para el acceso a la VPC. Para obtener información acerca de cómo crear un punto de conexión de VPC, consulte Acceso al plano de datos a través de AWS PrivateLink.

Al ser Regiones de AWS compatible con FIPS, OpenSearch Serverless también ofrece FIPS-compliant variantes de estos puntos de conexión. Para obtener más información, consulte Uso de puntos finales FIPS con Serverless OpenSearch.

Per-collection puntos finales

Un punto final por colección se dirige a una sola colección a través de un nombre de host que incluye el ID de la colección. El punto final se muestra en la página de detalles de la recopilación de la consola OpenSearch Serverless y la BatchGetCollectionAPI lo devuelve en el campo. collectionEndpoint

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

  • Clásico: collection-id.region.aoss.amazonaws.com

La siguiente solicitud indexa un documento en el movies índice de la colección 1tg2xudton46knx2a95g enus-east-1:

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

Per-account endpoint

Un punto final por cuenta orienta todas las colecciones de una región a través de un único nombre de host. Cuenta de AWS Como el nombre de host es el mismo para todas las colecciones, debe identificar la colección de destino en cada solicitud mediante uno de estos encabezados HTTP (se requiere al menos uno; si incluye ambos, deben hacer referencia a la misma colección):

  • x-amz-aoss-collection-name— el nombre de la colección asignado por el cliente

  • x-amz-aoss-collection-id— el identificador de recopilación generado por el servicio

El punto final por cuenta permite a un solo cliente compartir un grupo de conexiones entre varias colecciones al cambiar la colección de destino por solicitud a través del encabezado. Esto resulta útil para aplicaciones con varios inquilinos que modelan cada inquilino como una colección independiente.

Úselo x-amz-aoss-collection-name para que su aplicación pueda enrutar las solicitudes con nombres que ya conoce. Omite almacenar o buscar el identificador de recopilación generado por el servicio.

El punto final por cuenta no se muestra en la consola Serverless. OpenSearch Constrúyelo a partir de tu Cuenta de AWS ID y la región.

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

La siguiente solicitud indexa un documento en el movies índice de colección de la cuenta my-collection 123456789012 enus-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

Los x-amz-aoss-collection-id encabezados x-amz-aoss-collection-name y deben serlo. SigV4-signed AWS Los SDK lo hacen automáticamente.