Respostas de erro de SOAP
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.
<soapenv:Body> <soapenv:Fault> <Faultcode>soapenv:Client.NoSuchKey</Faultcode> <Faultstring>The specified key does not exist.</Faultstring> <Detail> <Key>Fred</Key> </Detail> </soapenv:Fault> </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 Tipo: Container Antepassado: Body.Fault |
Fault
|
Contêiner para informações de erro. Tipo: Container 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. Tipo: string 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. Tipo: string Antepassado: Body.Fault |
Key
|
Identifica a chave envolvida no erro Tipo: string Antepassado: Body.Fault |
