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á.
# Adicionar uma instância do Amazon DocumentDB a um cluster
------
#### [ Using the Console de gerenciamento da AWS ]
Use o procedimento a seguir para criar uma instância para o cluster usando o console do Amazon DocumentDB.
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon DocumentDB em https://console.aws.amazon.com /docdb.](https://console.aws.amazon.com/docdb)
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.
1. Para escolher o cluster ao qual você deseja adicionar uma instância, selecione o botão à esquerda do nome do cluster.
1. Escolha **Ações** e escolha **Adicionar instâncias**.
1. Na página **Adicionar instância a: **, repita as etapas a seguir para cada instância a ser adicionada ao cluster. É possível ter até 15.
1. **Identificador da instância**: você pode inserir um identificador exclusivo para essa instância ou permitir que o Amazon DocumentDB forneça o identificador da instância com base no identificador do cluster.
Restrições de nomenclatura da instância:
+ O comprimento é de [1 a 63] letras, números ou hífens.
+ O primeiro caractere deve ser uma letra.
+ Não pode terminar com um hífen ou conter dois hifens consecutivos.
+ Deve ser exclusivo para todas as instâncias do Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS
1. **Classe da instância**: na lista suspensa, escolha o tipo de instância desejado para essa instância.
1. **Nível de promoção**: na lista suspensa, escolha o nível de promoção da instância ou selecione *Nenhuma preferência* para permitir que o Amazon DocumentDB defina o nível de promoção para a instância. Números mais baixos significam maior prioridade. Para obter mais informações, consulte [Controlar o destino de failover](failover.md#failover-target_control).
1. Para adicionar mais instâncias, escolha **Adicionar outras instâncias** e repita as etapas a, b e c.
1. Conclua a operação.
+ Para adicionar instâncias ao seu cluster, escolha **Criar**.
+ Para cancelar a operação, escolha **Cancelar**.
Leva alguns minutos para criar uma instância. Você pode usar o console ou AWS CLI visualizar o status da instância. Para obter mais informações, consulte [Monitorar o status de uma instância](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Use a `create-db-instance` AWS CLI operação com os parâmetros a seguir para criar a instância primária para seu cluster.
+ **--db-instance-class** — Obrigatório. A capacidade de computação e memória da instância, por exemplo, `db.m4.large`. Nem todas as classes de instâncias estão disponíveis em todas as Regiões da AWS.
+ **--db-instance-identifier** — Obrigatório. Uma string que identifica a instância.
Restrições de nomenclatura da instância:
+ O comprimento é de [1 a 63] letras, números ou hífens.
+ O primeiro caractere deve ser uma letra.
+ Não pode terminar com um hífen ou conter dois hifens consecutivos.
+ Deve ser exclusivo para todas as instâncias do Amazon RDS, Neptune e Amazon DocumentDB por região. Conta da AWS
+ **--engine** — Obrigatório. Deve ser `docdb`.
+ **--availability-zone** — Opcional. A zona de disponibilidade na qual você deseja que essa instância seja criada. Use esse parâmetro para localizar suas instâncias em diferentes zonas de disponibilidade para aumentar a tolerância a falhas. Para obter mais informações, consulte [Alta disponibilidade e replicação do Amazon DocumentDB](replication.md).
+ **--promotion-tier** — Opcional. O nível de prioridade de failover dessa instância. Deve estar entre 0 e 15, com números mais baixos sendo prioridade mais alta. Para obter mais informações, consulte [Controlar o destino de failover](failover.md#failover-target_control).
1. **Primeiro, determine em quais zonas de disponibilidade você pode criar a instância. **
Se quiser especificar a zona de disponibilidade antes de criar a instância, execute o seguinte comando para determinar quais zonas de disponibilidade estão disponíveis para o cluster do Amazon DocumentDB.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Para Windows:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
A saída dessa operação é semelhante à seguinte.
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **Segundo, determine quais classes de instância você pode criar na região. **
Para determinar quais classes de instância estão disponíveis na sua região, execute o seguinte comando. Na saída, escolha uma classe de instância para a instância que deseja adicionar ao cluster do Amazon DocumentDB.
Para Linux, macOS ou Unix:
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Para Windows:
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
A saída dessa operação é semelhante à seguinte.
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **Por último, adicione uma instância ao cluster do Amazon DocumentDB.**
Para adicionar uma instância ao cluster do Amazon DocumentDB, execute o seguinte comando.
Para Linux, macOS ou Unix:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
Para Windows:
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
A saída dessa operação é semelhante à seguinte.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
Leva alguns minutos para criar a instância. Você pode usar o console ou AWS CLI visualizar o status da instância. Para obter mais informações, consulte [Monitoramento do status de uma instância do Amazon DocumentDB](monitoring_docdb-instance_status.md).
------