All Documents
Current Document

Content is empty

If you don't find the content you expect, please try another search term

Documentation

exif

Last updated:2021-09-14 16:17:55

Operation

exif

Description

You can call this operation to query the exchangeable image file (Exif) information of an image. Exif specifies the format of images used by digital cameras and records the attribute information and shooting data of digital images. The Exif information includes various shooting conditions such as the aperture, shutter, white balance, ISO, focal length, and the shooting date and time. It also includes the brand name and model of the camera, color code, sound recorded during shooting, GPS data, and thumbnails.

Permission

To call this operation, you must have the GetObject permission. If the object does not exist, the following errors may be returned:

  • If you have the ListBucket permission on the bucket where the object resides, KS3 returns a 404 error.
  • If you do not have the ListBucket permission on the bucket, KS3 returns a 403 error.

Request

Syntax

https://BucketName.${Endpoint of the bucket}/object@base@tag=exif   HTTP/1.1
Host: BucketName.${Endpoint of the bucket}

Request parameters

You do not need to set parameters for this request.

Request header

The request does not require a special header.

Response

Response header

Header Required Description
Content-Type Yes The MIME type, which is fixed to application/json.

Response body

The response is provided in a JSON string.

Field Description
Make The camera manufacturer.
Model The camera model.
Orientation The image orientation, which is normal (upper-left).
XResolution The x-axis image resolution, which is 72.
YResolution The y-axis image resolution, which is 72.
ResolutionUnit The resolution unit, which is Dots Per Inch (DPI).
Software The image view software, which is Microsoft Windows Photo Viewer 6.1.7600.16385.
YCbCrPositioning The YCbCr positioning. The value is 2.
ExposureTime The exposure duration, which is 0.00800 (1/125) second.

Operation-specific errors

HTTP status code Description
400 The request format is incorrect.
404 The specified resource does not exist.
403 The access is denied.
500 An internal server error occurred.

Examples

1. Enter the following request in the address bar of your web browser:
https://ks3.ks3-cn-beijing.ksyuncs.com/image_deal/kssyun.png@base@tag=exif

2. Sample response   
{
    Make: "Apple",
    Model: "iPhone 4S",
    Orientation: "1",
    XResolution: "72/1",
    YCbCrPositioning: "1",
    YResolution: "72/1",
    ResolutionUnit: "2",
    ExposureTime: "1/449",
    ...
}
On this page
Pure ModeNormal Mode

Pure Mode

Click to preview the document content in full screen
Feedback