Todos os produtos
Search
Central de documentação

Object Storage Service:Tratamento de exceções (PHP SDK V1)

Última atualização: Jul 03, 2026

O OSS PHP SDK lança uma OssException para erros como parâmetros inválidos e arquivos inexistentes. Use o método getMessage para obter a mensagem de erro.

Para obter mais informações sobre OssException, consulte GitHub.

Exemplo de tratamento de exceção

O código a seguir demonstra como tratar uma exceção lançada ao tentar crie um bucket que já existe. O exemplo imprime a mensagem de erro correspondente.

    try {
        $ossClient->createBucket($bucket);
    } catch (OssException $e) {
        print("Exception:" . $e->getMessage() . "\n");
    }
            

Também é possível obter as seguintes informações:

Parâmetro

Descrição

HTTPStatus

Código de status HTTP. Use o método getHTTPStatus para obter esse valor.

ErrorCode

Código de erro retornado pelo OSS. Use o método getErrorCode para obter esse valor.

ErrorMessage

Mensagem de erro retornada pelo OSS. Use o método getErrorMessage para obter esse valor.

RequestId

Identificador universalmente único (UUID) da requisição. Caso não consiga resolver um problema, forneça este RequestId a um desenvolvedor do OSS para obter assistência. Use o método getRequestId para obter esse valor.

Details

Descrição detalhada da mensagem de erro retornada pelo OSS. Use o método getDetails para obter esse valor.

Códigos de erro comuns do OSS

Código de erro

Descrição

Código de status HTTP

AccessDenied

Acesso negado.

403

BucketAlreadyExists

O bucket já existe.

409

BucketNotEmpty

O bucket não está vazio.

409

EntityTooLarge

A entidade é muito grande.

400

EntityTooSmall

A entidade é muito pequena.

400

FileGroupTooLarge

O grupo de arquivos é muito grande.

400

FilePartNotExist

A parte do arquivo não existe.

400

FilePartStale

A parte do arquivo está obsoleta.

400

InvalidArgument

O formato do parâmetro é inválido.

400

InvalidAccessKeyId

O AccessKey ID não existe.

403

InvalidBucketName

O nome do bucket é inválido.

400

InvalidDigest

O digest é inválido.

400

InvalidObjectName

O nome do objeto é inválido.

400

InvalidPart

A parte é inválida.

400

InvalidPartOrder

A ordem das partes é inválida.

400

InvalidTargetBucketForLogging

O bucket de destino para a operação de log é inválido.

400

InternalError

Ocorreu um erro interno no OSS.

500

MalformedXML

O formato XML é inválido.

400

MethodNotAllowed

O método não é suportado.

405

MissingArgument

Um parâmetro está ausente.

411

MissingContentLength

O tamanho do conteúdo está ausente.

411

NoSuchBucket

O bucket não existe.

404

NoSuchKey

O objeto não existe.

404

NoSuchUpload

O ID de upload multipart não existe.

404

NotImplemented

Não é possível processar o método.

501

PreconditionFailed

Ocorreu um erro de pré-condição.

412

RequestTimeTooSkewed

A diferença entre o horário do cliente e o do servidor OSS ultrapassa 15 minutos.

403

RequestTimeout

A requisição expirou.

400

SignatureDoesNotMatch

A assinatura está incorreta.

403

InvalidEncryptionAlgorithmError

O algoritmo de criptografia especificado está incorreto.

400