gcloud alpha looker instances create

NAME
gcloud alpha looker instances create - create a Looker instance
SYNOPSIS
gcloud alpha looker instances create(INSTANCE :--region=REGION)--edition=EDITION--oauth-client-id=OAUTH_CLIENT_ID--oauth-client-secret=OAUTH_CLIENT_SECRET[--async][--no-catalog-integration-enabled][--class-type=CLASS_TYPE][--fips-enabled][--kms-key=KMS_KEY][--no-public-ip-enabled][--consumer-network=CONSUMER_NETWORK--private-ip-enabled :--reserved-range=RESERVED_RANGE][--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME][--gemini-enabled :--gemini-preview-tester-enabled--gemini-prompt-log-enabled][--maintenance-window-day=MAINTENANCE_WINDOW_DAY--maintenance-window-time=MAINTENANCE_WINDOW_TIME][--psc-enabled :--psc-allowed-vpcs=[PSC_ALLOWED_VPCS,…]][GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) Create a new Looker instance.

This command can fail for the following reasons:

  • An instance with the same name already exists.
  • The active account does not have permission to create instances.
  • --async flag is not passed
EXAMPLES
To create a basic tier instance with the namemy-looker-instance inregionus-central-1 with an edition ofLOOKER_CORE_STANDARD, run:
gcloudalphalookerinstancescreatemy-looker-instance--region=us-central1--edition="core-standard"--oauth-client-id='looker'--oauth-client-secret='looker'--async

Note: It isrecommended that the--async argument isprovided when creating a Looker instance.

POSITIONAL ARGUMENTS
Instance resource - Arguments and flags that specify the Looker instance youwant to create. The arguments in this group can be used to specify theattributes of this resource. (NOTE) Some attributes are not given arguments inthis group but can be set in other ways.

To set theproject attribute:

  • provide the argumentinstance on the command line with a fullyspecified name;
  • provide the argument--project on the command line;
  • set the propertycore/project.

This must be specified.

INSTANCE
ID of the instance or fully qualified identifier for the instance.

To set theinstance attribute:

  • provide the argumentinstance on the command line.

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

--region=REGION
The name of the Looker region of the instance. Overrides the defaultlooker/region property value for this command invocation.To set theregion attribute:
  • provide the argumentinstance on the command line with a fullyspecified name;
  • provide the argument--region on the command line;
  • set the propertylooker/region.
REQUIRED FLAGS
--edition=EDITION
The edition of the Looker instance.EDITION must be oneof:
core-embed-annual
A Looker (Google Cloud core) product for deploying and maintaining externalanalytics and custom applications at scale. This can be purchased via an annualcontract.
core-enterprise-annual
A Looker (Google Cloud core) product with enhanced security features for a widevariety of internal BI and analytics use cases. This can be purchased via anannual contract.
core-standard
A Looker (Google Cloud core) product for small organizations or teams with fewerthan 50 users. This will be billed monthly while the instance is active.
core-standard-annual
A Looker (Google Cloud core) product for small organizations or teams with fewerthan 50 users. This can be purchased via an annual contract.
core-trial
Trial edition of Looker.
core-trial-embed
An embed trial edition of Looker (Google Cloud core) product.
core-trial-enterprise
An enterprise trial edition of Looker (Google Cloud core) product.
core-trial-standard
A standard trial edition of Looker (Google Cloud core) product.
nonprod-core-embed-annual
A non-production edition of Looker (Google Cloud core) product for deploying andmaintaining external analytics and custom applications at scale. This can bepurchased via an annual contract.
nonprod-core-enterprise-annual
A non-production edition of Looker (Google Cloud core) product with enhancedsecurity features for a wide variety of internal BI and analytics use cases.This can be purchased via an annual contract.
nonprod-core-standard-annual
A non-production edition of Looker (Google Cloud core) product for smallorganizations or teams with fewer than 50 users. This can be purchased via anannual contract.
--oauth-client-id=OAUTH_CLIENT_ID
The client ID from an external OAuth application.

OAuth Application Credentials - Looker Instance OAuth login settings. Setup anOAuth app that will allow users to authenticate and access the instance. Formore information see:https://developers.google.com/identity/protocols/oauth2/web-server#creatingcred

--oauth-client-secret=OAUTH_CLIENT_SECRET
The client secret from an external OAuth application.

OAuth Application Credentials - Looker Instance OAuth login settings. Setup anOAuth app that will allow users to authenticate and access the instance. Formore information see:https://developers.google.com/identity/protocols/oauth2/web-server#creatingcred

OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
Catalog Integration - Catalog Integration is a feature that allows Looker tointegrate with Universal Dataplex Catalog.
--catalog-integration-enabled
This specifies whether Catalog Integration is enabled on the Looker instance.Enabled by default, use--no-catalog-integration-enabled todisable.
--class-type=CLASS_TYPE
The class type of the Looker instance.CLASS_TYPE mustbe one of:p1,r1.
--fips-enabled
This specifies whether FIPS is enabled on the Looker instance.
Key resource - The Cloud KMS (Key Management Service) cryptokey that will beused to protect the Looker instance and backups. The 'Looker Service Agent'service account must hold permission 'Cloud KMS CryptoKey Encrypter/Decrypter'.The arguments in this group can be used to specify the attributes of thisresource.
--kms-key=KMS_KEY
ID of the key or fully qualified identifier for the key. To set thekms-key attribute:
  • provide the argument--kms-key on the command line.
--public-ip-enabled
This specifies whether public IP is enabled on the Looker instance. Enabled bydefault, use--no-public-ip-enabled to disable.
Private IP - Assigns an internal, Google-hosted VPC IP address. Private IPconnectivity requires additional APIs and permissions. Private IP cannot bedisabled once it has been enabled. If enabled,consumer-networkmust be assigned.
--consumer-network=CONSUMER_NETWORK
The network name within the consumer project. This MUST be delared if enablingprivate IP.

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

--private-ip-enabled
This specifies whether private IP (PSA) is enabled on the Looker instance. Thisflag is for creating a PSA (Private Service Access) instance.

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

--reserved-range=RESERVED_RANGE
The name of a reserved IP address range within the consumer network to be usedfor private service access connection.
Deny Maintanence Period - You must allow at least 48 hours of maintenanceavailability in a 60-day rolling window. Only contiguous availability windows ofat least two hours are considered. When setting a maintenance exclusion pleasebe aware that excluding application upgrades cannot exceed 60-days and excludinginfrastructure upgrades cannot exceed 90-days.
--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
End date of the deny maintenance period in format: YYYY-MM-DD

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

--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
Start date of the deny maintenance period in format: YYYY-MM-DD

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

--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME
Time in UTC when the period starts and ends. A valid time of day must bespecified in 24hr format (ex: 13:00, 17:30, 23:45).

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

Gemini AI - Gemini AI is a powerful AI model that can be used to answerquestions, generate content, and perform a variety of other tasks.
--gemini-enabled
This specifies whether Gemini AI is enabled on the Looker instance.

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

--gemini-preview-tester-enabled
This specifies whether user opts in for Gemini AI public preview for the Lookerinstance.
--gemini-prompt-log-enabled
This specifies whether Gemini AI prompt logging is enabled for the Lookerinstance.
Maintenance Window - Maintenance typically only takes place once every fewmonths, and requires your instance to be restarted while updates are made, whichdisrupts service briefly.
--maintenance-window-day=MAINTENANCE_WINDOW_DAY
Day of week for maintenance window, in UTC time zone.MAINTENANCE_WINDOW_DAY must be one of:friday,monday,saturday,sunday,thursday,tuesday,wednesday.

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

--maintenance-window-time=MAINTENANCE_WINDOW_TIME
Hour of day for maintenance window, in UTC time zone. A valid time of day mustbe specified in 24hr format (ex: 13:00, 17:30, 23:45). Maintenance will bescheduled within 60 minutes.

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

Private Service Connect - Private Service Connect allows private consumption ofservices across VPC networks that belong to different groups, teams, projects,or organizations.
--psc-enabled
This specifies whether Private Service Connect (PSC) is enabled on the Lookerinstance.

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

--psc-allowed-vpcs=[PSC_ALLOWED_VPCS,…]
List of VPCs that are allowed ingress into the Looker instance.
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 thelooker/v1alpha2 API. The full documentationfor this API can be found at:https://cloud.google.com/looker/docs/reference/rest/
NOTES
This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. This variant is also available:
gcloudlookerinstancescreate

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 2026-02-18 UTC.