Jump to

• Request
• Response

List Protected Database Archival Backups

get

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

Get the list of archival backups for a protected database on the Recovery Appliance.

Request

Path Parameters

• protectedDatabaseUniqueName(required): string
  Protected database unique name.

  Example:

  PROTDB1

• 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

• 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.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful Operation

Body ()

Root Schema : ProtectedDatabaseArchivalBackupCollection

Type: object

Collection of Archival Backup objects

Show Source

• items(required): array items
  List of Archival Backup objects

{
    "description":"Collection of Archival Backup objects",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/CommonListProperties"
        }
    ],
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "description":"List of Archival Backup objects",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ArchivalBackupSingleDatabaseSummary"
            }
        }
    }
}

Match All

Show Source

• object CommonListProperties
  Common properties for list response.

{
    "description":"Collection of Archival Backup objects",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/CommonListProperties"
        }
    ],
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "description":"List of Archival Backup objects",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ArchivalBackupSingleDatabaseSummary"
            }
        }
    }
}

Nested Schema : items

Type: array

List of Archival Backup objects

Show Source

• Array of: object ArchivalBackupSingleDatabaseSummary
  Archival backup Properties

{
    "description":"List of Archival Backup objects",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ArchivalBackupSingleDatabaseSummary"
    }
}

Nested Schema : CommonListProperties

Type: object

Common properties for list response.

Show Source

• code: integer
  HTTP Response Code.
• count(required): integer
  Count of summary objects in this page.
• message: string
  Response message.
• raTargetName: string
  Recovery appliance target name.
• raTargetTimezone: string
  Recovery appliance timezone.

{
    "description":"Common properties for list response.",
    "required":[
        "count"
    ],
    "properties":{
        "count":{
            "description":"Count of summary objects in this page.",
            "type":"integer"
        },
        "raTargetTimezone":{
            "description":"Recovery appliance timezone.",
            "type":"string"
        },
        "raTargetName":{
            "description":"Recovery appliance target name.",
            "type":"string"
        },
        "code":{
            "description":"HTTP Response Code.",
            "type":"integer"
        },
        "message":{
            "description":"Response message.",
            "type":"string"
        }
    }
}

Nested Schema : ArchivalBackupSingleDatabaseSummary

Type: object

Archival backup Properties

Match All

Show Source

• object ArchivalBackupSingleDatabase
  Archival backup Properties

{
    "description":"Archival backup Properties",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/ArchivalBackupSingleDatabase"
        }
    ]
}

Nested Schema : ArchivalBackupSingleDatabase

Type: object

Archival backup Properties

Show Source

• creationTime: string
  Creation time of the archival backup.
• keepbkpTag: string
  Keep backup tag used for the archival backup.
• keepbkpToTime: string
  Keep backup time used for the archival backup.
• keepUntil: string
  Keep until time of the archival backup.
• name: string
  Archival backup name
• scn: string
  SCN of the database used for the archival backup.
• status: string
  Status of the archival backup. I (Initiated), A (Available), E (Error), D (Deleted)

  Example: A

{
    "description":"Archival backup Properties",
    "type":"object",
    "properties":{
        "name":{
            "description":"Archival backup name",
            "type":"string"
        },
        "scn":{
            "description":"SCN of the database used for the archival backup.",
            "type":"string"
        },
        "keepbkpTag":{
            "description":"Keep backup tag used for the archival backup.",
            "type":"string"
        },
        "keepbkpToTime":{
            "description":"Keep backup time used for the archival backup.",
            "type":"string"
        },
        "keepUntil":{
            "description":"Keep until time of the archival backup.",
            "type":"string"
        },
        "status":{
            "description":"Status of the archival backup.  I (Initiated), A (Available), E (Error), D (Deleted)",
            "type":"string",
            "example":"A"
        },
        "creationTime":{
            "description":"Creation time of the archival backup.",
            "type":"string"
        }
    }
}

400 Response

Bad Request. The payload is null or missing some parameters

Body ()

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"
        }
    }
}

401 Response

Unauthorized. The user does not have permissions to perform the requested operation

Body ()

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"
        }
    }
}

403 Response

Forbidden. The user is forbidden to perform the requested operation

Body ()

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"
        }
    }
}

404 Response

Not Found. The requested REST API URL is not found.

Body ()

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"
        }
    }
}

500 Response

Internal Server Error. Exception in execution of REST API.

Body ()

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.

Body ()

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"
        }
    }
}

Back to Top