Metadata trace

New-EdgeDiagnosticsMetadataTrace

Synopsis

Launch a metadata tracing request.

Syntax

New-EdgeDiagnosticsMetadataTrace -URL <String> [-HTTPMethod <String>] [-EdgeIP <String>] [-RequestHeaders <String>] [-SensitiveRequestHeaderKeys <String>] [-UseStaging] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
New-EdgeDiagnosticsMetadataTrace -URL <String> [-HTTPMethod <String>] [-MDTLocationID <String>] [-RequestHeaders <String>] [-SensitiveRequestHeaderKeys <String>] [-UseStaging] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
New-EdgeDiagnosticsMetadataTrace -Body <Object> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Launches an asynchronous request to trace metadata for a URL configured in Property Manager. The metadata tracing works for the current property version active either on the staging or production network.

To run the operation for a location, run the Get-EdgeDiagnosticsMetadataTraceLocations operation first to get the required values. If you don't provide a location ID or an edge server IP, then Edge Diagnostics runs the operation using a random location.

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.

‑Body
Conditionally required

Request body, either as a PSCustomObject or string. This parameter supports pipelining.

‑EdgeIP

An IP address that belongs to the edge server and you want to get the logs for.

‑EdgeRCFile

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

‑HTTPMethod

The HTTP method you want to use to run the operation, either HEAD, POST, or the default GET method.

‑MDTLocationID

The ID of an available location closest to your end users. To get this value, run Get-EdgeDiagnosticsMetadataTraceLocations first. For GET and HEAD, provide either this value or -EdgeIP.

‑RequestHeaders

Customized headers for the curl request in the format header: value. The request includes Akamai Pragma headers by default.

‑Section

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

‑SensitiveRequestHeaderKeys

Sensitive requestHeaders you don't want to store in the database after running the request.

‑URL
Conditionally required

A fully qualified URL you want to get the error statistics for. You need to provide either this value or a -CPCode.

‑UseStaging

Runs the request on the staging environment.

Related Links