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.
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)
)
string
[REQUIRED]
The unique identifier of the refreshable clone Autonomous Database to refresh.
datetime
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.
dict
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.
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'
)
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.
string
The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.
string
[REQUIRED]
The unique identifier of the source Autonomous Database whose refreshable clones you want to list.
dict
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.