Démarrage rapide : Demander un jeton SAS de collection STAC

Dans ce guide de démarrage rapide, vous allez récupérer un jeton SAP au niveau de la collection qui peut être utilisé par d’autres applications pour accéder aux ressources de collection STAC dans un compte de stockage géré au sein d’une ressource GeoCatalog Microsoft Planetary Computer Pro.

Dans certaines applications, vous devez passer un jeton SAP au niveau de la collection pour permettre l’accès authentifié aux ressources stockées dans un compte de stockage managé.

Par exemple, lors de la récupération de ressources au niveau de la collection, telles que les données Zarr, un jeton SAS fournit des autorisations temporaires pour accéder directement aux données à partir du stockage Blob.

Cet exemple montre comment demander un jeton SAS au niveau d’une collection depuis la route /sas/token/{collection_id}.

REST API

1. Obtenir le jeton d'accès pour l'autorisation à un GéoCatalogue

from datetime import datetime, timedelta
import requests
from azure.identity import AzureCliCredential

# Resource ID for Planetary Computer Pro Geocatalog
MPCPRO_APP_ID = "https://geocatalog.spatio.azure.com"

_access_token = None

def getBearerToken():
    global _access_token
    if not _access_token or datetime.fromtimestamp(_access_token.expires_on) < datetime.now() + timedelta(minutes=5):
        credential = AzureCliCredential()
        _access_token = credential.get_token(f"{MPCPRO_APP_ID}/.default")

    return {"Authorization": f"Bearer {_access_token.token}"}

2. Demander un jeton SAS pour une collection STAC

Accédez au point de terminaison qui retourne votre jeton SAS de niveau collection STAC temporaire.

geocatalog_url = "<your-geocatalog-url>"
collection_id = "<your-collection-id>"

response = requests.get(
        f"{geocatalog_url}/sas/token/{collection_id}",
        headers=getBearerToken(),
        params={"api-version": "2026-04-15"}
    )

sas_token = response.json()["token"]

print(f"SAS Token: {sas_token}")

La variable sas_token contient la chaîne du jeton que vous pouvez passer aux applications qui doivent récupérer des ressources au niveau de la collection.

Kit de développement logiciel (SDK) Python

Prerequisites

• Python 3.10 ou version ultérieure

Installez le Kit de développement logiciel (SDK) Planetary Computer Pro Python :

pip install azure-planetarycomputer azure-identity

Demander un jeton SAP pour une collection STAC

from azure.planetarycomputer import PlanetaryComputerProClient
from azure.identity import DefaultAzureCredential

client = PlanetaryComputerProClient(
    endpoint="<your-geocatalog-url>",
    credential=DefaultAzureCredential()
)

collection_id = "<your-collection-id>"
sas_response = client.sas.get_token(collection_id)
sas_token = sas_response["token"]

print(f"SAS Token: {sas_token}")

La variable sas_token contient la chaîne du jeton que vous pouvez passer aux applications qui doivent récupérer des ressources au niveau de la collection.

Pour plus d’informations, consultez la référence Python SDK.