---
title: "Cloud Resources Upload"
slug: "cloud-resources-upload"
updated: 2025-06-25T15:30:24Z
published: 2025-06-25T15:30:24Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.nucleussec.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloud Resources Upload

## Overview

FlexConnect allows Nucleus users to import cloud resource assets using a structured JSON format. This approach is particularly useful for integrating external asset sources such as cloud inventory tools, CSPM platforms, or custom discovery pipelines directly into Nucleus. Each resource entry must follow Nucleus’ schema for cloud assets to ensure successful ingestion, deduplication, and enrichment.

This document provides an overview of the expected JSON structure and a working example featuring multiple cloud resource assets from different providers. This example can serve as a template for developing your own integrations or troubleshooting custom uploads.

For full schema, please refer to the [FlexConnect Data Schema](/v1/docs/flexconnect-framework) help article

> [!WARNING]
> Asset Types Supported
> 
> Please note that if you are uploading a Virtual Machine, Code Repository, Container Image, or Web application URL to use the relevant asset schema. This model is meant to reflect cloud resources that are of the type “non-compute”

## Example JSON Data

```plaintext
{
    "nucleus_import_version": 1,
    "scan_tool": "Cloud Resource Scanner",
    "scan_type": "Host",
    "assets": [
    {
      // AWS Cloud resource example (cloud resource model)
      "provider": "AWS",
      "account_id": "123456789012",
      "resource_name": "arn:aws:glacier:eu-north-1:520600265607:vaults/test@/1234abcdef",
      "urn": "arn:aws:glacier:eu-north-1:520600265607:vaults/test@/1234abcdef",
      "asset_type": "cloud_resource",
      "region": "eu-north-1",
      "findings": [
                {
                    "finding_type": "COMPLIANCE",
                    "finding_number": "PASSWORD-1",
                    "finding_name": "Weak Password",
                    "finding_severity": "Critical",
                    "finding_description": "According to the configuration scan, the bucket is using a default or weak password.",
                    "finding_recommendation": "Change the password.",
                    "finding_exploitable": "false",
                    "finding_references": {
                        "CVSS Base Score": "10.0",
                        "Test ID": "12345"
                    },
                    "finding_output": "The password failed the configuration check on this API endpoint: 'https://test.example.com:8080'",
                    "finding_port": "8080/tcp",
                    "finding_service": "https"
                }
            ]
    },
    {
      // AWS Virtual Machine example (Host model)
      "host_name": "virtual_machine_name_here.ec2"       
      "asset_type": "host",
      "asset_info": [
        {
          "aws.resource_name": "arn:aws:ec2:us-west-2:123456789012:instance/i-0abc123def456gh78",
          "aws.account_id": "123456789012",
          "aws.arn": "arn:aws:ec2:us-west-2:123456789012:instance/i-0abc123def456gh78",
          "aws.region": "us-east-1"
        }
        ]
      "findings": [
                {
                    "finding_type": "Vuln",
                    "finding_number": "NETWORK-1",
                    "finding_name": "Operating System EOL",
                    "finding_severity": "Critical",
                    "finding_description": "According to the version number, the operating system on the remote host is no longer supported.",
                    "finding_recommendation": "Upgrade to a version of the operating system that is currently supported.",
                    "finding_exploitable": "false",
                    "finding_references": {
                        "CVSS Base Score": "10.0",
                        "Test ID": "12345"
                    },
                    "finding_output": "Support for Example Operating System ended on 1970-01-01. Upgrade to the latest version.",
                    "finding_port": "0/tcp",
                    "finding_service": "general"
                }
            ]
    },
    {
      // GCP Example cloud resource
      "provider": "GCP",
      "account_id": "cicd-prod",
      "resource_name": "//storage.googleapis.com/projects/my-project-123/buckets/my-bucket",
      "urn": "//compute.googleapis.com/projects/cicd-prod/zones/us-central1-a/instances/gce-vm-1",
      "asset_type": "cloud_resource",
      "region": "us-central1-a",
      "findings": [
                {
                    "finding_type": "Vuln",
                    "finding_number": "NETWORK-1",
                    "finding_name": "Operating System EOL",
                    "finding_severity": "Critical",
                    "finding_description": "According to the version number, the operating system on the remote host is no longer supported.",
                    "finding_recommendation": "Upgrade to a version of the operating system that is currently supported.",
                    "finding_exploitable": "false",
                    "finding_references": {
                        "CVSS Base Score": "10.0",
                        "Test ID": "12345"
                    },
                    "finding_output": "Support for Example Operating System ended on 1970-01-01. Upgrade to the latest version.",
                    "finding_port": "0/tcp",
                    "finding_service": "general"
                }
            ]
    },
    {
      // GCP Virtual Machine example (Host model)
      "host_name": "gce-vm-1"       
      "asset_type": "host",
      "asset_info": [
        {
          "gcp.resource_name": "//compute.googleapis.com/projects/cicd-prod/zones/us-central1-a/instances/gce-vm-1",
          "gcp.account_id": "cicd-prod",
          "gcp.urn": "//compute.googleapis.com/projects/cicd-prod/zones/us-central1-a/instances/gce-vm-1",
          "gcp.region": "us-central1-a"
        }
        ]
      "findings": [
                {
                    "finding_type": "Vuln",
                    "finding_number": "NETWORK-1",
                    "finding_name": "Operating System EOL",
                    "finding_severity": "Critical",
                    "finding_description": "According to the version number, the operating system on the remote host is no longer supported.",
                    "finding_recommendation": "Upgrade to a version of the operating system that is currently supported.",
                    "finding_exploitable": "false",
                    "finding_references": {
                        "CVSS Base Score": "10.0",
                        "Test ID": "12345"
                    },
                    "finding_output": "Support for Example Operating System ended on 1970-01-01. Upgrade to the latest version.",
                    "finding_port": "0/tcp",
                    "finding_service": "general"
                }
            ]
    },
    {
      // Azure Virtual Machine example (Host model)
      "host_name": "nsg-app-server1"       
      "asset_type": "host",
      "asset_info": [
        {
          "azure.resource_name": "/subscriptions/8d1fa3a2-4d0e-4b6e-9b45-1c9d34c9dbd0/resourceGroups/rg-networking/providers/Microsoft.Network/networkSecurityGroups/nsg-app-tier",
          "azure.account_id": "8d1fa3a2-4d0e-4b6e-9b45-1c9d34c9dbd0",
          "azure.urn": "/subscriptions/8d1fa3a2-4d0e-4b6e-9b45-1c9d34c9dbd0/resourceGroups/rg-networking/providers/Microsoft.Network/networkSecurityGroups/nsg-app-tier",
          "azure.region": "eastus2"
        }
        ]
      "findings": [
                {
                    "finding_type": "Vuln",
                    "finding_number": "NETWORK-1",
                    "finding_name": "Operating System EOL",
                    "finding_severity": "Critical",
                    "finding_description": "According to the version number, the operating system on the remote host is no longer supported.",
                    "finding_recommendation": "Upgrade to a version of the operating system that is currently supported.",
                    "finding_exploitable": "false",
                    "finding_references": {
                        "CVSS Base Score": "10.0",
                        "Test ID": "12345"
                    },
                    "finding_output": "Support for Example Operating System ended on 1970-01-01. Upgrade to the latest version.",
                    "finding_port": "0/tcp",
                    "finding_service": "general"
                }
            ]
    },
    {
      // Azure cloud resource example
      "provider": "Azure",
      "account_id": "8d1fa3a2-4d0e-4b6e-9b45-1c9d34c9dbd0",
      "resource_name": "/service-principal/a329d4bf-4557-4ccf-b132-84e7025ea000",
      "urn": "/service-principal/a329d4bf-4557-4ccf-b132-84e7025ea000",
      "asset_type": "cloud_resource",
      "region": "eastus2",
      "findings": [
                {
                    "finding_type": "Vuln",
                    "finding_number": "NETWORK-1",
                    "finding_name": "Operating System EOL",
                    "finding_severity": "Critical",
                    "finding_description": "According to the version number, the operating system on the remote host is no longer supported.",
                    "finding_recommendation": "Upgrade to a version of the operating system that is currently supported.",
                    "finding_exploitable": "false",
                    "finding_references": {
                        "CVSS Base Score": "10.0",
                        "Test ID": "12345"
                    },
                    "finding_output": "Support for Example Operating System ended on 1970-01-01. Upgrade to the latest version.",
                    "finding_port": "0/tcp",
                    "finding_service": "general"
                }
            ]
    }
  ]
}
```