Get-VectorStoreFile.md

external help file	Module Name	online version	schema
PSOpenAI-help.xml	PSOpenAI	https://github.com/mkht/PSOpenAI/blob/main/Docs/Get-VectorStoreFile.md	2.0.0

Get-VectorStoreFile

SYNOPSIS

Retrieves vector store files.

SYNTAX

Get

Get-VectorStoreFile
    [-VectorStoreId] <String>
    [-FileId] <String>
    [-TimeoutSec <Int32>]
    [-MaxRetryCount <Int32>]
    [-ApiBase <Uri>]
    [-ApiKey <SecureString>]
    [-Organization <String>]
    [<CommonParameters>]

List

Get-VectorStoreFile
    [-VectorStoreId] <String>
    [-All]
    [-Limit <Int32>]
    [-Order <String>]
    [-Filter <String>]
    [-TimeoutSec <Int32>]
    [-MaxRetryCount <Int32>]
    [-ApiBase <Uri>]
    [-ApiKey <SecureString>]
    [-Organization <String>]
    [<CommonParameters>]

DESCRIPTION

Retrieves vector store files.

EXAMPLES

Example 1

PS C:\> Get-VectorStoreFile -VectorStoreId 'vs_abc123' -FileId 'file-abc123'

Get a file with ID file-abc123 in the vector store with ID of vs_abc123.

Example 2

PS C:\> Get-VectorStoreFile -VectorStoreId 'vs_abc123' -All

Get all files in the vector store with ID of vs_abc123.

PARAMETERS

-VectorStoreId

The ID of the vector store that the file belongs to.

Type: String
Parameter Sets: Get
Aliases: vector_store_id
Required: True
Position: 0
Accept pipeline input: True (ByValue, ByPropertyName)

-FileId

The ID of the file being retrieved.

Type: String
Parameter Sets: Get
Aliases: file_id
Required: True
Position: 1
Accept pipeline input: True (ByPropertyName)

-Filter

Filter by file status. One of in_progress, completed, failed, cancelled.

Type: String
Parameter Sets: List, ListAll
Required: False
Position: Named

-Limit

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

Type: Int32
Parameter Sets: List
Required: False
Position: Named
Default value: 20

-All

When this switch is specified, all vector stores will be retrieved.

Type: SwitchParameter
Parameter Sets: ListAll
Required: False
Position: Named

-Order

Sort order by the created timestamp of the objects. asc for ascending order and desc for descending order. The default is asc

Type: String
Parameter Sets: List, ListAll
Accepted values: asc, desc
Required: False
Position: Named
Default value: asc

-TimeoutSec

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

-MaxRetryCount

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

-ApiBase

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

-ApiKey

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

-Organization

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

INPUTS

OUTPUTS

PSCustomObject

NOTES

RELATED LINKS

https://developers.openai.com/api/reference/resources/vector_stores/subresources/files/methods/retrieve/ https://developers.openai.com/api/reference/resources/vector_stores/subresources/files/methods/list/