View a markdown version of this page

Endpoints de coleta para Amazon Serverless OpenSearch - OpenSearch Serviço Amazon

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Endpoints de coleta para Amazon Serverless OpenSearch

O Amazon OpenSearch Serverless NextGen fornece endpoints baseados em recursos no domínio. on.aws Você pode usar um endpoint por coleção para acessar uma única coleção ou um endpoint por conta para acessar cada coleção Conta da AWS em sua região por meio de um nome de host. Ambos os endpoints funcionam acima do padrão AWS PrivateLink — crie endpoints VPC a partir do console Amazon VPC ou com a API do Amazon EC2. CreateVpcEndpoint

OpenSearch O Serverless Classic usa um endpoint por coleção ativado. aoss.amazonaws.com

Tipos de endpoint

OpenSearch O Serverless oferece suporte aos seguintes formatos de endpoint de coleção.

OpenSearch Formatos de endpoint de coleta sem servidor
Endpoint type Formato Description
Per-collection (NextGen) collection-id.aoss.region.on.aws

Identifica a coleção a partir do nome do host. Um endpoint por coleção.

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

Identifica a coleção a partir de um cabeçalho de solicitação. Um endpoint serve cada coleção Conta da AWS em sua região.

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

Identifica a coleção a partir do nome do host. Um endpoint por coleção Classic.

Ambos os formatos de NextGen endpoint usam o padrão AWS PrivateLink para acesso à VPC. Para obter mais informações sobre como criar um endpoint da VPC, consulte Acesso ao plano de dados por meio de AWS PrivateLink.

Regiões da AWS Nesse suporte ao FIPS, o OpenSearch Serverless também oferece FIPS-compliant variantes desses endpoints. Para obter detalhes, consulte Usando endpoints FIPS com Serverless OpenSearch.

Per-collection endpoints

Um endpoint por coleção tem como alvo uma única coleção por meio de um nome de host que inclui o ID da coleção. O endpoint é mostrado na página de detalhes da coleção no console OpenSearch Serverless e retornado pela BatchGetCollectionAPI no campo. collectionEndpoint

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

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

A solicitação a seguir indexa um documento no movies índice da coleção 1tg2xudton46knx2a95g em: us-east-1

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

Per-account endpoint

Um endpoint por conta tem como alvo cada coleção Conta da AWS em sua região por meio de um único nome de host. Como o nome do host é o mesmo para todas as coleções, você identifica a coleção de destino em cada solicitação por meio de um desses cabeçalhos HTTP (pelo menos um é obrigatório; se você incluir os dois, eles devem se referir à mesma coleção):

  • x-amz-aoss-collection-name— o nome da coleção atribuído pelo cliente

  • x-amz-aoss-collection-id— o ID da coleção gerado pelo serviço

O endpoint por conta permite que um único cliente compartilhe um pool de conexões em várias coleções, alternando a coleção de destino por solicitação por meio do cabeçalho. Isso é útil para aplicativos multilocatários que modelam cada inquilino como uma coleção separada.

Use x-amz-aoss-collection-name para que seu aplicativo possa rotear solicitações com nomes que ele já conhece. Você ignora o armazenamento ou a consulta do ID da coleção gerado pelo serviço.

O endpoint por conta não é exibido no console OpenSearch Serverless. Construa-o a partir do seu Conta da AWS ID e da região.

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

A solicitação a seguir indexa um documento no movies índice da coleção my-collection em conta 123456789012 em: 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

Os x-amz-aoss-collection-id cabeçalhos x-amz-aoss-collection-name e devem ser SigV4-signed. AWS Os SDKs fazem isso automaticamente.