[ReleasePR Microsoft.Azure.Management.Storage] Add RestoreBlobRanges API in Microsoft.Storage specification

sdk/storage/Microsoft.Azure.Management.Storage/src/Generated/IStorageAccountsOperations.cs

@@ -124,8 +124,9 @@ public partial interface IStorageAccountsOperations
         /// <param name='expand'>
         /// May be used to expand the properties within account's properties.
         /// By default, data is not included when fetching properties.
-        /// Currently we only support geoReplicationStats. Possible values
-        /// include: 'geoReplicationStats'
+        /// Currently we only support geoReplicationStats and
+        /// blobRestoreStatus. Possible values include: 'geoReplicationStats',
+        /// 'blobRestoreStatus'
         /// </param>
         /// <param name='customHeaders'>
         /// The headers that will be added to request.
@@ -388,6 +389,40 @@ public partial interface IStorageAccountsOperations
         /// </exception>
         Task<AzureOperationResponse> FailoverWithHttpMessagesAsync(string resourceGroupName, string accountName, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
         /// <summary>
+        /// Restore blobs in the specified blob ranges
+        /// </summary>
+        /// <param name='resourceGroupName'>
+        /// The name of the resource group within the user's subscription. The
+        /// name is case insensitive.
+        /// </param>
+        /// <param name='accountName'>
+        /// The name of the storage account within the specified resource
+        /// group. Storage account names must be between 3 and 24 characters in
+        /// length and use numbers and lower-case letters only.
+        /// </param>
+        /// <param name='timeToRestore'>
+        /// Restore blob to the specified time.
+        /// </param>
+        /// <param name='blobRanges'>
+        /// Blob ranges to restore.
+        /// </param>
+        /// <param name='customHeaders'>
+        /// The headers that will be added to request.
+        /// </param>
+        /// <param name='cancellationToken'>
+        /// The cancellation token.
+        /// </param>
+        /// <exception cref="Microsoft.Rest.Azure.CloudException">
+        /// Thrown when the operation returned an invalid status code
+        /// </exception>
+        /// <exception cref="Microsoft.Rest.SerializationException">
+        /// Thrown when unable to deserialize the response
+        /// </exception>
+        /// <exception cref="Microsoft.Rest.ValidationException">
+        /// Thrown when a required parameter is null
+        /// </exception>
+        Task<AzureOperationResponse<BlobRestoreStatus>> RestoreBlobRangesWithHttpMessagesAsync(string resourceGroupName, string accountName, System.DateTime timeToRestore, IList<BlobRestoreRange> blobRanges, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
+        /// <summary>
         /// Revoke user delegation keys.
         /// </summary>
         /// <param name='resourceGroupName'>
@@ -477,6 +512,40 @@ public partial interface IStorageAccountsOperations
         /// </exception>
         Task<AzureOperationResponse> BeginFailoverWithHttpMessagesAsync(string resourceGroupName, string accountName, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
         /// <summary>
+        /// Restore blobs in the specified blob ranges
+        /// </summary>
+        /// <param name='resourceGroupName'>
+        /// The name of the resource group within the user's subscription. The
+        /// name is case insensitive.
+        /// </param>
+        /// <param name='accountName'>
+        /// The name of the storage account within the specified resource
+        /// group. Storage account names must be between 3 and 24 characters in
+        /// length and use numbers and lower-case letters only.
+        /// </param>
+        /// <param name='timeToRestore'>
+        /// Restore blob to the specified time.
+        /// </param>
+        /// <param name='blobRanges'>
+        /// Blob ranges to restore.
+        /// </param>
+        /// <param name='customHeaders'>
+        /// The headers that will be added to request.
+        /// </param>
+        /// <param name='cancellationToken'>
+        /// The cancellation token.
+        /// </param>
+        /// <exception cref="Microsoft.Rest.Azure.CloudException">
+        /// Thrown when the operation returned an invalid status code
+        /// </exception>
+        /// <exception cref="Microsoft.Rest.SerializationException">
+        /// Thrown when unable to deserialize the response
+        /// </exception>
+        /// <exception cref="Microsoft.Rest.ValidationException">
+        /// Thrown when a required parameter is null
+        /// </exception>
+        Task<AzureOperationResponse<BlobRestoreStatus>> BeginRestoreBlobRangesWithHttpMessagesAsync(string resourceGroupName, string accountName, System.DateTime timeToRestore, IList<BlobRestoreRange> blobRanges, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
+        /// <summary>
         /// Lists all the storage accounts available under the subscription.
         /// Note that storage keys are not returned; use the ListKeys operation
         /// for this.

sdk/storage/Microsoft.Azure.Management.Storage/src/Generated/Models/BlobRestoreParameters.cs

@@ -0,0 +1,86 @@
+// <auto-generated>
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License. See License.txt in the project root for
+// license information.
+//
+// Code generated by Microsoft (R) AutoRest Code Generator.
+// Changes may cause incorrect behavior and will be lost if the code is
+// regenerated.
+// </auto-generated>
+
+namespace Microsoft.Azure.Management.Storage.Models
+{
+    using Microsoft.Rest;
+    using Newtonsoft.Json;
+    using System.Collections;
+    using System.Collections.Generic;
+    using System.Linq;
+
+    /// <summary>
+    /// Blob restore parameters
+    /// </summary>
+    public partial class BlobRestoreParameters
+    {
+        /// <summary>
+        /// Initializes a new instance of the BlobRestoreParameters class.
+        /// </summary>
+        public BlobRestoreParameters()
+        {
+            CustomInit();
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the BlobRestoreParameters class.
+        /// </summary>
+        /// <param name="timeToRestore">Restore blob to the specified
+        /// time.</param>
+        /// <param name="blobRanges">Blob ranges to restore.</param>
+        public BlobRestoreParameters(System.DateTime timeToRestore, IList<BlobRestoreRange> blobRanges)
+        {
+            TimeToRestore = timeToRestore;
+            BlobRanges = blobRanges;
+            CustomInit();
+        }
+
+        /// <summary>
+        /// An initialization method that performs custom operations like setting defaults
+        /// </summary>
+        partial void CustomInit();
+
+        /// <summary>
+        /// Gets or sets restore blob to the specified time.
+        /// </summary>
+        [JsonProperty(PropertyName = "timeToRestore")]
+        public System.DateTime TimeToRestore { get; set; }
+
+        /// <summary>
+        /// Gets or sets blob ranges to restore.
+        /// </summary>
+        [JsonProperty(PropertyName = "blobRanges")]
+        public IList<BlobRestoreRange> BlobRanges { get; set; }
+
+        /// <summary>
+        /// Validate the object.
+        /// </summary>
+        /// <exception cref="ValidationException">
+        /// Thrown if validation fails
+        /// </exception>
+        public virtual void Validate()
+        {
+            if (BlobRanges == null)
+            {
+                throw new ValidationException(ValidationRules.CannotBeNull, "BlobRanges");
+            }
+            if (BlobRanges != null)
+            {
+                foreach (var element in BlobRanges)
+                {
+                    if (element != null)
+                    {
+                        element.Validate();
+                    }
+                }
+            }
+        }
+    }
+}

sdk/storage/Microsoft.Azure.Management.Storage/src/Generated/Models/BlobRestoreProgressStatus.cs

@@ -0,0 +1,23 @@
+// <auto-generated>
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License. See License.txt in the project root for
+// license information.
+//
+// Code generated by Microsoft (R) AutoRest Code Generator.
+// Changes may cause incorrect behavior and will be lost if the code is
+// regenerated.
+// </auto-generated>
+
+namespace Microsoft.Azure.Management.Storage.Models
+{
+
+    /// <summary>
+    /// Defines values for BlobRestoreProgressStatus.
+    /// </summary>
+    public static class BlobRestoreProgressStatus
+    {
+        public const string InProgress = "InProgress";
+        public const string Complete = "Complete";
+        public const string Failed = "Failed";
+    }
+}

sdk/storage/Microsoft.Azure.Management.Storage/src/Generated/Models/BlobRestoreRange.cs

@@ -0,0 +1,79 @@
+// <auto-generated>
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License. See License.txt in the project root for
+// license information.
+//
+// Code generated by Microsoft (R) AutoRest Code Generator.
+// Changes may cause incorrect behavior and will be lost if the code is
+// regenerated.
+// </auto-generated>
+
+namespace Microsoft.Azure.Management.Storage.Models
+{
+    using Microsoft.Rest;
+    using Newtonsoft.Json;
+    using System.Linq;
+
+    /// <summary>
+    /// Blob range
+    /// </summary>
+    public partial class BlobRestoreRange
+    {
+        /// <summary>
+        /// Initializes a new instance of the BlobRestoreRange class.
+        /// </summary>
+        public BlobRestoreRange()
+        {
+            CustomInit();
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the BlobRestoreRange class.
+        /// </summary>
+        /// <param name="startRange">Blob start range. Empty means account
+        /// start.</param>
+        /// <param name="endRange">Blob end range. Empty means account
+        /// end.</param>
+        public BlobRestoreRange(string startRange, string endRange)
+        {
+            StartRange = startRange;
+            EndRange = endRange;
+            CustomInit();
+        }
+
+        /// <summary>
+        /// An initialization method that performs custom operations like setting defaults
+        /// </summary>
+        partial void CustomInit();
+
+        /// <summary>
+        /// Gets or sets blob start range. Empty means account start.
+        /// </summary>
+        [JsonProperty(PropertyName = "startRange")]
+        public string StartRange { get; set; }
+
+        /// <summary>
+        /// Gets or sets blob end range. Empty means account end.
+        /// </summary>
+        [JsonProperty(PropertyName = "endRange")]
+        public string EndRange { get; set; }
+
+        /// <summary>
+        /// Validate the object.
+        /// </summary>
+        /// <exception cref="ValidationException">
+        /// Thrown if validation fails
+        /// </exception>
+        public virtual void Validate()
+        {
+            if (StartRange == null)
+            {
+                throw new ValidationException(ValidationRules.CannotBeNull, "StartRange");
+            }
+            if (EndRange == null)
+            {
+                throw new ValidationException(ValidationRules.CannotBeNull, "EndRange");
+            }
+        }
+    }
+}

sdk/storage/Microsoft.Azure.Management.Storage/src/Generated/Models/BlobRestoreStatus.cs

@@ -0,0 +1,98 @@
+// <auto-generated>
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License. See License.txt in the project root for
+// license information.
+//
+// Code generated by Microsoft (R) AutoRest Code Generator.
+// Changes may cause incorrect behavior and will be lost if the code is
+// regenerated.
+// </auto-generated>
+
+namespace Microsoft.Azure.Management.Storage.Models
+{
+    using Newtonsoft.Json;
+    using System.Linq;
+
+    /// <summary>
+    /// Blob restore status.
+    /// </summary>
+    public partial class BlobRestoreStatus
+    {
+        /// <summary>
+        /// Initializes a new instance of the BlobRestoreStatus class.
+        /// </summary>
+        public BlobRestoreStatus()
+        {
+            CustomInit();
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the BlobRestoreStatus class.
+        /// </summary>
+        /// <param name="status">The status of blob restore progress. Possible
+        /// values are: - InProgress: Indicates that blob restore is ongoing. -
+        /// Complete: Indicates that blob restore has been completed
+        /// successfully. - Failed: Indicates that blob restore is failed.
+        /// Possible values include: 'InProgress', 'Complete', 'Failed'</param>
+        /// <param name="failureReason">Failure reason when blob restore is
+        /// failed.</param>
+        /// <param name="restoreId">Id for tracking blob restore
+        /// request.</param>
+        /// <param name="parameters">Blob restore request parameters.</param>
+        public BlobRestoreStatus(string status = default(string), string failureReason = default(string), string restoreId = default(string), BlobRestoreParameters parameters = default(BlobRestoreParameters))
+        {
+            Status = status;
+            FailureReason = failureReason;
+            RestoreId = restoreId;
+            Parameters = parameters;
+            CustomInit();
+        }
+
+        /// <summary>
+        /// An initialization method that performs custom operations like setting defaults
+        /// </summary>
+        partial void CustomInit();
+
+        /// <summary>
+        /// Gets the status of blob restore progress. Possible values are: -
+        /// InProgress: Indicates that blob restore is ongoing. - Complete:
+        /// Indicates that blob restore has been completed successfully. -
+        /// Failed: Indicates that blob restore is failed. Possible values
+        /// include: 'InProgress', 'Complete', 'Failed'
+        /// </summary>
+        [JsonProperty(PropertyName = "status")]
+        public string Status { get; private set; }
+
+        /// <summary>
+        /// Gets failure reason when blob restore is failed.
+        /// </summary>
+        [JsonProperty(PropertyName = "failureReason")]
+        public string FailureReason { get; private set; }
+
+        /// <summary>
+        /// Gets id for tracking blob restore request.
+        /// </summary>
+        [JsonProperty(PropertyName = "restoreId")]
+        public string RestoreId { get; private set; }
+
+        /// <summary>
+        /// Gets blob restore request parameters.
+        /// </summary>
+        [JsonProperty(PropertyName = "parameters")]
+        public BlobRestoreParameters Parameters { get; private set; }
+
+        /// <summary>
+        /// Validate the object.
+        /// </summary>
+        /// <exception cref="Rest.ValidationException">
+        /// Thrown if validation fails
+        /// </exception>
+        public virtual void Validate()
+        {
+            if (Parameters != null)
+            {
+                Parameters.Validate();
+            }
+        }
+    }
+}