Avm.Authoring

0.31.0

Private/Tests/Cleanup/ConvertTo-AvmBicepCleanupState.ps1

                                function ConvertTo-AvmBicepCleanupState {

    [CmdletBinding()]

    [OutputType([System.Collections.Specialized.OrderedDictionary])]

    param(

        [Parameter(Mandatory)]

        [System.Collections.IDictionary] $State

    )

    Set-StrictMode -Version 3.0

    $ErrorActionPreference = 'Stop'

    if (($State['schemaVersion'] -isnot [int] -and $State['schemaVersion'] -isnot [long]) -or

        ($State['schemaVersion'] -ne 1 -and ($State['schemaVersion'] -ne 2 -or -not $State.Contains('isolationBoundary')))) {

        throw [AvmConfigurationException]::new('Unsupported Bicep cleanup state version.')

    }

    foreach ($name in @('runId', 'tenantId', 'subscriptionId', 'environment', 'status')) {

        if ($State[$name] -isnot [string] -or [string]::IsNullOrWhiteSpace($State[$name])) {

            throw [AvmConfigurationException]::new("Cleanup state requires a string '$name'.")

        }

    }

    if (-not (Test-AvmBicepRunId -RunId $State['runId']) -or

        $State['status'] -cnotin @('Pending', 'CleanupPending', 'Complete')) {

        throw [AvmConfigurationException]::new('Cleanup state has an invalid run ID or status.')

    }

    foreach ($name in @('tenantId', 'subscriptionId')) {

        $id = [guid]::Empty

        if (-not [guid]::TryParseExact($State[$name], 'D', [ref]$id) -or $id -eq [guid]::Empty) {

            throw [AvmConfigurationException]::new("Cleanup state has an invalid '$name'.")

        }

    }

    foreach ($name in @('deployments', 'ownedResourceGroups', 'resources')) {

        if ($State[$name] -isnot [System.Collections.IList]) {

            throw [AvmConfigurationException]::new("Cleanup state requires an array '$name'.")

        }

    }

    $deployments = [System.Collections.Generic.List[object]]::new()

    $deletionRecords = 0

    $pendingDeletions = 0

    $seen = [System.Collections.Generic.HashSet[string]]::new([System.StringComparer]::OrdinalIgnoreCase)

    foreach ($entry in $State['deployments']) {

        if ($entry -isnot [System.Collections.IDictionary] -or

            $entry['id'] -isnot [string] -or $entry['preflightRejected'] -isnot [bool] -or

            $entry['status'] -isnot [string] -or

            $entry['status'] -cnotin @('Attempted', 'Succeeded', 'Failed', 'Unknown', 'Rejected')) {

            throw [AvmConfigurationException]::new('Invalid cleanup deployment record.')

        }

        $resource = ConvertTo-AvmBicepCleanupResource -ResourceIds @($entry['id'])

        if ($resource.type -ine 'Microsoft.Resources/deployments' -or -not $seen.Add($entry['id'])) {

            throw [AvmConfigurationException]::new('Cleanup deployment IDs must be distinct deployment resources.')

        }

        $deployment = [ordered]@{

            id                = $entry['id']

            status            = $entry['status']

            preflightRejected = $entry['preflightRejected']

        }

        if ($entry.Contains('recordDeletion')) {

            if ($entry['recordDeletion'] -isnot [string] -or

                $entry['recordDeletion'] -cnotin @('Pending', 'Complete') -or

                $entry['status'] -cnotin @('Failed', 'Rejected')) {

                throw [AvmConfigurationException]::new('Invalid deployment record deletion progress.')

            }

            $deployment['recordDeletion'] = $entry['recordDeletion']

            $deletionRecords++

            if ($entry['recordDeletion'] -ceq 'Pending') { $pendingDeletions++ }

        }

        $deployments.Add($deployment)

    }

    $groups = [System.Collections.Generic.List[object]]::new()

    $seen.Clear()

    foreach ($entry in $State['ownedResourceGroups']) {

        if ($entry -isnot [System.Collections.IDictionary] -or $entry['id'] -isnot [string] -or

            -not (Test-AvmBicepRunId -RunId $entry['runId'])) {

            throw [AvmConfigurationException]::new('Invalid owned resource-group cleanup record.')

        }

        $resource = ConvertTo-AvmBicepCleanupResource -ResourceIds @($entry['id'])

        if ($resource.type -ine 'Microsoft.Resources/resourceGroups' -or -not $seen.Add($entry['id'])) {

            throw [AvmConfigurationException]::new('Owned cleanup group IDs must be distinct resource groups.')

        }

        $groups.Add([ordered]@{ id = $entry['id']; runId = $entry['runId'] })

    }

    $resources = [System.Collections.Generic.List[object]]::new()

    $seen.Clear()

    foreach ($entry in $State['resources']) {

        if ($entry -isnot [System.Collections.IDictionary] -or

            $entry['id'] -isnot [string] -or $entry['removed'] -isnot [bool] -or

            $entry['postProcessed'] -isnot [bool] -or $entry['metadataCaptured'] -isnot [bool] -or

            $entry['managedResourceGroupIds'] -isnot [System.Collections.IList] -or

            $entry['originalSoftDeleteFeatureState'] -isnot [string] -or

            $entry['originalSoftDeleteFeatureState'] -cnotin @('', 'Enabled', 'Disabled', 'AlwaysON')) {

            throw [AvmConfigurationException]::new('Invalid cleanup resource record.')

        }

        $resource = ConvertTo-AvmBicepCleanupResource -ResourceIds @($entry['id'])

        if ($resource.type -ieq 'Microsoft.Resources/deployments' -or -not $seen.Add($entry['id'])) {

            throw [AvmConfigurationException]::new('Cleanup resource IDs must be distinct non-deployment resources.')

        }

        if (($entry['postProcessed'] -and -not $entry['removed']) -or

            (($entry['removed'] -or $entry['postProcessed']) -and -not $entry['metadataCaptured'])) {

            throw [AvmConfigurationException]::new('Cleanup resource status is inconsistent.')

        }

        $managedIds = [System.Collections.Generic.List[string]]::new()

        foreach ($managedId in $entry['managedResourceGroupIds']) {

            if ($managedId -isnot [string] -or

                (ConvertTo-AvmBicepCleanupResource -ResourceIds @($managedId)).type -ine 'Microsoft.Resources/resourceGroups' -or

                $resource.type -ine 'Microsoft.Databricks/workspaces' -or

                $managedId.Split('/')[2] -ine $entry['id'].Split('/')[2]) {

                throw [AvmConfigurationException]::new('Invalid Databricks managed group in cleanup state.')

            }

            $managedIds.Add($managedId)

        }

        if (-not [string]::IsNullOrEmpty($entry['originalSoftDeleteFeatureState']) -and

            $resource.type -ine 'Microsoft.RecoveryServices/vaults/backupFabrics/protectionContainers/protectedItems') {

            throw [AvmConfigurationException]::new('Unexpected recovery-vault setting in cleanup state.')

        }

        $resources.Add([ordered]@{

                id                             = $entry['id']

                type                           = $resource.type

                removed                        = $entry['removed']

                postProcessed                  = $entry['postProcessed']

                metadataCaptured               = $entry['metadataCaptured']

                managedResourceGroupIds        = $managedIds.ToArray()

                originalSoftDeleteFeatureState = $entry['originalSoftDeleteFeatureState']

            })

    }

    if ($State['status'] -ceq 'Complete' -and

        @($resources | Where-Object { -not $_['postProcessed'] }).Count -gt 0) {

        throw [AvmConfigurationException]::new('Complete cleanup state cannot contain unfinished resources.')

    }

    if (($deletionRecords -gt 0 -and @($resources | Where-Object { -not $_['postProcessed'] }).Count -gt 0) -or

        ($State['status'] -ceq 'Complete' -and $pendingDeletions -gt 0)) {

        throw [AvmConfigurationException]::new('Deployment deletion progress requires removed resources and confirmed completion.')

    }

    $document = [ordered]@{

        schemaVersion       = $State['schemaVersion']

        runId               = $State['runId']

        tenantId            = $State['tenantId']

        subscriptionId      = $State['subscriptionId']

        environment         = $State['environment']

        status              = $State['status']

        deployments         = $deployments.ToArray()

        ownedResourceGroups = $groups.ToArray()

        resources           = $resources.ToArray()

    }

    if ($State.Contains('isolationBoundary')) {

        if ($State['schemaVersion'] -ne 2 -or $State['isolationBoundary'] -cnotin @('Empty', 'OwnedResourceGroup') -or

            -not $State.Contains('case') -or

            ($State['isolationBoundary'] -ceq 'OwnedResourceGroup' -and $State['case']['scope'] -cne 'group') -or

            @($groups | Where-Object { $_['runId'] -cne $State['runId'] -or

                    $_['id'].Split('/')[2] -ine $State['subscriptionId'] }).Count -gt 0) {

            throw [AvmConfigurationException]::new('Invalid verified resource isolation boundary.')

        }

        $document['isolationBoundary'] = $State['isolationBoundary']

        Assert-AvmBicepIsolationBoundary -State $State -ResourceIds @(

            @($deployments | ForEach-Object { $_['id'] }) + @($resources | ForEach-Object { $_['id'] })

        )

    }

    if ($State.Contains('attempts') -and -not $State.Contains('case')) {

        throw [AvmConfigurationException]::new('A Bicep attempt journal requires its case metadata.')

    }

    if ($State.Contains('case')) {

        if ($State['case'] -isnot [System.Collections.IDictionary]) {

            throw [AvmConfigurationException]::new('Cleanup case metadata must be an object.')

        }

        $document['case'] = ConvertTo-AvmBicepCleanupCase -Case $State['case']

        $case = $document['case']

        if ($State.Contains('attempts')) {

            $document['attempts'] = @(ConvertTo-AvmBicepAttemptJournal -State $State)

        }

        else {

            foreach ($entry in $deployments) {

                $expectedId = Get-AvmBicepScopedDeploymentId -Scope $case['scope'] `

                    -SubscriptionId $State['subscriptionId'] -ResourceGroupName $case['resourceGroupName'] `

                    -ManagementGroupId $case['managementGroupId'] -DeploymentName $entry['id'].Split('/')[-1]

                if ($entry['id'] -ine $expectedId -or

                    $entry['id'].Split('/')[-1] -cnotmatch ('^avm-e2e-' + $State['runId'] + '-t[1-3]$')) {

                    throw [AvmConfigurationException]::new('Cleanup deployment does not belong to its recorded case.')

                }

            }

        }

    }

    return $document

}

# SIG # Begin signature block

# MIInKAYJKoZIhvcNAQcCoIInGTCCJxUCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBrNQb8Ap42NHSx

# b19/YRvHtG/EO3zOD5q1vy6KIqnYQaCCDLowggX1MIID3aADAgECAhMzAAACHU0Z

# yE7XD1dIAAAAAAIdMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD

# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQzWhcNMjcwNDE1MTg1

# OTQzWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD

# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB

# DwAwggEKAoIBAQDQvewXxx9gZZFC6Ys1WBay8BJ8kGA4JQnH5CMafqOASlTpK9H8

# o5ZXTXt0caVQTNMUPt445wXYD+dFtaKWTwDn1I52oUSrC9vJin1Gsqt+zyKJL5Dg

# 3eQXbQNR61DmMy20GLTIO3SFed9Rfi/ophgCLGFLDR3r0KvHjwMb/jYWS0celV/4

# Lz27LfAekm8v9E5IXaeiXbAUYZKK090n4CVl3JBtbN+9DtI9SNu/yjvozW52/u7R

# X/Ttpa/KDlpuokZ+Zcbvmtd9ur9gFLvZzh41o9MsE/clQtdaFWGvuo6Jua/ntpgk

# ey3E5/vBFe+MJPG6phdnuo6r57ZudCudiI1bAgMBAAGjggGbMIIBlzAOBgNVHQ8B

# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O

# BBYEFH6QuMwqcPG0hQlQ6c5jCtTTLrVeMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQL

# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAxMis1MDc1NTkw

# HwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEwYAYDVR0fBFkwVzBVoFOg

# UYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0

# JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNybDBtBggrBgEFBQcBAQRh

# MF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# Y2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy

# dDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQBKTbYOjzwTG/DXGaz9

# s6+fQeaTtDcFmMY+5UyVFCyj7Pv+5i37qfX8lSL/tBIfYQfWsMuBQlfZurJD6r4H

# VJ2CeH+1fgiq8dcHdVKoZ3Sa2qXoX3cq9iS8cVb06B7+5/XJ7I0OxHH9fDsvJ3T3

# w5V/ZtAIFmLrl+P0CtG+92uzRsn0nTbdFjOkLMLWPLAU3THohKRlSEMgFJpPkm5n

# 5UAZ35xX6FWCrDLsSKb555bTifwa8mJBwdlof0bmfYidH+dxZ1FdDxvLnNl9zeKs

# A4kejaaIqqIPguhwAti5Ql7BlTNoJNwxCvBmqW2MQLnCkYN/VVUsR3V2x/rcTNzo

# Bf/Z/SpROvdaA2ZOOd1uioXJt3tdLQ7vHpqpib0KfWr/FWXW10q38VxfCnRQBqzb

# SuztR7nEMuzX7Ck+B/XaPDXd1qh72+QYyB0Z2VzWmO9zsnb9Uq/dwu8LGeQqnyu6

# 7SDGACvnXii2fb9+US492VTnXSnFKyqwgzUyFMtZK1/sHYTv6bG4TtQUygQxTN+Z

# V+aJIlKO2MqZ7bKrAnOzS9m6NgoTdWOq11bTOZwKlIEV/EhV9SWkDmdpR/hPPT2v

# 6TEj4F8PT/zHjRezIU5c/DGlt/VhY/pK0XkJtEyMmmS1BMtjU/rqBZVMIm3dnxQs

# /TBByr+Cf8Z1r7aifQVQ+WSqzjCCBr0wggSloAMCAQICEzMAAAA5O7Y3Gb8GHWcA

# AAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX

# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg

# Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl

# IEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoXDTM2MDMyMjIyMTMwNFow

# VzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEo

# MCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAyNDCCAiIwDQYJ

# KoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeqlRYHNa265v4IY9fH8TKh

# emHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo0dtS/EW6I/yEL/bLSY8h

# KpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATvQVL4tcf03aTycsz8QeCd

# M0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a1uv1zerOYMnsneRRwCbp

# yW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1FyQfK0fVkaya8SmVHQ/t

# Of23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfOGSWHIIV4YrTJTT6PNty5

# REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7ttOu1bVnXfHaqPYl2rPs

# 20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJuz2MXMCt7iw7lFPG9LXK

# Gjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxSCwyoGIq0PhaA7Y+VPct5

# pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOmVQop36wUVUYklUy++vDW

# eEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3SkE/xIkgpfl22MM1itkZ

# 35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8EBAMCAYYwEAYJKwYBBAGC

# NxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPXLQaUEggxMBkGCSsGAQQB

# gjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU

# ci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2Ny

# bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAx

# MV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx

# MV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOCAgEAFJQfOChP7onn6fLI

# MKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D5W4wMwYeLystcEqfkjz4

# NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBYnbu0+THSuVHTe0VTTPVh

# ily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSIvgn0JksVBVMYVI5QFu/q

# hnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6aR9y34aiM1qmxaxBi6OU

# nyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4wPKC5OmHm1DQIt/MNokbb

# H3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7RTX8AdBPo0I6OEojf39z

# uFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK/fg8B2qjW88MT/WF5V5u

# vZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSKYBv0VisCzfxgeU+dquXW

# 9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkwYTu/9dLeH2pDqeJZAABV

# DWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVTQl0v4q8J/AUmQN5W4n10

# 1cY2L4A7GTQG1h32HHAvfQESWP0xghnEMIIZwAIBATBuMFcxCzAJBgNVBAYTAlVT

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv

# c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w

# DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ

# KoZIhvcNAQkEMSIEIKA5Ol7UljNwetpmO5sGKVK+ZTTSQ8pxMaHU0rhPsJaiMEIG

# CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEATqD9o3DrbpEEbbR5

# PCR5iqd0Q4uAw/YnNy0GrPEqsu5pqd3f1Qmq0q3MDZbw9S4x0nuA5NKR3lG/QfAi

# 7X6ZR88NHEZyNyLekdm1cgvnTproEsEXf+upODjTzCHmB3r0p2L+ukPwKxUDRVmZ

# yU4COD3cv9aSB+zHEilcfPiyHz3KjnsfkT2C60lft1rd7lvYSEGETM5CZdckAgMg

# PAHEZV4a1FOZFijsvLukFwdJunjT6LYASb7B/xu3k4qDgcXKFBYFt0/01BzPJQGa

# cj7sPLxFY7X4sNzJp5Je0ECWFNH2KPrv5TperM8k1B2mae8tvn93pqhAd9EPTTag

# i0jNjaGCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCCF3wGCSqGSIb3DQEHAqCCF20w

# ghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9

# MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCDMRytUexSq5EYd

# EIdZ2rmIifLaCpSxiilB4cN1nSK2nwIGaqpsgDQdGBMyMDI2MTAyMjIyMjU1OC42

# MjJaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScw

# JQYDVQQLEx5uU2hpZWxkIFRTUyBFU046OTYwMC0wNUUwLUQ5NDcxJTAjBgNVBAMT

# HE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghHqMIIHIDCCBQigAwIBAgIT

# MwAAAiY1tD5nQ5P2HwABAAACJjANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNjAyMTkxOTQwMDJaFw0yNzA1MTcxOTQwMDJa

# MIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL

# ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxk

# IFRTUyBFU046OTYwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC/

# /w+ZZIL5RFFpVI8D3ZyuNu8IzcAEOD30OLYjh337rXjcrIlOSzpJc4ZeUxEyli6x

# 6F6zm4NR8dbPb9diDp/hOUzHWGxiA1Z3RXKBb/4F/ojyvN43SEGWqSfVc3I3BlsY

# T35ecVAJ9kVf90YOv29tFjJBBZkYvrT/DwwyRLscOyP4p+9/lyJjD+ULs3YXBhVr

# fZ+MbQB+BYKLqRvBKbj/wR9akNrMxQINoGaD5jZO/N/nSsmG2P1zv/cv4gSoMBnW

# eQIBkjd2I5w1DeXupp2vSiNmR5sA2ZkBK3yiQWaJvRxODlkfiyHk9Mkk/TrYTjmj

# PCbhe+uqhHNRy8UlbOvWsCq0tRtUykHv39DgqAfJNrE8OSt835rBzDprrcAhwmgf

# hoVi4AKeqwikY0nUa48K0Qy80XT4fiEA3ExEZNaRFo9Nq/GwbfgqKqGmc9xhKuRF

# cjtua4KHZvnAvpWgEFSOCkovXs/BcLnkEHM9xZ8iUag5CyhNqXYYE/z0pcXdYaNI

# kQ68EWmuvLm7g9oofV2vOm5GVNoghnkWG6nGPo/JwEgmA9oSS0EfvFRMWPA/gpSv

# F3shArKHnaEpVSSi3DNbyiuYiEs9Ko0IkZc8xKFeQRaqGRxrB+2r/7B3X81Tps99

# KhFwg+wD87od22F2MUg1x7twt3gaVnFk0IZIwUPCGwIDAQABo4IBSTCCAUUwHQYD

# VR0OBBYEFF3hn9fYJN2Y/Z9LVbBPIxAzXHsQMB8GA1UdIwQYMBaAFJ+nFV0AXmJd

# g/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El

# MjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6

# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGlt

# ZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0l

# AQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUA

# A4ICAQA2Ux0tr9sYCjsq0FRyiVpx15OurNXv6Qk7iX+ArVPlz3w4tqjcTNm1dt3t

# Tua2wJMpJhPH8n7UXhmT98d5Du44Ll4adnse4SQfVg3QL6aRkXHnJUn8y9iftB/P

# y22n9xnwPFfj3QlDOSgLuHleu97U0iH2ZaluYabWXJihdiYpK8cPHFlqZOAiot0+

# GD8dP+RMuvpxt/F2LmYelpoZwriiFOUmlxEUV7xJHyZZlDquskeyuq01DTv91N4q

# M8cfPPhl/2pc4HeMf/nd2HouifJbDQFNd4WPhLzn0Sy3u1Zh3+S3tjQdqN+dyw60

# RaV+RXCoOLgFZ3MAg/GoDl+fvb5hy/1a71ctX8wEad1Pf6def2pqfl3wFc++hkF8

# DXXTZofJN4YVaN3InwbAGQDDkNK4lqecCixxmSKwidPynGeE5OtvNoK1pkLsm/i8

# F1RjGczZ/kSF2VDkqG866iQ+jVbGOQ6Du3eyyFcFKZoDJ4B5mEAS9aT2SKqllLey

# bOboH6r67siR5B/2Hnu7+KYuYZy0BEadtA6ngG4cnSR9JsrkhhsKmb11ujqwgJyN

# x92MsoGGwNgN1aI0QID8CsjCFwpfmMzlA44xHKYv3hmjxeqBS4uU5rQeiAnVgpJe

# aVGKm/lzPDtnppGV+7XhRp5b1ZxT/Z7Xxc+I7H7/jCtQDZoaZTCCB3EwggVZoAMC

# AQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m

# dCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIy

# NVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAw

# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9

# DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2

# Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N

# 7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXc

# ag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJ

# j361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjk

# lqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37Zy

# L9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M

# 269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLX

# pyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLU

# HMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode

# 2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEA

# ATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYE

# FJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEB

# MEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# RG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEE

# AYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB

# /zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEug

# SaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9N

# aWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsG

# AQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jv

# b0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt

# 4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsP

# MeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++

# Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9

# QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2

# wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aR

# AfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5z

# bcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nx

# t67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3

# Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+AN

# uOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/Z

# cGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNNMIICNQIBATCB+aGB0aSBzjCB

# yzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMc

# TWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBU

# U1MgRVNOOjk2MDAtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1T

# dGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQCi/fMxFtkqr7XMXdsRyWU0lSKH

# Z6CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3

# DQEBCwUAAgUA7oUDhzAiGA8yMDI2MTAyMjIxNDk1OVoYDzIwMjYxMDIzMjE0OTU5

# WjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDuhQOHAgEAMAcCAQACAgy/MAcCAQAC

# AhHmMAoCBQDuhlUHAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKg

# CjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAJxZsxo+

# QS7ikxv/tUV8GG4BDcJgDvZGUyA13fjRiajGZeonNzBWiQckEwy2MhzoSOB0bjRl

# SpgCOtxDZ142lfWXiXwoWyrBWpPVcswK88QVazHlkowTa5NVma+DzYpuGRYG3hF0

# 176ZQ3kDaRpHqOnIj8tgTbhC2YAJW9usDe4ti5UFehwO1HAkBR7jTV3SPmsu6dmO

# KzDgBvyE+SNV5kz18bPfr0cnv9WmRvlRJcpHYf2RRWHypKIpNp+mHanb1LeNSbzA

# kMFnYqwDaXxAW7vhlhoxmlRr1GZhbMj0GIqjnHZxqcGNxefane2gmeC8AKqjEEyq

# OukwWJ4R6tqUX50xggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UE

# CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z

# b2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQ

# Q0EgMjAxMAITMwAAAiY1tD5nQ5P2HwABAAACJjANBglghkgBZQMEAgEFAKCCAUow

# GgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCC2OFIN

# DJ4iLSHGyWGwSs2oCY6lQYNcPu1R3aSihLMlDzCB+gYLKoZIhvcNAQkQAi8xgeow

# gecwgeQwgb0EIMwyXGFnTNsZRBrs6GN/BbV0okaNP3VBYqLFjUsFnbgqMIGYMIGA

# pH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAImNbQ+Z0OT9h8A

# AQAAAiYwIgQgnMMiHCudMXDeOlQHdyKnb4yY02ZJ5727lrvNSsHl404wDQYJKoZI

# hvcNAQELBQAEggIAVHR8hINbbQmxV9ZGUmBSKGHWhbwp1Gy74ZMPPrNbybZjxdRm

# xsluLNCRsnuXIrcfeTJ80PjpgpO7ganpb8iAsLY22G6tTa/iCbvjJFiQJj5zEcC0

# 3euFQGD0VBsoIAcpsIGiY0w/3WQDXHQYTdviMLJkUBM4qAQV+3nxW6gJkcU/Qj0S

# hLMEhiEL/bs6/m5O6hfVLesrjjPX+u+RlgzaYag3dQTxqs8k4B3BRSQFBa/L/L/u

# zjth8NzhsnHTEPSSSHJkA4uFvfvLzSfjpIxeswm50JJpTzXAcBB7PU4QQOmNfyqS

# YMimI3Qwse6e+W39P/KacoDnBqxORjqyPyoniv48mhgjDyMqJSwLE6UqdgF72p/j

# T73iVir4+sOk2mqQUeSpexupAYXn72NeZZl8a3QeEsUDJFkoreLzoQy+5HkHZ0mi

# jSLJIbWX9CxQZfRivJK5A98RFECwd0iEzQe5H2xnkmFNzAIUCFCaq45YY5jX+W+V

# EIk66qSf9RQFjwqa5G6JCrAHV6XHkZK1paqeqdHIGhiclEDh+OY2p7CMP5UacmS5

# Lg+UvZRgLM2t6sXwSkQAqRAbH4H+ytfHSQm11qYX1rdJpXuBXBCTSvZa0fGQtBxo

# M0UmaC15hAdfdEkjcPFAaOeNtXAET5cgX/JyxiSTI7eHVe42udZpyaN2WPQ=

# SIG # End signature block