Asset storage classes need to be listed e.g. via CLI or documented

[romatou18]

Describe the current behavior

1. When trying to implement assets it proved to be difficult to find a comprehensive list of asset storage classes
   e.g. s3://, storage: file:, etc.
   A few examples are definitely found in the Assets documentation but not comprehensive list
   https://docs.prefect.io/v3/how-to-guides/workflows/assets

• listing ALL storage classes
• explaining how to use each of those.

2. I could only infer a list of it via reviewing:
   

   prefect/src/prefect/runner/storage.py

   Line 557 in 2c9a7cf

   class RemoteStorage:

Describe the proposed behavior

Suggestion: Complete the gaps in the current Assets documentation sections, or add a new section or page dedicated to listing storage classes, giving at least one example of each.

Example Use

No idea I am new to Prefect and this is what should be added by an experience dev.

Additional context

No response

[bdalpe]

Hi @romatou18,

You're looking at two different things here.

Yes, Assets use a URI structure for defining the identifier, but the scheme and path are arbitrary and do not require a "valid" value. You could use galaxy://marvin/dont/panic/42 as an identifier. The scheme and path are used for grouping. I think we can clarify this better in the docs and list those that have pretty icons out-of-the-box.

Here's some examples from my demo Workspace:

---

The link you provided to the Runner RemoteStorage class is specific to the pull_with_block step in a prefect.yaml file. This has no relation to Assets.

pull:
    - prefect.deployments.steps.pull_from_remote_storage:
        url: s3://my-bucket/my-folder
        key: {{ prefect.blocks.secret.my-aws-access-key }}}
        secret: {{ prefect.blocks.secret.my-aws-secret-key }}}

example from here: https://docs.prefect.io/v3/api-ref/python/prefect-deployments-steps-pull#pull_with_block

This allows for using any fsspec implementation to pull the code from remote storage for execution at Flow run time.

[23f3004349]

Hi, I would like to work on this issue.
Is it still available?

[kingsley-123]

Hi @bdalpe, I'd like to work on this documentation improvement. Is it still available? I see @23f3004349 showed interest - are they still working on it?

[desertaxle]

Closing as won't do. There are no asset storage classes in Prefect, and any string identifier can be used for an asset. No documentation changes are needed.