SDK for PHP 3.x

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.
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 either another ODB network or a customer-owned VPC.
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.
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.
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.
RebootDbNode ( array $params = [] )
Reboots the specified DB node in a VM cluster.
StartDbNode ( array $params = [] )
Starts the specified DB node in a VM cluster.
StopDbNode ( array $params = [] )
Stops the specified DB node in a VM cluster.
TagResource ( array $params = [] )
Applies tags to the specified resource.
UntagResource ( array $params = [] )
Removes tags from the specified resource.
UpdateCloudExadataInfrastructure ( array $params = [] )
Updates the properties of an Exadata infrastructure resource.
UpdateOdbNetwork ( array $params = [] )
Updates properties of a specified ODB network.

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:

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.

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>',
    'customDomainName' => '<string>',
    'defaultDnsPrefix' => '<string>',
    'displayName' => '<string>', // REQUIRED
    's3Access' => 'ENABLED|DISABLED',
    's3PolicyDocument' => '<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.

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.

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.

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 either another ODB network or a customer-owned 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
    'peerNetworkId' => '<string>', // REQUIRED
    '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.

peerNetworkId
Required: Yes
Type: string

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

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.

Valid Values: provisioning | active | terminating | terminated | failed

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.

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.

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>',
        '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>',
        '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>',
        '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' => [
        '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>',
        '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>',
        '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

[
    'existingTenancyActivationLink' => '<string>',
    'newTenancyActivationLink' => '<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',
]

Result Details

Members
existingTenancyActivationLink
Type: string

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

newTenancyActivationLink
Type: string

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

status
Type: string

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>',
        'managedServices' => [
            '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',
            ],
            '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>',
        '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([
]);

Parameter Details

Members

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.

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>',
            '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>',
            '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>',
            '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' => [
        [
            '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>',
            '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>',
            '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>',
            'managedServices' => [
                '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',
                ],
                '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>',
            '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.

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.

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.

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.

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.

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([
    'displayName' => '<string>',
    'odbNetworkId' => '<string>', // REQUIRED
    'peeredCidrsToBeAdded' => ['<string>', ...],
    'peeredCidrsToBeRemoved' => ['<string>', ...],
    's3Access' => 'ENABLED|DISABLED',
    's3PolicyDocument' => '<string>',
    'zeroEtlAccess' => 'ENABLED|DISABLED',
]);

Parameter Details

Members
displayName
Type: string

The new user-friendly name of 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.

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.

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

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.

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.

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.

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. Valid values are LICENSE_INCLUDED or BRING_YOUR_OWN_LICENSE.

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.

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.

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.

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.

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
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.

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.

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
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.

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.

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.

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.

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.

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.

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.

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.

Valid Values: enabled | disabled

ManagedServices

Description

The managed services configuration for the ODB network.

Members
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.

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.

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.

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.

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.

percentProgress
Type: float

The percentage progress of the ODB peering connection creation or deletion.

status
Type: string

The status of the ODB peering connection.

Valid Values: provisioning | active | terminating | terminated | failed

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.

percentProgress
Type: float

The percentage progress of the ODB peering connection creation or deletion.

status
Type: string

The status of the ODB peering connection.

Valid Values: provisioning | active | terminating | terminated | failed

statusReason
Type: string

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

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.

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.

Valid Values: enabled | disabled

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.

Valid Values: Interface | Gateway

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.

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.

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.

Valid Values: enabled | disabled