Jump to

• Request
• Response

Get KVM Database Systems

get

/dbsystem

Get all the KVM Database Systems present in the system.

Request

There are no request parameters for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object DbSystem

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/DbSystem"
    }
}

Nested Schema : DbSystem

Type: object

Show Source

• afdEnabled(optional): boolean
• clusterName(optional): string
• cpuPool(optional): object DbSystemCpuPool
• createTime(optional): string(date-time)
• databases(optional): array databases
• gridHome(optional): object DbSystemGridHome
• id(optional): string
• image(optional): string
• memorySizeFormatted(optional): string
• memorySizeInMb(optional): integer
• name(optional): string
• numaEnabled(optional): boolean
• numberOfCores(optional): integer
• shapeName(optional): string
• state(optional): string
• storage(optional): object DbSystemStorage
• updateTime(optional): string(date-time)
• version(optional): string
• vms(optional): array vms

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string"
        },
        "name":{
            "type":"string"
        },
        "state":{
            "type":"string"
        },
        "createTime":{
            "type":"string",
            "format":"date-time"
        },
        "updateTime":{
            "type":"string",
            "format":"date-time"
        },
        "image":{
            "type":"string"
        },
        "version":{
            "type":"string"
        },
        "shapeName":{
            "type":"string"
        },
        "clusterName":{
            "type":"string"
        },
        "numberOfCores":{
            "type":"integer"
        },
        "memorySizeInMb":{
            "type":"integer"
        },
        "memorySizeFormatted":{
            "type":"string"
        },
        "numaEnabled":{
            "type":"boolean"
        },
        "afdEnabled":{
            "type":"boolean"
        },
        "storage":{
            "$ref":"#/definitions/DbSystemStorage"
        },
        "cpuPool":{
            "$ref":"#/definitions/DbSystemCpuPool"
        },
        "vms":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/DbSystemVm"
            }
        },
        "databases":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/DB"
            }
        },
        "gridHome":{
            "$ref":"#/definitions/DbSystemGridHome"
        }
    }
}

Nested Schema : DbSystemCpuPool

Type: object

Show Source

• name(optional): string
• numberOfCores(optional): integer
• perNodeAllocations(optional): array perNodeAllocations
• type(optional): string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "type":{
            "type":"string"
        },
        "numberOfCores":{
            "type":"integer"
        },
        "perNodeAllocations":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/CpuPoolNodeAllocation"
            }
        }
    }
}

Nested Schema : databases

Type: array

Show Source

• Array of: object DB

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/DB"
    }
}

Nested Schema : DbSystemGridHome

Type: object

Show Source

• location(optional): string
• name(optional): string
• version(optional): string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "version":{
            "type":"string"
        },
        "location":{
            "type":"string"
        }
    }
}

Nested Schema : DbSystemStorage

Type: object

Show Source

• accVolumeDevice(optional): string
• accVolumeName(optional): string
• accVolumeSizeFormatted(optional): string
• accVolumeSizeInMb(optional): integer(int64)
• diskGroup(optional): string
• hasAccVolume(optional): boolean
• mountPoint(optional): string
• redundancy(optional): string
  Allowed Values: [ "MIRROR", "HIGH", "REBALANCE_IN_PROGRESS", "EXTERNAL", "EXTENDED" ]

  Redundancy of the VM storage
• sizeFormatted(optional): string
• sizeInMb(optional): integer(int64)
• volumeDevice(optional): string
• volumeName(optional): string

{
    "type":"object",
    "properties":{
        "diskGroup":{
            "type":"string"
        },
        "volumeName":{
            "type":"string"
        },
        "volumeDevice":{
            "type":"string"
        },
        "sizeInMb":{
            "type":"integer",
            "format":"int64"
        },
        "sizeFormatted":{
            "type":"string"
        },
        "hasAccVolume":{
            "type":"boolean"
        },
        "accVolumeName":{
            "type":"string"
        },
        "accVolumeDevice":{
            "type":"string"
        },
        "accVolumeSizeInMb":{
            "type":"integer",
            "format":"int64"
        },
        "accVolumeSizeFormatted":{
            "type":"string"
        },
        "mountPoint":{
            "type":"string"
        },
        "redundancy":{
            "type":"string",
            "description":"Redundancy of the VM storage",
            "enum":[
                "MIRROR",
                "HIGH",
                "REBALANCE_IN_PROGRESS",
                "EXTERNAL",
                "EXTENDED"
            ]
        }
    }
}

Nested Schema : vms

Type: array

Show Source

• Array of: object DbSystemVm

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/DbSystemVm"
    }
}

Nested Schema : perNodeAllocations

Type: array

Show Source

• Array of: object CpuPoolNodeAllocation

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/CpuPoolNodeAllocation"
    }
}

Nested Schema : CpuPoolNodeAllocation

Type: object

Show Source

• cpus(optional): array cpus
• effectiveCpuSet(optional): string
• nodeName(optional): string

{
    "type":"object",
    "properties":{
        "nodeName":{
            "type":"string"
        },
        "effectiveCpuSet":{
            "type":"string"
        },
        "cpus":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/PhysicalCpu"
            }
        }
    }
}

Nested Schema : cpus

Type: array

Show Source

• Array of: object PhysicalCpu

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/PhysicalCpu"
    }
}

Nested Schema : PhysicalCpu

Type: object

Show Source

• cpuId(optional): integer
• online(optional): boolean

{
    "type":"object",
    "properties":{
        "cpuId":{
            "type":"integer"
        },
        "online":{
            "type":"boolean"
        }
    }
}

Nested Schema : DB

Type: object

Show Source

• associatedNetworks(optional): array associatedNetworks
• backupConfigId(optional): string
• cloudStorageContainer(optional): string
  if the object store backup is selected, then which container should the database backup go to.
• cpupool(optional): string
  Defines the CPU Pool name
• createTime(optional): string(date-time)
• databaseUniqueName(optional): string
• dbCharacterSet(optional): object DbCharacterSet
• dbClass(optional): string
  Allowed Values: [ "OLTP", "DSS", "IMDB" ]
• dbConsoleEnable(optional): boolean
• dbDomainName(optional): string
• dbEdition(optional): string
  Database Edition.
• dbHomeId(optional): string
  The database home resource identifier for associating this database.
• dbId(optional): string
  The database id
• dbName(optional): string
• dbRedundancy(optional): string
• dbRole(optional): string
  Database role (PRIMARY/STANDBY).
• dbShape(optional): string
  Allowed Values: [ "odb1s", "odb1", "odb2", "odb4", "odb6", "odb8", "odb10", "odb12", "odb16", "odb20", "odb24", "odb28", "odb32", "odb36", "odb42", "odb48", "odb56", "odb64" ]
• dbStorage(optional): string
  Allowed Values: [ "ASM", "ACFS", "PMEM" ]
• dbTargetNodeName(optional): string
• dbTargetNodeNumber(optional): string
• dbType(optional): string
  Allowed Values: [ "RAC", "RACOne", "SI" ]
• dbVersion(optional): string
• enableEEHA(optional): boolean
  Enable HA for EE SI database
• enableSEHA(optional): boolean
• enableTDE(optional): boolean
  Flag to create TDE enabled database
• entitySource(optional): string
  Where the database is created. Null for local system.
• id(optional): string
• instanceOnly(optional): boolean
  do not create the database files. Used in case of standby case to create standby instance.
• isAutoBackupDisabled(optional): boolean
• isBcfgInSync(optional): boolean
• isCdb(optional): boolean
• level0BackupDay(optional): string
  Allowed Values: [ "monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday" ]
• name(optional): string
  display name for the resource
• pdbAdminUserName(optional): string
• pdBName(optional): string
• pdbs(optional): array pdbs
  List of PDB objects that are present in the CDB
• quota(optional): string
  disk space quota for a database.
• registerOnly(optional): boolean
  Use to migrate existing database
• remark(optional): string
  Remark for database status
• rmanBkupPassword(optional): string
• state(optional): object ResourceState
• tdePassword(optional): string
  Password for Password Protected KeyStore
• tdeWalletManagement(optional): string
  Specify wallet management method for TDE enabled database. Allowed values are ODA and EXTERNAL.
• updatedTime(optional): string(date-time)

{
    "properties":{
        "id":{
            "type":"string"
        },
        "name":{
            "description":"display name for the resource",
            "type":"string"
        },
        "dbName":{
            "type":"string"
        },
        "databaseUniqueName":{
            "type":"string"
        },
        "dbVersion":{
            "type":"string"
        },
        "dbHomeId":{
            "description":"The database home resource identifier for associating this database.",
            "type":"string"
        },
        "instanceOnly":{
            "description":"do not create the database files. Used in case of standby case to create standby instance.",
            "type":"boolean"
        },
        "registerOnly":{
            "description":"Use to migrate existing database",
            "type":"boolean"
        },
        "dbId":{
            "description":"The database id",
            "type":"string"
        },
        "isCdb":{
            "type":"boolean"
        },
        "isAutoBackupDisabled":{
            "type":"boolean"
        },
        "pdBName":{
            "type":"string"
        },
        "pdbAdminUserName":{
            "type":"string"
        },
        "pdbs":{
            "description":"List of PDB objects that are present in the CDB",
            "type":"array",
            "items":{
                "$ref":"#/definitions/Pdb"
            }
        },
        "enableTDE":{
            "type":"boolean",
            "description":"Flag to create TDE enabled database"
        },
        "tdePassword":{
            "description":"Password for Password Protected KeyStore",
            "type":"string"
        },
        "tdeWalletManagement":{
            "description":"Specify wallet management method for TDE enabled database. Allowed values are ODA and EXTERNAL.",
            "type":"string"
        },
        "dbType":{
            "type":"string",
            "enum":[
                "RAC",
                "RACOne",
                "SI"
            ]
        },
        "dbRole":{
            "description":"Database role (PRIMARY/STANDBY).",
            "type":"string"
        },
        "dbTargetNodeNumber":{
            "type":"string"
        },
        "dbClass":{
            "type":"string",
            "enum":[
                "OLTP",
                "DSS",
                "IMDB"
            ]
        },
        "dbShape":{
            "type":"string",
            "enum":[
                "odb1s",
                "odb1",
                "odb2",
                "odb4",
                "odb6",
                "odb8",
                "odb10",
                "odb12",
                "odb16",
                "odb20",
                "odb24",
                "odb28",
                "odb32",
                "odb36",
                "odb42",
                "odb48",
                "odb56",
                "odb64"
            ]
        },
        "dbStorage":{
            "type":"string",
            "enum":[
                "ASM",
                "ACFS",
                "PMEM"
            ]
        },
        "dbRedundancy":{
            "type":"string"
        },
        "quota":{
            "type":"string",
            "description":"disk space quota for a database."
        },
        "dbCharacterSet":{
            "$ref":"#/definitions/DbCharacterSet"
        },
        "dbConsoleEnable":{
            "type":"boolean"
        },
        "backupConfigId":{
            "type":"string"
        },
        "cloudStorageContainer":{
            "type":"string",
            "description":"if the object store backup is selected, then which container should the database backup go to."
        },
        "state":{
            "$ref":"#/definitions/ResourceState"
        },
        "createTime":{
            "type":"string",
            "format":"date-time"
        },
        "updatedTime":{
            "type":"string",
            "format":"date-time"
        },
        "rmanBkupPassword":{
            "type":"string"
        },
        "dbEdition":{
            "description":"Database Edition.",
            "type":"string"
        },
        "dbDomainName":{
            "type":"string"
        },
        "level0BackupDay":{
            "type":"string",
            "enum":[
                "monday",
                "tuesday",
                "wednesday",
                "thursday",
                "friday",
                "saturday",
                "sunday"
            ]
        },
        "isBcfgInSync":{
            "type":"boolean"
        },
        "associatedNetworks":{
            "type":"array",
            "items":{
                "type":"string"
            }
        },
        "enableSEHA":{
            "type":"boolean"
        },
        "enableEEHA":{
            "description":"Enable HA for EE SI database",
            "type":"boolean"
        },
        "dbTargetNodeName":{
            "type":"string"
        },
        "cpupool":{
            "description":"Defines the CPU Pool name",
            "type":"string"
        },
        "entitySource":{
            "description":"Where the database is created. Null for local system.",
            "type":"string"
        },
        "remark":{
            "description":"Remark for database status",
            "type":"string"
        }
    }
}

Nested Schema : associatedNetworks

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : DbCharacterSet

Type: object

Show Source

• characterSet(optional): string
• dbLanguage(optional): string
• dbTerritory(optional): string
• nlsCharacterset(optional): string

{
    "properties":{
        "characterSet":{
            "type":"string"
        },
        "nlsCharacterset":{
            "type":"string"
        },
        "dbTerritory":{
            "type":"string"
        },
        "dbLanguage":{
            "type":"string"
        }
    }
}

Nested Schema : pdbs

Type: array

List of PDB objects that are present in the CDB

Show Source

• Array of: object Pdb

{
    "description":"List of PDB objects that are present in the CDB",
    "type":"array",
    "items":{
        "$ref":"#/definitions/Pdb"
    }
}

Nested Schema : ResourceState

Type: object

Show Source

• status(optional): string
  Allowed Values: [ "CREATING", "CONFIGURED", "UPDATING", "DELETING", "FAILED", "RUNNING", "ENABLED", "DISABLED", "STALE" ]

{
    "properties":{
        "status":{
            "type":"string",
            "enum":[
                "CREATING",
                "CONFIGURED",
                "UPDATING",
                "DELETING",
                "FAILED",
                "RUNNING",
                "ENABLED",
                "DISABLED",
                "STALE"
            ]
        }
    }
}

Nested Schema : Pdb

Type: object

Show Source

• id(optional): string
  PDB Id
• pdbName(optional): string
  Name of the PDB
• sourcePdbArchivePath(optional): string
  The absolute file name of the PDB archive file if ARCHIVE is used in sourceType
• sourcePdbName(optional): string
  The source PDB name if PDB is used in pdbSource
• sourceType(optional): string
  Allowed Values: [ "SEED", "PDB", "ARCHIVE" ]

  The source type to create the PDB
• state(optional): object ResourceState

{
    "properties":{
        "id":{
            "description":"PDB Id",
            "type":"string"
        },
        "pdbName":{
            "description":"Name of the PDB",
            "type":"string"
        },
        "state":{
            "$ref":"#/definitions/ResourceState"
        },
        "sourceType":{
            "description":"The source type to create the PDB",
            "type":"string",
            "enum":[
                "SEED",
                "PDB",
                "ARCHIVE"
            ]
        },
        "sourcePdbName":{
            "description":"The source PDB name if PDB is used in pdbSource",
            "type":"string"
        },
        "sourcePdbArchivePath":{
            "description":"The absolute file name of the PDB archive file if ARCHIVE is used in sourceType",
            "type":"string"
        }
    }
}

Nested Schema : DbSystemVm

Type: object

Show Source

• customVNetworks(optional): array customVNetworks
• diskImagePath(optional): string
• disks(optional): array disks
• hostName(optional): string
• maxMemoryInMb(optional): string
• name(optional): string
• nodeName(optional): string
• nodeNumber(optional): string
• status(optional): object VmStatus
• vmSnapshotPath(optional): string
• vnetworks(optional): array vnetworks

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "nodeNumber":{
            "type":"string"
        },
        "nodeName":{
            "type":"string"
        },
        "hostName":{
            "type":"string"
        },
        "vmSnapshotPath":{
            "type":"string"
        },
        "diskImagePath":{
            "type":"string"
        },
        "maxMemoryInMb":{
            "type":"string"
        },
        "status":{
            "$ref":"#/definitions/VmStatus"
        },
        "disks":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/DbSystemDisk"
            }
        },
        "vnetworks":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/DbSystemVNetwork"
            }
        },
        "customVNetworks":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/DbSystemCustomVNetwork"
            }
        }
    }
}

Nested Schema : customVNetworks

Type: array

Show Source

• Array of: object DbSystemCustomVNetwork

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/DbSystemCustomVNetwork"
    }
}

Nested Schema : disks

Type: array

Show Source

• Array of: object DbSystemDisk

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/DbSystemDisk"
    }
}

Nested Schema : VmStatus

Type: object

Show Source

• currNode(optional): string
• currState(optional): string
• targetState(optional): string

{
    "type":"object",
    "properties":{
        "currNode":{
            "type":"string"
        },
        "currState":{
            "type":"string"
        },
        "targetState":{
            "type":"string"
        }
    }
}

Nested Schema : vnetworks

Type: array

Show Source

• Array of: object DbSystemVNetwork

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/DbSystemVNetwork"
    }
}

Nested Schema : DbSystemCustomVNetwork

Type: object

Show Source

• dbSystemVmName(optional): string
• gateway(optional): string
• ipAddress(optional): string
• macAddress(optional): string
• name(optional): string
• netmask(optional): string
• type(optional): string
• vnetworkName(optional): string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "vnetworkName":{
            "type":"string"
        },
        "dbSystemVmName":{
            "type":"string"
        },
        "ipAddress":{
            "type":"string"
        },
        "netmask":{
            "type":"string"
        },
        "gateway":{
            "type":"string"
        },
        "macAddress":{
            "type":"string"
        },
        "type":{
            "type":"string"
        }
    }
}

Nested Schema : DbSystemDisk

Type: object

Show Source

• devicePath(optional): string
• name(optional): string
• targetDevice(optional): string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "devicePath":{
            "type":"string"
        },
        "targetDevice":{
            "type":"string"
        }
    }
}

Nested Schema : DbSystemVNetwork

Type: object

Show Source

• bridgeName(optional): string
• gateway(optional): string
• ipAddress(optional): string
• name(optional): string
• netmask(optional): string
• targetDevice(optional): string
• type(optional): string
• virtualFunction(optional): string
• vlanName(optional): string

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string"
        },
        "type":{
            "type":"string"
        },
        "ipAddress":{
            "type":"string"
        },
        "netmask":{
            "type":"string"
        },
        "gateway":{
            "type":"string"
        },
        "targetDevice":{
            "type":"string"
        },
        "virtualFunction":{
            "type":"string"
        },
        "bridgeName":{
            "type":"string"
        },
        "vlanName":{
            "type":"string"
        }
    }
}

Default Response

An unexpected error has occurred

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
• message: string

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string"
        },
        "message":{
            "type":"string"
        }
    }
}

Back to Top