Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Beschreibung von Amazon DocumentDB-Cluster-Parametergruppen
Eine `default` Cluster-Parametergruppe wird automatisch erstellt, wenn Sie den ersten Amazon DocumentDB-Cluster in einer neuen Region erstellen oder eine neue Engine verwenden. Nachfolgende Cluster, die in derselben Region erstellt werden und dieselbe Engine-Version haben, werden mit der `default` Cluster-Parametergruppe erstellt.
**Topics**
+ [Beschreibung der Details einer Cluster-Parametergruppe](#cluster_parameter_groups-describe_details)
+ [Ermitteln der Parametergruppe eines Clusters](#cluster_parameter_groups-determine)
+ [Ermitteln von Clustern und Instances, die einer Cluster-Parametergruppe zugeordnet sind](#cluster_parameter_groups-count)
## Beschreibung der Details einer Amazon DocumentDB-Cluster-Parametergruppe
Um die Details einer bestimmten Cluster-Parametergruppe zu beschreiben, führen Sie die folgenden Schritte mit dem AWS-Managementkonsole oder dem AWS Command Line Interface (AWS CLI) aus.
------
#### [ Using the AWS-Managementkonsole ]
****
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Wählen Sie im Navigationsbereich **Parameter groups (Parametergruppen)** aus.
**Tipp**
Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.
1. Wählen Sie im Bereich **Cluster parameter groups (Cluster-Parametergruppen)** den Namen der Parametergruppe aus, deren Details Sie anzeigen möchten.
1. Auf der anschließend angezeigten Seite werden die Parameter der Parametergruppe, die letzte Aktivität und Tags angezeigt.
+ In **Cluster parameters (Cluster-Parameter)** werden Ihnen der Name, der aktuelle Wert, die zulässigen Werte, der Anwendungstyp, der Datentyp und die Beschreibung des Parameters angezeigt. Sie können auch erkennen, ob der Parameter geändert werden kann. Sie können einzelne Parameter ändern, indem Sie den Parameter auswählen und dann im Abschnitt **Cluster-Parameter** auf **Bearbeiten** klicken. Weitere Informationen finden Sie unter [Amazon DocumentDB-Cluster-Parameter ändern](cluster_parameter_groups-parameters.md).
+ In **Recent events (Aktuelle Ereignisse)** werden Ihnen die jeweils aktuellen Ereignisse für diese Parametergruppe angezeigt. Sie können diese Ereignisse über die Suchleiste in diesem Abschnitt filtern. Weitere Informationen finden Sie unter [Amazon DocumentDB DocumentDB-Ereignisse verwalten](managing-events.md).
+ Unter **Tags** werden die Tags angezeigt, die sich in dieser Cluster-Parametergruppe befinden. Sie können Tags hinzufügen oder entfernen, indem Sie im Abschnitt **Tags die Option** **Bearbeiten** wählen. Weitere Informationen finden Sie unter [Taggen von Amazon DocumentDB DocumentDB-Ressourcen](tagging.md).
------
#### [ Using the AWS CLI ]
Sie können den `describe-db-cluster-parameter-groups` AWS CLI Befehl verwenden, um den Amazon-Ressourcennamen (ARN), die Familie, die Beschreibung und den Namen einer einzelnen Cluster-Parametergruppe oder aller Cluster-Parametergruppen, die Sie für Amazon DocumentDB haben, anzuzeigen. Sie können den `describe-db-cluster-parameters` AWS CLI Befehl auch verwenden, um die Parameter und ihre Details innerhalb einer einzelnen Cluster-Parametergruppe anzuzeigen.
+ **--describe-db-cluster-parameter-groups**— Um eine Liste all Ihrer Cluster-Parametergruppen und ihrer Details zu sehen.
+ **--db-cluster-parameter-group-name**— Fakultativ. Der Name der Cluster-Parametergruppe, die beschrieben werden soll. Wenn dieser Parameter weggelassen wird, werden alle Cluster-Parametergruppen beschrieben.
+ **--describe-db-cluster-parameters**— Um alle Parameter innerhalb einer Parametergruppe und ihre Werte aufzulisten.
+ **--db-cluster-parameter-group name** – Erforderlich. Der Name der Cluster-Parametergruppe, die beschrieben werden soll.
**Example**
Der folgende Code listet bis zu 100 Cluster-Parametergruppen zusammen mit ARN, Familie, Beschreibung und Name auf.
```
aws docdb describe-db-cluster-parameter-groups
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"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**
Der folgende Code listet den ARN, die Familie, die Beschreibung und den Namen für `sample-parameter-group` auf.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-cluster-parameter-groups \
--db-cluster-parameter-group-name sample-parameter-group
```
Für Windows:
```
aws docdb describe-db-cluster-parameter-groups ^
--db-cluster-parameter-group-name sample-parameter-group
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"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**
Der folgende Code listet die Werte der Parameter in `sample-parameter-group` auf.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-cluster-parameters \
--db-cluster-parameter-group-name sample-parameter-group
```
Für Windows:
```
aws docdb describe-db-cluster-parameters ^
--db-cluster-parameter-group-name sample-parameter-group
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"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"
}
]
}
```
------
## Ermitteln der Parametergruppe eines Amazon DocumentDB-Clusters
Um zu ermitteln, welche Parametergruppe einem bestimmten Cluster zugeordnet ist, führen Sie die folgenden Schritte mit dem AWS-Managementkonsole oder dem aus AWS CLI.
------
#### [ Using the AWS-Managementkonsole ]
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Wählen Sie im linken Navigationsbereich **Cluster** aus.
1. Wählen Sie aus der Liste der Cluster den Namen des Clusters aus, an dem Sie interessiert sind.
1. Auf der anschließend angezeigten Seite werden die Details des von Ihnen ausgewählten Clusters angezeigt. Scrollen Sie nach unten zu **Cluster details (Clusterdetails)**. Sie finden den Namen der Parametergruppe unten in diesem Abschnitt unterhalb von **Cluster parameter group (Cluster-Parametergruppe)**.
![\[Screenshot: Anzeige der Parametergruppe eines Clusters.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-determine-parameter-group.png)
------
#### [ Using the AWS CLI ]
Der folgende AWS CLI Code bestimmt, welche Parametergruppe den Cluster steuert. `sample-cluster`
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterParameterGroup]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
[
[
"sample-cluster",
"sample-parameter-group"
]
]
```
------
## Ermitteln von Clustern und Instances, die einer Amazon DocumentDB-Cluster-Parametergruppe zugeordnet sind
Um zu ermitteln, wie viele Cluster und Instances jeder Parametergruppe zugeordnet sind, führen Sie die folgenden Schritte mit dem aus AWS CLI.
------
#### [ Using the AWS CLI ]
Der folgende AWS CLI Code bestimmt, mit wie vielen Clustern und Instances verknüpft ist`sample-parameter-group`.
Für Linux, macOS oder 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
}) | .[]'
```
Für 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
}) | .[]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"parameter_group_name": "sample-parameter-group",
"total_clusters": 50,
"total_instances": 150
}
```
------