You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/planetary-computer/bulk-ingestion-api.md
+16-15Lines changed: 16 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,24 +13,24 @@ ms.date: 04/18/2024
13
13
14
14
This article shows you how to ingest many geospatial data assets at once into a GeoCatalog using the Bulk Ingestion API. First, we create and configure a GeoCatalog Ingestion Source. Creating an Ingestion Source establishes a secure connection between a GeoCatalog resource and the storage location for your existing geospatial data. Next, we create a SpatioTemporal Access Catalog (STAC) Collection within your GeoCatalog resource to store the data being ingested. Finally, we use the Bulk Ingestion API to initiate the ingestion workflow. When you're finished completing these steps, your geospatial data is ingested and accessible from the GeoCatalog UIs and APIs.
15
15
16
-
:::image type="content" source="media/static_catalog_import.png" alt-text="Diagram illustrating the static catalog import process for GeoCatalog, showing data flow from storage to GeoCatalog via the Bulk Ingestion API.":::
16
+
:::image type="content" source="media/static-catalog-import.png" alt-text="Diagram illustrating the static catalog import process for GeoCatalog, showing data flow from storage to GeoCatalog via the Bulk Ingestion API.":::
A geospatial dataset in your storage account blob container:
25
-
1. Geospatial data assets (for example, GeoTIFF files)
26
-
1. The associated STAC Items [Create STAC Items](./create-stac-item.md) for these assets.
27
-
1. A STAC Collection JSON that references all the STAC Items and geospatial data assets.
25
+
- Geospatial data assets (for example, GeoTIFF files)
26
+
- The associated STAC Items [Create STAC Items](./create-stac-item.md) for these assets.
27
+
- A STAC Collection JSON that references all the STAC Items and geospatial data assets.
28
28
29
29
In your local / development environment:
30
30
31
-
1. A Python environment running Python 3.8, or later.
32
-
1.[Azure CLI](/cli/azure/install-azure-cli)
33
-
1. You're [signed in to Azure](/cli/azure/authenticate-azure-cli-interactively)
31
+
- A Python environment running Python 3.8, or later.
32
+
-[Azure CLI](/cli/azure/install-azure-cli)
33
+
- You're [signed in to Azure](/cli/azure/authenticate-azure-cli-interactively)
34
34
35
35
Microsoft Planetary Computer Pro must have access to the Azure Blob Storage container. In this article, we create and use a temporary SAS token credential to grant this access. Alternatively, you can use these guides to set up Managed Identity or hard-coded SAS Tokens.
36
36
@@ -148,10 +148,10 @@ Creating an ingestion source defines for GeoCatalog which source to ingest geosp
148
148
```
149
149
> [!NOTE]
150
150
> Running these steps more than once back-to-back results in a 409 response:
151
-
152
-
```Container url <container uri> already contains a SAS token ingestion source with id <sas token id>```
153
-
154
-
The ingestion source API doesn't allow you to create more than one ingestion source for the same container URL. To avoid conflicts, ensure you clean up any existing ingestion sources before creating a new one. For details, see [Clean up resources](#clean-up-resources).
151
+
>
152
+
>```Container url <container uri> already contains a SAS token ingestion source with id <sas token id>```
153
+
>
154
+
>The ingestion source API doesn't allow you to create more than one ingestion source for the same container URL. To avoid conflicts, ensure you clean up any existing ingestion sources before creating a new one. For details, see [Clean up resources](#clean-up-resources).
155
155
156
156
## Create Collection
157
157
@@ -202,8 +202,9 @@ A STAC collection is the high-level container for STAC Items and their associate
202
202
"msft:short_description": "An example collection",
203
203
}
204
204
```
205
+
205
206
> [!NOTE]
206
-
> This sample collection specification is a basic example of a collection. For more information on STAC collections and the STAC open standard, see the [STAC overview](./stac-overview.md). For a guide creating a complete STAC collection, see [Create STAC Collection](./create-stac-collection.md).
207
+
> This sample collection specification is a basic example of a collection. For more information on STAC collections and the STAC open standard, see the [STAC overview](./stac-overview.md). For more information about creating a complete STAC collection, see [Create STAC Collection](./create-stac-collection.md).
207
208
208
209
1. Create the new collection with the Collection API
209
210
@@ -316,7 +317,7 @@ Once the workflow is complete, you can query, retrieve, or visualize your geospa
0 commit comments