Tutorial: trabalhar com registros de dados de poço usando APIs do Wellbore DDMS
Use APIs do DDMS (Wellbore Domain Data Management Services) no Postman para trabalhar com dados de poço em sua instância do Gerenciador de Dados do Microsoft Azure para Energia.
Neste tutorial, você aprenderá a:
- Configurar o Postman para usar uma coleção do Wellbore DDMS.
- Configurar o Postman para usar um ambiente do Wellbore DDMS.
- Enviar solicitações por meio do Postman.
- Gerar um token de autorização.
- Usar APIs do Wellbore DDMS para trabalhar com registros de dados de poços.
Para obter mais informações sobre DDMS, consulte os conceitos de DDMS.
Pré-requisitos
- Uma assinatura do Azure
- Uma instância do Gerenciador de Dados de Energia do Azure criada na sua assinatura do Azure
Obter os detalhes da instância do Gerenciador de Dados de Energia do Azure
A primeira etapa é obter as seguintes informações da instância do Gerenciador de Dados de Energia do Azure no portal do Azure:
Parâmetro | Valor | Exemplo |
---|---|---|
client_id |
ID do aplicativo (cliente) | 00001111-aaaa-2222-bbbb-3333cccc4444 |
client_secret |
Segredos do cliente | _fl****************** |
tenant_id |
ID do Diretório (locatário) | 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx |
base_url |
URL | https://<instance>.energy.azure.com |
data-partition-id |
Partições de dados | <data-partition-name> |
Você usará essa informação mais adiante neste tutorial.
Configurar o Postman
Baixe e instale o aplicativo da área de trabalho Postman.
Importe os seguintes arquivos para o Postman:
Para importar os arquivos:
No ambiente Postman, atualize o Valor atual com as informações dos detalhes da instância do Gerenciador de Dados do Microsoft Azure para Energia:
No Postman, no menu à esquerda, selecione Ambientes e, em seguida, selecione Ambiente do Wellbore DDMS.
Na coluna Valor atual, insira as informações da tabela na seção Obter detalhes da instância do Gerenciador de Dados do Microsoft Azure para Energia deste tutorial.
Enviar uma solicitação de exemplo do Postman
A coleção do Postman para Wellbore DDMS contém solicitações que você pode usar para interagir com dados sobre poços, perfurações de poço, logs de poços e trajetória bem em sua instância do Gerenciador de Dados do Microsoft Azure para Energia.
No Postman, no menu à esquerda, selecione Coleções e selecione Wellbore DDMS. Em Configuração, selecione Obter um Token SPN.
Na lista suspensa do ambiente no canto superior direito, selecione Ambiente do Wellbore DDMS.
Para enviar a solicitação, selecione Enviar.
A solicitação valida o código de resposta da API real em relação ao código de resposta esperado. Selecione a guia Resultados de Teste para ver se a solicitação foi bem-sucedida ou falhou.
Aqui está um exemplo de uma chamada bem-sucedida do Postman:
Aqui está um exemplo de uma chamada do Postman com falha:
Usar APIs do Wellbore DDMS para trabalhar com registros de dados de poços
A conclusão com êxito das solicitações do Postman descritas nas APIs do Wellbore DDMS a seguir indica o sucesso da ingestão e da recuperação de registros de poços na instância de versão prévia do Wellbore DDMS do Azure Data Manager for Energy.
Criar uma marca legal
Crie uma marca legal que é adicionada automaticamente ao ambiente do Wellbore DDMS para conformidade de dados.
API: Configuração>Criar marca legal para WDMS
Método: POST
Para obter mais informações, confira Gerenciar marcas legais.
Criar um registro de poço
Crie um registro de poço na instância de versão prévia do Azure Data Manager for Energy.
API: Poço>Criar Poço
Método: POST
Obter um registro de poço
Obtenha os dados de registro de poço da instância da versão prévia do Azure Data Manager for Energy.
API: Poço>Poço pela ID
Método: GET
Obter versões de poço
Obtenha as versões de cada registro de poço ingerido na instância de versão prévia do Azure Data Manager for Energy.
API: Poço>Versões do Poço
Método: GET
Obter uma versão de poço específica
Obtenha os detalhes de uma versão específica de um registro de poço específico na instância da versão prévia do Azure Data Manager for Energy.
API: Poço>Versão Específica do Poço
Método: GET
Excluir um registro de poço
Exclua um registro de poço específico da instância da versão prévia do Azure Data Manager for Energy.
API: Limpar>Registro de Poço
Método: DELETE
Próxima etapa
Leia o tutorial a seguir para saber como usar a ferramenta de linha de comando sdutil para carregar dados sísmicos no Repositório Sísmico: