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á.
# Descrever os grupos de parâmetros de cluster do Amazon DocumentDB
Um grupo de parâmetros de cluster `default` é criado automaticamente quando você cria o primeiro cluster Amazon DocumentDB na nova região ou usa um novo mecanismo. Os clusters subsequentes, criados na mesma região e com a mesma versão do mecanismo, são criados com o grupo de parâmetros do cluster `default`.
**Topics**
+ [Descrevendo os detalhes de um grupo de parâmetros de cluster](#cluster_parameter_groups-describe_details)
+ [Determinando um grupo de parâmetros de um cluster](#cluster_parameter_groups-determine)
+ [Determinação de clusters e instâncias associados a um grupo de parâmetros de cluster](#cluster_parameter_groups-count)
## Descrevendo os detalhes de um grupo de parâmetros de cluster do Amazon DocumentDB
Para descrever os detalhes de um determinado grupo de parâmetros de cluster, conclua as etapas a seguir usando o Console de gerenciamento da AWS ou o AWS Command Line Interface (AWS CLI).
------
#### [ Using the Console de gerenciamento da AWS ]
****
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 **Grupos de parâmetros**.
**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. No painel **Grupos de parâmetros de cluster**, escolha o nome do grupo de parâmetros de cluster cujos detalhes deseja visualizar.
1. A página resultante exibe os parâmetros do grupo de parâmetros, a atividade recente e as tags.
+ Em **Parâmetros de cluster**, é possível ver o nome do parâmetro, o valor atual, os valores permitidos, se o parâmetro é modificável, o tipo de aplicação, o tipo de dado e a descrição. É possível modificar parâmetros individuais selecionando o parâmetro e escolhendo **Editar** na seção **Parâmetros de cluster**. Para obter mais informações, consulte [Modificando os parâmetros de cluster do Amazon DocumentDB](cluster_parameter_groups-parameters.md).
+ Em **Eventos recentes**, é possível ver os eventos mais recentes para esse grupo de parâmetros. É possível filtrar esses eventos usando a barra de pesquisa nesta seção. Para obter mais informações, consulte [Gerenciando eventos do Amazon DocumentDB](managing-events.md).
+ Em **Tags**, você pode ver as tags nesse grupo de parâmetro do cluster. É possível adicionar ou remover tags escolhendo **Editar** na seção **Tags**. Para obter mais informações, consulte [Marcação de recursos do Amazon DocumentDB](tagging.md).
------
#### [ Using the AWS CLI ]
Você pode usar o `describe-db-cluster-parameter-groups` AWS CLI comando para visualizar o Amazon Resource Name (ARN), a família, a descrição e o nome de um único grupo de parâmetros de cluster ou de todos os grupos de parâmetros de cluster que você tem para o Amazon DocumentDB. Você também pode usar o `describe-db-cluster-parameters` AWS CLI comando para visualizar os parâmetros e seus detalhes dentro de um único grupo de parâmetros do cluster.
+ **--describe-db-cluster-parameter-groups** — para ver uma lista de todos os grupos de parâmetros de cluster e seus detalhes.
+ **--db-cluster-parameter-group-name** — Opcional. O nome do grupo de parâmetro de cluster que você deseja descrever. Se esse parâmetro for omitido, todos os grupos de parâmetro de cluster serão descritos.
+ **--describe-db-cluster-parameters** — para listar todos os parâmetros em um grupo de parâmetros e seus valores.
+ **--db-cluster-parameter-group name** — obrigatório. O nome do grupo de parâmetro de cluster que você deseja descrever.
**Example**
O código a seguir lista até 100 grupos de parâmetros de cluster e seus ARNs, famílias, descrições e nomes.
```
aws docdb describe-db-cluster-parameter-groups
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"DBClusterParameterGroups": [
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:default.docdb4.0",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Default cluster parameter group for docdb4.0",
"DBClusterParameterGroupName": "default.docdb4.0"
},
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:012345678912:cluster-pg:sample-parameter-group",
"DBParameterGroupFamily": "docdb4.0",
"Description": "Custom docdb4.0 parameter group",
"DBClusterParameterGroupName": "sample-parameter-group"
}
]
}
```
**Example**
O código a seguir lista o ARN, a família, a descrição e o nome do `sample-parameter-group`.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--db-cluster-parameter-group-name sample-parameter-group
```
Para Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--db-cluster-parameter-group-name sample-parameter-group
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"DBClusterParameterGroups": [
{
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:sample-parameter-group",
"Description": "Custom docdb4.0 parameter group",
"DBParameterGroupFamily": "docdb4.0",
"DBClusterParameterGroupName": "sample-parameter-group"
}
]
}
```
**Example**
O código a seguir lista os valores dos parâmetros no `sample-parameter-group`.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Para Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"Parameters": [
{
"ParameterName": "audit_logs",
"ParameterValue": "disabled",
"Description": "Enables auditing on cluster.",
"Source": "system",
"ApplyType": "dynamic",
"DataType": "string",
"AllowedValues": "enabled,disabled",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
},
{
"ParameterName": "change_stream_log_retention_duration",
"ParameterValue": "17777",
"Description": "Duration of time in seconds that the change stream log is retained and can be consumed.",
"Source": "user",
"ApplyType": "dynamic",
"DataType": "integer",
"AllowedValues": "3600-86400",
"IsModifiable": true,
"ApplyMethod": "pending-reboot"
}
]
}
```
------
## Determinando o grupo de parâmetros de um cluster do Amazon DocumentDB
Para determinar qual grupo de parâmetros está associado a um determinado cluster, conclua as etapas a seguir usando o Console de gerenciamento da AWS ou AWS CLI o.
------
#### [ Using the Console de gerenciamento da AWS ]
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 à esquerda, escolha **Clusters**.
1. Na lista de clusters, selecione o nome do cluster desejado.
1. A página resultante exibe os detalhes do cluster selecionado. Role para baixo até **Detalhes do cluster**. Na parte inferior dessa seção, localize o nome do grupo de parâmetros sob **Grupo de parâmetros de cluster**.
![\[Captura de tela: como mostrar um grupo de parâmetros de um cluster.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png)
------
#### [ Using the AWS CLI ]
O AWS CLI código a seguir determina qual grupo de parâmetros está governando o cluster`sample-cluster`.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
[
[
"sample-cluster",
"sample-parameter-group"
]
]
```
------
## Determinação de clusters e instâncias associados a um grupo de parâmetros de cluster do Amazon DocumentDB
Para determinar quantos clusters e instâncias estão associados a cada grupo de parâmetros, conclua as etapas a seguir usando AWS CLI o.
------
#### [ Using the AWS CLI ]
O AWS CLI código a seguir determina a quantos clusters e instâncias estão associados`sample-parameter-group`.
Para Linux, macOS ou Unix:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' \
--output json | \
jq -r 'group_by(.[0]) | map({
parameter_group_name: .[0][0],
total_clusters: length,
total_instances: map(.[2] | length) | add // 0
}) | .[]'
```
Para Windows:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterParameterGroup,DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ^
--output json | ^
jq -r 'group_by(.[0]) | map({
parameter_group_name: .[0][0],
total_clusters: length,
total_instances: map(.[2] | length) | add // 0
}) | .[]'
```
A saída dessa operação é semelhante ao seguinte (formato JSON).
```
{
"parameter_group_name": "sample-parameter-group",
"total_clusters": 50,
"total_instances": 150
}
```
------