Todos os produtos
Search
Central de documentação

Object Storage Service:Get object metadata (Android SDK)

Última atualização: Sep 22, 2026

Use o método HeadObject para obter os metadados de um objeto sem incluir o conteúdo dele.

Observações

  • Os metadados de um objeto descrevem as suas propriedades e incluem cabeçalhos HTTP padrão, além de metadados definidos pelo usuário. Defina cabeçalhos HTTP padrão para estabelecer políticas de requisição HTTP, como políticas de cache de objetos ou de download forçado. Configure também metadados personalizados para identificar a finalidade ou as propriedades de um objeto. Para mais informações, consulte Object metadata.

  • O OSS SDK for Android não permite definir nem modificar os metadados de um objeto.

  • Antes de executar o código de exemplo neste tópico, crie uma instância do OSSClient usando métodos como o uso de um nome de domínio personalizado ou o Security Token Service (STS). Para mais informações, consulte Initialization (Android SDK).

Código de exemplo

O código a seguir demonstra como obter os metadados de um objeto.

// Create a request to synchronously get object metadata.
// Specify the bucket name, such as examplebucket, and the full path of the object, such as exampledir/exampleobject.txt. The full path cannot contain the bucket name.
HeadObjectRequest head = new HeadObjectRequest("examplebucket", "exampledir/exampleobject.txt");

// Get the object metadata.
OSSAsyncTask task = oss.asyncHeadObject(head, new OSSCompletedCallback<HeadObjectRequest, HeadObjectResult>() {
    @Override
    public void onSuccess(HeadObjectRequest request, HeadObjectResult result) {
    
    // Get the object length.
        Log.d("headObject", "object Size: " + result.getMetadata().getContentLength()); 
    // Get the object type.
        Log.d("headObject", "object Content Type: " + result.getMetadata().getContentType()); 
    }

    @Override
    public void onFailure(HeadObjectRequest request, ClientException clientExcepion, ServiceException serviceException) {
        // Request exception.
        if (clientExcepion != null) {
            // A client exception occurred, such as a network error.
            clientExcepion.printStackTrace();
        }
        if (serviceException != null) {
            // A server exception occurred.
            Log.e("ErrorCode", serviceException.getErrorCode());
            Log.e("RequestId", serviceException.getRequestId());
            Log.e("HostId", serviceException.getHostId());
            Log.e("RawMessage", serviceException.getRawMessage());
        }
    }
});

// task.waitUntilFinished(); // Wait for the task to complete.

Referências