Jump to

• Request
• Response

List Archival Backups for a Protected Database

get

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

List all archival backups for a protected database.

Request

Path Parameters

• protectedDatabaseUniqueName(required): string
  Protected database unique name.
• raTargetId(required): string
  Recovery Appliance id.

Header Parameters

• ORCL-EM-ZDLRATARGET-AUTHORIZATION:
  Recovery Appliance Administrator Credential. If not specified preferred credentials will be used.

  Example:

  NAMED:NC_RA_ADMIN

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful Operation

Body ()

Root Schema : ArchivalBackupCollection

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

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

Nested Schema : items

Type: array

List of archival backup objects.

Show Source

• Array of: object ArchivalBackupSummary
  Archival backup properties.

{
    "description":"List of archival backup objects.",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ArchivalBackupSummary"
    }
}

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 : ArchivalBackupSummary

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 specifying the backup to use for archival backup creation.
• status: string
  Status of the archival backup. I = Initiated, A = Available, E = Error, D = Deleting)

  Example: A

{
    "description":"Archival backup properties.",
    "type":"object",
    "properties":{
        "name":{
            "description":"Archival backup name.",
            "type":"string"
        },
        "scn":{
            "description":"SCN specifying the backup to use for archival backup creation.",
            "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 = Deleting)",
            "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