docs(data-connectors): note get_source_metadata is Grain-only (501 otherwise)

kdr · kdr · commit e54232be8465 · 2026-06-03T11:18:53.000-07:00
diff --git a/cloudglue/client/resources/data_connectors.py b/cloudglue/client/resources/data_connectors.py
@@ -103,6 +103,9 @@ def get_source_metadata(self, connector_id: str, url: str):
         Returns provider-specific metadata (e.g. Grain recording details) for a
         single file in a connected data source, without importing it.
 
+        Note: currently only supported for Grain connectors. Other connector
+        types raise a CloudglueError with status 501 (Not Implemented).
+
         Args:
             connector_id: The ID of the data connector.
             url: Connector URI to look up. Must match the connector's type.
@@ -111,7 +114,8 @@ def get_source_metadata(self, connector_id: str, url: str):
             SourceMetadataResponse object.
 
         Raises:
-            CloudglueError: If there is an error fetching source metadata.
+            CloudglueError: If there is an error fetching source metadata
+                (including 501 for non-Grain connectors).
         """
         try:
             return self.api.get_data_connector_source_metadata(
