

# Respostas de erro de SOAP
<a name="SOAPErrorResponses"></a>

**nota**  
 As APIs SOAP para o Amazon S3 não estão disponíveis para novos clientes e chegam ao fim da vida útil (EOL) em 31 de agosto de 2025. Recomendamos usar a API REST ou os AWS SDKs. 

Em SOAP, um resultado de erro será retornado ao cliente como uma falha de SOAP, com o código de resposta HTTP 500. Se você não receber uma falha de SOAP, sua solicitação terá sido bem-sucedida. O código de falha de SOAP do Amazon S3 é composto de um código de falha padrão de SOAP 1.1 ("servidor" ou "cliente") concatenado com o código de erro específico ao Amazon S3. Por exemplo: “Server.InternalError” ou “Client.NoSuchBucket”. O elemento da sequência da falha de SOAP contém uma mensagem de erro genérica, legível pelo usuário em inglês. Finalmente, o elemento de detalhes da falha de SOAP contém informações diversas relevantes para o erro.

Por exemplo, se você tentar excluir o objeto “Fred”, que não existe, o corpo da resposta de SOAP conterá uma falha de SOAP “NoSuchKey”.

O exemplo a seguir mostra uma resposta de erro de SOAP.

```
1. <soapenv:Body>
2.   <soapenv:Fault>
3.     <Faultcode>soapenv:Client.NoSuchKey</Faultcode>
4.     <Faultstring>The specified key does not exist.</Faultstring>
5.     <Detail>
6.       <Key>Fred</Key>
7.     </Detail>
8.   </soapenv:Fault>
9.   </soapenv:Body>
```

A tabela a seguir explica os elementos de resposta de erros de SOAP


|  Name (Nome)  |  Descrição  | 
| --- | --- | 
| Detail  | Contêiner para a chave envolvida no erro<br />Tipo: Container<br />Antepassado: Body.Fault | 
| Fault  | Contêiner para informações de erro.<br />Tipo: Container<br />Antepassado: Body | 
| Faultcode  | O código de falha é uma string que identifica exclusivamente uma condição de erro. O objetivo desse código é ser lido e compreendido pelos programas que detectam e tratam erros por tipo. Para obter mais informações, consulte [Lista de códigos de erro](ErrorResponses.md#ErrorCodeList).<br />Tipo: string<br />Antepassado: Body.Fault | 
|  Faultstring  | A string de falha contém uma descrição genérica da condição do erro em inglês. Ela é destinada ao público humano. Programas simples exibem a mensagem diretamente ao usuário final se encontrarem uma condição de erro que não conhecem ou não tratam. Programas sofisticados com tratamento de erro mais exaustivo e internacionalização própria são mais de prováveis de ignorar a string de falha.<br />Tipo: string<br />Antepassado: Body.Fault | 
| Key  | Identifica a chave envolvida no erro<br />Tipo: string<br />Antepassado: Body.Fault | 