gcloud alloydb instances create - creates a new AlloyDB instance within a given cluster

gcloud alloydb instances createINSTANCE--cluster=CLUSTER--instance-type=INSTANCE_TYPE--region=REGION[--allocated-ip-range-override=ALLOCATED_IP_RANGE_OVERRIDE][--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,…]][--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP][--async][--authorized-external-networks=[AUTHORIZED_NETWORK,…]][--availability-type=AVAILABILITY_TYPE][--connection-pooling-client-connection-idle-timeout=CONNECTION_POOLING_CLIENT_CONNECTION_IDLE_TIMEOUT][--connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,…]][--connection-pooling-max-client-connections=CONNECTION_POOLING_MAX_CLIENT_CONNECTIONS][--connection-pooling-max-pool-size=CONNECTION_POOLING_MAX_POOL_SIZE][--connection-pooling-max-prepared-statements=CONNECTION_POOLING_MAX_PREPARED_STATEMENTS][--connection-pooling-min-pool-size=CONNECTION_POOLING_MIN_POOL_SIZE][--connection-pooling-pool-mode=CONNECTION_POOLING_POOL_MODE][--connection-pooling-query-wait-timeout=CONNECTION_POOLING_QUERY_WAIT_TIMEOUT][--connection-pooling-server-idle-timeout=CONNECTION_POOLING_SERVER_IDLE_TIMEOUT][--connection-pooling-server-lifetime=CONNECTION_POOLING_SERVER_LIFETIME][--connection-pooling-stats-users=[STATS_USERS,…]][--cpu-count=CPU_COUNT][--database-flags=FLAG=VALUE,[FLAG=VALUE,…]][--[no-]enable-connection-pooling][--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE][--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH][--[no-]insights-config-record-application-tags][--[no-]insights-config-record-client-address][--machine-type=MACHINE_TYPE][--[no-]outbound-public-ip][--psc-auto-connections=[network=NETWORK],[project=PROJECT]][--psc-network-attachment-uri=PSC_NETWORK_ATTACHMENT_URI][--read-pool-node-count=READ_POOL_NODE_COUNT][--[no-]require-connectors][--ssl-mode=SSL_MODE; default="ENCRYPTED_ONLY"][GCLOUD_WIDE_FLAG …]

gcloudalloydbinstancescreatemy-instance--cluster=my-cluster--region=us-central1--instance-type=PRIMARY--cpu-count=4

To create a new read pool instance, run:

gcloudalloydbinstancescreatemy-instance--cluster=my-cluster--region=us-central1--instance-type=READ_POOL--read-pool-node-count=1--cpu-count=4

INSTANCE

AlloyDB instance ID

--cluster=CLUSTER

AlloyDB cluster ID

--instance-type=INSTANCE_TYPE

Specifies instance type.INSTANCE_TYPE must be one of:

PRIMARY

PRIMARY instances support read and write operations.

READ_POOL

READ_POOL instances support read operations only. Each read pool instanceconsists of one or more homogeneous nodes. * Read pool of size 1 can only havezonal availability. * Read pools with node count of 2 or more can have regionalavailability (nodes are present in 2 or more zones in a region).

--region=REGION

Regional location (e.g.asia-east1,us-east1). See thefull list of regions athttps://cloud.google.com/sql/docs/instance-locations.

--allocated-ip-range-override=ALLOCATED_IP_RANGE_OVERRIDE

Name of the allocated IP range for the private IP AlloyDB instance, for example:"google-managed-services-default". If set, the instance IPs will be created fromthis allocated range and will override the IP range used by the parent cluster.The range name must comply with RFC 1035. Specifically, the name must be 1-63characters long and match the regular expression[a-z]([-a-z0-9]*[a-z0-9])?.

--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,…]

Comma-separated list of allowed consumer projects to create endpoints forPrivate Service Connect (PSC) connectivity for the instance. Only instances inPSC-enabled clusters are allowed to set this field.(e.g.,--allowed-psc-projects=project1,12345678,project2)

--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP

Specify to enable or disable public IP on an instance. ASSIGN_INBOUND_PUBLIC_IPmust be one of:

• NO_PUBLIC_IP
  • This disables public IP on the instance. Updating an instance to disable publicIP will clear the list of authorized networks.
• ASSIGN_IPV4
  • Assign an inbound public IPv4 address for the instance. Public IP is enabled.

--async

Return immediately, without waiting for the operation in progress to complete.

--authorized-external-networks=[AUTHORIZED_NETWORK,…]

Comma-separated list of authorized external networks to set on the instance.Authorized networks should use CIDR notation (e.g. 1.2.3.4/30). This flag isonly allowed to be set for instances with public IP enabled.

--availability-type=AVAILABILITY_TYPE

Specifies level of availability.AVAILABILITY_TYPE mustbe one of:

REGIONAL

Provide high availability instances. Recommended for production instances;instances automatically fail over to another zone within your selected region.

ZONAL

Provide zonal availability instances. Not recommended for production instances;instance does not automatically fail over to another zone.

--connection-pooling-client-connection-idle-timeout=CONNECTION_POOLING_CLIENT_CONNECTION_IDLE_TIMEOUT

The maximum number of seconds a client is allowed to be idle before it isdisconnected.

--connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,…]

Comma-separated list of startup parameters that should be ignored by theconnection pool.

--connection-pooling-max-client-connections=CONNECTION_POOLING_MAX_CLIENT_CONNECTIONS

The max client connections for managed connection pooling.

--connection-pooling-max-pool-size=CONNECTION_POOLING_MAX_POOL_SIZE

The max pool size for managed connection pooling.

--connection-pooling-max-prepared-statements=CONNECTION_POOLING_MAX_PREPARED_STATEMENTS

The maximum number of prepared statements allowed.

--connection-pooling-min-pool-size=CONNECTION_POOLING_MIN_POOL_SIZE

The min pool size for managed connection pooling.

--connection-pooling-pool-mode=CONNECTION_POOLING_POOL_MODE

The pool mode for managed connection pooling.CONNECTION_POOLING_POOL_MODE must be one of:

SESSION

Session mode for managed connection pooling.

TRANSACTION

Transaction mode for managed connection pooling.

--connection-pooling-query-wait-timeout=CONNECTION_POOLING_QUERY_WAIT_TIMEOUT

The query wait timeout for managed connection pooling.

--connection-pooling-server-idle-timeout=CONNECTION_POOLING_SERVER_IDLE_TIMEOUT

The server idle timeout for managed connection pooling.

--connection-pooling-server-lifetime=CONNECTION_POOLING_SERVER_LIFETIME

The lifetime of a server connection in seconds. The pooler will close an unused(not currently linked to any client connection) server connection that has beenconnected longer than this. Setting it to 0 means the connection is to be usedonly once, then closed.

--connection-pooling-stats-users=[STATS_USERS,…]

Comma-separated list of database users to access connection pooling stats.

--cpu-count=CPU_COUNT

Whole number value indicating how many vCPUs the machine should contain. If theinstance does not have a machine-type, the vCPU count will be used to determinethe machine type where each vCPU corresponds to an N2 high-mem machine:(https://cloud.google.com/compute/docs/general-purpose-machines#n2_machine_types).where CPU_COUNT can be one of: 2, 4, 8, 16, 32, 64, 96, 128. If the instance hasa machine-type, cpu-count must have the same value as the vCPU count in themachine-type. Eg: if machine-type is c4a-highmem-4-lssd, cpu-count must be 4.CPU_COUNT must be one of:1,2,4,8,14,16,22,32,44,48,64,72,88,96,128,144,192,288.

--database-flags=FLAG=VALUE,[FLAG=VALUE,…]

Comma-separated list of database flags to set on the instance. Use an equalssign to separate flag name and value. Flags without values, likeskip_grant_tables, can be written out without a value after, e.g.,skip_grant_tables=. Use on/off for booleans. View the InstanceResource API for allowed flags. (e.g.,--database-flagsmax_allowed_packet=55555,skip_grant_tables=,log_output=1)

--[no-]enable-connection-pooling

Enable connection pooling for the instance. Use--enable-connection-pooling to enable and--no-enable-connection-pooling to disable.

--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE

Number of query plans to sample every minute. Default value is 5. Allowed range:0 to 20.

--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH

Query string length in bytes to be stored by the query insights feature. Defaultlength is 1024 bytes. Allowed range: 256 to 4500 bytes.

--[no-]insights-config-record-application-tags

Allow application tags to be recorded by the query insights feature.

Use--insights-config-record-application-tags to enable and--no-insights-config-record-application-tags to disable.

--[no-]insights-config-record-client-address

Allow the client address to be recorded by the query insights feature.

Use--insights-config-record-client-address to enable and--no-insights-config-record-client-address to disable.

--machine-type=MACHINE_TYPE

Specifies machine type for the instance.MACHINE_TYPEmust be one of:n2-highmem-2,n2-highmem-4,n2-highmem-8,n2-highmem-16,n2-highmem-32,n2-highmem-64,n2-highmem-96,n2-highmem-128,c4a-highmem-1,c4a-highmem-4-lssd,c4a-highmem-8-lssd,c4a-highmem-16-lssd,c4a-highmem-32-lssd,c4a-highmem-48-lssd,c4a-highmem-64-lssd,c4a-highmem-72-lssd,c4-highmem-4-lssd,c4-highmem-8-lssd,c4-highmem-16-lssd,c4-highmem-24-lssd,c4-highmem-32-lssd,c4-highmem-48-lssd,c4-highmem-96-lssd,c4-highmem-144-lssd,c4-highmem-192-lssd,c4-highmem-288-lssd,z3-highmem-14-standardlssd,z3-highmem-22-standardlssd,z3-highmem-44-standardlssd,z3-highmem-88-standardlssd,z3-highmem-8-highlssd,z3-highmem-16-highlssd,z3-highmem-22-highlssd,z3-highmem-32-highlssd,z3-highmem-44-highlssd.

--[no-]outbound-public-ip

Add outbound Public IP connectivity to an AlloyDB instance. Use--outbound-public-ip to enable and--no-outbound-public-ip to disable.

--psc-auto-connections=[network=NETWORK],[project=PROJECT]

Comma-separated list of consumer project and consumer network pairs to createendpoints for Private Service Connect (PSC) connectivity for the instance. Onlyinstances in PSC-enabled clusters are allowed to set this field. Both projectand network must be specified. (e.g.,--psc-auto-connections=project=project1,network=projects/vpc-host-project1/global/networks/network1--psc-auto-connections=project=project2,network=projects/vpc-host-project2/global/networks/network2).Setspsc_auto_connections value.

network

Required, setsnetwork value.

project

Required, setsproject value.

Shorthand Example:

--psc-auto-connections=network=string,project=string

JSON Example:

--psc-auto-connections='{"network": "string", "project": "string"}'

File Example:

--psc-auto-connections=path_to_file.(yaml|json)

--psc-network-attachment-uri=PSC_NETWORK_ATTACHMENT_URI

Full URI of the network attachment that is configured to support outboundconnectivity from an AlloyDB instance which uses Private Service Connect (PSC).For example, this would be of theform:psc-network-attachment-uri=projects/test-project/regions/us-central1/networkAttachments/my-na

--read-pool-node-count=READ_POOL_NODE_COUNT

Read capacity, i.e. number of nodes in a read pool instance.

--[no-]require-connectors

Enable or disable enforcing connectors only (ex: AuthProxy) connections to thedatabase. Use--require-connectors to enable and--no-require-connectors to disable.

--ssl-mode=SSL_MODE; default="ENCRYPTED_ONLY"

Specify the SSL mode to use when the instance connects to the database. DefaultSSL mode is ENCRYPTED_ONLY.SSL_MODE must be one of:

ALLOW_UNENCRYPTED_AND_ENCRYPTED

SSL connections are optional. CA verification is not enforced.

ENCRYPTED_ONLY

SSL connections are required. CA verification is not enforced.

Run$gcloud help for details.