@@ -28,6 +28,7 @@ public partial class ManagementAPI
2828 /// </summary>
2929 /// <param name="mgmtStateProvider">The instance management state provider.</param>
3030 /// <param name="mgmtHubContext">The management hub context for SignalR or Direct communication.</param>
31+ /// <param name="log"></param>
3132 public ManagementAPI ( IInstanceManagementStateProvider mgmtStateProvider , IHubContext < InstanceManagementHub , IInstanceManagementHub > mgmtHubContext , ILogger < ManagementAPI > log )
3233 {
3334 _mgmtStateProvider = mgmtStateProvider ;
@@ -41,6 +42,7 @@ public ManagementAPI(IInstanceManagementStateProvider mgmtStateProvider, IHubCon
4142 /// <param name="mgmtStateProvider">The instance management state provider.</param>
4243 /// <param name="mgmtHubContext">The management hub context for SignalR communication.</param>
4344 /// <param name="certifyManager">The in-process Certify manager instance.</param>
45+ /// <param name="log"></param>
4446 public ManagementAPI ( IInstanceManagementStateProvider mgmtStateProvider , IHubContext < InstanceManagementHub , IInstanceManagementHub > mgmtHubContext , Certify . Management . ICertifyManager certifyManager , ILogger < ManagementAPI > log )
4547 {
4648 _mgmtStateProvider = mgmtStateProvider ;
@@ -125,12 +127,12 @@ private async Task SendCommandWithNoResult(string instanceId, InstanceCommandReq
125127 /// <returns>The deserialized result as type <typeparamref name="T"/> if available; otherwise, default.</returns>
126128 private async Task < T ? > PerformInstanceCommandTaskWithResult < T > ( string instanceId , KeyValuePair < string , string > [ ] args , string commandType )
127129 {
128- InstanceCommandResult result ;
129- var cmd = new InstanceCommandRequest ( commandType , args ) ;
130-
131- cmd . IsResultAwaited = true ;
130+ var cmd = new InstanceCommandRequest ( commandType , args )
131+ {
132+ IsResultAwaited = true
133+ } ;
132134
133- result = await GetCommandResult ( instanceId , cmd ) ;
135+ var result = await GetCommandResult ( instanceId , cmd ) ;
134136
135137 if ( result ? . Value != null )
136138 {
@@ -623,6 +625,12 @@ internal async Task<List<ActionStep>> PerformInstanceImport(string instanceId, I
623625 return await PerformInstanceCommandTaskWithResult < ICollection < Models . ActionStep > > ( instanceId , args , ManagementHubCommands . GetSystemStatusItems ) ;
624626 }
625627
628+ /// <summary>
629+ /// Retrieves the service configuration for the specified instance.
630+ /// </summary>
631+ /// <param name="instanceId">The target instance identifier.</param>
632+ /// <param name="currentAuthContext">The current authentication context.</param>
633+ /// <returns>A <see cref="ServiceConfig"/> object containing the service configuration, or null if not found.</returns>
626634 public async Task < ServiceConfig ? > GetServiceConfig ( string instanceId , AuthContext ? currentAuthContext )
627635 {
628636 var args = new KeyValuePair < string , string > [ ] {
@@ -632,6 +640,12 @@ internal async Task<List<ActionStep>> PerformInstanceImport(string instanceId, I
632640 return await PerformInstanceCommandTaskWithResult < ServiceConfig > ( instanceId , args , ManagementHubCommands . GetServiceConfig ) ;
633641 }
634642
643+ /// <summary>
644+ /// Retrieves service core settings for a specified instance asynchronously.
645+ /// </summary>
646+ /// <param name="instanceId">Identifies the specific instance for which the settings are being retrieved.</param>
647+ /// <param name="currentAuthContext">Provides the authentication context necessary for accessing the service settings.</param>
648+ /// <returns>Returns the preferences associated with the service core settings or null if not found.</returns>
635649 public async Task < Preferences ? > GetServiceCoreSettings ( string instanceId , AuthContext ? currentAuthContext )
636650 {
637651 var args = new KeyValuePair < string , string > [ ] {
@@ -641,6 +655,13 @@ internal async Task<List<ActionStep>> PerformInstanceImport(string instanceId, I
641655 return await PerformInstanceCommandTaskWithResult < Preferences > ( instanceId , args , ManagementHubCommands . GetServiceCoreSettings ) ;
642656 }
643657
658+ /// <summary>
659+ /// Updates the core settings of a service instance based on provided preferences and authentication context.
660+ /// </summary>
661+ /// <param name="instanceId">Identifies the specific service instance to be updated.</param>
662+ /// <param name="prefs">Contains the new preferences to apply to the service instance.</param>
663+ /// <param name="currentAuthContext">Holds the current authentication context for authorization during the update.</param>
664+ /// <returns>Returns the result of the update operation, which may indicate success or failure.</returns>
644665 public async Task < ActionResult ? > UpdateServiceCoreSettings ( string instanceId , Preferences prefs , AuthContext ? currentAuthContext )
645666 {
646667 var args = new KeyValuePair < string , string > [ ] {
@@ -651,6 +672,13 @@ internal async Task<List<ActionStep>> PerformInstanceImport(string instanceId, I
651672 return await PerformInstanceCommandTaskWithResult < ActionResult ? > ( instanceId , args , ManagementHubCommands . UpdateServiceCoreSettings ) ;
652673 }
653674
675+ /// <summary>
676+ /// Updates the configuration of a specified service instance asynchronously.
677+ /// </summary>
678+ /// <param name="instanceId">Identifies the specific service instance to be updated.</param>
679+ /// <param name="config">Contains the new configuration settings for the service instance.</param>
680+ /// <param name="currentAuthContext">Represents the current authentication context for authorization checks.</param>
681+ /// <returns>Returns the result of the update operation, which may indicate success or failure.</returns>
654682 public async Task < ActionResult ? > UpdateServiceConfig ( string instanceId , ServiceConfig config , AuthContext ? currentAuthContext )
655683 {
656684 var args = new KeyValuePair < string , string > [ ] {
0 commit comments