odb 2024-08-20
- 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
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
oravailabilityZoneId
.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
oravailabilityZoneId
.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
, and7879
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
oravailabilityZoneId
. - 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
oravailabilityZoneId
. - 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
and100.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
and100.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
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
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
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
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
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
-
- Type: CloudExadataInfrastructureUnallocatedResources structure
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
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
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
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
orBRING_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
-
- 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
orEXADBXS_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
, andCOMPLETE
. - 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