Enhancements

[techthoughts2]

Pull Request

Description

Description of changes:

• Adjusted error control and error return behavior - potential breaking change

  • Previous behavior: any error (API error, validation error [size requirements, extension verification, etc.] would return a Boolean value: $false)
    • This behavior wasn't especially helpful and did not provide a lot of insight into what went wrong
    • This behavior did not allow you to take any meaningful action if the API endpoint returned a certain error condition
  • New behavior:
    • Any validation error with throw for the failed validation
    • Any API error will return as a PSObject containing the API exception

      • Example 1:

        ok      error_code description
        --      ---------- -----------
        False          401 Unauthorized

      • Example 2:

        ok      error_code description                       parameters
        --      ---------- -----------                       ----------
        False          429 Too Many Requests: retry after 10 @{retry_after=10}

• General code style adjustments throughout the code-base

• Build/dev improvements

  • Bumped module versions to latest available
  • Updated Pester tests from Pester 4 to Pester 5
  • Updated CodeBuild to use latest version of PowerShell 7
  • Added new functionality to tasks.json
  • Updated infra tests to have API back off capability

License

By submitting this pull request, I confirm that my contribution is made under the terms of the MIT license.