# Bulk Data Export

Bulk data export refers to the capability to export large volumes of data, files, or resources from your IONOS Cloud infrastructure. It enables the efficient retrieval of substantial amounts of stored data for your contract, streamlining your data management process.

{% hint style="info" %}
**Note:** Bulk data export can be requested through [<mark style="color:blue;">IONOS Cloud Support</mark>](https://docs.ionos.com/cloud/support/general-information/contact-information). To export additional information, you can use the [<mark style="color:blue;">Cloud API</mark>](#products-eligible-for-request-based-data-export) provided by the respective product as mentioned in the [<mark style="color:blue;">FAQ</mark>](https://docs.ionos.com/sections-test/guides/self-data-export#what-information-is-included-when-exporting-metadata-via-the-api).
{% endhint %}

## Secure Data Export Request

To facilitate secure data export from your account, all export requests are initiated through [<mark style="color:blue;">IONOS Cloud Support</mark>](https://docs.ionos.com/cloud/support/general-information/contact-information), which enforces a rigorous encryption and verification protocol. This protocol utilizes [<mark style="color:blue;">Pretty Good Privacy (PGP) key</mark>](https://docs.ionos.com/sections-test/guides/security-safeguards/report-security-event/vulnerabilities#how-to-report) encryption to safeguard data during transmission and requires the provision of authenticated access credentials for the Object Storage environment in your account to save the exported data.

{% hint style="info" %}
**Note:**

* **Single Export per Contract:** We can process only one export request per contract at a time. This limitation exists because data collection is a resource-intensive and time-consuming process.
* **Contract Owner Access Required:** You must be a contract owner to initiate export requests. This ensures that data access is authorized correctly and aligned with organizational security and compliance policies.
  {% endhint %}

The following procedure lists the steps for requesting a secure data export, from initial request submission to receipt of the encrypted data in the designated Object Storage bucket.

{% stepper %}
{% step %}

#### Initiate a data export from your account

To initiate a data export from your account, contact [<mark style="color:blue;">IONOS Cloud Support</mark>](https://docs.ionos.com/cloud/support/general-information/contact-information) and provide the following information to ensure secure encryption of the exported data:

* **Contract Number and Support PIN:** These are mandatory to authenticate your request.
* **Object Storage Details:** Specify the **Endpoint URL**, **Target Bucket Name**, **Access Key** and the **Secret Access Key**.
* **PGP Public Key:** Share your PGP public key, which will be used to encrypt the exported data before delivery to Object Storage. For more information about data encryption, see [<mark style="color:blue;">PGP key</mark>](https://docs.ionos.com/sections-test/guides/security-safeguards/report-security-event/vulnerabilities#how-to-report).
  {% endstep %}

{% step %}

#### Information validation, data extraction, and delivery to Object Storage

After validating the necessary information received from you, the support team initiates an export request and uploads your data in an encrypted format to the designated Object Storage bucket in your account.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Result:** You can access the exported data from your account and decrypt it using your PGP key.
{% endhint %}

{% hint style="info" %}
**Info:** For further information about specific file types and tools that can be used to self-extract bulk data for specific products or services, see [<mark style="color:blue;">Self-Export</mark>](#file-types-and-tools-used-for-products-or-services).
{% endhint %}

## Products eligible for request-based data export

Data from the specific products listed below can only be exported in bulk by submitting a request to [<mark style="color:blue;">IONOS Cloud Support</mark>](https://docs.ionos.com/cloud/support/general-information/contact-information).

| **Product Categories** | **Products**                                                                                                                                     | **Availability**     |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------- |
| Containers             | [<mark style="color:blue;">Managed Kubernetes</mark>](https://docs.ionos.com/sections-test/guides/containers/managed-kubernetes)                 | :white\_check\_mark: |
| Containers             | [<mark style="color:blue;">Private Container Registry</mark>](https://docs.ionos.com/sections-test/guides/containers/private-container-registry) | :white\_check\_mark: |
| Data Analytics         | [<mark style="color:blue;">Event Streams for Apache Kafka</mark>](https://docs.ionos.com/sections-test/guides/data-analytics/kafka)              | :white\_check\_mark: |
| Databases              | [<mark style="color:blue;">In-Memory DB</mark>](https://docs.ionos.com/sections-test/guides/databases/in-memory-db)                              | :white\_check\_mark: |
| Databases              | [<mark style="color:blue;">MariaDB</mark>](https://docs.ionos.com/sections-test/guides/databases/mariadb)                                        | :white\_check\_mark: |
| Databases              | [<mark style="color:blue;">MongoDB</mark>](https://docs.ionos.com/sections-test/guides/databases/mongodb)                                        | :white\_check\_mark: |
| Databases              | [<mark style="color:blue;">PostgreSQL</mark>](https://docs.ionos.com/sections-test/guides/databases/postgresql)                                  | :white\_check\_mark: |
| Observability          | [<mark style="color:blue;">Logging Service</mark>](https://docs.ionos.com/sections-test/guides/observability/logging-service)                    | :white\_check\_mark: |
| Observability          | [<mark style="color:blue;">Monitoring Service</mark>](https://docs.ionos.com/sections-test/guides/observability/monitoring-service)              | :white\_check\_mark: |
| Storage & Backup       | [<mark style="color:blue;">Block Storage</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/block-storage)                   | :white\_check\_mark: |
| Storage & Backup       | [<mark style="color:blue;">Network File Storage</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/network-file-storage)     | :white\_check\_mark: |

## Standardized file naming conventions for exported data files

* Each exported file uses the corresponding product name as its filename prefix. The file extension reflects the original data format. Example: `.json` for a `JSON` file.
* If the file is compressed before encryption, a `.gz` extension is appended to denote `gzip` compression.
* All exported files are encrypted using a PGP key, and the `.pgp` extension is added as the final suffix. Examples:
  * `example.json.gz.pgp`: A `JSON` file that is compressed first and encrypted later.
  * `example.tld.pgp`: A `TLD` file that is encrypted without compression.

## File types and tools used for products or services

1\. If you have requested your data using the automated bulk data export option, we extract your data, compress it into a .gz archive, and encrypt it using your PGP key.

2\. You can decrypt your compressed file and extract the data using appropriate tools. The following table lists the supported tools for data export, along with the relevant formats and structures.

| **Product Categories** | **Products**                                                                                                                                     | **Format or Structure**                                                               | **Supported Tools**                                                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Containers             | [<mark style="color:blue;">Managed Kubernetes</mark>](https://docs.ionos.com/sections-test/guides/containers/managed-kubernetes)                 | "velero style"                                                                        | You can manually export using `find /export -name "*.json" -print0 \| xargs -0 kubectl apply -f`. |
| Containers             | [<mark style="color:blue;">Private Container Registry</mark>](https://docs.ionos.com/sections-test/guides/containers/private-container-registry) | Copy of the registry storage filesystem                                               | `docker compose`                                                                                  |
| Data Analytics         | [<mark style="color:blue;">Event Streams for Apache Kafka</mark>](https://docs.ionos.com/sections-test/guides/data-analytics/kafka)              | PGP-encrypted and a gzipped tarball containing a JSON array file for each Kafka topic | Continuously read JSON messages from the stream and write them to the corresponding Kafka topics. |
| Databases              | [<mark style="color:blue;">In-Memory DB</mark>](https://docs.ionos.com/sections-test/guides/databases/in-memory-db)                              | RDB file, including ACL, and configuration                                            | Move the files to the default directories used by a standard Redis installation.                  |
| Databases              | [<mark style="color:blue;">MariaDB</mark>](https://docs.ionos.com/sections-test/guides/databases/mariadb)                                        | SQL files with grants, data, and configuration                                        | `mariadb`                                                                                         |
| Databases              | [<mark style="color:blue;">MongoDB</mark>](https://docs.ionos.com/sections-test/guides/databases/mongodb)                                        | `binary dump` (via `mongodump`)                                                       | `mongorestore`. Ensure you use the `--archive` option.                                            |
| Databases              | [<mark style="color:blue;">PostgreSQL</mark>](https://docs.ionos.com/sections-test/guides/databases/postgresql)                                  | `SQL dump` (via `pg_dump`)                                                            | `psql`                                                                                            |
| Network Services       | [<mark style="color:blue;">Cloud DNS</mark>](https://api.ionos.com/docs/dns/v1/)                                                                 | `JSON` export                                                                         | You can manually export using `JSON` export.                                                      |
| Observability          | [<mark style="color:blue;">Logging Service</mark>](https://docs.ionos.com/sections-test/guides/observability/logging-service)                    | Loki streams are Pipe (\|) -delimited, Zstandard compressed CSV                       | `zstd - https://facebook.github.io/zstd/`                                                         |
| Storage & Backup       | [<mark style="color:blue;">Block Storage</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/block-storage)                   | Raw images with Linux Raid-Header                                                     | Linux command line tool `dd`                                                                      |
| Storage & Backup       | [<mark style="color:blue;">Network File Storage</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/network-file-storage)     | `tar` - ball                                                                          | Linux command line tool `tar`.                                                                    |

## FAQ

### Does the exported data include metadata?

The exported data does not contain any associated metadata. To access metadata, use the provided API in self-export mode. For more information, see [<mark style="color:blue;">Self-Export</mark>](https://docs.ionos.com/sections-test/guides/data-export/self-data-export).