# Self Data Export

Self Data Export refers to the capability to export metadata from your IONOS Cloud infrastructure using API or specific tools.

## Products for self data export

Metadata from the specific products listed below can be exported manually.

| **Product Categories** | **Products**                                                                                                                                                              | **Export Metadata using API**                                                                                                                      |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| AI                     | [<mark style="color:blue;">AI Model Hub</mark>](https://docs.ionos.com/sections-test/guides/ai/ai-model-hub)                                                              | [<mark style="color:blue;">Retrieve Data using AI Model Hub API</mark>](https://api.ionos.com/docs/inference-modelhub/v1/)                         |
| Compute Services       | [<mark style="color:blue;">Virtual Servers (Dedicated Core Servers and vCPU Servers)</mark>](https://docs.ionos.com/sections-test/guides/compute-services/compute-engine) | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/cloud/v6/#tag/Servers)                                             |
| Compute Services       | [<mark style="color:blue;">Cubes</mark>](https://docs.ionos.com/sections-test/guides/compute-services/cubes)                                                              | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/cloud/v6/#tag/Templates)                                           |
| Containers             | [<mark style="color:blue;">Managed Kubernetes</mark>](https://docs.ionos.com/sections-test/guides/containers/managed-kubernetes)                                          | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/cloud/v6/#tag/Kubernetes)                                          |
| Containers             | [<mark style="color:blue;">Private Container Registry</mark>](https://docs.ionos.com/sections-test/guides/containers/private-container-registry)                          | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/containerregistry/v1/#tag/Registries/operation/registriesFindById) |
| Data Analytics         | [<mark style="color:blue;">Event Streams for Apache Kafka</mark>](https://docs.ionos.com/sections-test/guides/data-analytics/kafka)                                       | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/kafka/v1/#tag/Users)                                               |
| Databases              | [<mark style="color:blue;">In-Memory DB</mark>](https://docs.ionos.com/sections-test/guides/databases/in-memory-db)                                                       | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/in-memory-db/v1/#tag/ReplicaSet/operation/replicasetsGet)          |
| Databases              | [<mark style="color:blue;">MariaDB</mark>](https://docs.ionos.com/sections-test/guides/databases/mariadb)                                                                 | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/mariadb/v1/#tag/ReplicaSet)                                        |
| Databases              | [<mark style="color:blue;">MongoDB</mark>](https://docs.ionos.com/sections-test/guides/databases/mongodb)                                                                 | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/mongodb/v1/#tag/Clusters)                                          |
| Databases              | [<mark style="color:blue;">PostgreSQL</mark>](https://docs.ionos.com/sections-test/guides/databases/postgresql)                                                           | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/postgresql/v1/#tag/Clusters/operation/clustersGet)                 |
| Network Services       | [<mark style="color:blue;">CDN with built-in WAF</mark>](https://docs.ionos.com/sections-test/guides/network-services/cdn)                                                | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/cdn/v1/)                                                           |
| Network Services       | [<mark style="color:blue;">Cloud DNS</mark>](https://docs.ionos.com/sections-test/guides/network-services/cloud-dns)                                                      | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/dns/v1/)                                                           |
| Network Services       | [<mark style="color:blue;">Managed Application Load Balancer (ALB)</mark>](https://docs.ionos.com/sections-test/guides/network-services/application-load-balancer)        | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/cloud/v6/#tag/Application-Load-Balancers)                          |
| Network Services       | [<mark style="color:blue;">Managed NAT Gateway</mark>](https://docs.ionos.com/sections-test/guides/network-services/nat-gateway)                                          | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/cloud/v6/#tag/NAT-Gateways)                                        |
| Network Services       | [<mark style="color:blue;">Managed Network Load Balancer (NLB)</mark>](https://docs.ionos.com/sections-test/guides/network-services/network-load-balancer)                | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/cloud/v6/#tag/Network-Load-Balancers)                              |
| Network Services       | [<mark style="color:blue;">VM Autoscaling</mark>](https://docs.ionos.com/sections-test/guides/network-services/vm-auto-scaling)                                           | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/vmautoscaling/v1.ea/)                                              |
| Network Services       | [<mark style="color:blue;">VPN Gateway</mark>](https://docs.ionos.com/sections-test/guides/network-services/vpn-gateway)                                                  | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/vpn/v1/)                                                           |
| Observability          | [<mark style="color:blue;">Activity Logs</mark>](https://docs.ionos.com/sections-test/guides/observability/activity-logs)                                                 | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/activitylog/v1/)                                                   |
| Observability          | [<mark style="color:blue;">Logging Service</mark>](https://docs.ionos.com/sections-test/guides/observability/logging-service)                                             | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/logging/v1/#tag/Pipelines/operation/pipelinesGet)                  |
| Observability          | [<mark style="color:blue;">Monitoring Service</mark>](https://docs.ionos.com/sections-test/guides/observability/monitoring-service)                                       | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/monitoring/v1/#tag/)                                               |
| Storage & Backup       | [<mark style="color:blue;">Block Storage</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/block-storage)                                            | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/cloud/v6/#tag/Servers/operation/datacentersServersVolumesGet)      |
| Storage & Backup       | [<mark style="color:blue;">Network File Storage</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/network-file-storage)                              | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/nfs/v1/#tag/Clusters)                                              |
| Storage & Backup       | [<mark style="color:blue;">IONOS Cloud Object Storage</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/ionos-object-storage)                        | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/object-storage/v2/)                                                |
| Security               | [<mark style="color:blue;">Certificate Manager</mark>](https://docs.ionos.com/sections-test/guides/security/certificate-manager)                                          | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/certificatemanager/v2/)                                            |

| **Services**                                                                                                                                                                                    | **Export option**                                                                                                                                                                                           |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [<mark style="color:blue;">VDC</mark>](https://docs.ionos.com/sections-test/guides/set-up-ionos-cloud/get-started/configure-data-center)                                                        | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/dns/v1/#tag/Servers)                                                                                                        |
| [<mark style="color:blue;">Identity & Access Management (IAM)</mark>](https://docs.ionos.com/sections-test/guides/set-up-ionos-cloud/management/identity-access-management/iam-federation)      | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/identity-federation/v1/)                                                                                                    |
| [<mark style="color:blue;">IAM Password Policy Service</mark>](https://docs.ionos.com/sections-test/guides/set-up-ionos-cloud/management/identity-access-management/password-policy-management) | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/identity-policy/v1/)                                                                                                        |
| [<mark style="color:blue;">IAM Token Manager</mark>](https://docs.ionos.com/sections-test/guides/set-up-ionos-cloud/management/identity-access-management/token-manager)                        | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/authentication/v1/)                                                                                                         |
| [<mark style="color:blue;">Billing Service</mark>](https://docs.ionos.com/sections-test/guides/set-up-ionos-cloud/management/usage)                                                             | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/billing/v3/)                                                                                                                |
| [<mark style="color:blue;">Reseller Service</mark>](https://docs.ionos.com/sections-test/guides/set-up-ionos-cloud/account-management)                                                          | [<mark style="color:blue;">Retrieve metadata</mark>](https://api.ionos.com/docs/reseller/v2/)                                                                                                               |
| [<mark style="color:blue;">Acronis Backup</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/backup-service/how-tos/install-acronis-backup-agent)                           | For more information, refer to the [<mark style="color:blue;">Acronis Documentation</mark>](https://www.acronis.com/en/support/documentation/CyberProtectionService/#creating-backup-replication-plan.html) |

## What information is included when exporting metadata via the API?

The platform provides metadata that includes various details such as the `number of CPUs`, allocated `ram`, `nics`, firewall settings, and specific product information. It also includes the `UUID` for each resource, its creation and modification history, and current status.

Additionally, the API response provides extra information whenever applicable. For example, when configuring Kubernetes node pools and performing a [<mark style="color:blue;">Get Kubernetes Clusters API request</mark>](https://api.ionos.com/docs/cloud/v6/#tag/Kubernetes/operation/k8sGet), the metadata specifies parameters such as the utilized Kubernetes version, total node count, and individual node configurations, compute resources, and network settings.

The following examples display the metadata retrieved using the Cloud API in its response:

<details>

<summary><strong>Metadata retrieved using the Get Kubernetes Clusters API</strong></summary>

**Endpoint:** `https://api.ionos.com/cloudapi/v6/k8s`\
**Metadata:**

```bash
{
  "id": "k8s",
  "type": "collection",
  "href": "https://api.ionos.com/cloudapi/v6/k8s",
  "items": [
    {
      "id": "1e072e52-2ed3-492f-b6b6-c6b116907527",
      "type": "k8s",
      "href": "https://api.ionos.com/cloudapi/v6/k8s/b0a6ed23-0636-4bd4-94aa-be01c355af1d",
      "metadata": {
        "etag": "45480eb3fbfc31f1d916c1eaa4abdcc3",
        "createdDate": "2015-12-04T14:34:09.809Z",
        "createdBy": "user@example.com",
        "createdByUserId": "user@example.com",
        "lastModifiedDate": "2015-12-04T14:34:09.809Z",
        "lastModifiedBy": "user@example.com",
        "lastModifiedByUserId": "63cef532-26fe-4a64-a4e0-de7c8a506c90",
        "state": "AVAILABLE"
      },
      "properties": {
        "name": "k8s",
        "k8sVersion": "1.15.4",
        "maintenanceWindow": {
          "dayOfTheWeek": "Monday",
          "time": "13:00:00"
        },
        "availableUpgradeVersions": [
          "1.16.4",
          "1.17.7"
        ],
        "viableNodePoolVersions": [
          "1.17.7",
          "1.18.2"
        ],
        "public": true,
        "location": "de/fra",
        "natGatewayIp": "198.51.100.100",
        "nodeSubnet": "192.168.0.0/16",
        "apiSubnetAllowList": [
          "1.2.3.4/32",
          "2002::1234:abcd:ffff:c0a8:101/64",
          "1.2.3.4",
          "2002::1234:abcd:ffff:c0a8:101"
        ],
        "s3Buckets": [
          {
            "name": "My Bucket"
          }
        ]
      },
      "entities": {
        "nodepools": {
          "id": "1e072e52-2ed3-492f-b6b6-c6b116907527/nodepools",
          "type": "collection",
          "href": "https://api.ionos.com/cloudapi/v6/k8s/30f8a4f6-6515-4c34-b49d-dea807453b90/nodepools",
          "items": [
            {
              "id": "1e072e52-2ed3-492f-b6b6-c6b116907527",
              "type": "nodepool",
              "href": "https://api.ionos.com/cloudapi/v6/k8s/30f8a4f6-6515-4c34-b49d-dea807453b90/nodepools/4735f530-4279-42f3-9562-386143098038",
              "metadata": {
                "etag": "45480eb3fbfc31f1d916c1eaa4abdcc3",
                "createdDate": "2015-12-04T14:34:09.809Z",
                "createdBy": "user@example.com",
                "createdByUserId": "user@example.com",
                "lastModifiedDate": "2015-12-04T14:34:09.809Z",
                "lastModifiedBy": "user@example.com",
                "lastModifiedByUserId": "63cef532-26fe-4a64-a4e0-de7c8a506c90",
                "state": "AVAILABLE"
              },
              "properties": {
                "name": "K8s-node-pool",
                "datacenterId": "1e072e52-2ed3-492f-b6b6-c6b116907521",
                "nodeCount": 2,
                "serverType": "DedicatedCore",
                "cpuFamily": "INTEL_ICELAKE",
                "coresCount": 4,
                "ramSize": 2048,
                "availabilityZone": "AUTO",
                "storageType": "HDD",
                "storageSize": 100,
                "k8sVersion": "1.15.4",
                "maintenanceWindow": {
                  "dayOfTheWeek": "Monday",
                  "time": "13:00:00"
                },
                "autoScaling": {
                  "minNodeCount": 1,
                  "maxNodeCount": 3
                },
                "lans": [
                  {
                    "routes": []
                  }
                ],
                "labels": {
                  "property1": "string",
                  "property2": "string"
                },
                "annotations": {
                  "property1": "string",
                  "property2": "string"
                },
                "publicIps": [
                  "81.173.1.2",
                  "82.231.2.5",
                  "92.221.2.4"
                ],
                "availableUpgradeVersions": [
                  "1.16.4",
                  "1.17.7"
                ]
              }
            }
          ]
        }
      }
    }
  ]
}
```

</details>

<details>

<summary><strong>Metadata retrieved using the PostgreSQL List Clusters API</strong></summary>

**Endpoint:** `https://api.ionos.com/databases/postgresql/clusters`\
**Metadata:**

```bash
{
    "type": "cluster",
    "id": "498ae72f-411f-11eb-9d07-046c59cc737e",
    "metadata": {
        "createdDate": "2020-12-10T13:37:50+01:00",
        "createdBy": "john.doe@example.com",
        "createdByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
        "lastModifiedDate": "2020-12-11T13:37:50+01:00",
        "lastModifiedBy": "jane.doe@example.com",
        "lastModifiedByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
        "state": "AVAILABLE"
    },
    "properties": {
        "displayName": "PostgreSQL cluster",
        "postgresVersion": "13",
        "location": "de/fra",
        "dnsName": "pg.example.com",
        "backupLocation": "de",
        "instances": 2,
        "ram": 2048,
        "cores": 4,
        "storageSize": 15000,
        "storageType": "HDD",
        "connections": [
            {
                "datacenterId": "5a029f4a-72e5-11ec-90d6-0242ac120003",
                "lanId": "2",
                "cidr": "192.168.1.100/24"
            }
        ],
        "maintenanceWindow": {
            "time": "16:30:59",
            "dayOfTheWeek": "Monday"
        },
        "synchronizationMode": "ASYNCHRONOUS",
        "connectionPooler": {
            "enabled": true,
            "poolMode": "transaction"
        }
    }
}
```

</details>

<details>

<summary><strong>Metadata retrieved using the Block Storage Get Attached Volumes API</strong></summary>

**Endpoint:** `https://api.ionos.com/cloudapi/v6/datacenters/{datacenterId}/servers/{serverId}/volumes`\
**Metadata:**

```bash
{
  "id": "15f67991-0f51-4efc-a8ad-ef1fb31a480c",
  "type": "collection",
  "href": "<RESOURCE-URI>",
  "items": [
    {
      "id": "15f67991-0f51-4efc-a8ad-ef1fb31a480c",
      "type": "volume",
      "href": "<RESOURCE-URI>",
      "metadata": {
        "etag": "45480eb3fbfc31f1d916c1eaa4abdcc3",
        "createdDate": "2015-12-04T14:34:09.809Z",
        "createdBy": "user@example.com",
        "createdByUserId": "user@example.com",
        "lastModifiedDate": "2015-12-04T14:34:09.809Z",
        "lastModifiedBy": "user@example.com",
        "lastModifiedByUserId": "63cef532-26fe-4a64-a4e0-de7c8a506c90",
        "state": "AVAILABLE"
      },
      "properties": {
        "name": "My resource",
        "type": "HDD",
        "size": 100,
        "availabilityZone": "AUTO",
        "image": "d6ad1576-fde9-4696-aa41-1ebd75bdaf49",
        "imagePassword": "mypass123",
        "imageAlias": "string",
        "sshKeys": [
          "ssh-rsa AAAAB3NzaC1yc2EA",
          "ssh-rsa AAAAB3NzaC1yc2EAAAA"
        ],
        "bus": "VIRTIO",
        "licenceType": "LINUX",
        "applicationType": "MSSQL-2019-Standard",
        "cpuHotPlug": true,
        "ramHotPlug": true,
        "nicHotPlug": true,
        "nicHotUnplug": true,
        "discVirtioHotPlug": true,
        "discVirtioHotUnplug": true,
        "exposeSerial": true,
        "requireLegacyBios": true,
        "deviceNumber": 3,
        "pciSlot": 7,
        "backupunitId": "25f67991-0f51-4efc-a8ad-ef1f1a481c",
        "userData": "string",
        "bootServer": "25f67991-0f51-4efc-a8ad-ef1fb1a481c",
        "bootOrder": "AUTO"
      }
    }
  ],
  "offset": 0,
  "limit": 1000,
  "_links": {
    "prev": "<PREVIOUS-PAGE-URI>",
    "self": "<THIS-PAGE-URI>",
    "next": "<NEXT-PAGE-URI>"
  }
}
```

</details>