AzureBlobClient (jclouds 1.6.1-incubating API)

Methods
Modifier and Type	Method and Description
`boolean`	`blobExists(String container, String name)`
`boolean`	`containerExists(String container)` Issues a HEAD command to determine if the container exists or not.
`boolean`	`createContainer(String container, CreateContainerOptions... options)` The Create Container operation creates a new container under the specified identity.
`boolean`	`createRootContainer(CreateContainerOptions... options)` The root container is a default container that may be inferred from a URL requesting a blob resource.
`void`	`deleteBlob(String container, String name)` The Delete Blob operation marks the specified blob for deletion.
`void`	`deleteContainer(String container)` The Delete Container operation marks the specified container for deletion.
`void`	`deleteRootContainer()` The Delete Container operation marks the specified container for deletion.
`AzureBlob`	`getBlob(String container, String name, GetOptions... options)` The Get Blob operation reads or downloads a blob from the system, including its metadata and properties.
`BlobProperties`	`getBlobProperties(String container, String name)` The Get Blob Properties operation returns all user-defined metadata, standard HTTP properties, and system properties for the blob.
`ContainerProperties`	`getContainerProperties(String container)` The Get Container Properties operation returns all user-defined metadata and system properties for the specified container.
`PublicAccess`	`getPublicAccessForContainer(String container)`
`ListBlobsResponse`	`listBlobs(ListBlobsOptions... options)`
`ListBlobsResponse`	`listBlobs(String container, ListBlobsOptions... options)` The List Blobs operation enumerates the list of blobs under the specified container.
`BoundedSet<ContainerProperties>`	`listContainers(ListOptions... listOptions)` The List Containers operation returns a list of the containers under the specified identity.
`AzureBlob`	`newBlob()`
`String`	`putBlob(String container, AzureBlob object)` The Put Blob operation creates a new blob or updates the content of an existing blob.
`void`	`setBlobMetadata(String container, String name, Map<String,String> metadata)`
`void`	`setResourceMetadata(String container, Map<String,String> metadata)` The Set Container Metadata operation sets one or more user-defined name/value pairs for the specified container.

```
public interface AzureBlobClient
```
Provides access to Azure Blob via their REST API.
All commands return a Future of the result from Azure Blob. Any exceptions incurred during processing will be backend in an ExecutionException as documented in Future#get().

Author:

Adrian Cole

See Also:

Method Summary

Methods
Modifier and Type Method and Description

boolean blobExists(String container, String name)

boolean containerExists(String container)
Issues a HEAD command to determine if the container exists or not.

boolean createContainer(String container, CreateContainerOptions... options)
The Create Container operation creates a new container under the specified identity.

boolean createRootContainer(CreateContainerOptions... options)
The root container is a default container that may be inferred from a URL requesting a blob resource.

void deleteBlob(String container, String name)
The Delete Blob operation marks the specified blob for deletion.

void deleteContainer(String container)
The Delete Container operation marks the specified container for deletion.

void deleteRootContainer()
The Delete Container operation marks the specified container for deletion.

AzureBlob getBlob(String container, String name, GetOptions... options)
The Get Blob operation reads or downloads a blob from the system, including its metadata and properties.

BlobProperties getBlobProperties(String container, String name)
The Get Blob Properties operation returns all user-defined metadata, standard HTTP properties, and system properties for the blob.

ContainerProperties getContainerProperties(String container)
The Get Container Properties operation returns all user-defined metadata and system properties for the specified container.

PublicAccess getPublicAccessForContainer(String container)

ListBlobsResponse listBlobs(ListBlobsOptions... options)

ListBlobsResponse listBlobs(String container, ListBlobsOptions... options)
The List Blobs operation enumerates the list of blobs under the specified container.

BoundedSet<ContainerProperties> listContainers(ListOptions... listOptions)
The List Containers operation returns a list of the containers under the specified identity.

AzureBlob newBlob()

String putBlob(String container, AzureBlob object)
The Put Blob operation creates a new blob or updates the content of an existing blob.

void setBlobMetadata(String container, String name, Map<String,String> metadata)

void setResourceMetadata(String container, Map<String,String> metadata)
The Set Container Metadata operation sets one or more user-defined name/value pairs for the specified container.

- Method Detail
  - newBlob
```
@Provides
AzureBlob newBlob()
```
  - listContainers
```
BoundedSet<ContainerProperties> listContainers(ListOptions... listOptions)
```
    The List Containers operation returns a list of the containers under the specified identity.
    The 2009-07-17 version of the List Containers operation times out after 30 seconds.
    
    Parameters:
    listOptions - controls the number or type of results requested
    See Also:
    ListOptions
  - createContainer
```
boolean createContainer(String container,
                      CreateContainerOptions... options)
```
    The Create Container operation creates a new container under the specified identity. If the container with the same name already exists, the operation fails.
    The container resource includes metadata and properties for that container. It does not include a list of the blobs contained by the container.
    
    Returns:
    true, if the bucket was created or false, if the container was already present
    See Also:
    CreateContainerOptions
  - getContainerProperties
```
ContainerProperties getContainerProperties(String container)
```
    The Get Container Properties operation returns all user-defined metadata and system properties for the specified container. The data returned does not include the container's list of blobs.
  - containerExists
```
boolean containerExists(String container)
```
    Issues a HEAD command to determine if the container exists or not.
  - setResourceMetadata
```
void setResourceMetadata(String container,
                       Map<String,String> metadata)
```
    The Set Container Metadata operation sets one or more user-defined name/value pairs for the specified container.
    Remarks
    Calling the Set Container Metadata operation overwrites all existing metadata that is associated with the container. It's not possible to modify an individual name/value pair.
    You may also set metadata for a container at the time it is created.
    Calling Set Container Metadata updates the ETag for the container.
  - deleteContainer
```
void deleteContainer(String container)
```
    The Delete Container operation marks the specified container for deletion. The container and any blobs contained within it are later deleted during garbage collection.
    When a container is deleted, a container with the same name cannot be created for at least 30 seconds; the container may not be available for more than 30 seconds if the service is still processing the request. While the container is being deleted, attempts to create a container of the same name will fail with status code 409 (Conflict), with the service returning additional error information indicating that the container is being deleted. All other operations, including operations on any blobs under the container, will fail with status code 404 (Not Found) while the container is being deleted.
  - createRootContainer
```
boolean createRootContainer(CreateContainerOptions... options)
```
    The root container is a default container that may be inferred from a URL requesting a blob resource. The root container makes it possible to reference a blob from the top level of the storage identity hierarchy, without referencing the container name.
    The container resource includes metadata and properties for that container. It does not include a list of the blobs contained by the container.
    
    See Also:
    CreateContainerOptions
  - getPublicAccessForContainer
```
PublicAccess getPublicAccessForContainer(String container)
```
    Parameters:
    container -
    
    Returns:
    whether data in the container may be accessed publicly and the level of access
  - deleteRootContainer
```
void deleteRootContainer()
```
    The Delete Container operation marks the specified container for deletion. The container and any blobs contained within it are later deleted during garbage collection.
    Remarks
    When a container is deleted, a container with the same name cannot be created for at least 30 seconds; the container may not be available for more than 30 seconds if the service is still processing the request. While the container is being deleted, attempts to create a container of the same name will fail with status code 409 (Conflict), with the service returning additional error information indicating that the container is being deleted. All other operations, including operations on any blobs under the container, will fail with status code 404 (Not Found) while the container is being deleted.
    
    See Also:
    deleteContainer(String), createRootContainer(CreateContainerOptions)
  - listBlobs
```
ListBlobsResponse listBlobs(String container,
                          ListBlobsOptions... options)
```
    The List Blobs operation enumerates the list of blobs under the specified container.
    
    Authorization
    If the container's access control list (ACL) is set to allow anonymous access, any client may call this operation.
    Remarks
    If you specify a value for the maxresults parameter and the number of blobs to return exceeds this value, or exceeds the default value for maxresults, the response body will contain a NextMarker element that indicates the next blob to return on a subsequent request. To return the next set of items, specify the value of NextMarker as the marker parameter on the URI for the subsequent request.
    Note that the value of NextMarker should be treated as opaque.
    The delimiter parameter enables the caller to traverse the blob keyspace by using a user-configured delimiter. The delimiter may be a single character or a string. When the request includes this parameter, the operation returns a BlobPrefix element. The BlobPrefix element is returned in place of all blobs whose keys begin with the same substring up to the appearance of the delimiter character. The value of the BlobPrefix element is substring+delimiter, where substring is the common substring that begins one or more blob keys, and delimiter is the value of the delimiter parameter.
    You can use the value of BlobPrefix to make a subsequent call to list the blobs that begin with this prefix, by specifying the value of BlobPrefix for the prefix parameter on the request URI. In this way, you can traverse a virtual hierarchy of blobs as though it were a file system.
    Note that each BlobPrefix element returned counts toward the maximum result, just as each Blob element does.
    Blobs are listed in alphabetical order in the response body.
  - listBlobs
```
ListBlobsResponse listBlobs(ListBlobsOptions... options)
```
  - putBlob
```
String putBlob(String container,
             AzureBlob object)
```
    The Put Blob operation creates a new blob or updates the content of an existing blob.
    Updating an existing blob overwrites any existing metadata on the blob. Partial updates are not supported; the content of the existing blob is overwritten with the content of the new blob.
    
    Remarks
    The maximum upload size for a blob is 64 MB. If your blob is larger than 64 MB, you may upload it as a set of blocks. For more information, see the Put Block and Put Block List operations.
    If you attempt to upload a blob that is larger than 64 MB, the service returns status code 413 (Request Payload Too Large). The Blob service also returns additional information about the error in the response, including the maximum blob size permitted in bytes.
  - getBlob
```
AzureBlob getBlob(String container,
                String name,
                GetOptions... options)
```
    The Get Blob operation reads or downloads a blob from the system, including its metadata and properties.
  - getBlobProperties
```
BlobProperties getBlobProperties(String container,
                               String name)
```
    The Get Blob Properties operation returns all user-defined metadata, standard HTTP properties, and system properties for the blob. It does not return the content of the blob.
  - setBlobMetadata
```
void setBlobMetadata(String container,
                   String name,
                   Map<String,String> metadata)
```
  - deleteBlob
```
void deleteBlob(String container,
              String name)
```
    The Delete Blob operation marks the specified blob for deletion. The blob is later deleted during garbage collection.
  - blobExists
```
boolean blobExists(String container,
                 String name)
```
    Throws:
    
    ContainerNotFoundException - if the container is not present.

Interface AzureBlobClient

Method Summary

Method Detail

newBlob

listContainers

createContainer

getContainerProperties

containerExists

setResourceMetadata

Remarks

deleteContainer

createRootContainer

getPublicAccessForContainer

deleteRootContainer

Remarks

listBlobs

Authorization

Remarks

listBlobs

putBlob

Remarks

getBlob

getBlobProperties

setBlobMetadata

deleteBlob

blobExists