ALZ

7.1.1

Private/Shared/Invoke-HttpRequestWithRetry.ps1

                                ####################################

# Invoke-HttpRequestWithRetry.ps1  #

####################################

# Version: 0.1.0

<#

.SYNOPSIS

Invokes an HTTP request with automatic retry logic for transient errors.

.DESCRIPTION

Makes HTTP requests using Invoke-WebRequest or Invoke-RestMethod with

automatic retry for transient HTTP errors (408, 429, 500, 502, 503, 504).

.PARAMETER Uri

The URI to send the request to.

.PARAMETER Method

The HTTP method for the request. Defaults to GET.

.PARAMETER MaxRetryCount

Maximum number of retries for transient errors. Defaults to 10.

.PARAMETER RetryIntervalSeconds

Seconds to wait between retries. Defaults to 3.

.PARAMETER OutFile

If specified, downloads the response to this file path using Invoke-WebRequest.

.PARAMETER SkipHttpErrorCheck

If specified, does not throw on HTTP error status codes.

Returns the response object without error.

.PARAMETER TimeoutSec

Timeout in seconds for the HTTP request. If not specified, uses the default.

.PARAMETER Body

The body of the request.

.PARAMETER ContentType

The content type of the request body.

.PARAMETER Headers

Additional headers to include in the request.

.PARAMETER ReturnStatusCode

If specified alongside SkipHttpErrorCheck, returns a hashtable with

Result and StatusCode properties (similar to Invoke-GitHubApiRequest).

.EXAMPLE

Invoke-HttpRequestWithRetry -Uri "https://api.releases.hashicorp.com/v1/releases/terraform?limit=20"

.EXAMPLE

Invoke-HttpRequestWithRetry -Uri "https://example.com/file.zip" -OutFile "./file.zip"

.EXAMPLE

Invoke-HttpRequestWithRetry -Uri "https://example.com" -Method Head -SkipHttpErrorCheck -MaxRetryCount 0

.NOTES

# Release notes 25/03/2026 - V0.1.0:

- Initial release.

#>

function Invoke-HttpRequestWithRetry {

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $true, Position = 1, HelpMessage = "The URI to send the request to.")]

        [string] $Uri,

        [Parameter(Mandatory = $false, HelpMessage = "The HTTP method for the request.")]

        [string] $Method = "GET",

        [Parameter(Mandatory = $false, HelpMessage = "Maximum number of retries for transient errors.")]

        [int] $MaxRetryCount = 10,

        [Parameter(Mandatory = $false, HelpMessage = "Seconds to wait between retries.")]

        [int] $RetryIntervalSeconds = 3,

        [Parameter(Mandatory = $false, HelpMessage = "If specified, downloads the response to this file path.")]

        [string] $OutFile,

        [Parameter(Mandatory = $false, HelpMessage = "If specified, does not throw on HTTP error status codes.")]

        [switch] $SkipHttpErrorCheck,

        [Parameter(Mandatory = $false, HelpMessage = "Timeout in seconds for the HTTP request.")]

        [int] $TimeoutSec,

        [Parameter(Mandatory = $false, HelpMessage = "The body of the request.")]

        [object] $Body,

        [Parameter(Mandatory = $false, HelpMessage = "The content type of the request body.")]

        [string] $ContentType,

        [Parameter(Mandatory = $false, HelpMessage = "Additional headers to include in the request.")]

        [hashtable] $Headers,

        [Parameter(Mandatory = $false, HelpMessage = "If specified, returns a hashtable with Result and StatusCode.")]

        [switch] $ReturnStatusCode

    )

    $isDownload = -not [string]::IsNullOrEmpty($OutFile)

    $transientStatusCodes = @(408, 429, 500, 502, 503, 504)

    $maxAttempts = $MaxRetryCount + 1

    # Build common parameters

    $commonParams = @{

        Uri         = $Uri

        Method      = $Method

        ErrorAction = "Stop"

    }

    if ($PSBoundParameters.ContainsKey("TimeoutSec")) {

        $commonParams["TimeoutSec"] = $TimeoutSec

    }

    if ($PSBoundParameters.ContainsKey("Body")) {

        $commonParams["Body"] = $Body

    }

    if ($PSBoundParameters.ContainsKey("ContentType")) {

        $commonParams["ContentType"] = $ContentType

    }

    if ($PSBoundParameters.ContainsKey("Headers")) {

        $commonParams["Headers"] = $Headers

    }

    Write-Verbose "HTTP $Method $Uri (MaxRetries=$MaxRetryCount, RetryInterval=${RetryIntervalSeconds}s$(if ($PSBoundParameters.ContainsKey('TimeoutSec')) { ", Timeout=${TimeoutSec}s" })$(if ($isDownload) { ", OutFile=$OutFile" }))"

    for ($attempt = 1; $attempt -le $maxAttempts; $attempt++) {

        Write-Verbose "HTTP $Method $Uri - Attempt $attempt of $maxAttempts"

        try {

            if ($isDownload) {

                Invoke-WebRequest @commonParams -OutFile $OutFile

                Write-Verbose "HTTP $Method $Uri - Download complete (saved to $OutFile)"

                return

            }

            if ($SkipHttpErrorCheck) {

                $response = Invoke-WebRequest @commonParams -SkipHttpErrorCheck -UseBasicParsing

                $code = [int]$response.StatusCode

                if ($code -in $transientStatusCodes -and $attempt -lt $maxAttempts) {

                    Write-Verbose "HTTP $Method $Uri - Transient status $code on attempt $attempt"

                    Write-ToConsoleLog "Request to $Uri returned status $code (attempt $attempt of $maxAttempts). Retrying in $RetryIntervalSeconds seconds..." -IsWarning

                    Start-Sleep -Seconds $RetryIntervalSeconds

                    continue

                }

                Write-Verbose "HTTP $Method $Uri - Completed with status $code"

                if ($ReturnStatusCode) {

                    return @{

                        Result     = $response

                        StatusCode = $code

                    }

                }

                return $response

            }

            return (Invoke-WebRequest @commonParams -UseBasicParsing)

        } catch {

            $responseCode = $null

            if ($_.Exception.Response) {

                $responseCode = [int]$_.Exception.Response.StatusCode

            }

            $isTransient = $responseCode -in $transientStatusCodes

            Write-Verbose "HTTP $Method $Uri - Error on attempt ${attempt}: Status=$responseCode, Message=$($_.Exception.Message)"

            if ($isTransient -and $attempt -lt $maxAttempts) {

                Write-ToConsoleLog "Request to $Uri failed with status $responseCode (attempt $attempt of $maxAttempts). Retrying in $RetryIntervalSeconds seconds..." -IsWarning

                Start-Sleep -Seconds $RetryIntervalSeconds

            } else {

                $errorDetails = "HTTP $Method $Uri failed after $attempt attempt(s)."

                if ($null -ne $responseCode) {

                    $errorDetails += " Status code: $responseCode."

                }

                $errorDetails += " Error: $($_.Exception.Message)"

                if ($_.Exception.Response) {

                    try {

                        $stream = $_.Exception.Response.GetResponseStream()

                        if ($null -ne $stream) {

                            $reader = [System.IO.StreamReader]::new($stream)

                            $responseBody = $reader.ReadToEnd()

                            $reader.Dispose()

                            if (-not [string]::IsNullOrWhiteSpace($responseBody)) {

                                $errorDetails += " Response body: $responseBody"

                            }

                        }

                    } catch {

                        Write-Verbose "Failed to read response body: $($_.Exception.Message)"

                    }

                }

                Write-ToConsoleLog $errorDetails -IsError

                throw

            }

        }

    }

}

# SIG # Begin signature block

# MIIoVAYJKoZIhvcNAQcCoIIoRTCCKEECAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAV5SiQUYZ5GyjH

# g6T7wEEFwzFCKRIHtIG0vHL5FCDP9qCCDYUwggYDMIID66ADAgECAhMzAAAEhJji

# EuB4ozFdAAAAAASEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjUwNjE5MTgyMTM1WhcNMjYwNjE3MTgyMTM1WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDtekqMKDnzfsyc1T1QpHfFtr+rkir8ldzLPKmMXbRDouVXAsvBfd6E82tPj4Yz

# aSluGDQoX3NpMKooKeVFjjNRq37yyT/h1QTLMB8dpmsZ/70UM+U/sYxvt1PWWxLj

# MNIXqzB8PjG6i7H2YFgk4YOhfGSekvnzW13dLAtfjD0wiwREPvCNlilRz7XoFde5

# KO01eFiWeteh48qUOqUaAkIznC4XB3sFd1LWUmupXHK05QfJSmnei9qZJBYTt8Zh

# ArGDh7nQn+Y1jOA3oBiCUJ4n1CMaWdDhrgdMuu026oWAbfC3prqkUn8LWp28H+2S

# LetNG5KQZZwvy3Zcn7+PQGl5AgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUBN/0b6Fh6nMdE4FAxYG9kWCpbYUw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwNTM2MjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AGLQps1XU4RTcoDIDLP6QG3NnRE3p/WSMp61Cs8Z+JUv3xJWGtBzYmCINmHVFv6i

# 8pYF/e79FNK6P1oKjduxqHSicBdg8Mj0k8kDFA/0eU26bPBRQUIaiWrhsDOrXWdL

# m7Zmu516oQoUWcINs4jBfjDEVV4bmgQYfe+4/MUJwQJ9h6mfE+kcCP4HlP4ChIQB

# UHoSymakcTBvZw+Qst7sbdt5KnQKkSEN01CzPG1awClCI6zLKf/vKIwnqHw/+Wvc

# Ar7gwKlWNmLwTNi807r9rWsXQep1Q8YMkIuGmZ0a1qCd3GuOkSRznz2/0ojeZVYh

# ZyohCQi1Bs+xfRkv/fy0HfV3mNyO22dFUvHzBZgqE5FbGjmUnrSr1x8lCrK+s4A+

# bOGp2IejOphWoZEPGOco/HEznZ5Lk6w6W+E2Jy3PHoFE0Y8TtkSE4/80Y2lBJhLj

# 27d8ueJ8IdQhSpL/WzTjjnuYH7Dx5o9pWdIGSaFNYuSqOYxrVW7N4AEQVRDZeqDc

# fqPG3O6r5SNsxXbd71DCIQURtUKss53ON+vrlV0rjiKBIdwvMNLQ9zK0jy77owDy

# XXoYkQxakN2uFIBO1UNAvCYXjs4rw3SRmBX9qiZ5ENxcn/pLMkiyb68QdwHUXz+1

# fI6ea3/jjpNPz6Dlc/RMcXIWeMMkhup/XEbwu73U+uz/MIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGiUwghohAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAASEmOIS4HijMV0AAAAA

# BIQwDQYJYIZIAWUDBAIBBQCggbAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIFrt

# TtqKKezOKGq8qsfc0rnf8QIetYe8rfbvrtBuXHgeMEQGCisGAQQBgjcCAQwxNjA0

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEcgBpodHRwczovL3d3dy5taWNyb3NvZnQu

# Y29tIDANBgkqhkiG9w0BAQEFAASCAQAYxao9xMC+2FVjbxeLnbvUkzSqeLLzrGux

# UjZtJnQ5Vkd1v0y6IhOwmD5knKGE4OhnIAopKuk4fTWAw4FqZ7+J970LTCtSii2j

# Hn45/VL+q2gl9ZVl84iJUTBa51FeKFZ61tgMEYSRMwiZxPaZ6vd/eeZevoeHpKme

# OoDTx0yLuGOXnkuhijMsC65Oy/tHd4lbRRq1108pS2H3WAcONxqqLmHS5JodE7rz

# Xr62aQw2ov9Vyf0OZ5x+Qjoo7dE+jz7eVV3w4gO3/ilIjZlTSkmOvDmymYYpvpsU

# VjDX0D4xJA9f1lqzpiMQD67sN9xKczOwfQDqJ7VdMNyhwXVQ72GhoYIXrTCCF6kG

# CisGAQQBgjcDAwExgheZMIIXlQYJKoZIhvcNAQcCoIIXhjCCF4ICAQMxDzANBglg

# hkgBZQMEAgEFADCCAVoGCyqGSIb3DQEJEAEEoIIBSQSCAUUwggFBAgEBBgorBgEE

# AYRZCgMBMDEwDQYJYIZIAWUDBAIBBQAEIPxBjrttunPQaYiXjVdBg0lUhDEl9Vg1

# BePf1OKN7rBmAgZpvKAtmUsYEzIwMjYwNDEwMTcwMTE4Ljk5M1owBIACAfSggdmk

# gdYwgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH

# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNV

# BAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UE

# CxMeblNoaWVsZCBUU1MgRVNOOjUyMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNy

# b3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloIIR+zCCBygwggUQoAMCAQICEzMAAAIX

# cfsupa8BHeoAAQAAAhcwDQYJKoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3Rh

# bXAgUENBIDIwMTAwHhcNMjUwODE0MTg0ODIzWhcNMjYxMTEzMTg0ODIzWjCB0zEL

# MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v

# bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWlj

# cm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hp

# ZWxkIFRTUyBFU046NTIxQS0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC

# AQDAzzawTD7f29hHuIYIgUOdg2FEz4HMXYBiKrl1SlmkkU9GMJyKlDpFRsj5EBg1

# ECkTHHnKCtdtpa27C+qyoBVJZtT9bp95y6OMguQ+qf2meC1ZGR9CBtiC9pcAuXo9

# jbI4f1/vYwP7oDLFB6dKkAx1TNj9CT+O2Owd0VdUF762yGUiRIncZnDxVUqpODcZ

# kSXO3BslY22uEES+F/pqfEx6BAwk/u07z8EnshOzj8BXcPZu/x4eTzVj586ZDyZD

# rVYurbAi2+XMhPlvN6Ur0u8TJx/nHWVfEDATDlrt2lL4IpNqeG2/5DabB5sDJuN/

# 2KjiTjyy1NqrWu1ys6IPB12pWbVL17yHVOzNcXOMsu8T0SaOc18h7Cxj5EKFRoed

# jgUXDAkScS/8lLvqgdPSgZ3Lv4nrR8Y6XsDVShTICSGlvYGNr5LBIiIdtDgUPImI

# uVnp2tlnzgygnznYlLEzSEGMY7oVmU87yK43KTrzQOLxWdtI2kh0k34OGV6l5NQw

# EMeoKZ3SZVZFZk+bWm+C3L3dqw2382DqjibZ2eihY50zfIqwlpaPIeqJz2B9OtkE

# z48Jep5No7WgSJpD6HjDScdV1X5dK8jabXI3iKJuqObkc9oA7c4n46Y0t+01Wavh

# npTZPqkhwsHKygpwNS8KrJxePgL/6fUoUGkMZ0MzD2Ca7wIDAQABo4IBSTCCAUUw

# HQYDVR0OBBYEFFCs32OXA06h4TllCqcXnHxLVslDMB8GA1UdIwQYMBaAFJ+nFV0A

# XmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWlj

# cm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQ

# Q0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0

# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIw

# VGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYD

# VR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEB

# CwUAA4ICAQBGaAV2EHvEgAgcQSDkj/lL6DHrtpHpGJbxkDC0TebPyjR3Kf6kg/6W

# J01HUgpBDSv5GNiAj1xnqZu8DK+Hd7ar8FXyuMcTe530/JjKrfZ64WB1ne9fhvlB

# d49aWkEBit3OJHbusfPpbCkfl1mxLKltcMFtCRaQ2XqDzbJPLcBsFsoNcF3PFmwR

# q5o6mVq0rsSvh2GCUoF7HwlDZ0xKRJnB4I0Nep32v/1bZV1FmwMko/9dzhTJCVWx

# ugGi0q1gRJcWSPBHUdWwf5DQLr383kI/9OrdiAjW5vhv37cwkUpaElcJwkYVmRwv

# BSZjCgWDVcujsMsl0aOsgfWOwjY0VckVAd5/oB1F7URG9hB6q3KsG/Ei9H4//zcU

# 1jLPHTiKdRP1MXYDBM66oILpnrug3BHikQQnIAgRES+R2GON9ZyCyT+cZOV9qG81

# j9I4es1Eqjj0oOVxw3NEIlDJD4Pn2vv+p5s1LJA9N/Aj376MRjRD9RYpU0uGKjnk

# ZgGx4n32zs3OR3E6v1R+2nn3scSi9sDr2oaVnc6lQTcfVEEYNWn8W8za5dO6bwus

# yQ9fHkCn+Rs8BKwL2O72gwJ7YgRc7ZJ4PVoPciq8A50cUoeDW+ls9RBJZvqDbF8F

# XfTAVypo9iDNxvE9Y/Jmor5LyXvPDrho7mGYnt5DCgx9O7RVrLqvjzCCB3EwggVZ

# oAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jv

# c29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4

# MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw

# MTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvX

# JHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa

# /rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AK

# OG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rbo

# YiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIck

# w+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbni

# jYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F

# 37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZ

# fD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIz

# GHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR

# /bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1

# Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUC

# AwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0O

# BBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yD

# fQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lv

# cHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkr

# BgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUw

# AwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBN

# MEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0

# cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoG

# CCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01p

# Y1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9

# /Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5

# bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvf

# am++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn

# 0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlS

# dYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0

# j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5

# JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakUR

# R6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4

# O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVn

# K+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoI

# Yn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNWMIICPgIBATCCAQGhgdmk

# gdYwgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH

# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNV

# BAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UE

# CxMeblNoaWVsZCBUU1MgRVNOOjUyMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNy

# b3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQBpsoAVoq3a

# FpR2qQd8VjMDN+BIy6CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX

# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg

# Q29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAy

# MDEwMA0GCSqGSIb3DQEBCwUAAgUA7YN1NTAiGA8yMDI2MDQxMDEzMTAxM1oYDzIw

# MjYwNDExMTMxMDEzWjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDtg3U1AgEAMAcC

# AQACAheJMAcCAQACAhMOMAoCBQDthMa1AgEAMDYGCisGAQQBhFkKBAIxKDAmMAwG

# CisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQEL

# BQADggEBAJ5C1HTOUnXmLNgpLvHvEBosHUC21E6E4zKg3Ze7SRs8YFAk6kaKJW50

# sx5KwnUEt1RYdKIoMDh4DXQkB0I3FhEecu7PIeLUxKjnPN0nMsCy7yXeIptuCm94

# NYD1VH/Cqzd9HlQT0ERJhFLAjUZQAnXdStzvoDHYVb5IQ3OQzuHLvPjbgBsUgafW

# GI5EJoYzbzEv7pHoDbAmCw21JehykqHloWzwxGChE9qxMXRQYKPqYm8SHM4bZa/w

# piWQOxFr2rhyNIfJCJhFsO1k1JAFJuk38B+Gm4tLyGV8kAiRqzxU9kqcThA9WGYK

# sslf1B6mwwfOSjWx9ax3Je9D1kbiRtExggQNMIIECQIBATCBkzB8MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQg

# VGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAhdx+y6lrwEd6gABAAACFzANBglghkgB

# ZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3

# DQEJBDEiBCC8p5AJrnHKazl/9CCTRYkrn2kcIby/0A8lYt32Km47FzCB+gYLKoZI

# hvcNAQkQAi8xgeowgecwgeQwgb0EINDyUGA+XbfJnRLNRK3mmE4h6Ac/LCuQ3B6/

# F7aT5FpbMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0

# b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh

# dGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMA

# AAIXcfsupa8BHeoAAQAAAhcwIgQg44UVK0dn9Yb8Ghu4wKvN8B9k3YELf8GSVg0U

# MqUXXscwDQYJKoZIhvcNAQELBQAEggIAsO2qkjxcZrWg79CdZ0gudhDAM/GecAYO

# D1UInEKt5b99SOzYMrIsr0lAlbRbc4VF5lPsqKnm6nmfebH1QTptw7OaYuMS5EJD

# O4KekTjKcnQ7+DKudOb2aRNWsHr6kif0Sj3lFGBv+5Om/iv4RFrNwRMHuisefJLE

# RM5RQw40NYV+MXEAnRtpIsfgldW0p3PPi6qkzTrK1MM/l9Z6bcru4eEB+rQ/ufXW

# fYW3hzUZFd5MJqrG/Ow4MfcnAk8I/vriGMu2ICLg2BBmZZeGuYSnU68LYJnq23W0

# /l7C2b9Y4aP8YP/ILjwkJroSU076ba0T4i4rXEadbis06oS2iPRSHK0UKTOEUVhw

# CKQppl5rpzbqi+VxSyCn+EDkTlvgbMVfLg8ZcUUCH6ZPl10NaPfnB6OHIGlbbhZx

# vp8kLlq4ZW43BPpkNDmSfd1GlAZq/ejVUfsmbKMEMdhGFUgswsoOuhideL5LBHZU

# rTnC/8K3cJHjlxvFq1ZxT0EWC0xqG3AoKQSdfV4a4Euc0QNHvcCv+VE16IClA3mg

# Dv6xfuhv9YKakdNsX2dRMPtlbaCAJ6CA6M4fRLo2qHLK0cp4Xv9g4T0tLEKxpPUt

# GRR8m/DKJkoTRlqQJy9nCxFcPEAeJVa5THoIqNWIZU2lbjnvuvon7dGMuPH9iNDI

# bgRE8ySr3o8=

# SIG # End signature block