Data stream

Update-DataStream

Synopsis

Patch a stream.

Syntax

Update-DataStream [-StreamType <String>] [-StreamID] <Int32> [-Body] <Object> [-Activate] [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Updates selected details of an existing stream.

Running this operation using JSON Patch syntax creates a stream version that replaces the current one.

Currently you can patch a stream using only the REPLACE operation.

When updating configuration objects such as destination or deliveryConfiguration, pass a complete object to avoid overwriting current details with default values for omitted members such as tags, uploadFilePrefix, and uploadFileSuffix.

Note that only active streams collect and send logs to their destinations.

You need to set the Activate switch parameter while patching active streams, and optionally for inactive streams if you want to activate them upon request.

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.

‑Activate

Add this switch to activate the stream at the time of the request. When you edit a stream that is active, you need to disable this switch.

‑Body
Required

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

‑EdgeRCFile

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

‑Section

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

‑StreamID
Required

Your stream's ID.

Related Links


Did this page help you?