Todos os produtos
Search
Central de documentação

Object Storage Service:Exception handling (PHP SDK V1)

Última atualização: Sep 22, 2026

O PHP SDK do OSS 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 a OssException, consulte o GitHub.

Exemplo de tratamento de exceções

Para testar, crie um bucket que já existe. O código a seguir mostra como tratar a exceção lançada e imprime a mensagem de erro.

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

Você também pode obter as seguintes informações:

Parâmetro

Descrição

HTTPStatus

O código de status HTTP. Para obter esse valor, utilize o método getHTTPStatus.

ErrorCode

O código de erro retornado pelo OSS. Obtenha esse valor por meio do método getErrorCode.

ErrorMessage

A mensagem de erro retornada pelo OSS. Use o método getErrorMessage para resgatar essa informação.

RequestId

Um identificador universalmente exclusivo (UUID) que identifica a requisição de forma única. Caso não consiga resolver um problema, forneça este RequestId a um desenvolvedor do OSS para obter assistência. O método getRequestId retorna esse valor.

Details

Uma descrição detalhada da mensagem de erro retornada pelo OSS. Chame 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 AccessKeyID (AccessKey ou accesskey) 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 do upload de múltiplas partes não existe.

404

NotImplemented

O método não pode ser processado.

501

PreconditionFailed

Ocorreu um erro de pré-processamento.

412

RequestTimeTooSkewed

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

403

RequestTimeout

A requisição atingiu o tempo limite.

400

SignatureDoesNotMatch

A assinatura está incorreta.

403

InvalidEncryptionAlgorithmError

O algoritmo de criptografia especificado está incorreto.

400