La méthode HeadObject récupère les métadonnées d'un objet sans renvoyer l'objet lui-même.
Notes
Les métadonnées d'un objet décrivent ses propriétés. Elles incluent des en-têtes HTTP standard et des métadonnées définies par l'utilisateur. Configurez les en-têtes HTTP standard pour créer des politiques de requête HTTP personnalisées, telles que des politiques de mise en cache ou de téléchargement forcé. Définissez des métadonnées utilisateur pour identifier l'objectif ou les propriétés d'un objet. Pour plus d'informations, consultez la rubrique Métadonnées d'objet.
Le SDK OSS pour iOS ne prend pas en charge la configuration ni la modification des métadonnées d'objet.
Exemple de code
L'exemple de code suivant montre comment récupérer les métadonnées d'un objet :
OSSHeadObjectRequest * request = [OSSHeadObjectRequest new];
// Specify the bucket name. For example, examplebucket.
request.bucketName = @"examplebucket";
// Specify the full path of the object. The full path cannot contain the bucket name. For example, exampledir/exampleobject.txt.
request.objectKey = @"exampledir/exampleobject.txt";
OSSTask * headTask = [client headObject:request];
[headTask continueWithBlock:^id(OSSTask *task) {
if (!task.error) {
NSLog(@"head object success!");
OSSHeadObjectResult * result = task.result;
NSLog(@"header fields: %@", result.httpResponseHeaderFields);
for (NSString * key in result.objectMeta) {
NSLog(@"ObjectMeta: %@ - %@", key, [result.objectMeta objectForKey:key]);
}
} else {
NSLog(@"head object failed, error: %@" ,task.error);
}
return nil;
}];Références
Pour une description de l'opération API permettant de récupérer les métadonnées d'un objet, consultez la rubrique GetObjectMeta.