gcloud alpha looker instances create Stay organized with collections Save and categorize content based on your preferences.
- 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.
--asyncflag is not passed
- EXAMPLES
- To create a basic tier instance with the name
my-looker-instanceinregionus-central-1with an edition ofLOOKER_CORE_STANDARD, run:gcloudalphalookerinstancescreatemy-looker-instance--region=us-central1--edition="core-standard"--oauth-client-id='looker'--oauth-client-secret='looker'--asyncNote: It is
recommendedthat the--asyncargument 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 the
projectattribute:- provide the argument
instanceon the command line with a fullyspecified name; - provide the argument
--projecton the command line; - set the property
core/project.
This must be specified.
INSTANCE- ID of the instance or fully qualified identifier for the instance.
To set the
instanceattribute:- provide the argument
instanceon the command line.
This positional argument must be specified if any of the other arguments in thisgroup are specified.
- provide the argument
--region=REGION- The name of the Looker region of the instance. Overrides the defaultlooker/region property value for this command invocation.To set the
regionattribute:- provide the argument
instanceon the command line with a fullyspecified name; - provide the argument
--regionon the command line; - set the property
looker/region.
- provide the argument
- provide the argument
- 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.
- REQUIRED FLAGS
--edition=EDITION- The edition of the Looker instance.
EDITIONmust 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-enabledtodisable. --class-type=CLASS_TYPE- The class type of the Looker instance.
CLASS_TYPEmustbe 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 the
kms-keyattribute:- provide the argument
--kms-keyon the command line.
- provide the argument
--public-ip-enabled- This specifies whether public IP is enabled on the Looker instance. Enabled bydefault, use
--no-public-ip-enabledto 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_DAYmust 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 helpfor details. - API REFERENCE
- This command uses the
looker/v1alpha2API. 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.