Distribuire una risorsa GeoCatalog

Questo articolo illustra il processo di distribuzione di una risorsa GeoCatalog. La risorsa GeoCatalog è il contenitore di primo livello per i dati geospaziali archiviati usando Microsoft Planetary Computer Pro. Una volta distribuita una risorsa GeoCatalog, l'utente può iniziare a inserire dati geospaziali in Planetary Computer Pro. I dati geospaziali archiviati in un GeoCatalog vengono indicizzati, interrogati e recuperati usando lo standard aperto SpatioTemporal Access Catalog (STAC). Per altre informazioni su STAC, vedere PANORAMICA di STAC.

Prerequisiti

• Un account Azure e una sottoscrizione Creare gratuitamente un account.
• Interfaccia della riga di comando di Azure (per l'uso dell'API REST)

Metodi

Questo articolo descrive due metodi per la distribuzione di un GeoCatalog Pro del Computer Planetario:

• Uso del portale di Azure.
• Uso dell'API REST di Azure.

Portale di Azure

Distribuire GeoCatalog con il portale di Azure

1. Passare al portale di Azure

2. Trovare il tipo di risorsa GeoCatalogs usando la barra di ricerca del portale di Azure nella parte superiore della pagina; selezionare "GeoCatalogs" nell'elenco dei servizi.

   

3. Avviare il processo di creazione di GeoCatalog selezionando il pulsante Crea in alto a sinistra nella schermata o 2) selezionando il pulsante Crea catalogo geografico nel centro inferiore dello schermo. Il pulsante Crea geocatalog non viene visualizzato se si dispone di uno o più GeoCatalog esistenti.

   

4. Nella scheda "Informazioni di base" del flusso di lavoro "Crea risorsa GeoCatalog" selezionare la sottoscrizione e il gruppo di risorse in cui si vuole distribuire geoCatalog. Specificare un nome univoco per la risorsa GeoCatalog e selezionare l'area di Azure in cui si vuole eseguire la distribuzione. Selezionare "Avanti" per passare alla scheda successiva.

   Annotazioni

   La distribuzione in anteprima è supportata nelle seguenti regioni:

   • Stati Uniti orientali
   • Stati Uniti centro-settentrionali
   • Europa occidentale
   • Canada centrale

   

5. Nella scheda "Rete" selezionare le opzioni di rete. Selezionare "Avanti" per passare alla scheda successiva.

   Annotazioni

   L'opzione Abilita l'accesso pubblico da tutte le reti è supportata solo in anteprima.

   

6. Nella scheda "Tag" aggiungere i tag desiderati alla nuova risorsa GeoCatalog. I tag sono facoltativi; Per indicazioni su come usare i tag di Azure, vedere Naming and Tagging Best Practices (Procedure consigliate per la denominazione e l'assegnazione di tag di tag di Azure). Selezionare "Avanti" per passare alla scheda successiva.

   

7. Nella scheda "Rivedi e crea" esaminare le selezioni effettuate nel passaggio precedente. Apportare le correzioni necessarie nelle sezioni precedenti selezionando il pulsante Indietro nella parte inferiore della pagina. È anche possibile passare direttamente a una scheda nel flusso di lavoro selezionando il nome di tale scheda. Dopo aver soddisfatto le impostazioni e le selezioni, selezionare il pulsante Crea .

   

8. Viene visualizzata una pagina "Distribuzione in corso" mentre si attende il completamento della distribuzione GeoCatalog. Questo processo può richiedere 10 o più minuti. Lo "Stato" della distribuzione della risorsa mostra "Creato" anche prima del completamento della distribuzione.

   

9. La pagina di distribuzione viene aggiornata a "La distribuzione è stata completata" al termine della distribuzione. È possibile selezionare "Vai alla risorsa" per passare direttamente alla risorsa GeoCatalog appena creata.

   

Passaggi successivi

• Creare una raccolta STAC
• Creare una raccolta STAC dall'API
• Gestire l'accesso alla risorsa GeoCatalog
• Assegnare un'identità gestita assegnata dall'utente a una risorsa GeoCatalog

Contenuto correlato

• Eliminare un geocatalog

REST API

Distribuire GeoCatalog con l'API REST di Azure

1. Accedere al portale di Azure e aprire Cloud Shell.

2. Creare un'istanza di GeoCatalog selezionando la modalità Bash ed eseguire i comandi seguenti:

   # Change the active subscription using the subscription name or id, which has been allowed for GeoCatalog preview
   az account set --subscription "sub_name or sub_id"
   
   # Register Microsoft.Orbital resource provider even if it's already registered to take effect for GeoCatalog.
   az provider register -n Microsoft.Orbital
   
   # Set up the parameters of subscription_id, resource_group, target Azure region/location, and Spatio catalog name to be created. Note the subscription_id and resource_group need to be existing resources. Update Location and Catalog_name accordingly.
   export SUBSCRIPTION_ID="sub_id"
   export RESOURCE_GROUP="rg_name"
   export LOCATION=northcentralus
   export CATALOG_NAME="catalog_name"
   
   # Kick off the GeoCatalog deployment process, which may take 10-20 minutes
   az rest --method PUT --uri "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.Orbital/geoCatalogs/$CATALOG_NAME?api-version=2025-02-11-preview" --body '{"location": "'$LOCATION'", "Properties":{"tier":"Basic"}}'
   
   # Check the status of the deployment
   az rest --method GET --uri "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.Orbital/geoCatalogs/$CATALOG_NAME?api-version=2025-02-11-preview"
   
   # Get catalog uri
   az resource show -g $RESOURCE_GROUP -n $CATALOG_NAME --namespace Microsoft.Orbital --resource-type "geocatalogs"
   

3. Una volta completato lo stato della distribuzione, dovrebbe essere possibile visualizzare l'istanza GeoCatalog creata nel portale nel gruppo di risorse specificato.

Passaggi successivi

• Creare una raccolta STAC
• Creare una raccolta STAC dall'API
• Gestire l'accesso alla risorsa GeoCatalog
• Assegnare un'identità gestita assegnata dall'utente a una risorsa GeoCatalog

Contenuto correlato

• Eliminare un geocatalog