When creating or updating a resource that doesn't have an id, if you supply a parameter dataset, then the resource will be assigned to that dataset and it will be compared to resources in that dataset. If a match is found, then the resource will be given the corresponding id and that resource on HDX will be overwritten.

Author: mcarans

documentation/index.md

@@ -899,6 +899,13 @@ The built-in configuration assumes data will be of form similar to below:
 
 ## Resource Specific Operations
 
+When creating or updating a resource that doesn't have an id, if you supply a parameter
+dataset, then the resource will be assigned to that dataset and it will be compared to
+resources in that dataset. If a match is found, then the resource will be given the
+corresponding id and that resource on HDX will be overwritten.
+
+    resource.create_in_hdx(dataset=DATASET)
+
 You can download a resource using the **download** function eg.
 
     url, path = resource.download("FOLDER_TO_DOWNLOAD_TO")

tests/hdx/data/test_resource.py

@@ -12,6 +12,7 @@
 from .. import MockResponse, dataset_resultdict, resource_data
 from .test_resource_view import resource_view_list, resource_view_mocklist
 from hdx.api.configuration import Configuration
+from hdx.data.dataset import Dataset
 from hdx.data.hdxobject import HDXError
 from hdx.data.resource import Resource
 from hdx.utilities.dateparse import parse_date
@@ -1068,3 +1069,16 @@ def test_get_api_url(self, configuration, read):
         )
         del resource["id"]
         assert resource.get_api_url() is None
+
+    def test_get_resource_id(self, configuration, read):
+        resources = [
+            {"id": "abcd", "name": "test_resource", "format": "CSV"},
+            {"id": "efgh", "name": "test_resource2", "format": "CSV"},
+            {"id": "ijkl", "name": "test_resource2", "format": "XLSX"},
+        ]
+        dataset = Dataset({"id": "1234", "name": "test_dataset", "format": "CSV"})
+        dataset.add_update_resources(resources)
+
+        resource = Resource({"name": "test_resource2", "format": "CSV"})
+        result = resource._get_resource_id(dataset=dataset)
+        assert result == "efgh"