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á.
# Grupos de OpenSearch coleção Amazon Serverless
*Os grupos de coleção* no Amazon OpenSearch Serverless organizam várias coleções e permitem o compartilhamento de recursos computacionais entre coleções com chaves KMS diferentes. Esse modelo de computação compartilhada reduz os custos ao eliminar a necessidade de unidades de OpenSearch processamento separadas (OCUs) para cada chave KMS.
Cada coleção OpenSearch Serverless que você cria é protegida com criptografia de dados em repouso, usada AWS KMS para armazenar e gerenciar suas chaves de criptografia. Coleções dentro do mesmo grupo de coleções compartilham recursos computacionais e espaço de memória da OCU, mesmo quando usam chaves KMS diferentes para criptografia.
Os grupos de coleta fornecem isolamento para os requisitos de segurança e desempenho. Você pode agrupar coleções com a mesma chave KMS em um único grupo de coleta para isolamento de segurança ou combinar coleções com chaves KMS diferentes no mesmo grupo para otimização de custos. Essa flexibilidade permite equilibrar os requisitos de segurança com a eficiência dos recursos.
Quando você adiciona uma coleção a um grupo de coleções, o OpenSearch Serverless a atribui aos recursos computacionais compartilhados do grupo. O sistema gerencia automaticamente a distribuição das cargas de trabalho entre esses recursos, mantendo a segurança criptografando os dados de cada coleção com a chave KMS designada. Os controles de acesso continuam sendo aplicados no nível da coleção, e os recursos computacionais compartilhados acessam várias chaves do KMS conforme necessário para servir às coleções no grupo.
Você controla a alocação de recursos definindo limites mínimos e máximos de OCU no nível do grupo de coleta. Esses limites se aplicam a todas as coleções do grupo e ajudam você a gerenciar custos e, ao mesmo tempo, garantir um desempenho consistente.
Por padrão, há uma cota de serviço (limite) para o número de coleções em um grupo de coleções, o número de índices em uma coleção e o número de OCUs em um grupo de coleções. Para obter mais informações, consulte Cotas [OpenSearch sem servidor](https://docs.aws.amazon.com/general/latest/gr/opensearch-service.html#opensearch-limits-serverless).
## Principais conceitos
Grupo de coleção
Um AWS recurso que atua como um contêiner para uma ou mais coleções. Cada grupo de coleta tem um identificador exclusivo e pode ter seus próprios limites de capacidade e configurações.
Computação compartilhada
Coleções dentro do mesmo grupo de coleções compartilham o mesmo conjunto de OCUs, independentemente das chaves KMS que elas usam. Esse compartilhamento reduz os custos ao eliminar a necessidade de recursos computacionais separados para cada chave KMS.
Limites de capacidade
Você pode definir limites mínimos e máximos de OCU para operações de indexação e pesquisa no nível do grupo de coleta. Esses limites ajudam a controlar os custos e garantir um desempenho consistente.
# Limites de capacidade do grupo de coleta
Os grupos de coleta fornecem controle granular sobre a alocação de recursos por meio dos limites mínimo e máximo da OCU. Esses limites se aplicam a todas as coleções dentro do grupo e operam independentemente das configurações de capacidade no nível da conta.
Por padrão, há uma cota de serviço (limite) para o número de coleções em um grupo de coleções, o número de índices em uma coleção e o número de OCUs em um grupo de coleções. Para obter mais informações, consulte Cotas [OpenSearch sem servidor](https://docs.aws.amazon.com/general/latest/gr/opensearch-service.html#opensearch-limits-serverless).
## Entendendo os limites de capacidade do grupo de coleta
Você pode configurar limites mínimos e máximos de OCU para operações de indexação e pesquisa no nível do grupo de coleta. Esses limites controlam como o OpenSearch Serverless dimensiona os recursos para coleções no grupo:
+ **OCU mínima** — O número mínimo OCUs que o OpenSearch Serverless mantém para o grupo de coleta, garantindo um desempenho de linha de base consistente.
+ Se a carga de trabalho exigir menos OCUs do que o valor mínimo especificado, o OpenSearch Serverless ainda manteria o valor mínimo especificado de OCUs e o faturamento refletiria o mesmo.
+ Se a carga de trabalho exigir um número maior de OCUs do que o valor mínimo especificado, o OpenSearch Serverless manteria o nível de OCUs necessário para a carga de trabalho e o faturamento refletiria a maior utilização da OCU.
+ **OCU máxima** — O número máximo OCUs desse OpenSearch Serverless pode ser expandido para o grupo de coleta, ajudando você a controlar os custos.
Os limites de capacidade do grupo de coleta são dissociados dos limites no nível da conta. As configurações máximas de OCU no nível da conta se aplicam somente às coleções não associadas a nenhum grupo de coleta, enquanto as configurações máximas de OCU do grupo de coleta se aplicam às coleções dentro desse grupo específico.
## Valores-limite de capacidade válidos
Ao definir limites mínimos e máximos de OCU para um grupo de coleta, você só pode usar valores do seguinte conjunto: 1, 2, 4, 8, 16 e múltiplos de 16 (como 32, 48, 64, 80, 96) até um máximo de 1.696. OCUs
Os limites mínimo e máximo de OCU são opcionais quando você cria um grupo de coleta. Se você não especificar um limite máximo de OCU, o OpenSearch Serverless usará um valor padrão de 96. OCUs
O limite mínimo da OCU deve ser menor ou igual ao limite máximo da OCU.
## Entendendo a relação entre os limites de OCU no nível da conta e do grupo de coleção
Ao planejar sua capacidade OpenSearch sem servidor, é importante entender como os limites de OCU no nível da conta e os limites de OCU do grupo de coleção interagem. A soma das configurações máximas de OCU em todos os grupos de coleta mais a configuração máxima de OCU no nível da conta deve ser menor ou igual ao limite de cota de serviço por conta. Para ver os valores-limite atuais, consulte Cotas [OpenSearch sem servidor](https://docs.aws.amazon.com/general/latest/gr/opensearch-service.html#opensearch-limits-serverless).
**nota**
As configurações máximas de OCU no nível da conta se aplicam somente às coleções não associadas a nenhum grupo de coleções. As coleções dentro dos grupos de coleta são regidas pelos respectivos limites do grupo de coleta, não pelos limites no nível da conta.
Essa restrição se aplica tanto à indexação quanto à pesquisa OCUs de forma independente. Por exemplo, se você definir configurações no nível da conta e grupos de coleção, deverá garantir que o total não exceda o limite da cota de serviço para indexação OCUs e, separadamente, não exceda o limite da cota de serviço para pesquisa. OCUs Além disso, você pode criar no máximo 300 grupos de coleção por conta.
**Exemplo: capacidade de planejamento com limites no nível da conta e do grupo de coleções**
Se você definir a OCU máxima de pesquisa no nível da conta como 500 e o limite da cota de serviço for 1.700:
+ E crie 2 grupos de coleta, a soma da OCU máxima para os 2 grupos de coleta não deve ser superior a 1.200 (1.700 - 500)
+ Você pode deixar cada grupo de coleta na OCU máxima padrão de 96 (96 \$1 96 \$1 500 = 692), deixando espaço para crescimento futuro
+ Ou você pode aumentar o máximo de cada grupo de coleta para 600 (600 \$1 600 \$1 500 = 1.700), usando a capacidade total permitida pela cota de serviço
Esse relacionamento é fundamental para o planejamento da capacidade. Antes de criar novos grupos de coleta ou aumentar os limites máximos de OCU, verifique se sua alocação total não excede o limite da cota de serviço. Se você atingir esse limite, deverá reduzir as configurações máximas de OCU nos grupos de coleta existentes ou diminuir as configurações máximas de OCU em nível de conta para abrir espaço para novas alocações.
## Configurando limites de capacidade
Você pode definir limites de capacidade ao criar um grupo de coleta ou atualizá-los posteriormente. Para configurar limites de capacidade usando o AWS CLI, use os [UpdateCollectionGroup](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_UpdateCollectionGroup.html)comandos [CreateCollectionGroup](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateCollectionGroup.html)ou:
```
aws opensearchserverless create-collection-group \
--name my-collection-group \
--capacity-limits maxIndexingCapacityInOCU=32,maxSearchCapacityInOCU=32,minIndexingCapacityInOCU=4,minSearchCapacityInOCU=4
```
Para atualizar os limites de capacidade de um grupo de coleta existente:
```
aws opensearchserverless update-collection-group \
--id abcdef123456 \
--capacity-limits maxIndexingCapacityInOCU=48,maxSearchCapacityInOCU=48,minIndexingCapacityInOCU=8,minSearchCapacityInOCU=8
```
## Monitorando a capacidade do grupo de coleta
OpenSearch O Serverless emite as seguintes métricas do Amazon CloudWatch Logs em intervalos de um minuto para ajudar você a monitorar a utilização da OCU e os limites de capacidade no nível do grupo de coleta:
+ `IndexingOCU`— O número de indexação OCUs atualmente em uso pelo grupo de coleções.
+ `SearchOCU`— O número de pesquisas OCUs atualmente em uso pelo grupo de coleções.
OpenSearch O Serverless também emite métricas de OCU no nível da conta para coleções não associadas a nenhum grupo de coleções. Você pode agregar essas métricas CloudWatch para visualizar a soma de todos os grupos de coleções e coleções OCUs em nível de conta.
Configure alarmes para notificá-lo quando seu grupo de coleta se aproximar dos limites de capacidade, para que você possa ajustar as configurações conforme necessário. Para obter mais informações sobre métricas OpenSearch sem servidor, consulte. [Monitorando o Amazon OpenSearch Serverless](serverless-monitoring.md)
## Como os limites de capacidade são aplicados
OpenSearch O Serverless impõe limites de capacidade do grupo de coleta durante as operações de escalabilidade. Quando suas coleções precisam de recursos adicionais, o OpenSearch Serverless se expande até o limite máximo de OCU. Quando a demanda diminui, o OpenSearch Serverless diminui, mas mantém pelo menos o limite mínimo de OCU para garantir um desempenho consistente.
Os limites de capacidade são aplicados somente quando o grupo de coleta contém pelo menos uma coleção. Grupos de coleta vazios não consomem OCUs nem impõem limites de capacidade.
Se uma operação de escalabilidade exceder o limite máximo da OCU ou violar o requisito mínimo da OCU, a OpenSearch Serverless rejeitará a operação para manter a conformidade com os limites configurados.
# Criptografia e chaves KMS em grupos de coleção
Cada coleção OpenSearch Serverless que você cria é protegida com criptografia de dados em repouso, usada AWS KMS para armazenar e gerenciar suas chaves de criptografia. Ao trabalhar com grupos de coleções, você tem flexibilidade na forma como especifica a chave KMS para suas coleções.
Você pode fornecer a chave KMS associada a uma coleção de duas maneiras:
+ **Na CreateCollection solicitação** — especifique a chave KMS diretamente ao criar a coleção usando o `encryption-config` parâmetro.
+ **Nas políticas de segurança** — defina a associação da chave KMS em uma política de segurança de criptografia.
Quando você especifica uma chave KMS em ambos os locais, a chave KMS fornecida na CreateCollection solicitação tem precedência sobre a configuração da política de segurança.
Essa flexibilidade simplifica o gerenciamento de coleções em grande escala, especialmente quando você precisa criar várias coleções com chaves KMS exclusivas. Em vez de criar e gerenciar milhares de políticas de criptografia, você pode especificar a chave KMS diretamente durante a criação da coleção.
## Compartilhamento OCUs entre diferentes chaves KMS
Os grupos de coleções permitem o compartilhamento de recursos computacionais entre coleções com chaves KMS diferentes. Coleções no mesmo grupo de coleções compartilham espaço de memória da OCU, independentemente de suas chaves de criptografia. Esse modelo de computação compartilhada reduz os custos ao eliminar a necessidade de separar cada OCUs chave KMS.
Os grupos de coleta fornecem isolamento para os requisitos de segurança e desempenho. Você pode agrupar coleções com a mesma chave KMS em um único grupo de coleta para isolamento de segurança ou combinar coleções com chaves KMS diferentes no mesmo grupo para otimização de custos. Essa flexibilidade permite equilibrar os requisitos de segurança com a eficiência dos recursos.
O sistema mantém a segurança criptografando os dados de cada coleção com a chave KMS designada. Os controles de acesso continuam sendo aplicados no nível da coleção, e os recursos computacionais compartilhados acessam várias chaves do KMS conforme necessário para servir às coleções no grupo.
## Permissões KMS necessárias
Ao especificar uma chave KMS na CreateCollection solicitação, você precisa das seguintes permissões adicionais:
+ `kms:DescribeKey`— Permite que o OpenSearch Serverless recupere informações sobre a chave KMS.
+ `kms:CreateGrant`— Permite que o OpenSearch Serverless crie uma concessão para a chave KMS para permitir operações de criptografia.
Essas permissões não são necessárias ao usar chaves AWS próprias.
# Crie grupos de coleções
Este tópico descreve como criar, configurar e gerenciar grupos de coleta no Amazon OpenSearch Serverless. Use grupos de coleções para organizar coleções e compartilhar recursos computacionais para otimizar custos. Defina limites mínimos e máximos de OCU no nível do grupo de coleta para controlar o desempenho e os gastos.
## Criar um grupo de coleções
Use os procedimentos a seguir para criar um novo grupo de coleta e definir suas configurações. Crie um grupo de coleção usando o console OpenSearch Serverless ou o. AWS CLI AWS SDKs Ao criar um grupo de coleta, você especifica limites de capacidade e outras opções de configuração.
------
#### [ Console ]
1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/).
1. **No painel de navegação esquerdo, escolha **Sem servidor** e, em seguida, escolha Grupos de coleção**
1. Escolha **Criar grupo de coleção**.
1. Em **Nome do grupo de coleta**, insira um nome para seu grupo de coleta. O nome deve ter de 3 a 32 caracteres, começar com uma letra minúscula e conter somente letras minúsculas, números e hífens.
1. (Opcional) Em **Descrição**, insira uma descrição para seu grupo de coleta.
1. Na seção **Gerenciamento de capacidade**, configure os limites da OCU:
+ **Capacidade máxima de indexação** — O número máximo de indexação para o OCUs qual as coleções desse grupo podem ser escaladas.
+ **Capacidade máxima de pesquisa** — O número máximo de pesquisas para as quais as coleções OCUs desse grupo podem ser escaladas.
+ **Capacidade mínima de indexação** — O número mínimo de indexação OCUs a ser mantido para um desempenho consistente.
+ **Capacidade mínima de pesquisa** — O número mínimo de pesquisas OCUs a serem mantidas para um desempenho consistente.
1. (Opcional) Na seção **Tags**, adicione tags para ajudar a organizar e identificar seu grupo de coleção.
1. Escolha **Criar grupo de coleção**.
------
#### [ AWS CLI ]
+ Use o [create-collection-group](https://docs.aws.amazon.com/cli/latest/reference/opensearchserverless/create-collection-group.html)comando para criar um novo grupo de coleções. No comando, substitua o *example* conteúdo por suas próprias informações específicas.
```
aws opensearchserverless create-collection-group \
--name my-collection-group \
--description "Collection group for production workloads" \
--capacity-limits maxIndexingCapacityInOCU=20,maxSearchCapacityInOCU=20,minIndexingCapacityInOCU=2,minSearchCapacityInOCU=2 \
--tags key=Environment,value=Production key=Team,value=DataEngineering
```
O comando retorna detalhes sobre o grupo de coleção criado, incluindo seu ID exclusivo e ARN.
------
## Adicionar uma nova coleção a um grupo de coleções
Ao criar uma nova coleção, especifique um nome de grupo de coleta existente ao qual associar a coleção. Use os procedimentos a seguir para adicionar uma nova coleção a um grupo de coleta.
------
#### [ Console ]
1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/).
1. **No painel de navegação esquerdo, escolha **Sem servidor** e, em seguida, escolha Coleções**
1. Escolha **Criar coleção**.
1. Em **Nome da coleção**, insira um nome para sua coleção. O nome deve ter de 3 a 28 caracteres, começar com uma letra minúscula e conter somente letras minúsculas, números e hífens.
1. (Opcional) Em **Descrição**, insira uma descrição para sua coleção.
1. Na seção **Grupo de coleções**, selecione o grupo de coleta ao qual você deseja que a coleção seja atribuída. Uma coleção só pode pertencer a um grupo de coleções por vez.
(Opcional) Você também pode optar por **Criar um novo grupo**. Isso levará você ao fluxo de trabalho **Criar grupo de coleção**. Depois de concluir a criação do grupo de coleta, retorne à etapa 1 desse procedimento para começar a criar sua nova coleção.
1. Continue com o fluxo de trabalho para criar a coleção.
**Importante**
Não saia do fluxo de trabalho **Criar coleção**. Isso interromperá a configuração da coleção. A página **de detalhes da coleção** aparece após a conclusão da configuração.
------
#### [ AWS CLI ]
+ Use o comando [create-collection](https://docs.aws.amazon.com/cli/latest/reference/opensearchserverless/create-collection.html) para criar uma nova coleção e adicioná-la a um grupo de coleções existente. No comando, substitua o *example* conteúdo por suas próprias informações específicas.
```
aws opensearchserverless create-collection \
--name my-collection \
--type SEARCH \
--collection-group-name my-collection-group \
--description "Collection for search workloads"
```
------
# Gerencie grupos de OpenSearch coleção Amazon Serverless
Depois de criar grupos de coleta Amazon OpenSearch Serverless, você pode modificar suas configurações conforme suas necessidades mudarem. Use essas operações de gerenciamento para atualizar os limites de capacidade e visualizar os detalhes do grupo de coleta. Essas mudanças ajudam você a otimizar a alocação de recursos e a manter a organização eficiente de suas coleções.
## Exibir grupos de coleções
Exiba seus grupos de coleta OpenSearch sem servidor para revisar suas configurações, coleções associadas e status atual.
------
#### [ Console ]
1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/).
1. **No painel de navegação esquerdo, escolha **Sem servidor** e, em seguida, escolha Coleções**
1. Escolha a **guia Grupos de coleções**. Os grupos de coleções da sua conta são exibidos.
1. Escolha o **Nome** de um grupo de coleta para exibir seus detalhes.
------
#### [ AWS CLI ]
+ Use o [list-collection-groups](https://docs.aws.amazon.com/cli/latest/reference/opensearchserverless/list-collection-groups.html)comando para listar todos os grupos de coleções em sua conta. Use o [batch-get-collection-group](https://docs.aws.amazon.com/cli/latest/reference/opensearchserverless/batch-get-collection-group.html)comando para ver detalhes sobre grupos de coleta específicos. Nos comandos a seguir, substitua o *example* conteúdo por suas próprias informações específicas.
Para listar todos os grupos de coleções:
```
aws opensearchserverless list-collection-groups
```
Para obter detalhes sobre grupos de coleções específicos:
```
aws opensearchserverless batch-get-collection-group \
--names my-collection-group another-group
```
------
## Atualizar as configurações do grupo de coleções
Atualize as configurações do grupo de coleta OpenSearch Serverless para modificar configurações, como limites de capacidade e descrição.
------
#### [ Console ]
1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/).
1. **No painel de navegação esquerdo, escolha **Sem servidor** e, em seguida, escolha Coleções**
1. Escolha a **guia Grupos de coleções**. Os grupos de coleções da sua conta são exibidos.
1. Escolha o **Nome** de um grupo de coleta para exibir seus detalhes.
1. Em **Detalhes do grupo de coleções**, escolha **Editar**.
1. Faça as alterações e escolha **Salvar**.
------
#### [ AWS CLI ]
+ Use o [update-collection-group](https://docs.aws.amazon.com/cli/latest/reference/opensearchserverless/update-collection-group.html)comando para atualizar a descrição e os limites de capacidade de um grupo de coleta existente. No comando a seguir, substitua o *example* conteúdo pelas suas próprias informações.
```
aws opensearchserverless update-collection-group \
--id abcdef123456 \
--description "Updated description for production workloads" \
--capacity-limits maxIndexingCapacityInOCU=30,maxSearchCapacityInOCU=30,minIndexingCapacityInOCU=4,minSearchCapacityInOCU=4
```
------
As alterações nos limites de capacidade entram em vigor imediatamente e podem afetar o comportamento de escalabilidade das coleções no grupo.
## Excluir grupos de coleções
Antes de excluir um grupo de coleções, você deve primeiro remover todas as coleções do grupo. Você não pode excluir um grupo de coleções que contenha coleções.
------
#### [ Console ]
1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/).
1. **No painel de navegação esquerdo, escolha **Sem servidor** e, em seguida, escolha Coleções**
1. Escolha a **guia Grupos de coleções**. Os grupos de coleções da sua conta são exibidos.
1. Escolha o **nome** do grupo de coleta que você deseja excluir.
**Importante**
Remova todas as coleções do grupo de coleta atualizando cada coleção para remover a associação do grupo de coleta ou movendo-as para outros grupos de coleta.
1. Na parte superior da página, escolha **Delete** (Excluir).
1. Confirme a exclusão e escolha **Excluir**.
------
#### [ AWS CLI ]
+ Use o [delete-collection-group](https://docs.aws.amazon.com/cli/latest/reference/opensearchserverless/delete-collection-group.html)comando para excluir um grupo de coleções.
**Importante**
Remova todas as coleções do grupo de coleta atualizando cada coleção para remover a associação do grupo de coleta ou movendo-as para outros grupos de coleta.
No comando a seguir, substitua o *example* conteúdo pelas suas próprias informações.
Exclua o grupo de coleta vazio:
```
aws opensearchserverless delete-collection-group \
--id abcdef123456
```
------