public class GetObjectMetadataRequest extends SCSWebServiceRequest
Provides options for obtaining the metadata for the specified Amazon S3 object without actually fetching the object contents. This is useful if obtaining only object metadata, and avoids wasting bandwidth from retrieving the object data.
The object metadata contains information such as content type, content disposition, etc., as well as custom user metadata that can be associated with an object in Amazon S3.
For more information about enabling versioning for a bucket, see
SCS#setBucketVersioningConfiguration(SetBucketVersioningConfigurationRequest)
.
构造器和说明 |
---|
GetObjectMetadataRequest(String bucketName,
String key)
Constructs a new
GetObjectMetadataRequest
used to retrieve a specified
object's metadata. |
GetObjectMetadataRequest(String bucketName,
String key,
String versionId)
Constructs a new
GetObjectMetadataRequest
with basic options. |
限定符和类型 | 方法和说明 |
---|---|
String |
getBucketName()
Gets the name of the bucket containing the object whose metadata is
being retrieved.
|
String |
getKey()
Gets the key of the object whose metadata is being retrieved.
|
String |
getVersionId()
Gets the optional version ID of the object version whose metadata is
being retrieved.
|
void |
setBucketName(String bucketName)
Sets the name of the bucket containing the object whose metadata is
being retrieved.
|
void |
setKey(String key)
Sets the key of the object whose metadata is being retrieved.
|
void |
setVersionId(String versionId)
Sets the optional version ID of the object version whose metadata is
being retrieved.
|
GetObjectMetadataRequest |
withBucketName(String bucketName)
Sets the name of the bucket containing the object whose metadata is
being retrieved.
|
GetObjectMetadataRequest |
withKey(String key)
Sets the key of the object whose metadata is being retrieved.
|
GetObjectMetadataRequest |
withVersionId(String versionId)
Sets the optional version ID of the object version whose metadata is
being retrieved.
|
public GetObjectMetadataRequest(String bucketName, String key)
GetObjectMetadataRequest
used to retrieve a specified
object's metadata.bucketName
- The name of the bucket containing the object whose metadata
is being retrieved.key
- The key of the object whose metadata is being retrieved.GetObjectMetadataRequest(String bucketName, String key, String versionId)
public GetObjectMetadataRequest(String bucketName, String key, String versionId)
GetObjectMetadataRequest
with basic options.bucketName
- The name of the bucket containing the object whose metadata
is being retrieved.key
- The key of the object whose metadata is being retrieved.versionId
- The version ID of the object version whose metadata is being
retrieved.GetObjectMetadataRequest(String bucketName, String key)
public String getBucketName()
setBucketName(String bucketName)
,
withBucketName(String)
public void setBucketName(String bucketName)
bucketName
- The name of the bucket containing the object's whose metadata
is being retrieved.getBucketName()
,
withBucketName(String)
public GetObjectMetadataRequest withBucketName(String bucketName)
GetObjectMetadataRequest
, enabling additional method
calls to be chained together.bucketName
- The name of the bucket containing the object's whose metadata
is being retrieved.GetObjectMetadataRequest
, enabling additional method
calls to be chained together.getBucketName()
,
setBucketName(String bucketName)
public String getKey()
setKey(String)
,
withKey(String)
public void setKey(String key)
key
- The key of the object whose metadata is being retrieved.getKey()
,
withKey(String)
public GetObjectMetadataRequest withKey(String key)
GetObjectMetadataRequest
, enabling additional method
calls to be chained together.key
- The key of the object whose metadata is being retrieved.GetObjectMetadataRequest
, enabling additional method
calls to be chained together.getKey()
,
setKey(String)
public String getVersionId()
setVersionId(String)
,
withVersionId(String)
public void setVersionId(String versionId)
versionId
- The optional version ID of the object version whose metadata
is being retrieved. If not specified, the latest version will
be used.getVersionId()
,
withVersionId(String)
public GetObjectMetadataRequest withVersionId(String versionId)
GetObjectMetadataRequest
, enabling additional method
calls to be chained together.
If not specified, the latest version will be used.versionId
- The optional version ID of the object version whose metadata
is being retrieved.GetObjectMetadataRequest
, enabling additional method
calls to be chained together.getVersionId()
,
setVersionId(String)
Copyright © 2016. All rights reserved.