gcloud oracle-database cloud-exadata-infrastructures create

NAME
gcloud oracle-database cloud-exadata-infrastructures create - create a new ExadataInfrastructure
SYNOPSIS
gcloud oracle-database cloud-exadata-infrastructures create(CLOUD_EXADATA_INFRASTRUCTURE :--location=LOCATION)[--async][--display-name=DISPLAY_NAME][--gcp-oracle-zone=GCP_ORACLE_ZONE][--labels=[LABELS,…]][--request-id=REQUEST_ID][[--properties-shape=PROPERTIES_SHAPE :--properties-compute-count=PROPERTIES_COMPUTE_COUNT--properties-customer-contacts=[email=EMAIL]--properties-storage-count=PROPERTIES_STORAGE_COUNT--properties-total-storage-size-gb=PROPERTIES_TOTAL_STORAGE_SIZE_GB--maintenance-window-custom-action-timeout-mins=MAINTENANCE_WINDOW_CUSTOM_ACTION_TIMEOUT_MINS--maintenance-window-days-of-week=[MAINTENANCE_WINDOW_DAYS_OF_WEEK,…]--maintenance-window-hours-of-day=[MAINTENANCE_WINDOW_HOURS_OF_DAY,…]--maintenance-window-is-custom-action-timeout-enabled--maintenance-window-lead-time-week=MAINTENANCE_WINDOW_LEAD_TIME_WEEK--maintenance-window-months=[MAINTENANCE_WINDOW_MONTHS,…]--maintenance-window-patching-mode=MAINTENANCE_WINDOW_PATCHING_MODE--maintenance-window-preference=MAINTENANCE_WINDOW_PREFERENCE--maintenance-window-weeks-of-month=[MAINTENANCE_WINDOW_WEEKS_OF_MONTH,…]]][GCLOUD_WIDE_FLAG]
DESCRIPTION
Creates a new ExadataInfrastructure.
EXAMPLES
Choose an available system shapes in your location by runninggcloudoracle-database db-system-shapes list --location=us-east4. To createExadata Infrastructure instance with idmy-instance in the locationus-east4 with display-namemy instance, compute count2 and choosen shape "Exadata.FOO", run:
gcloudoracle-databasecloud-exadata-infrastructurescreatemy-instance--location=us-east4--display-name="my instance"--properties-shape=Exadata.FOO--properties-compute-count=2--properties-storage-count=3
POSITIONAL ARGUMENTS
CloudExadataInfrastructure resource - Identifier. The name of the ExadataInfrastructure resource with the format:projects/{project}/locations/{region}/cloudExadataInfrastructures/{cloud_exadata_infrastructure}The arguments in this group can be used to specify the attributes of thisresource. (NOTE) Some attributes are not given arguments in this group but canbe set in other ways.

To set theproject attribute:

  • provide the argumentcloud_exadata_infrastructure on the commandline with a fully specified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

CLOUD_EXADATA_INFRASTRUCTURE
ID of the cloudExadataInfrastructure or fully qualified identifier for thecloudExadataInfrastructure.

To set thecloud_exadata_infrastructure attribute:

  • provide the argumentcloud_exadata_infrastructure on the commandline.

This positional argument must be specified if any of the other arguments in thisgroup are specified.

--location=LOCATION
The location id of the cloudExadataInfrastructure resource.

To set thelocation attribute:

  • provide the argumentcloud_exadata_infrastructure on the commandline with a fully specified name;
  • provide the argument--location on the command line.
FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--display-name=DISPLAY_NAME
User friendly name for this resource.
--gcp-oracle-zone=GCP_ORACLE_ZONE
The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. Example:us-east4-b-r2. If not specified, the system will pick a zone based onavailability.
--labels=[LABELS,…]
Labels or tags associated with the resource.
KEY
Keys must start with a lowercase character and contain only hyphens(-), underscores (_), lowercase characters, andnumbers.
VALUE
Values must contain only hyphens (-), underscores (_),lowercase characters, and numbers.
Shorthand Example:
--labels=string=string

JSON Example:

--labels='{"string": "string"}'

File Example:

--labels=path_to_file.(yaml|json)
--request-id=REQUEST_ID
An optional ID to identify the request. This value is used to identify duplicaterequests. If you make a request with the same request ID and the originalrequest is still in progress or completed, the server ignores the secondrequest. This prevents clients from accidentally creating duplicate commitments.

The request ID must be a valid UUID with the exception that zero UUID is notsupported (00000000-0000-0000-0000-000000000000).

Various properties of Exadata Infrastructure.
--properties-shape=PROPERTIES_SHAPE
The shape of the Exadata Infrastructure. The shape determines the amount of CPU,storage, and memory resources allocated to the instance.

This flag argument must be specified if any of the other arguments in this groupare specified.

--properties-compute-count=PROPERTIES_COMPUTE_COUNT
The number of compute servers for the Exadata Infrastructure.
--properties-customer-contacts=[email=EMAIL]
The list of customer contacts.
email
The email address used by Oracle to send notifications regarding databases andinfrastructure.
Shorthand Example:
--properties-customer-contacts=email=string--properties-customer-contacts=email=string

JSON Example:

--properties-customer-contacts='[{"email": "string"}]'

File Example:

--properties-customer-contacts=path_to_file.(yaml|json)
--properties-storage-count=PROPERTIES_STORAGE_COUNT
The number of Cloud Exadata storage servers for the Exadata Infrastructure.
--properties-total-storage-size-gb=PROPERTIES_TOTAL_STORAGE_SIZE_GB
The total storage allocated to the Exadata Infrastructure resource, in gigabytes(GB).
Maintenance window as defined by Oracle.https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/datatypes/MaintenanceWindow
--maintenance-window-custom-action-timeout-mins=MAINTENANCE_WINDOW_CUSTOM_ACTION_TIMEOUT_MINS
Determines the amount of time the system will wait before the start of eachdatabase server patching operation. Custom action timeout is in minutes andvalid value is between 15 to 120 (inclusive).
--maintenance-window-days-of-week=[MAINTENANCE_WINDOW_DAYS_OF_WEEK,…]
Days during the week when maintenance should be performed.MAINTENANCE_WINDOW_DAYS_OF_WEEK must be one of:
friday
Friday
monday
Monday
saturday
Saturday
sunday
Sunday
thursday
Thursday
tuesday
Tuesday
wednesday
Wednesday
--maintenance-window-hours-of-day=[MAINTENANCE_WINDOW_HOURS_OF_DAY,…]
The window of hours during the day when maintenance should be performed. Thewindow is a 4 hour slot. Valid values are: 0 - represents time slot 0:00 - 3:59UTC 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 slot16:00 - 19:59 UTC 20 - represents time slot 20:00 - 23:59 UTC
--maintenance-window-is-custom-action-timeout-enabled
If true, enables the configuration of a custom action timeout (waiting period)between database server patching operations.
--maintenance-window-lead-time-week=MAINTENANCE_WINDOW_LEAD_TIME_WEEK
Lead time window allows user to set a lead time to prepare for a down time. Thelead time is in weeks and valid value is between 1 to 4.
--maintenance-window-months=[MAINTENANCE_WINDOW_MONTHS,…]
Months during the year when maintenance should be performed.MAINTENANCE_WINDOW_MONTHS must be one of:
april
The month of April.
august
The month of August.
december
The month of December.
february
The month of February.
january
The month of January.
july
The month of July.
june
The month of June.
march
The month of March.
may
The month of May.
november
The month of November.
october
The month of October.
september
The month of September.
--maintenance-window-patching-mode=MAINTENANCE_WINDOW_PATCHING_MODE
Cloud CloudExadataInfrastructure node patching method, either "ROLLING" or"NONROLLING". Default value is ROLLING.MAINTENANCE_WINDOW_PATCHING_MODE must be one of:
non-rolling
The non-rolling maintenance method first updates your storage servers at thesame time, then your database servers at the same time.
rolling
Updates the Cloud Exadata database server hosts in a rolling fashion.
--maintenance-window-preference=MAINTENANCE_WINDOW_PREFERENCE
The maintenance window scheduling preference.MAINTENANCE_WINDOW_PREFERENCE must be one of:
custom-preference
Custom preference.
no-preference
No preference.
--maintenance-window-weeks-of-month=[MAINTENANCE_WINDOW_WEEKS_OF_MONTH,…]
Weeks during the month when maintenance should be performed. Weeks start on the1st, 8th, 15th, and 22nd days of the month, and have a duration of 7 days. Weeksstart and end based on calendar dates, not days of the week.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

API REFERENCE
This command uses theoracledatabase/v1 API. The full documentationfor this API can be found at:https://cloud.google.com/oracle/database/docs

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-09-03 UTC.