REST Resource: projects.locations.cloudExadataInfrastructures

Resource: CloudExadataInfrastructure

Represents CloudExadataInfrastructure resource. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/

JSON representation
{
  "name": string,
  "displayName": string,
  "gcpOracleZone": string,
  "entitlementId": string,
  "properties": {
    object (CloudExadataInfrastructureProperties)
  },
  "labels": {
    string: string,
    ...
  },
  "createTime": string
}
Fields
name

string

Identifier. The name of the Exadata Infrastructure resource with the format: projects/{project}/locations/{region}/cloudExadataInfrastructures/{cloudExadataInfrastructure}

displayName

string

Optional. User friendly name for this resource.

gcpOracleZone

string

Optional. Google Cloud Platform location where Oracle Exadata is hosted.

entitlementId

string

Output only. Entitlement ID of the private offer against which this infrastructure resource is provisioned.

properties

object (CloudExadataInfrastructureProperties)

Optional. Various properties of the infra.

labels

map (key: string, value: string)

Optional. Labels or tags associated with the resource.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

createTime

string (Timestamp format)

Output only. The date and time that the Exadata Infrastructure was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

CloudExadataInfrastructureProperties

Various properties of Exadata Infrastructure.

JSON representation
{
  "ocid": string,
  "computeCount": integer,
  "storageCount": integer,
  "totalStorageSizeGb": integer,
  "availableStorageSizeGb": integer,
  "maintenanceWindow": {
    object (MaintenanceWindow)
  },
  "state": enum (State),
  "shape": string,
  "ociUrl": string,
  "cpuCount": integer,
  "maxCpuCount": integer,
  "memorySizeGb": integer,
  "maxMemoryGb": integer,
  "dbNodeStorageSizeGb": integer,
  "maxDbNodeStorageSizeGb": integer,
  "dataStorageSizeTb": number,
  "maxDataStorageTb": number,
  "activatedStorageCount": integer,
  "additionalStorageCount": integer,
  "dbServerVersion": string,
  "storageServerVersion": string,
  "nextMaintenanceRunId": string,
  "nextMaintenanceRunTime": string,
  "nextSecurityMaintenanceRunTime": string,
  "customerContacts": [
    {
      object (CustomerContact)
    }
  ],
  "monthlyStorageServerVersion": string,
  "monthlyDbServerVersion": string
}
Fields
ocid

string

Output only. OCID of created infra. https://docs.oracle.com/en-us/iaas/Content/General/Concepts/identifiers.htm#Oracle

computeCount

integer

Optional. The number of compute servers for the Exadata Infrastructure.

storageCount

integer

Optional. The number of Cloud Exadata storage servers for the Exadata Infrastructure.

totalStorageSizeGb

integer

Optional. The total storage allocated to the Exadata Infrastructure resource, in gigabytes (GB).

availableStorageSizeGb

integer

Output only. The available storage can be allocated to the Exadata Infrastructure resource, in gigabytes (GB).

maintenanceWindow

object (MaintenanceWindow)

Optional. Maintenance window for repair.

state

enum (State)

Output only. The current lifecycle state of the Exadata Infrastructure.

shape

string

Required. The shape of the Exadata Infrastructure. The shape determines the amount of CPU, storage, and memory resources allocated to the instance.

ociUrl

string

Output only. Deep link to the OCI console to view this resource.

cpuCount

integer

Optional. The number of enabled CPU cores.

maxCpuCount

integer

Output only. The total number of CPU cores available.

memorySizeGb

integer

Optional. The memory allocated in GBs.

maxMemoryGb

integer

Output only. The total memory available in GBs.

dbNodeStorageSizeGb

integer

Optional. The local node storage allocated in GBs.

maxDbNodeStorageSizeGb

integer

Output only. The total local node storage available in GBs.

dataStorageSizeTb

number

Output only. Size, in terabytes, of the DATA disk group.

maxDataStorageTb

number

Output only. The total available DATA disk group size.

activatedStorageCount

integer

Output only. The requested number of additional storage servers activated for the Exadata Infrastructure.

additionalStorageCount

integer

Output only. The requested number of additional storage servers for the Exadata Infrastructure.

dbServerVersion

string

Output only. The software version of the database servers (dom0) in the Exadata Infrastructure.

storageServerVersion

string

Output only. The software version of the storage servers (cells) in the Exadata Infrastructure.

nextMaintenanceRunId

string

Output only. The OCID of the next maintenance run.

nextMaintenanceRunTime

string (Timestamp format)

Output only. The time when the next maintenance run will occur.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

nextSecurityMaintenanceRunTime

string (Timestamp format)

Output only. The time when the next security maintenance run will occur.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

customerContacts[]

object (CustomerContact)

Optional. The list of customer contacts.

monthlyStorageServerVersion

string

Output only. The monthly software version of the storage servers (cells) in the Exadata Infrastructure. Example: 20.1.15

monthlyDbServerVersion

string

Output only. The monthly software version of the database servers (dom0) in the Exadata Infrastructure. Example: 20.1.15

MaintenanceWindow

Maintenance window as defined by Oracle. https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/datatypes/MaintenanceWindow

JSON representation
{
  "preference": enum (MaintenanceWindowPreference),
  "months": [
    enum (Month)
  ],
  "weeksOfMonth": [
    integer
  ],
  "daysOfWeek": [
    enum (DayOfWeek)
  ],
  "hoursOfDay": [
    integer
  ],
  "leadTimeWeek": integer,
  "patchingMode": enum (PatchingMode),
  "customActionTimeoutMins": integer,
  "isCustomActionTimeoutEnabled": boolean
}
Fields
preference

enum (MaintenanceWindowPreference)

Optional. The maintenance window scheduling preference.

months[]

enum (Month)

Optional. Months during the year when maintenance should be performed.

weeksOfMonth[]

integer

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

daysOfWeek[]

enum (DayOfWeek)

Optional. Days during the week when maintenance should be performed.

hoursOfDay[]

integer

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

leadTimeWeek

integer

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

patchingMode

enum (PatchingMode)

Optional. Cloud CloudExadataInfrastructure node patching method, either "ROLLING" or "NONROLLING". Default value is ROLLING.

customActionTimeoutMins

integer

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

isCustomActionTimeoutEnabled

boolean

Optional. If true, enables the configuration of a custom action timeout (waiting period) between database server patching operations.

MaintenanceWindowPreference

Maintenance window preference.

Enums
MAINTENANCE_WINDOW_PREFERENCE_UNSPECIFIED Default unspecified value.
CUSTOM_PREFERENCE Custom preference.
NO_PREFERENCE No preference.

Month

Represents a month in the Gregorian calendar.

Enums
MONTH_UNSPECIFIED The unspecified month.
JANUARY The month of January.
FEBRUARY The month of February.
MARCH The month of March.
APRIL The month of April.
MAY The month of May.
JUNE The month of June.
JULY The month of July.
AUGUST The month of August.
SEPTEMBER The month of September.
OCTOBER The month of October.
NOVEMBER The month of November.
DECEMBER The month of December.

PatchingMode

Patching mode.

Enums
PATCHING_MODE_UNSPECIFIED Default unspecified value.
ROLLING Updates the Cloud Exadata database server hosts in a rolling fashion.
NON_ROLLING The non-rolling maintenance method first updates your storage servers at the same time, then your database servers at the same time.

State

The various lifecycle states of the Exadata Infrastructure.

Enums
STATE_UNSPECIFIED Default unspecified value.
PROVISIONING The Exadata Infrastructure is being provisioned.
AVAILABLE The Exadata Infrastructure is available for use.
UPDATING The Exadata Infrastructure is being updated.
TERMINATING The Exadata Infrastructure is being terminated.
TERMINATED The Exadata Infrastructure is terminated.
FAILED The Exadata Infrastructure is in failed state.
MAINTENANCE_IN_PROGRESS The Exadata Infrastructure is in maintenance.

Methods

create

Creates a new Exadata Infrastructure in a given project and location.

delete

Deletes a single Exadata Infrastructure.

get

Gets details of a single Exadata Infrastructure.

list

Lists Exadata Infrastructures in a given project and location.