odb / Client / list_autonomous_database_backups

list_autonomous_database_backups

odb.Client.list_autonomous_database_backups(**kwargs)

Lists the backups of the specified Autonomous Database.

See also: AWS API Documentation

Request Syntax

response = client.list_autonomous_database_backups(
    maxResults=123,
    nextToken='string',
    autonomousDatabaseId='string',
    status='ACTIVE'|'CREATING'|'UPDATING'|'DELETING'|'FAILED',
    type='INCREMENTAL'|'FULL'|'LONGTERM'|'VIRTUAL_FULL'|'CUMULATIVE_INCREMENTAL'|'ROLL_FORWARD_IMAGE_COPY'
)

Parameters:

• maxResults (integer) – The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output.

• nextToken (string) – The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.

• autonomousDatabaseId (string) –

  [REQUIRED]

  The unique identifier of the Autonomous Database whose backups you want to list.

• status (string) – The status of the Autonomous Database backups to return results for.

• type (string) – The type of the Autonomous Database backups to return results for.

Return type:

dict

Returns:

Response Syntax

{
    'nextToken': 'string',
    'autonomousDatabaseBackups': [
        {
            'autonomousDatabaseBackupId': 'string',
            'autonomousDatabaseBackupArn': 'string',
            'autonomousDatabaseId': 'string',
            'ocid': 'string',
            'displayName': 'string',
            'dbVersion': 'string',
            'status': 'ACTIVE'|'CREATING'|'UPDATING'|'DELETING'|'FAILED',
            'statusReason': 'string',
            'isAutomatic': True|False,
            'retentionPeriodInDays': 123,
            'sizeInTBs': 123.0,
            'timeAvailableTill': datetime(2015, 1, 1),
            'timeStarted': datetime(2015, 1, 1),
            'timeEnded': datetime(2015, 1, 1),
            'type': 'INCREMENTAL'|'FULL'|'LONGTERM'|'VIRTUAL_FULL'|'CUMULATIVE_INCREMENTAL'|'ROLL_FORWARD_IMAGE_COPY'
        },
    ]
}

Response Structure

• (dict) –

  • nextToken (string) –

    The token to include in another request to get the next page of items. This value is null when there are no more items to return.

  • autonomousDatabaseBackups (list) –

    The list of Autonomous Database backups along with their properties.

    • (dict) –

      A summary of an Autonomous Database backup.

      • autonomousDatabaseBackupId (string) –

        The unique identifier of the Autonomous Database backup.

      • autonomousDatabaseBackupArn (string) –

        The Amazon Resource Name (ARN) of the Autonomous Database backup.

      • autonomousDatabaseId (string) –

        The unique identifier of the Autonomous Database that the backup was created from.

      • ocid (string) –

        The Oracle Cloud Identifier (OCID) of the Autonomous Database backup.

      • displayName (string) –

        The user-friendly name of the Autonomous Database backup.

      • dbVersion (string) –

        The Oracle Database software version of the Autonomous Database backup.

      • status (string) –

        The current status of the Autonomous Database backup.

      • statusReason (string) –

        Additional information about the current status of the Autonomous Database backup, if applicable.

      • isAutomatic (boolean) –

        Indicates whether the backup was created automatically.

      • retentionPeriodInDays (integer) –

        The retention period, in days, for the Autonomous Database backup.

      • sizeInTBs (float) –

        The size of the Autonomous Database backup, in terabytes (TB).

      • timeAvailableTill (datetime) –

        The date and time until which the Autonomous Database backup is available for restore.

      • timeStarted (datetime) –

        The date and time when the Autonomous Database backup started.

      • timeEnded (datetime) –

        The date and time when the Autonomous Database backup ended.

      • type (string) –

        The type of the Autonomous Database backup.

Exceptions

• odb.Client.exceptions.ThrottlingException

• odb.Client.exceptions.ValidationException

• odb.Client.exceptions.AccessDeniedException

• odb.Client.exceptions.InternalServerException

• odb.Client.exceptions.ResourceNotFoundException