/******************************************************************************* * Copyright 2012-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved. * Licensed under the Apache License, Version 2.0 (the "License"). You may not use * this file except in compliance with the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. * This file 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. * ***************************************************************************** * * AWS Tools for Windows (TM) PowerShell (TM) * */ using System; using System.Collections.Generic; using System.Linq; using System.Management.Automation; using System.Text; using Amazon.PowerShell.Common; using Amazon.Runtime; using Amazon.IoT; using Amazon.IoT.Model; namespace Amazon.PowerShell.Cmdlets.IOT { /// /// Updates values stored in the domain configuration. Domain configurations for default /// endpoints can't be updated. /// /// /// /// Requires permission to access the UpdateDomainConfiguration /// action. /// /// [Cmdlet("Update", "IOTDomainConfiguration", SupportsShouldProcess = true, ConfirmImpact = ConfirmImpact.Medium)] [OutputType("Amazon.IoT.Model.UpdateDomainConfigurationResponse")] [AWSCmdlet("Calls the AWS IoT UpdateDomainConfiguration API operation.", Operation = new[] {"UpdateDomainConfiguration"}, SelectReturnType = typeof(Amazon.IoT.Model.UpdateDomainConfigurationResponse))] [AWSCmdletOutput("Amazon.IoT.Model.UpdateDomainConfigurationResponse", "This cmdlet returns an Amazon.IoT.Model.UpdateDomainConfigurationResponse object containing multiple properties. The object can also be referenced from properties attached to the cmdlet entry in the $AWSHistory stack." )] public partial class UpdateIOTDomainConfigurationCmdlet : AmazonIoTClientCmdlet, IExecutor { #region Parameter AuthorizerConfig_AllowAuthorizerOverride /// /// /// A Boolean that specifies whether the domain configuration's authorization service /// can be overridden. /// /// [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.Boolean? AuthorizerConfig_AllowAuthorizerOverride { get; set; } #endregion #region Parameter AuthorizerConfig_DefaultAuthorizerName /// /// /// The name of the authorization service for a domain configuration. /// /// [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.String AuthorizerConfig_DefaultAuthorizerName { get; set; } #endregion #region Parameter DomainConfigurationName /// /// /// The name of the domain configuration to be updated. /// /// #if !MODULAR [System.Management.Automation.Parameter(Position = 0, ValueFromPipelineByPropertyName = true, ValueFromPipeline = true)] #else [System.Management.Automation.Parameter(Position = 0, ValueFromPipelineByPropertyName = true, ValueFromPipeline = true, Mandatory = true)] [System.Management.Automation.AllowEmptyString] [System.Management.Automation.AllowNull] #endif [Amazon.PowerShell.Common.AWSRequiredParameter] public System.String DomainConfigurationName { get; set; } #endregion #region Parameter DomainConfigurationStatus /// /// /// The status to which the domain configuration should be updated. /// /// [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] [AWSConstantClassSource("Amazon.IoT.DomainConfigurationStatus")] public Amazon.IoT.DomainConfigurationStatus DomainConfigurationStatus { get; set; } #endregion #region Parameter RemoveAuthorizerConfig /// /// /// Removes the authorization configuration from a domain. /// /// [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.Boolean? RemoveAuthorizerConfig { get; set; } #endregion #region Parameter TlsConfig_SecurityPolicy /// /// /// The security policy for a domain configuration. For more information, see Security /// policies in the Amazon Web Services IoT Core developer guide. /// /// [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public System.String TlsConfig_SecurityPolicy { get; set; } #endregion #region Parameter Select /// /// Use the -Select parameter to control the cmdlet output. The default value is '*'. /// Specifying -Select '*' will result in the cmdlet returning the whole service response (Amazon.IoT.Model.UpdateDomainConfigurationResponse). /// Specifying the name of a property of type Amazon.IoT.Model.UpdateDomainConfigurationResponse will result in that property being returned. /// Specifying -Select '^ParameterName' will result in the cmdlet returning the selected cmdlet parameter value. /// [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public string Select { get; set; } = "*"; #endregion #region Parameter PassThru /// /// Changes the cmdlet behavior to return the value passed to the DomainConfigurationName parameter. /// The -PassThru parameter is deprecated, use -Select '^DomainConfigurationName' instead. This parameter will be removed in a future version. /// [System.Obsolete("The -PassThru parameter is deprecated, use -Select '^DomainConfigurationName' instead. This parameter will be removed in a future version.")] [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public SwitchParameter PassThru { get; set; } #endregion #region Parameter Force /// /// This parameter overrides confirmation prompts to force /// the cmdlet to continue its operation. This parameter should always /// be used with caution. /// [System.Management.Automation.Parameter(ValueFromPipelineByPropertyName = true)] public SwitchParameter Force { get; set; } #endregion protected override void ProcessRecord() { this._AWSSignerType = "v4"; base.ProcessRecord(); var resourceIdentifiersText = FormatParameterValuesForConfirmationMsg(nameof(this.DomainConfigurationName), MyInvocation.BoundParameters); if (!ConfirmShouldProceed(this.Force.IsPresent, resourceIdentifiersText, "Update-IOTDomainConfiguration (UpdateDomainConfiguration)")) { return; } var context = new CmdletContext(); // allow for manipulation of parameters prior to loading into context PreExecutionContextLoad(context); #pragma warning disable CS0618, CS0612 //A class member was marked with the Obsolete attribute if (ParameterWasBound(nameof(this.Select))) { context.Select = CreateSelectDelegate(Select) ?? throw new System.ArgumentException("Invalid value for -Select parameter.", nameof(this.Select)); if (this.PassThru.IsPresent) { throw new System.ArgumentException("-PassThru cannot be used when -Select is specified.", nameof(this.Select)); } } else if (this.PassThru.IsPresent) { context.Select = (response, cmdlet) => this.DomainConfigurationName; } #pragma warning restore CS0618, CS0612 //A class member was marked with the Obsolete attribute context.AuthorizerConfig_AllowAuthorizerOverride = this.AuthorizerConfig_AllowAuthorizerOverride; context.AuthorizerConfig_DefaultAuthorizerName = this.AuthorizerConfig_DefaultAuthorizerName; context.DomainConfigurationName = this.DomainConfigurationName; #if MODULAR if (this.DomainConfigurationName == null && ParameterWasBound(nameof(this.DomainConfigurationName))) { WriteWarning("You are passing $null as a value for parameter DomainConfigurationName which is marked as required. In case you believe this parameter was incorrectly marked as required, report this by opening an issue at https://github.com/aws/aws-tools-for-powershell/issues."); } #endif context.DomainConfigurationStatus = this.DomainConfigurationStatus; context.RemoveAuthorizerConfig = this.RemoveAuthorizerConfig; context.TlsConfig_SecurityPolicy = this.TlsConfig_SecurityPolicy; // allow further manipulation of loaded context prior to processing PostExecutionContextLoad(context); var output = Execute(context) as CmdletOutput; ProcessOutput(output); } #region IExecutor Members public object Execute(ExecutorContext context) { var cmdletContext = context as CmdletContext; // create request var request = new Amazon.IoT.Model.UpdateDomainConfigurationRequest(); // populate AuthorizerConfig var requestAuthorizerConfigIsNull = true; request.AuthorizerConfig = new Amazon.IoT.Model.AuthorizerConfig(); System.Boolean? requestAuthorizerConfig_authorizerConfig_AllowAuthorizerOverride = null; if (cmdletContext.AuthorizerConfig_AllowAuthorizerOverride != null) { requestAuthorizerConfig_authorizerConfig_AllowAuthorizerOverride = cmdletContext.AuthorizerConfig_AllowAuthorizerOverride.Value; } if (requestAuthorizerConfig_authorizerConfig_AllowAuthorizerOverride != null) { request.AuthorizerConfig.AllowAuthorizerOverride = requestAuthorizerConfig_authorizerConfig_AllowAuthorizerOverride.Value; requestAuthorizerConfigIsNull = false; } System.String requestAuthorizerConfig_authorizerConfig_DefaultAuthorizerName = null; if (cmdletContext.AuthorizerConfig_DefaultAuthorizerName != null) { requestAuthorizerConfig_authorizerConfig_DefaultAuthorizerName = cmdletContext.AuthorizerConfig_DefaultAuthorizerName; } if (requestAuthorizerConfig_authorizerConfig_DefaultAuthorizerName != null) { request.AuthorizerConfig.DefaultAuthorizerName = requestAuthorizerConfig_authorizerConfig_DefaultAuthorizerName; requestAuthorizerConfigIsNull = false; } // determine if request.AuthorizerConfig should be set to null if (requestAuthorizerConfigIsNull) { request.AuthorizerConfig = null; } if (cmdletContext.DomainConfigurationName != null) { request.DomainConfigurationName = cmdletContext.DomainConfigurationName; } if (cmdletContext.DomainConfigurationStatus != null) { request.DomainConfigurationStatus = cmdletContext.DomainConfigurationStatus; } if (cmdletContext.RemoveAuthorizerConfig != null) { request.RemoveAuthorizerConfig = cmdletContext.RemoveAuthorizerConfig.Value; } // populate TlsConfig var requestTlsConfigIsNull = true; request.TlsConfig = new Amazon.IoT.Model.TlsConfig(); System.String requestTlsConfig_tlsConfig_SecurityPolicy = null; if (cmdletContext.TlsConfig_SecurityPolicy != null) { requestTlsConfig_tlsConfig_SecurityPolicy = cmdletContext.TlsConfig_SecurityPolicy; } if (requestTlsConfig_tlsConfig_SecurityPolicy != null) { request.TlsConfig.SecurityPolicy = requestTlsConfig_tlsConfig_SecurityPolicy; requestTlsConfigIsNull = false; } // determine if request.TlsConfig should be set to null if (requestTlsConfigIsNull) { request.TlsConfig = null; } CmdletOutput output; // issue call var client = Client ?? CreateClient(_CurrentCredentials, _RegionEndpoint); try { var response = CallAWSServiceOperation(client, request); object pipelineOutput = null; pipelineOutput = cmdletContext.Select(response, this); output = new CmdletOutput { PipelineOutput = pipelineOutput, ServiceResponse = response }; } catch (Exception e) { output = new CmdletOutput { ErrorResponse = e }; } return output; } public ExecutorContext CreateContext() { return new CmdletContext(); } #endregion #region AWS Service Operation Call private Amazon.IoT.Model.UpdateDomainConfigurationResponse CallAWSServiceOperation(IAmazonIoT client, Amazon.IoT.Model.UpdateDomainConfigurationRequest request) { Utils.Common.WriteVerboseEndpointMessage(this, client.Config, "AWS IoT", "UpdateDomainConfiguration"); try { #if DESKTOP return client.UpdateDomainConfiguration(request); #elif CORECLR return client.UpdateDomainConfigurationAsync(request).GetAwaiter().GetResult(); #else #error "Unknown build edition" #endif } catch (AmazonServiceException exc) { var webException = exc.InnerException as System.Net.WebException; if (webException != null) { throw new Exception(Utils.Common.FormatNameResolutionFailureMessage(client.Config, webException.Message), webException); } throw; } } #endregion internal partial class CmdletContext : ExecutorContext { public System.Boolean? AuthorizerConfig_AllowAuthorizerOverride { get; set; } public System.String AuthorizerConfig_DefaultAuthorizerName { get; set; } public System.String DomainConfigurationName { get; set; } public Amazon.IoT.DomainConfigurationStatus DomainConfigurationStatus { get; set; } public System.Boolean? RemoveAuthorizerConfig { get; set; } public System.String TlsConfig_SecurityPolicy { get; set; } public System.Func Select { get; set; } = (response, cmdlet) => response; } } }