com.azure.storage.blob

Class BlobServiceClient

java.lang.Object

com.azure.storage.blob.BlobServiceClient

public final class BlobServiceClient
extends Object

Client to a storage account. It may only be instantiated through a BlobServiceClientBuilder. This class does not hold any state about a particular storage account but is instead a convenient way of sending off appropriate requests to the resource on the service. It may also be used to construct URLs to blobs and containers.

This client contains operations on a blob. Operations on a container are available on BlobContainerClient through BlobServiceClient.getBlobContainerClient(String), and operations on a blob are available on BlobClient.

Please see here for more information on containers.

Method Summary

Modifier and Type	Method and Description
BlobContainerClient	createBlobContainer(String containerName) Creates a new container within a storage account.
Response<BlobContainerClient>	createBlobContainerWithResponse(String containerName, Map<String,String> metadata, PublicAccessType accessType, Context context) Creates a new container within a storage account.
void	deleteBlobContainer(String containerName) Deletes the specified container in the storage account.
Response<Void>	deleteBlobContainerWithResponse(String containerName, Context context) Deletes the specified container in the storage account.
StorageAccountInfo	getAccountInfo() Returns the sku name and account kind for the account.
Response<StorageAccountInfo>	getAccountInfoWithResponse(Duration timeout, Context context) Returns the sku name and account kind for the account.
String	getAccountName() Get associated account name.
String	getAccountUrl() Gets the URL of the storage account represented by this client.
BlobContainerClient	getBlobContainerClient(String containerName) Initializes a BlobContainerClient object pointing to the specified container.
HttpPipeline	getHttpPipeline() Gets the HttpPipeline powering this client.
BlobServiceProperties	getProperties() Gets the properties of a storage account’s Blob service.
Response<BlobServiceProperties>	getPropertiesWithResponse(Duration timeout, Context context) Gets the properties of a storage account’s Blob service.
BlobServiceVersion	getServiceVersion() Gets the service version the client is using.
BlobServiceStatistics	getStatistics() Retrieves statistics related to replication for the Blob service.
Response<BlobServiceStatistics>	getStatisticsWithResponse(Duration timeout, Context context) Retrieves statistics related to replication for the Blob service.
UserDelegationKey	getUserDelegationKey(OffsetDateTime start, OffsetDateTime expiry) Gets a user delegation key for use with this account's blob storage.
Response<UserDelegationKey>	getUserDelegationKeyWithResponse(OffsetDateTime start, OffsetDateTime expiry, Duration timeout, Context context) Gets a user delegation key for use with this account's blob storage.
PagedIterable<BlobContainerItem>	listBlobContainers() Returns a lazy loaded list of containers in this account.
PagedIterable<BlobContainerItem>	listBlobContainers(ListBlobContainersOptions options, Duration timeout) Returns a lazy loaded list of containers in this account.
void	setProperties(BlobServiceProperties properties) Sets properties for a storage account's Blob service endpoint.
Response<Void>	setPropertiesWithResponse(BlobServiceProperties properties, Duration timeout, Context context) Sets properties for a storage account's Blob service endpoint.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getBlobContainerClient

public BlobContainerClient getBlobContainerClient(String containerName)

Initializes a BlobContainerClient object pointing to the specified container. This method does not create a container. It simply constructs the URL to the container and offers access to methods relevant to containers.

Code Samples

BlobContainerClient blobContainerClient = client.getBlobContainerClient("containerName");

Parameters:

containerName - The name of the container to point to.

Returns:

A BlobContainerClient object pointing to the specified container

getHttpPipeline

public HttpPipeline getHttpPipeline()

Gets the HttpPipeline powering this client.

Returns:

The pipeline.

getServiceVersion

public BlobServiceVersion getServiceVersion()

Gets the service version the client is using.

Returns:

the service version the client is using.

createBlobContainer

public BlobContainerClient createBlobContainer(String containerName)

Creates a new container within a storage account. If a container with the same name already exists, the operation fails. For more information, see the Azure Docs.

Code Samples

BlobContainerClient blobContainerClient = client.createBlobContainer("containerName");

Parameters:

containerName - Name of the container to create

Returns:

The BlobContainerClient used to interact with the container created.

createBlobContainerWithResponse

public Response<BlobContainerClient> createBlobContainerWithResponse(String containerName,
                                                                     Map<String,String> metadata,
                                                                     PublicAccessType accessType,
                                                                     Context context)

Creates a new container within a storage account. If a container with the same name already exists, the operation fails. For more information, see the Azure Docs.

Code Samples

Map<String, String> metadata = Collections.singletonMap("metadata", "value");
Context context = new Context("Key", "Value");

BlobContainerClient blobContainerClient = client.createBlobContainerWithResponse(
    "containerName",
    metadata,
    PublicAccessType.CONTAINER,
    context).getValue();

Parameters:

containerName - Name of the container to create

metadata - Metadata to associate with the container.

accessType - Specifies how the data in this container is available to the public. See the x-ms-blob-public-access header in the Azure Docs for more information. Pass null for no public access.

context - Additional context that is passed through the Http pipeline during the service call.

Returns:

A Response whose value contains the BlobContainerClient used to interact with the container created.

deleteBlobContainer

public void deleteBlobContainer(String containerName)

Deletes the specified container in the storage account. If the container doesn't exist the operation fails. For more information see the Azure Docs.

Code Samples

try {
    client.deleteBlobContainer("container Name");
    System.out.printf("Delete container completed with status %n");
} catch (UnsupportedOperationException error) {
    System.out.printf("Delete container failed: %s%n", error);
}

Parameters:

containerName - Name of the container to delete

deleteBlobContainerWithResponse

public Response<Void> deleteBlobContainerWithResponse(String containerName,
                                                      Context context)

Deletes the specified container in the storage account. If the container doesn't exist the operation fails. For more information see the Azure Docs.

Parameters:

containerName - Name of the container to delete

context - Additional context that is passed through the Http pipeline during the service call.

Returns:

A response containing status code and HTTP headers

getAccountUrl

public String getAccountUrl()

Gets the URL of the storage account represented by this client.

Returns:

the URL.

listBlobContainers

public PagedIterable<BlobContainerItem> listBlobContainers()

Returns a lazy loaded list of containers in this account. The returned PagedIterable can be consumed while new items are automatically retrieved as needed. For more information, see the Azure Docs.

Code Samples

client.listBlobContainers().forEach(container -> System.out.printf("Name: %s%n", container.getName()));

Returns:

The list of containers.

listBlobContainers

public PagedIterable<BlobContainerItem> listBlobContainers(ListBlobContainersOptions options,
                                                           Duration timeout)

Returns a lazy loaded list of containers in this account. The returned PagedIterable can be consumed while new items are automatically retrieved as needed. For more information, see the Azure Docs.

Code Samples

ListBlobContainersOptions options = new ListBlobContainersOptions()
    .setPrefix("containerNamePrefixToMatch")
    .setDetails(new BlobContainerListDetails().setRetrieveMetadata(true));

client.listBlobContainers(options, timeout).forEach(container -> System.out.printf("Name: %s%n", container.getName()));

Parameters:

options - A ListBlobContainersOptions which specifies what data should be returned by the service.

timeout - An optional timeout value beyond which a RuntimeException will be raised.

Returns:

The list of containers.

getProperties

public BlobServiceProperties getProperties()

Gets the properties of a storage account’s Blob service. For more information, see the Azure Docs.

Code Samples

BlobServiceProperties properties = client.getProperties();

System.out.printf("Hour metrics enabled: %b, Minute metrics enabled: %b%n",
    properties.getHourMetrics().isEnabled(),
    properties.getMinuteMetrics().isEnabled());

Returns:

The storage account properties.

getPropertiesWithResponse

public Response<BlobServiceProperties> getPropertiesWithResponse(Duration timeout,
                                                                 Context context)

Gets the properties of a storage account’s Blob service. For more information, see the Azure Docs.

Code Samples

Context context = new Context("Key", "Value");
BlobServiceProperties properties = client.getPropertiesWithResponse(timeout, context).getValue();

System.out.printf("Hour metrics enabled: %b, Minute metrics enabled: %b%n",
    properties.getHourMetrics().isEnabled(),
    properties.getMinuteMetrics().isEnabled());

Parameters:

timeout - An optional timeout value beyond which a RuntimeException will be raised.

context - Additional context that is passed through the Http pipeline during the service call.

Returns:

A Response whose value contains the storage account properties.

setProperties

public void setProperties(BlobServiceProperties properties)

Sets properties for a storage account's Blob service endpoint. For more information, see the Azure Docs. Note that setting the default service version has no effect when using this client because this client explicitly sets the version header on each request, overriding the default.

Code Samples

BlobRetentionPolicy loggingRetentionPolicy = new BlobRetentionPolicy().setEnabled(true).setDays(3);
BlobRetentionPolicy metricsRetentionPolicy = new BlobRetentionPolicy().setEnabled(true).setDays(1);

BlobServiceProperties properties = new BlobServiceProperties()
    .setLogging(new BlobAnalyticsLogging()
        .setWrite(true)
        .setDelete(true)
        .setRetentionPolicy(loggingRetentionPolicy))
    .setHourMetrics(new BlobMetrics()
        .setEnabled(true)
        .setRetentionPolicy(metricsRetentionPolicy))
    .setMinuteMetrics(new BlobMetrics()
        .setEnabled(true)
        .setRetentionPolicy(metricsRetentionPolicy));

try {
    client.setProperties(properties);
    System.out.printf("Setting properties completed%n");
} catch (UnsupportedOperationException error) {
    System.out.printf("Setting properties failed: %s%n", error);
}

Parameters:

properties - Configures the service.

setPropertiesWithResponse

public Response<Void> setPropertiesWithResponse(BlobServiceProperties properties,
                                                Duration timeout,
                                                Context context)

Sets properties for a storage account's Blob service endpoint. For more information, see the Azure Docs. Note that setting the default service version has no effect when using this client because this client explicitly sets the version header on each request, overriding the default.

Code Samples

BlobRetentionPolicy loggingRetentionPolicy = new BlobRetentionPolicy().setEnabled(true).setDays(3);
BlobRetentionPolicy metricsRetentionPolicy = new BlobRetentionPolicy().setEnabled(true).setDays(1);

BlobServiceProperties properties = new BlobServiceProperties()
    .setLogging(new BlobAnalyticsLogging()
        .setWrite(true)
        .setDelete(true)
        .setRetentionPolicy(loggingRetentionPolicy))
    .setHourMetrics(new BlobMetrics()
        .setEnabled(true)
        .setRetentionPolicy(metricsRetentionPolicy))
    .setMinuteMetrics(new BlobMetrics()
        .setEnabled(true)
        .setRetentionPolicy(metricsRetentionPolicy));

Context context = new Context("Key", "Value");

System.out.printf("Setting properties completed with status %d%n",
    client.setPropertiesWithResponse(properties, timeout, context).getStatusCode());

Parameters:

properties - Configures the service.

timeout - An optional timeout value beyond which a RuntimeException will be raised.

context - Additional context that is passed through the Http pipeline during the service call.

Returns:

The storage account properties.

getUserDelegationKey

public UserDelegationKey getUserDelegationKey(OffsetDateTime start,
                                              OffsetDateTime expiry)

Gets a user delegation key for use with this account's blob storage. Note: This method call is only valid when using TokenCredential in this object's HttpPipeline.

Code Samples

System.out.printf("User delegation key: %s%n",
    client.getUserDelegationKey(delegationKeyStartTime, delegationKeyExpiryTime));

Parameters:

start - Start time for the key's validity. Null indicates immediate start.

expiry - Expiration of the key's validity.

Returns:

The user delegation key.

getUserDelegationKeyWithResponse

public Response<UserDelegationKey> getUserDelegationKeyWithResponse(OffsetDateTime start,
                                                                    OffsetDateTime expiry,
                                                                    Duration timeout,
                                                                    Context context)

Gets a user delegation key for use with this account's blob storage. Note: This method call is only valid when using TokenCredential in this object's HttpPipeline.

Code Samples

System.out.printf("User delegation key: %s%n",
    client.getUserDelegationKeyWithResponse(delegationKeyStartTime, delegationKeyExpiryTime, timeout, context));

Parameters:

start - Start time for the key's validity. Null indicates immediate start.

expiry - Expiration of the key's validity.

timeout - An optional timeout value beyond which a RuntimeException will be raised.

context - Additional context that is passed through the Http pipeline during the service call.

Returns:

A Response whose value contains the user delegation key.

getStatistics

public BlobServiceStatistics getStatistics()

Retrieves statistics related to replication for the Blob service. It is only available on the secondary location endpoint when read-access geo-redundant replication is enabled for the storage account. For more information, see the Azure Docs.

Code Samples

System.out.printf("Geo-replication status: %s%n",
    client.getStatistics().getGeoReplication().getStatus());

Returns:

The storage account statistics.

getStatisticsWithResponse

public Response<BlobServiceStatistics> getStatisticsWithResponse(Duration timeout,
                                                                 Context context)

Retrieves statistics related to replication for the Blob service. It is only available on the secondary location endpoint when read-access geo-redundant replication is enabled for the storage account. For more information, see the Azure Docs.

Code Samples

System.out.printf("Geo-replication status: %s%n",
    client.getStatisticsWithResponse(timeout, context).getValue().getGeoReplication().getStatus());

Parameters:

timeout - An optional timeout value beyond which a RuntimeException will be raised.

context - Additional context that is passed through the Http pipeline during the service call.

Returns:

A Response whose value the storage account statistics.

getAccountInfo

public StorageAccountInfo getAccountInfo()

Returns the sku name and account kind for the account. For more information, please see the Azure Docs.

Code Samples

StorageAccountInfo accountInfo = client.getAccountInfo();

System.out.printf("Account kind: %s, SKU: %s%n", accountInfo.getAccountKind(), accountInfo.getSkuName());

Returns:

The storage account info.

getAccountInfoWithResponse

public Response<StorageAccountInfo> getAccountInfoWithResponse(Duration timeout,
                                                               Context context)

Returns the sku name and account kind for the account. For more information, please see the Azure Docs.

Parameters:

timeout - An optional timeout value beyond which a RuntimeException will be raised.

context - Additional context that is passed through the Http pipeline during the service call.

Returns:

A Response whose value contains the storage account info.

getAccountName

public String getAccountName()

Get associated account name.

Returns:

account name associated with this storage resource.