New-MGNReplicationConfigurationTemplate - ReplicationServersSecurityGroupsIDs is marked as required

[DenisBellezi]

Describe the bug

ERROR MESSAGE:
WARNING: You are passing $null as a value for parameter ReplicationServersSecurityGroupsIDs 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.

Regression Issue

• Select this option if this issue appears to be a regression.

Expected Behavior

ReplicationServersSecurityGroupsIDs should not be required

Current Behavior

ReplicationServersSecurityGroupsIDs is required which is a different behavior from that we have in AWS CLI.

Reproduction Steps

#---------------------------------------------
PARAMETERS USED FOR CREATION:

$replicationConfig = @{
StagingAreaSubnetId = "subnet-041798402f8942d5a"
StagingAreaTags = @{ "" = "" }
UseDedicatedReplicationServer = $false
BandwidthThrottling = 0
EbsEncryption = "DEFAULT" # Options: DEFAULT, CUSTOM, NONE
DataPlaneRouting = "PUBLIC_IP" # Options: PRIVATE_IP, PUBLIC_IP
DefaultLargeStagingDiskType = "GP3" # Options: GP2, GP3, ST1
AssociateDefaultSecurityGroup = $true
CreatePublicIP = $true
ReplicationServerInstanceType = "t3.small"
ReplicationServersSecurityGroupsIDs = $null
}

New-MGNReplicationConfigurationTemplate @replicationConfig
#---------------------------------------------
The command above works if I add a security group in ReplicationServersSecurityGroupsIDs

#---------------------------------------------

AWS CLI

In AWS CLI is possible to create a an MGN Replication Template without specifying a --replication-servers-security-groups-ids

Example:

aws mgn create-replication-configuration-template --associate-default-security-group --default-large-staging-disk-type GP3 --replication-server-instance-type t3.small --staging-area-subnet-id subnet-041798402f8942d5a --create-public-ip --data-plane-routing PUBLIC_IP --bandwidth-throttling 0 --ebs-encryption DEFAULT --no-use-dedicated-replication-server --replication-servers-security-groups-ids [""] --staging-area-tags = --region ap-southeast-2

Possible Solution

Make ReplicationServersSecurityGroupsIDs optional.

Additional Information/Context

No response

AWS Tools for PowerShell version used

Binary 4.1.724 AWS.Tools.Common
Binary 4.1.724 AWS.Tools.Mgn

$PSVersionTable.PSVersion

PowerShell version used

Major Minor Patch PreReleaseLabel BuildLabel

---

7 4 6

Operating System and version

Microsoft Windows Server 2022 Datacenter

[ashishdhingra]

@DenisBellezi Good morning. Thanks for opening the issue. If you refer API documentation for Application Migration Service > CreateReplicationConfigurationTemplate, replicationServersSecurityGroupsIDs is the required parameter. It is an array of strings with Minimum number of 0 items and Maximum number of 32 items. So you cannot pass $null for this parameter, you need to pass empty array, perhaps using @().

In your AWS CLI command as well, you appear to be passing an empty array --replication-servers-security-groups-ids [""].

Just a note, even if you pass empty array via @(), it might not work since AWS Tools for PowerShell uses AWS SDK for .NET to make AWS service API calls. There is an issue with current GA version 3.x of AWS SDK for .NET that initializes lists to empty collection by default and would not marshall (send) empty array in the outgoing request body in this case due to check here (which ensures that collection has at least one element due to logic here). While this issue would be fixed in next major version of AWS SDK for .NET (AWS Tools for PowerShell next major version would be released after few weeks thereafter), to workaround this limitation, you would need to set global level [Amazon.AWSConfigs]::InitializeCollections=$false. So update your PowerShell logic as shown below and see if it works:

[Amazon.AWSConfigs]::InitializeCollections=$false

$replicationConfig = @{
StagingAreaSubnetId = "subnet-041798402f8942d5a"
StagingAreaTags = @{ "" = "" }
UseDedicatedReplicationServer = $false
BandwidthThrottling = 0
EbsEncryption = "DEFAULT" # Options: DEFAULT, CUSTOM, NONE
DataPlaneRouting = "PUBLIC_IP" # Options: PRIVATE_IP, PUBLIC_IP
DefaultLargeStagingDiskType = "GP3" # Options: GP2, GP3, ST1
AssociateDefaultSecurityGroup = $true
CreatePublicIP = $true
ReplicationServerInstanceType = "t3.small"
ReplicationServersSecurityGroupsIDs = @()
}

New-MGNReplicationConfigurationTemplate @replicationConfig

Thanks,
Ashish

[github-actions]

This issue has not received a response in 5 days. If you want to keep this issue open, please just leave a comment below and auto-close will be canceled.