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á.

# DeleteDBCluster
<a name="API_DeleteDBCluster"></a>

Exclui um cluster provisionado anteriormente. Quando você exclui um cluster, todos os backups automatizados para esse cluster são excluídos e não podem ser recuperados. Os snapshots manuais do cluster especificado não são excluídos.



## Parâmetros da solicitação
<a name="API_DeleteDBCluster_RequestParameters"></a>

 Para obter informações sobre os parâmetros comuns a todas as ações, consulte [Parâmetros Comuns](CommonParameters.md).

 ** DBClusterIdentifier **   
O identificador do cluster para o cluster a ser excluído. Esse parâmetro não diferencia maiúsculas de minúsculas.  
Restrições:  
+ Deve corresponder a um `DBClusterIdentifier` existente.
Tipo: String  
Obrigatório: Sim

 ** FinalDBSnapshotIdentifier **   
 O identificador do snapshot do novo snapshot do cluster criado quando `SkipFinalSnapshot` é definido como `false`.   
 Especificar esse parâmetro e também definir o parâmetro `SkipFinalShapshot` para `true` resultará em um erro. 
Restrições:  
+ Deve ter de 1 a 255 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.
Tipo: string  
Obrigatório: não

 ** SkipFinalSnapshot **   
 Determina se um snapshot de cluster foi criado antes de o cluster ser excluído. Se `true` for especificado, nenhum snapshot de cluster será criado. Se `false` for especificado, um snapshot de cluster será criado antes de o cluster do banco de dados ser excluído.   
É necessário especificar um parâmetro `SkipFinalSnapshot` se `false` for `FinalDBSnapshotIdentifier`.
Padrão: `false`   
Tipo: booliano  
Obrigatório: Não

## Elementos de Resposta
<a name="API_DeleteDBCluster_ResponseElements"></a>

O elemento a seguir é retornado pelo serviço.

 ** DBCluster **   
Informações detalhadas sobre um cluster.   
Tipo: objeto [DBCluster](API_DBCluster.md)

## Erros
<a name="API_DeleteDBCluster_Errors"></a>

Para obter informações sobre os erros comuns a todas ações, consulte [Tipos de erro comuns](CommonErrors.md).

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier` não se refere a um cluster existente.   
Código de status HTTP: 404

 ** DBClusterSnapshotAlreadyExistsFault **   
O usuário já tem um snapshot de cluster com o identificador determinado.  
Código de status HTTP: 400

 ** InvalidDBClusterSnapshotStateFault **   
O valor fornecido não é um estado de snapshot de cluster válido.  
Código de status HTTP: 400

 ** InvalidDBClusterStateFault **   
O cluster não está em um estado válido.  
Código de status HTTP: 400

 ** SnapshotQuotaExceeded **   
A solicitação faria com que você excedesse o número de snapshots permitidos.  
Código de Status HTTP: 400

## Consulte também
<a name="API_DeleteDBCluster_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DeleteDBCluster) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DeleteDBCluster)