Todos os produtos
Search
Central de documentação

Object Storage Service:Get bucket information (iOS SDK)

Última atualização: Sep 25, 2026

Um bucket é um contêiner usado para armazenar objetos no Object Storage Service (OSS). Todos os objetos do OSS são armazenados em buckets. Este tópico descreve como consultar as informações de um bucket.

Observações

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

    Nota

    Ao inicializar uma instância do OSSClient, especifique um endpoint que corresponda à região do bucket.

Exemplos

O código de exemplo a seguir mostra como consultar as informações de um bucket chamado examplebucket, incluindo a região, a data de criação e a ACL do bucket:

OSSGetBucketInfoRequest *request = [OSSGetBucketInfoRequest new];
// Specify the name of the bucket. Example: examplebucket. 
request.bucketName = @"examplebucket";
// Query the information about the bucket. 
OSSTask * getBucketInfoTask = [client getBucketInfo:request];

[getBucketInfoTask continueWithBlock:^id(OSSTask *task) {
    if (!task.error) {
        OSSGetBucketInfoResult *result = task.result;
        NSLog(@"Creation time: %@", result.creationDate);
        NSLog(@"Region: %@", result. Location);
        NSLog(@"Storage class: %@", result.storageClass);
        NSLog(@"Owner: %@", result.owner.userName);
        NSLog(@"ACL: %@", result.acl.grant);
    } else {
        NSLog(@"get bucket info failed, error: %@", task.error);
    }
    return nil;
}];
// Implement synchronous blocking to wait for the task to complete. 
// [getBucketInfoTask waitUntilFinished];

Referências

  • Para obter o código de exemplo completo usado para consultar as informações de um bucket, acesse o GitHub.

  • Para mais informações sobre a operação de API usada para consultar as informações de um bucket, consulte GetBucketInfo.

  • Consulte Initialization para mais informações sobre como inicializar uma instância do OSSClient.