REST API for Oracle Enterprise Manager

List Protected Databases

get

https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/zdlra/{raTargetId}/protectedDatabases

Get protected databases on a Recovery Appliance.

Request

Path Parameters

raTargetId(required): string
Recovery Appliance Target id.
Example:
```
F76BBCCBD8A0D4719A8AA588375FA8BE
```

Query Parameters

limit: integer(int32)
Minimum Value: 1

Maximum Value: 2000

to limit the number of rows returned. If the result set is greater follow the previous and next links in the results.
Example:
```
20
```
nameOnly: string

Retrieve only protected database names.
page: string

system generated page token used in the self, next and previous links.

Header Parameters

ORCL-EM-ZDLRATARGET-AUTHORIZATION(required):
Recovery Appliance Administrator Credentials. The format must be NAMED: (e.g. NAMED:ORSADMIN) or PREFERRED: (e.g. PREFERRED:PREF_ORSADMIN). If no value is specified, the system will use preferred credentials.
Example:
```
NAMED:ORSADMIN
```

There's no request body for this operation.

Response

Supported Media Types

application/json

200 Response

Successful Operation

Root Schema : ProtectedDatabaseSummary

Type: object

Collection of protected database objects.

Show Source

items(required): array items

List of protected database objects.

{
    "description":"Collection of protected database objects.",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/CommonProperties"
        },
        {
            "type":"object"
        }
    ],
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "description":"List of protected database objects.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProtectedDatabase"
            }
        }
    }
}

Match All

Show Source

object CommonProperties

Collection of summary objects.
object ProtectedDatabaseSummary-allOf[1]

{
    "description":"Collection of protected database objects.",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/CommonProperties"
        },
        {
            "type":"object"
        }
    ],
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "description":"List of protected database objects.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ProtectedDatabase"
            }
        }
    }
}

Nested Schema : items

Type: array

List of protected database objects.

Show Source

Array of: object ProtectedDatabase

Protected database properties.

{
    "description":"List of protected database objects.",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ProtectedDatabase"
    }
}

Nested Schema : CommonProperties

Type: object

Collection of summary objects.

Show Source

count(required): integer

Count of summary objects in this page.

Example: 1
links(required): object links

Navigation links.
nextPage: string

For pagination of a list of items. When paging through a list, if this value appears in the response, then there are additional items still to get. Include this value as the page parameter for the subsequent "List" request.

{
    "description":"Collection of summary objects.",
    "type":"object",
    "required":[
        "count",
        "links"
    ],
    "properties":{
        "count":{
            "example":1,
            "description":"Count of summary objects in this page.",
            "type":"integer"
        },
        "nextPage":{
            "description":"For pagination of a list of items. When paging through a list, if this value appears in the \nresponse, then there are additional items still to get. Include this value as the page \nparameter for the subsequent \"List\" request.\n",
            "type":"string"
        },
        "links":{
            "type":"object",
            "description":"Navigation links.",
            "properties":{
                "self":{
                    "$ref":"#/components/schemas/Link"
                },
                "next":{
                    "$ref":"#/components/schemas/Link"
                }
            }
        }
    }
}

Nested Schema : ProtectedDatabaseSummary-allOf[1]

Type: object

Nested Schema : ProtectedDatabase

Type: object

Protected database properties.

Show Source

allowBackupDeletion: string

The setting that controls whether RMAN backups for databases that use this protection policy can be deleted.
backupRedoFailover: string

Specifies whether protected databases using this protection policy will use this Recovery Appliance as an alternate destination in a backup and redo failover strategy.
copyToCloudEnabled: string

Enabled (YES) or disabled (NO) of copy-to-cloud operation for this database.
copyToTapeEnabled: string

Enabled (YES) or disabled (NO) of copy-to-tape operation for this database.
creationTime: string

The time of task creation.
databaseKey: string

The primary key for this database in the Recovery Appliance metadata database.
databaseSize: string

Database size.
databaseVersion: string

Database version.
dbid: string

The DBID for this protected database.
dbUniqueName: string

Database unique name.
deduplicationFactor: string

The ratio of the total size of virtual full backups to the actual consumed space on the appliance for this protected database.
deleting: string

YES if this database is currently being deleted.
diskRecoveryWindowCurrent: string

The current value (in seconds) of the recovery window for this protected database.
diskRecoveryWindowGoal: string

Recovery window goal that the Recovery Appliance should attempt to meet for point-in-time recovery using disk backups.
diskRecoveryWindowNeededSpace: string

The estimated space (in GB) that is needed to meet the recovery window goal.
diskReservedSpace: string

The amount of disk space(in GB) reserved for the exclusive use of this database.
finalChangeNumber: string

The highest SCN to which this database can be recovered when using backups and redo logs available on Recovery Appliance.
guaranteedBackupCopy: string

Always accept new backups even if it requires purging existing backups not yet copied to media or replicated.
keepSpace: string

The space used to hold KEEP backups for the database.
lastCompleteBackup: string

The latest time for which a backup of all datafiles in the database exists.
lastCopyToCloud: string

The timestamp of the last complete copy-to-cloud operation for this database.
lastCopyToTape: string

The timestamp of the last complete copy-to-tape operation for this database.
lastReplication: string

The timestamp of the last complete replication operation for this database.
maxDiskBackupRetention: string

A maximum time that disk backups should be retained. This value must be greater than or equal to the disk recovery window goal. If not specified, backups will be be retained beyond the disk recovery window goal as space permits.
mediaManagerRecoveryWindowGoal: string

A longer window within which point-in-time recovery capability from a media manager (e.g., Oracle Secure Backup) will be maintained.
minimumRecoveryNeeded: string

The minimum interval needed to restore the protected database to the present.
name: string

Protected database target name or database unique name.
nzdlActive: string

YES if real-time redo transport is active. NO if redo has not recently been received.
protectionPolicyName: string

The name of the protection policy used by this database.
replicationEnabled: string

Enabled (YES) or disabled (NO) of replication operation for this database.
replicationServerList: string

The list of replication server configurations associated with this protection policy.
replicationSetupStatus: string

The status of the setup for the downstream replication appliance for this database.
restoreWindow: string

The time range used to compute the value of the estimated space that is needed to meet the recovery window goal.
spaceUsage: string

The amount of disk space (in GB) currently used by this protected database.
storageLocation: string

The name of the Recovery Appliance storage location used by this protected database.
targetName: string

Protected database target name.
targetType: string

Target type corresponding to the target specified by targetName. This can be oracle_database, rac_database or composite.
timeZone: string

The time zone offset of the protected database.
unprotectedDataWindowCurrent: string

The point beyond which recovery is impossible unless additional redo is available.
unprotectedDataWindowThreshold: string

The maximum amount of time in which there is potential data loss exposure for databases associated with this protected database.
vpcUser: string

The list of Recovery Appliance recovery catalog user for this protected database.

{
    "description":"Protected database properties.",
    "type":"object",
    "properties":{
        "name":{
            "description":"Protected database target name or database unique name.",
            "type":"string"
        },
        "targetName":{
            "description":"Protected database target name.",
            "type":"string"
        },
        "targetType":{
            "description":"Target type corresponding to the target specified by targetName. This can be oracle_database, rac_database or composite.",
            "type":"string"
        },
        "dbUniqueName":{
            "description":"Database unique name.",
            "type":"string"
        },
        "databaseVersion":{
            "description":"Database version.",
            "type":"string"
        },
        "databaseSize":{
            "description":"Database size.",
            "type":"string"
        },
        "protectionPolicyName":{
            "description":"The name of the protection policy used by this database.",
            "type":"string"
        },
        "diskRecoveryWindowGoal":{
            "description":"Recovery window goal that the Recovery Appliance should attempt to meet for point-in-time recovery using disk backups.",
            "type":"string"
        },
        "diskRecoveryWindowCurrent":{
            "description":"The current value (in seconds) of the recovery window for this protected database.",
            "type":"string"
        },
        "diskRecoveryWindowNeededSpace":{
            "description":"The estimated space (in GB) that is needed to meet the recovery window goal.",
            "type":"string"
        },
        "unprotectedDataWindowThreshold":{
            "description":"The maximum amount of time in which there is potential data loss exposure for databases associated with this protected database.",
            "type":"string"
        },
        "unprotectedDataWindowCurrent":{
            "description":"The point beyond which recovery is impossible unless additional redo is available.",
            "type":"string"
        },
        "mediaManagerRecoveryWindowGoal":{
            "description":"A longer window within which point-in-time recovery capability from a media manager (e.g., Oracle Secure Backup) will be maintained.",
            "type":"string"
        },
        "maxDiskBackupRetention":{
            "description":"A maximum time that disk backups should be retained. This value must be greater than or equal to the disk recovery window goal. If not specified, backups will be be retained beyond the disk recovery window goal as space permits.",
            "type":"string"
        },
        "guaranteedBackupCopy":{
            "description":"Always accept new backups even if it requires purging existing backups not yet copied to media or replicated.",
            "type":"string"
        },
        "backupRedoFailover":{
            "description":"Specifies whether protected databases using this protection policy will use this Recovery Appliance as an alternate destination in a backup and redo failover strategy.",
            "type":"string"
        },
        "lastCompleteBackup":{
            "description":"The latest time for which a backup of all datafiles in the database exists.",
            "type":"string"
        },
        "lastCopyToTape":{
            "description":"The timestamp of the last complete copy-to-tape operation for this database.",
            "type":"string"
        },
        "lastCopyToCloud":{
            "description":"The timestamp of the last complete copy-to-cloud operation for this database.",
            "type":"string"
        },
        "lastReplication":{
            "description":"The timestamp of the last complete replication operation for this database.",
            "type":"string"
        },
        "copyToCloudEnabled":{
            "description":"Enabled (YES) or disabled (NO) of copy-to-cloud operation for this database.",
            "type":"string"
        },
        "copyToTapeEnabled":{
            "description":"Enabled (YES) or disabled (NO) of copy-to-tape operation for this database.",
            "type":"string"
        },
        "replicationEnabled":{
            "description":"Enabled (YES) or disabled (NO) of replication operation for this database.",
            "type":"string"
        },
        "finalChangeNumber":{
            "description":"The highest SCN to which this database can be recovered when using backups and redo logs available on Recovery Appliance.",
            "type":"string"
        },
        "replicationServerList":{
            "description":"The list of replication server configurations associated with this protection policy.",
            "type":"string"
        },
        "databaseKey":{
            "description":"The primary key for this database in the Recovery Appliance metadata database.",
            "type":"string"
        },
        "deleting":{
            "description":"YES if this database is currently being deleted.",
            "type":"string"
        },
        "dbid":{
            "description":"The DBID for this protected database.",
            "type":"string"
        },
        "creationTime":{
            "description":"The time of task creation.",
            "type":"string"
        },
        "storageLocation":{
            "description":"The name of the Recovery Appliance storage location used by this protected database.",
            "type":"string"
        },
        "timeZone":{
            "description":"The time zone offset of the protected database.",
            "type":"string"
        },
        "spaceUsage":{
            "description":"The amount of disk space (in GB) currently used by this protected database.",
            "type":"string"
        },
        "keepSpace":{
            "description":"The space used to hold KEEP backups for the database.",
            "type":"string"
        },
        "diskReservedSpace":{
            "description":"The amount of disk space(in GB) reserved for the exclusive use of this database.",
            "type":"string"
        },
        "replicationSetupStatus":{
            "description":"The status of the setup for the downstream replication appliance for this database.",
            "type":"string"
        },
        "restoreWindow":{
            "description":"The time range used to compute the value of the estimated space that is needed to meet the recovery window goal.",
            "type":"string"
        },
        "minimumRecoveryNeeded":{
            "description":"The minimum interval needed to restore the protected database to the present.",
            "type":"string"
        },
        "nzdlActive":{
            "description":"YES if real-time redo transport is active. NO if redo has not recently been received.",
            "type":"string"
        },
        "allowBackupDeletion":{
            "description":"The setting that controls whether RMAN backups for databases that use this protection policy can be deleted.",
            "type":"string"
        },
        "deduplicationFactor":{
            "description":"The ratio of the total size of virtual full backups to the actual consumed space on the appliance for this protected database.",
            "type":"string"
        },
        "vpcUser":{
            "description":"The list of Recovery Appliance recovery catalog user for this protected database.",
            "type":"string"
        }
    },
    "allOf":[
        {
            "$ref":"#/components/schemas/ChildDetailsLink"
        },
        {
            "type":"object"
        }
    ]
}

Match All

Show Source

object ChildDetailsLink

Object details Link.
object ProtectedDatabase-allOf[1]

{
    "description":"Protected database properties.",
    "type":"object",
    "properties":{
        "name":{
            "description":"Protected database target name or database unique name.",
            "type":"string"
        },
        "targetName":{
            "description":"Protected database target name.",
            "type":"string"
        },
        "targetType":{
            "description":"Target type corresponding to the target specified by targetName. This can be oracle_database, rac_database or composite.",
            "type":"string"
        },
        "dbUniqueName":{
            "description":"Database unique name.",
            "type":"string"
        },
        "databaseVersion":{
            "description":"Database version.",
            "type":"string"
        },
        "databaseSize":{
            "description":"Database size.",
            "type":"string"
        },
        "protectionPolicyName":{
            "description":"The name of the protection policy used by this database.",
            "type":"string"
        },
        "diskRecoveryWindowGoal":{
            "description":"Recovery window goal that the Recovery Appliance should attempt to meet for point-in-time recovery using disk backups.",
            "type":"string"
        },
        "diskRecoveryWindowCurrent":{
            "description":"The current value (in seconds) of the recovery window for this protected database.",
            "type":"string"
        },
        "diskRecoveryWindowNeededSpace":{
            "description":"The estimated space (in GB) that is needed to meet the recovery window goal.",
            "type":"string"
        },
        "unprotectedDataWindowThreshold":{
            "description":"The maximum amount of time in which there is potential data loss exposure for databases associated with this protected database.",
            "type":"string"
        },
        "unprotectedDataWindowCurrent":{
            "description":"The point beyond which recovery is impossible unless additional redo is available.",
            "type":"string"
        },
        "mediaManagerRecoveryWindowGoal":{
            "description":"A longer window within which point-in-time recovery capability from a media manager (e.g., Oracle Secure Backup) will be maintained.",
            "type":"string"
        },
        "maxDiskBackupRetention":{
            "description":"A maximum time that disk backups should be retained. This value must be greater than or equal to the disk recovery window goal. If not specified, backups will be be retained beyond the disk recovery window goal as space permits.",
            "type":"string"
        },
        "guaranteedBackupCopy":{
            "description":"Always accept new backups even if it requires purging existing backups not yet copied to media or replicated.",
            "type":"string"
        },
        "backupRedoFailover":{
            "description":"Specifies whether protected databases using this protection policy will use this Recovery Appliance as an alternate destination in a backup and redo failover strategy.",
            "type":"string"
        },
        "lastCompleteBackup":{
            "description":"The latest time for which a backup of all datafiles in the database exists.",
            "type":"string"
        },
        "lastCopyToTape":{
            "description":"The timestamp of the last complete copy-to-tape operation for this database.",
            "type":"string"
        },
        "lastCopyToCloud":{
            "description":"The timestamp of the last complete copy-to-cloud operation for this database.",
            "type":"string"
        },
        "lastReplication":{
            "description":"The timestamp of the last complete replication operation for this database.",
            "type":"string"
        },
        "copyToCloudEnabled":{
            "description":"Enabled (YES) or disabled (NO) of copy-to-cloud operation for this database.",
            "type":"string"
        },
        "copyToTapeEnabled":{
            "description":"Enabled (YES) or disabled (NO) of copy-to-tape operation for this database.",
            "type":"string"
        },
        "replicationEnabled":{
            "description":"Enabled (YES) or disabled (NO) of replication operation for this database.",
            "type":"string"
        },
        "finalChangeNumber":{
            "description":"The highest SCN to which this database can be recovered when using backups and redo logs available on Recovery Appliance.",
            "type":"string"
        },
        "replicationServerList":{
            "description":"The list of replication server configurations associated with this protection policy.",
            "type":"string"
        },
        "databaseKey":{
            "description":"The primary key for this database in the Recovery Appliance metadata database.",
            "type":"string"
        },
        "deleting":{
            "description":"YES if this database is currently being deleted.",
            "type":"string"
        },
        "dbid":{
            "description":"The DBID for this protected database.",
            "type":"string"
        },
        "creationTime":{
            "description":"The time of task creation.",
            "type":"string"
        },
        "storageLocation":{
            "description":"The name of the Recovery Appliance storage location used by this protected database.",
            "type":"string"
        },
        "timeZone":{
            "description":"The time zone offset of the protected database.",
            "type":"string"
        },
        "spaceUsage":{
            "description":"The amount of disk space (in GB) currently used by this protected database.",
            "type":"string"
        },
        "keepSpace":{
            "description":"The space used to hold KEEP backups for the database.",
            "type":"string"
        },
        "diskReservedSpace":{
            "description":"The amount of disk space(in GB) reserved for the exclusive use of this database.",
            "type":"string"
        },
        "replicationSetupStatus":{
            "description":"The status of the setup for the downstream replication appliance for this database.",
            "type":"string"
        },
        "restoreWindow":{
            "description":"The time range used to compute the value of the estimated space that is needed to meet the recovery window goal.",
            "type":"string"
        },
        "minimumRecoveryNeeded":{
            "description":"The minimum interval needed to restore the protected database to the present.",
            "type":"string"
        },
        "nzdlActive":{
            "description":"YES if real-time redo transport is active. NO if redo has not recently been received.",
            "type":"string"
        },
        "allowBackupDeletion":{
            "description":"The setting that controls whether RMAN backups for databases that use this protection policy can be deleted.",
            "type":"string"
        },
        "deduplicationFactor":{
            "description":"The ratio of the total size of virtual full backups to the actual consumed space on the appliance for this protected database.",
            "type":"string"
        },
        "vpcUser":{
            "description":"The list of Recovery Appliance recovery catalog user for this protected database.",
            "type":"string"
        }
    },
    "allOf":[
        {
            "$ref":"#/components/schemas/ChildDetailsLink"
        },
        {
            "type":"object"
        }
    ]
}

Nested Schema : ChildDetailsLink

Type: object

Object details Link.

Show Source

links(required): object links

Navigation links.

{
    "description":"Object details Link.",
    "type":"object",
    "required":[
        "links"
    ],
    "properties":{
        "links":{
            "type":"object",
            "description":"Navigation links.",
            "properties":{
                "self":{
                    "$ref":"#/components/schemas/Link"
                }
            }
        }
    }
}

Nested Schema : ProtectedDatabase-allOf[1]

Type: object

Nested Schema : links

Type: object

Navigation links.

Show Source

self: object Link

Represents a link(could be self, previous or next)

{
    "type":"object",
    "description":"Navigation links.",
    "properties":{
        "self":{
            "$ref":"#/components/schemas/Link"
        }
    }
}

Nested Schema : Link

Type: object

Represents a link(could be self, previous or next)

Show Source

href: string

URL for Link

Example: /em/api/<resources>?page=b2Zmc2V0OjA&limit=0

{
    "type":"object",
    "description":"Represents a link(could be self, previous or next)",
    "properties":{
        "href":{
            "type":"string",
            "description":"URL for Link",
            "example":"/em/api/<resources>?page=b2Zmc2V0OjA&limit=0"
        }
    }
}

Nested Schema : links

Type: object

Navigation links.

Show Source

next: object Link

Represents a link(could be self, previous or next)
self: object Link

Represents a link(could be self, previous or next)

{
    "type":"object",
    "description":"Navigation links.",
    "properties":{
        "self":{
            "$ref":"#/components/schemas/Link"
        },
        "next":{
            "$ref":"#/components/schemas/Link"
        }
    }
}

400 Response

Bad Request

Root Schema : CommonErrorResponse

Type: object

Common Error response.

Show Source

code(required): string

HTTP Status Code
errors(required): array errors

List of errors and their details.
message(required): string

Error description.

{
    "description":"Common Error response.",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/ErrorResponse"
        }
    ],
    "required":[
        "code",
        "message",
        "errors"
    ],
    "properties":{
        "code":{
            "description":"HTTP Status Code",
            "type":"string"
        },
        "message":{
            "description":"Error description.",
            "type":"string"
        },
        "errors":{
            "description":"List of errors and their details.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ErrorResponse"
            }
        }
    }
}

Match All

Show Source

object ErrorResponse

Error response

{
    "description":"Common Error response.",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/ErrorResponse"
        }
    ],
    "required":[
        "code",
        "message",
        "errors"
    ],
    "properties":{
        "code":{
            "description":"HTTP Status Code",
            "type":"string"
        },
        "message":{
            "description":"Error description.",
            "type":"string"
        },
        "errors":{
            "description":"List of errors and their details.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ErrorResponse"
            }
        }
    }
}

Nested Schema : errors

Type: array

List of errors and their details.

Show Source

Array of: object ErrorResponse

Error response

{
    "description":"List of errors and their details.",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ErrorResponse"
    }
}

Nested Schema : ErrorResponse

Type: object

Error response

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing
message(required): string

A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

401 Response

Unauthorized

Root Schema : CommonErrorResponse

Type: object

Common Error response.

Show Source

code(required): string

HTTP Status Code
errors(required): array errors

List of errors and their details.
message(required): string

Error description.

{
    "description":"Common Error response.",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/ErrorResponse"
        }
    ],
    "required":[
        "code",
        "message",
        "errors"
    ],
    "properties":{
        "code":{
            "description":"HTTP Status Code",
            "type":"string"
        },
        "message":{
            "description":"Error description.",
            "type":"string"
        },
        "errors":{
            "description":"List of errors and their details.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ErrorResponse"
            }
        }
    }
}

Match All

Show Source

object ErrorResponse

Error response

{
    "description":"Common Error response.",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/ErrorResponse"
        }
    ],
    "required":[
        "code",
        "message",
        "errors"
    ],
    "properties":{
        "code":{
            "description":"HTTP Status Code",
            "type":"string"
        },
        "message":{
            "description":"Error description.",
            "type":"string"
        },
        "errors":{
            "description":"List of errors and their details.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ErrorResponse"
            }
        }
    }
}

Nested Schema : errors

Type: array

List of errors and their details.

Show Source

Array of: object ErrorResponse

Error response

{
    "description":"List of errors and their details.",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ErrorResponse"
    }
}

Nested Schema : ErrorResponse

Type: object

Error response

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing
message(required): string

A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

403 Response

Forbidden

Root Schema : CommonErrorResponse

Type: object

Common Error response.

Show Source

code(required): string

HTTP Status Code
errors(required): array errors

List of errors and their details.
message(required): string

Error description.

{
    "description":"Common Error response.",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/ErrorResponse"
        }
    ],
    "required":[
        "code",
        "message",
        "errors"
    ],
    "properties":{
        "code":{
            "description":"HTTP Status Code",
            "type":"string"
        },
        "message":{
            "description":"Error description.",
            "type":"string"
        },
        "errors":{
            "description":"List of errors and their details.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ErrorResponse"
            }
        }
    }
}

Match All

Show Source

object ErrorResponse

Error response

{
    "description":"Common Error response.",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/ErrorResponse"
        }
    ],
    "required":[
        "code",
        "message",
        "errors"
    ],
    "properties":{
        "code":{
            "description":"HTTP Status Code",
            "type":"string"
        },
        "message":{
            "description":"Error description.",
            "type":"string"
        },
        "errors":{
            "description":"List of errors and their details.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ErrorResponse"
            }
        }
    }
}

Nested Schema : errors

Type: array

List of errors and their details.

Show Source

Array of: object ErrorResponse

Error response

{
    "description":"List of errors and their details.",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ErrorResponse"
    }
}

Nested Schema : ErrorResponse

Type: object

Error response

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing
message(required): string

A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

404 Response

Not Found

Root Schema : CommonErrorResponse

Type: object

Common Error response.

Show Source

code(required): string

HTTP Status Code
errors(required): array errors

List of errors and their details.
message(required): string

Error description.

{
    "description":"Common Error response.",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/ErrorResponse"
        }
    ],
    "required":[
        "code",
        "message",
        "errors"
    ],
    "properties":{
        "code":{
            "description":"HTTP Status Code",
            "type":"string"
        },
        "message":{
            "description":"Error description.",
            "type":"string"
        },
        "errors":{
            "description":"List of errors and their details.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ErrorResponse"
            }
        }
    }
}

Match All

Show Source

object ErrorResponse

Error response

{
    "description":"Common Error response.",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/ErrorResponse"
        }
    ],
    "required":[
        "code",
        "message",
        "errors"
    ],
    "properties":{
        "code":{
            "description":"HTTP Status Code",
            "type":"string"
        },
        "message":{
            "description":"Error description.",
            "type":"string"
        },
        "errors":{
            "description":"List of errors and their details.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ErrorResponse"
            }
        }
    }
}

Nested Schema : errors

Type: array

List of errors and their details.

Show Source

Array of: object ErrorResponse

Error response

{
    "description":"List of errors and their details.",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ErrorResponse"
    }
}

Nested Schema : ErrorResponse

Type: object

Error response

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing
message(required): string

A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

500 Response

Internal Server Error. Exception in execution of REST API.

Root Schema : ErrorResponse

Type: object

Error response

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing
message(required): string

A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

503 Response

Service Unavailable. The server is unable to process the request.

Root Schema : ErrorResponse

Type: object

Error response

Show Source

code(required): string

A short error code that defines the error, meant for programmatic parsing
message(required): string

A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}