Neo4j · Schema

Neo4j Aura Instance

Schema for Neo4j AuraDB cloud database instances including configuration, status, and lifecycle management properties.

Graph DatabaseCypherCloudGraphQLDriversAPIs

Properties

Name Type Description
id string Unique identifier for the AuraDB instance
name string Display name of the instance
status string Current lifecycle status of the instance
tenant_id string Identifier of the tenant (project) this instance belongs to
cloud_provider string Cloud infrastructure provider hosting the instance
region string Cloud region where the instance is deployed
type string Instance type determining capabilities and pricing tier
memory string Memory allocated to the instance
storage string Storage allocated to the instance
connection_url string Bolt connection URI for connecting to the instance
metrics_integration_url string URL for the customer metrics integration endpoint
neo4j_version string Neo4j database version running on the instance
View JSON Schema on GitHub

JSON Schema

neo4j-aura-instance-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://neo4j.com/schemas/neo4j/aura-instance.json",
  "title": "Neo4j Aura Instance",
  "description": "Schema for Neo4j AuraDB cloud database instances including configuration, status, and lifecycle management properties.",
  "type": "object",
  "required": ["id", "name", "status", "tenant_id", "cloud_provider", "region", "type", "memory"],
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the AuraDB instance"
    },
    "name": {
      "type": "string",
      "description": "Display name of the instance",
      "maxLength": 30
    },
    "status": {
      "type": "string",
      "description": "Current lifecycle status of the instance",
      "enum": [
        "creating",
        "running",
        "pausing",
        "paused",
        "resuming",
        "updating",
        "destroying",
        "destroyed",
        "loading",
        "restoring"
      ]
    },
    "tenant_id": {
      "type": "string",
      "description": "Identifier of the tenant (project) this instance belongs to"
    },
    "cloud_provider": {
      "type": "string",
      "description": "Cloud infrastructure provider hosting the instance",
      "enum": ["gcp", "aws", "azure"]
    },
    "region": {
      "type": "string",
      "description": "Cloud region where the instance is deployed",
      "examples": ["us-east-1", "europe-west1", "eastus"]
    },
    "type": {
      "type": "string",
      "description": "Instance type determining capabilities and pricing tier",
      "enum": [
        "enterprise-db",
        "enterprise-ds",
        "professional-db",
        "free-db"
      ]
    },
    "memory": {
      "type": "string",
      "description": "Memory allocated to the instance",
      "pattern": "^\\d+GB$",
      "examples": ["2GB", "8GB", "16GB", "32GB"]
    },
    "storage": {
      "type": "string",
      "description": "Storage allocated to the instance",
      "pattern": "^\\d+GB$",
      "examples": ["8GB", "16GB", "64GB"]
    },
    "connection_url": {
      "type": "string",
      "description": "Bolt connection URI for connecting to the instance",
      "format": "uri",
      "examples": ["neo4j+s://xxxxxxxx.databases.neo4j.io"]
    },
    "metrics_integration_url": {
      "type": "string",
      "description": "URL for the customer metrics integration endpoint",
      "format": "uri"
    },
    "neo4j_version": {
      "type": "string",
      "description": "Neo4j database version running on the instance",
      "examples": ["5"]
    }
  },
  "$defs": {
    "Tenant": {
      "type": "object",
      "description": "A tenant (project) that organizes and manages multiple AuraDB instances under a single administrative unit.",
      "required": ["id", "name"],
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier for the tenant"
        },
        "name": {
          "type": "string",
          "description": "Display name of the tenant"
        },
        "instance_configurations": {
          "type": "array",
          "description": "Available instance configurations for this tenant",
          "items": {
            "$ref": "#/$defs/InstanceConfiguration"
          }
        }
      }
    },
    "InstanceConfiguration": {
      "type": "object",
      "description": "An available instance configuration option within a tenant.",
      "properties": {
        "type": {
          "type": "string",
          "description": "Instance type"
        },
        "regions": {
          "type": "array",
          "description": "Available cloud regions for this instance type",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Region identifier"
              }
            }
          }
        }
      }
    },
    "Snapshot": {
      "type": "object",
      "description": "A point-in-time snapshot of an AuraDB instance for backup and restore purposes.",
      "required": ["snapshot_id", "instance_id", "status", "timestamp"],
      "properties": {
        "snapshot_id": {
          "type": "string",
          "description": "Unique identifier for the snapshot"
        },
        "instance_id": {
          "type": "string",
          "description": "Identifier of the instance this snapshot was taken from"
        },
        "status": {
          "type": "string",
          "description": "Current status of the snapshot",
          "enum": ["Completed", "InProgress", "Failed"]
        },
        "timestamp": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601 timestamp of when the snapshot was created"
        },
        "exportable": {
          "type": "boolean",
          "description": "Whether the snapshot data can be exported"
        }
      }
    }
  }
}