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.

# DescribeClusters
<a name="API_DescribeClusters"></a>

Gibt Informationen über alle bereitgestellten Cluster zurück, wenn keine Cluster-ID angegeben ist, oder über einen bestimmten Cluster, wenn ein Clustername angegeben wird.

## Anforderungssyntax
<a name="API_DescribeClusters_RequestSyntax"></a>

```
{
   "ClusterName": "string",
   "MaxResults": number,
   "NextToken": "string",
   "ShowShardDetails": boolean
}
```

## Anforderungsparameter
<a name="API_DescribeClusters_RequestParameters"></a>

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [ClusterName](#API_DescribeClusters_RequestSyntax) **   <a name="MemoryDB-DescribeClusters-request-ClusterName"></a>
Der Name des Clusters.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [MaxResults](#API_DescribeClusters_RequestSyntax) **   <a name="MemoryDB-DescribeClusters-request-MaxResults"></a>
Die maximale Anzahl der in der Antwort zurückgegebenen Datensätze. Wenn mehr Datensätze als der angegebene MaxResults Wert vorhanden sind, ist ein Token in der Antwort enthalten, sodass die verbleibenden Ergebnisse abgerufen werden können.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** [NextToken](#API_DescribeClusters_RequestSyntax) **   <a name="MemoryDB-DescribeClusters-request-NextToken"></a>
Ein optionales Argument, das übergeben wird, falls die Gesamtzahl der Datensätze den Wert von überschreitet MaxResults. Wenn nextToken zurückgegeben wird, sind mehr Ergebnisse verfügbar. Der Wert von nextToken ist ein eindeutiges Paginierungstoken für jede Seite. Rufen Sie erneut mit dem zurückgegebenen Token auf, um die nächste Seite abzurufen. Behalten Sie alle anderen Argumente unverändert bei.   
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [ShowShardDetails](#API_DescribeClusters_RequestSyntax) **   <a name="MemoryDB-DescribeClusters-request-ShowShardDetails"></a>
Ein optionales Flag, das in die Anfrage aufgenommen werden kann, um Informationen über die einzelnen Shards abzurufen.  
Typ: Boolesch  
Erforderlich: Nein

## Antwortsyntax
<a name="API_DescribeClusters_ResponseSyntax"></a>

```
{
   "Clusters": [ 
      { 
         "ACLName": "string",
         "ARN": "string",
         "AutoMinorVersionUpgrade": boolean,
         "AvailabilityMode": "string",
         "ClusterEndpoint": { 
            "Address": "string",
            "Port": number
         },
         "DataTiering": "string",
         "Description": "string",
         "Engine": "string",
         "EnginePatchVersion": "string",
         "EngineVersion": "string",
         "IpDiscovery": "string",
         "KmsKeyId": "string",
         "MaintenanceWindow": "string",
         "MultiRegionClusterName": "string",
         "Name": "string",
         "NetworkType": "string",
         "NodeType": "string",
         "NumberOfShards": number,
         "ParameterGroupName": "string",
         "ParameterGroupStatus": "string",
         "PendingUpdates": { 
            "ACLs": { 
               "ACLToApply": "string"
            },
            "Resharding": { 
               "SlotMigration": { 
                  "ProgressPercentage": number
               }
            },
            "ServiceUpdates": [ 
               { 
                  "ServiceUpdateName": "string",
                  "Status": "string"
               }
            ]
         },
         "SecurityGroups": [ 
            { 
               "SecurityGroupId": "string",
               "Status": "string"
            }
         ],
         "Shards": [ 
            { 
               "Name": "string",
               "Nodes": [ 
                  { 
                     "AvailabilityZone": "string",
                     "CreateTime": number,
                     "Endpoint": { 
                        "Address": "string",
                        "Port": number
                     },
                     "Name": "string",
                     "Status": "string"
                  }
               ],
               "NumberOfNodes": number,
               "Slots": "string",
               "Status": "string"
            }
         ],
         "SnapshotRetentionLimit": number,
         "SnapshotWindow": "string",
         "SnsTopicArn": "string",
         "SnsTopicStatus": "string",
         "Status": "string",
         "SubnetGroupName": "string",
         "TLSEnabled": boolean
      }
   ],
   "NextToken": "string"
}
```

## Antwortelemente
<a name="API_DescribeClusters_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [Clusters](#API_DescribeClusters_ResponseSyntax) **   <a name="MemoryDB-DescribeClusters-response-Clusters"></a>
Eine Liste von Clustern  
Typ: Array von [Cluster](API_Cluster.md)-Objekten

 ** [NextToken](#API_DescribeClusters_ResponseSyntax) **   <a name="MemoryDB-DescribeClusters-response-NextToken"></a>
Ein optionales Argument, das übergeben wird, falls die Gesamtzahl der Datensätze den Wert von überschreitet MaxResults. Wenn nextToken zurückgegeben wird, sind mehr Ergebnisse verfügbar. Der Wert von nextToken ist ein eindeutiges Paginierungstoken für jede Seite. Rufen Sie erneut mit dem zurückgegebenen Token auf, um die nächste Seite abzurufen. Behalten Sie alle anderen Argumente unverändert bei.   
Typ: Zeichenfolge

## Fehler
<a name="API_DescribeClusters_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** ClusterNotFoundFault **   
  
HTTP-Statuscode: 400

 ** InvalidParameterCombinationException **   
  
HTTP-Statuscode: 400

 ** InvalidParameterValueException **   
  
HTTP-Statuscode: 400

 ** ServiceLinkedRoleNotFoundFault **   
  
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_DescribeClusters_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/DescribeClusters) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/DescribeClusters) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/DescribeClusters) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/DescribeClusters) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/DescribeClusters) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/DescribeClusters) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/DescribeClusters) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/DescribeClusters) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/DescribeClusters) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/DescribeClusters)