list_storage_files

imerit_ango.sdk.SDK.

list_storage_files(storage_id, bucket_name, path, get_signed_urls, retry_on_slow_down)

Recursively list files stored in a specified storage, bucket and folder path.

Parameters

• storage_id: string

  • The unique identifier for the storage. You can retrieve the storage ID using get_storages function.

• bucket_name: string

  • The name of the storage bucket to list files from.

  • Example: "ango-datasets"

• path: string, default ""

  • The directory path within the bucket to list files from. If empty, files are listed from the root of the bucket.

  • Example: "project-1/images/batch-1/"

• get_signed_urls: bool, default True

  • Whether to generate signed URLs for the listed files. When enabled, each file entry includes a temporary URL for secure access.

• retry_on_slow_down: bool, default True

  • Whether to automatically retry the request if the storage service responds with a slow-down or rate-limiting error.

Returns:

• output: dict

  • A dictionary containing the result of the operation.

Example

python

import os
from dotenv import load_dotenv
from imerit_ango.sdk import SDK

load_dotenv('variables.env')
api_key = os.getenv('API_KEY')

ango_sdk = SDK(api_key)

storage_id = "$STORAGE_ID"
sdk_response = ango_sdk.list_storage_files(
    storage_id=storage_id,
    bucket_name="ango-dataset",
    path="project-1/images/batch-1/",
    get_signed_urls=True,
    retry_on_slow_down=True
)

See also

get_storages