Skip to content

🗄️ Storage Assets

Access all previous orders or assets in your account.

Authenticate

First connect with UP42 as explained in the authentication chapter.

import up42
up42.authenticate(
    project_id="your-project-ID",
    project_api_key="your-project-API-key"
)

See orders

Get a list of all tasking and catalog orders.

storage = up42.initialize_storage()

orders = storage.get_orders(limit=100, sortby="createdAt")
assets = orders[0].get_assets()

You can also get information about a specific order by using its ID. For example, up42.initialize_order(order_id="ea36dee9-fed6-457e-8400-2c20ebd30f44").

For more information, see Order and Storage.

Search for assets

Get a list of assets in storage.

You can search by different properties — for example, tags, geometry, geospatial collections.

assets = storage.get_assets(created_after="2022-01-01", limit=100, sortby="size", descending=False)

print(assets[0].info) # Dictionary with the asset metadata

print(assets[0].stac_info) # Dictionary with additional STAC metadata — for example, geometry or image acquisition parameters

You can also get information about a specific asset by using its ID. For example, up42.initialize_asset(asset_id="ea36dee9-fed6-457e-8400-2c20ebd30f44").

For more information, see Storage.

Download assets

Download a single asset or multiple assets.

The default download path for an asset is your current working directory. You can also provide a custom output_directory path.

assets[0].download()

To download multiple assets, loop over a list of assets as follows:

for asset in assets:
    asset.download()

For more information, see Asset.

PySTAC client

Utilize the pystac-client library.

You can authenticate pystac-client to browse in UP42 storage as follows:

up42_pystac_client = storage.pystac_client

Using the up42_pystac_client, you can run regular PySTAC client operations.

up42_stac_collections = up42_pystac_client.get_collections()

For more information, see Storage.

⏭️ Continue with the Run an analytics workflow chapter.