external help file | Module Name | online version | schema |
---|---|---|---|
PSOpenAI-help.xml |
PSOpenAI |
2.0.0 |
Cancels a run that is in_progress.
Stop-ThreadRun
[-RunId] <String>
[-ThreadId] <String>
[-Wait]
[-Force]
[-PassThru]
[-TimeoutSec <Int32>]
[-MaxRetryCount <Int32>]
[-ApiBase <Uri>]
[-ApiKey <SecureString>]
[-Organization <String>]
[<CommonParameters>]
Cancels a run that is in_progress.
PS C:\> Stop-ThreadRun -RunId 'run_abc123' -ThreadId 'thread_abc123'
Cancels a run.
The ID of the run to cancel.
Type: String
Aliases: run_id
Required: True
Position: 0
Accept pipeline input: True (ByValue, ByPropertyName)
The ID of the thread to which this run belongs.
Type: String
Aliases: thread_id
Required: True
Position: 1
Accept pipeline input: True (ByPropertyName)
By default, This cmdlet does not wait completes cancellation.
When the switch specified, Waits for complete.
Type: SwitchParameter
Required: False
Position: Named
By default, This cmdlet only requests cancel a run that the status is queued
, in_progress
or requires_action
.
When the switch specified, Always requests cancel any status of the run.
Type: SwitchParameter
Required: False
Position: Named
By default, This cmdlet returns nothing. When the PassThru switch specified, This cmdlet returns Run object.
Type: SwitchParameter
Required: False
Position: Named
Specifies how long the request can be pending before it times out.
The default value is 0
(infinite).
Type: Int32
Required: False
Position: Named
Default value: 0
Number between 0
and 100
.
Specifies the maximum number of retries if the request fails.
The default value is 0
(No retry).
Note : Retries will only be performed if the request fails with a 429 (Rate limit reached)
or 5xx (Server side errors)
error. Other errors (e.g., authentication failure) will not be performed.
Type: Int32
Required: False
Position: Named
Default value: 0
Specifies an API endpoint URL such like: https://your-api-endpoint.test/v1
If not specified, it will use https://api.openai.com/v1
Type: System.Uri
Required: False
Position: Named
Default value: https://api.openai.com/v1
Specifies API key for authentication.
The type of data should [string]
or [securestring]
.
If not specified, it will try to use $global:OPENAI_API_KEY
or $env:OPENAI_API_KEY
Type: Object
Required: False
Position: Named
Specifies Organization ID which used for an API request.
If not specified, it will try to use $global:OPENAI_ORGANIZATION
or $env:OPENAI_ORGANIZATION
Type: string
Aliases: OrgId
Required: False
Position: Named
https://platform.openai.com/docs/api-reference/runs/cancelRun