imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-09 10:56:49 +00:00
Code Activity
gcloud-help/gcloud/oracle-database/db-systems/create
Automated 1dea1ef852 gcloud: Wed Sep 24 11:08:57 UTC 2025
2025-09-24 11:08:57 +00:00

461 lines
20 KiB
Text
Raw Blame History

NAME
gcloud oracle-database db-systems create - create a new DbSystem
SYNOPSIS
gcloud oracle-database db-systems create DB_SYSTEM
--display-name=DISPLAY_NAME --odb-subnet=ODB_SUBNET [--async]
[--gcp-oracle-zone=GCP_ORACLE_ZONE] [--labels=[LABELS,...]]
[--location=LOCATION] [--odb-network=ODB_NETWORK]
[--request-id=REQUEST_ID]
[[--properties-compute-count=PROPERTIES_COMPUTE_COUNT
--properties-database-edition=PROPERTIES_DATABASE_EDITION
--properties-initial-data-storage-size-gb=PROPERTIES_INITIAL_DATA_STORAGE_SIZE_GB --properties-license-model=PROPERTIES_LICENSE_MODEL --properties-shape=PROPERTIES_SHAPE --properties-ssh-public-keys=[PROPERTIES_SSH_PUBLIC_KEYS,
...]
: --db-system-options-storage-management=DB_SYSTEM_OPTIONS_STORAGE_MANAGEMENT --properties-compute-model=PROPERTIES_COMPUTE_MODEL --properties-data-storage-size-gb=PROPERTIES_DATA_STORAGE_SIZE_GB --properties-domain=PROPERTIES_DOMAIN --properties-hostname-prefix=PROPERTIES_HOSTNAME_PREFIX --properties-memory-size-gb=PROPERTIES_MEMORY_SIZE_GB --properties-node-count=PROPERTIES_NODE_COUNT --properties-private-ip=PROPERTIES_PRIVATE_IP --properties-reco-storage-size-gb=PROPERTIES_RECO_STORAGE_SIZE_GB --data-collection-options-is-diagnostics-events-enabled --data-collection-options-is-incident-logs-enabled [--db-home-version=DB_HOME_VERSION (--database-admin-password=DATABASE_ADMIN_PASSWORD : --database-character-set=DATABASE_CHARACTER_SET --database-db-home-name=DATABASE_DB_HOME_NAME --database-db-name=DATABASE_DB_NAME --database-db-unique-name=DATABASE_DB_UNIQUE_NAME --database-id=DATABASE_ID --database-name=DATABASE_NAME --database-ncharacter-set=DATABASE_NCHARACTER_SET --database-tde-wallet-password=DATABASE_TDE_WALLET_PASSWORD [--properties-db-version=PROPERTIES_DB_VERSION : --db-backup-config-auto-enabled --db-backup-config-auto-full-day=DB_BACKUP_CONFIG_AUTO_FULL_DAY --db-backup-config-auto-full-window=DB_BACKUP_CONFIG_AUTO_FULL_WINDOW --db-backup-config-auto-incremental-window=DB_BACKUP_CONFIG_AUTO_INCREMENTAL_WINDOW --db-backup-config-deletion-policy=DB_BACKUP_CONFIG_DELETION_POLICY --db-backup-config-destination-details=[type=TYPE] --db-backup-config-retention-period-days=DB_BACKUP_CONFIG_RETENTION_PERIOD_DAYS]) : --db-home-display-name=DB_HOME_DISPLAY_NAME --db-home-is-unified-auditing-enabled] --time-zone-id=TIME_ZONE_ID --time-zone-version=TIME_ZONE_VERSION]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Create a new DbSystem.
EXAMPLES
Choose an available db-version in your location by running gcloud
oracle-database db-versions list --location=us-east4. Choose an available
db-system-initial-storage-size in your location by running gcloud
oracle-database db-system-initial-storage-sizes list --location=us-east4.
Choose an available shape in your location by running gcloud
oracle-database db-system-shapes list --location=us-east4. To create
DbSystem with id my-db-system in the location us-east4 with display-name my
db system, run:
$ gcloud oracle-database db-systems create my-db-system \
--location=us-east4 --display-name="my db system" \
--properties-db-home-db-version=xx.0.0.0 \
--properties-db-system-initial-storage-size=1000 \
--properties-shape=VM.FOO
POSITIONAL ARGUMENTS
DbSystem resource - Identifier. The name of the DbSystem resource in the
following format:
projects/{project}/locations/{region}/dbSystems/{db_system} This
represents a Cloud resource. (NOTE) Some attributes are not given
arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument db_system on the command line with a fully
specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
To set the location attribute:
◆ provide the argument db_system on the command line with a fully
specified name;
◆ provide the argument --location on the command line.
This must be specified.
DB_SYSTEM
ID of the dbSystem or fully qualified identifier for the dbSystem.
To set the db_system attribute:
▸ provide the argument db_system on the command line.
REQUIRED FLAGS
--display-name=DISPLAY_NAME
The display name for the System db. The name does not have to be unique
within your project.
OdbSubnet resource - The name of the OdbSubnet associated with the
DbSystem for IP allocation. Format:
projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
This represents a Cloud resource. (NOTE) Some attributes are not given
arguments in this group but can be set in other ways.
To set the project attribute:
◆ provide the argument --odb-subnet on the command line with a fully
specified name;
◆ provide the argument --project on the command line;
◆ set the property core/project.
To set the location attribute:
◆ provide the argument --odb-subnet on the command line with a fully
specified name;
◆ provide the argument --location on the command line.
To set the odb-network attribute:
◆ provide the argument --odb-subnet on the command line with a fully
specified name;
◆ provide the argument --odb-network on the command line.
This must be specified.
--odb-subnet=ODB_SUBNET
ID of the odbSubnet or fully qualified identifier for the odbSubnet.
To set the odb-subnet attribute:
▸ provide the argument --odb-subnet on the command line.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to
complete.
--gcp-oracle-zone=GCP_ORACLE_ZONE
The GCP Oracle zone where Oracle DbSystem is hosted. Example:
us-east4-b-r2. If not specified, the system will pick a zone based on
availability.
--labels=[LABELS,...]
The labels or tags associated with the DbSystem.
KEY
Keys must start with a lowercase character and contain only hyphens
(-), underscores (_), lowercase characters, and numbers.
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)
--location=LOCATION
For resources [db_system, odb-network, odb-subnet], provides fallback
value for resource location attribute. When the resource's full URI
path is not provided, location will fallback to this flag value.
--odb-network=ODB_NETWORK
For resources [odb-network, odb-subnet], provides fallback value for
resource odb-network attribute. When the resource's full URI path is
not provided, odb-network will fallback to this flag value.
--request-id=REQUEST_ID
An optional request ID to identify requests. Specify a unique request
ID so that if you must retry your request, the server will know to
ignore the request if it has already been completed. The server will
guarantee that for at least 60 minutes since the first request.
For example, consider a situation where you make an initial request and
the request times out. If you make the request again with the same
request ID, the server can check if original operation with the same
request ID was received, and if so, will ignore the second request.
This prevents clients from accidentally creating duplicate commitments.
The request ID must be a valid UUID with the exception that zero UUID
is not supported (00000000-0000-0000-0000-000000000000).
The properties of a DbSystem.
--properties-compute-count=PROPERTIES_COMPUTE_COUNT
The number of CPU cores to enable for the DbSystem.
This flag argument must be specified if any of the other arguments in
this group are specified.
--properties-database-edition=PROPERTIES_DATABASE_EDITION
The database edition of the DbSystem. PROPERTIES_DATABASE_EDITION
must be one of:
enterprise-edition
The database edition is Enterprise.
enterprise-edition-high-performance
The database edition is Enterprise Edition.
standard-edition
The database edition is Standard.
This flag argument must be specified if any of the other arguments in
this group are specified.
--properties-initial-data-storage-size-gb=PROPERTIES_INITIAL_DATA_STORAGE_SIZE_GB
The initial data storage size in GB.
This flag argument must be specified if any of the other arguments in
this group are specified.
--properties-license-model=PROPERTIES_LICENSE_MODEL
The license model of the DbSystem. PROPERTIES_LICENSE_MODEL must be
one of:
bring-your-own-license
The license model is bring your own license.
license-included
The license model is included.
This flag argument must be specified if any of the other arguments in
this group are specified.
--properties-shape=PROPERTIES_SHAPE
Shape of DB System.
This flag argument must be specified if any of the other arguments in
this group are specified.
--properties-ssh-public-keys=[PROPERTIES_SSH_PUBLIC_KEYS,...]
SSH public keys to be stored with the DbSystem.
This flag argument must be specified if any of the other arguments in
this group are specified.
Details of the DbSystem Options.
--db-system-options-storage-management=DB_SYSTEM_OPTIONS_STORAGE_MANAGEMENT
The storage option used in DB system.
DB_SYSTEM_OPTIONS_STORAGE_MANAGEMENT must be one of:
asm
Automatic storage management.
lvm
Logical Volume management.
--properties-compute-model=PROPERTIES_COMPUTE_MODEL
The compute model of the DbSystem. PROPERTIES_COMPUTE_MODEL must be
one of:
ecpu
The compute model is virtual.
ocpu
The compute model is physical.
--properties-data-storage-size-gb=PROPERTIES_DATA_STORAGE_SIZE_GB
The data storage size in GB that is currently available to DbSystems.
--properties-domain=PROPERTIES_DOMAIN
The host domain name of the DbSystem.
--properties-hostname-prefix=PROPERTIES_HOSTNAME_PREFIX
Prefix for DB System host names.
--properties-memory-size-gb=PROPERTIES_MEMORY_SIZE_GB
The memory size in GB.
--properties-node-count=PROPERTIES_NODE_COUNT
The number of nodes in the DbSystem.
--properties-private-ip=PROPERTIES_PRIVATE_IP
The private IP address of the DbSystem.
--properties-reco-storage-size-gb=PROPERTIES_RECO_STORAGE_SIZE_GB
The reco/redo storage size in GB.
Data collection options for DbSystem.
--data-collection-options-is-diagnostics-events-enabled
Indicates whether to enable data collection for diagnostics.
--data-collection-options-is-incident-logs-enabled
Indicates whether to enable incident logs and trace collection.
Details of the Database Home resource.
--db-home-version=DB_HOME_VERSION
A valid Oracle Database version. For a list of supported versions,
use the ListDbVersions operation.
This flag argument must be specified if any of the other arguments
in this group are specified.
--db-home-display-name=DB_HOME_DISPLAY_NAME
The display name for the Database Home. The name does not have to
be unique within your project.
--db-home-is-unified-auditing-enabled
Whether unified auditing is enabled for the Database Home.
Details of the Database resource.
https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/Database/
This must be specified.
--database-admin-password=DATABASE_ADMIN_PASSWORD
The password for the default ADMIN user.
This flag argument must be specified if any of the other
arguments in this group are specified.
--database-character-set=DATABASE_CHARACTER_SET
The character set for the database. The default is AL32UTF8.
--database-db-home-name=DATABASE_DB_HOME_NAME
The name of the DbHome resource associated with the Database.
--database-db-name=DATABASE_DB_NAME
The database name. The name must begin with an alphabetic
character and can contain a maximum of eight alphanumeric
characters. Special characters are not permitted.
--database-db-unique-name=DATABASE_DB_UNIQUE_NAME
The DB_UNIQUE_NAME of the Oracle Database being backed up.
--database-id=DATABASE_ID
The database ID of the Database.
--database-name=DATABASE_NAME
Identifier. The name of the Database resource in the following
format:
projects/{project}/locations/{region}/databases/{database}
--database-ncharacter-set=DATABASE_NCHARACTER_SET
The national character set for the database. The default is
AL16UTF16.
--database-tde-wallet-password=DATABASE_TDE_WALLET_PASSWORD
The TDE wallet password for the database.
The properties of a Database.
--properties-db-version=PROPERTIES_DB_VERSION
The Oracle Database version.
This flag argument must be specified if any of the other
arguments in this group are specified.
Backup Options for the Database.
--db-backup-config-auto-enabled
If set to true, enables automatic backups on the database.
--db-backup-config-auto-full-day=DB_BACKUP_CONFIG_AUTO_FULL_DAY
The day of the week on which the full backup should be
performed on the database. If no value is provided, it will
default to Sunday. DB_BACKUP_CONFIG_AUTO_FULL_DAY must be one
of:
friday
Friday
monday
Monday
saturday
Saturday
sunday
Sunday
thursday
Thursday
tuesday
Tuesday
wednesday
Wednesday
--db-backup-config-auto-full-window=DB_BACKUP_CONFIG_AUTO_FULL_WINDOW
The window in which the full backup should be performed on
the database. If no value is provided, the default is
anytime. DB_BACKUP_CONFIG_AUTO_FULL_WINDOW must be one of:
slot-eight
2:00 PM - 4:00 PM
slot-eleven
8:00 PM - 10:00 PM
slot-five
8:00 AM - 10:00 AM
slot-four
6:00 AM - 8:00 AM
slot-nine
4:00 PM - 6:00 PM
slot-one
12:00 AM - 2:00 AM
slot-seven
12:00 PM - 2:00 PM
slot-six
10:00 AM - 12:00 PM
slot-ten
6:00 PM - 8:00 PM
slot-three
4:00 AM - 6:00 AM
slot-twelve
10:00 PM - 12:00 AM
slot-two
2:00 AM - 4:00 AM
--db-backup-config-auto-incremental-window=DB_BACKUP_CONFIG_AUTO_INCREMENTAL_WINDOW
The window in which the incremental backup should be
performed on the database. If no value is provided, the
default is anytime except the auto full backup day.
DB_BACKUP_CONFIG_AUTO_INCREMENTAL_WINDOW must be one of:
slot-eight
2:00 PM - 4:00 PM
slot-eleven
8:00 PM - 10:00 PM
slot-five
8:00 AM - 10:00 AM
slot-four
6:00 AM - 8:00 AM
slot-nine
4:00 PM - 6:00 PM
slot-one
12:00 AM - 2:00 AM
slot-seven
12:00 PM - 2:00 PM
slot-six
10:00 AM - 12:00 PM
slot-ten
6:00 PM - 8:00 PM
slot-three
4:00 AM - 6:00 AM
slot-twelve
10:00 PM - 12:00 AM
slot-two
2:00 AM - 4:00 AM
--db-backup-config-deletion-policy=DB_BACKUP_CONFIG_DELETION_POLICY
This defines when the backups will be deleted after Database
termination. DB_BACKUP_CONFIG_DELETION_POLICY must be one of:
delete-after-retention-period
Keeps the backups as per the policy defined for database
backups.
delete-immediately
Keeps the backup for predefined time i.e. 72 hours and
then delete permanently.
--db-backup-config-destination-details=[type=TYPE]
Details of the database backup destinations.
type
The type of the database backup destination.
Shorthand Example:
--db-backup-config-destination-details=type=string --db-backup-config-destination-details=type=string
JSON Example:
--db-backup-config-destination-details='[{"type": "string"}]'
File Example:
--db-backup-config-destination-details=path_to_file.(yaml|json)
--db-backup-config-retention-period-days=DB_BACKUP_CONFIG_RETENTION_PERIOD_DAYS
The number of days an automatic backup is retained before
being automatically deleted. This value determines the
earliest point in time to which a database can be restored.
Min: 1, Max: 60.
Represents a time zone from the IANA Time Zone Database
(https://www.iana.org/time-zones).
--time-zone-id=TIME_ZONE_ID
IANA Time Zone Database time zone. For example "America/New_York".
--time-zone-version=TIME_ZONE_VERSION
IANA Time Zone Database version number. For example "2019a".
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 the oracledatabase/v1 API. The full documentation for
this API can be found at: https://cloud.google.com/oracle/database/docs
View git blame Copy permalink