Un bucket est un conteneur permettant de stocker des objets dans Object Storage Service (OSS). Tous les objets d'OSS sont stockés dans des buckets. Cette rubrique explique comment récupérer les informations relatives à un bucket.
Notes
-
Avant d'exécuter l'exemple de code de cette rubrique, créez une instance OSSClient en utilisant un nom de domaine personnalisé ou le Security Token Service (STS). Pour plus d'informations, consultez la section Initialisation.
RemarqueLors de l'initialisation d'une instance OSSClient, spécifiez un endpoint correspondant à la région du bucket.
Exemples
L'exemple de code suivant montre comment récupérer les informations relatives à un bucket nommé examplebucket, notamment sa région, sa date de création et sa liste de contrôle d'accès (ACL) :
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];
Références
Pour consulter l'exemple de code complet permettant de récupérer les informations d'un bucket, rendez-vous sur GitHub.
Pour plus d'informations sur l'opération API permettant de récupérer les informations d'un bucket, consultez la section GetBucketInfo.
Pour plus d'informations sur l'initialisation d'une instance OSSClient, consultez la section Initialisation.