Cloud Exadata Infrastructures - Update

Service:: Oracle Database

API Version:: 2025-03-01

Update a CloudExadataInfrastructure

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Oracle.Database/cloudExadataInfrastructures/{cloudexadatainfrastructurename}?api-version=2025-03-01

URI Parameters

Name	In	Required	Type	Description
cloudexadatainfrastructurename	path	True	string pattern: .*	CloudExadataInfrastructure name
resourceGroupName	path	True	string minLength: 1 maxLength: 90	The name of the resource group. The name is case insensitive.
subscriptionId	path	True	string (uuid)	The ID of the target subscription. The value must be an UUID.
api-version	query	True	string minLength: 1	The API version to use for this operation.

Request Body

Name	Type	Description
properties.computeCount	integer (int32)	The number of compute servers for the cloud Exadata infrastructure.
properties.customerContacts	CustomerContact[]	The list of customer email addresses that receive information from Oracle about the specified OCI Database service resource. Oracle uses these email addresses to send notifications about planned and unplanned software maintenance updates, information about system hardware, and other information needed by administrators. Up to 10 email addresses can be added to the customer contacts for a cloud Exadata infrastructure instance.
properties.displayName	string minLength: 1 maxLength: 255	The name for the Exadata infrastructure.
properties.maintenanceWindow	MaintenanceWindow	maintenanceWindow property
properties.storageCount	integer (int32)	The number of storage servers for the cloud Exadata infrastructure.
tags	object	Resource tags.
zones	string[]	CloudExadataInfrastructure zones

Responses

Name	Type	Description
200 OK	CloudExadataInfrastructure	Azure operation completed successfully.
202 Accepted		Resource update request accepted. Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	An unexpected error response.

Name

Type

Description

200 OK

CloudExadataInfrastructure

Azure operation completed successfully.

202 Accepted

Resource update request accepted.

Headers

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

An unexpected error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

Patch Exadata Infrastructure

Sample request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg000/providers/Oracle.Database/cloudExadataInfrastructures/infra1?api-version=2025-03-01

{}

Sample response

Status code:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg000/providers/Oracle.Database/cloudExadataInfrastructures/infra1",
  "type": "Oracle.Database/cloudExadataInfrastructures",
  "location": "eastus",
  "tags": {
    "tagK1": "tagV1"
  },
  "properties": {
    "ocid": "ocid1..aaaaaa",
    "computeCount": 100,
    "storageCount": 10,
    "totalStorageSizeInGbs": 1000,
    "availableStorageSizeInGbs": 1000,
    "timeCreated": "2023-02-01T01:01:00",
    "lifecycleDetails": "none",
    "maintenanceWindow": {
      "preference": "NoPreference",
      "months": [
        {
          "name": "January"
        }
      ],
      "weeksOfMonth": [
        0
      ],
      "daysOfWeek": [
        {
          "name": "Monday"
        }
      ],
      "hoursOfDay": [
        0
      ],
      "leadTimeInWeeks": 0,
      "patchingMode": "Rolling",
      "customActionTimeoutInMins": 120,
      "isCustomActionTimeoutEnabled": true,
      "isMonthlyPatchingEnabled": true
    },
    "estimatedPatchingTime": {
      "estimatedDbServerPatchingTime": 3000,
      "estimatedNetworkSwitchesPatchingTime": 3000,
      "estimatedStorageServerPatchingTime": 3000,
      "totalEstimatedPatchingTime": 3000
    },
    "customerContacts": [
      {
        "email": "noreply@oracle.com"
      }
    ],
    "provisioningState": "Succeeded",
    "shape": "EXADATA.X9M",
    "ociUrl": "https://url",
    "cpuCount": 10,
    "maxCpuCount": 100,
    "memorySizeInGbs": 100,
    "maxMemoryInGbs": 1000,
    "dbNodeStorageSizeInGbs": 10,
    "maxDbNodeStorageSizeInGbs": 10,
    "dataStorageSizeInTbs": 10,
    "maxDataStorageInTbs": 1000,
    "dbServerVersion": "19.0.0.0",
    "storageServerVersion": "0.0",
    "activatedStorageCount": 1,
    "additionalStorageCount": 1,
    "displayName": "infra 1",
    "lastMaintenanceRunId": "ocid1..aaaaa",
    "nextMaintenanceRunId": "ocid1..aaaaaa",
    "monthlyDbServerVersion": "aaaa",
    "monthlyStorageServerVersion": "aaaa"
  },
  "zones": [
    "1"
  ]
}

Status code:: 202

Retry-After: 10000000
Location: eastus

Definitions

Name	Description
AzureResourceProvisioningState	Azure Resource Provisioning State enum
CloudExadataInfrastructure	CloudExadataInfrastructure resource definition
CloudExadataInfrastructureLifecycleState	CloudExadataInfrastructureLifecycleState enum
CloudExadataInfrastructureUpdate	The type used for update operations of the CloudExadataInfrastructure.
ComputeModel	Compute model enum
createdByType	The type of identity that created the resource.
CustomerContact	CustomerContact resource properties
DayOfWeek	DayOfWeek resource properties
DayOfWeekName	DayOfWeekName enum
DefinedFileSystemConfiguration	Predefined configurations for the file system
ErrorAdditionalInfo	The resource management error additional info.
ErrorDetail	The error detail.
ErrorResponse	Error response
EstimatedPatchingTime	The estimated total time required in minutes for all patching operations (database server, storage server, and network switch patching).
MaintenanceWindow	MaintenanceWindow resource properties
Month	Month resource properties
MonthName	MonthName enum
PatchingMode	Patching mode enum
Preference	Preference enum
systemData	Metadata pertaining to creation and last modification of the resource.

AzureResourceProvisioningState

Enumeration

Azure Resource Provisioning State enum

Value	Description
Canceled	Resource creation was canceled.
Failed	Resource creation failed.
Provisioning	Indicates that resource in Provisioning state
Succeeded	Resource has been created.

CloudExadataInfrastructure

Object

CloudExadataInfrastructure resource definition

Name	Type	Description
id	string (arm-id)	Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	The geo-location where the resource lives
name	string	The name of the resource
properties.activatedStorageCount	integer (int32)	The requested number of additional storage servers activated for the Exadata infrastructure.
properties.additionalStorageCount	integer (int32)	The requested number of additional storage servers for the Exadata infrastructure.
properties.availableStorageSizeInGbs	integer (int32)	The available storage can be allocated to the cloud Exadata infrastructure resource, in gigabytes (GB).
properties.computeCount	integer (int32)	The number of compute servers for the cloud Exadata infrastructure.
properties.computeModel	ComputeModel	The compute model of the Exadata Infrastructure
properties.cpuCount	integer (int32)	The total number of CPU cores allocated.
properties.customerContacts	CustomerContact[]	The list of customer email addresses that receive information from Oracle about the specified OCI Database service resource. Oracle uses these email addresses to send notifications about planned and unplanned software maintenance updates, information about system hardware, and other information needed by administrators. Up to 10 email addresses can be added to the customer contacts for a cloud Exadata infrastructure instance.
properties.dataStorageSizeInTbs	number (double)	The quantity of data in the database, in terabytes.
properties.databaseServerType	string minLength: 1 maxLength: 255	The database server model type of the cloud Exadata infrastructure resource.
properties.dbNodeStorageSizeInGbs	integer (int32)	The local node storage to be allocated in GBs.
properties.dbServerVersion	string	The software version of the database servers (dom0) in the Exadata infrastructure.
properties.definedFileSystemConfiguration	DefinedFileSystemConfiguration[]	Defined file system configurations
properties.displayName	string minLength: 1 maxLength: 255	The name for the Exadata infrastructure.
properties.estimatedPatchingTime	EstimatedPatchingTime	The estimated total time required in minutes for all patching operations (database server, storage server, and network switch patching).
properties.lastMaintenanceRunId	string minLength: 1 maxLength: 255	The OCID of the last maintenance run.
properties.lifecycleDetails	string	Additional information about the current lifecycle state.
properties.lifecycleState	CloudExadataInfrastructureLifecycleState	CloudExadataInfrastructure lifecycle state
properties.maintenanceWindow	MaintenanceWindow	maintenanceWindow property
properties.maxCpuCount	integer (int32)	The total number of CPU cores available.
properties.maxDataStorageInTbs	number (double)	The total available DATA disk group size.
properties.maxDbNodeStorageSizeInGbs	integer (int32)	The total local node storage available in GBs.
properties.maxMemoryInGbs	integer (int32)	The total memory available in GBs.
properties.memorySizeInGbs	integer (int32)	The memory allocated in GBs.
properties.monthlyDbServerVersion	string	Monthly Db Server version
properties.monthlyStorageServerVersion	string	Monthly Storage Server version
properties.nextMaintenanceRunId	string minLength: 1 maxLength: 255	The OCID of the next maintenance run.
properties.ociUrl	string (uri)	HTTPS link to OCI resources exposed to Azure Customer via Azure Interface.
properties.ocid	string minLength: 1 maxLength: 255	Exadata infra ocid
properties.provisioningState	AzureResourceProvisioningState	CloudExadataInfrastructure provisioning state
properties.shape	string	The model name of the cloud Exadata infrastructure resource.
properties.storageCount	integer (int32)	The number of storage servers for the cloud Exadata infrastructure.
properties.storageServerType	string minLength: 1 maxLength: 255	The storage server model type of the cloud Exadata infrastructure resource.
properties.storageServerVersion	string	The software version of the storage servers (cells) in the Exadata infrastructure.
properties.timeCreated	string	The date and time the cloud Exadata infrastructure resource was created.
properties.totalStorageSizeInGbs	integer (int32)	The total storage allocated to the cloud Exadata infrastructure resource, in gigabytes (GB).
systemData	systemData	Azure Resource Manager metadata containing createdBy and modifiedBy information.
tags	object	Resource tags.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
zones	string[]	CloudExadataInfrastructure zones

CloudExadataInfrastructureLifecycleState

Enumeration

CloudExadataInfrastructureLifecycleState enum

Value	Description
Available	Indicates that resource in Available state
Failed	Indicates that resource in Failed state
MaintenanceInProgress	Indicates that resource maintenance in progress state
Provisioning	Indicates that resource in Provisioning state
Terminated	Indicates that resource in Terminated state
Terminating	Indicates that resource in Terminating state
Updating	Indicates that resource in Updating state

CloudExadataInfrastructureUpdate

Object

The type used for update operations of the CloudExadataInfrastructure.

Name	Type	Description
properties.computeCount	integer (int32)	The number of compute servers for the cloud Exadata infrastructure.
properties.customerContacts	CustomerContact[]	The list of customer email addresses that receive information from Oracle about the specified OCI Database service resource. Oracle uses these email addresses to send notifications about planned and unplanned software maintenance updates, information about system hardware, and other information needed by administrators. Up to 10 email addresses can be added to the customer contacts for a cloud Exadata infrastructure instance.
properties.displayName	string minLength: 1 maxLength: 255	The name for the Exadata infrastructure.
properties.maintenanceWindow	MaintenanceWindow	maintenanceWindow property
properties.storageCount	integer (int32)	The number of storage servers for the cloud Exadata infrastructure.
tags	object	Resource tags.
zones	string[]	CloudExadataInfrastructure zones

ComputeModel

Enumeration

Compute model enum

Value	Description
ECPU	ECPU model type
OCPU	OCPU model type

createdByType

Enumeration

The type of identity that created the resource.

Value	Description
Application
Key
ManagedIdentity
User

CustomerContact

Object

CustomerContact resource properties

Name	Type	Description
email	string minLength: 1 maxLength: 320	The email address used by Oracle to send notifications regarding databases and infrastructure.

DayOfWeek

Object

DayOfWeek resource properties

Name	Type	Description
name	DayOfWeekName	Name of the day of the week.

DayOfWeekName

Enumeration

DayOfWeekName enum

Value	Description
Friday	Friday value
Monday	Monday value
Saturday	Saturday value
Sunday	Sunday value
Thursday	Thursday value
Tuesday	Tuesday value
Wednesday	Wednesday value

DefinedFileSystemConfiguration

Object

Predefined configurations for the file system

Name	Type	Description
isBackupPartition	boolean	Checks if the data can be backed up
isResizable	boolean	Checks if the mount path is resizable
minSizeGb	integer (int32)	Minimum size of mount path in Gb
mountPoint	string	Mount path for the file system

ErrorAdditionalInfo

Object

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorDetail

Object

The error detail.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorDetail[]	The error details.
message	string	The error message.
target	string	The error target.

ErrorResponse

Object

Error response

Name	Type	Description
error	ErrorDetail	The error object.

EstimatedPatchingTime

Object

The estimated total time required in minutes for all patching operations (database server, storage server, and network switch patching).

Name	Type	Description
estimatedDbServerPatchingTime	integer (int32) minimum: 1 maximum: 3000	The estimated time required in minutes for database server patching.
estimatedNetworkSwitchesPatchingTime	integer (int32) minimum: 1 maximum: 3000	The estimated time required in minutes for network switch patching.
estimatedStorageServerPatchingTime	integer (int32) minimum: 1 maximum: 3000	The estimated time required in minutes for storage server patching.
totalEstimatedPatchingTime	integer (int32) minimum: 1 maximum: 3000	The estimated total time required in minutes for all patching operations.

MaintenanceWindow

Object

MaintenanceWindow resource properties

Name	Type	Description
customActionTimeoutInMins	integer (int32) minimum: 0 maximum: 120	Determines the amount of time the system will wait before the start of each database server patching operation. Custom action timeout is in minutes and valid value is between 15 to 120 (inclusive).
daysOfWeek	DayOfWeek[]	Days during the week when maintenance should be performed.
hoursOfDay	integer[] (int32)	The window of hours during the day when maintenance should be performed. The window is a 4 hour slot. Valid values are - 0 - represents time slot 0:00 - 3:59 UTC - 4 - represents time slot 4:00 - 7:59 UTC - 8 - represents time slot 8:00 - 11:59 UTC - 12 - represents time slot 12:00 - 15:59 UTC - 16 - represents time slot 16:00 - 19:59 UTC - 20 - represents time slot 20:00 - 23:59 UTC
isCustomActionTimeoutEnabled	boolean	If true, enables the configuration of a custom action timeout (waiting period) between database server patching operations.
isMonthlyPatchingEnabled	boolean	is Monthly Patching Enabled
leadTimeInWeeks	integer (int32)	Lead time window allows user to set a lead time to prepare for a down time. The lead time is in weeks and valid value is between 1 to 4.
months	Month[]	Months during the year when maintenance should be performed.
patchingMode	PatchingMode	Cloud Exadata infrastructure node patching method.
preference	Preference	The maintenance window scheduling preference.
weeksOfMonth	integer[] (int32)	Weeks during the month when maintenance should be performed. Weeks start on the 1st, 8th, 15th, and 22nd days of the month, and have a duration of 7 days. Weeks start and end based on calendar dates, not days of the week. For example, to allow maintenance during the 2nd week of the month (from the 8th day to the 14th day of the month), use the value 2. Maintenance cannot be scheduled for the fifth week of months that contain more than 28 days. Note that this parameter works in conjunction with the daysOfWeek and hoursOfDay parameters to allow you to specify specific days of the week and hours that maintenance will be performed.

Month

Object

Month resource properties

Name	Type	Description
name	MonthName	Name of the month of the year.

MonthName

Enumeration

MonthName enum

Value	Description
April	April value
August	August value
December	December value
February	February value
January	January value
July	July value
June	June value
March	March value
May	May value
November	November value
October	October value
September	September value

PatchingMode

Enumeration

Patching mode enum

Value	Description
NonRolling	Non Rolling patching
Rolling	Rolling patching

Preference

Enumeration

Preference enum

Value	Description
CustomPreference	Custom preference
NoPreference	No preference

systemData

Object

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string (date-time)	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string (date-time)	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

Freigeben über

Cloud Exadata Infrastructures - Update

URI Parameters

Request Body

Responses

Security

azure_auth

Scopes

Examples

Patch Exadata Infrastructure

Sample request

Sample response

Definitions

AzureResourceProvisioningState

CloudExadataInfrastructure

CloudExadataInfrastructureLifecycleState

CloudExadataInfrastructureUpdate

ComputeModel

createdByType

CustomerContact

DayOfWeek

DayOfWeekName

DefinedFileSystemConfiguration

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

EstimatedPatchingTime

MaintenanceWindow

Month

MonthName

PatchingMode

Preference

systemData