org.jclouds.blobstore

Interface BlobRequestSigner

All Known Implementing Classes:

AtmosBlobRequestSigner, AWSS3BlobRequestSignerV4, AzureBlobRequestSigner, GoogleCloudStorageBlobRequestSigner, LocalBlobRequestSigner, RegionScopedTemporaryUrlBlobSigner, RequestSigningUnsupported, S3BlobRequestSigner

public interface BlobRequestSigner

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

Method Summary

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

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)

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)