Akamai REST method

Synopsis

Send an authorized HTTPS request to an Akamai RESTful web service.

Syntax

Invoke-AkamaiRestMethod [[-Method] <String>] [-Path] <String> [[-QueryParameters] <Hashtable>] [[-AdditionalHeaders] <Hashtable>] [[-Body] <Object>] [[-InputFile] <String>] [[-OutputFile] <String>] [[-MaxBody] <String>] [-IncludeResponseHeaders] [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Constructs a call to Invoke-RestMethod from the given -Path, -Method, and other additional parameters and adds necessary authorization details retrieved from Get-AkamaiCredentials.

The response is formatted into a PSCustomObject of the response body.

Parameters

‑AccountSwitchKey

An account credential key that lets you move between accounts when using an API client enabled for multiple accounts. To find account switch keys, use Get-AccountSwitchKey.

‑AdditionalHeaders

An additional headers in a hashtable.

‑Body

A request body, either as a PSCustomObject or a string.

‑EdgeRCFile

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.

‑IncludeResponseHeaders

When the switch parameter is present, this includes the response header data in the output.

‑InputFile

File to send with upload HTTP requests.

‑MaxBody

Maximum body size with which to calculate the EdgeGrid signature. Defaults to 128kb, and should not be changed unless your API client has a lower value.

‑Method

Request method.

‑OutputFile

The file to write response data to.

‑Path
Required

Your request path.

‑QueryParameters

The query parameters in a hashtable.

‑Section

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.

Related Links

User Guide: Overview