Implantar um recurso do GeoCatalog

Este artigo orienta o leitor durante o processo de implantação de um recurso do GeoCatalog. O recurso GeoCatalog é o contêiner de nível superior para dados geoespaciais armazenados usando o Microsoft Planetry Computer Pro. Depois que um recurso GeoCatalog é implantado, o usuário pode começar a ingerir dados geoespaciais no Planetry Computer Pro. Os dados geoespaciais armazenados em um GeoCatalog são indexados, consultados e recuperados usando o padrão aberto do Catálogo de Acesso SpatioTemporal (STAC). Para obter mais informações sobre o STAC, consulte a visão geral do STAC.

Pré-requisitos

• Uma conta e uma assinatura do Azure criem uma conta gratuitamente.
• CLI do Azure (para usar a API REST)

Métodos

Este artigo descreve dois métodos para implantar o GeoCatalog do Planetary Computer Pro.

• Usando o portal do Azure.
• Usando a API REST do Azure.

Portal do Azure

Implantar o GeoCatalog com o portal do Azure

1. Navegue até o portal do Azure

2. Localize o tipo de recurso GeoCatalogs usando a barra de pesquisa do portal do Azure na parte superior da página; selecione "GeoCatalogs" na lista de Serviços.

   

3. Inicie o processo de criação do GeoCatalog por 1) selecionando o botão Criar no canto superior esquerdo da tela ou 2) selecionando o botão Criar catálogo geográfico no centro inferior da tela. O botão Criar geocatalog não aparecerá se você tiver um ou mais GeoCatalogs existentes.

   

4. Na guia "Noções básicas" do fluxo de trabalho "Criar Recurso do GeoCatalog", selecione a Assinatura e o Grupo de Recursos no qual você deseja implantar seu GeoCatalog. Forneça um nome exclusivo para o recurso GeoCatalog e selecione a Região do Azure na qual você deseja implantar. Selecione "Avançar" para prosseguir para a próxima guia.

   Observação

   Damos suporte à implantação para as seguintes regiões na Versão Prévia:

   • Leste dos EUA
   • Centro-Norte dos EUA
   • Europa Ocidental
   • Canadá Central

   

5. Na guia "Rede", selecione as opções de rede. Selecione "Avançar" para prosseguir para a próxima guia.

   Observação

   Há suporte apenas para habilitar o acesso público de todas as redes na Versão Prévia.

   

6. Na guia "Marcas", adicione as marcas desejadas ao novo recurso GeoCatalog. As marcas são opcionais; Consulte as práticas recomendadas de nomenclatura e marcação para obter diretrizes sobre como usar marcas do Azure. Selecione "Avançar" para prosseguir para a próxima guia.

   

7. Na guia "Examinar e criar", examine as seleções feitas na etapa anterior. Faça as correções necessárias nas seções anteriores selecionando o botão Anterior na parte inferior da página. Você também pode navegar diretamente até uma guia no fluxo de trabalho selecionando o nome dessa guia. Depois de estar satisfeito com suas configurações e seleções, selecione o botão Criar .

   

8. Você verá uma página "A implantação está em andamento" enquanto aguarda a conclusão da implantação do GeoCatalog. Esse processo pode levar 10 ou mais minutos. O "Status" da implantação de recursos mostra "Criado" mesmo antes da implantação ser concluída.

   

9. A página de implantação é atualizada para "Sua implantação está concluída" quando a implantação é concluída. Você pode selecionar "Ir para o recurso" para navegar diretamente até o recurso GeoCatalog recém-criado.

   

Próximas etapas

• Criar uma coleção STAC
• Criar uma coleção STAC da API
• Gerenciar o acesso ao recurso GeoCatalog
• Atribuir uma identidade gerenciada atribuída pelo usuário a um recurso do GeoCatalog

Conteúdo relacionado

• Excluir um GeoCatalog

REST API

Implantar o GeoCatalog com a API REST do Azure

1. Entre no portal do Azure e abra o Cloud Shell.

2. Crie uma instância do GeoCatalog selecionando o modo Bash e execute os seguintes comandos:

   # 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. Depois que o status da implantação for exibido com êxito, você poderá ver a instância do GeoCatalog criada no portal no grupo de recursos especificado.

Próximas etapas

• Criar uma coleção STAC
• Criar uma coleção STAC da API
• Gerenciar o acesso ao recurso GeoCatalog
• Atribuir uma identidade gerenciada atribuída pelo usuário a um recurso do GeoCatalog

Conteúdo relacionado

• Excluir um GeoCatalog