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.

# FailoverShard
<a name="API_FailoverShard"></a>

Wird für ein Failover eines Shards verwendet. Diese API wurde entwickelt, um das Verhalten Ihrer Anwendung im Falle eines MemoryDB-Failovers zu testen. Sie ist nicht dafür konzipiert, als Tool auf Produktionsebene verwendet zu werden, um einen Failover einzuleiten, um ein Problem zu lösen, das Sie möglicherweise mit dem Cluster haben. Darüber hinaus kann Amazon unter bestimmten Bedingungen, z. B. bei großen Betriebsereignissen, diese API blockieren. 

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

```
{
   "ClusterName": "string",
   "ShardName": "string"
}
```

## Anforderungsparameter
<a name="API_FailoverShard_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_FailoverShard_RequestSyntax) **   <a name="MemoryDB-FailoverShard-request-ClusterName"></a>
Für den Cluster wurde ein Failover ausgeführt.  
Typ: Zeichenfolge  
Erforderlich: Ja

 ** [ShardName](#API_FailoverShard_RequestSyntax) **   <a name="MemoryDB-FailoverShard-request-ShardName"></a>
Der Name des Shards.  
Typ: Zeichenfolge  
Erforderlich: Ja

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

```
{
   "Cluster": { 
      "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
   }
}
```

## Antwortelemente
<a name="API_FailoverShard_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.

 ** [Cluster](#API_FailoverShard_ResponseSyntax) **   <a name="MemoryDB-FailoverShard-response-Cluster"></a>
Für den Cluster wurde ein Failover ausgeführt.  
Typ: [Cluster](API_Cluster.md) Objekt

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

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

 ** APICallRateForCustomerExceededFault **   
  
HTTP-Statuscode: 400

 ** ClusterNotFoundFault **   
  
HTTP-Statuscode: 400

 ** InvalidClusterStateFault **   
  
HTTP-Statuscode: 400

 ** InvalidKMSKeyFault **   
  
HTTP-Statuscode: 400

 ** InvalidParameterCombinationException **   
  
HTTP-Statuscode: 400

 ** InvalidParameterValueException **   
  
HTTP-Statuscode: 400

 ** ShardNotFoundFault **   
  
HTTP-Statuscode: 400

 ** TestFailoverNotAvailableFault **   
  
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_FailoverShard_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/FailoverShard) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/FailoverShard) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/FailoverShard)