SDK for PHP V3

Client: Aws\Odb\OdbClient
Service ID: odb
Version: 2024-08-20

This page describes the parameters and results for the operations of the odb (2024-08-20), and shows how to use the Aws\Odb\OdbClient object to call the described operations. This documentation is specific to the 2024-08-20 API version of the service.

Operation Summary

Each of the following operations can be created from a client using $client->getCommand('CommandName'), where "CommandName" is the name of one of the following operations. Note: a command is a value that encapsulates an operation and the parameters used to create an HTTP request.

You can also create and send a command immediately using the magic methods available on a client object: $client->commandName(/* parameters */). You can send the command asynchronously (returning a promise) by appending the word "Async" to the operation name: $client->commandNameAsync(/* parameters */).

AcceptMarketplaceRegistration ( array $params = [] )
Registers the Amazon Web Services Marketplace token for your Amazon Web Services account to activate your Oracle Database@Amazon Web Services subscription.
AssociateIamRoleToResource ( array $params = [] )
Associates an Amazon Web Services Identity and Access Management (IAM) service role with a specified resource to enable Amazon Web Services service integration.
CreateAutonomousDatabase ( array $params = [] )
Creates a new Autonomous Database.
CreateAutonomousDatabaseBackup ( array $params = [] )
Creates a new backup of the specified Autonomous Database.
CreateAutonomousDatabaseWallet ( array $params = [] )
Creates a new wallet for the specified Autonomous Database.
CreateCloudAutonomousVmCluster ( array $params = [] )
Creates a new Autonomous VM cluster in the specified Exadata infrastructure.
CreateCloudExadataInfrastructure ( array $params = [] )
Creates an Exadata infrastructure.
CreateCloudVmCluster ( array $params = [] )
Creates a VM cluster on the specified Exadata infrastructure.
CreateOdbNetwork ( array $params = [] )
Creates an ODB network.
CreateOdbPeeringConnection ( array $params = [] )
Creates a peering connection between an ODB network and a VPC.
DeleteAutonomousDatabase ( array $params = [] )
Deletes the specified Autonomous Database.
DeleteAutonomousDatabaseBackup ( array $params = [] )
Deletes the specified Autonomous Database backup.
DeleteCloudAutonomousVmCluster ( array $params = [] )
Deletes an Autonomous VM cluster.
DeleteCloudExadataInfrastructure ( array $params = [] )
Deletes the specified Exadata infrastructure.
DeleteCloudVmCluster ( array $params = [] )
Deletes the specified VM cluster.
DeleteOdbNetwork ( array $params = [] )
Deletes the specified ODB network.
DeleteOdbPeeringConnection ( array $params = [] )
Deletes an ODB peering connection.
DisassociateIamRoleFromResource ( array $params = [] )
Disassociates an Amazon Web Services Identity and Access Management (IAM) service role from a specified resource to disable Amazon Web Services service integration.
FailoverAutonomousDatabase ( array $params = [] )
Initiates a failover of the specified Autonomous Database to a standby peer database.
GetAutonomousDatabase ( array $params = [] )
Gets information about a specific Autonomous Database.
GetAutonomousDatabaseBackup ( array $params = [] )
Gets information about a specific Autonomous Database backup.
GetAutonomousDatabaseWalletDetails ( array $params = [] )
Gets the wallet details for the specified Autonomous Database.
GetCloudAutonomousVmCluster ( array $params = [] )
Gets information about a specific Autonomous VM cluster.
GetCloudExadataInfrastructure ( array $params = [] )
Returns information about the specified Exadata infrastructure.
GetCloudExadataInfrastructureUnallocatedResources ( array $params = [] )
Retrieves information about unallocated resources in a specified Cloud Exadata Infrastructure.
GetCloudVmCluster ( array $params = [] )
Returns information about the specified VM cluster.
GetDbNode ( array $params = [] )
Returns information about the specified DB node.
GetDbServer ( array $params = [] )
Returns information about the specified database server.
GetOciOnboardingStatus ( array $params = [] )
Returns the tenancy activation link and onboarding status for your Amazon Web Services account.
GetOdbNetwork ( array $params = [] )
Returns information about the specified ODB network.
GetOdbPeeringConnection ( array $params = [] )
Retrieves information about an ODB peering connection.
InitializeService ( array $params = [] )
Initializes the ODB service for the first time in an account.
ListAutonomousDatabaseBackups ( array $params = [] )
Lists the backups of the specified Autonomous Database.
ListAutonomousDatabaseCharacterSets ( array $params = [] )
Lists the available character sets for Autonomous Databases.
ListAutonomousDatabaseClones ( array $params = [] )
Lists the clones of the specified Autonomous Database.
ListAutonomousDatabasePeers ( array $params = [] )
Lists the peer databases of the specified Autonomous Database.
ListAutonomousDatabaseVersions ( array $params = [] )
Lists the available Oracle Database software versions for Autonomous Databases.
ListAutonomousDatabases ( array $params = [] )
Returns information about the Autonomous Databases owned by your Amazon Web Services account in the current Amazon Web Services Region.
ListAutonomousVirtualMachines ( array $params = [] )
Lists all Autonomous VMs in an Autonomous VM cluster.
ListCloudAutonomousVmClusters ( array $params = [] )
Lists all Autonomous VM clusters in a specified Cloud Exadata infrastructure.
ListCloudExadataInfrastructures ( array $params = [] )
Returns information about the Exadata infrastructures owned by your Amazon Web Services account.
ListCloudVmClusters ( array $params = [] )
Returns information about the VM clusters owned by your Amazon Web Services account or only the ones on the specified Exadata infrastructure.
ListDbNodes ( array $params = [] )
Returns information about the DB nodes for the specified VM cluster.
ListDbServers ( array $params = [] )
Returns information about the database servers that belong to the specified Exadata infrastructure.
ListDbSystemShapes ( array $params = [] )
Returns information about the shapes that are available for an Exadata infrastructure.
ListGiVersions ( array $params = [] )
Returns information about Oracle Grid Infrastructure (GI) software versions that are available for a VM cluster for the specified shape.
ListOdbNetworks ( array $params = [] )
Returns information about the ODB networks owned by your Amazon Web Services account.
ListOdbPeeringConnections ( array $params = [] )
Lists all ODB peering connections or those associated with a specific ODB network.
ListSystemVersions ( array $params = [] )
Returns information about the system versions that are available for a VM cluster for the specified giVersion and shape.
ListTagsForResource ( array $params = [] )
Returns information about the tags applied to this resource.
RebootAutonomousDatabase ( array $params = [] )
Reboots the specified Autonomous Database.
RebootDbNode ( array $params = [] )
Reboots the specified DB node in a VM cluster.
RestoreAutonomousDatabase ( array $params = [] )
Restores the specified Autonomous Database to a point in time.
ShrinkAutonomousDatabase ( array $params = [] )
Shrinks the storage of the specified Autonomous Database to reclaim unused space.
StartAutonomousDatabase ( array $params = [] )
Starts the specified Autonomous Database.
StartDbNode ( array $params = [] )
Starts the specified DB node in a VM cluster.
StopAutonomousDatabase ( array $params = [] )
Stops the specified Autonomous Database.
StopDbNode ( array $params = [] )
Stops the specified DB node in a VM cluster.
SwitchoverAutonomousDatabase ( array $params = [] )
Performs a switchover of the specified Autonomous Database to a standby peer database.
TagResource ( array $params = [] )
Applies tags to the specified resource.
UntagResource ( array $params = [] )
Removes tags from the specified resource.
UpdateAutonomousDatabase ( array $params = [] )
Updates the properties of an Autonomous Database.
UpdateAutonomousDatabaseBackup ( array $params = [] )
Updates the properties of an Autonomous Database backup.
UpdateCloudExadataInfrastructure ( array $params = [] )
Updates the properties of an Exadata infrastructure resource.
UpdateOdbNetwork ( array $params = [] )
Updates properties of a specified ODB network.
UpdateOdbPeeringConnection ( array $params = [] )
Modifies the settings of an Oracle Database@Amazon Web Services peering connection.

Paginators

Paginators handle automatically iterating over paginated API results. Paginators are associated with specific API operations, and they accept the parameters that the corresponding API operation accepts. You can get a paginator from a client class using getPaginator($paginatorName, $operationParameters). This client supports the following paginators:

ListAutonomousDatabaseBackups
ListAutonomousDatabaseCharacterSets
ListAutonomousDatabaseClones
ListAutonomousDatabasePeers
ListAutonomousDatabaseVersions
ListAutonomousDatabases
ListAutonomousVirtualMachines
ListCloudAutonomousVmClusters
ListCloudExadataInfrastructures
ListCloudVmClusters
ListDbNodes
ListDbServers
ListDbSystemShapes
ListGiVersions
ListOdbNetworks
ListOdbPeeringConnections
ListSystemVersions

Operations

AcceptMarketplaceRegistration

$result = $client->acceptMarketplaceRegistration([/* ... */]);
$promise = $client->acceptMarketplaceRegistrationAsync([/* ... */]);

Registers the Amazon Web Services Marketplace token for your Amazon Web Services account to activate your Oracle Database@Amazon Web Services subscription.

Parameter Syntax

$result = $client->acceptMarketplaceRegistration([
    'marketplaceRegistrationToken' => '<string>', // REQUIRED
]);

Parameter Details

Members
marketplaceRegistrationToken
Required: Yes
Type: string

The registration token that's generated by Amazon Web Services Marketplace and sent to Oracle Database@Amazon Web Services.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

AssociateIamRoleToResource

$result = $client->associateIamRoleToResource([/* ... */]);
$promise = $client->associateIamRoleToResourceAsync([/* ... */]);

Associates an Amazon Web Services Identity and Access Management (IAM) service role with a specified resource to enable Amazon Web Services service integration.

Parameter Syntax

$result = $client->associateIamRoleToResource([
    'awsIntegration' => 'KmsTde', // REQUIRED
    'iamRoleArn' => '<string>', // REQUIRED
    'resourceArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
awsIntegration
Required: Yes
Type: string

The Amazon Web Services integration configuration settings for the Amazon Web Services Identity and Access Management (IAM) service role association.

iamRoleArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the Amazon Web Services Identity and Access Management (IAM) service role to associate with the resource.

resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the target resource to associate with the Amazon Web Services Identity and Access Management (IAM) service role.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

CreateAutonomousDatabase

$result = $client->createAutonomousDatabase([/* ... */]);
$promise = $client->createAutonomousDatabaseAsync([/* ... */]);

Creates a new Autonomous Database.

Parameter Syntax

$result = $client->createAutonomousDatabase([
    'adminPassword' => '<string>',
    'allowlistedIps' => ['<string>', ...],
    'autonomousMaintenanceScheduleType' => 'EARLY|REGULAR',
    'backupRetentionPeriodInDays' => <integer>,
    'byolComputeCountLimit' => <float>,
    'characterSet' => '<string>',
    'clientToken' => '<string>',
    'computeCount' => <float>,
    'cpuCoreCount' => <integer>,
    'customerContactsToSendToOCI' => [
        [
            'email' => '<string>',
        ],
        // ...
    ],
    'dataStorageSizeInGBs' => <integer>,
    'dataStorageSizeInTBs' => <integer>,
    'databaseEdition' => 'STANDARD_EDITION|ENTERPRISE_EDITION',
    'dbName' => '<string>',
    'dbToolsDetails' => [
        [
            'computeCount' => <float>,
            'isEnabled' => true || false,
            'maxIdleTimeInMinutes' => <integer>,
            'name' => '<string>',
        ],
        // ...
    ],
    'dbVersion' => '<string>',
    'dbWorkload' => 'OLTP|AJD|APEX|LH',
    'displayName' => '<string>',
    'encryptionKeyConfiguration' => [
        'awsEncryptionKey' => [
            'externalIdType' => 'database_ocid|compartment_ocid|tenant_ocid',
            'iamRoleArn' => '<string>',
            'kmsKeyId' => '<string>',
        ],
    ],
    'encryptionKeyProvider' => 'ORACLE_MANAGED|AWS_KMS',
    'isAutoScalingEnabled' => true || false,
    'isAutoScalingForStorageEnabled' => true || false,
    'isBackupRetentionLocked' => true || false,
    'isLocalDataGuardEnabled' => true || false,
    'isMtlsConnectionRequired' => true || false,
    'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
    'ncharacterSet' => '<string>',
    'odbNetworkId' => '<string>',
    'privateEndpointIp' => '<string>',
    'privateEndpointLabel' => '<string>',
    'resourcePoolLeaderId' => '<string>',
    'resourcePoolSummary' => [
        'availableComputeCapacity' => <integer>,
        'availableStorageCapacityInTBs' => <float>,
        'isDisabled' => true || false,
        'poolSize' => <integer>,
        'poolStorageSizeInTBs' => <integer>,
        'totalComputeCapacity' => <integer>,
    ],
    'scheduledOperations' => [
        [
            'dayOfWeek' => [ // REQUIRED
                'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
            ],
            'scheduledStartTime' => '<string>',
            'scheduledStopTime' => '<string>',
        ],
        // ...
    ],
    'source' => 'NONE|DATABASE|BACKUP_FROM_ID|BACKUP_FROM_TIMESTAMP|CROSS_REGION_DATAGUARD|CROSS_REGION_DISASTER_RECOVERY|CLONE_TO_REFRESHABLE',
    'sourceConfiguration' => [
        'cloneToRefreshable' => [
            'autoRefreshFrequencyInSeconds' => <integer>,
            'autoRefreshPointLagInSeconds' => <integer>,
            'cloneType' => 'FULL|METADATA|PARTIAL',
            'openMode' => 'READ_ONLY|READ_WRITE',
            'refreshableMode' => 'AUTOMATIC|MANUAL',
            'sourceAutonomousDatabaseId' => '<string>', // REQUIRED
            'timeOfAutoRefreshStart' => <integer || string || DateTime>,
        ],
        'crossRegionDataGuard' => [
            'sourceAutonomousDatabaseArn' => '<string>', // REQUIRED
        ],
        'crossRegionDisasterRecovery' => [
            'isReplicateAutomaticBackups' => true || false,
            'remoteDisasterRecoveryType' => 'ADG|BACKUP_BASED', // REQUIRED
            'sourceAutonomousDatabaseArn' => '<string>', // REQUIRED
        ],
        'databaseClone' => [
            'cloneType' => 'FULL|METADATA|PARTIAL', // REQUIRED
            'sourceAutonomousDatabaseId' => '<string>', // REQUIRED
        ],
        'pointInTimeRestore' => [
            'cloneTableSpaceList' => [<integer>, ...],
            'cloneType' => 'FULL|METADATA|PARTIAL', // REQUIRED
            'sourceAutonomousDatabaseId' => '<string>', // REQUIRED
            'timestamp' => <integer || string || DateTime>,
            'useLatestAvailableBackupTimestamp' => true || false,
        ],
        'restoreFromBackup' => [
            'autonomousDatabaseBackupId' => '<string>', // REQUIRED
            'cloneTableSpaceList' => [<integer>, ...],
            'cloneType' => 'FULL|METADATA|PARTIAL', // REQUIRED
        ],
    ],
    'standbyAllowlistedIps' => ['<string>', ...],
    'standbyAllowlistedIpsSource' => 'PRIMARY|SEPARATE|NOT_APPLICABLE',
    'tags' => ['<string>', ...],
    'transportableTablespace' => [
        'ttsBundleUrl' => '<string>',
    ],
]);

Parameter Details

Members
adminPassword
Type: string

The password for the ADMIN user of the Autonomous Database.

allowlistedIps
Type: Array of strings

The list of IP addresses that are allowed to access the Autonomous Database.

autonomousMaintenanceScheduleType
Type: string

The maintenance schedule type for the Autonomous Database.

backupRetentionPeriodInDays
Type: int

The retention period, in days, for automatic backups of the Autonomous Database.

byolComputeCountLimit
Type: double

The maximum number of compute resources that you can allocate to the Autonomous Database under the bring-your-own-license (BYOL) model.

characterSet
Type: string

The character set to use for the Autonomous Database.

clientToken
Type: string

A client-provided token to ensure the idempotency of the request.

computeCount
Type: double

The compute capacity, in number of Elastic CPUs (ECPUs) or Oracle CPUs (OCPUs), to assign to the Autonomous Database.

cpuCoreCount
Type: int

The number of CPU cores to allocate to the Autonomous Database.

customerContactsToSendToOCI
Type: Array of CustomerContact structures

The list of customer contacts to receive operational notifications from Oracle Cloud Infrastructure (OCI) for the Autonomous Database.

dataStorageSizeInGBs
Type: int

The size, in gigabytes (GB), of the data volume to allocate for the Autonomous Database.

dataStorageSizeInTBs
Type: int

The size, in terabytes (TB), of the data volume to allocate for the Autonomous Database.

databaseEdition
Type: string

The Oracle Database edition to apply to the Autonomous Database.

dbName
Type: string

The name of the Autonomous Database. The name must begin with an alphabetic character and can contain a maximum of 30 alphanumeric characters. Special characters are not permitted. The name must be unique in the Amazon Web Services account.

dbToolsDetails
Type: Array of DatabaseTool structures

The list of database management tools to enable for the Autonomous Database.

dbVersion
Type: string

The Oracle Database software version to use for the Autonomous Database.

dbWorkload
Type: string

The intended use of the Autonomous Database, such as transaction processing, data warehouse, JSON database, or APEX.

displayName
Type: string

The user-friendly name for the Autonomous Database. The name does not have to be unique.

encryptionKeyConfiguration

The configuration of the encryption key to use for the Autonomous Database.

encryptionKeyProvider
Type: string

The provider of the encryption key to use for the Autonomous Database.

isAutoScalingEnabled
Type: boolean

Specifies whether to enable automatic scaling of the compute resources for the Autonomous Database.

isAutoScalingForStorageEnabled
Type: boolean

Specifies whether to enable automatic scaling of the storage for the Autonomous Database.

isBackupRetentionLocked
Type: boolean

Specifies whether to lock the backup retention period of the Autonomous Database to prevent it from being shortened.

isLocalDataGuardEnabled
Type: boolean

Specifies whether to enable local Oracle Data Guard for the Autonomous Database.

isMtlsConnectionRequired
Type: boolean

Specifies whether mutual TLS (mTLS) authentication is required to connect to the Autonomous Database.

licenseModel
Type: string

The Oracle license model to apply to the Autonomous Database.

ncharacterSet
Type: string

The national character set to use for the Autonomous Database.

odbNetworkId
Type: string

The unique identifier of the ODB network to be used for the Autonomous Database.

privateEndpointIp
Type: string

The private endpoint IP address for the Autonomous Database.

privateEndpointLabel
Type: string

The private endpoint label for the Autonomous Database.

resourcePoolLeaderId
Type: string

The unique identifier of the resource pool leader Autonomous Database.

resourcePoolSummary
Type: ResourcePoolSummary structure

The configuration of the resource pool for the Autonomous Database.

scheduledOperations
Type: Array of ScheduledOperationDetails structures

The list of scheduled start and stop times for the Autonomous Database.

source
Type: string

The source from which to create the Autonomous Database, such as a clone, backup, or cross-Region copy.

sourceConfiguration
Type: SourceConfiguration structure

The configuration details for the source used to create the Autonomous Database.

standbyAllowlistedIps
Type: Array of strings

The list of IP addresses that are allowed to access the standby Autonomous Database.

standbyAllowlistedIpsSource
Type: string

The source of the allowlisted IP addresses for the standby Autonomous Database.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The list of resource tags to apply to the Autonomous Database. Each tag is a key-value pair with no predefined name, type, or namespace.

transportableTablespace
Type: TransportableTablespace structure

The transportable tablespace configuration to use when creating the Autonomous Database.

Result 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>',
]

Result Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database that was created.

displayName
Type: string

The user-friendly name of the Autonomous Database that was created.

status
Type: string

The current status of the Autonomous Database.

statusReason
Type: string

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

Errors

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

You have exceeded the service quota.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

CreateAutonomousDatabaseBackup

$result = $client->createAutonomousDatabaseBackup([/* ... */]);
$promise = $client->createAutonomousDatabaseBackupAsync([/* ... */]);

Creates a new backup of the specified Autonomous Database.

Parameter Syntax

$result = $client->createAutonomousDatabaseBackup([
    'autonomousDatabaseId' => '<string>', // REQUIRED
    'clientToken' => '<string>',
    'displayName' => '<string>',
    'retentionPeriodInDays' => <integer>,
    'tags' => ['<string>', ...],
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to back up.

clientToken
Type: string

A client-provided token to ensure the idempotency of the request.

displayName
Type: string

The user-friendly name for the Autonomous Database backup.

retentionPeriodInDays
Type: int

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

tags
Type: Associative array of custom strings keys (TagKey) to strings

The list of resource tags to apply to the Autonomous Database backup. Each tag is a key-value pair with no predefined name, type, or namespace.

Result Syntax

[
    'autonomousDatabaseBackupId' => '<string>',
    'displayName' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
    'statusReason' => '<string>',
]

Result Details

Members
autonomousDatabaseBackupId
Required: Yes
Type: string

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

displayName
Type: string

The user-friendly name of the Autonomous Database backup that was created.

status
Type: string

The current status of the Autonomous Database backup.

statusReason
Type: string

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

Errors

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

You have exceeded the service quota.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

CreateAutonomousDatabaseWallet

$result = $client->createAutonomousDatabaseWallet([/* ... */]);
$promise = $client->createAutonomousDatabaseWalletAsync([/* ... */]);

Creates a new wallet for the specified Autonomous Database.

Parameter Syntax

$result = $client->createAutonomousDatabaseWallet([
    'autonomousDatabaseId' => '<string>', // REQUIRED
    'clientToken' => '<string>',
    'password' => '<string>', // REQUIRED
    'walletType' => 'REGIONAL|INSTANCE',
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to create a wallet for.

clientToken
Type: string

A client-provided token to ensure the idempotency of the request.

password
Required: Yes
Type: string

The password to encrypt the keys inside the wallet.

walletType
Type: string

The type of wallet to create, either a regional wallet or an instance wallet.

Result Syntax

[
    'autonomousDatabaseWalletFile' => <string || resource || Psr\Http\Message\StreamInterface>,
]

Result Details

Members
autonomousDatabaseWalletFile
Required: Yes
Type: blob (string|resource|Psr\Http\Message\StreamInterface)

The generated wallet file for the Autonomous Database, returned as a compressed archive.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

CreateCloudAutonomousVmCluster

$result = $client->createCloudAutonomousVmCluster([/* ... */]);
$promise = $client->createCloudAutonomousVmClusterAsync([/* ... */]);

Creates a new Autonomous VM cluster in the specified Exadata infrastructure.

Parameter Syntax

$result = $client->createCloudAutonomousVmCluster([
    'autonomousDataStorageSizeInTBs' => <float>, // REQUIRED
    'clientToken' => '<string>',
    'cloudExadataInfrastructureId' => '<string>', // REQUIRED
    'cpuCoreCountPerNode' => <integer>, // REQUIRED
    'dbServers' => ['<string>', ...],
    'description' => '<string>',
    'displayName' => '<string>', // REQUIRED
    'isMtlsEnabledVmCluster' => true || false,
    'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
    'maintenanceWindow' => [
        'customActionTimeoutInMins' => <integer>,
        'daysOfWeek' => [
            [
                'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
            ],
            // ...
        ],
        'hoursOfDay' => [<integer>, ...],
        'isCustomActionTimeoutEnabled' => true || false,
        'leadTimeInWeeks' => <integer>,
        'months' => [
            [
                'name' => 'JANUARY|FEBRUARY|MARCH|APRIL|MAY|JUNE|JULY|AUGUST|SEPTEMBER|OCTOBER|NOVEMBER|DECEMBER',
            ],
            // ...
        ],
        'patchingMode' => 'ROLLING|NONROLLING',
        'preference' => 'NO_PREFERENCE|CUSTOM_PREFERENCE',
        'skipRu' => true || false,
        'weeksOfMonth' => [<integer>, ...],
    ],
    'memoryPerOracleComputeUnitInGBs' => <integer>, // REQUIRED
    'odbNetworkId' => '<string>', // REQUIRED
    'scanListenerPortNonTls' => <integer>,
    'scanListenerPortTls' => <integer>,
    'tags' => ['<string>', ...],
    'timeZone' => '<string>',
    'totalContainerDatabases' => <integer>, // REQUIRED
]);

Parameter Details

Members
autonomousDataStorageSizeInTBs
Required: Yes
Type: double

The data disk group size to be allocated for Autonomous Databases, in terabytes (TB).

clientToken
Type: string

A client-provided token to ensure idempotency of the request.

cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier of the Exadata infrastructure where the VM cluster will be created.

cpuCoreCountPerNode
Required: Yes
Type: int

The number of CPU cores to be enabled per VM cluster node.

dbServers
Type: Array of strings

The list of database servers to be used for the Autonomous VM cluster.

description
Type: string

A user-provided description of the Autonomous VM cluster.

displayName
Required: Yes
Type: string

The display name for the Autonomous VM cluster. The name does not need to be unique.

isMtlsEnabledVmCluster
Type: boolean

Specifies whether to enable mutual TLS (mTLS) authentication for the Autonomous VM cluster.

licenseModel
Type: string

The Oracle license model to apply to the Autonomous VM cluster.

maintenanceWindow
Type: MaintenanceWindow structure

The scheduling details for the maintenance window. Patching and system updates take place during the maintenance window.

memoryPerOracleComputeUnitInGBs
Required: Yes
Type: int

The amount of memory to be allocated per OCPU, in GB.

odbNetworkId
Required: Yes
Type: string

The unique identifier of the ODB network to be used for the VM cluster.

scanListenerPortNonTls
Type: int

The SCAN listener port for non-TLS (TCP) protocol.

scanListenerPortTls
Type: int

The SCAN listener port for TLS (TCP) protocol.

tags
Type: Associative array of custom strings keys (TagKey) to strings

Free-form tags for this resource. Each tag is a key-value pair with no predefined name, type, or namespace.

timeZone
Type: string

The time zone to use for the Autonomous VM cluster.

totalContainerDatabases
Required: Yes
Type: int

The total number of Autonomous CDBs that you can create in the Autonomous VM cluster.

Result Syntax

[
    'cloudAutonomousVmClusterId' => '<string>',
    'displayName' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
    'statusReason' => '<string>',
]

Result Details

Members
cloudAutonomousVmClusterId
Required: Yes
Type: string

The unique identifier of the created Autonomous VM cluster.

displayName
Type: string

The display name of the created Autonomous VM cluster.

status
Type: string

The current status of the Autonomous VM cluster creation process.

statusReason
Type: string

Additional information about the current status of the Autonomous VM cluster creation process, if applicable.

Errors

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

You have exceeded the service quota.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

CreateCloudExadataInfrastructure

$result = $client->createCloudExadataInfrastructure([/* ... */]);
$promise = $client->createCloudExadataInfrastructureAsync([/* ... */]);

Creates an Exadata infrastructure.

Parameter Syntax

$result = $client->createCloudExadataInfrastructure([
    'availabilityZone' => '<string>',
    'availabilityZoneId' => '<string>',
    'clientToken' => '<string>',
    'computeCount' => <integer>, // REQUIRED
    'customerContactsToSendToOCI' => [
        [
            'email' => '<string>',
        ],
        // ...
    ],
    'databaseServerType' => '<string>',
    'displayName' => '<string>', // REQUIRED
    'maintenanceWindow' => [
        'customActionTimeoutInMins' => <integer>,
        'daysOfWeek' => [
            [
                'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
            ],
            // ...
        ],
        'hoursOfDay' => [<integer>, ...],
        'isCustomActionTimeoutEnabled' => true || false,
        'leadTimeInWeeks' => <integer>,
        'months' => [
            [
                'name' => 'JANUARY|FEBRUARY|MARCH|APRIL|MAY|JUNE|JULY|AUGUST|SEPTEMBER|OCTOBER|NOVEMBER|DECEMBER',
            ],
            // ...
        ],
        'patchingMode' => 'ROLLING|NONROLLING',
        'preference' => 'NO_PREFERENCE|CUSTOM_PREFERENCE',
        'skipRu' => true || false,
        'weeksOfMonth' => [<integer>, ...],
    ],
    'shape' => '<string>', // REQUIRED
    'storageCount' => <integer>, // REQUIRED
    'storageServerType' => '<string>',
    'tags' => ['<string>', ...],
]);

Parameter Details

Members
availabilityZone
Type: string

The name of the Availability Zone (AZ) where the Exadata infrastructure is located.

This operation requires that you specify a value for either availabilityZone or availabilityZoneId.

Example: us-east-1a

availabilityZoneId
Type: string

The AZ ID of the AZ where the Exadata infrastructure is located.

This operation requires that you specify a value for either availabilityZone or availabilityZoneId.

Example: use1-az1

clientToken
Type: string

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don't specify a client token, the Amazon Web Services SDK automatically generates a client token and uses it for the request to ensure idempotency. The client token is valid for up to 24 hours after it's first used.

computeCount
Required: Yes
Type: int

The number of database servers for the Exadata infrastructure. Valid values for this parameter depend on the shape. To get information about the minimum and maximum values, use the ListDbSystemShapes operation.

customerContactsToSendToOCI
Type: Array of CustomerContact structures

The email addresses of contacts to receive notification from Oracle about maintenance updates for the Exadata infrastructure.

databaseServerType
Type: string

The database server model type of the Exadata infrastructure. For the list of valid model names, use the ListDbSystemShapes operation.

displayName
Required: Yes
Type: string

A user-friendly name for the Exadata infrastructure.

maintenanceWindow
Type: MaintenanceWindow structure

The maintenance window configuration for the Exadata Cloud infrastructure.

This allows you to define when maintenance operations such as patching and updates can be performed on the infrastructure.

shape
Required: Yes
Type: string

The model name of the Exadata infrastructure. For the list of valid model names, use the ListDbSystemShapes operation.

storageCount
Required: Yes
Type: int

The number of storage servers to activate for this Exadata infrastructure. Valid values for this parameter depend on the shape. To get information about the minimum and maximum values, use the ListDbSystemShapes operation.

storageServerType
Type: string

The storage server model type of the Exadata infrastructure. For the list of valid model names, use the ListDbSystemShapes operation.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The list of resource tags to apply to the Exadata infrastructure.

Result Syntax

[
    'cloudExadataInfrastructureId' => '<string>',
    'displayName' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
    'statusReason' => '<string>',
]

Result Details

Members
cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier of the Exadata infrastructure.

displayName
Type: string

The user-friendly name for the Exadata infrastructure.

status
Type: string

The current status of the Exadata infrastructure.

statusReason
Type: string

Additional information about the status of the Exadata infrastructure.

Errors

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

You have exceeded the service quota.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

CreateCloudVmCluster

$result = $client->createCloudVmCluster([/* ... */]);
$promise = $client->createCloudVmClusterAsync([/* ... */]);

Creates a VM cluster on the specified Exadata infrastructure.

Parameter Syntax

$result = $client->createCloudVmCluster([
    'clientToken' => '<string>',
    'cloudExadataInfrastructureId' => '<string>', // REQUIRED
    'clusterName' => '<string>',
    'cpuCoreCount' => <integer>, // REQUIRED
    'dataCollectionOptions' => [
        'isDiagnosticsEventsEnabled' => true || false,
        'isHealthMonitoringEnabled' => true || false,
        'isIncidentLogsEnabled' => true || false,
    ],
    'dataStorageSizeInTBs' => <float>,
    'dbNodeStorageSizeInGBs' => <integer>,
    'dbServers' => ['<string>', ...],
    'displayName' => '<string>', // REQUIRED
    'giVersion' => '<string>', // REQUIRED
    'hostname' => '<string>', // REQUIRED
    'isLocalBackupEnabled' => true || false,
    'isSparseDiskgroupEnabled' => true || false,
    'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
    'memorySizeInGBs' => <integer>,
    'odbNetworkId' => '<string>', // REQUIRED
    'scanListenerPortTcp' => <integer>,
    'sshPublicKeys' => ['<string>', ...], // REQUIRED
    'systemVersion' => '<string>',
    'tags' => ['<string>', ...],
    'timeZone' => '<string>',
]);

Parameter Details

Members
clientToken
Type: string

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don't specify a client token, the Amazon Web Services SDK automatically generates a client token and uses it for the request to ensure idempotency. The client token is valid for up to 24 hours after it's first used.

cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier of the Exadata infrastructure for this VM cluster.

clusterName
Type: string

A name for the Grid Infrastructure cluster. The name isn't case sensitive.

cpuCoreCount
Required: Yes
Type: int

The number of CPU cores to enable on the VM cluster.

dataCollectionOptions
Type: DataCollectionOptions structure

The set of preferences for the various diagnostic collection options for the VM cluster.

dataStorageSizeInTBs
Type: double

The size of the data disk group, in terabytes (TBs), to allocate for the VM cluster.

dbNodeStorageSizeInGBs
Type: int

The amount of local node storage, in gigabytes (GBs), to allocate for the VM cluster.

dbServers
Type: Array of strings

The list of database servers for the VM cluster.

displayName
Required: Yes
Type: string

A user-friendly name for the VM cluster.

giVersion
Required: Yes
Type: string

A valid software version of Oracle Grid Infrastructure (GI). To get the list of valid values, use the ListGiVersions operation and specify the shape of the Exadata infrastructure.

Example: 19.0.0.0

hostname
Required: Yes
Type: string

The host name for the VM cluster.

Constraints:

  • Can't be "localhost" or "hostname".

  • Can't contain "-version".

  • The maximum length of the combined hostname and domain is 63 characters.

  • The hostname must be unique within the subnet.

isLocalBackupEnabled
Type: boolean

Specifies whether to enable database backups to local Exadata storage for the VM cluster.

isSparseDiskgroupEnabled
Type: boolean

Specifies whether to create a sparse disk group for the VM cluster.

licenseModel
Type: string

The Oracle license model to apply to the VM cluster.

Default: LICENSE_INCLUDED

memorySizeInGBs
Type: int

The amount of memory, in gigabytes (GBs), to allocate for the VM cluster.

odbNetworkId
Required: Yes
Type: string

The unique identifier of the ODB network for the VM cluster.

scanListenerPortTcp
Type: int

The port number for TCP connections to the single client access name (SCAN) listener.

Valid values: 1024–8999 with the following exceptions: 2484, 6100, 6200, 7060, 7070, 7085, and 7879

Default: 1521

sshPublicKeys
Required: Yes
Type: Array of strings

The public key portion of one or more key pairs used for SSH access to the VM cluster.

systemVersion
Type: string

The version of the operating system of the image for the VM cluster.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The list of resource tags to apply to the VM cluster.

timeZone
Type: string

The time zone for the VM cluster. For a list of valid values for time zone, you can check the options in the console.

Default: UTC

Result Syntax

[
    'cloudVmClusterId' => '<string>',
    'displayName' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
    'statusReason' => '<string>',
]

Result Details

Members
cloudVmClusterId
Required: Yes
Type: string

The unique identifier for the VM cluster.

displayName
Type: string

The user-friendly name for the VM cluster.

status
Type: string

The current status of the VM cluster.

statusReason
Type: string

Additional information about the status of the VM cluster.

Errors

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

You have exceeded the service quota.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

CreateOdbNetwork

$result = $client->createOdbNetwork([/* ... */]);
$promise = $client->createOdbNetworkAsync([/* ... */]);

Creates an ODB network.

Parameter Syntax

$result = $client->createOdbNetwork([
    'availabilityZone' => '<string>',
    'availabilityZoneId' => '<string>',
    'backupSubnetCidr' => '<string>',
    'clientSubnetCidr' => '<string>', // REQUIRED
    'clientToken' => '<string>',
    'crossRegionS3RestoreSourcesToEnable' => ['<string>', ...],
    'customDomainName' => '<string>',
    'defaultDnsPrefix' => '<string>',
    'displayName' => '<string>', // REQUIRED
    'kmsAccess' => 'ENABLED|DISABLED',
    'kmsPolicyDocument' => '<string>',
    's3Access' => 'ENABLED|DISABLED',
    's3PolicyDocument' => '<string>',
    'stsAccess' => 'ENABLED|DISABLED',
    'stsPolicyDocument' => '<string>',
    'tags' => ['<string>', ...],
    'zeroEtlAccess' => 'ENABLED|DISABLED',
]);

Parameter Details

Members
availabilityZone
Type: string

The Amazon Web Services Availability Zone (AZ) where the ODB network is located.

This operation requires that you specify a value for either availabilityZone or availabilityZoneId.

availabilityZoneId
Type: string

The AZ ID of the AZ where the ODB network is located.

This operation requires that you specify a value for either availabilityZone or availabilityZoneId.

backupSubnetCidr
Type: string

The CIDR range of the backup subnet for the ODB network.

Constraints:

  • Must not overlap with the CIDR range of the client subnet.

  • Must not overlap with the CIDR ranges of the VPCs that are connected to the ODB network.

  • Must not use the following CIDR ranges that are reserved by OCI:

    • 100.106.0.0/16 and 100.107.0.0/16

    • 169.254.0.0/16

    • 224.0.0.0 - 239.255.255.255

    • 240.0.0.0 - 255.255.255.255

clientSubnetCidr
Required: Yes
Type: string

The CIDR range of the client subnet for the ODB network.

Constraints:

  • Must not overlap with the CIDR range of the backup subnet.

  • Must not overlap with the CIDR ranges of the VPCs that are connected to the ODB network.

  • Must not use the following CIDR ranges that are reserved by OCI:

    • 100.106.0.0/16 and 100.107.0.0/16

    • 169.254.0.0/16

    • 224.0.0.0 - 239.255.255.255

    • 240.0.0.0 - 255.255.255.255

clientToken
Type: string

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don't specify a client token, the Amazon Web Services SDK automatically generates a client token and uses it for the request to ensure idempotency. The client token is valid for up to 24 hours after it's first used.

crossRegionS3RestoreSourcesToEnable
Type: Array of strings

The cross-Region Amazon S3 restore sources to enable for the ODB network.

customDomainName
Type: string

The domain name to use for the resources in the ODB network.

defaultDnsPrefix
Type: string

The DNS prefix to the default DNS domain name. The default DNS domain name is oraclevcn.com.

displayName
Required: Yes
Type: string

A user-friendly name for the ODB network.

kmsAccess
Type: string

The Amazon Web Services Key Management Service (KMS) access configuration for the ODB network.

kmsPolicyDocument
Type: string

The Amazon Web Services Key Management Service (KMS) policy document that defines permissions for key usage within the ODB network.

s3Access
Type: string

Specifies the configuration for Amazon S3 access from the ODB network.

s3PolicyDocument
Type: string

Specifies the endpoint policy for Amazon S3 access from the ODB network.

stsAccess
Type: string

The Amazon Web Services Security Token Service (STS) access configuration for the ODB network.

stsPolicyDocument
Type: string

The Amazon Web Services Security Token Service (STS) policy document that defines permissions for token service usage within the ODB network.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The list of resource tags to apply to the ODB network.

zeroEtlAccess
Type: string

Specifies the configuration for Zero-ETL access from the ODB network.

Result Syntax

[
    'displayName' => '<string>',
    'odbNetworkId' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
    'statusReason' => '<string>',
]

Result Details

Members
displayName
Type: string

The user-friendly name of the ODB network.

odbNetworkId
Required: Yes
Type: string

The unique identifier of the ODB network.

status
Type: string

The current status of the ODB network.

statusReason
Type: string

Additional information about the status of the ODB network.

Errors

ThrottlingException:

The request was denied due to request throttling.

ServiceQuotaExceededException:

You have exceeded the service quota.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

CreateOdbPeeringConnection

$result = $client->createOdbPeeringConnection([/* ... */]);
$promise = $client->createOdbPeeringConnectionAsync([/* ... */]);

Creates a peering connection between an ODB network and a VPC.

A peering connection enables private connectivity between the networks for application-tier communication.

Parameter Syntax

$result = $client->createOdbPeeringConnection([
    'clientToken' => '<string>',
    'displayName' => '<string>',
    'odbNetworkId' => '<string>', // REQUIRED
    'peerNetworkCidrsToBeAdded' => ['<string>', ...],
    'peerNetworkId' => '<string>', // REQUIRED
    'peerNetworkRouteTableIds' => ['<string>', ...],
    'tags' => ['<string>', ...],
]);

Parameter Details

Members
clientToken
Type: string

The client token for the ODB peering connection request.

Constraints:

  • Must be unique for each request.

displayName
Type: string

The display name for the ODB peering connection.

odbNetworkId
Required: Yes
Type: string

The unique identifier of the ODB network that initiates the peering connection.

peerNetworkCidrsToBeAdded
Type: Array of strings

A list of CIDR blocks to add to the peering connection. These CIDR blocks define the IP address ranges that can communicate through the peering connection.

peerNetworkId
Required: Yes
Type: string

The unique identifier of the peer network. This can be either a VPC ID or another ODB network ID.

peerNetworkRouteTableIds
Type: Array of strings

The unique identifier of the VPC route table for which a route to the ODB network is automatically created during peering connection establishment.

tags
Type: Associative array of custom strings keys (TagKey) to strings

The tags to assign to the ODB peering connection.

Result Syntax

[
    'displayName' => '<string>',
    'odbPeeringConnectionId' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
    'statusReason' => '<string>',
]

Result Details

Members
displayName
Type: string

The display name of the ODB peering connection.

odbPeeringConnectionId
Required: Yes
Type: string

The unique identifier of the ODB peering connection.

status
Type: string

The status of the ODB peering connection.

statusReason
Type: string

The reason for the current status of the ODB peering connection.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

DeleteAutonomousDatabase

$result = $client->deleteAutonomousDatabase([/* ... */]);
$promise = $client->deleteAutonomousDatabaseAsync([/* ... */]);

Deletes the specified Autonomous Database.

Parameter Syntax

$result = $client->deleteAutonomousDatabase([
    'autonomousDatabaseId' => '<string>', // REQUIRED
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

DeleteAutonomousDatabaseBackup

$result = $client->deleteAutonomousDatabaseBackup([/* ... */]);
$promise = $client->deleteAutonomousDatabaseBackupAsync([/* ... */]);

Deletes the specified Autonomous Database backup.

Parameter Syntax

$result = $client->deleteAutonomousDatabaseBackup([
    'autonomousDatabaseBackupId' => '<string>', // REQUIRED
]);

Parameter Details

Members
autonomousDatabaseBackupId
Required: Yes
Type: string

The unique identifier of the Autonomous Database backup to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

DeleteCloudAutonomousVmCluster

$result = $client->deleteCloudAutonomousVmCluster([/* ... */]);
$promise = $client->deleteCloudAutonomousVmClusterAsync([/* ... */]);

Deletes an Autonomous VM cluster.

Parameter Syntax

$result = $client->deleteCloudAutonomousVmCluster([
    'cloudAutonomousVmClusterId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudAutonomousVmClusterId
Required: Yes
Type: string

The unique identifier of the Autonomous VM cluster to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

DeleteCloudExadataInfrastructure

$result = $client->deleteCloudExadataInfrastructure([/* ... */]);
$promise = $client->deleteCloudExadataInfrastructureAsync([/* ... */]);

Deletes the specified Exadata infrastructure. Before you use this operation, make sure to delete all of the VM clusters that are hosted on this Exadata infrastructure.

Parameter Syntax

$result = $client->deleteCloudExadataInfrastructure([
    'cloudExadataInfrastructureId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier of the Exadata infrastructure to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

DeleteCloudVmCluster

$result = $client->deleteCloudVmCluster([/* ... */]);
$promise = $client->deleteCloudVmClusterAsync([/* ... */]);

Deletes the specified VM cluster.

Parameter Syntax

$result = $client->deleteCloudVmCluster([
    'cloudVmClusterId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudVmClusterId
Required: Yes
Type: string

The unique identifier of the VM cluster to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

DeleteOdbNetwork

$result = $client->deleteOdbNetwork([/* ... */]);
$promise = $client->deleteOdbNetworkAsync([/* ... */]);

Deletes the specified ODB network.

Parameter Syntax

$result = $client->deleteOdbNetwork([
    'deleteAssociatedResources' => true || false, // REQUIRED
    'odbNetworkId' => '<string>', // REQUIRED
]);

Parameter Details

Members
deleteAssociatedResources
Required: Yes
Type: boolean

Specifies whether to delete associated OCI networking resources along with the ODB network.

odbNetworkId
Required: Yes
Type: string

The unique identifier of the ODB network to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

DeleteOdbPeeringConnection

$result = $client->deleteOdbPeeringConnection([/* ... */]);
$promise = $client->deleteOdbPeeringConnectionAsync([/* ... */]);

Deletes an ODB peering connection.

When you delete an ODB peering connection, the underlying VPC peering connection is also deleted.

Parameter Syntax

$result = $client->deleteOdbPeeringConnection([
    'odbPeeringConnectionId' => '<string>', // REQUIRED
]);

Parameter Details

Members
odbPeeringConnectionId
Required: Yes
Type: string

The unique identifier of the ODB peering connection to delete.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

DisassociateIamRoleFromResource

$result = $client->disassociateIamRoleFromResource([/* ... */]);
$promise = $client->disassociateIamRoleFromResourceAsync([/* ... */]);

Disassociates an Amazon Web Services Identity and Access Management (IAM) service role from a specified resource to disable Amazon Web Services service integration.

Parameter Syntax

$result = $client->disassociateIamRoleFromResource([
    'awsIntegration' => 'KmsTde', // REQUIRED
    'iamRoleArn' => '<string>', // REQUIRED
    'resourceArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
awsIntegration
Required: Yes
Type: string

The Amazon Web Services integration configuration settings for the Amazon Web Services Identity and Access Management (IAM) service role disassociation.

iamRoleArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the Amazon Web Services Identity and Access Management (IAM) service role to disassociate from the resource.

resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the target resource to disassociate from the Amazon Web Services Identity and Access Management (IAM) service role.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

FailoverAutonomousDatabase

$result = $client->failoverAutonomousDatabase([/* ... */]);
$promise = $client->failoverAutonomousDatabaseAsync([/* ... */]);

Initiates a failover of the specified Autonomous Database to a standby peer database.

Parameter Syntax

$result = $client->failoverAutonomousDatabase([
    'autonomousDatabaseId' => '<string>', // REQUIRED
    'peerDbArn' => '<string>',
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to fail over.

peerDbArn
Type: string

The Amazon Resource Name (ARN) of the peer Autonomous Database to fail over to.

Result 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>',
]

Result Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database that was failed over.

displayName
Type: string

The user-friendly name of the Autonomous Database.

status
Type: string

The current status of the Autonomous Database after the failover operation.

statusReason
Type: string

Additional information about the status of the Autonomous Database after the failover operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetAutonomousDatabase

$result = $client->getAutonomousDatabase([/* ... */]);
$promise = $client->getAutonomousDatabaseAsync([/* ... */]);

Gets information about a specific Autonomous Database.

Parameter Syntax

$result = $client->getAutonomousDatabase([
    'autonomousDatabaseId' => '<string>', // REQUIRED
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to retrieve information about.

Result Syntax

[
    'autonomousDatabase' => [
        'actualUsedDataStorageSizeInTBs' => <float>,
        'allocatedStorageSizeInTBs' => <float>,
        'allowlistedIps' => ['<string>', ...],
        'apexDetails' => [
            'apexVersion' => '<string>',
            'ordsVersion' => '<string>',
        ],
        'autoRefreshFrequencyInSeconds' => <integer>,
        'autoRefreshPointLagInSeconds' => <integer>,
        'autonomousDatabaseArn' => '<string>',
        'autonomousDatabaseId' => '<string>',
        'autonomousMaintenanceScheduleType' => 'EARLY|REGULAR',
        'availabilityZone' => '<string>',
        'availabilityZoneId' => '<string>',
        'availableUpgradeVersions' => ['<string>', ...],
        'backupRetentionPeriodInDays' => <integer>,
        'byolComputeCountLimit' => <integer>,
        'characterSet' => '<string>',
        'cloneTableSpaceList' => [<integer>, ...],
        'computeCount' => <float>,
        'computeModel' => 'ECPU|OCPU',
        'connectionStringDetails' => [
            'allConnectionStrings' => ['<string>', ...],
            'dedicated' => '<string>',
            'high' => '<string>',
            'low' => '<string>',
            'medium' => '<string>',
            'profiles' => [
                [
                    'consumerGroup' => '<string>',
                    'displayName' => '<string>',
                    'hostFormat' => '<string>',
                    'isRegional' => true || false,
                    'protocol' => '<string>',
                    'sessionMode' => '<string>',
                    'syntaxFormat' => '<string>',
                    'tlsAuthentication' => '<string>',
                    'value' => '<string>',
                ],
                // ...
            ],
        ],
        'connectionUrls' => [
            'apexUrl' => '<string>',
            'databaseTransformsUrl' => '<string>',
            'graphStudioUrl' => '<string>',
            'machineLearningNotebookUrl' => '<string>',
            'machineLearningUserManagementUrl' => '<string>',
            'mongoDbUrl' => '<string>',
            'ordsUrl' => '<string>',
            'spatialStudioUrl' => '<string>',
            'sqlDevWebUrl' => '<string>',
        ],
        'cpuCoreCount' => <integer>,
        'createdAt' => <DateTime>,
        'customerContacts' => [
            [
                'email' => '<string>',
            ],
            // ...
        ],
        'dataSafeStatus' => 'REGISTERING|REGISTERED|DEREGISTERING|NOT_REGISTERED|FAILED',
        'dataStorageSizeInGBs' => <integer>,
        'dataStorageSizeInTBs' => <float>,
        'databaseEdition' => 'STANDARD_EDITION|ENTERPRISE_EDITION',
        'databaseManagementStatus' => 'ENABLING|ENABLED|DISABLING|NOT_ENABLED|FAILED_ENABLING|FAILED_DISABLING',
        'databaseType' => 'REGULAR|CLONE',
        'dbName' => '<string>',
        'dbToolsDetails' => [
            [
                'computeCount' => <float>,
                'isEnabled' => true || false,
                'maxIdleTimeInMinutes' => <integer>,
                'name' => '<string>',
            ],
            // ...
        ],
        'dbVersion' => '<string>',
        'dbWorkload' => 'OLTP|AJD|APEX|LH',
        'displayName' => '<string>',
        'encryptionSummary' => [
            'encryptionKeyConfiguration' => [
                'awsEncryptionKey' => [
                    'externalIdType' => 'database_ocid|compartment_ocid|tenant_ocid',
                    'iamRoleArn' => '<string>',
                    'kmsKeyId' => '<string>',
                ],
                'ociEncryptionKey' => [
                    'kmsKeyId' => '<string>',
                    'vaultId' => '<string>',
                ],
                'okvEncryptionKey' => [
                    'certificateDirectoryName' => '<string>',
                    'certificateId' => '<string>',
                    'directoryName' => '<string>',
                    'okvKmsKey' => '<string>',
                    'okvUri' => '<string>',
                ],
            ],
            'encryptionKeyProvider' => 'ORACLE_MANAGED|AWS_KMS|OKV|OCI',
        ],
        'failedDataRecoveryInSeconds' => <integer>,
        'inMemoryAreaInGBs' => <integer>,
        'isAutoScalingEnabled' => true || false,
        'isAutoScalingForStorageEnabled' => true || false,
        'isBackupRetentionLocked' => true || false,
        'isLocalDataGuardEnabled' => true || false,
        'isMtlsConnectionRequired' => true || false,
        'isReconnectCloneEnabled' => true || false,
        'isRefreshableClone' => true || false,
        'isRemoteDataGuardEnabled' => true || false,
        'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
        'localAdgAutoFailoverMaxDataLossLimit' => <integer>,
        'localDisasterRecoveryType' => 'ADG|BACKUP_BASED',
        'localStandbyDb' => [
            'availabilityDomain' => '<string>',
            'lagTimeInSeconds' => <integer>,
            'maintenanceTargetComponent' => '<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>',
            'timeDataGuardRoleChanged' => <DateTime>,
            'timeDisasterRecoveryRoleChanged' => <DateTime>,
            'timeMaintenanceBegin' => <DateTime>,
            'timeMaintenanceEnd' => <DateTime>,
        ],
        'longTermBackupSchedule' => [
            'isDisabled' => true || false,
            'repeatCadence' => 'ONE_TIME|WEEKLY|MONTHLY|YEARLY',
            'retentionPeriodInDays' => <integer>,
            'timeOfBackup' => <DateTime>,
        ],
        'maintenanceTargetComponent' => '<string>',
        'memoryPerOracleComputeUnitInGBs' => <integer>,
        'ncharacterSet' => '<string>',
        'netServicesArchitecture' => 'DEDICATED|SHARED',
        'nextLongTermBackupTimeStamp' => <DateTime>,
        'ociResourceAnchorName' => '<string>',
        'ociUrl' => '<string>',
        'ocid' => '<string>',
        'odbNetworkArn' => '<string>',
        'odbNetworkId' => '<string>',
        'openMode' => 'READ_ONLY|READ_WRITE',
        'operationsInsightsStatus' => 'ENABLING|ENABLED|DISABLING|NOT_ENABLED|FAILED_ENABLING|FAILED_DISABLING',
        'peerDbIds' => ['<string>', ...],
        'percentProgress' => <float>,
        'permissionLevel' => 'RESTRICTED|UNRESTRICTED',
        'privateEndpoint' => '<string>',
        'privateEndpointIp' => '<string>',
        'privateEndpointLabel' => '<string>',
        'provisionableCpus' => [<integer>, ...],
        'refreshableMode' => 'AUTOMATIC|MANUAL',
        'refreshableStatus' => 'REFRESHING|NOT_REFRESHING',
        'remoteDisasterRecoveryConfiguration' => [
            'disasterRecoveryType' => 'ADG|BACKUP_BASED',
            'isReplicateAutomaticBackups' => true || false,
            'isSnapshotStandby' => true || false,
            'timeSnapshotStandbyEnabledTill' => <DateTime>,
        ],
        'resourcePoolLeaderId' => '<string>',
        'resourcePoolSummary' => [
            'availableComputeCapacity' => <integer>,
            'availableStorageCapacityInTBs' => <float>,
            'isDisabled' => true || false,
            'poolSize' => <integer>,
            'poolStorageSizeInTBs' => <integer>,
            'totalComputeCapacity' => <integer>,
        ],
        'role' => 'PRIMARY|STANDBY|DISABLED_STANDBY|BACKUP_COPY|SNAPSHOT_STANDBY',
        'scheduledOperations' => [
            [
                'dayOfWeek' => [
                    'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
                ],
                'scheduledStartTime' => '<string>',
                'scheduledStopTime' => '<string>',
            ],
            // ...
        ],
        'serviceConsoleUrl' => '<string>',
        'sourceId' => '<string>',
        'sqlWebDeveloperUrl' => '<string>',
        'standbyAllowlistedIps' => ['<string>', ...],
        'standbyAllowlistedIpsSource' => 'PRIMARY|SEPARATE|NOT_APPLICABLE',
        'standbyDb' => [
            'availabilityDomain' => '<string>',
            'lagTimeInSeconds' => <integer>,
            'maintenanceTargetComponent' => '<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>',
            'timeDataGuardRoleChanged' => <DateTime>,
            'timeDisasterRecoveryRoleChanged' => <DateTime>,
            'timeMaintenanceBegin' => <DateTime>,
            'timeMaintenanceEnd' => <DateTime>,
        ],
        '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>',
        'timeDataGuardRoleChanged' => <DateTime>,
        'timeDeletionOfFreeAutonomousDatabase' => <DateTime>,
        'timeDisasterRecoveryRoleChanged' => <DateTime>,
        'timeLocalDataGuardEnabled' => <DateTime>,
        'timeMaintenanceBegin' => <DateTime>,
        'timeMaintenanceEnd' => <DateTime>,
        'timeOfAutoRefreshStart' => <DateTime>,
        'timeOfLastBackup' => <DateTime>,
        'timeOfLastFailover' => <DateTime>,
        'timeOfLastRefresh' => <DateTime>,
        'timeOfLastRefreshPoint' => <DateTime>,
        'timeOfLastSwitchover' => <DateTime>,
        'timeOfNextRefresh' => <DateTime>,
        'timeReclamationOfFreeAutonomousDatabase' => <DateTime>,
        'timeUndeleted' => <DateTime>,
        'timeUntilReconnectCloneEnabled' => <DateTime>,
        'totalBackupStorageSizeInGBs' => <float>,
        'usedDataStorageSizeInGBs' => <integer>,
        'usedDataStorageSizeInTBs' => <float>,
    ],
]

Result Details

Members
autonomousDatabase
Required: Yes
Type: AutonomousDatabase structure

The details of the requested Autonomous Database.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetAutonomousDatabaseBackup

$result = $client->getAutonomousDatabaseBackup([/* ... */]);
$promise = $client->getAutonomousDatabaseBackupAsync([/* ... */]);

Gets information about a specific Autonomous Database backup.

Parameter Syntax

$result = $client->getAutonomousDatabaseBackup([
    'autonomousDatabaseBackupId' => '<string>', // REQUIRED
]);

Parameter Details

Members
autonomousDatabaseBackupId
Required: Yes
Type: string

The unique identifier of the Autonomous Database backup to retrieve information about.

Result Syntax

[
    'autonomousDatabaseBackup' => [
        'autonomousDatabaseBackupArn' => '<string>',
        'autonomousDatabaseBackupId' => '<string>',
        'autonomousDatabaseId' => '<string>',
        'dbVersion' => '<string>',
        'displayName' => '<string>',
        'isAutomatic' => true || false,
        'ocid' => '<string>',
        'retentionPeriodInDays' => <integer>,
        'sizeInTBs' => <float>,
        'status' => 'ACTIVE|CREATING|UPDATING|DELETING|FAILED',
        'statusReason' => '<string>',
        'timeAvailableTill' => <DateTime>,
        'timeEnded' => <DateTime>,
        'timeStarted' => <DateTime>,
        'type' => 'INCREMENTAL|FULL|LONGTERM|VIRTUAL_FULL|CUMULATIVE_INCREMENTAL|ROLL_FORWARD_IMAGE_COPY',
    ],
]

Result Details

Members
autonomousDatabaseBackup
Type: AutonomousDatabaseBackup structure

The details of the requested Autonomous Database backup.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetAutonomousDatabaseWalletDetails

$result = $client->getAutonomousDatabaseWalletDetails([/* ... */]);
$promise = $client->getAutonomousDatabaseWalletDetailsAsync([/* ... */]);

Gets the wallet details for the specified Autonomous Database.

Parameter Syntax

$result = $client->getAutonomousDatabaseWalletDetails([
    'autonomousDatabaseId' => '<string>', // REQUIRED
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to retrieve wallet details for.

Result Syntax

[
    'autonomousDatabaseWalletDetails' => [
        'status' => 'ACTIVE|UPDATING',
        'timeRotated' => <DateTime>,
    ],
]

Result Details

Members
autonomousDatabaseWalletDetails
Required: Yes
Type: AutonomousDatabaseWalletDetails structure

The wallet details for the Autonomous Database.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetCloudAutonomousVmCluster

$result = $client->getCloudAutonomousVmCluster([/* ... */]);
$promise = $client->getCloudAutonomousVmClusterAsync([/* ... */]);

Gets information about a specific Autonomous VM cluster.

Parameter Syntax

$result = $client->getCloudAutonomousVmCluster([
    'cloudAutonomousVmClusterId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudAutonomousVmClusterId
Required: Yes
Type: string

The unique identifier of the Autonomous VM cluster to retrieve information about.

Result Syntax

[
    'cloudAutonomousVmCluster' => [
        'autonomousDataStoragePercentage' => <float>,
        'autonomousDataStorageSizeInTBs' => <float>,
        'availableAutonomousDataStorageSizeInTBs' => <float>,
        'availableContainerDatabases' => <integer>,
        'availableCpus' => <float>,
        'cloudAutonomousVmClusterArn' => '<string>',
        'cloudAutonomousVmClusterId' => '<string>',
        'cloudExadataInfrastructureArn' => '<string>',
        'cloudExadataInfrastructureId' => '<string>',
        'computeModel' => 'ECPU|OCPU',
        'cpuCoreCount' => <integer>,
        'cpuCoreCountPerNode' => <integer>,
        'cpuPercentage' => <float>,
        'createdAt' => <DateTime>,
        'dataStorageSizeInGBs' => <float>,
        'dataStorageSizeInTBs' => <float>,
        'dbNodeStorageSizeInGBs' => <integer>,
        'dbServers' => ['<string>', ...],
        'description' => '<string>',
        'displayName' => '<string>',
        'domain' => '<string>',
        'exadataStorageInTBsLowestScaledValue' => <float>,
        'hostname' => '<string>',
        'iamRoles' => [
            [
                'awsIntegration' => 'KmsTde',
                'iamRoleArn' => '<string>',
                'status' => 'ASSOCIATING|DISASSOCIATING|FAILED|CONNECTED|DISCONNECTED|PARTIALLY_CONNECTED|UNKNOWN',
                'statusReason' => '<string>',
            ],
            // ...
        ],
        'isMtlsEnabledVmCluster' => true || false,
        'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
        'maintenanceWindow' => [
            'customActionTimeoutInMins' => <integer>,
            'daysOfWeek' => [
                [
                    'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
                ],
                // ...
            ],
            'hoursOfDay' => [<integer>, ...],
            'isCustomActionTimeoutEnabled' => true || false,
            'leadTimeInWeeks' => <integer>,
            'months' => [
                [
                    'name' => 'JANUARY|FEBRUARY|MARCH|APRIL|MAY|JUNE|JULY|AUGUST|SEPTEMBER|OCTOBER|NOVEMBER|DECEMBER',
                ],
                // ...
            ],
            'patchingMode' => 'ROLLING|NONROLLING',
            'preference' => 'NO_PREFERENCE|CUSTOM_PREFERENCE',
            'skipRu' => true || false,
            'weeksOfMonth' => [<integer>, ...],
        ],
        'maxAcdsLowestScaledValue' => <integer>,
        'memoryPerOracleComputeUnitInGBs' => <integer>,
        'memorySizeInGBs' => <integer>,
        'nodeCount' => <integer>,
        'nonProvisionableAutonomousContainerDatabases' => <integer>,
        'ociResourceAnchorName' => '<string>',
        'ociUrl' => '<string>',
        'ocid' => '<string>',
        'odbNetworkArn' => '<string>',
        'odbNetworkId' => '<string>',
        'percentProgress' => <float>,
        'provisionableAutonomousContainerDatabases' => <integer>,
        'provisionedAutonomousContainerDatabases' => <integer>,
        'provisionedCpus' => <float>,
        'reclaimableCpus' => <float>,
        'reservedCpus' => <float>,
        'scanListenerPortNonTls' => <integer>,
        'scanListenerPortTls' => <integer>,
        'shape' => '<string>',
        'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
        'statusReason' => '<string>',
        'timeDatabaseSslCertificateExpires' => <DateTime>,
        'timeOrdsCertificateExpires' => <DateTime>,
        'timeZone' => '<string>',
        'totalContainerDatabases' => <integer>,
    ],
]

Result Details

Members
cloudAutonomousVmCluster
Type: CloudAutonomousVmCluster structure

The details of the requested Autonomous VM cluster.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetCloudExadataInfrastructure

$result = $client->getCloudExadataInfrastructure([/* ... */]);
$promise = $client->getCloudExadataInfrastructureAsync([/* ... */]);

Returns information about the specified Exadata infrastructure.

Parameter Syntax

$result = $client->getCloudExadataInfrastructure([
    'cloudExadataInfrastructureId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier of the Exadata infrastructure.

Result Syntax

[
    'cloudExadataInfrastructure' => [
        'activatedStorageCount' => <integer>,
        'additionalStorageCount' => <integer>,
        'availabilityZone' => '<string>',
        'availabilityZoneId' => '<string>',
        'availableStorageSizeInGBs' => <integer>,
        'cloudExadataInfrastructureArn' => '<string>',
        'cloudExadataInfrastructureId' => '<string>',
        'computeCount' => <integer>,
        'computeModel' => 'ECPU|OCPU',
        'cpuCount' => <integer>,
        'createdAt' => <DateTime>,
        'customerContactsToSendToOCI' => [
            [
                'email' => '<string>',
            ],
            // ...
        ],
        'dataStorageSizeInTBs' => <float>,
        'databaseServerType' => '<string>',
        'dbNodeStorageSizeInGBs' => <integer>,
        'dbServerVersion' => '<string>',
        'displayName' => '<string>',
        'lastMaintenanceRunId' => '<string>',
        'maintenanceWindow' => [
            'customActionTimeoutInMins' => <integer>,
            'daysOfWeek' => [
                [
                    'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
                ],
                // ...
            ],
            'hoursOfDay' => [<integer>, ...],
            'isCustomActionTimeoutEnabled' => true || false,
            'leadTimeInWeeks' => <integer>,
            'months' => [
                [
                    'name' => 'JANUARY|FEBRUARY|MARCH|APRIL|MAY|JUNE|JULY|AUGUST|SEPTEMBER|OCTOBER|NOVEMBER|DECEMBER',
                ],
                // ...
            ],
            'patchingMode' => 'ROLLING|NONROLLING',
            'preference' => 'NO_PREFERENCE|CUSTOM_PREFERENCE',
            'skipRu' => true || false,
            'weeksOfMonth' => [<integer>, ...],
        ],
        'maxCpuCount' => <integer>,
        'maxDataStorageInTBs' => <float>,
        'maxDbNodeStorageSizeInGBs' => <integer>,
        'maxMemoryInGBs' => <integer>,
        'memorySizeInGBs' => <integer>,
        'monthlyDbServerVersion' => '<string>',
        'monthlyStorageServerVersion' => '<string>',
        'nextMaintenanceRunId' => '<string>',
        'ociResourceAnchorName' => '<string>',
        'ociUrl' => '<string>',
        'ocid' => '<string>',
        'percentProgress' => <float>,
        'shape' => '<string>',
        'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
        'statusReason' => '<string>',
        'storageCount' => <integer>,
        'storageServerType' => '<string>',
        'storageServerVersion' => '<string>',
        'totalStorageSizeInGBs' => <integer>,
    ],
]

Result Details

Members
cloudExadataInfrastructure
Type: CloudExadataInfrastructure structure

The Exadata infrastructure.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetCloudExadataInfrastructureUnallocatedResources

$result = $client->getCloudExadataInfrastructureUnallocatedResources([/* ... */]);
$promise = $client->getCloudExadataInfrastructureUnallocatedResourcesAsync([/* ... */]);

Retrieves information about unallocated resources in a specified Cloud Exadata Infrastructure.

Parameter Syntax

$result = $client->getCloudExadataInfrastructureUnallocatedResources([
    'cloudExadataInfrastructureId' => '<string>', // REQUIRED
    'dbServers' => ['<string>', ...],
]);

Parameter Details

Members
cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier of the Cloud Exadata infrastructure for which to retrieve unallocated resources.

dbServers
Type: Array of strings

The database servers to include in the unallocated resources query.

Result Syntax

[
    'cloudExadataInfrastructureUnallocatedResources' => [
        'cloudAutonomousVmClusters' => [
            [
                'cloudAutonomousVmClusterId' => '<string>',
                'unallocatedAdbStorageInTBs' => <float>,
            ],
            // ...
        ],
        'cloudExadataInfrastructureDisplayName' => '<string>',
        'cloudExadataInfrastructureId' => '<string>',
        'exadataStorageInTBs' => <float>,
        'localStorageInGBs' => <integer>,
        'memoryInGBs' => <integer>,
        'ocpus' => <integer>,
    ],
]

Result Details

Members
cloudExadataInfrastructureUnallocatedResources

Details about the unallocated resources in the specified Cloud Exadata infrastructure.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetCloudVmCluster

$result = $client->getCloudVmCluster([/* ... */]);
$promise = $client->getCloudVmClusterAsync([/* ... */]);

Returns information about the specified VM cluster.

Parameter Syntax

$result = $client->getCloudVmCluster([
    'cloudVmClusterId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudVmClusterId
Required: Yes
Type: string

The unique identifier of the VM cluster.

Result Syntax

[
    'cloudVmCluster' => [
        'cloudExadataInfrastructureArn' => '<string>',
        'cloudExadataInfrastructureId' => '<string>',
        'cloudVmClusterArn' => '<string>',
        'cloudVmClusterId' => '<string>',
        'clusterName' => '<string>',
        'computeModel' => 'ECPU|OCPU',
        'cpuCoreCount' => <integer>,
        'createdAt' => <DateTime>,
        'dataCollectionOptions' => [
            'isDiagnosticsEventsEnabled' => true || false,
            'isHealthMonitoringEnabled' => true || false,
            'isIncidentLogsEnabled' => true || false,
        ],
        'dataStorageSizeInTBs' => <float>,
        'dbNodeStorageSizeInGBs' => <integer>,
        'dbServers' => ['<string>', ...],
        'diskRedundancy' => 'HIGH|NORMAL',
        'displayName' => '<string>',
        'domain' => '<string>',
        'giVersion' => '<string>',
        'hostname' => '<string>',
        'iamRoles' => [
            [
                'awsIntegration' => 'KmsTde',
                'iamRoleArn' => '<string>',
                'status' => 'ASSOCIATING|DISASSOCIATING|FAILED|CONNECTED|DISCONNECTED|PARTIALLY_CONNECTED|UNKNOWN',
                'statusReason' => '<string>',
            ],
            // ...
        ],
        'iormConfigCache' => [
            'dbPlans' => [
                [
                    'dbName' => '<string>',
                    'flashCacheLimit' => '<string>',
                    'share' => <integer>,
                ],
                // ...
            ],
            'lifecycleDetails' => '<string>',
            'lifecycleState' => 'BOOTSTRAPPING|DISABLED|ENABLED|FAILED|UPDATING',
            'objective' => 'AUTO|BALANCED|BASIC|HIGH_THROUGHPUT|LOW_LATENCY',
        ],
        'isLocalBackupEnabled' => true || false,
        'isSparseDiskgroupEnabled' => true || false,
        'lastUpdateHistoryEntryId' => '<string>',
        'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
        'listenerPort' => <integer>,
        'memorySizeInGBs' => <integer>,
        'nodeCount' => <integer>,
        'ociResourceAnchorName' => '<string>',
        'ociUrl' => '<string>',
        'ocid' => '<string>',
        'odbNetworkArn' => '<string>',
        'odbNetworkId' => '<string>',
        'percentProgress' => <float>,
        'scanDnsName' => '<string>',
        'scanDnsRecordId' => '<string>',
        'scanIpIds' => ['<string>', ...],
        'shape' => '<string>',
        'sshPublicKeys' => ['<string>', ...],
        'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
        'statusReason' => '<string>',
        'storageSizeInGBs' => <integer>,
        'systemVersion' => '<string>',
        'timeZone' => '<string>',
        'vipIds' => ['<string>', ...],
    ],
]

Result Details

Members
cloudVmCluster
Type: CloudVmCluster structure

The VM cluster.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetDbNode

$result = $client->getDbNode([/* ... */]);
$promise = $client->getDbNodeAsync([/* ... */]);

Returns information about the specified DB node.

Parameter Syntax

$result = $client->getDbNode([
    'cloudVmClusterId' => '<string>', // REQUIRED
    'dbNodeId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudVmClusterId
Required: Yes
Type: string

The unique identifier of the VM cluster that contains the DB node.

dbNodeId
Required: Yes
Type: string

The unique identifier of the DB node to retrieve information about.

Result Syntax

[
    'dbNode' => [
        'additionalDetails' => '<string>',
        'backupIpId' => '<string>',
        'backupVnic2Id' => '<string>',
        'backupVnicId' => '<string>',
        'cpuCoreCount' => <integer>,
        'createdAt' => <DateTime>,
        'dbNodeArn' => '<string>',
        'dbNodeId' => '<string>',
        'dbNodeStorageSizeInGBs' => <integer>,
        'dbServerId' => '<string>',
        'dbSystemId' => '<string>',
        'faultDomain' => '<string>',
        'floatingIpAddress' => '<string>',
        'hostIpId' => '<string>',
        'hostname' => '<string>',
        'maintenanceType' => 'VMDB_REBOOT_MIGRATION',
        'memorySizeInGBs' => <integer>,
        'ociResourceAnchorName' => '<string>',
        'ocid' => '<string>',
        'privateIpAddress' => '<string>',
        'softwareStorageSizeInGB' => <integer>,
        'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|STOPPING|STOPPED|STARTING',
        'statusReason' => '<string>',
        'timeMaintenanceWindowEnd' => '<string>',
        'timeMaintenanceWindowStart' => '<string>',
        'totalCpuCoreCount' => <integer>,
        'vnic2Id' => '<string>',
        'vnicId' => '<string>',
    ],
]

Result Details

Members
dbNode
Type: DbNode structure

Information about a DB node.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetDbServer

$result = $client->getDbServer([/* ... */]);
$promise = $client->getDbServerAsync([/* ... */]);

Returns information about the specified database server.

Parameter Syntax

$result = $client->getDbServer([
    'cloudExadataInfrastructureId' => '<string>', // REQUIRED
    'dbServerId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier of the Oracle Exadata infrastructure that contains the database server.

dbServerId
Required: Yes
Type: string

The unique identifier of the database server to retrieve information about.

Result Syntax

[
    'dbServer' => [
        'autonomousVirtualMachineIds' => ['<string>', ...],
        'autonomousVmClusterIds' => ['<string>', ...],
        'computeModel' => 'ECPU|OCPU',
        'cpuCoreCount' => <integer>,
        'createdAt' => <DateTime>,
        'dbNodeStorageSizeInGBs' => <integer>,
        'dbServerId' => '<string>',
        'dbServerPatchingDetails' => [
            'estimatedPatchDuration' => <integer>,
            'patchingStatus' => 'COMPLETE|FAILED|MAINTENANCE_IN_PROGRESS|SCHEDULED',
            'timePatchingEnded' => '<string>',
            'timePatchingStarted' => '<string>',
        ],
        'displayName' => '<string>',
        'exadataInfrastructureId' => '<string>',
        'maxCpuCount' => <integer>,
        'maxDbNodeStorageInGBs' => <integer>,
        'maxMemoryInGBs' => <integer>,
        'memorySizeInGBs' => <integer>,
        'ociResourceAnchorName' => '<string>',
        'ocid' => '<string>',
        'shape' => '<string>',
        'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
        'statusReason' => '<string>',
        'vmClusterIds' => ['<string>', ...],
    ],
]

Result Details

Members
dbServer
Type: DbServer structure

The details of the requested database server.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetOciOnboardingStatus

$result = $client->getOciOnboardingStatus([/* ... */]);
$promise = $client->getOciOnboardingStatusAsync([/* ... */]);

Returns the tenancy activation link and onboarding status for your Amazon Web Services account.

Parameter Syntax

$result = $client->getOciOnboardingStatus([
]);

Parameter Details

Members

Result Syntax

[
    'autonomousDatabaseOciIntegrationIamRoles' => [
        [
            'awsIntegration' => 'KmsTde',
            'iamRoleArn' => '<string>',
        ],
        // ...
    ],
    'existingTenancyActivationLink' => '<string>',
    'linkedOciCompartmentId' => '<string>',
    'linkedOciTenancyId' => '<string>',
    'newTenancyActivationLink' => '<string>',
    'ociIdentityDomain' => [
        'accountSetupCloudFormationUrl' => '<string>',
        'ociIdentityDomainId' => '<string>',
        'ociIdentityDomainResourceUrl' => '<string>',
        'ociIdentityDomainUrl' => '<string>',
        'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
        'statusReason' => '<string>',
    ],
    'status' => 'NOT_STARTED|PENDING_LINK_GENERATION|PENDING_CUSTOMER_ACTION|PENDING_INITIALIZATION|ACTIVATING|ACTIVE_IN_HOME_REGION|ACTIVE|ACTIVE_LIMITED|FAILED|PUBLIC_OFFER_UNSUPPORTED|SUSPENDED|CANCELED',
    'subscriptionErrors' => [
        [
            'errorMessage' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
autonomousDatabaseOciIntegrationIamRoles
Type: Array of OciIamRole structures

The list of Amazon Web Services Identity and Access Management (IAM) service roles used for Autonomous Database integration with Oracle Cloud Infrastructure (OCI).

existingTenancyActivationLink
Type: string

The existing OCI tenancy activation link for your Amazon Web Services account.

linkedOciCompartmentId
Type: string

The unique identifier of the Oracle Cloud Infrastructure (OCI) compartment that is linked to your Amazon Web Services account.

linkedOciTenancyId
Type: string

The unique identifier of the Oracle Cloud Infrastructure (OCI) tenancy that is linked to your Amazon Web Services account.

newTenancyActivationLink
Type: string

A new OCI tenancy activation link for your Amazon Web Services account.

ociIdentityDomain
Type: OciIdentityDomain structure

The Oracle Cloud Infrastructure (OCI) identity domain information in the onboarding status response.

status
Type: string

subscriptionErrors
Type: Array of SubscriptionError structures

The list of errors that occurred during the subscription process for your Amazon Web Services account, if any.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

GetOdbNetwork

$result = $client->getOdbNetwork([/* ... */]);
$promise = $client->getOdbNetworkAsync([/* ... */]);

Returns information about the specified ODB network.

Parameter Syntax

$result = $client->getOdbNetwork([
    'odbNetworkId' => '<string>', // REQUIRED
]);

Parameter Details

Members
odbNetworkId
Required: Yes
Type: string

The unique identifier of the ODB network.

Result Syntax

[
    'odbNetwork' => [
        'availabilityZone' => '<string>',
        'availabilityZoneId' => '<string>',
        'backupSubnetCidr' => '<string>',
        'clientSubnetCidr' => '<string>',
        'createdAt' => <DateTime>,
        'customDomainName' => '<string>',
        'defaultDnsPrefix' => '<string>',
        'displayName' => '<string>',
        'ec2PlacementGroupIds' => ['<string>', ...],
        'managedServices' => [
            'crossRegionS3RestoreSourcesAccess' => [
                [
                    'ipv4Addresses' => ['<string>', ...],
                    'region' => '<string>',
                    'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
                ],
                // ...
            ],
            'kmsAccess' => [
                'domainName' => '<string>',
                'ipv4Addresses' => ['<string>', ...],
                'kmsPolicyDocument' => '<string>',
                'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
            ],
            'managedS3BackupAccess' => [
                'ipv4Addresses' => ['<string>', ...],
                'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
            ],
            'managedServicesIpv4Cidrs' => ['<string>', ...],
            'resourceGatewayArn' => '<string>',
            's3Access' => [
                'domainName' => '<string>',
                'ipv4Addresses' => ['<string>', ...],
                's3PolicyDocument' => '<string>',
                'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
            ],
            'serviceNetworkArn' => '<string>',
            'serviceNetworkEndpoint' => [
                'vpcEndpointId' => '<string>',
                'vpcEndpointType' => 'SERVICENETWORK',
            ],
            'stsAccess' => [
                'domainName' => '<string>',
                'ipv4Addresses' => ['<string>', ...],
                'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
                'stsPolicyDocument' => '<string>',
            ],
            'zeroEtlAccess' => [
                'cidr' => '<string>',
                'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
            ],
        ],
        'ociDnsForwardingConfigs' => [
            [
                'domainName' => '<string>',
                'ociDnsListenerIp' => '<string>',
            ],
            // ...
        ],
        'ociNetworkAnchorId' => '<string>',
        'ociNetworkAnchorUrl' => '<string>',
        'ociResourceAnchorName' => '<string>',
        'ociVcnId' => '<string>',
        'ociVcnUrl' => '<string>',
        'odbNetworkArn' => '<string>',
        'odbNetworkId' => '<string>',
        'peeredCidrs' => ['<string>', ...],
        'percentProgress' => <float>,
        'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
        'statusReason' => '<string>',
    ],
]

Result Details

Members
odbNetwork
Type: OdbNetwork structure

The ODB network.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

GetOdbPeeringConnection

$result = $client->getOdbPeeringConnection([/* ... */]);
$promise = $client->getOdbPeeringConnectionAsync([/* ... */]);

Retrieves information about an ODB peering connection.

Parameter Syntax

$result = $client->getOdbPeeringConnection([
    'odbPeeringConnectionId' => '<string>', // REQUIRED
]);

Parameter Details

Members
odbPeeringConnectionId
Required: Yes
Type: string

The unique identifier of the ODB peering connection to retrieve information about.

Result Syntax

[
    'odbPeeringConnection' => [
        'createdAt' => <DateTime>,
        'displayName' => '<string>',
        'odbNetworkArn' => '<string>',
        'odbPeeringConnectionArn' => '<string>',
        'odbPeeringConnectionId' => '<string>',
        'odbPeeringConnectionType' => '<string>',
        'peerNetworkArn' => '<string>',
        'peerNetworkCidrs' => ['<string>', ...],
        'percentProgress' => <float>,
        'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
        'statusReason' => '<string>',
    ],
]

Result Details

Members
odbPeeringConnection
Type: OdbPeeringConnection structure

A peering connection between an ODB network and either another ODB network or a customer-owned VPC.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

InitializeService

$result = $client->initializeService([/* ... */]);
$promise = $client->initializeServiceAsync([/* ... */]);

Initializes the ODB service for the first time in an account.

Parameter Syntax

$result = $client->initializeService([
    'ociIdentityDomain' => true || false,
]);

Parameter Details

Members
ociIdentityDomain
Type: boolean

The Oracle Cloud Infrastructure (OCI) identity domain configuration for service initialization.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ListAutonomousDatabaseBackups

$result = $client->listAutonomousDatabaseBackups([/* ... */]);
$promise = $client->listAutonomousDatabaseBackupsAsync([/* ... */]);

Lists the backups of the specified Autonomous Database.

Parameter Syntax

$result = $client->listAutonomousDatabaseBackups([
    'autonomousDatabaseId' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'status' => 'ACTIVE|CREATING|UPDATING|DELETING|FAILED',
    'type' => 'INCREMENTAL|FULL|LONGTERM|VIRTUAL_FULL|CUMULATIVE_INCREMENTAL|ROLL_FORWARD_IMAGE_COPY',
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

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

maxResults
Type: int

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
Type: string

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

status
Type: string

The status of the Autonomous Database backups to return results for.

type
Type: string

The type of the Autonomous Database backups to return results for.

Result Syntax

[
    'autonomousDatabaseBackups' => [
        [
            'autonomousDatabaseBackupArn' => '<string>',
            'autonomousDatabaseBackupId' => '<string>',
            'autonomousDatabaseId' => '<string>',
            'dbVersion' => '<string>',
            'displayName' => '<string>',
            'isAutomatic' => true || false,
            'ocid' => '<string>',
            'retentionPeriodInDays' => <integer>,
            'sizeInTBs' => <float>,
            'status' => 'ACTIVE|CREATING|UPDATING|DELETING|FAILED',
            'statusReason' => '<string>',
            'timeAvailableTill' => <DateTime>,
            'timeEnded' => <DateTime>,
            'timeStarted' => <DateTime>,
            'type' => 'INCREMENTAL|FULL|LONGTERM|VIRTUAL_FULL|CUMULATIVE_INCREMENTAL|ROLL_FORWARD_IMAGE_COPY',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
autonomousDatabaseBackups
Required: Yes
Type: Array of AutonomousDatabaseBackupSummary structures

The list of Autonomous Database backups along with their properties.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ListAutonomousDatabaseCharacterSets

$result = $client->listAutonomousDatabaseCharacterSets([/* ... */]);
$promise = $client->listAutonomousDatabaseCharacterSetsAsync([/* ... */]);

Lists the available character sets for Autonomous Databases.

Parameter Syntax

$result = $client->listAutonomousDatabaseCharacterSets([
    'characterSetType' => 'DATABASE|NATIONAL',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
characterSetType
Type: string

The type of character set to return results for, either the database character set or the national character set.

maxResults
Type: int

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
Type: string

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

Result Syntax

[
    'autonomousDatabaseCharacterSets' => [
        [
            'characterSet' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
autonomousDatabaseCharacterSets
Required: Yes
Type: Array of AutonomousDatabaseCharacterSetSummary structures

The list of available Autonomous Database character sets.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ListAutonomousDatabaseClones

$result = $client->listAutonomousDatabaseClones([/* ... */]);
$promise = $client->listAutonomousDatabaseClonesAsync([/* ... */]);

Lists the clones of the specified Autonomous Database.

Parameter Syntax

$result = $client->listAutonomousDatabaseClones([
    'autonomousDatabaseId' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

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

maxResults
Type: int

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
Type: string

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

Result Syntax

[
    'autonomousDatabaseClones' => [
        [
            'actualUsedDataStorageSizeInTBs' => <float>,
            'allocatedStorageSizeInTBs' => <float>,
            'allowlistedIps' => ['<string>', ...],
            'apexDetails' => [
                'apexVersion' => '<string>',
                'ordsVersion' => '<string>',
            ],
            'autoRefreshFrequencyInSeconds' => <integer>,
            'autoRefreshPointLagInSeconds' => <integer>,
            'autonomousDatabaseArn' => '<string>',
            'autonomousDatabaseId' => '<string>',
            'autonomousMaintenanceScheduleType' => 'EARLY|REGULAR',
            'availabilityZone' => '<string>',
            'availabilityZoneId' => '<string>',
            'availableUpgradeVersions' => ['<string>', ...],
            'backupRetentionPeriodInDays' => <integer>,
            'byolComputeCountLimit' => <integer>,
            'characterSet' => '<string>',
            'cloneTableSpaceList' => [<integer>, ...],
            'computeCount' => <float>,
            'computeModel' => 'ECPU|OCPU',
            'connectionStringDetails' => [
                'allConnectionStrings' => ['<string>', ...],
                'dedicated' => '<string>',
                'high' => '<string>',
                'low' => '<string>',
                'medium' => '<string>',
                'profiles' => [
                    [
                        'consumerGroup' => '<string>',
                        'displayName' => '<string>',
                        'hostFormat' => '<string>',
                        'isRegional' => true || false,
                        'protocol' => '<string>',
                        'sessionMode' => '<string>',
                        'syntaxFormat' => '<string>',
                        'tlsAuthentication' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
            ],
            'connectionUrls' => [
                'apexUrl' => '<string>',
                'databaseTransformsUrl' => '<string>',
                'graphStudioUrl' => '<string>',
                'machineLearningNotebookUrl' => '<string>',
                'machineLearningUserManagementUrl' => '<string>',
                'mongoDbUrl' => '<string>',
                'ordsUrl' => '<string>',
                'spatialStudioUrl' => '<string>',
                'sqlDevWebUrl' => '<string>',
            ],
            'cpuCoreCount' => <integer>,
            'createdAt' => <DateTime>,
            'customerContacts' => [
                [
                    'email' => '<string>',
                ],
                // ...
            ],
            'dataSafeStatus' => 'REGISTERING|REGISTERED|DEREGISTERING|NOT_REGISTERED|FAILED',
            'dataStorageSizeInGBs' => <integer>,
            'dataStorageSizeInTBs' => <float>,
            'databaseEdition' => 'STANDARD_EDITION|ENTERPRISE_EDITION',
            'databaseManagementStatus' => 'ENABLING|ENABLED|DISABLING|NOT_ENABLED|FAILED_ENABLING|FAILED_DISABLING',
            'databaseType' => 'REGULAR|CLONE',
            'dbName' => '<string>',
            'dbToolsDetails' => [
                [
                    'computeCount' => <float>,
                    'isEnabled' => true || false,
                    'maxIdleTimeInMinutes' => <integer>,
                    'name' => '<string>',
                ],
                // ...
            ],
            'dbVersion' => '<string>',
            'dbWorkload' => 'OLTP|AJD|APEX|LH',
            'displayName' => '<string>',
            'encryptionSummary' => [
                'encryptionKeyConfiguration' => [
                    'awsEncryptionKey' => [
                        'externalIdType' => 'database_ocid|compartment_ocid|tenant_ocid',
                        'iamRoleArn' => '<string>',
                        'kmsKeyId' => '<string>',
                    ],
                    'ociEncryptionKey' => [
                        'kmsKeyId' => '<string>',
                        'vaultId' => '<string>',
                    ],
                    'okvEncryptionKey' => [
                        'certificateDirectoryName' => '<string>',
                        'certificateId' => '<string>',
                        'directoryName' => '<string>',
                        'okvKmsKey' => '<string>',
                        'okvUri' => '<string>',
                    ],
                ],
                'encryptionKeyProvider' => 'ORACLE_MANAGED|AWS_KMS|OKV|OCI',
            ],
            'failedDataRecoveryInSeconds' => <integer>,
            'inMemoryAreaInGBs' => <integer>,
            'isAutoScalingEnabled' => true || false,
            'isAutoScalingForStorageEnabled' => true || false,
            'isBackupRetentionLocked' => true || false,
            'isLocalDataGuardEnabled' => true || false,
            'isMtlsConnectionRequired' => true || false,
            'isReconnectCloneEnabled' => true || false,
            'isRefreshableClone' => true || false,
            'isRemoteDataGuardEnabled' => true || false,
            'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
            'localAdgAutoFailoverMaxDataLossLimit' => <integer>,
            'localDisasterRecoveryType' => 'ADG|BACKUP_BASED',
            'localStandbyDb' => [
                'availabilityDomain' => '<string>',
                'lagTimeInSeconds' => <integer>,
                'maintenanceTargetComponent' => '<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>',
                'timeDataGuardRoleChanged' => <DateTime>,
                'timeDisasterRecoveryRoleChanged' => <DateTime>,
                'timeMaintenanceBegin' => <DateTime>,
                'timeMaintenanceEnd' => <DateTime>,
            ],
            'longTermBackupSchedule' => [
                'isDisabled' => true || false,
                'repeatCadence' => 'ONE_TIME|WEEKLY|MONTHLY|YEARLY',
                'retentionPeriodInDays' => <integer>,
                'timeOfBackup' => <DateTime>,
            ],
            'maintenanceTargetComponent' => '<string>',
            'memoryPerOracleComputeUnitInGBs' => <integer>,
            'ncharacterSet' => '<string>',
            'netServicesArchitecture' => 'DEDICATED|SHARED',
            'nextLongTermBackupTimeStamp' => <DateTime>,
            'ociResourceAnchorName' => '<string>',
            'ociUrl' => '<string>',
            'ocid' => '<string>',
            'odbNetworkArn' => '<string>',
            'odbNetworkId' => '<string>',
            'openMode' => 'READ_ONLY|READ_WRITE',
            'operationsInsightsStatus' => 'ENABLING|ENABLED|DISABLING|NOT_ENABLED|FAILED_ENABLING|FAILED_DISABLING',
            'peerDbIds' => ['<string>', ...],
            'percentProgress' => <float>,
            'permissionLevel' => 'RESTRICTED|UNRESTRICTED',
            'privateEndpoint' => '<string>',
            'privateEndpointIp' => '<string>',
            'privateEndpointLabel' => '<string>',
            'provisionableCpus' => [<integer>, ...],
            'refreshableMode' => 'AUTOMATIC|MANUAL',
            'refreshableStatus' => 'REFRESHING|NOT_REFRESHING',
            'remoteDisasterRecoveryConfiguration' => [
                'disasterRecoveryType' => 'ADG|BACKUP_BASED',
                'isReplicateAutomaticBackups' => true || false,
                'isSnapshotStandby' => true || false,
                'timeSnapshotStandbyEnabledTill' => <DateTime>,
            ],
            'resourcePoolLeaderId' => '<string>',
            'resourcePoolSummary' => [
                'availableComputeCapacity' => <integer>,
                'availableStorageCapacityInTBs' => <float>,
                'isDisabled' => true || false,
                'poolSize' => <integer>,
                'poolStorageSizeInTBs' => <integer>,
                'totalComputeCapacity' => <integer>,
            ],
            'role' => 'PRIMARY|STANDBY|DISABLED_STANDBY|BACKUP_COPY|SNAPSHOT_STANDBY',
            'scheduledOperations' => [
                [
                    'dayOfWeek' => [
                        'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
                    ],
                    'scheduledStartTime' => '<string>',
                    'scheduledStopTime' => '<string>',
                ],
                // ...
            ],
            'serviceConsoleUrl' => '<string>',
            'sourceId' => '<string>',
            'sqlWebDeveloperUrl' => '<string>',
            'standbyAllowlistedIps' => ['<string>', ...],
            'standbyAllowlistedIpsSource' => 'PRIMARY|SEPARATE|NOT_APPLICABLE',
            'standbyDb' => [
                'availabilityDomain' => '<string>',
                'lagTimeInSeconds' => <integer>,
                'maintenanceTargetComponent' => '<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>',
                'timeDataGuardRoleChanged' => <DateTime>,
                'timeDisasterRecoveryRoleChanged' => <DateTime>,
                'timeMaintenanceBegin' => <DateTime>,
                'timeMaintenanceEnd' => <DateTime>,
            ],
            '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>',
            'timeDataGuardRoleChanged' => <DateTime>,
            'timeDeletionOfFreeAutonomousDatabase' => <DateTime>,
            'timeDisasterRecoveryRoleChanged' => <DateTime>,
            'timeLocalDataGuardEnabled' => <DateTime>,
            'timeMaintenanceBegin' => <DateTime>,
            'timeMaintenanceEnd' => <DateTime>,
            'timeOfAutoRefreshStart' => <DateTime>,
            'timeOfLastBackup' => <DateTime>,
            'timeOfLastFailover' => <DateTime>,
            'timeOfLastRefresh' => <DateTime>,
            'timeOfLastRefreshPoint' => <DateTime>,
            'timeOfLastSwitchover' => <DateTime>,
            'timeOfNextRefresh' => <DateTime>,
            'timeReclamationOfFreeAutonomousDatabase' => <DateTime>,
            'timeUndeleted' => <DateTime>,
            'timeUntilReconnectCloneEnabled' => <DateTime>,
            'totalBackupStorageSizeInGBs' => <float>,
            'usedDataStorageSizeInGBs' => <integer>,
            'usedDataStorageSizeInTBs' => <float>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
autonomousDatabaseClones
Required: Yes
Type: Array of AutonomousDatabaseSummary structures

The list of Autonomous Database clones along with their properties.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ListAutonomousDatabasePeers

$result = $client->listAutonomousDatabasePeers([/* ... */]);
$promise = $client->listAutonomousDatabasePeersAsync([/* ... */]);

Lists the peer databases of the specified Autonomous Database.

Parameter Syntax

$result = $client->listAutonomousDatabasePeers([
    'autonomousDatabaseId' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

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

maxResults
Type: int

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
Type: string

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

Result Syntax

[
    'autonomousDatabasePeers' => [
        [
            'autonomousDatabaseArn' => '<string>',
            'autonomousDatabaseId' => '<string>',
            'ocid' => '<string>',
            'region' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
autonomousDatabasePeers
Required: Yes
Type: Array of AutonomousDatabasePeerSummary structures

The list of peer databases for the Autonomous Database.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ListAutonomousDatabaseVersions

$result = $client->listAutonomousDatabaseVersions([/* ... */]);
$promise = $client->listAutonomousDatabaseVersionsAsync([/* ... */]);

Lists the available Oracle Database software versions for Autonomous Databases.

Parameter Syntax

$result = $client->listAutonomousDatabaseVersions([
    'dbWorkload' => 'OLTP|AJD|APEX|LH',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
dbWorkload
Type: string

The intended use of the Autonomous Database to return versions for, such as transaction processing, data warehouse, JSON database, or APEX.

maxResults
Type: int

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
Type: string

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

Result Syntax

[
    'autonomousDatabaseVersions' => [
        [
            'dbWorkload' => 'OLTP|AJD|APEX|LH',
            'details' => '<string>',
            'version' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
autonomousDatabaseVersions
Required: Yes
Type: Array of AutonomousDatabaseVersionSummary structures

The list of available Autonomous Database software versions.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ListAutonomousDatabases

$result = $client->listAutonomousDatabases([/* ... */]);
$promise = $client->listAutonomousDatabasesAsync([/* ... */]);

Returns information about the Autonomous Databases owned by your Amazon Web Services account in the current Amazon Web Services Region.

Parameter Syntax

$result = $client->listAutonomousDatabases([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

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
Type: string

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

Result Syntax

[
    'autonomousDatabases' => [
        [
            'actualUsedDataStorageSizeInTBs' => <float>,
            'allocatedStorageSizeInTBs' => <float>,
            'allowlistedIps' => ['<string>', ...],
            'apexDetails' => [
                'apexVersion' => '<string>',
                'ordsVersion' => '<string>',
            ],
            'autoRefreshFrequencyInSeconds' => <integer>,
            'autoRefreshPointLagInSeconds' => <integer>,
            'autonomousDatabaseArn' => '<string>',
            'autonomousDatabaseId' => '<string>',
            'autonomousMaintenanceScheduleType' => 'EARLY|REGULAR',
            'availabilityZone' => '<string>',
            'availabilityZoneId' => '<string>',
            'availableUpgradeVersions' => ['<string>', ...],
            'backupRetentionPeriodInDays' => <integer>,
            'byolComputeCountLimit' => <integer>,
            'characterSet' => '<string>',
            'cloneTableSpaceList' => [<integer>, ...],
            'computeCount' => <float>,
            'computeModel' => 'ECPU|OCPU',
            'connectionStringDetails' => [
                'allConnectionStrings' => ['<string>', ...],
                'dedicated' => '<string>',
                'high' => '<string>',
                'low' => '<string>',
                'medium' => '<string>',
                'profiles' => [
                    [
                        'consumerGroup' => '<string>',
                        'displayName' => '<string>',
                        'hostFormat' => '<string>',
                        'isRegional' => true || false,
                        'protocol' => '<string>',
                        'sessionMode' => '<string>',
                        'syntaxFormat' => '<string>',
                        'tlsAuthentication' => '<string>',
                        'value' => '<string>',
                    ],
                    // ...
                ],
            ],
            'connectionUrls' => [
                'apexUrl' => '<string>',
                'databaseTransformsUrl' => '<string>',
                'graphStudioUrl' => '<string>',
                'machineLearningNotebookUrl' => '<string>',
                'machineLearningUserManagementUrl' => '<string>',
                'mongoDbUrl' => '<string>',
                'ordsUrl' => '<string>',
                'spatialStudioUrl' => '<string>',
                'sqlDevWebUrl' => '<string>',
            ],
            'cpuCoreCount' => <integer>,
            'createdAt' => <DateTime>,
            'customerContacts' => [
                [
                    'email' => '<string>',
                ],
                // ...
            ],
            'dataSafeStatus' => 'REGISTERING|REGISTERED|DEREGISTERING|NOT_REGISTERED|FAILED',
            'dataStorageSizeInGBs' => <integer>,
            'dataStorageSizeInTBs' => <float>,
            'databaseEdition' => 'STANDARD_EDITION|ENTERPRISE_EDITION',
            'databaseManagementStatus' => 'ENABLING|ENABLED|DISABLING|NOT_ENABLED|FAILED_ENABLING|FAILED_DISABLING',
            'databaseType' => 'REGULAR|CLONE',
            'dbName' => '<string>',
            'dbToolsDetails' => [
                [
                    'computeCount' => <float>,
                    'isEnabled' => true || false,
                    'maxIdleTimeInMinutes' => <integer>,
                    'name' => '<string>',
                ],
                // ...
            ],
            'dbVersion' => '<string>',
            'dbWorkload' => 'OLTP|AJD|APEX|LH',
            'displayName' => '<string>',
            'encryptionSummary' => [
                'encryptionKeyConfiguration' => [
                    'awsEncryptionKey' => [
                        'externalIdType' => 'database_ocid|compartment_ocid|tenant_ocid',
                        'iamRoleArn' => '<string>',
                        'kmsKeyId' => '<string>',
                    ],
                    'ociEncryptionKey' => [
                        'kmsKeyId' => '<string>',
                        'vaultId' => '<string>',
                    ],
                    'okvEncryptionKey' => [
                        'certificateDirectoryName' => '<string>',
                        'certificateId' => '<string>',
                        'directoryName' => '<string>',
                        'okvKmsKey' => '<string>',
                        'okvUri' => '<string>',
                    ],
                ],
                'encryptionKeyProvider' => 'ORACLE_MANAGED|AWS_KMS|OKV|OCI',
            ],
            'failedDataRecoveryInSeconds' => <integer>,
            'inMemoryAreaInGBs' => <integer>,
            'isAutoScalingEnabled' => true || false,
            'isAutoScalingForStorageEnabled' => true || false,
            'isBackupRetentionLocked' => true || false,
            'isLocalDataGuardEnabled' => true || false,
            'isMtlsConnectionRequired' => true || false,
            'isReconnectCloneEnabled' => true || false,
            'isRefreshableClone' => true || false,
            'isRemoteDataGuardEnabled' => true || false,
            'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
            'localAdgAutoFailoverMaxDataLossLimit' => <integer>,
            'localDisasterRecoveryType' => 'ADG|BACKUP_BASED',
            'localStandbyDb' => [
                'availabilityDomain' => '<string>',
                'lagTimeInSeconds' => <integer>,
                'maintenanceTargetComponent' => '<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>',
                'timeDataGuardRoleChanged' => <DateTime>,
                'timeDisasterRecoveryRoleChanged' => <DateTime>,
                'timeMaintenanceBegin' => <DateTime>,
                'timeMaintenanceEnd' => <DateTime>,
            ],
            'longTermBackupSchedule' => [
                'isDisabled' => true || false,
                'repeatCadence' => 'ONE_TIME|WEEKLY|MONTHLY|YEARLY',
                'retentionPeriodInDays' => <integer>,
                'timeOfBackup' => <DateTime>,
            ],
            'maintenanceTargetComponent' => '<string>',
            'memoryPerOracleComputeUnitInGBs' => <integer>,
            'ncharacterSet' => '<string>',
            'netServicesArchitecture' => 'DEDICATED|SHARED',
            'nextLongTermBackupTimeStamp' => <DateTime>,
            'ociResourceAnchorName' => '<string>',
            'ociUrl' => '<string>',
            'ocid' => '<string>',
            'odbNetworkArn' => '<string>',
            'odbNetworkId' => '<string>',
            'openMode' => 'READ_ONLY|READ_WRITE',
            'operationsInsightsStatus' => 'ENABLING|ENABLED|DISABLING|NOT_ENABLED|FAILED_ENABLING|FAILED_DISABLING',
            'peerDbIds' => ['<string>', ...],
            'percentProgress' => <float>,
            'permissionLevel' => 'RESTRICTED|UNRESTRICTED',
            'privateEndpoint' => '<string>',
            'privateEndpointIp' => '<string>',
            'privateEndpointLabel' => '<string>',
            'provisionableCpus' => [<integer>, ...],
            'refreshableMode' => 'AUTOMATIC|MANUAL',
            'refreshableStatus' => 'REFRESHING|NOT_REFRESHING',
            'remoteDisasterRecoveryConfiguration' => [
                'disasterRecoveryType' => 'ADG|BACKUP_BASED',
                'isReplicateAutomaticBackups' => true || false,
                'isSnapshotStandby' => true || false,
                'timeSnapshotStandbyEnabledTill' => <DateTime>,
            ],
            'resourcePoolLeaderId' => '<string>',
            'resourcePoolSummary' => [
                'availableComputeCapacity' => <integer>,
                'availableStorageCapacityInTBs' => <float>,
                'isDisabled' => true || false,
                'poolSize' => <integer>,
                'poolStorageSizeInTBs' => <integer>,
                'totalComputeCapacity' => <integer>,
            ],
            'role' => 'PRIMARY|STANDBY|DISABLED_STANDBY|BACKUP_COPY|SNAPSHOT_STANDBY',
            'scheduledOperations' => [
                [
                    'dayOfWeek' => [
                        'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
                    ],
                    'scheduledStartTime' => '<string>',
                    'scheduledStopTime' => '<string>',
                ],
                // ...
            ],
            'serviceConsoleUrl' => '<string>',
            'sourceId' => '<string>',
            'sqlWebDeveloperUrl' => '<string>',
            'standbyAllowlistedIps' => ['<string>', ...],
            'standbyAllowlistedIpsSource' => 'PRIMARY|SEPARATE|NOT_APPLICABLE',
            'standbyDb' => [
                'availabilityDomain' => '<string>',
                'lagTimeInSeconds' => <integer>,
                'maintenanceTargetComponent' => '<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>',
                'timeDataGuardRoleChanged' => <DateTime>,
                'timeDisasterRecoveryRoleChanged' => <DateTime>,
                'timeMaintenanceBegin' => <DateTime>,
                'timeMaintenanceEnd' => <DateTime>,
            ],
            '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>',
            'timeDataGuardRoleChanged' => <DateTime>,
            'timeDeletionOfFreeAutonomousDatabase' => <DateTime>,
            'timeDisasterRecoveryRoleChanged' => <DateTime>,
            'timeLocalDataGuardEnabled' => <DateTime>,
            'timeMaintenanceBegin' => <DateTime>,
            'timeMaintenanceEnd' => <DateTime>,
            'timeOfAutoRefreshStart' => <DateTime>,
            'timeOfLastBackup' => <DateTime>,
            'timeOfLastFailover' => <DateTime>,
            'timeOfLastRefresh' => <DateTime>,
            'timeOfLastRefreshPoint' => <DateTime>,
            'timeOfLastSwitchover' => <DateTime>,
            'timeOfNextRefresh' => <DateTime>,
            'timeReclamationOfFreeAutonomousDatabase' => <DateTime>,
            'timeUndeleted' => <DateTime>,
            'timeUntilReconnectCloneEnabled' => <DateTime>,
            'totalBackupStorageSizeInGBs' => <float>,
            'usedDataStorageSizeInGBs' => <integer>,
            'usedDataStorageSizeInTBs' => <float>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
autonomousDatabases
Required: Yes
Type: Array of AutonomousDatabaseSummary structures

The list of Autonomous Databases along with their properties.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ListAutonomousVirtualMachines

$result = $client->listAutonomousVirtualMachines([/* ... */]);
$promise = $client->listAutonomousVirtualMachinesAsync([/* ... */]);

Lists all Autonomous VMs in an Autonomous VM cluster.

Parameter Syntax

$result = $client->listAutonomousVirtualMachines([
    'cloudAutonomousVmClusterId' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
cloudAutonomousVmClusterId
Required: Yes
Type: string

The unique identifier of the Autonomous VM cluster whose virtual machines you're listing.

maxResults
Type: int

The maximum number of items to return per page.

nextToken
Type: string

The pagination token to continue listing from.

Result Syntax

[
    'autonomousVirtualMachines' => [
        [
            'autonomousVirtualMachineId' => '<string>',
            'clientIpAddress' => '<string>',
            'cloudAutonomousVmClusterId' => '<string>',
            'cpuCoreCount' => <integer>,
            'dbNodeStorageSizeInGBs' => <integer>,
            'dbServerDisplayName' => '<string>',
            'dbServerId' => '<string>',
            'memorySizeInGBs' => <integer>,
            'ociResourceAnchorName' => '<string>',
            'ocid' => '<string>',
            'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
            'statusReason' => '<string>',
            'vmName' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
autonomousVirtualMachines
Required: Yes
Type: Array of AutonomousVirtualMachineSummary structures

The list of Autonomous VMs in the specified Autonomous VM cluster.

nextToken
Type: string

The pagination token from which to continue listing.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ListCloudAutonomousVmClusters

$result = $client->listCloudAutonomousVmClusters([/* ... */]);
$promise = $client->listCloudAutonomousVmClustersAsync([/* ... */]);

Lists all Autonomous VM clusters in a specified Cloud Exadata infrastructure.

Parameter Syntax

$result = $client->listCloudAutonomousVmClusters([
    'cloudExadataInfrastructureId' => '<string>',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
cloudExadataInfrastructureId
Type: string

The unique identifier of the Cloud Exadata Infrastructure that hosts the Autonomous VM clusters to be listed.

maxResults
Type: int

The maximum number of items to return per page.

nextToken
Type: string

The pagination token to continue listing from.

Result Syntax

[
    'cloudAutonomousVmClusters' => [
        [
            'autonomousDataStoragePercentage' => <float>,
            'autonomousDataStorageSizeInTBs' => <float>,
            'availableAutonomousDataStorageSizeInTBs' => <float>,
            'availableContainerDatabases' => <integer>,
            'availableCpus' => <float>,
            'cloudAutonomousVmClusterArn' => '<string>',
            'cloudAutonomousVmClusterId' => '<string>',
            'cloudExadataInfrastructureArn' => '<string>',
            'cloudExadataInfrastructureId' => '<string>',
            'computeModel' => 'ECPU|OCPU',
            'cpuCoreCount' => <integer>,
            'cpuCoreCountPerNode' => <integer>,
            'cpuPercentage' => <float>,
            'createdAt' => <DateTime>,
            'dataStorageSizeInGBs' => <float>,
            'dataStorageSizeInTBs' => <float>,
            'dbNodeStorageSizeInGBs' => <integer>,
            'dbServers' => ['<string>', ...],
            'description' => '<string>',
            'displayName' => '<string>',
            'domain' => '<string>',
            'exadataStorageInTBsLowestScaledValue' => <float>,
            'hostname' => '<string>',
            'iamRoles' => [
                [
                    'awsIntegration' => 'KmsTde',
                    'iamRoleArn' => '<string>',
                    'status' => 'ASSOCIATING|DISASSOCIATING|FAILED|CONNECTED|DISCONNECTED|PARTIALLY_CONNECTED|UNKNOWN',
                    'statusReason' => '<string>',
                ],
                // ...
            ],
            'isMtlsEnabledVmCluster' => true || false,
            'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
            'maintenanceWindow' => [
                'customActionTimeoutInMins' => <integer>,
                'daysOfWeek' => [
                    [
                        'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
                    ],
                    // ...
                ],
                'hoursOfDay' => [<integer>, ...],
                'isCustomActionTimeoutEnabled' => true || false,
                'leadTimeInWeeks' => <integer>,
                'months' => [
                    [
                        'name' => 'JANUARY|FEBRUARY|MARCH|APRIL|MAY|JUNE|JULY|AUGUST|SEPTEMBER|OCTOBER|NOVEMBER|DECEMBER',
                    ],
                    // ...
                ],
                'patchingMode' => 'ROLLING|NONROLLING',
                'preference' => 'NO_PREFERENCE|CUSTOM_PREFERENCE',
                'skipRu' => true || false,
                'weeksOfMonth' => [<integer>, ...],
            ],
            'maxAcdsLowestScaledValue' => <integer>,
            'memoryPerOracleComputeUnitInGBs' => <integer>,
            'memorySizeInGBs' => <integer>,
            'nodeCount' => <integer>,
            'nonProvisionableAutonomousContainerDatabases' => <integer>,
            'ociResourceAnchorName' => '<string>',
            'ociUrl' => '<string>',
            'ocid' => '<string>',
            'odbNetworkArn' => '<string>',
            'odbNetworkId' => '<string>',
            'percentProgress' => <float>,
            'provisionableAutonomousContainerDatabases' => <integer>,
            'provisionedAutonomousContainerDatabases' => <integer>,
            'provisionedCpus' => <float>,
            'reclaimableCpus' => <float>,
            'reservedCpus' => <float>,
            'scanListenerPortNonTls' => <integer>,
            'scanListenerPortTls' => <integer>,
            'shape' => '<string>',
            'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
            'statusReason' => '<string>',
            'timeDatabaseSslCertificateExpires' => <DateTime>,
            'timeOrdsCertificateExpires' => <DateTime>,
            'timeZone' => '<string>',
            'totalContainerDatabases' => <integer>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
cloudAutonomousVmClusters
Required: Yes
Type: Array of CloudAutonomousVmClusterSummary structures

The list of Autonomous VM clusters in the specified Cloud Exadata Infrastructure.

nextToken
Type: string

The pagination token to continue listing from.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ListCloudExadataInfrastructures

$result = $client->listCloudExadataInfrastructures([/* ... */]);
$promise = $client->listCloudExadataInfrastructuresAsync([/* ... */]);

Returns information about the Exadata infrastructures owned by your Amazon Web Services account.

Parameter Syntax

$result = $client->listCloudExadataInfrastructures([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

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.

Default: 10

nextToken
Type: string

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

Result Syntax

[
    'cloudExadataInfrastructures' => [
        [
            'activatedStorageCount' => <integer>,
            'additionalStorageCount' => <integer>,
            'availabilityZone' => '<string>',
            'availabilityZoneId' => '<string>',
            'availableStorageSizeInGBs' => <integer>,
            'cloudExadataInfrastructureArn' => '<string>',
            'cloudExadataInfrastructureId' => '<string>',
            'computeCount' => <integer>,
            'computeModel' => 'ECPU|OCPU',
            'cpuCount' => <integer>,
            'createdAt' => <DateTime>,
            'customerContactsToSendToOCI' => [
                [
                    'email' => '<string>',
                ],
                // ...
            ],
            'dataStorageSizeInTBs' => <float>,
            'databaseServerType' => '<string>',
            'dbNodeStorageSizeInGBs' => <integer>,
            'dbServerVersion' => '<string>',
            'displayName' => '<string>',
            'lastMaintenanceRunId' => '<string>',
            'maintenanceWindow' => [
                'customActionTimeoutInMins' => <integer>,
                'daysOfWeek' => [
                    [
                        'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
                    ],
                    // ...
                ],
                'hoursOfDay' => [<integer>, ...],
                'isCustomActionTimeoutEnabled' => true || false,
                'leadTimeInWeeks' => <integer>,
                'months' => [
                    [
                        'name' => 'JANUARY|FEBRUARY|MARCH|APRIL|MAY|JUNE|JULY|AUGUST|SEPTEMBER|OCTOBER|NOVEMBER|DECEMBER',
                    ],
                    // ...
                ],
                'patchingMode' => 'ROLLING|NONROLLING',
                'preference' => 'NO_PREFERENCE|CUSTOM_PREFERENCE',
                'skipRu' => true || false,
                'weeksOfMonth' => [<integer>, ...],
            ],
            'maxCpuCount' => <integer>,
            'maxDataStorageInTBs' => <float>,
            'maxDbNodeStorageSizeInGBs' => <integer>,
            'maxMemoryInGBs' => <integer>,
            'memorySizeInGBs' => <integer>,
            'monthlyDbServerVersion' => '<string>',
            'monthlyStorageServerVersion' => '<string>',
            'nextMaintenanceRunId' => '<string>',
            'ociResourceAnchorName' => '<string>',
            'ociUrl' => '<string>',
            'ocid' => '<string>',
            'percentProgress' => <float>,
            'shape' => '<string>',
            'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
            'statusReason' => '<string>',
            'storageCount' => <integer>,
            'storageServerType' => '<string>',
            'storageServerVersion' => '<string>',
            'totalStorageSizeInGBs' => <integer>,
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
cloudExadataInfrastructures
Required: Yes
Type: Array of CloudExadataInfrastructureSummary structures

The list of Exadata infrastructures along with their properties.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ListCloudVmClusters

$result = $client->listCloudVmClusters([/* ... */]);
$promise = $client->listCloudVmClustersAsync([/* ... */]);

Returns information about the VM clusters owned by your Amazon Web Services account or only the ones on the specified Exadata infrastructure.

Parameter Syntax

$result = $client->listCloudVmClusters([
    'cloudExadataInfrastructureId' => '<string>',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
cloudExadataInfrastructureId
Type: string

The unique identifier of the Oracle Exadata infrastructure.

maxResults
Type: int

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.

Default: 10

nextToken
Type: string

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

Result Syntax

[
    'cloudVmClusters' => [
        [
            'cloudExadataInfrastructureArn' => '<string>',
            'cloudExadataInfrastructureId' => '<string>',
            'cloudVmClusterArn' => '<string>',
            'cloudVmClusterId' => '<string>',
            'clusterName' => '<string>',
            'computeModel' => 'ECPU|OCPU',
            'cpuCoreCount' => <integer>,
            'createdAt' => <DateTime>,
            'dataCollectionOptions' => [
                'isDiagnosticsEventsEnabled' => true || false,
                'isHealthMonitoringEnabled' => true || false,
                'isIncidentLogsEnabled' => true || false,
            ],
            'dataStorageSizeInTBs' => <float>,
            'dbNodeStorageSizeInGBs' => <integer>,
            'dbServers' => ['<string>', ...],
            'diskRedundancy' => 'HIGH|NORMAL',
            'displayName' => '<string>',
            'domain' => '<string>',
            'giVersion' => '<string>',
            'hostname' => '<string>',
            'iamRoles' => [
                [
                    'awsIntegration' => 'KmsTde',
                    'iamRoleArn' => '<string>',
                    'status' => 'ASSOCIATING|DISASSOCIATING|FAILED|CONNECTED|DISCONNECTED|PARTIALLY_CONNECTED|UNKNOWN',
                    'statusReason' => '<string>',
                ],
                // ...
            ],
            'iormConfigCache' => [
                'dbPlans' => [
                    [
                        'dbName' => '<string>',
                        'flashCacheLimit' => '<string>',
                        'share' => <integer>,
                    ],
                    // ...
                ],
                'lifecycleDetails' => '<string>',
                'lifecycleState' => 'BOOTSTRAPPING|DISABLED|ENABLED|FAILED|UPDATING',
                'objective' => 'AUTO|BALANCED|BASIC|HIGH_THROUGHPUT|LOW_LATENCY',
            ],
            'isLocalBackupEnabled' => true || false,
            'isSparseDiskgroupEnabled' => true || false,
            'lastUpdateHistoryEntryId' => '<string>',
            'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
            'listenerPort' => <integer>,
            'memorySizeInGBs' => <integer>,
            'nodeCount' => <integer>,
            'ociResourceAnchorName' => '<string>',
            'ociUrl' => '<string>',
            'ocid' => '<string>',
            'odbNetworkArn' => '<string>',
            'odbNetworkId' => '<string>',
            'percentProgress' => <float>,
            'scanDnsName' => '<string>',
            'scanDnsRecordId' => '<string>',
            'scanIpIds' => ['<string>', ...],
            'shape' => '<string>',
            'sshPublicKeys' => ['<string>', ...],
            'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
            'statusReason' => '<string>',
            'storageSizeInGBs' => <integer>,
            'systemVersion' => '<string>',
            'timeZone' => '<string>',
            'vipIds' => ['<string>', ...],
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
cloudVmClusters
Required: Yes
Type: Array of CloudVmClusterSummary structures

The list of VM clusters along with their properties.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ListDbNodes

$result = $client->listDbNodes([/* ... */]);
$promise = $client->listDbNodesAsync([/* ... */]);

Returns information about the DB nodes for the specified VM cluster.

Parameter Syntax

$result = $client->listDbNodes([
    'cloudVmClusterId' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
cloudVmClusterId
Required: Yes
Type: string

The unique identifier of the VM cluster.

maxResults
Type: int

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.

Default: 10

nextToken
Type: string

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

Result Syntax

[
    'dbNodes' => [
        [
            'additionalDetails' => '<string>',
            'backupIpId' => '<string>',
            'backupVnic2Id' => '<string>',
            'backupVnicId' => '<string>',
            'cpuCoreCount' => <integer>,
            'createdAt' => <DateTime>,
            'dbNodeArn' => '<string>',
            'dbNodeId' => '<string>',
            'dbNodeStorageSizeInGBs' => <integer>,
            'dbServerId' => '<string>',
            'dbSystemId' => '<string>',
            'faultDomain' => '<string>',
            'hostIpId' => '<string>',
            'hostname' => '<string>',
            'maintenanceType' => 'VMDB_REBOOT_MIGRATION',
            'memorySizeInGBs' => <integer>,
            'ociResourceAnchorName' => '<string>',
            'ocid' => '<string>',
            'softwareStorageSizeInGB' => <integer>,
            'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|STOPPING|STOPPED|STARTING',
            'statusReason' => '<string>',
            'timeMaintenanceWindowEnd' => '<string>',
            'timeMaintenanceWindowStart' => '<string>',
            'totalCpuCoreCount' => <integer>,
            'vnic2Id' => '<string>',
            'vnicId' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
dbNodes
Required: Yes
Type: Array of DbNodeSummary structures

The list of DB nodes along with their properties.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ListDbServers

$result = $client->listDbServers([/* ... */]);
$promise = $client->listDbServersAsync([/* ... */]);

Returns information about the database servers that belong to the specified Exadata infrastructure.

Parameter Syntax

$result = $client->listDbServers([
    'cloudExadataInfrastructureId' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier of the Oracle Exadata infrastructure.

maxResults
Type: int

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.

Default: 10

nextToken
Type: string

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

Result Syntax

[
    'dbServers' => [
        [
            'autonomousVirtualMachineIds' => ['<string>', ...],
            'autonomousVmClusterIds' => ['<string>', ...],
            'computeModel' => 'ECPU|OCPU',
            'cpuCoreCount' => <integer>,
            'createdAt' => <DateTime>,
            'dbNodeStorageSizeInGBs' => <integer>,
            'dbServerId' => '<string>',
            'dbServerPatchingDetails' => [
                'estimatedPatchDuration' => <integer>,
                'patchingStatus' => 'COMPLETE|FAILED|MAINTENANCE_IN_PROGRESS|SCHEDULED',
                'timePatchingEnded' => '<string>',
                'timePatchingStarted' => '<string>',
            ],
            'displayName' => '<string>',
            'exadataInfrastructureId' => '<string>',
            'maxCpuCount' => <integer>,
            'maxDbNodeStorageInGBs' => <integer>,
            'maxMemoryInGBs' => <integer>,
            'memorySizeInGBs' => <integer>,
            'ociResourceAnchorName' => '<string>',
            'ocid' => '<string>',
            'shape' => '<string>',
            'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
            'statusReason' => '<string>',
            'vmClusterIds' => ['<string>', ...],
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
dbServers
Required: Yes
Type: Array of DbServerSummary structures

The list of database servers along with their properties.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ListDbSystemShapes

$result = $client->listDbSystemShapes([/* ... */]);
$promise = $client->listDbSystemShapesAsync([/* ... */]);

Returns information about the shapes that are available for an Exadata infrastructure.

Parameter Syntax

$result = $client->listDbSystemShapes([
    'availabilityZone' => '<string>',
    'availabilityZoneId' => '<string>',
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
availabilityZone
Type: string

The logical name of the AZ, for example, us-east-1a. This name varies depending on the account.

availabilityZoneId
Type: string

The physical ID of the AZ, for example, use1-az4. This ID persists across accounts.

maxResults
Type: int

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.

Default: 10

nextToken
Type: string

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

Result Syntax

[
    'dbSystemShapes' => [
        [
            'areServerTypesSupported' => true || false,
            'availableCoreCount' => <integer>,
            'availableCoreCountPerNode' => <integer>,
            'availableDataStorageInTBs' => <integer>,
            'availableDataStoragePerServerInTBs' => <integer>,
            'availableDbNodePerNodeInGBs' => <integer>,
            'availableDbNodeStorageInGBs' => <integer>,
            'availableMemoryInGBs' => <integer>,
            'availableMemoryPerNodeInGBs' => <integer>,
            'computeModel' => 'ECPU|OCPU',
            'coreCountIncrement' => <integer>,
            'maxStorageCount' => <integer>,
            'maximumNodeCount' => <integer>,
            'minCoreCountPerNode' => <integer>,
            'minDataStorageInTBs' => <integer>,
            'minDbNodeStoragePerNodeInGBs' => <integer>,
            'minMemoryPerNodeInGBs' => <integer>,
            'minStorageCount' => <integer>,
            'minimumCoreCount' => <integer>,
            'minimumNodeCount' => <integer>,
            'name' => '<string>',
            'runtimeMinimumCoreCount' => <integer>,
            'shapeFamily' => '<string>',
            'shapeType' => 'AMD|INTEL|INTEL_FLEX_X9|AMPERE_FLEX_A1',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
dbSystemShapes
Required: Yes
Type: Array of DbSystemShapeSummary structures

The list of shapes and their properties.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ListGiVersions

$result = $client->listGiVersions([/* ... */]);
$promise = $client->listGiVersionsAsync([/* ... */]);

Returns information about Oracle Grid Infrastructure (GI) software versions that are available for a VM cluster for the specified shape.

Parameter Syntax

$result = $client->listGiVersions([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'shape' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

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.

Default: 10

nextToken
Type: string

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

shape
Type: string

The shape to return GI versions for. For a list of valid shapes, use the ListDbSystemShapes operation..

Result Syntax

[
    'giVersions' => [
        [
            'version' => '<string>',
        ],
        // ...
    ],
    'nextToken' => '<string>',
]

Result Details

Members
giVersions
Required: Yes
Type: Array of GiVersionSummary structures

The list of GI versions and their properties.

nextToken
Type: 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.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ListOdbNetworks

$result = $client->listOdbNetworks([/* ... */]);
$promise = $client->listOdbNetworksAsync([/* ... */]);

Returns information about the ODB networks owned by your Amazon Web Services account.

Parameter Syntax

$result = $client->listOdbNetworks([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

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.

Default: 10

nextToken
Type: string

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

Result Syntax

[
    'nextToken' => '<string>',
    'odbNetworks' => [
        [
            'availabilityZone' => '<string>',
            'availabilityZoneId' => '<string>',
            'backupSubnetCidr' => '<string>',
            'clientSubnetCidr' => '<string>',
            'createdAt' => <DateTime>,
            'customDomainName' => '<string>',
            'defaultDnsPrefix' => '<string>',
            'displayName' => '<string>',
            'ec2PlacementGroupIds' => ['<string>', ...],
            'managedServices' => [
                'crossRegionS3RestoreSourcesAccess' => [
                    [
                        'ipv4Addresses' => ['<string>', ...],
                        'region' => '<string>',
                        'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
                    ],
                    // ...
                ],
                'kmsAccess' => [
                    'domainName' => '<string>',
                    'ipv4Addresses' => ['<string>', ...],
                    'kmsPolicyDocument' => '<string>',
                    'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
                ],
                'managedS3BackupAccess' => [
                    'ipv4Addresses' => ['<string>', ...],
                    'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
                ],
                'managedServicesIpv4Cidrs' => ['<string>', ...],
                'resourceGatewayArn' => '<string>',
                's3Access' => [
                    'domainName' => '<string>',
                    'ipv4Addresses' => ['<string>', ...],
                    's3PolicyDocument' => '<string>',
                    'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
                ],
                'serviceNetworkArn' => '<string>',
                'serviceNetworkEndpoint' => [
                    'vpcEndpointId' => '<string>',
                    'vpcEndpointType' => 'SERVICENETWORK',
                ],
                'stsAccess' => [
                    'domainName' => '<string>',
                    'ipv4Addresses' => ['<string>', ...],
                    'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
                    'stsPolicyDocument' => '<string>',
                ],
                'zeroEtlAccess' => [
                    'cidr' => '<string>',
                    'status' => 'ENABLED|ENABLING|DISABLED|DISABLING',
                ],
            ],
            'ociDnsForwardingConfigs' => [
                [
                    'domainName' => '<string>',
                    'ociDnsListenerIp' => '<string>',
                ],
                // ...
            ],
            'ociNetworkAnchorId' => '<string>',
            'ociNetworkAnchorUrl' => '<string>',
            'ociResourceAnchorName' => '<string>',
            'ociVcnId' => '<string>',
            'ociVcnUrl' => '<string>',
            'odbNetworkArn' => '<string>',
            'odbNetworkId' => '<string>',
            'peeredCidrs' => ['<string>', ...],
            'percentProgress' => <float>,
            'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
            'statusReason' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: 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.

odbNetworks
Required: Yes
Type: Array of OdbNetworkSummary structures

The list of ODB networks.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ListOdbPeeringConnections

$result = $client->listOdbPeeringConnections([/* ... */]);
$promise = $client->listOdbPeeringConnectionsAsync([/* ... */]);

Lists all ODB peering connections or those associated with a specific ODB network.

Parameter Syntax

$result = $client->listOdbPeeringConnections([
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'odbNetworkId' => '<string>',
]);

Parameter Details

Members
maxResults
Type: int

The maximum number of ODB peering connections to return in the response.

Default: 20

Constraints:

  • Must be between 1 and 100.

nextToken
Type: string

The pagination token for the next page of ODB peering connections.

odbNetworkId
Type: string

The identifier of the ODB network to list peering connections for.

If not specified, lists all ODB peering connections in the account.

Result Syntax

[
    'nextToken' => '<string>',
    'odbPeeringConnections' => [
        [
            'createdAt' => <DateTime>,
            'displayName' => '<string>',
            'odbNetworkArn' => '<string>',
            'odbPeeringConnectionArn' => '<string>',
            'odbPeeringConnectionId' => '<string>',
            'odbPeeringConnectionType' => '<string>',
            'peerNetworkArn' => '<string>',
            'peerNetworkCidrs' => ['<string>', ...],
            'percentProgress' => <float>,
            'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
            'statusReason' => '<string>',
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: string

The pagination token for the next page of ODB peering connections.

odbPeeringConnections
Required: Yes
Type: Array of OdbPeeringConnectionSummary structures

The list of ODB peering connections.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ListSystemVersions

$result = $client->listSystemVersions([/* ... */]);
$promise = $client->listSystemVersionsAsync([/* ... */]);

Returns information about the system versions that are available for a VM cluster for the specified giVersion and shape.

Parameter Syntax

$result = $client->listSystemVersions([
    'giVersion' => '<string>', // REQUIRED
    'maxResults' => <integer>,
    'nextToken' => '<string>',
    'shape' => '<string>', // REQUIRED
]);

Parameter Details

Members
giVersion
Required: Yes
Type: string

The software version of the Exadata Grid Infrastructure (GI).

maxResults
Type: int

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.

Default: 10

nextToken
Type: string

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

shape
Required: Yes
Type: string

The Exadata hardware system model.

Result Syntax

[
    'nextToken' => '<string>',
    'systemVersions' => [
        [
            'giVersion' => '<string>',
            'shape' => '<string>',
            'systemVersions' => ['<string>', ...],
        ],
        // ...
    ],
]

Result Details

Members
nextToken
Type: 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.

systemVersions
Required: Yes
Type: Array of SystemVersionSummary structures

The list of system versions.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ListTagsForResource

$result = $client->listTagsForResource([/* ... */]);
$promise = $client->listTagsForResourceAsync([/* ... */]);

Returns information about the tags applied to this resource.

Parameter Syntax

$result = $client->listTagsForResource([
    'resourceArn' => '<string>', // REQUIRED
]);

Parameter Details

Members
resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the resource to list tags for.

Result Syntax

[
    'tags' => ['<string>', ...],
]

Result Details

Members
tags
Type: Associative array of custom strings keys (TagKey) to strings

The list of tags applied to the resource.

Errors

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

RebootAutonomousDatabase

$result = $client->rebootAutonomousDatabase([/* ... */]);
$promise = $client->rebootAutonomousDatabaseAsync([/* ... */]);

Reboots the specified Autonomous Database.

Parameter Syntax

$result = $client->rebootAutonomousDatabase([
    'autonomousDatabaseId' => '<string>', // REQUIRED
    'isOnlineReboot' => true || false,
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to reboot.

isOnlineReboot
Type: boolean

Specifies whether to perform an online reboot of the Autonomous Database without interrupting active connections.

Result 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>',
]

Result Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database that was rebooted.

displayName
Type: string

The user-friendly name of the Autonomous Database.

status
Type: string

The current status of the Autonomous Database after the reboot operation.

statusReason
Type: string

Additional information about the status of the Autonomous Database after the reboot operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

RebootDbNode

$result = $client->rebootDbNode([/* ... */]);
$promise = $client->rebootDbNodeAsync([/* ... */]);

Reboots the specified DB node in a VM cluster.

Parameter Syntax

$result = $client->rebootDbNode([
    'cloudVmClusterId' => '<string>', // REQUIRED
    'dbNodeId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudVmClusterId
Required: Yes
Type: string

The unique identifier of the VM cluster that contains the DB node to reboot.

dbNodeId
Required: Yes
Type: string

The unique identifier of the DB node to reboot.

Result Syntax

[
    'dbNodeId' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|STOPPING|STOPPED|STARTING',
    'statusReason' => '<string>',
]

Result Details

Members
dbNodeId
Required: Yes
Type: string

The unique identifier of the DB node that was rebooted.

status
Type: string

The current status of the DB node after the reboot operation.

statusReason
Type: string

Additional information about the status of the DB node after the reboot operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

RestoreAutonomousDatabase

$result = $client->restoreAutonomousDatabase([/* ... */]);
$promise = $client->restoreAutonomousDatabaseAsync([/* ... */]);

Restores the specified Autonomous Database to a point in time.

Parameter Syntax

$result = $client->restoreAutonomousDatabase([
    'autonomousDatabaseId' => '<string>', // REQUIRED
    'timestamp' => <integer || string || DateTime>, // REQUIRED
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to restore.

timestamp
Required: Yes
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time to which to restore the Autonomous Database.

Result 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>',
]

Result Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database that was restored.

displayName
Type: string

The user-friendly name of the Autonomous Database.

status
Type: string

The current status of the Autonomous Database after the restore operation.

statusReason
Type: string

Additional information about the status of the Autonomous Database after the restore operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

ShrinkAutonomousDatabase

$result = $client->shrinkAutonomousDatabase([/* ... */]);
$promise = $client->shrinkAutonomousDatabaseAsync([/* ... */]);

Shrinks the storage of the specified Autonomous Database to reclaim unused space.

Parameter Syntax

$result = $client->shrinkAutonomousDatabase([
    'autonomousDatabaseId' => '<string>', // REQUIRED
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to shrink.

Result 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>',
]

Result Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database that was shrunk.

displayName
Type: string

The user-friendly name of the Autonomous Database.

status
Type: string

The current status of the Autonomous Database after the shrink operation.

statusReason
Type: string

Additional information about the status of the Autonomous Database after the shrink operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

StartAutonomousDatabase

$result = $client->startAutonomousDatabase([/* ... */]);
$promise = $client->startAutonomousDatabaseAsync([/* ... */]);

Starts the specified Autonomous Database.

Parameter Syntax

$result = $client->startAutonomousDatabase([
    'autonomousDatabaseId' => '<string>', // REQUIRED
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to start.

Result 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>',
]

Result Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database that was started.

displayName
Type: string

The user-friendly name of the Autonomous Database.

status
Type: string

The current status of the Autonomous Database after the start operation.

statusReason
Type: string

Additional information about the status of the Autonomous Database after the start operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

StartDbNode

$result = $client->startDbNode([/* ... */]);
$promise = $client->startDbNodeAsync([/* ... */]);

Starts the specified DB node in a VM cluster.

Parameter Syntax

$result = $client->startDbNode([
    'cloudVmClusterId' => '<string>', // REQUIRED
    'dbNodeId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudVmClusterId
Required: Yes
Type: string

The unique identifier of the VM cluster that contains the DB node to start.

dbNodeId
Required: Yes
Type: string

The unique identifier of the DB node to start.

Result Syntax

[
    'dbNodeId' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|STOPPING|STOPPED|STARTING',
    'statusReason' => '<string>',
]

Result Details

Members
dbNodeId
Required: Yes
Type: string

The unique identifier of the DB node that was started.

status
Type: string

The current status of the DB node after the start operation.

statusReason
Type: string

Additional information about the status of the DB node after the start operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

StopAutonomousDatabase

$result = $client->stopAutonomousDatabase([/* ... */]);
$promise = $client->stopAutonomousDatabaseAsync([/* ... */]);

Stops the specified Autonomous Database.

Parameter Syntax

$result = $client->stopAutonomousDatabase([
    'autonomousDatabaseId' => '<string>', // REQUIRED
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to stop.

Result 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>',
]

Result Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database that was stopped.

displayName
Type: string

The user-friendly name of the Autonomous Database.

status
Type: string

The current status of the Autonomous Database after the stop operation.

statusReason
Type: string

Additional information about the status of the Autonomous Database after the stop operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

StopDbNode

$result = $client->stopDbNode([/* ... */]);
$promise = $client->stopDbNodeAsync([/* ... */]);

Stops the specified DB node in a VM cluster.

Parameter Syntax

$result = $client->stopDbNode([
    'cloudVmClusterId' => '<string>', // REQUIRED
    'dbNodeId' => '<string>', // REQUIRED
]);

Parameter Details

Members
cloudVmClusterId
Required: Yes
Type: string

The unique identifier of the VM cluster that contains the DB node to stop.

dbNodeId
Required: Yes
Type: string

The unique identifier of the DB node to stop.

Result Syntax

[
    'dbNodeId' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|STOPPING|STOPPED|STARTING',
    'statusReason' => '<string>',
]

Result Details

Members
dbNodeId
Required: Yes
Type: string

The unique identifier of the DB node that was stopped.

status
Type: string

The current status of the DB node after the stop operation.

statusReason
Type: string

Additional information about the status of the DB node after the stop operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

SwitchoverAutonomousDatabase

$result = $client->switchoverAutonomousDatabase([/* ... */]);
$promise = $client->switchoverAutonomousDatabaseAsync([/* ... */]);

Performs a switchover of the specified Autonomous Database to a standby peer database.

Parameter Syntax

$result = $client->switchoverAutonomousDatabase([
    'autonomousDatabaseId' => '<string>', // REQUIRED
    'peerDbArn' => '<string>',
]);

Parameter Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to switch over.

peerDbArn
Type: string

The Amazon Resource Name (ARN) of the peer Autonomous Database to switch over to.

Result 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>',
]

Result Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database that was switched over.

displayName
Type: string

The user-friendly name of the Autonomous Database.

status
Type: string

The current status of the Autonomous Database after the switchover operation.

statusReason
Type: string

Additional information about the status of the Autonomous Database after the switchover operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

TagResource

$result = $client->tagResource([/* ... */]);
$promise = $client->tagResourceAsync([/* ... */]);

Applies tags to the specified resource.

Parameter Syntax

$result = $client->tagResource([
    'resourceArn' => '<string>', // REQUIRED
    'tags' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the resource to apply tags to.

tags
Required: Yes
Type: Associative array of custom strings keys (TagKey) to strings

The list of tags to apply to the resource.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ServiceQuotaExceededException:

You have exceeded the service quota.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

UntagResource

$result = $client->untagResource([/* ... */]);
$promise = $client->untagResourceAsync([/* ... */]);

Removes tags from the specified resource.

Parameter Syntax

$result = $client->untagResource([
    'resourceArn' => '<string>', // REQUIRED
    'tagKeys' => ['<string>', ...], // REQUIRED
]);

Parameter Details

Members
resourceArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the resource to remove tags from.

tagKeys
Required: Yes
Type: Array of strings

The names (keys) of the tags to remove from the resource.

Result Syntax

[]

Result Details

The results for this operation are always empty.

Errors

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

UpdateAutonomousDatabase

$result = $client->updateAutonomousDatabase([/* ... */]);
$promise = $client->updateAutonomousDatabaseAsync([/* ... */]);

Updates the properties of an Autonomous Database.

Parameter Syntax

$result = $client->updateAutonomousDatabase([
    'adminPassword' => '<string>',
    'allowlistedIps' => ['<string>', ...],
    'autoRefreshFrequencyInSeconds' => <integer>,
    'autoRefreshPointLagInSeconds' => <integer>,
    'autonomousDatabaseId' => '<string>', // REQUIRED
    'autonomousMaintenanceScheduleType' => 'EARLY|REGULAR',
    'backupRetentionPeriodInDays' => <integer>,
    'byolComputeCountLimit' => <float>,
    'computeCount' => <float>,
    'cpuCoreCount' => <integer>,
    'customerContactsToSendToOCI' => [
        [
            'email' => '<string>',
        ],
        // ...
    ],
    'dataStorageSizeInGBs' => <integer>,
    'dataStorageSizeInTBs' => <integer>,
    'databaseEdition' => 'STANDARD_EDITION|ENTERPRISE_EDITION',
    'dbName' => '<string>',
    'dbToolsDetails' => [
        [
            'computeCount' => <float>,
            'isEnabled' => true || false,
            'maxIdleTimeInMinutes' => <integer>,
            'name' => '<string>',
        ],
        // ...
    ],
    'dbVersion' => '<string>',
    'dbWorkload' => 'OLTP|AJD|APEX|LH',
    'displayName' => '<string>',
    'encryptionKeyConfiguration' => [
        'awsEncryptionKey' => [
            'externalIdType' => 'database_ocid|compartment_ocid|tenant_ocid',
            'iamRoleArn' => '<string>',
            'kmsKeyId' => '<string>',
        ],
    ],
    'encryptionKeyProvider' => 'ORACLE_MANAGED|AWS_KMS',
    'isAutoScalingEnabled' => true || false,
    'isAutoScalingForStorageEnabled' => true || false,
    'isBackupRetentionLocked' => true || false,
    'isDisconnectPeer' => true || false,
    'isLocalDataGuardEnabled' => true || false,
    'isMtlsConnectionRequired' => true || false,
    'isRefreshableClone' => true || false,
    'licenseModel' => 'BRING_YOUR_OWN_LICENSE|LICENSE_INCLUDED',
    'localAdgAutoFailoverMaxDataLossLimit' => <integer>,
    'longTermBackupSchedule' => [
        'isDisabled' => true || false,
        'repeatCadence' => 'ONE_TIME|WEEKLY|MONTHLY|YEARLY',
        'retentionPeriodInDays' => <integer>,
        'timeOfBackup' => <integer || string || DateTime>,
    ],
    'openMode' => 'READ_ONLY|READ_WRITE',
    'peerDbId' => '<string>',
    'permissionLevel' => 'RESTRICTED|UNRESTRICTED',
    'privateEndpointIp' => '<string>',
    'privateEndpointLabel' => '<string>',
    'refreshableMode' => 'AUTOMATIC|MANUAL',
    'resourcePoolLeaderId' => '<string>',
    'resourcePoolSummary' => [
        'availableComputeCapacity' => <integer>,
        'availableStorageCapacityInTBs' => <float>,
        'isDisabled' => true || false,
        'poolSize' => <integer>,
        'poolStorageSizeInTBs' => <integer>,
        'totalComputeCapacity' => <integer>,
    ],
    'scheduledOperations' => [
        [
            'dayOfWeek' => [ // REQUIRED
                'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
            ],
            'scheduledStartTime' => '<string>',
            'scheduledStopTime' => '<string>',
        ],
        // ...
    ],
    'standbyAllowlistedIps' => ['<string>', ...],
    'standbyAllowlistedIpsSource' => 'PRIMARY|SEPARATE|NOT_APPLICABLE',
    'timeOfAutoRefreshStart' => <integer || string || DateTime>,
]);

Parameter Details

Members
adminPassword
Type: string

The new password for the ADMIN user of the Autonomous Database.

allowlistedIps
Type: Array of strings

The list of IP addresses that are allowed to access the Autonomous Database.

autoRefreshFrequencyInSeconds
Type: int

The frequency, in seconds, at which the refreshable clone Autonomous Database is automatically refreshed.

autoRefreshPointLagInSeconds
Type: int

The time lag, in seconds, between the refreshable clone and its source Autonomous Database.

autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database to update.

autonomousMaintenanceScheduleType
Type: string

The maintenance schedule type for the Autonomous Database.

backupRetentionPeriodInDays
Type: int

The retention period, in days, for automatic backups of the Autonomous Database.

byolComputeCountLimit
Type: double

The maximum number of compute resources that you can allocate to the Autonomous Database under the bring-your-own-license (BYOL) model.

computeCount
Type: double

The compute capacity, in number of ECPUs or OCPUs, to assign to the Autonomous Database.

cpuCoreCount
Type: int

The number of CPU cores to allocate to the Autonomous Database.

customerContactsToSendToOCI
Type: Array of CustomerContact structures

The list of customer contacts to receive operational notifications from OCI for the Autonomous Database.

dataStorageSizeInGBs
Type: int

The size, in gigabytes (GB), of the data volume to allocate for the Autonomous Database.

dataStorageSizeInTBs
Type: int

The size, in terabytes (TB), of the data volume to allocate for the Autonomous Database.

databaseEdition
Type: string

The Oracle Database edition to apply to the Autonomous Database.

dbName
Type: string

The new name of the Autonomous Database.

dbToolsDetails
Type: Array of DatabaseTool structures

The list of database management tools to enable for the Autonomous Database.

dbVersion
Type: string

The Oracle Database software version to use for the Autonomous Database.

dbWorkload
Type: string

The intended use of the Autonomous Database, such as transaction processing, data warehouse, JSON database, or APEX.

displayName
Type: string

The new user-friendly name for the Autonomous Database.

encryptionKeyConfiguration

The configuration of the encryption key to use for the Autonomous Database.

encryptionKeyProvider
Type: string

The provider of the encryption key to use for the Autonomous Database.

isAutoScalingEnabled
Type: boolean

Specifies whether to enable automatic scaling of the compute resources for the Autonomous Database.

isAutoScalingForStorageEnabled
Type: boolean

Specifies whether to enable automatic scaling of the storage for the Autonomous Database.

isBackupRetentionLocked
Type: boolean

Specifies whether to lock the backup retention period of the Autonomous Database to prevent it from being shortened.

isDisconnectPeer
Type: boolean

Specifies whether to disconnect the Autonomous Database from its peer database.

isLocalDataGuardEnabled
Type: boolean

Specifies whether to enable local Oracle Data Guard for the Autonomous Database.

isMtlsConnectionRequired
Type: boolean

Specifies whether mutual TLS (mTLS) authentication is required to connect to the Autonomous Database.

isRefreshableClone
Type: boolean

Specifies whether the Autonomous Database is a refreshable clone.

licenseModel
Type: string

The Oracle license model to apply to the Autonomous Database.

localAdgAutoFailoverMaxDataLossLimit
Type: int

The maximum data loss limit, in seconds, for automatic failover to the local Oracle Data Guard standby database.

longTermBackupSchedule
Type: LongTermBackupSchedule structure

The long-term backup schedule for the Autonomous Database.

openMode
Type: string

The mode in which to open the Autonomous Database, either read-only or read/write.

peerDbId
Type: string

The unique identifier of the peer Autonomous Database.

permissionLevel
Type: string

The permission level of the Autonomous Database.

privateEndpointIp
Type: string

The private endpoint IP address for the Autonomous Database.

privateEndpointLabel
Type: string

The private endpoint label for the Autonomous Database.

refreshableMode
Type: string

The refresh mode of the refreshable clone Autonomous Database.

resourcePoolLeaderId
Type: string

The unique identifier of the resource pool leader Autonomous Database.

resourcePoolSummary
Type: ResourcePoolSummary structure

The configuration of the resource pool for the Autonomous Database.

scheduledOperations
Type: Array of ScheduledOperationDetails structures

The list of scheduled start and stop times for the Autonomous Database.

standbyAllowlistedIps
Type: Array of strings

The list of IP addresses that are allowed to access the standby Autonomous Database.

standbyAllowlistedIpsSource
Type: string

The source of the allowlisted IP addresses for the standby Autonomous Database.

timeOfAutoRefreshStart
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time at which the automatic refresh of the refreshable clone Autonomous Database starts.

Result 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>',
]

Result Details

Members
autonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the Autonomous Database that was updated.

displayName
Type: string

The user-friendly name of the Autonomous Database that was updated.

status
Type: string

The current status of the Autonomous Database.

statusReason
Type: string

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

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

UpdateAutonomousDatabaseBackup

$result = $client->updateAutonomousDatabaseBackup([/* ... */]);
$promise = $client->updateAutonomousDatabaseBackupAsync([/* ... */]);

Updates the properties of an Autonomous Database backup.

Parameter Syntax

$result = $client->updateAutonomousDatabaseBackup([
    'autonomousDatabaseBackupId' => '<string>', // REQUIRED
    'retentionPeriodInDays' => <integer>,
]);

Parameter Details

Members
autonomousDatabaseBackupId
Required: Yes
Type: string

The unique identifier of the Autonomous Database backup to update.

retentionPeriodInDays
Type: int

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

Result Syntax

[
    'autonomousDatabaseBackupId' => '<string>',
    'displayName' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
    'statusReason' => '<string>',
]

Result Details

Members
autonomousDatabaseBackupId
Required: Yes
Type: string

The unique identifier of the Autonomous Database backup that was updated.

displayName
Type: string

The user-friendly name of the Autonomous Database backup.

status
Type: string

The current status of the Autonomous Database backup.

statusReason
Type: string

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

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

UpdateCloudExadataInfrastructure

$result = $client->updateCloudExadataInfrastructure([/* ... */]);
$promise = $client->updateCloudExadataInfrastructureAsync([/* ... */]);

Updates the properties of an Exadata infrastructure resource.

Parameter Syntax

$result = $client->updateCloudExadataInfrastructure([
    'cloudExadataInfrastructureId' => '<string>', // REQUIRED
    'maintenanceWindow' => [
        'customActionTimeoutInMins' => <integer>,
        'daysOfWeek' => [
            [
                'name' => 'MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY',
            ],
            // ...
        ],
        'hoursOfDay' => [<integer>, ...],
        'isCustomActionTimeoutEnabled' => true || false,
        'leadTimeInWeeks' => <integer>,
        'months' => [
            [
                'name' => 'JANUARY|FEBRUARY|MARCH|APRIL|MAY|JUNE|JULY|AUGUST|SEPTEMBER|OCTOBER|NOVEMBER|DECEMBER',
            ],
            // ...
        ],
        'patchingMode' => 'ROLLING|NONROLLING',
        'preference' => 'NO_PREFERENCE|CUSTOM_PREFERENCE',
        'skipRu' => true || false,
        'weeksOfMonth' => [<integer>, ...],
    ],
]);

Parameter Details

Members
cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier of the Exadata infrastructure to update.

maintenanceWindow
Type: MaintenanceWindow structure

The scheduling details for the maintenance window. Patching and system updates take place during the maintenance window.

Result Syntax

[
    'cloudExadataInfrastructureId' => '<string>',
    'displayName' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
    'statusReason' => '<string>',
]

Result Details

Members
cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier of the updated Exadata infrastructure.

displayName
Type: string

The user-friendly name of the updated Exadata infrastructure.

status
Type: string

The current status of the Exadata infrastructure after the update operation.

statusReason
Type: string

Additional information about the status of the Exadata infrastructure after the update operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

UpdateOdbNetwork

$result = $client->updateOdbNetwork([/* ... */]);
$promise = $client->updateOdbNetworkAsync([/* ... */]);

Updates properties of a specified ODB network.

Parameter Syntax

$result = $client->updateOdbNetwork([
    'crossRegionS3RestoreSourcesToDisable' => ['<string>', ...],
    'crossRegionS3RestoreSourcesToEnable' => ['<string>', ...],
    'displayName' => '<string>',
    'kmsAccess' => 'ENABLED|DISABLED',
    'kmsPolicyDocument' => '<string>',
    'odbNetworkId' => '<string>', // REQUIRED
    'peeredCidrsToBeAdded' => ['<string>', ...],
    'peeredCidrsToBeRemoved' => ['<string>', ...],
    's3Access' => 'ENABLED|DISABLED',
    's3PolicyDocument' => '<string>',
    'stsAccess' => 'ENABLED|DISABLED',
    'stsPolicyDocument' => '<string>',
    'zeroEtlAccess' => 'ENABLED|DISABLED',
]);

Parameter Details

Members
crossRegionS3RestoreSourcesToDisable
Type: Array of strings

The cross-Region Amazon S3 restore sources to disable for the ODB network.

crossRegionS3RestoreSourcesToEnable
Type: Array of strings

The cross-Region Amazon S3 restore sources to enable for the ODB network.

displayName
Type: string

The new user-friendly name of the ODB network.

kmsAccess
Type: string

The Amazon Web Services Key Management Service (KMS) access configuration for the ODB network.

kmsPolicyDocument
Type: string

The Amazon Web Services Key Management Service (KMS) policy document that defines permissions for key usage within the ODB network.

odbNetworkId
Required: Yes
Type: string

The unique identifier of the ODB network to update.

peeredCidrsToBeAdded
Type: Array of strings

The list of CIDR ranges from the peered VPC that allow access to the ODB network.

peeredCidrsToBeRemoved
Type: Array of strings

The list of CIDR ranges from the peered VPC to remove from the ODB network.

s3Access
Type: string

Specifies the updated configuration for Amazon S3 access from the ODB network.

s3PolicyDocument
Type: string

Specifies the updated endpoint policy for Amazon S3 access from the ODB network.

stsAccess
Type: string

The Amazon Web Services Security Token Service (STS) access configuration for the ODB network.

stsPolicyDocument
Type: string

The Amazon Web Services Security Token Service (STS) policy document that defines permissions for token service usage within the ODB network.

zeroEtlAccess
Type: string

Specifies the updated configuration for Zero-ETL access from the ODB network.

Result Syntax

[
    'displayName' => '<string>',
    'odbNetworkId' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
    'statusReason' => '<string>',
]

Result Details

Members
displayName
Type: string

The user-friendly name of the ODB network.

odbNetworkId
Required: Yes
Type: string

The unique identifier of the ODB network.

status
Type: string

The current status of the ODB network.

statusReason
Type: string

Additional information about the status of the ODB network.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

UpdateOdbPeeringConnection

$result = $client->updateOdbPeeringConnection([/* ... */]);
$promise = $client->updateOdbPeeringConnectionAsync([/* ... */]);

Modifies the settings of an Oracle Database@Amazon Web Services peering connection. You can update the display name and add or remove CIDR blocks from the peering connection.

Parameter Syntax

$result = $client->updateOdbPeeringConnection([
    'displayName' => '<string>',
    'odbPeeringConnectionId' => '<string>', // REQUIRED
    'peerNetworkCidrsToBeAdded' => ['<string>', ...],
    'peerNetworkCidrsToBeRemoved' => ['<string>', ...],
]);

Parameter Details

Members
displayName
Type: string

A new display name for the peering connection.

odbPeeringConnectionId
Required: Yes
Type: string

The identifier of the Oracle Database@Amazon Web Services peering connection to update.

peerNetworkCidrsToBeAdded
Type: Array of strings

A list of CIDR blocks to add to the peering connection. These CIDR blocks define the IP address ranges that can communicate through the peering connection. The CIDR blocks must not overlap with existing CIDR blocks in the Oracle Database@Amazon Web Services network.

peerNetworkCidrsToBeRemoved
Type: Array of strings

A list of CIDR blocks to remove from the peering connection. The CIDR blocks must currently exist in the peering connection.

Result Syntax

[
    'displayName' => '<string>',
    'odbPeeringConnectionId' => '<string>',
    'status' => 'AVAILABLE|FAILED|PROVISIONING|TERMINATED|TERMINATING|UPDATING|MAINTENANCE_IN_PROGRESS',
    'statusReason' => '<string>',
]

Result Details

Members
displayName
Type: string

The display name of the peering connection.

odbPeeringConnectionId
Required: Yes
Type: string

The identifier of the Oracle Database@Amazon Web Services peering connection that was updated.

status
Type: string

The status of the peering connection update operation.

statusReason
Type: string

Additional information about the status of the peering connection update operation.

Errors

ThrottlingException:

The request was denied due to request throttling.

ValidationException:

The request has failed validation because it is missing required fields or has invalid inputs.

ConflictException:

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

AccessDeniedException:

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

InternalServerException:

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

ResourceNotFoundException:

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

Shapes

AccessDeniedException

Description

You don't have sufficient access to perform this action. Make sure you have the required permissions and try again.

Members
message
Required: Yes
Type: string

AutonomousDatabase

Description

Information about an Autonomous Database.

Members
actualUsedDataStorageSizeInTBs
Type: double

The actual amount of data storage currently in use by the Autonomous Database, in TB.

allocatedStorageSizeInTBs
Type: double

The amount of storage currently allocated to the Autonomous Database, in TB.

allowlistedIps
Type: Array of strings

The list of IP addresses that are allowed to access the Autonomous Database.

apexDetails
Type: AutonomousDatabaseApex structure

The Oracle Application Express (APEX) details for the Autonomous Database.

autoRefreshFrequencyInSeconds
Type: int

The frequency, in seconds, at which the refreshable clone Autonomous Database is automatically refreshed.

autoRefreshPointLagInSeconds
Type: int

The time lag, in seconds, between the refreshable clone and its source Autonomous Database.

autonomousDatabaseArn
Type: string

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

autonomousDatabaseId
Type: string

The unique identifier of the Autonomous Database.

autonomousMaintenanceScheduleType
Type: string

The maintenance schedule type for the Autonomous Database.

availabilityZone
Type: string

The Availability Zone where the Autonomous Database is located.

availabilityZoneId
Type: string

The unique identifier of the Availability Zone where the Autonomous Database is located.

availableUpgradeVersions
Type: Array of strings

The list of Oracle Database software versions to which the Autonomous Database can be upgraded.

backupRetentionPeriodInDays
Type: int

The retention period, in days, for automatic backups of the Autonomous Database.

byolComputeCountLimit
Type: int

The maximum number of compute resources that you can allocate to the Autonomous Database under the bring-your-own-license (BYOL) model.

characterSet
Type: string

The character set of the Autonomous Database.

cloneTableSpaceList
Type: Array of ints

The list of tablespace identifiers to clone for the Autonomous Database.

computeCount
Type: float

The compute capacity, in number of Elastic CPUs (ECPUs) or Oracle CPUs (OCPUs), assigned to the Autonomous Database.

computeModel
Type: string

The compute model of the Autonomous Database, either ECPU or OCPU.

connectionStringDetails

The connection string details for the Autonomous Database.

connectionUrls

The connection URLs for accessing tools and services for the Autonomous Database.

cpuCoreCount
Type: int

The number of CPU cores allocated to the Autonomous Database.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous Database was created.

customerContacts
Type: Array of CustomerContact structures

The list of customer contacts that receive operational notifications from Oracle for the Autonomous Database.

dataSafeStatus
Type: string

The status of the Oracle Data Safe registration for the Autonomous Database.

dataStorageSizeInGBs
Type: int

The size, in gigabytes (GB), of the data volume allocated for the Autonomous Database.

dataStorageSizeInTBs
Type: double

The size, in terabytes (TB), of the data volume allocated for the Autonomous Database.

databaseEdition
Type: string

The Oracle Database edition of the Autonomous Database.

databaseManagementStatus
Type: string

The status of Oracle Database Management for the Autonomous Database.

databaseType
Type: string

The type of the Autonomous Database, either a regular database or a clone.

dbName
Type: string

The name of the Autonomous Database.

dbToolsDetails
Type: Array of DatabaseTool structures

The list of database management tools enabled for the Autonomous Database.

dbVersion
Type: string

The Oracle Database software version of the Autonomous Database.

dbWorkload
Type: string

The intended use of the Autonomous Database, such as transaction processing, data warehouse, JSON database, or APEX.

displayName
Type: string

The user-friendly name of the Autonomous Database.

encryptionSummary
Type: EncryptionSummary structure

The encryption configuration for the Autonomous Database.

failedDataRecoveryInSeconds
Type: int

The amount of time, in seconds, that the data in the Autonomous Database is behind the data in the primary database.

inMemoryAreaInGBs
Type: int

The size of the in-memory area of the Autonomous Database, in GB.

isAutoScalingEnabled
Type: boolean

Indicates whether automatic scaling of the compute resources is enabled for the Autonomous Database.

isAutoScalingForStorageEnabled
Type: boolean

Indicates whether automatic scaling of the storage is enabled for the Autonomous Database.

isBackupRetentionLocked
Type: boolean

Indicates whether the backup retention period of the Autonomous Database is locked.

isLocalDataGuardEnabled
Type: boolean

Indicates whether local Oracle Data Guard is enabled for the Autonomous Database.

isMtlsConnectionRequired
Type: boolean

Indicates whether mutual TLS (mTLS) authentication is required to connect to the Autonomous Database.

isReconnectCloneEnabled
Type: boolean

Indicates whether reconnecting the refreshable clone to its source Autonomous Database is enabled.

isRefreshableClone
Type: boolean

Indicates whether the Autonomous Database is a refreshable clone.

isRemoteDataGuardEnabled
Type: boolean

Indicates whether remote Oracle Data Guard is enabled for the Autonomous Database.

licenseModel
Type: string

The Oracle license model that applies to the Autonomous Database.

localAdgAutoFailoverMaxDataLossLimit
Type: int

The maximum data loss limit, in seconds, for automatic failover to the local Oracle Data Guard standby database.

localDisasterRecoveryType
Type: string

The type of local disaster recovery configured for the Autonomous Database.

localStandbyDb
Type: DatabaseStandbySummary structure

The details of the local standby Autonomous Database in an Oracle Data Guard configuration.

longTermBackupSchedule
Type: LongTermBackupSchedule structure

The long-term backup schedule for the Autonomous Database.

maintenanceTargetComponent
Type: string

The component on the Autonomous Database that the current maintenance is being applied to.

memoryPerOracleComputeUnitInGBs
Type: int

The amount of memory allocated per Oracle Compute Unit, in GB.

ncharacterSet
Type: string

The national character set of the Autonomous Database.

netServicesArchitecture
Type: string

The Oracle Net Services architecture of the Autonomous Database, either dedicated or shared.

nextLongTermBackupTimeStamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the next scheduled long-term backup of the Autonomous Database.

ociResourceAnchorName
Type: string

The name of the Oracle Cloud Infrastructure (OCI) resource anchor associated with the Autonomous Database.

ociUrl
Type: string

The URL for accessing the OCI console page for the Autonomous Database.

ocid
Type: string

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

odbNetworkArn
Type: string

The Amazon Resource Name (ARN) of the ODB network associated with the Autonomous Database.

odbNetworkId
Type: string

The unique identifier of the ODB network associated with the Autonomous Database.

openMode
Type: string

The mode in which the Autonomous Database is open, either read-only or read/write.

operationsInsightsStatus
Type: string

The status of Oracle Operations Insights for the Autonomous Database.

peerDbIds
Type: Array of strings

The list of unique identifiers of the peer Autonomous Databases.

percentProgress
Type: float

The progress of the current operation on the Autonomous Database, as a percentage.

permissionLevel
Type: string

The permission level of the Autonomous Database.

privateEndpoint
Type: string

The private endpoint for the Autonomous Database.

privateEndpointIp
Type: string

The private endpoint IP address for the Autonomous Database.

privateEndpointLabel
Type: string

The private endpoint label for the Autonomous Database.

provisionableCpus
Type: Array of ints

The list of CPU core counts that you can provision for the Autonomous Database.

refreshableMode
Type: string

The refresh mode of the refreshable clone Autonomous Database.

refreshableStatus
Type: string

The refresh status of the refreshable clone Autonomous Database.

remoteDisasterRecoveryConfiguration

The configuration of the remote disaster recovery for the Autonomous Database.

resourcePoolLeaderId
Type: string

The unique identifier of the resource pool leader Autonomous Database.

resourcePoolSummary
Type: ResourcePoolSummary structure

The configuration of the resource pool for the Autonomous Database.

role
Type: string

The Oracle Data Guard role of the Autonomous Database.

scheduledOperations
Type: Array of ScheduledOperationDetails structures

The list of scheduled start and stop times for the Autonomous Database.

serviceConsoleUrl
Type: string

The URL for accessing the Oracle service console for the Autonomous Database.

sourceId
Type: string

The unique identifier of the source from which the Autonomous Database was created.

sqlWebDeveloperUrl
Type: string

The URL for accessing Oracle SQL Developer Web for the Autonomous Database.

standbyAllowlistedIps
Type: Array of strings

The list of IP addresses that are allowed to access the standby Autonomous Database.

standbyAllowlistedIpsSource
Type: string

The source of the allowlisted IP addresses for the standby Autonomous Database.

standbyDb
Type: DatabaseStandbySummary structure

The details of the standby Autonomous Database in a cross-Region Oracle Data Guard configuration.

status
Type: string

The current status of the Autonomous Database.

statusReason
Type: string

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

timeDataGuardRoleChanged
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Oracle Data Guard role of the Autonomous Database last changed.

timeDeletionOfFreeAutonomousDatabase
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the inactive Always Free Autonomous Database is scheduled to be automatically deleted.

timeDisasterRecoveryRoleChanged
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the disaster recovery role of the Autonomous Database last changed.

timeLocalDataGuardEnabled
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when local Oracle Data Guard was enabled for the Autonomous Database.

timeMaintenanceBegin
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the next maintenance of the Autonomous Database begins.

timeMaintenanceEnd
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the next maintenance of the Autonomous Database ends.

timeOfAutoRefreshStart
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time at which the automatic refresh of the refreshable clone Autonomous Database starts.

timeOfLastBackup
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the last backup of the Autonomous Database.

timeOfLastFailover
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the last failover operation for the Autonomous Database.

timeOfLastRefresh
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the last refresh of the refreshable clone Autonomous Database.

timeOfLastRefreshPoint
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time as of which the data in the refreshable clone Autonomous Database is current.

timeOfLastSwitchover
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the last switchover operation for the Autonomous Database.

timeOfNextRefresh
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the next scheduled refresh of the refreshable clone Autonomous Database.

timeReclamationOfFreeAutonomousDatabase
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Always Free Autonomous Database is scheduled to be stopped because of inactivity.

timeUndeleted
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous Database was restored after deletion.

timeUntilReconnectCloneEnabled
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time until which reconnecting the refreshable clone to its source Autonomous Database is allowed.

totalBackupStorageSizeInGBs
Type: double

The total amount of backup storage used by the Autonomous Database, in GB.

usedDataStorageSizeInGBs
Type: int

The amount of data storage currently in use by the Autonomous Database, in GB.

usedDataStorageSizeInTBs
Type: double

The amount of data storage currently in use by the Autonomous Database, in TB.

AutonomousDatabaseApex

Description

The Oracle Application Express (APEX) details for an Autonomous Database.

Members
apexVersion
Type: string

The Oracle Application Express (APEX) version of the Autonomous Database.

ordsVersion
Type: string

The Oracle REST Data Services (ORDS) version of the Autonomous Database.

AutonomousDatabaseBackup

Description

Information about an Autonomous Database backup.

Members
autonomousDatabaseBackupArn
Type: string

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

autonomousDatabaseBackupId
Type: string

The unique identifier of the Autonomous Database backup.

autonomousDatabaseId
Type: string

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

dbVersion
Type: string

The Oracle Database software version of the Autonomous Database backup.

displayName
Type: string

The user-friendly name of the Autonomous Database backup.

isAutomatic
Type: boolean

Indicates whether the backup was created automatically.

ocid
Type: string

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

retentionPeriodInDays
Type: int

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

sizeInTBs
Type: double

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

status
Type: string

The current status of the Autonomous Database backup.

statusReason
Type: string

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

timeAvailableTill
Type: timestamp (string|DateTime or anything parsable by strtotime)

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

timeEnded
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous Database backup ended.

timeStarted
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous Database backup started.

type
Type: string

The type of the Autonomous Database backup.

AutonomousDatabaseBackupSummary

Description

A summary of an Autonomous Database backup.

Members
autonomousDatabaseBackupArn
Type: string

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

autonomousDatabaseBackupId
Type: string

The unique identifier of the Autonomous Database backup.

autonomousDatabaseId
Type: string

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

dbVersion
Type: string

The Oracle Database software version of the Autonomous Database backup.

displayName
Type: string

The user-friendly name of the Autonomous Database backup.

isAutomatic
Type: boolean

Indicates whether the backup was created automatically.

ocid
Type: string

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

retentionPeriodInDays
Type: int

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

sizeInTBs
Type: double

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

status
Type: string

The current status of the Autonomous Database backup.

statusReason
Type: string

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

timeAvailableTill
Type: timestamp (string|DateTime or anything parsable by strtotime)

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

timeEnded
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous Database backup ended.

timeStarted
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous Database backup started.

type
Type: string

The type of the Autonomous Database backup.

AutonomousDatabaseCharacterSetSummary

Description

A summary of an available character set for Autonomous Databases.

Members
characterSet
Type: string

The name of the character set.

AutonomousDatabaseConnectionStrings

Description

The connection strings used to connect to an Autonomous Database.

Members
allConnectionStrings
Type: Associative array of custom strings keys (String) to strings

The list of all connection strings that you can use to connect to the Autonomous Database.

dedicated
Type: string

The connection string for connecting to the Autonomous Database with a dedicated service.

high
Type: string

The connection string for the high-priority database service.

low
Type: string

The connection string for the low-priority database service.

medium
Type: string

The connection string for the medium-priority database service.

profiles
Type: Array of DatabaseConnectionStringProfile structures

The list of connection string profiles for the Autonomous Database.

AutonomousDatabaseConnectionUrls

Description

The connection URLs for accessing tools and services for an Autonomous Database.

Members
apexUrl
Type: string

The URL for accessing Oracle Application Express (APEX) for the Autonomous Database.

databaseTransformsUrl
Type: string

The URL for accessing Oracle Database Transforms for the Autonomous Database.

graphStudioUrl
Type: string

The URL for accessing Oracle Graph Studio for the Autonomous Database.

machineLearningNotebookUrl
Type: string

The URL for accessing the Oracle Machine Learning notebook for the Autonomous Database.

machineLearningUserManagementUrl
Type: string

The URL for accessing Oracle Machine Learning user management for the Autonomous Database.

mongoDbUrl
Type: string

The URL for accessing the MongoDB API for the Autonomous Database.

ordsUrl
Type: string

The URL for accessing Oracle REST Data Services (ORDS) for the Autonomous Database.

spatialStudioUrl
Type: string

The URL for accessing Oracle Spatial Studio for the Autonomous Database.

sqlDevWebUrl
Type: string

The URL for accessing Oracle SQL Developer Web for the Autonomous Database.

AutonomousDatabasePeerSummary

Description

A summary of a peer database of an Autonomous Database.

Members
autonomousDatabaseArn
Type: string

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

autonomousDatabaseId
Type: string

The unique identifier of the peer Autonomous Database.

ocid
Type: string

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

region
Type: string

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

AutonomousDatabaseSummary

Description

A summary of an Autonomous Database.

Members
actualUsedDataStorageSizeInTBs
Type: double

The actual amount of data storage currently in use by the Autonomous Database, in TB.

allocatedStorageSizeInTBs
Type: double

The amount of storage currently allocated to the Autonomous Database, in TB.

allowlistedIps
Type: Array of strings

The list of IP addresses that are allowed to access the Autonomous Database.

apexDetails
Type: AutonomousDatabaseApex structure

The Oracle Application Express (APEX) details for the Autonomous Database.

autoRefreshFrequencyInSeconds
Type: int

The frequency, in seconds, at which the refreshable clone Autonomous Database is automatically refreshed.

autoRefreshPointLagInSeconds
Type: int

The time lag, in seconds, between the refreshable clone and its source Autonomous Database.

autonomousDatabaseArn
Type: string

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

autonomousDatabaseId
Type: string

The unique identifier of the Autonomous Database.

autonomousMaintenanceScheduleType
Type: string

The maintenance schedule type for the Autonomous Database.

availabilityZone
Type: string

The Availability Zone where the Autonomous Database is located.

availabilityZoneId
Type: string

The unique identifier of the Availability Zone where the Autonomous Database is located.

availableUpgradeVersions
Type: Array of strings

The list of Oracle Database software versions to which the Autonomous Database can be upgraded.

backupRetentionPeriodInDays
Type: int

The retention period, in days, for automatic backups of the Autonomous Database.

byolComputeCountLimit
Type: int

The maximum number of compute resources that you can allocate to the Autonomous Database under the bring-your-own-license (BYOL) model.

characterSet
Type: string

The character set of the Autonomous Database.

cloneTableSpaceList
Type: Array of ints

The list of tablespace identifiers to clone for the Autonomous Database.

computeCount
Type: float

The compute capacity, in number of Elastic CPUs (ECPUs) or Oracle CPUs (OCPUs), assigned to the Autonomous Database.

computeModel
Type: string

The compute model of the Autonomous Database, either ECPU or OCPU.

connectionStringDetails

The connection string details for the Autonomous Database.

connectionUrls

The connection URLs for accessing tools and services for the Autonomous Database.

cpuCoreCount
Type: int

The number of CPU cores allocated to the Autonomous Database.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous Database was created.

customerContacts
Type: Array of CustomerContact structures

The list of customer contacts that receive operational notifications from Oracle for the Autonomous Database.

dataSafeStatus
Type: string

The status of the Oracle Data Safe registration for the Autonomous Database.

dataStorageSizeInGBs
Type: int

The size, in gigabytes (GB), of the data volume allocated for the Autonomous Database.

dataStorageSizeInTBs
Type: double

The size, in terabytes (TB), of the data volume allocated for the Autonomous Database.

databaseEdition
Type: string

The Oracle Database edition of the Autonomous Database.

databaseManagementStatus
Type: string

The status of Oracle Database Management for the Autonomous Database.

databaseType
Type: string

The type of the Autonomous Database, either a regular database or a clone.

dbName
Type: string

The name of the Autonomous Database.

dbToolsDetails
Type: Array of DatabaseTool structures

The list of database management tools enabled for the Autonomous Database.

dbVersion
Type: string

The Oracle Database software version of the Autonomous Database.

dbWorkload
Type: string

The intended use of the Autonomous Database, such as transaction processing, data warehouse, JSON database, or APEX.

displayName
Type: string

The user-friendly name of the Autonomous Database.

encryptionSummary
Type: EncryptionSummary structure

The encryption configuration for the Autonomous Database.

failedDataRecoveryInSeconds
Type: int

The amount of time, in seconds, that the data in the Autonomous Database is behind the data in the primary database.

inMemoryAreaInGBs
Type: int

The size of the in-memory area of the Autonomous Database, in GB.

isAutoScalingEnabled
Type: boolean

Indicates whether automatic scaling of the compute resources is enabled for the Autonomous Database.

isAutoScalingForStorageEnabled
Type: boolean

Indicates whether automatic scaling of the storage is enabled for the Autonomous Database.

isBackupRetentionLocked
Type: boolean

Indicates whether the backup retention period of the Autonomous Database is locked.

isLocalDataGuardEnabled
Type: boolean

Indicates whether local Oracle Data Guard is enabled for the Autonomous Database.

isMtlsConnectionRequired
Type: boolean

Indicates whether mutual TLS (mTLS) authentication is required to connect to the Autonomous Database.

isReconnectCloneEnabled
Type: boolean

Indicates whether reconnecting the refreshable clone to its source Autonomous Database is enabled.

isRefreshableClone
Type: boolean

Indicates whether the Autonomous Database is a refreshable clone.

isRemoteDataGuardEnabled
Type: boolean

Indicates whether remote Oracle Data Guard is enabled for the Autonomous Database.

licenseModel
Type: string

The Oracle license model that applies to the Autonomous Database.

localAdgAutoFailoverMaxDataLossLimit
Type: int

The maximum data loss limit, in seconds, for automatic failover to the local Oracle Data Guard standby database.

localDisasterRecoveryType
Type: string

The type of local disaster recovery configured for the Autonomous Database.

localStandbyDb
Type: DatabaseStandbySummary structure

The details of the local standby Autonomous Database in an Oracle Data Guard configuration.

longTermBackupSchedule
Type: LongTermBackupSchedule structure

The long-term backup schedule for the Autonomous Database.

maintenanceTargetComponent
Type: string

The component on the Autonomous Database that the current maintenance is being applied to.

memoryPerOracleComputeUnitInGBs
Type: int

The amount of memory allocated per Oracle Compute Unit, in GB.

ncharacterSet
Type: string

The national character set of the Autonomous Database.

netServicesArchitecture
Type: string

The Oracle Net Services architecture of the Autonomous Database, either dedicated or shared.

nextLongTermBackupTimeStamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the next scheduled long-term backup of the Autonomous Database.

ociResourceAnchorName
Type: string

The name of the Oracle Cloud Infrastructure (OCI) resource anchor associated with the Autonomous Database.

ociUrl
Type: string

The URL for accessing the OCI console page for the Autonomous Database.

ocid
Type: string

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

odbNetworkArn
Type: string

The Amazon Resource Name (ARN) of the ODB network associated with the Autonomous Database.

odbNetworkId
Type: string

The unique identifier of the ODB network associated with the Autonomous Database.

openMode
Type: string

The mode in which the Autonomous Database is open, either read-only or read/write.

operationsInsightsStatus
Type: string

The status of Oracle Operations Insights for the Autonomous Database.

peerDbIds
Type: Array of strings

The list of unique identifiers of the peer Autonomous Databases.

percentProgress
Type: float

The progress of the current operation on the Autonomous Database, as a percentage.

permissionLevel
Type: string

The permission level of the Autonomous Database.

privateEndpoint
Type: string

The private endpoint for the Autonomous Database.

privateEndpointIp
Type: string

The private endpoint IP address for the Autonomous Database.

privateEndpointLabel
Type: string

The private endpoint label for the Autonomous Database.

provisionableCpus
Type: Array of ints

The list of CPU core counts that you can provision for the Autonomous Database.

refreshableMode
Type: string

The refresh mode of the refreshable clone Autonomous Database.

refreshableStatus
Type: string

The refresh status of the refreshable clone Autonomous Database.

remoteDisasterRecoveryConfiguration

The configuration of the remote disaster recovery for the Autonomous Database.

resourcePoolLeaderId
Type: string

The unique identifier of the resource pool leader Autonomous Database.

resourcePoolSummary
Type: ResourcePoolSummary structure

The configuration of the resource pool for the Autonomous Database.

role
Type: string

The Oracle Data Guard role of the Autonomous Database.

scheduledOperations
Type: Array of ScheduledOperationDetails structures

The list of scheduled start and stop times for the Autonomous Database.

serviceConsoleUrl
Type: string

The URL for accessing the Oracle service console for the Autonomous Database.

sourceId
Type: string

The unique identifier of the source from which the Autonomous Database was created.

sqlWebDeveloperUrl
Type: string

The URL for accessing Oracle SQL Developer Web for the Autonomous Database.

standbyAllowlistedIps
Type: Array of strings

The list of IP addresses that are allowed to access the standby Autonomous Database.

standbyAllowlistedIpsSource
Type: string

The source of the allowlisted IP addresses for the standby Autonomous Database.

standbyDb
Type: DatabaseStandbySummary structure

The details of the standby Autonomous Database in a cross-Region Oracle Data Guard configuration.

status
Type: string

The current status of the Autonomous Database.

statusReason
Type: string

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

timeDataGuardRoleChanged
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Oracle Data Guard role of the Autonomous Database last changed.

timeDeletionOfFreeAutonomousDatabase
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the inactive Always Free Autonomous Database is scheduled to be automatically deleted.

timeDisasterRecoveryRoleChanged
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the disaster recovery role of the Autonomous Database last changed.

timeLocalDataGuardEnabled
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when local Oracle Data Guard was enabled for the Autonomous Database.

timeMaintenanceBegin
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the next maintenance of the Autonomous Database begins.

timeMaintenanceEnd
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the next maintenance of the Autonomous Database ends.

timeOfAutoRefreshStart
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time at which the automatic refresh of the refreshable clone Autonomous Database starts.

timeOfLastBackup
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the last backup of the Autonomous Database.

timeOfLastFailover
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the last failover operation for the Autonomous Database.

timeOfLastRefresh
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the last refresh of the refreshable clone Autonomous Database.

timeOfLastRefreshPoint
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time as of which the data in the refreshable clone Autonomous Database is current.

timeOfLastSwitchover
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the last switchover operation for the Autonomous Database.

timeOfNextRefresh
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time of the next scheduled refresh of the refreshable clone Autonomous Database.

timeReclamationOfFreeAutonomousDatabase
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Always Free Autonomous Database is scheduled to be stopped because of inactivity.

timeUndeleted
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous Database was restored after deletion.

timeUntilReconnectCloneEnabled
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time until which reconnecting the refreshable clone to its source Autonomous Database is allowed.

totalBackupStorageSizeInGBs
Type: double

The total amount of backup storage used by the Autonomous Database, in GB.

usedDataStorageSizeInGBs
Type: int

The amount of data storage currently in use by the Autonomous Database, in GB.

usedDataStorageSizeInTBs
Type: double

The amount of data storage currently in use by the Autonomous Database, in TB.

AutonomousDatabaseVersionSummary

Description

A summary of an available Oracle Database software version for Autonomous Databases.

Members
dbWorkload
Type: string

The intended use of the Autonomous Database that the version supports, such as transaction processing, data warehouse, JSON database, or APEX.

details
Type: string

Additional details about the Autonomous Database software version.

version
Type: string

The Oracle Database software version.

AutonomousDatabaseWalletDetails

Description

The wallet details for an Autonomous Database.

Members
status
Type: string

The current status of the Autonomous Database wallet.

timeRotated
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous Database wallet was last rotated.

AutonomousVirtualMachineSummary

Description

A summary of an Autonomous Virtual Machine (VM) within an Autonomous VM cluster.

Members
autonomousVirtualMachineId
Type: string

The unique identifier of the Autonomous VM.

clientIpAddress
Type: string

The IP address used by clients to connect to this Autonomous VM.

cloudAutonomousVmClusterId
Type: string

The unique identifier of the Autonomous VM cluster containing this Autonomous VM.

cpuCoreCount
Type: int

The number of CPU cores allocated to this Autonomous VM.

dbNodeStorageSizeInGBs
Type: int

The amount of storage allocated to this Autonomous Virtual Machine, in gigabytes (GB).

dbServerDisplayName
Type: string

The display name of the database server hosting this Autonomous VM.

dbServerId
Type: string

The unique identifier of the database server hosting this Autonomous VM.

memorySizeInGBs
Type: int

The amount of memory allocated to this Autonomous VM, in gigabytes (GB).

ociResourceAnchorName
Type: string

The name of the Oracle Cloud Infrastructure (OCI) resource anchor associated with this Autonomous VM.

ocid
Type: string

The Oracle Cloud Identifier (OCID) of the Autonomous VM.

status
Type: string

The current status of the Autonomous VM.

statusReason
Type: string

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

vmName
Type: string

The name of the Autonomous VM.

AwsEncryptionKeyConfiguration

Description

The configuration of the Amazon Web Services Key Management Service (KMS) encryption key used for an Autonomous Database.

Members
externalIdType
Type: string

The type of external identifier associated with the encryption key.

iamRoleArn
Type: string

The Amazon Resource Name (ARN) of the Amazon Web Services Identity and Access Management (IAM) role that grants access to the KMS key.

kmsKeyId
Type: string

The identifier or ARN of the Amazon Web Services KMS key used for encryption.

AwsEncryptionKeyConfigurationInput

Description

The configuration of the Amazon Web Services Key Management Service (KMS) encryption key to use for an Autonomous Database.

Members
externalIdType
Type: string

The type of external identifier associated with the encryption key.

iamRoleArn
Type: string

The Amazon Resource Name (ARN) of the Amazon Web Services Identity and Access Management (IAM) role that grants access to the KMS key.

kmsKeyId
Type: string

The identifier or ARN of the Amazon Web Services KMS key to use for encryption.

CloneToRefreshableConfiguration

Description

The configuration for creating an Autonomous Database as a refreshable clone.

Members
autoRefreshFrequencyInSeconds
Type: int

The frequency, in seconds, at which the refreshable clone is automatically refreshed.

autoRefreshPointLagInSeconds
Type: int

The time lag, in seconds, between the refreshable clone and its source database.

cloneType
Type: string

The type of clone to create.

openMode
Type: string

The mode in which to open the refreshable clone, either read-only or read/write.

refreshableMode
Type: string

The refresh mode of the refreshable clone, either automatic or manual.

sourceAutonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the source Autonomous Database to create the refreshable clone from.

timeOfAutoRefreshStart
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time at which the automatic refresh of the refreshable clone starts.

CloudAutonomousVmCluster

Description

Information about an Autonomous VM cluster resource.

Members
autonomousDataStoragePercentage
Type: float

The percentage of data storage currently in use for Autonomous Databases in the Autonomous VM cluster.

autonomousDataStorageSizeInTBs
Type: double

The data storage size allocated for Autonomous Databases in the Autonomous VM cluster, in TB.

availableAutonomousDataStorageSizeInTBs
Type: double

The available data storage space for Autonomous Databases in the Autonomous VM cluster, in TB.

availableContainerDatabases
Type: int

The number of Autonomous CDBs that you can create with the currently available storage.

availableCpus
Type: float

The number of CPU cores available for allocation to Autonomous Databases.

cloudAutonomousVmClusterArn
Type: string

The Amazon Resource Name (ARN) for the Autonomous VM cluster.

cloudAutonomousVmClusterId
Required: Yes
Type: string

The unique identifier of the Autonomous VM cluster.

cloudExadataInfrastructureArn
Type: string

The Amazon Resource Name (ARN) of the Cloud Exadata Infrastructure containing this Autonomous VM cluster.

cloudExadataInfrastructureId
Type: string

The unique identifier of the Cloud Exadata Infrastructure containing this Autonomous VM cluster.

computeModel
Type: string

The compute model of the Autonomous VM cluster: ECPU or OCPU.

cpuCoreCount
Type: int

The total number of CPU cores in the Autonomous VM cluster.

cpuCoreCountPerNode
Type: int

The number of CPU cores enabled per node in the Autonomous VM cluster.

cpuPercentage
Type: float

The percentage of total CPU cores currently in use in the Autonomous VM cluster.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous VM cluster was created.

dataStorageSizeInGBs
Type: double

The total data storage allocated to the Autonomous VM cluster, in GB.

dataStorageSizeInTBs
Type: double

The total data storage allocated to the Autonomous VM cluster, in TB.

dbNodeStorageSizeInGBs
Type: int

The local node storage allocated to the Autonomous VM cluster, in gigabytes (GB).

dbServers
Type: Array of strings

The list of database servers associated with the Autonomous VM cluster.

description
Type: string

The user-provided description of the Autonomous VM cluster.

displayName
Type: string

The display name of the Autonomous VM cluster.

domain
Type: string

The domain name for the Autonomous VM cluster.

exadataStorageInTBsLowestScaledValue
Type: double

The minimum value to which you can scale down the Exadata storage, in TB.

hostname
Type: string

The hostname for the Autonomous VM cluster.

iamRoles
Type: Array of IamRole structures

The Amazon Web Services Identity and Access Management (IAM) service roles associated with the Autonomous VM cluster.

isMtlsEnabledVmCluster
Type: boolean

Indicates whether mutual TLS (mTLS) authentication is enabled for the Autonomous VM cluster.

licenseModel
Type: string

The Oracle license model that applies to the Autonomous VM cluster.

maintenanceWindow
Type: MaintenanceWindow structure

The scheduling details for the maintenance window. Patching and system updates take place during the maintenance window.

maxAcdsLowestScaledValue
Type: int

The minimum value to which you can scale down the maximum number of Autonomous CDBs.

memoryPerOracleComputeUnitInGBs
Type: int

The amount of memory allocated per Oracle Compute Unit, in GB.

memorySizeInGBs
Type: int

The total amount of memory allocated to the Autonomous VM cluster, in gigabytes (GB).

nodeCount
Type: int

The number of database server nodes in the Autonomous VM cluster.

nonProvisionableAutonomousContainerDatabases
Type: int

The number of Autonomous CDBs that can't be provisioned because of resource constraints.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor associated with this Autonomous VM cluster.

ociUrl
Type: string

The URL for accessing the OCI console page for this Autonomous VM cluster.

ocid
Type: string

The Oracle Cloud Identifier (OCID) of the Autonomous VM cluster.

odbNetworkArn
Type: string

The Amazon Resource Name (ARN) of the ODB network associated with this Autonomous VM cluster.

odbNetworkId
Type: string

The unique identifier of the ODB network associated with this Autonomous VM cluster.

percentProgress
Type: float

The progress of the current operation on the Autonomous VM cluster, as a percentage.

provisionableAutonomousContainerDatabases
Type: int

The number of Autonomous CDBs that can be provisioned in the Autonomous VM cluster.

provisionedAutonomousContainerDatabases
Type: int

The number of Autonomous CDBs currently provisioned in the Autonomous VM cluster.

provisionedCpus
Type: float

The number of CPU cores currently provisioned in the Autonomous VM cluster.

reclaimableCpus
Type: float

The number of CPU cores that can be reclaimed from terminated or scaled-down Autonomous Databases.

reservedCpus
Type: float

The number of CPU cores reserved for system operations and redundancy.

scanListenerPortNonTls
Type: int

The SCAN listener port for non-TLS (TCP) protocol. The default is 1521.

scanListenerPortTls
Type: int

The SCAN listener port for TLS (TCP) protocol. The default is 2484.

shape
Type: string

The shape of the Exadata infrastructure for the Autonomous VM cluster.

status
Type: string

The current state of the Autonomous VM cluster. Possible values include CREATING, AVAILABLE, UPDATING, DELETING, DELETED, FAILED.

statusReason
Type: string

Additional information about the current status of the Autonomous VM cluster.

timeDatabaseSslCertificateExpires
Type: timestamp (string|DateTime or anything parsable by strtotime)

The expiration date and time of the database SSL certificate.

timeOrdsCertificateExpires
Type: timestamp (string|DateTime or anything parsable by strtotime)

The expiration date and time of the Oracle REST Data Services (ORDS) certificate.

timeZone
Type: string

The time zone of the Autonomous VM cluster.

totalContainerDatabases
Type: int

The total number of Autonomous Container Databases that can be created with the allocated local storage.

CloudAutonomousVmClusterResourceDetails

Description

Resource details of an Autonomous VM cluster.

Members
cloudAutonomousVmClusterId
Type: string

The unique identifier of the Autonomous VM cluster.

unallocatedAdbStorageInTBs
Type: double

The amount of unallocated Autonomous Database storage in the Autonomous VM cluster, in terabytes.

CloudAutonomousVmClusterSummary

Description

A summary of an Autonomous VM cluster.

Members
autonomousDataStoragePercentage
Type: float

The percentage of data storage currently in use for Autonomous Databases in the Autonomous VM cluster.

autonomousDataStorageSizeInTBs
Type: double

The total data storage allocated for Autonomous Databases in the Autonomous VM cluster, in TB.

availableAutonomousDataStorageSizeInTBs
Type: double

The available data storage for Autonomous Databases in the Autonomous VM cluster, in TB.

availableContainerDatabases
Type: int

The number of Autonomous Container Databases that you can create with the currently available storage.

availableCpus
Type: float

The number of CPU cores available for allocation to Autonomous Databases.

cloudAutonomousVmClusterArn
Type: string

The Amazon Resource Name (ARN) for the Autonomous VM cluster.

cloudAutonomousVmClusterId
Required: Yes
Type: string

The unique identifier of the Autonomous VM cluster.

cloudExadataInfrastructureArn
Type: string

The Amazon Resource Name (ARN) of the Exadata infrastructure containing this Autonomous VM cluster.

cloudExadataInfrastructureId
Type: string

The unique identifier of the Exadata infrastructure containing this Autonomous VM cluster.

computeModel
Type: string

The compute model of the Autonomous VM cluster: ECPU or OCPU.

cpuCoreCount
Type: int

The total number of CPU cores in the Autonomous VM cluster.

cpuCoreCountPerNode
Type: int

The number of CPU cores per node in the Autonomous VM cluster.

cpuPercentage
Type: float

The percentage of total CPU cores currently in use in the Autonomous VM cluster.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Autonomous VM cluster was created.

dataStorageSizeInGBs
Type: double

The total data storage allocated to the Autonomous VM cluster, in GB.

dataStorageSizeInTBs
Type: double

The total data storage allocated to the Autonomous VM cluster, in TB.

dbNodeStorageSizeInGBs
Type: int

The local node storage allocated to the Autonomous VM cluster, in GB.

dbServers
Type: Array of strings

The list of database servers associated with the Autonomous VM cluster.

description
Type: string

The user-provided description of the Autonomous VM cluster.

displayName
Type: string

The user-friendly name for the Autonomous VM cluster.

domain
Type: string

The domain name for the Autonomous VM cluster.

exadataStorageInTBsLowestScaledValue
Type: double

The lowest value to which Exadata storage can be scaled down, in TB.

hostname
Type: string

The host name for the Autonomous VM cluster.

iamRoles
Type: Array of IamRole structures

The Amazon Web Services Identity and Access Management (IAM) service roles associated with the Autonomous VM cluster in the summary information.

isMtlsEnabledVmCluster
Type: boolean

Indicates if mutual TLS (mTLS) authentication is enabled for the Autonomous VM cluster.

licenseModel
Type: string

The Oracle license model that applies to the Autonomous VM cluster.

maintenanceWindow
Type: MaintenanceWindow structure

The scheduling details for the maintenance window. Patching and system updates take place during the maintenance window.

maxAcdsLowestScaledValue
Type: int

The lowest value to which you can scale down the maximum number of Autonomous CDBs.

memoryPerOracleComputeUnitInGBs
Type: int

The amount of memory allocated per Oracle Compute Unit (OCU), in GB.

memorySizeInGBs
Type: int

The total amount of memory allocated to the Autonomous VM cluster, in GB.

nodeCount
Type: int

The number of database server nodes in the Autonomous VM cluster.

nonProvisionableAutonomousContainerDatabases
Type: int

The number of Autonomous CDBs that can't be provisioned because of resource constraints.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor associated with this Autonomous VM cluster.

ociUrl
Type: string

The URL for accessing the OCI console page for this Autonomous VM cluster.

ocid
Type: string

The Oracle Cloud Identifier (OCID) of the Autonomous VM cluster.

odbNetworkArn
Type: string

The Amazon Resource Name (ARN) of the ODB network associated with this Autonomous VM cluster.

odbNetworkId
Type: string

The unique identifier of the ODB network associated with this Autonomous VM cluster.

percentProgress
Type: float

The progress of the current operation on the Autonomous VM cluster, as a percentage.

provisionableAutonomousContainerDatabases
Type: int

The number of Autonomous CDBs that you can provision in the Autonomous VM cluster.

provisionedAutonomousContainerDatabases
Type: int

The number of Autonomous Container Databases currently provisioned in the Autonomous VM cluster.

provisionedCpus
Type: float

The number of CPUs currently provisioned in the Autonomous VM cluster.

reclaimableCpus
Type: float

The number of CPUs that can be reclaimed from terminated or scaled-down Autonomous Databases.

reservedCpus
Type: float

The number of CPUs reserved for system operations and redundancy.

scanListenerPortNonTls
Type: int

The SCAN listener port for non-TLS (TCP) protocol.

scanListenerPortTls
Type: int

The SCAN listener port for TLS (TCP) protocol.

shape
Type: string

The shape of the Exadata infrastructure for the Autonomous VM cluster.

status
Type: string

The current status of the Autonomous VM cluster.

statusReason
Type: string

Additional information about the current status of the Autonomous VM cluster, if applicable.

timeDatabaseSslCertificateExpires
Type: timestamp (string|DateTime or anything parsable by strtotime)

The expiration date and time of the database SSL certificate.

timeOrdsCertificateExpires
Type: timestamp (string|DateTime or anything parsable by strtotime)

The expiration date and time of the Oracle REST Data Services (ORDS) certificate.

timeZone
Type: string

The time zone of the Autonomous VM cluster.

totalContainerDatabases
Type: int

The total number of Autonomous Container Databases that can be created in the Autonomous VM cluster.

CloudExadataInfrastructure

Description

Information about an Exadata infrastructure.

Members
activatedStorageCount
Type: int

The number of storage servers requested for the Exadata infrastructure.

additionalStorageCount
Type: int

The number of storage servers requested for the Exadata infrastructure.

availabilityZone
Type: string

The name of the Availability Zone (AZ) where the Exadata infrastructure is located.

availabilityZoneId
Type: string

The AZ ID of the AZ where the Exadata infrastructure is located.

availableStorageSizeInGBs
Type: int

The amount of available storage, in gigabytes (GB), for the Exadata infrastructure.

cloudExadataInfrastructureArn
Type: string

The Amazon Resource Name (ARN) for the Exadata infrastructure.

cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier for the Exadata infrastructure.

computeCount
Type: int

The number of database servers for the Exadata infrastructure.

computeModel
Type: string

The OCI model compute model used when you create or clone an instance: ECPU or OCPU. An ECPU is an abstracted measure of compute resources. ECPUs are based on the number of cores elastically allocated from a pool of compute and storage servers. An OCPU is a legacy physical measure of compute resources. OCPUs are based on the physical core of a processor with hyper-threading enabled.

cpuCount
Type: int

The total number of CPU cores that are allocated to the Exadata infrastructure.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Exadata infrastructure was created.

customerContactsToSendToOCI
Type: Array of CustomerContact structures

The email addresses of contacts to receive notification from Oracle about maintenance updates for the Exadata infrastructure.

dataStorageSizeInTBs
Type: double

The size of the Exadata infrastructure's data disk group, in terabytes (TB).

databaseServerType
Type: string

The database server model type of the Exadata infrastructure. For the list of valid model names, use the ListDbSystemShapes operation.

dbNodeStorageSizeInGBs
Type: int

The size of the Exadata infrastructure's local node storage, in gigabytes (GB).

dbServerVersion
Type: string

The software version of the database servers (dom0) in the Exadata infrastructure.

displayName
Type: string

The user-friendly name for the Exadata infrastructure.

lastMaintenanceRunId
Type: string

The Oracle Cloud Identifier (OCID) of the last maintenance run for the Exadata infrastructure.

maintenanceWindow
Type: MaintenanceWindow structure

The scheduling details for the maintenance window. Patching and system updates take place during the maintenance window.

maxCpuCount
Type: int

The total number of CPU cores available on the Exadata infrastructure.

maxDataStorageInTBs
Type: double

The total amount of data disk group storage, in terabytes (TB), that's available on the Exadata infrastructure.

maxDbNodeStorageSizeInGBs
Type: int

The total amount of local node storage, in gigabytes (GB), that's available on the Exadata infrastructure.

maxMemoryInGBs
Type: int

The total amount of memory, in gigabytes (GB), that's available on the Exadata infrastructure.

memorySizeInGBs
Type: int

The amount of memory, in gigabytes (GB), that's allocated on the Exadata infrastructure.

monthlyDbServerVersion
Type: string

The monthly software version of the database servers installed on the Exadata infrastructure.

monthlyStorageServerVersion
Type: string

The monthly software version of the storage servers installed on the Exadata infrastructure.

nextMaintenanceRunId
Type: string

The OCID of the next maintenance run for the Exadata infrastructure.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor for the Exadata infrastructure.

ociUrl
Type: string

The HTTPS link to the Exadata infrastructure in OCI.

ocid
Type: string

The OCID of the Exadata infrastructure.

percentProgress
Type: float

The amount of progress made on the current operation on the Exadata infrastructure, expressed as a percentage.

shape
Type: string

The model name of the Exadata infrastructure.

status
Type: string

The current status of the Exadata infrastructure.

statusReason
Type: string

Additional information about the status of the Exadata infrastructure.

storageCount
Type: int

The number of storage servers that are activated for the Exadata infrastructure.

storageServerType
Type: string

The storage server model type of the Exadata infrastructure. For the list of valid model names, use the ListDbSystemShapes operation.

storageServerVersion
Type: string

The software version of the storage servers on the Exadata infrastructure.

totalStorageSizeInGBs
Type: int

The total amount of storage, in gigabytes (GB), on the the Exadata infrastructure.

CloudExadataInfrastructureSummary

Description

Information about an Exadata infrastructure.

Members
activatedStorageCount
Type: int

The number of storage servers requested for the Exadata infrastructure.

additionalStorageCount
Type: int

The number of storage servers requested for the Exadata infrastructure.

availabilityZone
Type: string

The name of the Availability Zone (AZ) where the Exadata infrastructure is located.

availabilityZoneId
Type: string

The AZ ID of the AZ where the Exadata infrastructure is located.

availableStorageSizeInGBs
Type: int

The amount of available storage, in gigabytes (GB), for the Exadata infrastructure.

cloudExadataInfrastructureArn
Type: string

The Amazon Resource Name (ARN) for the Exadata infrastructure.

cloudExadataInfrastructureId
Required: Yes
Type: string

The unique identifier for the Exadata infrastructure.

computeCount
Type: int

The number of database servers for the Exadata infrastructure.

computeModel
Type: string

The OCI model compute model used when you create or clone an instance: ECPU or OCPU. An ECPU is an abstracted measure of compute resources. ECPUs are based on the number of cores elastically allocated from a pool of compute and storage servers. An OCPU is a legacy physical measure of compute resources. OCPUs are based on the physical core of a processor with hyper-threading enabled.

cpuCount
Type: int

The total number of CPU cores that are allocated to the Exadata infrastructure.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Exadata infrastructure was created.

customerContactsToSendToOCI
Type: Array of CustomerContact structures

The email addresses of contacts to receive notification from Oracle about maintenance updates for the Exadata infrastructure.

dataStorageSizeInTBs
Type: double

The size of the Exadata infrastructure's data disk group, in terabytes (TB).

databaseServerType
Type: string

The database server model type of the Exadata infrastructure. For the list of valid model names, use the ListDbSystemShapes operation.

dbNodeStorageSizeInGBs
Type: int

The size of the Exadata infrastructure's local node storage, in gigabytes (GB).

dbServerVersion
Type: string

The software version of the database servers on the Exadata infrastructure.

displayName
Type: string

The user-friendly name for the Exadata infrastructure.

lastMaintenanceRunId
Type: string

The Oracle Cloud Identifier (OCID) of the last maintenance run for the Exadata infrastructure.

maintenanceWindow
Type: MaintenanceWindow structure

The scheduling details for the maintenance window. Patching and system updates take place during the maintenance window.

maxCpuCount
Type: int

The total number of CPU cores available on the Exadata infrastructure.

maxDataStorageInTBs
Type: double

The total amount of data disk group storage, in terabytes (TB), that's available on the Exadata infrastructure.

maxDbNodeStorageSizeInGBs
Type: int

The total amount of local node storage, in gigabytes (GB), that's available on the Exadata infrastructure.

maxMemoryInGBs
Type: int

The total amount of memory, in gigabytes (GB), that's available on the Exadata infrastructure.

memorySizeInGBs
Type: int

The amount of memory, in gigabytes (GB), that's allocated on the Exadata infrastructure.

monthlyDbServerVersion
Type: string

The monthly software version of the database servers (dom0) installed on the Exadata infrastructure.

monthlyStorageServerVersion
Type: string

The monthly software version of the storage servers installed on the Exadata infrastructure.

nextMaintenanceRunId
Type: string

The OCID of the next maintenance run for the Exadata infrastructure.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor for the Exadata infrastructure.

ociUrl
Type: string

The HTTPS link to the Exadata infrastructure in OCI.

ocid
Type: string

The OCID of the Exadata infrastructure.

percentProgress
Type: float

The amount of progress made on the current operation on the Exadata infrastructure, expressed as a percentage.

shape
Type: string

The model name of the Exadata infrastructure.

status
Type: string

The current status of the Exadata infrastructure.

statusReason
Type: string

Additional information about the status of the Exadata infrastructure.

storageCount
Type: int

The number of storage servers that are activated for the Exadata infrastructure.

storageServerType
Type: string

The storage server model type of the Exadata infrastructure. For the list of valid model names, use the ListDbSystemShapes operation.

storageServerVersion
Type: string

The software version of the storage servers on the Exadata infrastructure.

totalStorageSizeInGBs
Type: int

The total amount of storage, in gigabytes (GB), on the the Exadata infrastructure.

CloudExadataInfrastructureUnallocatedResources

Description

Information about unallocated resources in the Cloud Exadata infrastructure.

Members
cloudAutonomousVmClusters
Type: Array of CloudAutonomousVmClusterResourceDetails structures

A list of Autonomous VM clusters associated with this Cloud Exadata Infrastructure.

cloudExadataInfrastructureDisplayName
Type: string

The display name of the Cloud Exadata infrastructure.

cloudExadataInfrastructureId
Type: string

The unique identifier of the Cloud Exadata infrastructure.

exadataStorageInTBs
Type: double

The amount of unallocated Exadata storage available, in terabytes (TB).

localStorageInGBs
Type: int

The amount of unallocated local storage available, in gigabytes (GB).

memoryInGBs
Type: int

The amount of unallocated memory available, in gigabytes (GB).

ocpus
Type: int

The number of unallocated Oracle CPU Units (OCPUs) available.

CloudVmCluster

Description

Information about a VM cluster.

Members
cloudExadataInfrastructureArn
Type: string

The Amazon Resource Name (ARN) of the Exadata infrastructure that this VM cluster belongs to.

cloudExadataInfrastructureId
Type: string

The unique identifier of the Exadata infrastructure that this VM cluster belongs to.

cloudVmClusterArn
Type: string

The Amazon Resource Name (ARN) of the VM cluster.

cloudVmClusterId
Required: Yes
Type: string

The unique identifier of the VM cluster.

clusterName
Type: string

The name of the Grid Infrastructure (GI) cluster.

computeModel
Type: string

The OCI model compute model used when you create or clone an instance: ECPU or OCPU. An ECPU is an abstracted measure of compute resources. ECPUs are based on the number of cores elastically allocated from a pool of compute and storage servers. An OCPU is a legacy physical measure of compute resources. OCPUs are based on the physical core of a processor with hyper-threading enabled.

cpuCoreCount
Type: int

The number of CPU cores enabled on the VM cluster.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the VM cluster was created.

dataCollectionOptions
Type: DataCollectionOptions structure

The set of diagnostic collection options enabled for the VM cluster.

dataStorageSizeInTBs
Type: double

The size of the data disk group, in terabytes (TB), that's allocated for the VM cluster.

dbNodeStorageSizeInGBs
Type: int

The amount of local node storage, in gigabytes (GB), that's allocated for the VM cluster.

dbServers
Type: Array of strings

The list of database servers for the VM cluster.

diskRedundancy
Type: string

The type of redundancy configured for the VM cluster. NORMAL is 2-way redundancy. HIGH is 3-way redundancy.

displayName
Type: string

The user-friendly name for the VM cluster.

domain
Type: string

The domain of the VM cluster.

giVersion
Type: string

The software version of the Oracle Grid Infrastructure (GI) for the VM cluster.

hostname
Type: string

The host name for the VM cluster.

iamRoles
Type: Array of IamRole structures

The Amazon Web Services Identity and Access Management (IAM) service roles associated with the VM cluster.

iormConfigCache
Type: ExadataIormConfig structure

The ExadataIormConfig cache details for the VM cluster.

isLocalBackupEnabled
Type: boolean

Indicates whether database backups to local Exadata storage is enabled for the VM cluster.

isSparseDiskgroupEnabled
Type: boolean

Indicates whether the VM cluster is configured with a sparse disk group.

lastUpdateHistoryEntryId
Type: string

The Oracle Cloud ID (OCID) of the last maintenance update history entry.

licenseModel
Type: string

The Oracle license model applied to the VM cluster.

listenerPort
Type: int

The port number configured for the listener on the VM cluster.

memorySizeInGBs
Type: int

The amount of memory, in gigabytes (GB), that's allocated for the VM cluster.

nodeCount
Type: int

The number of nodes in the VM cluster.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor for the VM cluster.

ociUrl
Type: string

The HTTPS link to the VM cluster in OCI.

ocid
Type: string

The OCID of the VM cluster.

odbNetworkArn
Type: string

The Amazon Resource Name (ARN) of the ODB network associated with this VM cluster.

odbNetworkId
Type: string

The unique identifier of the ODB network for the VM cluster.

percentProgress
Type: float

The amount of progress made on the current operation on the VM cluster, expressed as a percentage.

scanDnsName
Type: string

The FQDN of the DNS record for the Single Client Access Name (SCAN) IP addresses that are associated with the VM cluster.

scanDnsRecordId
Type: string

The OCID of the DNS record for the SCAN IP addresses that are associated with the VM cluster.

scanIpIds
Type: Array of strings

The OCID of the SCAN IP addresses that are associated with the VM cluster.

shape
Type: string

The hardware model name of the Exadata infrastructure that's running the VM cluster.

sshPublicKeys
Type: Array of strings

The public key portion of one or more key pairs used for SSH access to the VM cluster.

status
Type: string

The current status of the VM cluster.

statusReason
Type: string

Additional information about the status of the VM cluster.

storageSizeInGBs
Type: int

The amount of local node storage, in gigabytes (GB), that's allocated to the VM cluster.

systemVersion
Type: string

The operating system version of the image chosen for the VM cluster.

timeZone
Type: string

The time zone of the VM cluster.

vipIds
Type: Array of strings

The virtual IP (VIP) addresses that are associated with the VM cluster. Oracle's Cluster Ready Services (CRS) creates and maintains one VIP address for each node in the VM cluster to enable failover. If one node fails, the VIP is reassigned to another active node in the cluster.

CloudVmClusterSummary

Description

Information about a VM cluster.

Members
cloudExadataInfrastructureArn
Type: string

The Amazon Resource Name (ARN) of the Exadata infrastructure that this VM cluster belongs to.

cloudExadataInfrastructureId
Type: string

The unique identifier of the Exadata infrastructure that this VM cluster belongs to.

cloudVmClusterArn
Type: string

The Amazon Resource Name (ARN) of the VM cluster.

cloudVmClusterId
Required: Yes
Type: string

The unique identifier of the VM cluster.

clusterName
Type: string

The name of the Grid Infrastructure (GI) cluster.

computeModel
Type: string

The OCI model compute model used when you create or clone an instance: ECPU or OCPU. An ECPU is an abstracted measure of compute resources. ECPUs are based on the number of cores elastically allocated from a pool of compute and storage servers. An OCPU is a legacy physical measure of compute resources. OCPUs are based on the physical core of a processor with hyper-threading enabled.

cpuCoreCount
Type: int

The number of CPU cores enabled on the VM cluster.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the VM cluster was created.

dataCollectionOptions
Type: DataCollectionOptions structure

Information about the data collection options enabled for a VM cluster.

dataStorageSizeInTBs
Type: double

The size of the data disk group, in terabytes (TB), that's allocated for the VM cluster.

dbNodeStorageSizeInGBs
Type: int

The amount of local node storage, in gigabytes (GB), that's allocated for the VM cluster.

dbServers
Type: Array of strings

The list of database servers for the VM cluster.

diskRedundancy
Type: string

The type of redundancy configured for the VM cluster. NORMAL is 2-way redundancy. HIGH is 3-way redundancy.

displayName
Type: string

The user-friendly name for the VM cluster.

domain
Type: string

The domain of the VM cluster.

giVersion
Type: string

The software version of the Oracle Grid Infrastructure (GI) for the VM cluster.

hostname
Type: string

The host name for the VM cluster.

iamRoles
Type: Array of IamRole structures

The Amazon Web Services Identity and Access Management (IAM) service roles associated with the VM cluster in the summary information.

iormConfigCache
Type: ExadataIormConfig structure

The IORM settings of the Exadata DB system.

isLocalBackupEnabled
Type: boolean

Indicates whether database backups to local Exadata storage is enabled for the VM cluster.

isSparseDiskgroupEnabled
Type: boolean

Indicates whether the VM cluster is configured with a sparse disk group.

lastUpdateHistoryEntryId
Type: string

The Oracle Cloud ID (OCID) of the last maintenance update history entry.

licenseModel
Type: string

The Oracle license model applied to the VM cluster.

listenerPort
Type: int

The port number configured for the listener on the VM cluster.

memorySizeInGBs
Type: int

The amount of memory, in gigabytes (GB), that's allocated for the VM cluster.

nodeCount
Type: int

The number of nodes in the VM cluster.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor for the VM cluster.

ociUrl
Type: string

The HTTPS link to the VM cluster in OCI.

ocid
Type: string

The OCID of the VM cluster.

odbNetworkArn
Type: string

The Amazon Resource Name (ARN) of the ODB network associated with this VM cluster.

odbNetworkId
Type: string

The unique identifier of the ODB network for the VM cluster.

percentProgress
Type: float

The amount of progress made on the current operation on the VM cluster, expressed as a percentage.

scanDnsName
Type: string

The FQDN of the DNS record for the Single Client Access Name (SCAN) IP addresses that are associated with the VM cluster.

scanDnsRecordId
Type: string

The OCID of the DNS record for the SCAN IP addresses that are associated with the VM cluster.

scanIpIds
Type: Array of strings

The OCID of the SCAN IP addresses that are associated with the VM cluster.

shape
Type: string

The hardware model name of the Exadata infrastructure that's running the VM cluster.

sshPublicKeys
Type: Array of strings

The public key portion of one or more key pairs used for SSH access to the VM cluster.

status
Type: string

The current status of the VM cluster.

statusReason
Type: string

Additional information about the status of the VM cluster.

storageSizeInGBs
Type: int

The amount of local node storage, in gigabytes (GB), that's allocated to the VM cluster.

systemVersion
Type: string

The operating system version of the image chosen for the VM cluster.

timeZone
Type: string

The time zone of the VM cluster.

vipIds
Type: Array of strings

The virtual IP (VIP) addresses that are associated with the VM cluster. Oracle's Cluster Ready Services (CRS) creates and maintains one VIP address for each node in the VM cluster to enable failover. If one node fails, the VIP is reassigned to another active node in the cluster.

ConflictException

Description

Occurs when a conflict with the current status of your resource. Fix any inconsistencies with your resource and try again.

Members
message
Required: Yes
Type: string
resourceId
Required: Yes
Type: string

The identifier of the resource that caused the conflict.

resourceType
Required: Yes
Type: string

The type of resource that caused the conflict.

CrossRegionDataGuardConfiguration

Description

The configuration for creating an Autonomous Database as a cross-Region Oracle Data Guard peer.

Members
sourceAutonomousDatabaseArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the source Autonomous Database for the cross-Region Oracle Data Guard configuration.

CrossRegionDisasterRecoveryConfiguration

Description

The configuration for creating an Autonomous Database as a cross-Region disaster recovery peer.

Members
isReplicateAutomaticBackups
Type: boolean

Indicates whether automatic backups are replicated to the disaster recovery database.

remoteDisasterRecoveryType
Required: Yes
Type: string

The type of remote disaster recovery to configure, either Autonomous Data Guard or backup-based.

sourceAutonomousDatabaseArn
Required: Yes
Type: string

The Amazon Resource Name (ARN) of the source Autonomous Database for the cross-Region disaster recovery configuration.

CrossRegionS3RestoreSourcesAccess

Description

The configuration access for the cross-Region Amazon S3 database restore source for the ODB network.

Members
ipv4Addresses
Type: Array of strings

The IPv4 addresses allowed for cross-Region Amazon S3 restore access.

region
Type: string

The Amazon Web Services Region for cross-Region Amazon S3 restore access.

status
Type: string

The current status of the cross-Region Amazon S3 restore access configuration.

CustomerContact

Description

A contact to receive notification from Oracle about maintenance updates for a specific Exadata infrastructure.

Members
email
Type: string

The email address of the contact.

DataCollectionOptions

Description

Information about the data collection options enabled for a VM cluster.

Members
isDiagnosticsEventsEnabled
Type: boolean

Indicates whether diagnostic collection is enabled for the VM cluster.

isHealthMonitoringEnabled
Type: boolean

Indicates whether health monitoring is enabled for the VM cluster.

isIncidentLogsEnabled
Type: boolean

Indicates whether incident logs are enabled for the cloud VM cluster.

DatabaseCloneConfiguration

Description

The configuration for creating an Autonomous Database as a clone of an existing database.

Members
cloneType
Required: Yes
Type: string

The type of clone to create, either a full clone, a metadata clone, or a partial clone.

sourceAutonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the source Autonomous Database to clone.

DatabaseConnectionStringProfile

Description

A connection string profile for an Autonomous Database.

Members
consumerGroup
Type: string

The consumer group associated with the connection string profile.

displayName
Type: string

The user-friendly name of the connection string profile.

hostFormat
Type: string

The host name format used in the connection string.

isRegional
Type: boolean

Indicates whether the connection string profile is regional.

protocol
Type: string

The protocol used by the connection string profile.

sessionMode
Type: string

The session mode of the connection string profile.

syntaxFormat
Type: string

The syntax format of the connection string profile.

tlsAuthentication
Type: string

The TLS authentication method used by the connection string profile.

value
Type: string

The connection string value of the profile.

DatabaseStandbySummary

Description

A summary of a standby Autonomous Database in an Oracle Data Guard configuration.

Members
availabilityDomain
Type: string

The availability domain of the standby Autonomous Database.

lagTimeInSeconds
Type: int

The time lag, in seconds, between the standby database and the primary database.

maintenanceTargetComponent
Type: string

The component on the standby Autonomous Database that the current maintenance is being applied to.

status
Type: string

The current status of the standby Autonomous Database.

statusReason
Type: string

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

timeDataGuardRoleChanged
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the Oracle Data Guard role of the standby database last changed.

timeDisasterRecoveryRoleChanged
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the disaster recovery role of the standby database last changed.

timeMaintenanceBegin
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the next maintenance of the standby database begins.

timeMaintenanceEnd
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the next maintenance of the standby database ends.

DatabaseTool

Description

Information about a database management tool for an Autonomous Database.

Members
computeCount
Type: double

The compute capacity allocated to the database management tool.

isEnabled
Type: boolean

Indicates whether the database management tool is enabled.

maxIdleTimeInMinutes
Type: int

The maximum amount of time, in minutes, that the database management tool can be idle before it is shut down.

name
Type: string

The name of the database management tool.

DayOfWeek

Description

An enumeration of days of the week used for scheduling maintenance windows.

Members
name
Type: string

The name of the day of the week.

DbIormConfig

Description

The IORM configuration settings for the database.

Members
dbName
Type: string

The database name. For the default DbPlan, the dbName is default.

flashCacheLimit
Type: string

The flash cache limit for this database. This value is internally configured based on the share value assigned to the database.

share
Type: int

The relative priority of this database.

DbNode

Description

Information about a DB node.

Members
additionalDetails
Type: string

Additional information about the planned maintenance.

backupIpId
Type: string

The Oracle Cloud ID (OCID) of the backup IP address that's associated with the DB node.

backupVnic2Id
Type: string

The OCID of the second backup VNIC.

backupVnicId
Type: string

The OCID of the backup VNIC.

cpuCoreCount
Type: int

Number of CPU cores enabled on the DB node.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the DB node was created.

dbNodeArn
Type: string

The Amazon Resource Name (ARN) of the DB node.

dbNodeId
Type: string

The unique identifier of the DB node.

dbNodeStorageSizeInGBs
Type: int

The amount of local node storage, in gigabytes (GBs), that's allocated on the DB node.

dbServerId
Type: string

The unique identifier of the Db server that is associated with the DB node.

dbSystemId
Type: string

The OCID of the DB system.

faultDomain
Type: string

The name of the fault domain the instance is contained in.

floatingIpAddress
Type: string

The floating IP address assigned to the DB node.

hostIpId
Type: string

The OCID of the host IP address that's associated with the DB node.

hostname
Type: string

The host name for the DB node.

maintenanceType
Type: string

The type of database node maintenance. Either VMDB_REBOOT_MIGRATION or EXADBXS_REBOOT_MIGRATION.

memorySizeInGBs
Type: int

The allocated memory in GBs on the DB node.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor for the DB node.

ocid
Type: string

The OCID of the DB node.

privateIpAddress
Type: string

The private IP address assigned to the DB node.

softwareStorageSizeInGB
Type: int

The size (in GB) of the block storage volume allocation for the DB system.

status
Type: string

The current status of the DB node.

statusReason
Type: string

Additional information about the status of the DB node.

timeMaintenanceWindowEnd
Type: string

End date and time of maintenance window.

timeMaintenanceWindowStart
Type: string

Start date and time of maintenance window.

totalCpuCoreCount
Type: int

The total number of CPU cores reserved on the DB node.

vnic2Id
Type: string

The OCID of the second VNIC.

vnicId
Type: string

The OCID of the VNIC.

DbNodeSummary

Description

Information about a DB node.

Members
additionalDetails
Type: string

Additional information about the planned maintenance.

backupIpId
Type: string

The Oracle Cloud ID (OCID) of the backup IP address that's associated with the DB node.

backupVnic2Id
Type: string

The OCID of the second backup virtual network interface card (VNIC) for the DB node.

backupVnicId
Type: string

The OCID of the backup VNIC for the DB node.

cpuCoreCount
Type: int

The number of CPU cores enabled on the DB node.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the DB node was created.

dbNodeArn
Type: string

The Amazon Resource Name (ARN) of the DB node.

dbNodeId
Type: string

The unique identifier of the DB node.

dbNodeStorageSizeInGBs
Type: int

The amount of local node storage, in gigabytes (GB), that's allocated on the DB node.

dbServerId
Type: string

The unique identifier of the database server that's associated with the DB node.

dbSystemId
Type: string

The OCID of the DB system.

faultDomain
Type: string

The name of the fault domain where the DB node is located.

hostIpId
Type: string

The OCID of the host IP address that's associated with the DB node.

hostname
Type: string

The host name for the DB node.

maintenanceType
Type: string

The type of maintenance the DB node.

memorySizeInGBs
Type: int

The amount of memory, in gigabytes (GB), that allocated on the DB node.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor for the DB node.

ocid
Type: string

The OCID of the DB node.

softwareStorageSizeInGB
Type: int

The size of the block storage volume, in gigabytes (GB), that's allocated for the DB system. This attribute applies only for virtual machine DB systems.

status
Type: string

The current status of the DB node.

statusReason
Type: string

Additional information about the status of the DB node.

timeMaintenanceWindowEnd
Type: string

The end date and time of the maintenance window.

timeMaintenanceWindowStart
Type: string

The start date and time of the maintenance window.

totalCpuCoreCount
Type: int

The total number of CPU cores reserved on the DB node.

vnic2Id
Type: string

The OCID of the second VNIC.

vnicId
Type: string

The OCID of the VNIC.

DbServer

Description

Information about a database server.

Members
autonomousVirtualMachineIds
Type: Array of strings

The list of unique identifiers for the Autonomous VMs associated with this database server.

autonomousVmClusterIds
Type: Array of strings

The list of identifiers for the Autonomous VM clusters associated with this database server.

computeModel
Type: string

The compute model of the database server (ECPU or OCPU).

cpuCoreCount
Type: int

The number of CPU cores enabled on the database server.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the database server was created.

dbNodeStorageSizeInGBs
Type: int

The allocated local node storage in GBs on the database server.

dbServerId
Type: string

The unique identifier for the database server.

dbServerPatchingDetails
Type: DbServerPatchingDetails structure

The scheduling details for the quarterly maintenance window. Patching and system updates take place during the maintenance window.

displayName
Type: string

The user-friendly name of the database server.

exadataInfrastructureId
Type: string

The ID of the Exadata infrastructure the database server belongs to.

maxCpuCount
Type: int

The total number of CPU cores available.

maxDbNodeStorageInGBs
Type: int

The total local node storage available in GBs.

maxMemoryInGBs
Type: int

The total memory available in GBs.

memorySizeInGBs
Type: int

The allocated memory in GBs on the database server.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor for the database server.

ocid
Type: string

The OCID of the database server.

shape
Type: string

The shape of the database server. The shape determines the amount of CPU, storage, and memory resources available.

status
Type: string

The current status of the database server.

statusReason
Type: string

Additional information about the current status of the database server.

vmClusterIds
Type: Array of strings

The OCID of the VM clusters that are associated with the database server.

DbServerPatchingDetails

Description

The scheduling details for the quarterly maintenance window. Patching and system updates take place during the maintenance window.

Members
estimatedPatchDuration
Type: int

Estimated time, in minutes, to patch one database server.

patchingStatus
Type: string

The status of the patching operation. Possible values are SCHEDULED, MAINTENANCE_IN_PROGRESS, FAILED, and COMPLETE.

timePatchingEnded
Type: string

The time when the patching operation ended.

timePatchingStarted
Type: string

The time when the patching operation started.

DbServerSummary

Description

Information about a database server.

Members
autonomousVirtualMachineIds
Type: Array of strings

A list of unique identifiers for the Autonomous VMs.

autonomousVmClusterIds
Type: Array of strings

A list of identifiers for the Autonomous VM clusters.

computeModel
Type: string

The OCI model compute model used when you create or clone an instance: ECPU or OCPU. An ECPU is an abstracted measure of compute resources. ECPUs are based on the number of cores elastically allocated from a pool of compute and storage servers. An OCPU is a legacy physical measure of compute resources. OCPUs are based on the physical core of a processor with hyper-threading enabled.

cpuCoreCount
Type: int

The number of CPU cores enabled on the database server.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the database server was created.

dbNodeStorageSizeInGBs
Type: int

The amount of local node storage, in gigabytes (GB), that's allocated on the database server.

dbServerId
Type: string

The unique identifier of the database server.

dbServerPatchingDetails
Type: DbServerPatchingDetails structure

The scheduling details for the quarterly maintenance window. Patching and system updates take place during the maintenance window.

displayName
Type: string

The user-friendly name of the database server. The name doesn't need to be unique.

exadataInfrastructureId
Type: string

The ID of the Exadata infrastructure that hosts the database server.

maxCpuCount
Type: int

The total number of CPU cores available on the database server.

maxDbNodeStorageInGBs
Type: int

The total amount of local node storage, in gigabytes (GB), that's available on the database server.

maxMemoryInGBs
Type: int

The total amount of memory, in gigabytes (GB), that's available on the database server.

memorySizeInGBs
Type: int

The amount of memory, in gigabytes (GB), that's allocated on the database server.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor for the database server.

ocid
Type: string

The OCID of the database server.

shape
Type: string

The hardware system model of the Exadata infrastructure that the database server is hosted on. The shape determines the amount of CPU, storage, and memory resources available.

status
Type: string

The current status of the database server.

statusReason
Type: string

Additional information about the status of the database server.

vmClusterIds
Type: Array of strings

The IDs of the VM clusters that are associated with the database server.

DbSystemShapeSummary

Description

Information about a hardware system model (shape) that's available for an Exadata infrastructure. The shape determines resources, such as CPU cores, memory, and storage, to allocate to the Exadata infrastructure.

Members
areServerTypesSupported
Type: boolean

Indicates whether the hardware system model supports configurable database and server storage types.

availableCoreCount
Type: int

The maximum number of CPU cores that can be enabled for the shape.

availableCoreCountPerNode
Type: int

The maximum number of CPU cores per DB node that can be enabled for the shape.

availableDataStorageInTBs
Type: int

The maximum amount of data storage, in terabytes (TB), that can be enabled for the shape.

availableDataStoragePerServerInTBs
Type: int

The maximum amount of data storage, in terabytes (TB), that's available per storage server for the shape.

availableDbNodePerNodeInGBs
Type: int

The maximum amount of DB node storage, in gigabytes (GB), that's available per DB node for the shape.

availableDbNodeStorageInGBs
Type: int

The maximum amount of DB node storage, in gigabytes (GB), that can be enabled for the shape.

availableMemoryInGBs
Type: int

The maximum amount of memory, in gigabytes (GB), that can be enabled for the shape.

availableMemoryPerNodeInGBs
Type: int

The maximum amount of memory, in gigabytes (GB), that's available per DB node for the shape.

computeModel
Type: string

The OCI model compute model used when you create or clone an instance: ECPU or OCPU. An ECPU is an abstracted measure of compute resources. ECPUs are based on the number of cores elastically allocated from a pool of compute and storage servers. An OCPU is a legacy physical measure of compute resources. OCPUs are based on the physical core of a processor with hyper-threading enabled.

coreCountIncrement
Type: int

The discrete number by which the CPU core count for the shape can be increased or decreased.

maxStorageCount
Type: int

The maximum number of Exadata storage servers that's available for the shape.

maximumNodeCount
Type: int

The maximum number of compute servers that is available for the shape.

minCoreCountPerNode
Type: int

The minimum number of CPU cores that can be enabled per node for the shape.

minDataStorageInTBs
Type: int

The minimum amount of data storage, in terabytes (TB), that must be allocated for the shape.

minDbNodeStoragePerNodeInGBs
Type: int

The minimum amount of DB node storage, in gigabytes (GB), that must be allocated per DB node for the shape.

minMemoryPerNodeInGBs
Type: int

The minimum amount of memory, in gigabytes (GB), that must be allocated per DB node for the shape.

minStorageCount
Type: int

The minimum number of Exadata storage servers that are available for the shape.

minimumCoreCount
Type: int

The minimum number of CPU cores that can be enabled for the shape.

minimumNodeCount
Type: int

The minimum number of compute servers that are available for the shape.

name
Type: string

The name of the shape.

runtimeMinimumCoreCount
Type: int

The runtime minimum number of CPU cores that can be enabled for the shape.

shapeFamily
Type: string

The family of the shape.

shapeType
Type: string

The shape type. This property is determined by the CPU hardware.

DisasterRecoveryConfiguration

Description

The disaster recovery configuration for an Autonomous Database.

Members
disasterRecoveryType
Type: string

The type of disaster recovery configured for the Autonomous Database.

isReplicateAutomaticBackups
Type: boolean

Indicates whether automatic backups are replicated to the disaster recovery database.

isSnapshotStandby
Type: boolean

Indicates whether the standby database is a snapshot standby.

timeSnapshotStandbyEnabledTill
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time until which the snapshot standby database remains enabled.

EncryptionKeyConfiguration

Description

The configuration of the encryption key used for an Autonomous Database. This is a union, so only one of the following members can be specified.

Members
awsEncryptionKey

The configuration of the Amazon Web Services Key Management Service (KMS) encryption key.

ociEncryptionKey

The configuration of the Oracle Cloud Infrastructure (OCI) Vault encryption key.

okvEncryptionKey

The configuration of the Oracle Key Vault (OKV) encryption key.

EncryptionKeyConfigurationInput

Description

The configuration of the encryption key to use for an Autonomous Database. This is a union, so only one of the following members can be specified.

Members
awsEncryptionKey

The configuration of the Amazon Web Services Key Management Service (KMS) encryption key to use.

EncryptionSummary

Description

The encryption configuration for an Autonomous Database.

Members
encryptionKeyConfiguration
Type: EncryptionKeyConfiguration structure

The configuration of the encryption key used for the Autonomous Database.

encryptionKeyProvider
Type: string

The provider of the encryption key used for the Autonomous Database.

ExadataIormConfig

Description

The IORM settings of the Exadata DB system.

Members
dbPlans
Type: Array of DbIormConfig structures

An array of IORM settings for all the database in the Exadata DB system.

lifecycleDetails
Type: string

Additional information about the current lifecycleState.

lifecycleState
Type: string

The current state of IORM configuration for the Exadata DB system.

objective
Type: string

The current value for the IORM objective. The default is AUTO.

GiVersionSummary

Description

Information about a specific version of Oracle Grid Infrastructure (GI) software that can be installed on a VM cluster.

Members
version
Type: string

The GI software version.

IamRole

Description

Information about an Amazon Web Services Identity and Access Management (IAM) service role associated with a resource.

Members
awsIntegration
Type: string

The Amazon Web Services integration configuration settings for the Amazon Web Services Identity and Access Management (IAM) service role.

iamRoleArn
Type: string

The Amazon Resource Name (ARN) of the Amazon Web Services Identity and Access Management (IAM) service role.

status
Type: string

The current status of the Amazon Web Services Identity and Access Management (IAM) service role.

statusReason
Type: string

Additional information about the current status of the Amazon Web Services Identity and Access Management (IAM) service role, if applicable.

InternalServerException

Description

Occurs when there is an internal failure in the Oracle Database@Amazon Web Services service. Wait and try again.

Members
message
Required: Yes
Type: string
retryAfterSeconds
Type: int

The number of seconds to wait before retrying the request after an internal server error.

KmsAccess

Description

Configuration for Amazon Web Services Key Management Service (KMS) access from the ODB network.

Members
domainName
Type: string

The domain name for Amazon Web Services Key Management Service (KMS) access configuration.

ipv4Addresses
Type: Array of strings

The IPv4 addresses allowed for Amazon Web Services Key Management Service (KMS) access.

kmsPolicyDocument
Type: string

The Amazon Web Services Key Management Service (KMS) policy document that defines permissions for key usage.

status
Type: string

The current status of the Amazon Web Services Key Management Service (KMS) access configuration.

LongTermBackupSchedule

Description

The long-term backup schedule for an Autonomous Database.

Members
isDisabled
Type: boolean

Indicates whether the long-term backup schedule is disabled.

repeatCadence
Type: string

The cadence at which long-term backups are taken.

retentionPeriodInDays
Type: int

The retention period, in days, for long-term backups.

timeOfBackup
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time at which the long-term backup is taken.

MaintenanceWindow

Description

The scheduling details for the maintenance window. Patching and system updates take place during the maintenance window.

Members
customActionTimeoutInMins
Type: int

The custom action timeout in minutes for the maintenance window.

daysOfWeek
Type: Array of DayOfWeek structures

The days of the week when maintenance can be performed.

hoursOfDay
Type: Array of ints

The hours of the day when maintenance can be performed.

isCustomActionTimeoutEnabled
Type: boolean

Indicates whether custom action timeout is enabled for the maintenance window.

leadTimeInWeeks
Type: int

The lead time in weeks before the maintenance window.

months
Type: Array of Month structures

The months when maintenance can be performed.

patchingMode
Type: string

The patching mode for the maintenance window.

preference
Type: string

The preference for the maintenance window scheduling.

skipRu
Type: boolean

Indicates whether to skip release updates during maintenance.

weeksOfMonth
Type: Array of ints

The weeks of the month when maintenance can be performed.

ManagedS3BackupAccess

Description

The configuration for managed Amazon S3 backup access from the ODB network.

Members
ipv4Addresses
Type: Array of strings

The IPv4 addresses for the managed Amazon S3 backup access.

status
Type: string

The status of the managed Amazon S3 backup access.

ManagedServices

Description

The managed services configuration for the ODB network.

Members
crossRegionS3RestoreSourcesAccess
Type: Array of CrossRegionS3RestoreSourcesAccess structures

The access configuration for the cross-Region Amazon S3 database restore source.

kmsAccess
Type: KmsAccess structure

The Amazon Web Services Key Management Service (KMS) access configuration.

managedS3BackupAccess
Type: ManagedS3BackupAccess structure

The managed Amazon S3 backup access configuration.

managedServicesIpv4Cidrs
Type: Array of strings

The IPv4 CIDR blocks for the managed services.

resourceGatewayArn
Type: string

The Amazon Resource Name (ARN) of the resource gateway.

s3Access
Type: S3Access structure

The Amazon S3 access configuration.

serviceNetworkArn
Type: string

The Amazon Resource Name (ARN) of the service network.

serviceNetworkEndpoint
Type: ServiceNetworkEndpoint structure

The service network endpoint configuration.

stsAccess
Type: StsAccess structure

The Amazon Web Services Security Token Service (STS) access configuration.

zeroEtlAccess
Type: ZeroEtlAccess structure

The Zero-ETL access configuration.

Month

Description

An enumeration of months used for scheduling maintenance windows.

Members
name
Type: string

The name of the month.

OciDnsForwardingConfig

Description

DNS configuration to forward DNS resolver endpoints to your OCI Private Zone.

Members
domainName
Type: string

Domain name to which DNS resolver forwards to.

ociDnsListenerIp
Type: string

OCI DNS listener IP for custom DNS setup.

OciEncryptionKeyConfiguration

Description

The configuration of the Oracle Cloud Infrastructure (OCI) Vault encryption key used for an Autonomous Database.

Members
kmsKeyId
Required: Yes
Type: string

The Oracle Cloud Identifier (OCID) of the OCI Vault key to use for encryption.

vaultId
Required: Yes
Type: string

The Oracle Cloud Identifier (OCID) of the OCI Vault that contains the encryption key.

OciIamRole

Description

Information about an Amazon Web Services Identity and Access Management (IAM) service role used for Autonomous Database integration with Oracle Cloud Infrastructure (OCI).

Members
awsIntegration
Type: string

The Amazon Web Services integration configuration settings for the Amazon Web Services Identity and Access Management (IAM) service role.

iamRoleArn
Type: string

The Amazon Resource Name (ARN) of the Amazon Web Services Identity and Access Management (IAM) service role.

OciIdentityDomain

Description

Information about an Oracle Cloud Infrastructure (OCI) identity domain configuration.

Members
accountSetupCloudFormationUrl
Type: string

The Amazon Web Services CloudFormation URL for setting up the account integration with the OCI identity domain.

ociIdentityDomainId
Type: string

The unique identifier of the OCI identity domain.

ociIdentityDomainResourceUrl
Type: string

The resource URL for accessing the OCI identity domain.

ociIdentityDomainUrl
Type: string

The URL of the OCI identity domain.

status
Type: string

The current status of the OCI identity domain.

statusReason
Type: string

Additional information about the current status of the OCI identity domain, if applicable.

OdbNetwork

Description

Information about an ODB network.

Members
availabilityZone
Type: string

The Amazon Web Services Availability Zone (AZ) where the ODB network is located.

availabilityZoneId
Type: string

The AZ ID of the AZ where the ODB network is located.

backupSubnetCidr
Type: string

The CIDR range of the backup subnet in the ODB network.

clientSubnetCidr
Type: string

The CIDR range of the client subnet in the ODB network.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the ODB network was created.

customDomainName
Type: string

The domain name for the resources in the ODB network.

defaultDnsPrefix
Type: string

The DNS prefix to the default DNS domain name. The default DNS domain name is oraclevcn.com.

displayName
Type: string

The user-friendly name of the ODB network.

ec2PlacementGroupIds
Type: Array of strings

The list of EC2 Placement Group IDs associated with your ODB network.

managedServices
Type: ManagedServices structure

The managed services configuration for the ODB network.

ociDnsForwardingConfigs
Type: Array of OciDnsForwardingConfig structures

The DNS resolver endpoint in OCI for forwarding DNS queries for the ociPrivateZone domain.

ociNetworkAnchorId
Type: string

The unique identifier of the OCI network anchor for the ODB network.

ociNetworkAnchorUrl
Type: string

The URL of the OCI network anchor for the ODB network.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor that's associated with the ODB network.

ociVcnId
Type: string

The Oracle Cloud ID (OCID) for the Virtual Cloud Network (VCN) that's associated with the ODB network.

ociVcnUrl
Type: string

The URL for the VCN that's associated with the ODB network.

odbNetworkArn
Type: string

The Amazon Resource Name (ARN) of the ODB network.

odbNetworkId
Required: Yes
Type: string

The unique identifier of the ODB network.

peeredCidrs
Type: Array of strings

The list of CIDR ranges from the peered VPC that are allowed access to the ODB network.

percentProgress
Type: float

The amount of progress made on the current operation on the ODB network, expressed as a percentage.

status
Type: string

The current status of the ODB network.

statusReason
Type: string

Additional information about the current status of the ODB network.

OdbNetworkSummary

Description

Information about an ODB network.

Members
availabilityZone
Type: string

The Amazon Web Services Availability Zone (AZ) where the ODB network is located.

availabilityZoneId
Type: string

The AZ ID of the AZ where the ODB network is located.

backupSubnetCidr
Type: string

The CIDR range of the backup subnet in the ODB network.

clientSubnetCidr
Type: string

The CIDR range of the client subnet in the ODB network.

createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time when the ODB network was created.

customDomainName
Type: string

The domain name for the resources in the ODB network.

defaultDnsPrefix
Type: string

The DNS prefix to the default DNS domain name. The default DNS domain name is oraclevcn.com.

displayName
Type: string

The user-friendly name of the ODB network.

ec2PlacementGroupIds
Type: Array of strings

The list of EC2 Placement Group IDs associated with your ODB network.

managedServices
Type: ManagedServices structure

The managed services configuration for the ODB network.

ociDnsForwardingConfigs
Type: Array of OciDnsForwardingConfig structures

The DNS resolver endpoint in OCI for forwarding DNS queries for the ociPrivateZone domain.

ociNetworkAnchorId
Type: string

The unique identifier of the OCI network anchor for the ODB network.

ociNetworkAnchorUrl
Type: string

The URL of the OCI network anchor for the ODB network.

ociResourceAnchorName
Type: string

The name of the OCI resource anchor associated with the ODB network.

ociVcnId
Type: string

The Oracle Cloud ID (OCID) for the Virtual Cloud Network (VCN) associated with the ODB network.

ociVcnUrl
Type: string

The URL for the VCN that's associated with the ODB network.

odbNetworkArn
Type: string

The Amazon Resource Name (ARN) of the ODB network.

odbNetworkId
Required: Yes
Type: string

The unique identifier of the ODB network.

peeredCidrs
Type: Array of strings

The list of CIDR ranges from the peered VPC that are allowed access to the ODB network.

percentProgress
Type: float

The amount of progress made on the current operation on the ODB network, expressed as a percentage.

status
Type: string

The current status of the ODB network.

statusReason
Type: string

Additional information about the current status of the ODB network.

OdbPeeringConnection

Description

A peering connection between an ODB network and either another ODB network or a customer-owned VPC.

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp when the ODB peering connection was created.

displayName
Type: string

The display name of the ODB peering connection.

odbNetworkArn
Type: string

The Amazon Resource Name (ARN) of the ODB network that initiated the peering connection.

odbPeeringConnectionArn
Type: string

The Amazon Resource Name (ARN) of the ODB peering connection.

Example: arn:aws:odb:us-east-1:123456789012:odb-peering-connection/odbpcx-abcdefgh12345678

odbPeeringConnectionId
Required: Yes
Type: string

The unique identifier of the ODB peering connection. A sample ID is odbpcx-abcdefgh12345678.

odbPeeringConnectionType
Type: string

The type of the ODB peering connection.

Valid Values: ODB-VPC | ODB-ODB

peerNetworkArn
Type: string

The Amazon Resource Name (ARN) of the peer network.

peerNetworkCidrs
Type: Array of strings

The CIDR blocks associated with the peering connection. These CIDR blocks define the IP address ranges that can communicate through the peering connection.

percentProgress
Type: float

The percentage progress of the ODB peering connection creation or deletion.

status
Type: string

The status of the ODB peering connection.

statusReason
Type: string

The reason for the current status of the ODB peering connection.

OdbPeeringConnectionSummary

Description

A summary of an ODB peering connection.

Members
createdAt
Type: timestamp (string|DateTime or anything parsable by strtotime)

The timestamp when the ODB peering connection was created.

displayName
Type: string

The display name of the ODB peering connection.

odbNetworkArn
Type: string

The Amazon Resource Name (ARN) of the ODB network that initiated the peering connection.

odbPeeringConnectionArn
Type: string

The Amazon Resource Name (ARN) of the ODB peering connection.

odbPeeringConnectionId
Required: Yes
Type: string

The unique identifier of the ODB peering connection. A sample ID is odbpcx-abcdefgh12345678.

odbPeeringConnectionType
Type: string

The type of the ODB peering connection.

Valid Values: ODB-VPC | ODB-ODB

peerNetworkArn
Type: string

The Amazon Resource Name (ARN) of the peer network.

peerNetworkCidrs
Type: Array of strings

The CIDR blocks associated with the peering connection. These CIDR blocks define the IP address ranges that can communicate through the peering connection.

percentProgress
Type: float

The percentage progress of the ODB peering connection creation or deletion.

status
Type: string

The status of the ODB peering connection.

statusReason
Type: string

The reason for the current status of the ODB peering connection.

OkvEncryptionKeyConfiguration

Description

The configuration of the Oracle Key Vault (OKV) encryption key used for an Autonomous Database.

Members
certificateDirectoryName
Required: Yes
Type: string

The name of the directory that contains the Oracle Key Vault (OKV) certificate.

certificateId
Type: string

The identifier of the Oracle Key Vault (OKV) certificate.

directoryName
Required: Yes
Type: string

The name of the directory where the Oracle Key Vault (OKV) configuration is stored.

okvKmsKey
Required: Yes
Type: string

The identifier of the Oracle Key Vault (OKV) key to use for encryption.

okvUri
Required: Yes
Type: string

The URI of the Oracle Key Vault (OKV) server.

PointInTimeRestoreConfiguration

Description

The configuration for creating an Autonomous Database by restoring to a point in time.

Members
cloneTableSpaceList
Type: Array of ints

The list of tablespace identifiers to clone from the point-in-time restore.

cloneType
Required: Yes
Type: string

The type of clone to create from the point-in-time restore.

sourceAutonomousDatabaseId
Required: Yes
Type: string

The unique identifier of the source Autonomous Database to restore from.

timestamp
Type: timestamp (string|DateTime or anything parsable by strtotime)

The date and time to which to restore the Autonomous Database.

useLatestAvailableBackupTimestamp
Type: boolean

Indicates whether to use the latest available backup timestamp for the restore.

ResourceNotFoundException

Description

The operation tried to access a resource that doesn't exist. Make sure you provided the correct resource and try again.

Members
message
Required: Yes
Type: string
resourceId
Required: Yes
Type: string

The identifier of the resource that was not found.

resourceType
Required: Yes
Type: string

The type of resource that was not found.

ResourcePoolSummary

Description

The configuration of a resource pool for an Autonomous Database.

Members
availableComputeCapacity
Type: int

The available compute capacity in the resource pool.

availableStorageCapacityInTBs
Type: double

The available storage capacity in the resource pool, in TB.

isDisabled
Type: boolean

Indicates whether the resource pool is disabled.

poolSize
Type: int

The number of Autonomous Databases that the resource pool can contain.

poolStorageSizeInTBs
Type: int

The total storage size of the resource pool, in terabytes (TB).

totalComputeCapacity
Type: int

The total compute capacity of the resource pool.

RestoreFromBackupConfiguration

Description

The configuration for creating an Autonomous Database by restoring from a backup.

Members
autonomousDatabaseBackupId
Required: Yes
Type: string

The unique identifier of the Autonomous Database backup to restore from.

cloneTableSpaceList
Type: Array of ints

The list of tablespace identifiers to clone from the backup.

cloneType
Required: Yes
Type: string

The type of clone to create from the backup.

S3Access

Description

The configuration for Amazon S3 access from the ODB network.

Members
domainName
Type: string

The domain name for the Amazon S3 access.

ipv4Addresses
Type: Array of strings

The IPv4 addresses for the Amazon S3 access.

s3PolicyDocument
Type: string

The endpoint policy for the Amazon S3 access.

status
Type: string

The status of the Amazon S3 access.

ScheduledOperationDetails

Description

The scheduled start and stop times for an Autonomous Database on a specific day of the week.

Members
dayOfWeek
Required: Yes
Type: DayOfWeek structure

The day of the week on which the scheduled operation occurs.

scheduledStartTime
Type: string

The scheduled start time for the Autonomous Database, in UTC.

scheduledStopTime
Type: string

The scheduled stop time for the Autonomous Database, in UTC.

ServiceNetworkEndpoint

Description

The configuration for a service network endpoint.

Members
vpcEndpointId
Type: string

The identifier of the VPC endpoint.

vpcEndpointType
Type: string

The type of the VPC endpoint.

ServiceQuotaExceededException

Description

You have exceeded the service quota.

Members
message
Required: Yes
Type: string
quotaCode
Required: Yes
Type: string

The unqiue identifier of the service quota that was exceeded.

resourceId
Required: Yes
Type: string

The identifier of the resource that exceeded the service quota.

resourceType
Required: Yes
Type: string

The type of resource that exceeded the service quota.

SourceConfiguration

Description

The configuration details for the source used to create an Autonomous Database. This is a union, so only one of the following members can be specified.

Members
cloneToRefreshable

The configuration for creating the Autonomous Database as a refreshable clone.

crossRegionDataGuard

The configuration for creating the Autonomous Database as a cross-Region Oracle Data Guard peer.

crossRegionDisasterRecovery

The configuration for creating the Autonomous Database as a cross-Region disaster recovery peer.

databaseClone
Type: DatabaseCloneConfiguration structure

The configuration for creating the Autonomous Database as a clone of an existing database.

pointInTimeRestore

The configuration for creating the Autonomous Database by restoring to a point in time.

restoreFromBackup

The configuration for creating the Autonomous Database by restoring from a backup.

StsAccess

Description

Configuration for Amazon Web Services Security Token Service (STS) access from the ODB network.

Members
domainName
Type: string

The domain name for Amazon Web Services Security Token Service (STS) access configuration.

ipv4Addresses
Type: Array of strings

The IPv4 addresses allowed for Amazon Web Services Security Token Service (STS) access.

status
Type: string

The current status of the Amazon Web Services Security Token Service (STS) access configuration.

stsPolicyDocument
Type: string

The Amazon Web Services Security Token Service (STS) policy document that defines permissions for token service usage.

SubscriptionError

Description

Information about an error that occurred during the subscription process.

Members
errorMessage
Type: string

A human-readable message that describes the subscription error.

SystemVersionSummary

Description

Information about the compatible system versions that can be used with a specific Exadata shape and Grid Infrastructure (GI) version.

Members
giVersion
Type: string

The version of GI software.

shape
Type: string

The Exadata hardware model.

systemVersions
Type: Array of strings

The Exadata system versions that are compatible with the specified Exadata shape and GI version.

ThrottlingException

Description

The request was denied due to request throttling.

Members
message
Required: Yes
Type: string
retryAfterSeconds
Type: int

The number of seconds to wait before retrying the request after being throttled.

TransportableTablespace

Description

The transportable tablespace configuration used when creating an Autonomous Database.

Members
ttsBundleUrl
Type: string

The URL of the transportable tablespace bundle to use when creating the Autonomous Database.

ValidationException

Description

The request has failed validation because it is missing required fields or has invalid inputs.

Members
fieldList
Type: Array of ValidationExceptionField structures

A list of fields that failed validation.

message
Required: Yes
Type: string
reason
Required: Yes
Type: string

The reason why the validation failed.

ValidationExceptionField

Description

The input failed to meet the constraints specified by the service in a specified field. Make sure you provided the correct input and try again.

Members
message
Required: Yes
Type: string

The description of the error.

name
Required: Yes
Type: string

The field name for which validation failed.

ZeroEtlAccess

Description

The configuration for Zero-ETL access from the ODB network.

Members
cidr
Type: string

The CIDR block for the Zero-ETL access.

status
Type: string

The status of the Zero-ETL access.