libs3  trunk
S3ResponseProperties Struct Reference

#include <libs3.h>

Data Fields

const char * requestId
 
const char * requestId2
 
const char * contentType
 
uint64_t contentLength
 
const char * server
 
const char * eTag
 
int64_t lastModified
 
int metaDataCount
 
const S3NameValuemetaData
 
char usesServerSideEncryption
 

Detailed Description

S3ResponseProperties is passed to the properties callback function which is called when the complete response properties have been received. Some of the fields of this structure are optional and may not be provided in the response, and some will always be provided in the response.

Field Documentation

const char* S3ResponseProperties::requestId

This optional field identifies the request ID and may be used when reporting problems to Amazon.

const char* S3ResponseProperties::requestId2

This optional field identifies the request ID and may be used when reporting problems to Amazon.

const char* S3ResponseProperties::contentType

This optional field is the content type of the data which is returned by the request. If not provided, the default can be assumed to be "binary/octet-stream".

uint64_t S3ResponseProperties::contentLength

This optional field is the content length of the data which is returned in the response. A negative value means that this value was not provided in the response. A value of 0 means that there is no content provided. A positive value gives the number of bytes in the content of the response.

const char* S3ResponseProperties::server

This optional field names the server which serviced the request.

const char* S3ResponseProperties::eTag

This optional field provides a string identifying the unique contents of the resource identified by the request, such that the contents can be assumed not to be changed if the same eTag is returned at a later time decribing the same resource. This is an MD5 sum of the contents.

int64_t S3ResponseProperties::lastModified

This optional field provides the last modified time, relative to the Unix epoch, of the contents. If this value is < 0, then the last modified time was not provided in the response. If this value is >= 0, then the last modified date of the contents are available as a number of seconds since the UNIX epoch.

int S3ResponseProperties::metaDataCount

This is the number of user-provided meta data associated with the resource.

const S3NameValue* S3ResponseProperties::metaData

These are the meta data associated with the resource. In each case, the name will not include any S3-specific header prefixes (i.e. x-amz-meta- will have been removed from the beginning), and leading and trailing whitespace will have been stripped from the value.

char S3ResponseProperties::usesServerSideEncryption

This optional field provides an indication of whether or not server-side encryption was used for the object. This field is only meaningful if the request was an object put, copy, get, or head request. If this value is 0, then server-side encryption is not in effect for the object (or the request was one for which server-side encryption is not a meaningful value); if this value is non-zero, then server-side encryption is in effect for the object.


The documentation for this struct was generated from the following file: