/// <summary>
/// Constructs a web request to delete a blob.
/// </summary>
/// <param name="uri">The absolute URI to the blob.</param>
/// <param name="timeout">The server timeout interval.</param>
/// <param name="snapshot">The snapshot timestamp, if the blob is a snapshot.</param>
/// <param name="deleteSnapshotsOption">A set of options indicating whether to delete only blobs, only snapshots, or both.</param>
/// <param name="leaseId">The lease ID, if the blob has an active lease.</param>
/// <returns>A web request to use to perform the operation.</returns>
public static HttpWebRequest Delete(Uri uri, int timeout, DateTime?snapshot, DeleteSnapshotsOption deleteSnapshotsOption, string leaseId)
{
UriQueryBuilder builder = new UriQueryBuilder();
if (snapshot != null && deleteSnapshotsOption != DeleteSnapshotsOption.None)
{
throw new InvalidOperationException(String.Format(SR.DeleteSnapshotsNotValidError, "deleteSnapshotsOption", "snapshot"));
}
BlobRequest.AddSnapshot(builder, snapshot);
var request = Request.Delete(uri, timeout, builder);
Request.AddLeaseId(request, leaseId);
switch (deleteSnapshotsOption)
{
case DeleteSnapshotsOption.None:
break; // nop
case DeleteSnapshotsOption.IncludeSnapshots:
request.Headers.Add(
Constants.HeaderConstants.DeleteSnapshotHeader,
Constants.HeaderConstants.IncludeSnapshotsValue);
break;
case DeleteSnapshotsOption.DeleteSnapshotsOnly:
request.Headers.Add(
Constants.HeaderConstants.DeleteSnapshotHeader,
Constants.HeaderConstants.SnapshotsOnlyValue);
break;
}
return(request);
}
/// <summary>
/// Constructs a web request to return the blob's system properties.
/// </summary>
/// <param name="uri">The absolute URI to the blob.</param>
/// <param name="timeout">The server timeout interval.</param>
/// <param name="snapshot">The snapshot timestamp, if the blob is a snapshot.</param>
/// <param name="leaseId">The lease ID.</param>
/// <returns>A web request for performing the operation.</returns>
public static HttpWebRequest GetProperties(Uri uri, int timeout, DateTime?snapshot, string leaseId)
{
UriQueryBuilder builder = new UriQueryBuilder();
BlobRequest.AddSnapshot(builder, snapshot);
var request = Request.GetProperties(uri, timeout, builder);
Request.AddLeaseId(request, leaseId);
return(request);
}
/// <summary>
/// Constructs a web request to return the list of active page ranges for a page blob.
/// </summary>
/// <param name="uri">The absolute URI to the blob.</param>
/// <param name="timeout">The server timeout interval.</param>
/// <param name="snapshot">The snapshot timestamp, if the blob is a snapshot.</param>
/// <param name="leaseId">The lease ID, if the blob has an active lease.</param>
/// <returns>A web request to use to perform the operation.</returns>
public static HttpWebRequest GetPageRanges(Uri uri, int timeout, DateTime?snapshot, string leaseId)
{
UriQueryBuilder builder = new UriQueryBuilder();
builder.Add(Constants.QueryConstants.Component, "pagelist");
BlobRequest.AddSnapshot(builder, snapshot);
HttpWebRequest request = CreateWebRequest(uri, timeout, builder);
request.Method = "GET";
Request.AddLeaseId(request, leaseId);
return(request);
}
/// <summary>
/// Constructs a web request to get the blob's content, properties, and metadata.
/// </summary>
/// <param name="uri">The absolute URI to the blob.</param>
/// <param name="timeout">The server timeout interval.</param>
/// <param name="snapshot">The snapshot version, if the blob is a snapshot.</param>
/// <param name="leaseId">The lease ID for the blob, if it has an active lease.</param>
/// <returns>A web request for performing the operation.</returns>
public static HttpWebRequest Get(Uri uri, int timeout, DateTime?snapshot, string leaseId)
{
UriQueryBuilder builder = new UriQueryBuilder();
BlobRequest.AddSnapshot(builder, snapshot);
HttpWebRequest request = CreateWebRequest(uri, timeout, builder);
request.Method = "GET";
if (leaseId != null)
{
Request.AddLeaseId(request, leaseId);
}
return(request);
}
/// <summary>
/// Constructs a web request to return the list of blocks for a block blob.
/// </summary>
/// <param name="uri">The absolute URI to the blob.</param>
/// <param name="timeout">The server timeout interval.</param>
/// <param name="snapshot">The snapshot timestamp, if the blob is a snapshot.</param>
/// <param name="typesOfBlocks">The types of blocks to include in the list: committed, uncommitted, or both.</param>
/// <param name="leaseId">The lease ID for the blob, if it has an active lease.</param>
/// <returns>A web request to use to perform the operation.</returns>
public static HttpWebRequest GetBlockList(Uri uri, int timeout, DateTime?snapshot, BlockListingFilter typesOfBlocks, string leaseId)
{
UriQueryBuilder builder = new UriQueryBuilder();
builder.Add(Constants.QueryConstants.Component, "blocklist");
builder.Add("blocklisttype", typesOfBlocks.ToString());
BlobRequest.AddSnapshot(builder, snapshot);
HttpWebRequest request = CreateWebRequest(uri, timeout, builder);
request.Method = "GET";
Request.AddLeaseId(request, leaseId);
return(request);
}
