Delen via

Zelfstudie: Werken met seismische gegevens met behulp van Seismic DDMS-API's

In deze zelfstudie ziet u hoe u Seismic Domain Data Management Services (DDMS)-API's gebruikt met cURL voor het beheren van seismische gegevens in een Instantie van Azure Data Manager for Energy.

In deze zelfstudie leert u het volgende:

  • Registreer een gegevenspartitie voor seismische gegevens.
  • Gebruik Seismic DDMS-API's om seismische gegevens op te slaan en op te halen.

Zie DDMS-concepten voor meer informatie over DDMS.

Vereiste voorwaarden

  • Een Azure-abonnement
  • Een exemplaar van Azure Data Manager for Energy dat is gemaakt in uw Azure-abonnement
  • cURL-opdrachtregelprogramma geïnstalleerd op uw computer
  • Genereer het toegangstoken voor de service-principal om de Seismic-API's aan te roepen. Zie Hoe u een verificatietoken genereert.

De details van uw Azure Data Manager for Energy-exemplaar ophalen

Als u wilt doorgaan, verzamelt u de volgende gegevens van uw Azure Data Manager for Energy-exemplaar via Azure Portal:

Maatstaf Beschrijving Voorbeeld Waar vind ik deze waarde?
client_id Applicatie (client) ID 00001111-aaaa-2222-bbbb-3333cccc4444 U gebruikt deze app of client-id bij het registreren van de toepassing bij het Microsoft Identity Platform. Zie Een toepassing registreren
client_secret Clientgeheim _fl****************** Een clientgeheim wordt ook wel een toepassingswachtwoord genoemd, een tekenreekswaarde die uw app kan gebruiken in plaats van een certificaat om zichzelf te identificeren. Zie Een clientgeheim toevoegen.
tenant_id Directory-id (huurder) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Beweeg de muisaanwijzer over de accountnaam in het Azure-portaal om de directory- of tenant-id op te halen. U kunt ook Microsoft Entra ID>Eigenschappen>Huurder-ID zoeken en selecteren in de Azure portal.
base_url INSTANTIE-URL https://<instance>.energy.azure.com Zoek deze waarde op de overzichtspagina van de Azure Data Manager for Energy instantie.
data_partition_id Naam van gegevenspartitie opendes Zoek deze waarde op de overzichtspagina van de Azure Data Manager for Energy-instantie.
access_token Toegangstokenwaarde 0.ATcA01-XWHdJ0ES-qDevC6r........... Volg Hoe u verificatietoken genereert om een toegangstoken te maken en op te slaan.

Seismic DDMS-API's gebruiken om seismische gegevens op te slaan en op te halen

Maak een juridische tag die automatisch wordt toegevoegd aan de Seismic DDMS-omgeving voor gegevenscompatibiliteit.

API: Setup>Juridische tag maken voor SDMS

curl --request POST \
  --url https://{base_url}/api/legal/v1/legaltags \
  --header 'Authorization: Bearer {access_token}' \
  --header 'Content-Type: application/json' \
  --header 'Data-Partition-Id:  {data_partition_id}' \
  --data '{
    "name": "{tag_name}",
    "description": "Legal Tag added for Seismic",
    "properties": {
        "countryOfOrigin": [
            "US"
        ],
        "contractId": "No Contract Related",
        "expirationDate": "2099-01-01",
        "dataType": "Public Domain Data",
        "originator": "OSDU",
        "securityClassification": "Public",
        "exportClassification": "EAR99",
        "personalData": "No Personal Data"
    }
}'

Voorbeeldantwoord:

{
	"name": "opendes-Seismic-Legal-Tag-Test999588567444",
	"description": "Legal Tag added for Seismic",
	"properties": {
		"countryOfOrigin": [
			"US"
		],
		"contractId": "No Contract Related",
		"expirationDate": "2099-01-01",
		"originator": "OSDU",
		"dataType": "Public Domain Data",
		"securityClassification": "Public",
		"personalData": "No Personal Data",
		"exportClassification": "EAR99"
	}
}

Zie Juridische tags beheren voor meer informatie.

De service controleren

Voer eenvoudige serviceverbindings- en statustests uit in uw Azure Data Manager for Energy-exemplaar.

API: Serviceverificatie>Status controleren

curl --request GET \
  --url http://{base_url}/seistore-svc/api/v3/svcstatus \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {access_token}' \
  --header 'data-partition-id: {data_partition_id}'

Voorbeeldantwoord:

service OK

huurder

Maak een tenant in uw Azure Data Manager for Energy-exemplaar.

Opmerking

U moet een gegevenspartitie registreren als een tenant voordat u deze gebruikt met de Seismic DDMS.

API: Tenant>Een seismic-dms-tenant registreren

curl --request POST \
  --url https://{base_url}/seistore-svc/api/v3/tenant/{data_partition_id} \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "gcpid": "{data_partition_id}",
    "esd": "{data_partition_id}.dataservices.energy",
    "default_acl": "users.datalake.admins@opendes.dataservices.energy"
}'

Voorbeeldantwoord:

{
	"name": "opendes",
	"esd": "opendes.dataservices.energy",
	"gcpid": "opendes",
	"default_acls": "users.datalake.admins@opendes.dataservices.energy,users.datalake.ops@opendes.dataservices.energy",
	"Symbol(id)": {
		"partitionKey": "tn-opendes",
		"name": "opendes"
	}
}

Een subproject maken

Maak een subproject in uw Azure Data Manager for Energy-exemplaar.

API: SubprojectEen nieuw subproject> maken

curl --request POST \
  --url https://{base_url}/seistore-svc/api/v3/subproject/tenant/{data_partition_id}/subproject/{sesimic_subproject} \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access_token}' \
  --header 'Content-Type: application/json' \
  --header 'ltag: opendes-Seismic-Legal-Tag-Test999943387766' \
  --data '{
    "admin": "client_id",
    "access_policy": "dataset"
}'

Voorbeeldantwoord:

{
	"name": "test999384006",
	"tenant": "opendes",
	"ltag": "",
	"acls": {
		"admins": [
			"data.sdms.opendes.test999384006.3a114f91-d79f-489e-b9f0-3a4ac6643924.admin@opendes.dataservices.energy"
		],
		"viewers": [
			"data.sdms.opendes.test999384006.3bbce754-bdfa-4fad-9672-cc9a49231058.viewer@opendes.dataservices.energy"
		]
	},
	"access_policy": "dataset",
	"enforce_key": true,
	"gcs_bucket": "ss-cloud-lr8faf2xnup9yxd",
	"Symbol(id)": {
		"partitionKey": "sp-test999384006",
		"name": "test999384006"
	}
}

Een gegevensset registreren

Registreer een gegevensset in uw Azure Data Manager for Energy-exemplaar.

API:Een nieuwe gegevensset registreren>

curl --request POST \
  --url https://{base_url}/seistore-svc/api/v3/dataset/tenant/{data_partition_id}/subproject/{seismic_subproject}/dataset/{dataset_name} \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {access_token}' \
  --header 'Content-Type: application/json' \
  --header 'ltag: {legal_tag}' \
  --data '{
  "admin": "client_id",
  "storage_class": "MULTI_REGIONAL",
  "storage_location": "US",
  "access_policy": "dataset",
  "acls": {
    "admins": [
      "data.default.owners@opendes.dataservices.energy"
    ],
    "viewers": [
      "data.default.viewers@opendes.dataservices.energy"
    ]
  }
}'

Voorbeeldantwoord:

{
	"name": "test.sgy",
	"tenant": "opendes",
	"subproject": "test999384006",
	"path": "/",
	"ltag": "opendes-Seismic-Legal-Tag-Test999943387766",
	"created_by": "faK96PJHh5W-AzMK_dERdxkBBssUYVuqDjzYJcw9Al0",
	"last_modified_date": "Mon Mar 17 2025 12:43:38 GMT+0000 (Coordinated Universal Time)",
	"created_date": "Mon Mar 17 2025 12:43:38 GMT+0000 (Coordinated Universal Time)",
	"acls": {
		"admins": [
			"data.default.owners@opendes.dataservices.energy"
		],
		"viewers": [
			"data.default.viewers@opendes.dataservices.energy"
		]
	},
	"gcsurl": "ss-cloud-sfibby9ril9i755-915f80ed-4804-448a-bfa5-2e70934a97a2",
	"ctag": "TQsxLjyufohTOFvfopendes;opendes",
	"Symbol(id)": {
		"partitionKey": "ds-opendes-test999384006-3fdd95ea0c79eb59dcb2acc48ed1d1eb057a5f94debacffac4d8e88410c5cb2804d9ba68473ea20d2d91d143b64b755e4627ad87e89530ade1cd9614a8a53545",
		"name": "test.sgy"
	},
	"access_policy": "dataset",
	"sbit": "WSUmTxkL20jQSlKW",
	"sbit_count": 1
}

Toepassingen registreren

Registreer toepassingen in uw Azure Data Manager for Energy-exemplaar.

API: Toepassingen>registreren een nieuwe toepassing

curl --request POST \
  --url 'https://{base_url}/seistore-svc/api/v3/app?email={email}&sdpath={sdpath}' \
  --header 'Authorization: Bearer {access_token}'

Voorbeeldantwoord:

Status Code: 200

Volgende stap

Als alternatieve gebruikerservaring voor Postman kunt u het python-hulpprogramma sdutil gebruiken om rechtstreeks te communiceren met Seismic Store. Gebruik de volgende handleiding om aan de slag te gaan:

Sdutil gebruiken om gegevens te laden in Seismic Store Zie de OpenAPI-specificaties die beschikbaar zijn in de GitHub-opslagplaats adme-samples voor meer informatie over de Seismic REST API's in Azure Data Manager for Energy.

  • Last updated on