Add missing BackupRestore files from Websites

The BackupRestore folder got missed as the .gitignore file had an
exclusion clause for Backup*/

Author: solankisamir

src/ResourceManager/Websites/Commands.Websites/Cmdlets/BackupRestore/AzureWebAppBackup.cs

@@ -0,0 +1,112 @@
+// ----------------------------------------------------------------------------------
+//
+// Copyright Microsoft Corporation
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ----------------------------------------------------------------------------------
+
+using System;
+using Microsoft.Azure.Management.WebSites.Models;
+
+namespace Microsoft.Azure.Commands.WebApps.Cmdlets.WebApps
+{
+    /// <summary>
+    /// A simple class containing fields for all metadata associated with a backup.
+    /// </summary>
+    public class AzureWebAppBackup
+    {
+        /// <summary>
+        /// The resource group of the web app
+        /// </summary>
+        public string ResourceGroupName { get; set; }
+        
+        /// <summary>
+        /// The name of the web app
+        /// </summary>
+        public string Name { get; set; }
+
+        /// <summary>
+        /// The name of the web app slot
+        /// </summary>
+        public string Slot { get; set; }
+
+        /// <summary>
+        /// SAS URL for the storage account container which contains this backup
+        /// </summary>
+        public string StorageAccountUrl { get; set; }
+
+        /// <summary>
+        /// Name of the blob which contains data for this backup
+        /// </summary>
+        public string BlobName { get; set; }
+
+        /// <summary>
+        /// Databases backed up along with the web app
+        /// </summary>
+        public DatabaseBackupSetting[] Databases { get; set; }
+
+        /// <summary>
+        /// The numberic ID of this backup
+        /// </summary>
+        public int? BackupId { get; set; }
+
+        /// <summary>
+        /// The user-friendly name of this backup
+        /// </summary>
+        public string BackupName { get; set; }
+
+        /// <summary>
+        /// The status of the backup. Possible values are InProgress, Failed, Succeeded,
+        /// TimedOut, Created, Skipped, PartiallySucceeded, DeleteInProgress, DeleteFailed,
+        /// Deleted. 
+        /// </summary>
+        public string BackupStatus { get; set; }
+
+        /// <summary>
+        /// True if this backup was automatically created due to a backup schedule
+        /// </summary>
+        public bool? Scheduled { get; set; }
+
+        /// <summary>
+        /// The size of this backup in bytes
+        /// </summary>
+        public long? BackupSizeInBytes { get; set; }
+
+        /// <summary>
+        /// Size of the original web app which has been backed up
+        /// </summary>
+        public long? WebsiteSizeInBytes { get; set; }
+
+        /// <summary>
+        /// Time when the backup was requested
+        /// </summary>
+        public DateTime? Created { get; set; }
+
+        /// <summary>
+        /// Time when the web app was last restored from this backup
+        /// </summary>
+        public DateTime? LastRestored { get; set; }
+
+        /// <summary>
+        /// Time when the backup finished
+        /// </summary>
+        public DateTime? Finished { get; set; }
+
+        /// <summary>
+        /// Log of any failures or warnings associated with this backup
+        /// </summary>
+        public string Log { get; set; }
+
+        /// <summary>
+        /// Unique correlation identifier. Please use this along with the timestamp while communicating with Azure support.
+        /// </summary>
+        public string CorrelationId { get; set; }
+    }
+}

src/ResourceManager/Websites/Commands.Websites/Cmdlets/BackupRestore/AzureWebAppBackupConfiguration.cs

@@ -0,0 +1,75 @@
+// ----------------------------------------------------------------------------------
+//
+// Copyright Microsoft Corporation
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ----------------------------------------------------------------------------------
+
+using System;
+using Microsoft.Azure.Management.WebSites.Models;
+
+namespace Microsoft.Azure.Commands.WebApps.Cmdlets.WebApps
+{
+    /// <summary>
+    /// A simple class containing fields for all metadata associated with a backup configuration.
+    /// </summary>
+    public class AzureWebAppBackupConfiguration
+    {
+        /// <summary>
+        /// The name of the web app
+        /// </summary>
+        public string Name { get; set; }
+
+        /// <summary>
+        /// The resource group of the web app
+        /// </summary>
+        public string ResourceGroupName { get; set; }
+
+        /// <summary>
+        /// SAS URL for the storage account container to use for scheduled backups
+        /// </summary>
+        public string StorageAccountUrl { get; set; }
+
+        /// <summary>
+        /// Numeric part of backup frequency. For example, for weekly backups, FrequencyInterval = 7 and FrequencyUnit = Day.
+        /// </summary>
+        public int? FrequencyInterval { get; set; }
+
+        /// <summary>
+        /// Unit of backup frequency. Valid options are Hour and Day. For example, for weekly backups, FrequencyInterval = 7 and FrequencyUnit = Day.
+        /// </summary>
+        public string FrequencyUnit { get; set; }
+
+        /// <summary>
+        /// Number of days the automatic backups should be retained before being automatically deleted.
+        /// </summary>
+        public int? RetentionPeriodInDays { get; set; }
+
+        /// <summary>
+        /// The time when the first automatic backup should be created.
+        /// </summary>
+        public DateTime? StartTime { get; set; }
+
+        /// <summary>
+        /// The databases to be backed up automatically along with the web app
+        /// </summary>
+        public DatabaseBackupSetting[] Databases { get; set; }
+
+        /// <summary>
+        /// True if one backup should always be left in the storage account regardless of retention period.
+        /// </summary>
+        public bool? KeepAtLeastOneBackup { get; set; }
+
+        /// <summary>
+        /// True if the automatic backups are enabled.
+        /// </summary>
+        public bool? Enabled { get; set; }
+    }
+}

src/ResourceManager/Websites/Commands.Websites/Cmdlets/BackupRestore/BackupRestoreUtils.cs

@@ -0,0 +1,113 @@
+// ----------------------------------------------------------------------------------
+//
+// Copyright Microsoft Corporation
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ----------------------------------------------------------------------------------
+
+using System;
+using System.Linq;
+using Microsoft.Azure.Management.WebSites.Models;
+
+namespace Microsoft.Azure.Commands.WebApps.Cmdlets.WebApps
+{
+    internal class BackupRestoreUtils
+    {
+        public static FrequencyUnit StringToFrequencyUnit(string frequencyUnit)
+        {
+            FrequencyUnit freq;
+            try
+            {
+                freq = (FrequencyUnit) Enum.Parse(typeof (FrequencyUnit), frequencyUnit, true);
+            }
+            catch (ArgumentException)
+            {
+                throw new ArgumentException(string.Format("{0} is not a valid FrequencyUnit. Valid options are Hour and Day.", frequencyUnit));
+            }
+            return freq;
+        }
+
+        public static AzureWebAppBackup BackupItemToAppBackup(BackupItem backup, string resourceGroupName, string name, string slot)
+        {
+            if (backup == null)
+            {
+                return new AzureWebAppBackup();
+            }
+            var dbs = backup.Databases == null ? null : backup.Databases.ToArray();
+            string status = backup.Status == null ? null : backup.Status.ToString();
+            return new AzureWebAppBackup
+            {
+                ResourceGroupName = resourceGroupName,
+                Name = name,
+                Slot = slot,
+                StorageAccountUrl = backup.StorageAccountUrl,
+                BlobName = backup.BlobName,
+                Databases = dbs,
+                BackupId = backup.BackupItemId,
+                BackupName = backup.BackupItemName,
+                BackupStatus = status,
+                Scheduled = backup.Scheduled,
+                BackupSizeInBytes = backup.SizeInBytes,
+                WebsiteSizeInBytes = backup.WebsiteSizeInBytes,
+                Created = backup.Created,
+                LastRestored = backup.LastRestoreTimeStamp,
+                Finished = backup.FinishedTimeStamp,
+                Log = backup.Log,
+                CorrelationId = backup.CorrelationId
+            };
+        }
+
+        public static AzureWebAppBackupConfiguration BackupRequestToAppBackupConfiguration(BackupRequest configuration, string resourceGroupName, string name, string slot)
+        {
+            if (configuration == null)
+            {
+                return new AzureWebAppBackupConfiguration();
+            }
+            BackupSchedule schedule = configuration.BackupSchedule;
+            DatabaseBackupSetting[] databases = null;
+            bool? enabled = configuration.Enabled;
+            if (configuration.Databases != null)
+            {
+                databases = configuration.Databases.ToArray();
+            }
+            
+            int? frequencyInterval = null;
+            string frequencyUnit = null;
+            int? retentionPeriodInDays = null;
+            DateTime? startTime = null;
+            bool? keepAtLeastOneBackup = null;
+            if (schedule != null)
+            {
+                frequencyInterval = schedule.FrequencyInterval;
+                if (schedule.FrequencyUnit != null)
+                {
+                    frequencyUnit = schedule.FrequencyUnit.ToString();
+                }
+                retentionPeriodInDays = schedule.RetentionPeriodInDays;
+                startTime = schedule.StartTime;
+                keepAtLeastOneBackup = schedule.KeepAtLeastOneBackup;
+            }
+
+            return new AzureWebAppBackupConfiguration()
+            {
+                Name = name,
+                ResourceGroupName = resourceGroupName,
+                StorageAccountUrl = configuration.StorageAccountUrl,
+                FrequencyInterval = frequencyInterval,
+                FrequencyUnit = frequencyUnit,
+                RetentionPeriodInDays = retentionPeriodInDays,
+                StartTime = startTime,
+                Databases = databases,
+                KeepAtLeastOneBackup = keepAtLeastOneBackup,
+                Enabled = enabled
+            };
+        }
+    }
+}

src/ResourceManager/Websites/Commands.Websites/Cmdlets/BackupRestore/EditAzureWebAppBackupConfiguration.cs

@@ -0,0 +1,89 @@
+// ----------------------------------------------------------------------------------
+//
+// Copyright Microsoft Corporation
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ----------------------------------------------------------------------------------
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Management.Automation;
+using System.Text;
+using System.Threading.Tasks;
+using Microsoft.Azure.Commands.WebApps.Cmdlets.BackupRestore;
+using Microsoft.Azure.Management.WebSites.Models;
+
+namespace Microsoft.Azure.Commands.WebApps.Cmdlets.WebApps
+{
+    /// <summary>
+    /// Modifies the automatic backup configuration for an Azure Web App
+    /// </summary>
+    [Cmdlet(VerbsData.Edit, "AzureRmWebAppBackupConfiguration"), OutputType(typeof(AzureWebAppBackupConfiguration))]
+    public class EditAzureWebAppBackupConfiguration : WebAppOptionalSlotBaseCmdlet
+    {
+        [Parameter(Position = 3, Mandatory = true, HelpMessage = "The SAS URL for the Azure Storage container used to store the backup.", ValueFromPipelineByPropertyName = true)]
+        [ValidateNotNullOrEmpty]
+        public string StorageAccountUrl;
+
+        [Parameter(Position = 4, Mandatory = true, HelpMessage = "Numeric value for how often the backups should be made.", ValueFromPipelineByPropertyName = true)]
+        [ValidateNotNullOrEmpty]
+        public int FrequencyInterval { get; set; }
+
+        [Parameter(Position = 5, Mandatory = true, HelpMessage = "Unit of time for how often the backups should be made. Options are \"Hour\" and \"Day\".", ValueFromPipelineByPropertyName = true)]
+        [ValidateNotNullOrEmpty]
+        public string FrequencyUnit { get; set; }
+
+        [Parameter(Position = 6, Mandatory = true, HelpMessage = "How many days the automatic backups should be saved before being automatically deleted.", ValueFromPipelineByPropertyName = true)]
+        [ValidateNotNullOrEmpty]
+        public int RetentionPeriodInDays { get; set; }
+
+        [Parameter(Position = 7, Mandatory = false, HelpMessage = "The time when the automatic backups should begin. Backups will begin immediately if this is null.", ValueFromPipelineByPropertyName = true)]
+        public DateTime StartTime { get; set; }
+
+        [Parameter(Position = 8, Mandatory = false, HelpMessage = "The databases to backup.", ValueFromPipelineByPropertyName = true)]
+        public DatabaseBackupSetting[] Databases;
+
+        [Parameter(Position = 9, Mandatory = false, HelpMessage = "True if one backup should always be kept in the storage account, regardless of how old it is.", ValueFromPipelineByPropertyName = true)]
+        public SwitchParameter KeepAtLeastOneBackup { get; set; }
+
+        public override void ExecuteCmdlet()
+        {
+            base.ExecuteCmdlet();
+            var freq = BackupRestoreUtils.StringToFrequencyUnit(FrequencyUnit);
+            BackupSchedule schedule = new BackupSchedule(freq, FrequencyInterval, KeepAtLeastOneBackup.IsPresent,
+                RetentionPeriodInDays, StartTime);
+            BackupRequest request = new BackupRequest()
+            {
+                Location = "",
+                Enabled = true,
+                StorageAccountUrl = this.StorageAccountUrl,
+                BackupSchedule = schedule,
+                Databases = this.Databases,
+                BackupRequestType = BackupRestoreOperationType.Default
+            };
+            WebsitesClient.UpdateWebAppBackupConfiguration(ResourceGroupName, Name, Slot, request);
+            var config = new AzureWebAppBackupConfiguration()
+            {
+                Name = this.Name,
+                ResourceGroupName = this.ResourceGroupName,
+                StorageAccountUrl = this.StorageAccountUrl,
+                FrequencyInterval = this.FrequencyInterval,
+                FrequencyUnit = this.FrequencyUnit,
+                RetentionPeriodInDays = this.RetentionPeriodInDays,
+                StartTime = this.StartTime,
+                KeepAtLeastOneBackup = this.KeepAtLeastOneBackup.IsPresent,
+                Databases = this.Databases,
+                Enabled = true
+            };
+            WriteObject(config);
+        }
+    }
+}