

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 de um cluster de banco de dados que use o Amazon DocumentDB Sem Servidor
<a name="docdb-serverless-create-cluster"></a>



## Criação de um cluster do Amazon DocumentDB Sem Servidor
<a name="w2aac41c17b5"></a>

Com o Amazon DocumentDB Sem Servidor, seus clusters são intercambiáveis com clusters provisionados. É possível ter clusters em que algumas instâncias usem tecnologia sem servidor e algumas sejam provisionadas.

Verifique se a região e a versão do mecanismo desejadas oferecem suporte ao DocumentDB Sem Servidor. Consulte [Requisitos e limitações do DocumentDB Sem Servidor](docdb-serverless-limitations.md).

Para criar um cluster do Amazon DocumentDB ao qual você possa adicionar instâncias com tecnologia sem servidor, siga o mesmo procedimento usado em [Criar um cluster do Amazon DocumentDB](db-cluster-create.md). A única diferença é que o argumento `ServerlessV2ScalingConfiguration` também deve ser fornecido.

O argumento `ServerlessV2ScalingConfiguration` especifica a faixa de capacidade de escalabilidade de suas instâncias do DocumentDB Sem Servidor. Ele consiste nos valores mínimo e máximo de unidade de capacidade do DocumentDB (DCU) que se aplicam a todas as instâncias do DocumentDB Sem Servidor no cluster:
+ O valor `MinCapacity` especifica a capacidade mínima de escalabilidade.
+ O valor `MaxCapacity` especifica a capacidade máxima de escalabilidade.

Para ter mais informações sobre a escalabilidade, consulte [Configuração de escalabilidade do Amazon DocumentDB Sem Servidor](docdb-serverless-scaling-config.md).

------
#### [ Using the Console de gerenciamento da AWS ]

O exemplo Console de gerenciamento da AWS de configuração a seguir mostra como criar um cluster sem servidor DocumentDB.

1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/docdb/home?region=us-east-1) e abra o console do Amazon DocumentDB.

1. No painel de navegação, escolha **Clusters**.
**dica**  
Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.

   A tabela **Clusters** será exibida.

1. Escolha **Criar**.

   A página **Criação de cluster do Amazon DocumentDB** será exibida.

1. Na página Criação de cluster do Amazon DocumentDB, na seção **Tipo de cluster**, escolha **Clusters baseados em instâncias** (essa é a opção padrão).

1. Na seção **Configuração do cluster**:

   1. Em **Identificador do cluster**, insira um nome exclusivo, como **myserverlesscluster**. Observe que o console mudará todos os nomes de cluster para minúsculas, independentemente de como eles sejam inseridos.

   1. Em **Versão do mecanismo**, escolha **5.0.0** (essa é a opção padrão).

1. Na seção **Configuração de armazenamento do cluster**, escolha **Amazon DocumentDB Padrão** (essa é a opção padrão).
**nota**  
A outra opção nessa categoria é o **Amazon DocumentDB otimizado para E/S**. Para saber mais sobre as opções, consulte [Configurações de armazenamento de cluster do Amazon DocumentDB](db-cluster-storage-configs.md).

1. Na seção **Instance configuration**:

   1. Em **Classe da instância de banco de dados**, escolha **Serverless**.

   1. Em **Número de instâncias de réplica regulares**, escolha **3** (essa é a opção padrão).

   1. Na seção **Faixa de capacidade**, deixe os valores padrão para **Mínimo DCUs** e **Máximo DCUs**. Para receber informações sobre como definir parâmetros, consulte [Limites das instâncias do Amazon DocumentDB Sem Servidor](docdb-serverless-instance-limits.md).  
![\[Formulário de configuração para um cluster de banco de dados sem servidor com campos para classe de instância, instâncias de réplica e intervalo de capacidade.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/instance-config-serverless.png)

1. Na seção **Conectividade**, mantenha a configuração padrão **Não se conectar a um recurso de computação do EC2**.

1. Na seção **Autenticação**, insira um nome de usuário para o usuário principal e escolha **Autogerenciado**. Insira uma senha e confirme-a.

   Se, em vez disso, você escolher **Gerenciado em AWS Secrets Manager**, consulte [Gerenciamento de senhas com o Amazon DocumentDB e AWS Secrets Manager](docdb-secrets-manager.md) para obter mais informações.

1. Deixe todas as outras opções conforme o padrão e escolha **Criar cluster**.

------
#### [ Using the AWS CLI ]

No exemplo a seguir, substitua cada um *user input placeholder* por suas próprias informações ou parâmetros de configuração.

Para criar um cluster compatível com as instâncias sem servidor do DocumentDB usando o, consulte. AWS CLI[Criando um cluster usando o AWS CLI](db-cluster-create.md#db-cluster-create-cli)

Inclua os parâmetros adicionais a seguir em seu comando `create-db-cluster`:

```
--serverless-v2-scaling-configuration 
     MinCapacity=minimum_capacity,MaxCapacity=maximum_capacity
```

Exemplo:

```
aws docdb create-db-cluster \
      --db-cluster-identifier sample-cluster \
      --engine docdb \
      --engine-version 5.0.0 \
      --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16 \
      --master-username user-name \
      --master-user-password password
```

------

## Adição de uma instância do Amazon DocumentDB Sem Servidor
<a name="docdb-serverless-adding-instance"></a>

Para adicionar uma instância do DocumentDB Sem Servidor, siga o mesmo procedimento em [Adicionar uma instância do Amazon DocumentDB a um cluster](db-instance-add.md), certificando-se de especificar db.serverless como classe da instância.

### Adição de uma instância com tecnologia sem servidor por meio do Console de gerenciamento da AWS.
<a name="w2aac41c17b7b5"></a>

Para adicionar uma instância do DocumentDB Sem Servidor usando o console, consulte [Adicionar uma instância do Amazon DocumentDB a um cluster](db-instance-add.md) e escolha a guia **Uso do Console de gerenciamento da AWS**.

### Adicionar uma instância sem servidor usando o AWS CLI
<a name="w2aac41c17b7b7"></a>

**Para adicionar uma instância sem servidor do DocumentDB usando o AWS CLI, consulte [Adicionar uma instância do Amazon DocumentDB a um cluster](db-instance-add.md) e escolha a guia Usando o. AWS CLI**

Use o argumento da CLI de classe de instância a seguir:

```
--db-instance-class db.serverless
```

Exemplo:

```
aws docdb create-db-instance \
      --db-cluster-identifier sample-cluster \
      --db-instance-identifier sample-instance \
      --db-instance-class db.serverless \
      --engine docdb
```