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á.

Criação, listagem e exclusão de coleções do Amazon OpenSearch Sem Servidor

Uma coleção no Amazon OpenSearch Sem Servidor é um agrupamento lógico de um ou mais índices que representam uma workload de análise. O OpenSearch Service gerencia e ajusta automaticamente a coleção, exigindo entrada manual mínima.

Permissões obrigatórias

O OpenSearch Sem Servidor usa as seguintes permissões do AWS Identity and Access Management (IAM) para criar e gerenciar coleções. É possível especificar as condições do IAM para restringir os usuários a coleções específicas.

O exemplo de política de acesso baseada em identidade a seguir fornece as permissões mínimas necessárias para que um usuário gerencie uma única coleção de nome Logs:

[
   {
      "Sid":"Allows managing logs collections",
      "Effect":"Allow",
      "Action":[
         "aoss:CreateCollection",
         "aoss:ListCollections",
         "aoss:BatchGetCollection",
         "aoss:UpdateCollection",
         "aoss:DeleteCollection",
         "aoss:CreateAccessPolicy",
         "aoss:CreateSecurityPolicy"
      ],
      "Resource":"*",
      "Condition":{
         "StringEquals":{
            "aoss:collection":"Logs"
         }
      }
   }
]

aoss:CreateAccessPolicy e aoss:CreateSecurityPolicy estão incluídos porque as políticas de criptografia, de rede e de acesso a dados são necessárias para que uma coleção funcione adequadamente. Para ter mais informações, consulte Identity and Access Management para Amazon OpenSearch Serverless.

Criação de coleções

É possível usar o console ou a AWS CLI para criar uma coleção com tecnologia sem servidor. Essas etapas abordam como criar uma pesquisa ou uma coleção de séries temporais. Para criar uma coleção de pesquisa vetorial, consulteTrabalho com coleções de pesquisa vetorial.

Criação de uma coleção (console)

O status da coleção muda para Creating enquanto o OpenSearch Sem Servidor cria a coleção.

Criação de uma coleção (CLI)

Antes de criar uma coleção usando a AWS CLI, é necessário ter uma política de criptografia com um padrão de recurso que corresponda ao nome pretendido da coleção. Por exemplo, se você planeja nomear sua coleção como logs-application, é possível criar uma política de criptografia como esta:

aws opensearchserverless create-security-policy \
  --name logs-policy \
  --type encryption --policy "{\"Rules\":[{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AWSOwnedKey\":true}"

Se você planeja usar a política para cobranças adicionais, é possível tornar a regra mais ampla, como collection/logs* ou collection/*.

Você também precisa definir as configurações de rede para a coleção na forma de uma política de rede. Usando o exemplo anterior de logs-application, é possível criar a seguinte política de rede:

aws opensearchserverless create-security-policy \
  --name logs-policy \
  --type network --policy "[{\"Description\":\"Public access for logs collection\",\"Rules\":[{\"ResourceType\":\"dashboard\",\"Resource\":[\"collection\/logs-application\"]},{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AllowFromPublic\":true}]"

Para criar uma coleção, envie uma solicitação CreateCollection:

aws opensearchserverless create-collection --name "logs-application" --type SEARCH --description "A collection for storing log data"

Para o type, especifique SEARCH ou TIMESERIES. Para ter mais informações, consulte Escolha de um tipo de coleção.

Exemplo de resposta

{
    "createCollectionDetail": {
        "id": "07tjusf2h91cunochc",
        "name": "books",
        "description":"A collection for storing log data",
        "status": "CREATING",
        "type": "SEARCH",
        "kmsKeyArn": "auto",
        "arn": "arn:aws:aoss:us-east-1:123456789012:collection/07tjusf2h91cunochc",
        "createdDate": 1665952577473
    }
}

Se você não especificar um tipo de coleção na solicitação, ela assumirá o padrão TIMESERIES. Se sua coleção estiver criptografada com uma Chave pertencente à AWS, o kmsKeyArn será auto em vez de um ARN.

Acesso ao OpenSearch Dashboards

Depois de criar uma coleção com o AWS Management Console, será possível navegar até o URL do OpenSearch Dashboards da coleção. Você pode encontrar o URL dos Painéis escolhendo Coleções no painel de navegação esquerdo e selecionando a coleção para abrir a página de detalhes. O URL assume o formato https://dashboards.us-east-1.aoss.amazonaws.com/_login/?collectionId=07tjusf2h91cunochc. Depois de navegar até o URL, você fará login no Dashboards automaticamente.

Se você já tem o URL do OpenSearch Dashboards disponível, mas não está no AWS Management Console, chamar o URL dos Dashboards a partir do navegador redirecionará para o console. Depois de inserir suas credenciais da AWS, você fará login automaticamente no Dashboards. Para obter informações sobre como acessar coleções para SAML, consulte Acessar o OpenSearch Dashboards com SAML.

O tempo limite do console do OpenSearch Dashboards é de uma hora e não é configurável.

Exibição das coleções

É possível exibir as coleções existentes na sua Conta da AWS na guia Collections (Coleções) do console do Amazon OpenSearch Service.

Para listar as coleções junto com seus IDs, envie uma solicitação ListCollections.

aws opensearchserverless list-collections

Exemplo de resposta

{
   "collectionSummaries":[
      {
         "arn":"arn:aws:aoss:us-east-1:123456789012:collection/07tjusf2h91cunochc",
         "id":"07tjusf2h91cunochc",
         "name":"my-collection",
         "status":"CREATING"
      }
   ]
}

Para limitar os resultados da pesquisa, use filtros de coleções. Esta solicitação filtra a resposta para coleções no estado ACTIVE:

aws opensearchserverless list-collections --collection-filters '{ "status": "ACTIVE" }'

Para obter informações mais detalhadas sobre uma ou mais coleções, incluindo o endpoint do OpenSearch e o endpoint do OpenSearch Dashboards, envie uma solicitação BatchGetCollection:

aws opensearchserverless batch-get-collection --ids ["07tjusf2h91cunochc", "1iu5usc4rame"]

Exemplo de resposta

{
   "collectionDetails":[
      {
         "id": "07tjusf2h91cunochc",
         "name": "my-collection",
         "status": "ACTIVE",
         "type": "SEARCH",
         "description": "",
         "arn": "arn:aws:aoss:us-east-1:123456789012:collection/07tjusf2h91cunochc",
         "kmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab",
         "createdDate": 1667446262828,
         "lastModifiedDate": 1667446300769,
         "collectionEndpoint": "https://07tjusf2h91cunochc.us-east-1.aoss.amazonaws.com",
         "dashboardEndpoint": "https://07tjusf2h91cunochc.us-east-1.aoss.amazonaws.com/_dashboards"
      },
      {
         "id": "178ukvtg3i82dvopdid",
         "name": "another-collection",
         "status": "ACTIVE",
         "type": "TIMESERIES",
         "description": "",
         "arn": "arn:aws:aoss:us-east-1:123456789012:collection/178ukvtg3i82dvopdid",
         "kmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab",
         "createdDate": 1667446262828,
         "lastModifiedDate": 1667446300769,
         "collectionEndpoint": "https://178ukvtg3i82dvopdid.us-east-1.aoss.amazonaws.com",
         "dashboardEndpoint": "https://178ukvtg3i82dvopdid.us-east-1.aoss.amazonaws.com/_dashboards"
      }
   ],
   "collectionErrorDetails":[]
}

Exclusão de coleções

A exclusão de uma coleção exclui todos os dados e índices da coleção. Você não poderá recuperar coleções depois de excluí-las.

Para excluir uma coleção usando a AWS CLI, envie uma solicitação DeleteCollection:

aws opensearchserverless delete-collection --id 07tjusf2h91cunochc

Exemplo de resposta

{
   "deleteCollectionDetail":{
      "id":"07tjusf2h91cunochc",
      "name":"my-collection",
      "status":"DELETING"
   }
}