Samouczek: Korzystanie z punktów końcowych interfejsu API Reservoir DDMS

Z tego artykułu dowiesz się, jak odczytywać dane z interfejsów API REST usługi Reservoir DDMS za pomocą poleceń curl.

Wymagania wstępne

Utwórz zasób usługi Azure Data Manager for Energy. Zobacz Jak utworzyć zasób Azure Data Manager for Energy.
Wygeneruj token dostępu nazwy głównej usługi, aby wywołać interfejsy API usługi Reservoir DDMS. Zobacz Jak wygenerować token uwierzytelniania.

Użyj interfejsów API Reservoir DDMS do odczytu danych o zbiornikach

Aby sprawdzić kondycję klienta, uruchom następujące polecenie curl w usłudze Azure Cloud Shell.

curl --request GET \
  --url https://<adme_url>/api/reservoir-ddms/v2/health/info \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowa odpowiedź:

{
    "groupId": "org.opengroup.osdu",
    "artifactId": "@osdu/open-etp-client",
    "version": "1.2.0",
    "commitId": "unknown",
    "commitTime": "unknown"
}

Uruchom następujące polecenie curl, aby utworzyć nową przestrzeń danych.

curl --request POST \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Content-Type: application/json' \
  --header 'data-partition-id: <data-partition-id>' \
  --data '[
  {
    "DataspaceId": "<dataspace_name>",
    "Path": "<dataspace_name>",
    "CustomData": {
        "legaltags": ["<legal_tag_name>"],
        "otherRelevantDataCountries": ["<country_code1>","country_code2"],
        "viewers": [ "<valid_entitlement_group1>@<data-partition-id>.dataservices.energy" ],
        "owners": [  "<valid_entitlement_group2>@<data-partition-id>.dataservices.energy"]
    }
  }
]'

Przykładowe żądanie

Rozważ zasób usługi Azure Data Manager for Energy o nazwie admetest, z partycją danych o nazwie dp1, tagiem prawnym o nazwie dp1-RDDMS-Legal-Tag, prawidłową grupą uprawnień o nazwach data.default.viewers oraz data.default.owners. Chcesz utworzyć nową nazwę demo/RestWriteprzestrzeni danych .

curl --request GET \
  --url https://admetest.energy.azure.com/api/reservoir-ddms/v2/dataspaces/demo%2FVolve/resources \
  --header 'Authorization: Bearer ey.......' \
  --header 'Content-Type: application/json' \
  --header 'data-partition-id: dp1' \
  --data '[
  {
    "DataspaceId": "demo/RestWrite",
    "Path": "demo/RestWrite",
    "CustomData": {
        "legaltags": ["dp1-RDDMS-Legal-Tag"],
        "otherRelevantDataCountries": ["US"],
        "viewers": [ "data.default.viewers@dp1.dataservices.energy" ],
        "owners": [  "data.default.owners@dp1.dataservices.energy"]
    }
  }
]'

Przykładowa odpowiedź:

[
    "eml:///dataspace('demo/RestWrite')"
]

Uruchom następujące polecenie curl, aby uruchomić transakcję.

curl --request POST \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<encoded_dataspace_id>/transactions \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowa odpowiedź:

3f71e12a-7b05-41c1-851d-2c59498832d4

Przykład zakodowanego identyfikatora przestrzeni danych:

Dataspace name: "demo/RestWrite"
Encoded dataspace name: "demo%2FRestWrite"

Uruchom następujące polecenie curl, aby dodać zasoby przy użyciu identyfikatora transakcji.

curl --request PUT \
  --url 'https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<encoded_dataspace_id>/resources?transactionId=<transaction_id>' \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Content-Type: application/json' \
  --header 'data-partition-id: <data-partition-id>' \
  --data '[
  {
    "Citation": {
      "Title": "CustomTestCrs",
      "Originator": "dalsaab",
      "Creation": "2021-09-02T07:57:28.000Z",
      "Format": "Paradigm SKUA-GOCAD 22 Alpha 1 Build:20210830-0200 (id: origin/master|56050|1fb1cf919c2|20210827-1108) for Linux_x64_2.17_gcc91",
      "Editor": "dalsaab",
      "LastUpdate": "2021-09-06T13:30:24.000Z"
    },
    "YOffset": 6470000,
    "ZOffset": 0,
    "ArealRotation": {
      "_": 0,
      "$type": "eml20.PlaneAngleMeasure",
      "Uom": "rad"
    },
    "ProjectedAxisOrder": "easting northing",
    "ProjectedUom": "m",
    "VerticalUom": "m",
    "XOffset": 420000,
    "ZIncreasingDownward": true,
    "VerticalCrs": {
      "EpsgCode": 6230,
      "$type": "eml20.VerticalCrsEpsgCode"
    },
    "ProjectedCrs": {
      "EpsgCode": 23031,
      "$type": "eml20.ProjectedCrsEpsgCode"
    },
    "$type": "resqml20.obj_LocalDepth3dCrs",
    "SchemaVersion": "2.0",
    "Uuid": "7c7d7987-b7b9-4215-9014-cb7d6fb62173"
  },
  {
    "Citation": {
      "$type": "eml20.Citation",
      "Title": "Hdf Proxy",
      "Originator": "Mathieu",
      "Creation": "2014-09-09T15:33:25Z",
      "Format": "[F2I-CONSULTING:resqml2CppApi]"
    },
    "MimeType": "application/x-hdf5",
    "$type": "eml20.obj_EpcExternalPartReference",
    "SchemaVersion": "2.0.0.20140822",
    "Uuid": "68f2a7d4-f7c1-4a75-95e9-3c6a7029fb23"
  },
  {
    "Citation": {
      "Title": "Pointset 1",
      "Originator": "user1",
      "Creation": "2019-01-08T13:41:25.000Z",
      "Format": "Paradigm SKUA-GOCAD 22 Alpha 1 Build:20210830-0200 (id: origin/master|56050|1fb1cf919c2|20210827-1108) for Linux_x64_2.17_gcc91",
      "$type": "eml20.Citation"
    },
    "ExtraMetadata": [
      {
        "Name": "pdgm/dx/resqml/creatorGroup",
        "Value": "Interpreters",
        "$type": "resqml20.NameValuePair"
      }
    ],
    "NodePatch": [
      {
        "PatchIndex": 0,
        "Count": 6,
        "Geometry": {
          "$type": "resqml20.PointGeometry",
          "LocalCrs": {
            "$type": "eml20.DataObjectReference",
            "ContentType": "application/x-resqml+xml;version=2.0;type=obj_LocalDepth3dCrs",
            "Title": "CustomTestCrs",
            "UUID": "7c7d7987-b7b9-4215-9014-cb7d6fb62173"
          },
          "Points": {
            "$type": "resqml20.Point3dHdf5Array",
            "Coordinates": {
              "$type": "eml20.Hdf5Dataset",
              "PathInHdfFile": "/RESQML/5d27775e-5c7f-4786-a048-9a303fa1165a/points_patch0",
              "HdfProxy": {
                "$type": "eml20.DataObjectReference",
                "ContentType": "application/x-resqml+xml;version=2.0;type=obj_EpcExternalPartReference",
                "UUID": "68f2a7d4-f7c1-4a75-95e9-3c6a7029fb23",
                "DescriptionString": "Hdf Proxy",
                "VersionString": "1410276805"
              }
            }
          }
        }
      }
    ],
    "$type": "resqml20.obj_PointSetRepresentation",
    "SchemaVersion": "2.0.0.20140822",
    "Uuid": "5d27775e-5c7f-4786-a048-9a303fa1165a"
  }
]'

Przykładowa odpowiedź:

true

Uruchom następujące polecenie curl, aby dodać tablice przy użyciu identyfikatora transakcji.

curl --request PUT \
  --url 'https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<encoded_dataspace_id>/resources/arrays?transactionId=<transaction_id>' \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Content-Type: application/json' \
  --header 'data-partition-id: <data-partition-id>' \
  --data '[
  {
    "ContainerType": "eml20.obj_EpcExternalPartReference",
    "ContainerUuid": "68f2a7d4-f7c1-4a75-95e9-3c6a7029fb23",
    "PathInResource": "/RESQML/5d27775e-5c7f-4786-a048-9a303fa1165a/points_patch0",
    "Dimensions": [
      3,
      6
    ],
    "PreferredSubarrayDimensions": [
      3,
      1
    ],
    "Data": [
      0,0,0,
      1,0,0,
      0,1,2,
      1,1,2,
      1,0,2,
      1,1,1
    ],
    "ArrayType": "Float32Array"
  }
]'

Przykładowa odpowiedź:

[
    true
]

Uruchom następujące polecenie curl, aby zatwierdzić transakcję.

curl --request PUT \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<encoded_dataspace_id>/transactions/<transaction_id> \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowa odpowiedź:

true

Uruchom następujące polecenie curl, aby wycofać transakcję.

curl --request DELETE \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<encoded_dataspace_id>/transactions/<transaction_id> \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowa odpowiedź:

true

Uruchom następujące polecenie curl, aby wyświetlić listę wszystkich przestrzeni danych.

curl --request GET \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowa odpowiedź

[
	{
		"uri": "eml:///dataspace('demo/Volve')",
		"path": "demo/Volve",
		"storeLastWrite": "2025-02-04T13:34:18.901Z",
		"storeCreated": "2025-02-04T13:34:18.901Z",
		"customData": {
			"read-only": "false",
			"size": "232 kB"
		}
	}
]

Uruchom następujące polecenie curl, aby uzyskać podsumowanie zawartości w przestrzeni danych.

curl --request GET \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<dataspace_name>/resources \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowe żądanie

Rozważmy zasób usługi Azure Data Manager for Energy o nazwie admetest z partycją danych o nazwie dp1 , a nazwa przestrzeni danych to demo/Volve

curl --request GET \
  --url https://admetest.energy.azure.com/api/reservoir-ddms/v2/dataspaces/demo%2FVolve/resources \
  --header 'Authorization: Bearer ey......' \
  --header 'data-partition-id: dp1'

Przykładowa odpowiedź

[
	{
		"name": "eml20.obj_EpcExternalPartReference",
		"count": 1
	},
	{
		"name": "resqml20.obj_ContinuousProperty",
		"count": 10
	},
	{
		"name": "resqml20.obj_GeneticBoundaryFeature",
		"count": 7
	},
	{
		"name": "resqml20.obj_Grid2dRepresentation",
		"count": 5
	},
	{
		"name": "resqml20.obj_HorizonInterpretation",
		"count": 6
	},
	{
		"name": "resqml20.obj_LocalDepth3dCrs",
		"count": 1
	},
	{
		"name": "resqml20.obj_OrganizationFeature",
		"count": 1
	},
	{
		"name": "resqml20.obj_PropertyKind",
		"count": 6
	},
	{
		"name": "resqml20.obj_StratigraphicColumn",
		"count": 2
	},
	{
		"name": "resqml20.obj_StratigraphicColumnRankInterpretation",
		"count": 2
	},
	{
		"name": "resqml20.obj_StratigraphicUnitFeature",
		"count": 8
	},
	{
		"name": "resqml20.obj_StratigraphicUnitInterpretation",
		"count": 16
	},
	{
		"name": "resqml20.obj_SubRepresentation",
		"count": 21
	},
	{
		"name": "resqml20.obj_TriangulatedSetRepresentation",
		"count": 3
	}
]

Uruchom następujące polecenie curl, aby uzyskać wszystkie szczegóły zasobów w przestrzeni danych.

curl --request GET \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<dataspace_name>/resources/all \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowa odpowiedź

[
	{
		"uri": "eml:///dataspace('demo/Volve')/resqml20.obj_ContinuousProperty(0ea90494-08f9-48e8-bc28-6cbc70a64626)",
		"alternateUris": [],
		"name": "SnS_data_mismatch",
		"lastChanged": "2019-01-03T17:10:16.000Z",
		"storeLastWrite": "2025-02-05T11:33:11.766Z",
		"storeCreated": "2025-02-05T11:33:11.766Z",
		"activeStatus": "Active",
		"customData": {
			"created": "2019-01-03T17:10:16.000Z",
			"creator": "ATsoblefack"
		}
	},
	{
		"uri": "eml:///dataspace('demo/Volve')/resqml20.obj_ContinuousProperty(1615d8d2-2a2d-482c-885e-14225b89e90c)",
		"alternateUris": [],
		"name": "Thick",
		"lastChanged": "2019-01-08T13:42:27.000Z",
		"storeLastWrite": "2025-02-05T11:33:11.766Z",
		"storeCreated": "2025-02-05T11:33:11.766Z",
		"activeStatus": "Active",
		"customData": {
			"created": "2019-01-08T13:42:26.000Z",
			"creator": "ATsoblefack"
		}
	}
]

Uruchom następujące polecenie curl, aby uzyskać wszystkie zasoby w przestrzeni danych filtrowanej według typu obiektu.

curl --request GET \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<dataspace-name>/resources/<data-object-type> \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowe żądanie

Rozważmy zasób usługi Azure Data Manager for Energy o nazwie admetest z partycją danych o nazwie dp1 , a nazwa przestrzeni danych to demo/volve. Chcesz uzyskać wszystkie zasoby typu Grid2dRepresentation.

curl --request GET \
  --url https://admetest.energy.azure.com/api/reservoir-ddms/v2/dataspaces/demo%2FVolve/resources/resqml20.obj_Grid2dRepresentation \
  --header 'Authorization: Bearer ey........' \
  --header 'data-partition-id: dp1'

Przykładowa odpowiedź

[
	{
		"uri": "eml:///dataspace('demo/Volve')/resqml20.obj_Grid2dRepresentation(aaaabbbb-0000-cccc-1111-dddd2222eeee)",
		"alternateUris": [],
		"name": "ConvHugin_Fm_Base",
		"lastChanged": "2019-01-03T17:11:21.000Z",
		"storeLastWrite": "2025-02-05T11:33:11.766Z",
		"storeCreated": "2025-02-05T11:33:11.766Z",
		"activeStatus": "Active",
		"customData": {
			"created": "2019-01-03T17:11:20.000Z",
			"creator": "ATsoblefack"
		}
	},
	{
		"uri": "eml:///dataspace('demo/Volve')/resqml20.obj_Grid2dRepresentation(8f2c2911-5cdc-4133-ab98-be7a3f94de32)",
		"alternateUris": [],
		"name": "Hugin_Fm_Base",
		"lastChanged": "2019-01-03T17:08:58.000Z",
		"storeLastWrite": "2025-02-05T11:33:11.766Z",
		"storeCreated": "2025-02-05T11:33:11.766Z",
		"activeStatus": "Active",
		"customData": {
			"created": "2019-01-03T17:08:58.000Z",
			"creator": "ATsoblefack"
		}
    }
]

Uruchom następujące polecenie curl, aby uzyskać szczegółowe informacje, takie jak metadane reprezentacji, na podstawie GUID typu obiektu danych.

curl --request GET \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<dataspace-name>/resources/<data-object-type>/<data-object-type-guid> \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowe żądanie

Rozważmy zasób usługi Azure Data Manager for Energy o nazwie admetest z partycją danych o nazwie dp1 , a nazwa przestrzeni danych to demo/volve. Chcesz uzyskać szczegółowe informacje o typie obiektu Grid2dRepresentation z identyfikatorem GUID obiektu danych aaaabbbb-0000-cccc-1111-dddd2222eeee

curl --request GET \
  --url https://admetest.energy.azure.com/api/reservoir-ddms/v2/dataspaces/demo%2FVolve/resources/resqml20.obj_Grid2dRepresentation/aaaabbbb-0000-cccc-1111-dddd2222eeee \
  --header 'Authorization: Bearer ey.....' \
  --header 'data-partition-id: dp1'

Przykładowa odpowiedź

[
	{
		"$type": "resqml20.obj_Grid2dRepresentation",
		"SchemaVersion": "2.0",
		"Uuid": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
		"Citation": {
			"$type": "eml20.Citation",
			"Title": "ConvHugin_Fm_Base",
			"Originator": "ATsoblefack",
			"Creation": "2019-01-03T17:11:20.000Z",
			"Format": "Paradigm SKUA-GOCAD 22 Alpha 1 Build:20210830-0200 (id: origin/master|56050|1fb1cf919c2|20210827-1108) for Linux_x64_2.17_gcc91",
			"Editor": "ATsoblefack",
			"LastUpdate": "2019-01-03T17:11:21.000Z"
		},
		"ExtraMetadata": [
			{
				"$type": "resqml20.NameValuePair",
				"Name": "pdgm/dx/resqml/creatorGroup",
				"Value": "ATsoblefack"
			}
		],
		"RepresentedInterpretation": {
			"$type": "eml20.DataObjectReference",
			"ContentType": "application/x-resqml+xml;version=2.0;type=obj_HorizonInterpretation",
			"Title": "RP_Markers_Calibration",
			"UUID": "e33006db-2797-4cdf-a4f2-8207b4688b3a",
			"UuidAuthority": "pdgm",
			"_data": {
				"$type": "resqml20.obj_HorizonInterpretation",
				"SchemaVersion": "2.0",
				"Uuid": "e33006db-2797-4cdf-a4f2-8207b4688b3a",
				"Citation": {
					"$type": "eml20.Citation",
					"Title": "RP_Markers_Calibration",
					"Originator": "dalsaab",
					"Creation": "2021-09-06T14:20:48.000Z",
					"Format": "Paradigm SKUA-GOCAD 22 Alpha 1 Build:20210830-0200 (id: origin/master|56050|1fb1cf919c2|20210827-1108) for Linux_x64_2.17_gcc91"
				},
				"ExtraMetadata": [
					{
						"$type": "resqml20.NameValuePair",
						"Name": "pdgm/dx/resqml/creatorGroup",
						"Value": "dalsaab"
					}
				],
				"Domain": "depth",
				"InterpretedFeature": {
					"$type": "eml20.DataObjectReference",
					"ContentType": "application/x-resqml+xml;version=2.0;type=obj_GeneticBoundaryFeature",
					"Title": "Hugin_Fm_Base",
					"UUID": "bccee857-efb8-4562-aed7-19e5621526c4",
					"UuidAuthority": "pdgm",
					"_data": {
						"$type": "resqml20.obj_GeneticBoundaryFeature",
						"SchemaVersion": "2.0",
						"Uuid": "bccee857-efb8-4562-aed7-19e5621526c4",
						"Citation": {
							"$type": "eml20.Citation",
							"Title": "Hugin_Fm_Base",
							"Originator": "jmaksoud",
							"Creation": "2018-11-23T15:01:42.000Z",
							"Format": "Paradigm SKUA-GOCAD 22 Alpha 1 Build:20210830-0200 (id: origin/master|56050|1fb1cf919c2|20210827-1108) for Linux_x64_2.17_gcc91",
							"Editor": "dalsaab",
							"LastUpdate": "2018-11-23T15:58:48.000Z"
						},
						"ExtraMetadata": [
							{
								"$type": "resqml20.NameValuePair",
								"Name": "pdgm/dx/resqml/creatorGroup",
								"Value": "jmaksoud"
							}
						],
						"GeneticBoundaryKind": "horizon"
					}
				},
				"BoundaryRelation": [
					"conformable"
				]
			}
		}
	}
]

Uruchom następujące polecenie curl, aby uzyskać opis wszystkich tablic dla obiektu danych o identyfikatorze GUID i określonym typie obiektu danych.

curl --request GET \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<dataspace-name>/resources/<data-object-type>/<data-object-type-guid>/arrays \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowe żądanie

Rozważmy zasób usługi Azure Data Manager for Energy o nazwie admetest z partycją danych o nazwie dp1 , a nazwa przestrzeni danych to demo/Volve. Chcesz uzyskać tablice typu obiektu Grid2dRepresentation z identyfikatorem GUID obiektu danych aaaabbbb-0000-cccc-1111-dddd2222eeee

curl --request GET \
  --url https://admetest.energy.azure.com/api/reservoir-ddms/v2/dataspaces/demo%2FVolve/resources/resqml20.obj_Grid2dRepresentation/aaaabbbb-0000-cccc-1111-dddd2222eeee/arrays \
  --header 'Authorization: Bearer ey........' \
  --header 'data-partition-id: dp1'

Przykładowa odpowiedź

[
	{
		"uid": {
			"uri": "eml:///dataspace('demo/Volve')/eml20.obj_EpcExternalPartReference(53395ada-6f93-4bac-b506-d45997ded2a2)",
			"pathInResource": "/RESQML/aaaabbbb-0000-cccc-1111-dddd2222eeee/points_patch0"
		},
		"dimensions": [
			401,
			510
		],
		"arrayType": "Int8Array",
		"preferredSubarrayDimensions": [],
		"storeLastWrite": "1970-01-01T00:00:00.000Z",
		"storeCreated": "1970-01-01T00:00:00.000Z",
		"customData": {}
	}
]

Uruchom następujące polecenie curl, aby pobrać tablicę jako json dla określonej ścieżki w zasobie.

curl --request GET \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<dataspace-name>/resources/<data-object-type>/<data-object-type-guid>/arrays/<path-in-resource> \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowe żądanie

Rozważmy zasób usługi Azure Data Manager for Energy o nazwie admetest z partycją danych o nazwie dp1 , a nazwa przestrzeni danych to demo/Volve. Chcesz uzyskać tablicę, w której ścieżka jest zasobem RESQML/aaaabbbb-0000-cccc-1111-dddd2222eeee/points_patch0 typu obiektu Grid2dRepresentation z identyfikatorem GUID obiektu danych aaaabbbb-0000-cccc-1111-dddd2222eeee.

curl --request GET \
  --url https://admetest.energy.azure.com/api/reservoir-ddms/v2/dataspaces/demo%2FVolve/resources/resqml20.obj_Grid2dRepresentation/aaaabbbb-0000-cccc-1111-dddd2222eeee/arrays/RESQML%2Faaaabbbb-0000-cccc-1111-dddd2222eeee%2Fpoints_patch0 \
  --header 'Authorization: Bearer ey........' \
  --header 'data-partition-id: dp1'

Przykładowa odpowiedź

{
	"uid": {
		"uri": "eml:///dataspace('demo/Volve')/resqml20.obj_Grid2dRepresentation(aaaabbbb-0000-cccc-1111-dddd2222eeee)",
		"pathInResource": "RESQML/aaaabbbb-0000-cccc-1111-dddd2222eeee/points_patch0"
	},
	"data": {
		"data": [
			null,
			3160.12890625,
			3138.87255859375,
			3139.27734375,
			3139.30908203125,
			3138.96533203125,
			3138.2734375,
			3137.31884765625,
			3136.285400390625,
			3135.2890625
        ],
		"dimensions": [
			401,
			510
		]
	}
}

Uruchom następujące polecenie curl, aby pobrać wszystkie obiekty źródłowe dla określonego typu obiektu o identyfikatorze GUID.

curl --request GET \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<dataspace-name>/resources/<data-object-type>/<data-object-type-guid>/sources \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowe żądanie

Rozważmy zasób usługi Azure Data Manager for Energy o nazwie admetest z partycją danych o nazwie dp1 , a nazwa przestrzeni danych to demo/Volve. Chcesz pobrać wszystkie inne obiekty, do których odwołuje się obiekt o identyfikatorze GUID aaaabbbb-0000-cccc-1111-dddd2222eeee.

curl --request GET \
  --url https://admetest.energy.azure.com/api/reservoir-ddms/v2/dataspaces/demo%2FVolve/resources/resqml20.obj_Grid2dRepresentation/aaaabbbb-0000-cccc-1111-dddd2222eeee/sources \
  --header 'Authorization: Bearer ey........' \
  --header 'data-partition-id: dp1'

Przykładowa odpowiedź

[
	{
		"uri": "eml:///dataspace('demo/Volve')/resqml20.obj_ContinuousProperty(c88bd325-59ba-4c5b-8b4c-d3b1d98be7c5)",
		"alternateUris": [],
		"name": "SnS_data_mismatch",
		"lastChanged": "2019-01-03T17:11:20.000Z",
		"storeLastWrite": "2025-02-05T11:33:11.766Z",
		"storeCreated": "2025-02-05T11:33:11.766Z",
		"activeStatus": "Active",
		"customData": {
			"created": "2019-01-03T17:11:20.000Z",
			"creator": "ATsoblefack"
		}
	},
	{
		"uri": "eml:///dataspace('demo/Volve')/resqml20.obj_SubRepresentation(2756ba3c-ece5-498b-9633-6b7ed279043a)",
		"alternateUris": [],
		"name": "SnS_faults_proximity",
		"lastChanged": "2019-01-03T17:11:20.000Z",
		"storeLastWrite": "2025-02-05T11:33:11.766Z",
		"storeCreated": "2025-02-05T11:33:11.766Z",
		"activeStatus": "Active",
		"customData": {
			"created": "2019-01-03T17:11:20.000Z",
			"creator": "ATsoblefack"
		}
	}
]

Uruchom następujące polecenie curl, aby uzyskać obiekty docelowe dla określonego typu obiektu o identyfikatorze GUID.

curl --request GET \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<dataspace-name>/resources/<data-object-type>/<data-object-type-guid>/targets \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowe żądanie

Rozważmy zasób usługi Azure Data Manager for Energy o nazwie admetest z partycją danych o nazwie dp1 , a nazwa przestrzeni danych to demo/Volve. Chcesz pobrać wszystkie inne obiekty odwołujące się do określonego obiektu z identyfikatorem GUID aaaabbbb-0000-cccc-1111-dddd2222eeee.

curl --request GET \
  --url https://admetest.energy.azure.com/api/reservoir-ddms/v2/dataspaces/demo%2FVolve/resources/resqml20.obj_Grid2dRepresentation/aaaabbbb-0000-cccc-1111-dddd2222eeee/targets \
  --header 'Authorization: Bearer ey........' \
  --header 'data-partition-id: dp1'

Przykładowa odpowiedź

[
	{
		"uri": "eml:///dataspace('demo/Volve')/resqml20.obj_ContinuousProperty(c88bd325-59ba-4c5b-8b4c-d3b1d98be7c5)",
		"alternateUris": [],
		"name": "SnS_data_mismatch",
		"lastChanged": "2019-01-03T17:11:20.000Z",
		"storeLastWrite": "2025-02-05T11:33:11.766Z",
		"storeCreated": "2025-02-05T11:33:11.766Z",
		"activeStatus": "Active",
		"customData": {
			"created": "2019-01-03T17:11:20.000Z",
			"creator": "ATsoblefack"
		}
	},
	{
		"uri": "eml:///dataspace('demo/Volve')/resqml20.obj_SubRepresentation(2756ba3c-ece5-498b-9633-6b7ed279043a)",
		"alternateUris": [],
		"name": "SnS_faults_proximity",
		"lastChanged": "2019-01-03T17:11:20.000Z",
		"storeLastWrite": "2025-02-05T11:33:11.766Z",
		"storeCreated": "2025-02-05T11:33:11.766Z",
		"activeStatus": "Active",
		"customData": {
			"created": "2019-01-03T17:11:20.000Z",
			"creator": "ATsoblefack"
		}
	}
]

Uruchom następujące polecenie curl, aby usunąć przestrzeń danych.

curl --request DELETE \
  --url https://<adme_url>/api/reservoir-ddms/v2/dataspaces/<encoded_dataspace_id> \
  --header 'Authorization: Bearer <access-token>' \
  --header 'data-partition-id: <data-partition-id>'

Przykładowa odpowiedź:

Samouczek: Jak używać punktów końcowych API WebSocket Reservoir DDMS

Opinia

Czy ta strona była pomocna?

Ostatnia aktualizacja o 2026-11-07

Samouczek: Korzystanie z punktów końcowych interfejsu API Reservoir DDMS

Wymagania wstępne

Użyj interfejsów API Reservoir DDMS do odczytu danych o zbiornikach

Powiązane treści

Opinia

Dodatkowe zasoby