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<ServiceGetPropertiesResponse>	getProperties() Gets the properties of a storage account’s Blob service.
io.reactivex.Single<ServiceGetStatisticsResponse>	getStatistics() Retrieves statistics related to replication for the Blob service.
io.reactivex.Single<ServiceListContainersSegmentResponse>	listContainersSegment(String marker, ListContainersOptions options) Returns a single segment of containers starting from the specified Marker.
io.reactivex.Single<ServiceSetPropertiesResponse>	setProperties(StorageServiceProperties properties) 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)

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.

Returns:

Emits the successful response.

getProperties

public io.reactivex.Single<ServiceGetPropertiesResponse> getProperties()

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

Returns:

Emits the successful response.

setProperties

public io.reactivex.Single<ServiceSetPropertiesResponse> setProperties(StorageServiceProperties 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.

Parameters:

properties - Configures the service.

Returns:

Emits the successful response.

getStatistics

public io.reactivex.Single<ServiceGetStatisticsResponse> 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.

Returns:

Emits the successful response.