com.microsoft.azure.storage.blob

Class ServiceURL

java.lang.Object

com.microsoft.azure.storage.blob.StorageURL

com.microsoft.azure.storage.blob.ServiceURL

public final class ServiceURL
extends StorageURL

Represents a URL to a blob service. 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. Please see here for more information on containers.

Field Summary

Fields inherited from class com.microsoft.azure.storage.blob.StorageURL

storageClient

Constructor Summary

Constructors

Constructor and Description
ServiceURL(URL url, com.microsoft.rest.v2.http.HttpPipeline pipeline) Creates a ServiceURL object pointing to the account specified by the URL and using the provided pipeline to make HTTP requests.

Method Summary

Modifier and Type	Method and Description
ContainerURL	createContainerURL(String containerName)
io.reactivex.Single<ServiceGetAccountInfoResponse>	getAccountInfo(com.microsoft.rest.v2.Context context) Returns the sku name and account kind for the account.
io.reactivex.Single<ServiceGetPropertiesResponse>	getProperties(com.microsoft.rest.v2.Context context) Gets the properties of a storage account’s Blob service.
io.reactivex.Single<ServiceGetStatisticsResponse>	getStatistics(com.microsoft.rest.v2.Context context) Retrieves statistics related to replication for the Blob service.
io.reactivex.Single<ServiceListContainersSegmentResponse>	listContainersSegment(String marker, ListContainersOptions options, com.microsoft.rest.v2.Context context) Returns a single segment of containers starting from the specified Marker.
io.reactivex.Single<ServiceSetPropertiesResponse>	setProperties(StorageServiceProperties properties, com.microsoft.rest.v2.Context context) Sets properties for a storage account's Blob service endpoint.
ServiceURL	withPipeline(com.microsoft.rest.v2.http.HttpPipeline pipeline) Creates a new ServiceURL with the given pipeline.

Methods inherited from class com.microsoft.azure.storage.blob.StorageURL

appendToURLPath, createPipeline, toString, toURL

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceURL

public ServiceURL(URL url,
                  com.microsoft.rest.v2.http.HttpPipeline pipeline)

Creates a ServiceURL object pointing to the account specified by the URL and using the provided pipeline to make HTTP requests.

Parameters:

url - A url to an Azure Storage account.

pipeline - A pipeline which configures the behavior of HTTP exchanges. Please refer to the createPipeline method on StorageURL for more information.

Method Detail

createContainerURL

public ContainerURL createContainerURL(String containerName)

withPipeline

public ServiceURL withPipeline(com.microsoft.rest.v2.http.HttpPipeline pipeline)

Creates a new ServiceURL with the given pipeline.

Parameters:

pipeline - An HttpPipeline object to set.

Returns:

A ServiceURL object with the given pipeline.

listContainersSegment

public io.reactivex.Single<ServiceListContainersSegmentResponse> listContainersSegment(String marker,
                                                                                       ListContainersOptions options,
                                                                                       com.microsoft.rest.v2.Context context)

Returns a single segment of containers starting from the specified Marker. Use an empty marker to start enumeration from the beginning. Container names are returned in lexicographic order. After getting a segment, process it, and then call ListContainers again (passing the the previously-returned Marker) to get the next segment. For more information, see the Azure Docs.

Parameters:

marker - Identifies the portion of the list to be returned with the next list operation. This value is returned in the response of a previous list operation as the ListContainersSegmentResponse.body().nextMarker(). Set to null to list the first segment.

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

context - Context offers a means of passing arbitrary data (key/value pairs) to an HttpPipeline's policy objects. Most applications do not need to pass arbitrary data to the pipeline and can pass Context.NONE or null. Each context object is immutable. The withContext with data method creates a new Context object that refers to its parent, forming a linked list.

Returns:

Emits the successful response.

API Note:

## Sample Code \n [!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=service_list "Sample code for ServiceURL.listContainersSegment")] \n [!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=service_list_helper "Helper code for ServiceURL.listContainersSegment")] \n For more samples, please see the [Samples file](%https://github.com/Azure/azure-storage-java/blob/New-Storage-SDK-V10-Preview/src/test/java/com/microsoft/azure/storage/Samples.java)

getProperties

public io.reactivex.Single<ServiceGetPropertiesResponse> getProperties(com.microsoft.rest.v2.Context context)

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

Parameters:

context - Context offers a means of passing arbitrary data (key/value pairs) to an HttpPipeline's policy objects. Most applications do not need to pass arbitrary data to the pipeline and can pass Context.NONE or null. Each context object is immutable. The withContext with data method creates a new Context object that refers to its parent, forming a linked list.

Returns:

Emits the successful response.

API Note:

## Sample Code \n [!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=service_getsetprops "Sample code for ServiceURL.getProperties")] \n For more samples, please see the [Samples file](%https://github.com/Azure/azure-storage-java/blob/New-Storage-SDK-V10-Preview/src/test/java/com/microsoft/azure/storage/Samples.java)

setProperties

public io.reactivex.Single<ServiceSetPropertiesResponse> setProperties(StorageServiceProperties properties,
                                                                       com.microsoft.rest.v2.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.

Parameters:

properties - Configures the service.

context - Context offers a means of passing arbitrary data (key/value pairs) to an HttpPipeline's policy objects. Most applications do not need to pass arbitrary data to the pipeline and can pass Context.NONE or null. Each context object is immutable. The withContext with data method creates a new Context object that refers to its parent, forming a linked list.

Returns:

Emits the successful response.

API Note:

## Sample Code \n [!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=service_getsetprops "Sample code for ServiceURL.setProperties")] \n For more samples, please see the [Samples file](%https://github.com/Azure/azure-storage-java/blob/New-Storage-SDK-V10-Preview/src/test/java/com/microsoft/azure/storage/Samples.java)

getStatistics

public io.reactivex.Single<ServiceGetStatisticsResponse> getStatistics(com.microsoft.rest.v2.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.

Parameters:

context - Context offers a means of passing arbitrary data (key/value pairs) to an HttpPipeline's policy objects. Most applications do not need to pass arbitrary data to the pipeline and can pass Context.NONE or null. Each context object is immutable. The withContext with data method creates a new Context object that refers to its parent, forming a linked list.

Returns:

Emits the successful response.

API Note:

## Sample Code \n [!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=service_stats "Sample code for ServiceURL.getStats")] \n For more samples, please see the [Samples file](%https://github.com/Azure/azure-storage-java/blob/New-Storage-SDK-V10-Preview/src/test/java/com/microsoft/azure/storage/Samples.java)

getAccountInfo

public io.reactivex.Single<ServiceGetAccountInfoResponse> getAccountInfo(com.microsoft.rest.v2.Context context)

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

Parameters:

context - Context offers a means of passing arbitrary data (key/value pairs) to an HttpPipeline's policy objects. Most applications do not need to pass arbitrary data to the pipeline and can pass Context.NONE or null. Each context object is immutable. The withContext with data method creates a new Context object that refers to its parent, forming a linked list.

Returns:

Emits the successful response.

API Note:

## Sample Code \n [!code-java[Sample_Code](../azure-storage-java/src/test/java/com/microsoft/azure/storage/Samples.java?name=account_info "Sample code for ServiceURL.getAccountInfo")] \n For more samples, please see the [Samples file] (https://github.com/Azure/azure-storage-java/blob/New-Storage-SDK-V10-Preview/src/test/java/com/microsoft/azure/storage/Samples.java)