org.jclouds.blobstore

Interface BlobRequestSigner

All Known Implementing Classes:

AtmosBlobRequestSigner, AzureBlobRequestSigner, HPCloudObjectStorageBlobRequestSigner, LocalBlobRequestSigner, RequestSigningUnsupported, S3BlobRequestSigner, SwiftBlobSigner

public interface BlobRequestSigner

Generates signed requests for blobs. useful in other tools such as backup utilities.

Author:

Adrian Cole

Method Summary

Methods

Modifier and Type	Method and Description
HttpRequest	signGetBlob(String container, String name) gets a signed request, including headers as necessary, to access a blob from an external client.
HttpRequest	signGetBlob(String container, String name, GetOptions options)
HttpRequest	signGetBlob(String container, String name, long timeInSeconds) gets a signed request, including headers as necessary, to allow access to a blob from an external client for a limited period of time
HttpRequest	signPutBlob(String container, Blob blob) gets a signed request, including headers as necessary, to upload a blob from an external client.
HttpRequest	signPutBlob(String container, Blob blob, long timeInSeconds) gets a signed request, including headers as necessary, to upload a blob from an external client for a limited period of time
HttpRequest	signRemoveBlob(String container, String name) gets a signed request, including headers as necessary, to delete a blob from an external client.

Method Detail

signGetBlob

HttpRequest signGetBlob(String container,
                      String name)

gets a signed request, including headers as necessary, to access a blob from an external client.

Parameters:

container - container where the blob resides

directory - full path to the blob

Throws:

UnsupportedOperationException - if not supported by the provider

signGetBlob

@Beta
HttpRequest signGetBlob(String container,
                           String name,
                           long timeInSeconds)

gets a signed request, including headers as necessary, to allow access to a blob from an external client for a limited period of time

Parameters:

timeInSeconds - validity time in seconds for the generated request

See Also:

signGetBlob(String, String)

signGetBlob

HttpRequest signGetBlob(String container,
                      String name,
                      GetOptions options)

Parameters:

options -

See Also:

signGetBlob(String, String)

signRemoveBlob

HttpRequest signRemoveBlob(String container,
                         String name)

gets a signed request, including headers as necessary, to delete a blob from an external client.

Parameters:

container - container where the blob resides

directory - full path to the blob

Throws:

UnsupportedOperationException - if not supported by the provider

signPutBlob

HttpRequest signPutBlob(String container,
                      Blob blob)

gets a signed request, including headers as necessary, to upload a blob from an external client.

 Blob blob = context.getBlobStore.blobBuilder().name("name").forSigning().contentType("text/plain")
          .contentLength(length).build();
 

Parameters:

container - container where the blob resides

blob - what to upload

Throws:

UnsupportedOperationException - if not supported by the provider

See Also:

BlobBuilder#forSigning

signPutBlob

@Beta
HttpRequest signPutBlob(String container,
                           Blob blob,
                           long timeInSeconds)

gets a signed request, including headers as necessary, to upload a blob from an external client for a limited period of time

Parameters:

timeInSeconds - validity time in seconds for the generated request

See Also:

BlobBuilder#forSigning, signPutBlob(java.lang.String, org.jclouds.blobstore.domain.Blob)