O método HeadObject recupera os metadados de um objeto sem retornar o próprio objeto.
Observações
Os metadados descrevem as propriedades do objeto e incluem cabeçalhos HTTP padrão e metadados definidos pelo usuário. Configure cabeçalhos HTTP padrão para criar políticas personalizadas de requisição HTTP, como políticas de cache e de download forçado. Defina metadados personalizados para identificar a finalidade ou as características do objeto. Para mais informações, consulte Metadados de objeto.
O OSS SDK for iOS não permite configurar nem modificar metadados de objeto.
Código de exemplo
O código a seguir mostra como recuperar metadados de objeto:
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;
}];Referências
Para obter a descrição da operação de API que recupera metadados de objeto, consulte GetObjectMeta.