Invoke-AuvikRequest

SYNOPSIS

Makes an API request

SYNTAX

Invoke-AuvikRequest [[-method] <String>] [-resource_Uri] <String> [[-uri_Filter] <Hashtable>]
 [[-data] <Hashtable>] [-allPages] [<CommonParameters>]

DESCRIPTION

The Invoke-AuvikRequest cmdlet invokes an API request to Auvik API.

This is an internal function that is used by all public functions

As of 2023-08 the Auvik v1 API only supports GET requests

EXAMPLES

EXAMPLE 1

Invoke-AuvikRequest -method GET -resource_Uri '/account' -uri_Filter $uri_Filter

Invoke a rest method against the defined resource using any of the provided parameters

Example: Name Value —- —– Method GET Uri https://auvikapi.us1.my.auvik.com/v1/account?accountId=12345&details=True Headers {Authorization = Bearer 123456789} Body

PARAMETERS

-method

Defines the type of API method to use

Allowed values: ‘GET’

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: GET
Accept pipeline input: False
Accept wildcard characters: False

-resource_Uri

Defines the resource uri (url) to use when creating the API call

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-uri_Filter

Used with the internal function [ ConvertTo-AuvikQueryString ] to combine a functions parameters with the resource_Uri parameter.

This allows for the full uri query to occur

The full resource path is made with the following data $Auvik_Base_URI + $resource_Uri + ConvertTo-AuvikQueryString

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-data

Place holder parameter to use when other methods are supported by the Auvik v1 API

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-allPages

Returns all items from an endpoint

When using this parameter there is no need to use either the page or perPage parameters

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

N\A

RELATED LINKS

https://celerium.github.io/Auvik-PowerShellWrapper/site/Internal/Invoke-AuvikRequest.html