Private/Get-PSADOApi.ps1
|
Function Get-PSADOApi { <# .SYNOPSIS Function to connect with the Azure DevOps REST Api with the GET-method .DESCRIPTION This function uses invoke-restmethod to connect to the Azure DevOps REST API. It runs some errorhandling on the Results that are returned .PARAMETER Uri The Uri to connect to. .PARAMETER Header The Header that was created with New-Header .EXAMPLE Get-PSADOApi -Uri "https://dev.azure.com/$Organization/_apis/projects?api-version=5.0" -Header $Header .NOTES Private function Author: Barbara Forbes Module: Psado https://4bes.nl @Ba4bes #> Param( [Parameter()] [uri]$Uri, [Parameter()] [hashtable]$Header ) Try { $Result = Invoke-RestMethod -Uri $uri -Method Get -ContentType "application/json" -Headers $Header } Catch { $ErrorCode = $_.Exception.Response.StatusCode.value__ if ($ErrorCode -eq "401") { throw "Your request was unauthorized, status 401 was returned" } if ($ErrorCode -eq "400") { throw "Your request returned StatusCodede: 400, Bad Request" } else { throw "Request returned error: $($_.Exception.Response)" } } $autherror = $result | Select-String "Azure DevOps Services | Sign In" $resourceError = $result | Select-String "The resource cannot be found" if (-not [string]::IsNullOrEmpty($autherror)) { throw "Authentication failed. Please check Organization, username, token and permissions" } if (-not [string]::IsNullOrEmpty($resourceError)) { throw "Resource was not found, please check OrganizationName" } if ([string]::IsNullOrEmpty($Result)) { throw "Api did not respond" } if ($null -ne $Result.value) { Return ($Result.Value) } else { Return $Result } } |