[SQL] Add cmdlet to refresh external governance status. (#21220)

* irrelevant changes after updating the readme

* updates for api getter

* changes for external governance api

* add tests

* make auditing build

* Revert "irrelevant changes after updating the readme"

This reverts commit 4da1243.

* potentially relavant generated files

* Revert "make auditing build"

This reverts commit 070cadc.

* add help file

* address code review comments

* rename cmdlet

* update PS cmdlet name

* update help

* update example

* Update ChangeLog.md

---------

Co-authored-by: Yabo Hu <[email protected]>

Author: guptanitish-ms

src/Sql/Sql.Sdk/Generated/IServersOperations.cs

@@ -23,6 +23,51 @@ namespace Microsoft.Azure.Management.Sql
     /// </summary>
     public partial interface IServersOperations
     {
+        /// <summary>
+        /// Determines whether a resource can be created with the specified
+        /// name.
+        /// </summary>
+        /// <param name='parameters'>
+        /// The name availability request parameters.
+        /// </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<CheckNameAvailabilityResponse>> CheckNameAvailabilityWithHttpMessagesAsync(CheckNameAvailabilityRequest parameters, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
+        /// <summary>
+        /// Gets a list of all servers in the subscription.
+        /// </summary>
+        /// <param name='expand'>
+        /// The child resources to include in the response.
+        /// </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<IPage<Server>>> ListWithHttpMessagesAsync(string expand = default(string), Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
         /// <summary>
         /// Gets a list of servers in a resource groups.
         /// </summary>
@@ -165,28 +210,6 @@ public partial interface IServersOperations
         /// </exception>
         Task<AzureOperationResponse<Server>> UpdateWithHttpMessagesAsync(string resourceGroupName, string serverName, ServerUpdate parameters, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
         /// <summary>
-        /// Gets a list of all servers in the subscription.
-        /// </summary>
-        /// <param name='expand'>
-        /// The child resources to include in the response.
-        /// </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<IPage<Server>>> ListWithHttpMessagesAsync(string expand = default(string), Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
-        /// <summary>
         /// Imports a bacpac into a new database.
         /// </summary>
         /// <param name='resourceGroupName'>
@@ -217,11 +240,15 @@ public partial interface IServersOperations
         /// </exception>
         Task<AzureOperationResponse<ImportExportOperationResult>> ImportDatabaseWithHttpMessagesAsync(string resourceGroupName, string serverName, ImportNewDatabaseDefinition parameters, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
         /// <summary>
-        /// Determines whether a resource can be created with the specified
-        /// name.
+        /// Refresh external governance enablement status.
         /// </summary>
-        /// <param name='parameters'>
-        /// The name availability request parameters.
+        /// <param name='resourceGroupName'>
+        /// The name of the resource group that contains the resource. You can
+        /// obtain this value from the Azure Resource Manager API or the
+        /// portal.
+        /// </param>
+        /// <param name='serverName'>
+        /// The name of the server.
         /// </param>
         /// <param name='customHeaders'>
         /// The headers that will be added to request.
@@ -238,7 +265,7 @@ public partial interface IServersOperations
         /// <exception cref="Microsoft.Rest.ValidationException">
         /// Thrown when a required parameter is null
         /// </exception>
-        Task<AzureOperationResponse<CheckNameAvailabilityResponse>> CheckNameAvailabilityWithHttpMessagesAsync(CheckNameAvailabilityRequest parameters, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
+        Task<AzureOperationResponse<RefreshExternalGovernanceStatusOperationResult>> RefreshStatusWithHttpMessagesAsync(string resourceGroupName, string serverName, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
         /// <summary>
         /// Creates or updates a server.
         /// </summary>
@@ -354,10 +381,15 @@ public partial interface IServersOperations
         /// </exception>
         Task<AzureOperationResponse<ImportExportOperationResult>> BeginImportDatabaseWithHttpMessagesAsync(string resourceGroupName, string serverName, ImportNewDatabaseDefinition parameters, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
         /// <summary>
-        /// Gets a list of servers in a resource groups.
+        /// Refresh external governance enablement status.
         /// </summary>
-        /// <param name='nextPageLink'>
-        /// The NextLink from the previous successful call to List operation.
+        /// <param name='resourceGroupName'>
+        /// The name of the resource group that contains the resource. You can
+        /// obtain this value from the Azure Resource Manager API or the
+        /// portal.
+        /// </param>
+        /// <param name='serverName'>
+        /// The name of the server.
         /// </param>
         /// <param name='customHeaders'>
         /// The headers that will be added to request.
@@ -374,7 +406,7 @@ public partial interface IServersOperations
         /// <exception cref="Microsoft.Rest.ValidationException">
         /// Thrown when a required parameter is null
         /// </exception>
-        Task<AzureOperationResponse<IPage<Server>>> ListByResourceGroupNextWithHttpMessagesAsync(string nextPageLink, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
+        Task<AzureOperationResponse<RefreshExternalGovernanceStatusOperationResult>> BeginRefreshStatusWithHttpMessagesAsync(string resourceGroupName, string serverName, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
         /// <summary>
         /// Gets a list of all servers in the subscription.
         /// </summary>
@@ -397,5 +429,27 @@ public partial interface IServersOperations
         /// Thrown when a required parameter is null
         /// </exception>
         Task<AzureOperationResponse<IPage<Server>>> ListNextWithHttpMessagesAsync(string nextPageLink, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
+        /// <summary>
+        /// Gets a list of servers in a resource groups.
+        /// </summary>
+        /// <param name='nextPageLink'>
+        /// The NextLink from the previous successful call to List operation.
+        /// </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<IPage<Server>>> ListByResourceGroupNextWithHttpMessagesAsync(string nextPageLink, Dictionary<string, List<string>> customHeaders = null, CancellationToken cancellationToken = default(CancellationToken));
     }
 }

src/Sql/Sql.Sdk/Generated/ISqlManagementClient.cs

@@ -83,11 +83,6 @@ public partial interface ISqlManagementClient : System.IDisposable
         /// </summary>
         IElasticPoolDatabaseActivitiesOperations ElasticPoolDatabaseActivities { get; }
 
-        /// <summary>
-        /// Gets the IServersOperations.
-        /// </summary>
-        IServersOperations Servers { get; }
-
         /// <summary>
         /// Gets the IServerDevOpsAuditSettingsOperations.
         /// </summary>
@@ -503,5 +498,10 @@ public partial interface ISqlManagementClient : System.IDisposable
         /// </summary>
         IInstanceFailoverGroupsOperations InstanceFailoverGroups { get; }
 
+        /// <summary>
+        /// Gets the IServersOperations.
+        /// </summary>
+        IServersOperations Servers { get; }
+
     }
 }

src/Sql/Sql.Sdk/Generated/Models/ExternalGovernanceStatus.cs

@@ -0,0 +1,22 @@
+// <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.Sql.Models
+{
+
+    /// <summary>
+    /// Defines values for ExternalGovernanceStatus.
+    /// </summary>
+    public static class ExternalGovernanceStatus
+    {
+        public const string Enabled = "Enabled";
+        public const string Disabled = "Disabled";
+    }
+}

src/Sql/Sql.Sdk/Generated/Models/RefreshExternalGovernanceStatusOperationResult.cs

@@ -0,0 +1,100 @@
+// <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.Sql.Models
+{
+    using Microsoft.Rest;
+    using Microsoft.Rest.Serialization;
+    using Newtonsoft.Json;
+    using System.Linq;
+
+    /// <summary>
+    /// An RefreshExternalGovernanceStatus operation result resource.
+    /// </summary>
+    [Rest.Serialization.JsonTransformation]
+    public partial class RefreshExternalGovernanceStatusOperationResult : ProxyResource
+    {
+        /// <summary>
+        /// Initializes a new instance of the
+        /// RefreshExternalGovernanceStatusOperationResult class.
+        /// </summary>
+        public RefreshExternalGovernanceStatusOperationResult()
+        {
+            CustomInit();
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the
+        /// RefreshExternalGovernanceStatusOperationResult class.
+        /// </summary>
+        /// <param name="id">Resource ID.</param>
+        /// <param name="name">Resource name.</param>
+        /// <param name="type">Resource type.</param>
+        /// <param name="requestId">Request Id.</param>
+        /// <param name="requestType">Request type.</param>
+        /// <param name="queuedTime">Queued time.</param>
+        /// <param name="serverName">Server name.</param>
+        /// <param name="status">Operation status.</param>
+        /// <param name="errorMessage">Error message.</param>
+        public RefreshExternalGovernanceStatusOperationResult(string id = default(string), string name = default(string), string type = default(string), System.Guid? requestId = default(System.Guid?), string requestType = default(string), string queuedTime = default(string), string serverName = default(string), string status = default(string), string errorMessage = default(string))
+            : base(id, name, type)
+        {
+            RequestId = requestId;
+            RequestType = requestType;
+            QueuedTime = queuedTime;
+            ServerName = serverName;
+            Status = status;
+            ErrorMessage = errorMessage;
+            CustomInit();
+        }
+
+        /// <summary>
+        /// An initialization method that performs custom operations like setting defaults
+        /// </summary>
+        partial void CustomInit();
+
+        /// <summary>
+        /// Gets request Id.
+        /// </summary>
+        [JsonProperty(PropertyName = "properties.requestId")]
+        public System.Guid? RequestId { get; private set; }
+
+        /// <summary>
+        /// Gets request type.
+        /// </summary>
+        [JsonProperty(PropertyName = "properties.requestType")]
+        public string RequestType { get; private set; }
+
+        /// <summary>
+        /// Gets queued time.
+        /// </summary>
+        [JsonProperty(PropertyName = "properties.queuedTime")]
+        public string QueuedTime { get; private set; }
+
+        /// <summary>
+        /// Gets server name.
+        /// </summary>
+        [JsonProperty(PropertyName = "properties.serverName")]
+        public string ServerName { get; private set; }
+
+        /// <summary>
+        /// Gets operation status.
+        /// </summary>
+        [JsonProperty(PropertyName = "properties.status")]
+        public string Status { get; private set; }
+
+        /// <summary>
+        /// Gets error message.
+        /// </summary>
+        [JsonProperty(PropertyName = "properties.errorMessage")]
+        public string ErrorMessage { get; private set; }
+
+    }
+}