odb

2026/11/20 - odb - 2 new api methods

Changes  Adds the ListAutonomousDatabaseRefreshableClones and StartAutonomousDatabaseRefresh APIs for listing and refreshing refreshable clones of Autonomous Database Serverless.

StartAutonomousDatabaseRefresh (new) Link ¶

Starts a refresh of the specified refreshable clone Autonomous Database with data from its source database. The refresh runs asynchronously. To track its progress, check the refreshableStatus of the Autonomous Database.

See also: AWS API Documentation

Request Syntax

client.start_autonomous_database_refresh(
    autonomousDatabaseId='string',
    timeOfRefreshCutoff=datetime(2015, 1, 1)
)
type autonomousDatabaseId:

string

param autonomousDatabaseId:

[REQUIRED]

The unique identifier of the refreshable clone Autonomous Database to refresh.

type timeOfRefreshCutoff:

datetime

param timeOfRefreshCutoff:

The date and time up to which the refreshable clone Autonomous Database is refreshed from its source database. Data committed on the source database after this time isn't applied to the refreshable clone. The time must be at least 1 minute and at most 7 days in the past, and later than the clone's last refresh point.

rtype:

dict

returns:

Response Syntax

{
    'autonomousDatabaseId': 'string',
    'displayName': 'string',
    'status': 'AVAILABLE'|'FAILED'|'PROVISIONING'|'TERMINATED'|'TERMINATING'|'UPDATING'|'MAINTENANCE_IN_PROGRESS'|'STOPPING'|'STOPPED'|'STARTING'|'UNAVAILABLE'|'RESTORE_IN_PROGRESS'|'RESTORE_FAILED'|'BACKUP_IN_PROGRESS'|'SCALE_IN_PROGRESS'|'AVAILABLE_NEEDS_ATTENTION'|'RESTARTING'|'RECREATING'|'ROLE_CHANGE_IN_PROGRESS'|'UPGRADING'|'INACCESSIBLE'|'STANDBY',
    'statusReason': 'string',
    'refreshableStatus': 'REFRESHING'|'NOT_REFRESHING'
}

Response Structure

  • (dict) --

    • autonomousDatabaseId (string) --

      The unique identifier of the refreshable clone Autonomous Database that is being refreshed.

    • displayName (string) --

      The user-friendly name of the Autonomous Database.

    • status (string) --

      The current status of the Autonomous Database.

    • statusReason (string) --

      Additional information about the current status of the Autonomous Database.

    • refreshableStatus (string) --

      The refresh status of the refreshable clone Autonomous Database.

ListAutonomousDatabaseRefreshableClones (new) Link ¶

Lists the refreshable clones of the specified Autonomous Database.

See also: AWS API Documentation

Request Syntax

client.list_autonomous_database_refreshable_clones(
    maxResults=123,
    nextToken='string',
    autonomousDatabaseId='string'
)
type maxResults:

integer

param maxResults:

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.

type nextToken:

string

param nextToken:

The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.

type autonomousDatabaseId:

string

param autonomousDatabaseId:

[REQUIRED]

The unique identifier of the source Autonomous Database whose refreshable clones you want to list.

rtype:

dict

returns:

Response Syntax

{
    'nextToken': 'string',
    'autonomousDatabaseRefreshableClones': [
        {
            'autonomousDatabaseId': 'string',
            'autonomousDatabaseArn': 'string',
            'ocid': 'string',
            'region': 'string'
        },
    ]
}

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.

    • autonomousDatabaseRefreshableClones (list) --

      The list of refreshable clones for the Autonomous Database.

      • (dict) --

        A summary of a refreshable clone of an Autonomous Database.

        • autonomousDatabaseId (string) --

          The unique identifier of the refreshable clone Autonomous Database.

        • autonomousDatabaseArn (string) --

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

        • ocid (string) --

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

        • region (string) --

          The Amazon Web Services Region where the refreshable clone Autonomous Database is located.