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.
NotaAo 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.