Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This article lists the error codes that can occur when ingesting or deleting geospatial data from a Microsoft Planetary Computer Pro GeoCatalog. Use this reference to identify the cause of ingestion failures and find resolution steps for each error type.
Ingestion errors can occur during various stages of the data ingestion process, including authentication, validation, transformation, and storage operations (adding and deleting). The following table provides detailed information about each error code, its meaning, and steps to resolve the issue.
Table of Error Codes:
| Code | Explanation | Troubleshooting |
|---|---|---|
AssetTransformationError |
The system failed to transform the asset during ingestion. | • Verify asset files are in a supported format • Check that asset files aren't corrupted • Ensure asset URLs are accessible from your ingestion source |
CogTransformationError |
The Cloud Optimized GeoTIFF (COG) transformation process failed. | • Ensure source files are valid GeoTIFF files with proper georeferencing information • Validate your files with GDAL tools before ingestion |
CogTransformationTimeout |
The COG transformation process exceeded the time limit, typically with very large files. | • Split large files into smaller tiles • Convert files to COG format before ingestion to skip transformation |
CanceledOperation |
The ingestion operation was manually canceled or terminated. | • No action required for intentional cancellations • Check system logs for automatic cancellation reasons |
CollectionDoesNotExist |
The STAC collection ID referenced in your ingestion request doesn't exist. | • Create the collection before attempting to ingest items into it |
EmptyAsset |
The asset file referenced in the STAC item has no content or is 0 bytes. | • Verify asset files exist at the specified URLs • Ensure asset files contain valid data |
ErrorsInBatchOperation |
One or more items in a bulk ingestion operation failed. | • Check operation details for specific item failures • Try ingesting failed items individually to isolate issues |
GenericHttpIngestionError |
A general HTTP error occurred while accessing ingestion resources. | • Check network connectivity • Verify all asset URLs are accessible • Review HTTP status codes in logs for specific issues |
GenericIngestionError |
An unspecified error occurred during ingestion. | • Check detailed error messages and system logs • Contact support if the issue persists |
ImportFileValidationFailed |
The STAC catalog or collection file failed validation. | Troubleshooting STAC validation errors |
IngestionAuthenticationFailed |
The GeoCatalog couldn't authenticate to the ingestion source. | Troubleshooting access permission issues |
IngestionResourceConnectionFailed |
Unable to establish connection to the storage container. | Troubleshooting access permission issues |
IngestionResourceForbidden |
The GeoCatalog lacks permissions to access the resource. | Troubleshooting access permission issues |
IngestionResourceTimeout |
The request to access the ingestion source exceeded the time limit. | • Retry the operation • Check Azure service health for outages • Verify network connectivity between GeoCatalog and storage |
IngestionResourceUriNotFound |
The specified asset or catalog URI doesn't exist. | Troubleshooting access permission issues |
InternalError |
An unexpected error occurred within the GeoCatalog service. | • Retry the operation • If the error persists, contact support with the operation ID and timestamp |
InternalIntermitentError |
A temporary internal error occurred. | • Wait a few minutes and retry the operation • These errors typically resolve automatically |
InvalidAssetHref |
The asset URL in the STAC item is malformed or invalid. | • Ensure all asset hrefs are properly formatted URLs • Use absolute URLs, not relative paths • Verify all URLs point to accessible resources |
InvalidGeoparquet |
The GeoParquet file doesn't meet the required format specifications. | • Validate GeoParquet files using appropriate tools • Ensure files contain valid geometry columns |
InvalidInputData |
The STAC item or collection data contains invalid fields or values. | Troubleshooting STAC validation errors |
InvalidStacCatalog |
The STAC catalog structure doesn't conform to specifications. | Troubleshooting STAC validation errors |
ItemAlreadyExistsInCollection |
A STAC item with the same ID already exists in the collection. | • Use unique IDs for each item • Delete the existing item before attempting to ingest again |
ItemSizeExceeded |
The STAC item JSON exceeds the maximum allowed size (1 MB). | • Reduce the number of assets or properties in the item • Split large items into multiple smaller items |
ItemTransformationError |
Failed to process or transform the STAC item. | Troubleshooting STAC validation errors |
ManagedIdentityInfoNotFound |
The specified managed identity doesn't exist or isn't associated with the GeoCatalog. | Troubleshooting access permission issues |
NoRecordsToDelete |
The delete operation didn't find any matching records. | • Verify the STAC item IDs or search criteria used for deletion • Confirm items exist in the specified collection |
NoRecordsToPatch |
The patch operation didn't find any matching records. | • Ensure the STAC items you're trying to update exist in the collection • Verify item IDs are correct |
NoRecordsToUpdate |
The update operation didn't find any matching records. | • Verify that the items exist before attempting updates • Check item IDs and collection IDs for accuracy |
OperationIsCanceled |
The ingestion operation was canceled before completion. | • Check if cancellation was intentional • Review system logs for automatic cancellation triggers |
OperationNotExistsInCollection |
The referenced operation ID doesn't exist for this collection. | • Verify you're using the correct operation ID and collection |
PatchValidation |
The patch operation contains invalid data or operations. | • Ensure your patch follows JSON Patch specifications • Verify patch operations target valid fields |
PostItemCollectionSizeExceeded |
The batch of items being posted exceeds the size limit. | • Reduce the number of items in a single request • Use the bulk ingestion API for large datasets |
PublicAccessRestricted |
The storage resource doesn't allow public access. | Troubleshooting access permission issues |
StacValidationFailed |
The STAC item doesn't meet validation requirements. | Troubleshooting STAC validation errors |
TotalAssetsExceeded |
The STAC item contains too many assets (100 assets max). | • Reduce the number of assets per item to below 100 • Split into multiple items |