imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-16 12:22:03 +00:00
Code Activity

gcloud: Thu Feb 20 10:40:27 UTC 2025

Browse source
This commit is contained in:
Automated 2025-02-20 10:40:27 +00:00
parent 44f319c56c
commit 8d1a988ab5
295 changed files with 11246 additions and 956 deletions
Download patch file Download diff file Expand all files Collapse all files

4
gcloud/alpha/sql/backups/delete
View file

@ -11,7 +11,9 @@ DESCRIPTION
POSITIONAL ARGUMENTS
ID
The ID of the backup run. To find the ID, run the following command: $
gcloud sql backups list -i {instance}.
gcloud sql backups list -i {instance}.Or, the NAME of the backup. To
find the NAME, run the following command: $ gcloud sql backups list
--filter=instance:{instance}
FLAGS
--async

4
gcloud/alpha/sql/backups/describe
View file

@ -11,7 +11,9 @@ DESCRIPTION
POSITIONAL ARGUMENTS
ID
The ID of the backup run. To find the ID, run the following command: $
gcloud sql backups list -i {instance}.
gcloud sql backups list -i {instance}.Or, the NAME of the backup. To
find the NAME, run the following command: $ gcloud sql backups list
--filter=instance:{instance}
FLAGS
--instance=INSTANCE, -i INSTANCE

3
gcloud/alpha/sql/backups/help
View file

@ -31,6 +31,9 @@ COMMANDS
(ALPHA) Lists all backups associated with the project or a given
instance.
patch
(ALPHA) Update the Final backup of a Cloud SQL project.
restore
(ALPHA) Restores a backup of a Cloud SQL instance.

53
gcloud/alpha/sql/backups/patch Normal file
View file

@ -0,0 +1,53 @@
NAME
gcloud alpha sql backups patch - update the Final backup of a Cloud SQL
project
SYNOPSIS
gcloud alpha sql backups patch NAME
(--backup-description=BACKUP_DESCRIPTION --expiry-time=EXPIRY_TIME
| --ttl-days=TTL_DAYS) [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Update the Final backup of a Cloud SQL project.
POSITIONAL ARGUMENTS
NAME
The NAME of the backup. To find the NAME, run the following command: $
gcloud sql backups list --filter=type:FINAL instance:{instance}.
REQUIRED FLAGS
At least one of these must be specified:
--backup-description=BACKUP_DESCRIPTION
Provides description for the backup going to be taken.
At most one of these can be specified:
--expiry-time=EXPIRY_TIME
Specifies when the final backup expires. The Maximum time allowed
is 365 days from now. Format: YYYY-MM-DDTHH:MM:SS. Provide either
ttl-days or expiry-time.
--ttl-days=TTL_DAYS
Specifies the number of days to retain the final backup. The valid
range is between 1 and 365. The Default value is 30 days. Provide
either ttl-days or expiry-time.
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.
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. These variants are also available:
$ gcloud sql backups patch
$ gcloud beta sql backups patch

389
gcloud/alpha/sql/backups/restore
View file

@ -4,34 +4,411 @@ NAME
SYNOPSIS
gcloud alpha sql backups restore ID --restore-instance=RESTORE_INSTANCE
[--async] [--backup-instance=BACKUP_INSTANCE]
[--backup-project=BACKUP_PROJECT] [GCLOUD_WIDE_FLAG ...]
[--activation-policy=ACTIVATION_POLICY]
[--active-directory-domain=ACTIVE_DIRECTORY_DOMAIN] [--[no-]assign-ip]
[--async] [--audit-bucket-path=AUDIT_BUCKET_PATH]
[--audit-retention-interval=AUDIT_RETENTION_INTERVAL]
[--audit-upload-interval=AUDIT_UPLOAD_INTERVAL]
[--authorized-networks=NETWORK,[NETWORK,...]]
[--availability-type=AVAILABILITY_TYPE] [--no-backup]
[--backup-instance=BACKUP_INSTANCE] [--backup-location=BACKUP_LOCATION]
[--backup-project=BACKUP_PROJECT]
[--backup-start-time=BACKUP_START_TIME] [--collation=COLLATION]
[--connector-enforcement=CONNECTOR_ENFORCEMENT] [--cpu=CPU]
[--database-flags=FLAG=VALUE,[FLAG=VALUE,...]]
[--database-version=DATABASE_VERSION] [--[no-]deletion-protection]
[--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]
[--edition=EDITION] [--enable-bin-log] [--enable-google-private-path]
[--enable-point-in-time-recovery]
[--insights-config-query-insights-enabled]
[--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE]
[--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH]
[--insights-config-record-application-tags]
[--insights-config-record-client-address]
[--maintenance-release-channel=MAINTENANCE_RELEASE_CHANNEL]
[--maintenance-window-day=MAINTENANCE_WINDOW_DAY]
[--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR] [--memory=MEMORY]
[--network=NETWORK] [--require-ssl]
[--retained-backups-count=RETAINED_BACKUPS_COUNT]
[--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS]
[--ssl-mode=SSL_MODE] [--[no-]storage-auto-increase]
[--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE]
[--tier=TIER, -t TIER] [--time-zone=TIME_ZONE]
[--timeout=TIMEOUT; default=3600]
[--allowed-psc-projects=PROJECT,[PROJECT,...]
--enable-private-service-connect]
[--disk-encryption-key=DISK_ENCRYPTION_KEY
: --disk-encryption-key-keyring=DISK_ENCRYPTION_KEY_KEYRING
--disk-encryption-key-location=DISK_ENCRYPTION_KEY_LOCATION
--disk-encryption-key-project=DISK_ENCRYPTION_KEY_PROJECT]
[--region=REGION | --gce-zone=GCE_ZONE
| --secondary-zone=SECONDARY_ZONE --zone=ZONE] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Restores a backup of a Cloud SQL instance.
(ALPHA) The command lets you restore to an existing instance using ID. When
backup Name is used for restore it lets you restore to an existing instance
or a new instance. When restoring to new instance, optional flags can be
used to customize the new instance.
POSITIONAL ARGUMENTS
ID
The ID of the backup run to restore from.
The ID of the backup run to restore from or the backup NAME for restore
to existing/new instance. To find the NAME, run the following command:
$ gcloud sql backups list --filter=instance:{instance}
REQUIRED FLAGS
--restore-instance=RESTORE_INSTANCE
The ID of the target Cloud SQL instance that the backup is restored to.
OPTIONAL FLAGS
--activation-policy=ACTIVATION_POLICY
Activation policy for this instance. This specifies when the instance
should be activated and is applicable only when the instance state is
RUNNABLE. The default is always. More information on activation
policies can be found here:
https://cloud.google.com/sql/docs/mysql/start-stop-restart-instance#activation_policy.
ACTIVATION_POLICY must be one of: always, never.
--active-directory-domain=ACTIVE_DIRECTORY_DOMAIN
Managed Service for Microsoft Active Directory domain this instance is
joined to. Only available for SQL Server instances.
--[no-]assign-ip
Assign a public IP address to the instance. This is a public,
externally available IPv4 address that you can use to connect to your
instance when properly authorized. Use --assign-ip to enable and
--no-assign-ip to disable.
--async
Return immediately, without waiting for the operation in progress to
complete.
--audit-bucket-path=AUDIT_BUCKET_PATH
The location, as a Cloud Storage bucket, to which audit files are
uploaded. The URI is in the form gs://bucketName/folderName. Only
available for SQL Server instances.
--audit-retention-interval=AUDIT_RETENTION_INTERVAL
The number of days for audit log retention on disk, for example, 3dfor
3 days. Only available for SQL Server instances.
--audit-upload-interval=AUDIT_UPLOAD_INTERVAL
How often to upload audit logs (audit files), for example, 30mfor 30
minutes. Only available for SQL Server instances.
--authorized-networks=NETWORK,[NETWORK,...]
The list of external networks that are allowed to connect to the
instance. Specified in CIDR notation, also known as 'slash' notation
(e.g. 192.168.100.0/24).
--availability-type=AVAILABILITY_TYPE
Specifies level of availability. AVAILABILITY_TYPE must be one of:
regional
Provides high availability and is recommended for production
instances; instance automatically fails over to another zone within
your selected region.
zonal
Provides no failover capability. This is the default.
--backup
Enables daily backup. Enabled by default, use --no-backup to disable.
--backup-instance=BACKUP_INSTANCE
The ID of the instance that the backup was taken from. This argument
must be specified when the backup instance is different from the
restore instance. If it is not specified, the backup instance is
considered the same as the restore instance.
considered the same as the restore instance. This flag is not supported
when restore happens from backup name, only supported when restore
happens from backup ID in timestamp format.
--backup-location=BACKUP_LOCATION
Choose where to store your backups. Backups are stored in the closest
multi-region location to you by default. Only customize if needed.
--backup-project=BACKUP_PROJECT
The project of the instance to which the backup belongs. If it isn't
specified, backup and restore instances are in the same project.
specified, backup and restore instances are in the same project. This
flag is not supported when restore happens from backup name, only
supported when restore happens from backup ID in timestamp format.
--backup-start-time=BACKUP_START_TIME
Start time of daily backups, specified in the HH:MM format, in the UTC
timezone.
--collation=COLLATION
Cloud SQL server-level collation setting, which specifies the set of
rules for comparing characters in a character set.
--connector-enforcement=CONNECTOR_ENFORCEMENT
Cloud SQL Connector enforcement mode. It determines how Cloud SQL
Connectors are used in the connection. See the list of modes here
(https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/instances#connectorenforcement).
CONNECTOR_ENFORCEMENT must be one of:
CONNECTOR_ENFORCEMENT_UNSPECIFIED
The requirement for Cloud SQL connectors is unknown.
NOT_REQUIRED
Does not require Cloud SQL connectors.
REQUIRED
Requires all connections to use Cloud SQL connectors, including the
Cloud SQL Auth Proxy and Cloud SQL Java, Python, and Go connectors.
Note: This disables all existing authorized networks.
--cpu=CPU
Whole number value indicating how many cores are desired in the
machine. Both --cpu and --memory must be specified if a custom machine
type is desired, and the --tier flag must be omitted.
--database-flags=FLAG=VALUE,[FLAG=VALUE,...]
Comma-separated list of database flags to set on the instance. Use an
equals sign to separate flag name and value. Flags without values, like
skip_grant_tables, can be written out without a value after, e.g.,
skip_grant_tables=. Use on/off for booleans. View the Instance Resource
API for allowed flags. (e.g., --database-flags
max_allowed_packet=55555,skip_grant_tables=,log_output=1)
--database-version=DATABASE_VERSION
The database engine type and versions. If left unspecified, no changes
occur. See the list of database versions at
https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion.
Note for restore to new instance major version upgrades are not
supported. Only minor version upgrades are allowed.
--[no-]deletion-protection
Enable deletion protection on a Cloud SQL instance. Use
--deletion-protection to enable and --no-deletion-protection to
disable.
--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
Date when the deny maintenance period ends, that is 2021-01-10.
--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
Date when the deny maintenance period begins, that is 2020-11-01.
--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME
Time when the deny maintenance period starts or ends, that is 05:00:00.
--edition=EDITION
Specifies the edition of Cloud SQL instance. EDITION must be one of:
enterprise, enterprise-plus.
--enable-bin-log
Allows for data recovery from a specific point in time, down to a
fraction of a second. Must have automatic backups enabled to use. Make
sure storage can support at least 7 days of logs.
--enable-google-private-path
Enable a private path for Google Cloud services. This flag specifies
whether the instance is accessible to internal Google Cloud services
such as BigQuery. This is only applicable to MySQL and PostgreSQL
instances that don't use public IP. Currently, SQL Server isn't
supported.
--enable-point-in-time-recovery
Allows for data recovery from a specific point in time, down to a
fraction of a second, via write-ahead logs. Must have automatic backups
enabled to use. Make sure storage can support at least 7 days of logs.
--insights-config-query-insights-enabled
Enable query insights feature to provide query and query plan
analytics.
--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. Default length is 1024 bytes. Allowed range: 256 to 4500
bytes.
--insights-config-record-application-tags
Allow application tags to be recorded by the query insights feature.
--insights-config-record-client-address
Allow the client address to be recorded by the query insights feature.
--maintenance-release-channel=MAINTENANCE_RELEASE_CHANNEL
Which channel's updates to apply during the maintenance window. If not
specified, Cloud SQL chooses the timing of updates to your instance.
MAINTENANCE_RELEASE_CHANNEL must be one of:
preview
Preview updates release prior to production updates. You may wish
to use the preview channel for dev/test applications so that you
can preview their compatibility with your application prior to the
production release.
production
Production updates are stable and recommended for applications in
production.
week5
week5 updates release after the production updates. Use the week5
channel to receive a 5 week advance notification about the upcoming
maintenance, so you can prepare your application for the release.
--maintenance-window-day=MAINTENANCE_WINDOW_DAY
Day of week for maintenance window, in UTC time zone.
MAINTENANCE_WINDOW_DAY must be one of: SUN, MON, TUE, WED, THU, FRI,
SAT.
--maintenance-window-hour=MAINTENANCE_WINDOW_HOUR
Hour of day for maintenance window, in UTC time zone.
--memory=MEMORY
Whole number value indicating how much memory is desired in the
machine. A size unit should be provided (eg. 3072MiB or 9GiB) - if no
units are specified, GiB is assumed. Both --cpu and --memory must be
specified if a custom machine type is desired, and the --tier flag must
be omitted.
--network=NETWORK
Network in the current project that the instance will be part of. To
specify using a network with a shared VPC, use the full URL of the
network. For an example host project, 'testproject', and shared
network, 'testsharednetwork', this would use the form:
--network=projects/testproject/global/networks/testsharednetwork
--require-ssl
Specified if users connecting over IP must use SSL.
--retained-backups-count=RETAINED_BACKUPS_COUNT
How many backups to keep. The valid range is between 1 and 365. Default
value is 7 for Enterprise edition instances. For Enterprise_Plus,
default value is 15. Applicable only if --no-backups is not specified.
--retained-transaction-log-days=RETAINED_TRANSACTION_LOG_DAYS
How many days of transaction logs to keep. The valid range is between 1
and 35. Only use this option when point-in-time recovery is enabled. If
logs are stored on disk, storage size for transaction logs could
increase when the number of days for log retention increases. For
Enterprise, default and max retention values are 7 and 7 respectively.
For Enterprise_Plus, default and max retention values are 14 and 35.
--ssl-mode=SSL_MODE
Set the SSL mode of the instance. SSL_MODE must be one of:
ALLOW_UNENCRYPTED_AND_ENCRYPTED
Allow non-SSL and SSL connections. For SSL connections, client
certificate will not be verified.
ENCRYPTED_ONLY
Only allow connections encrypted with SSL/TLS.
TRUSTED_CLIENT_CERTIFICATE_REQUIRED
Only allow connections encrypted with SSL/TLS and with valid client
certificates.
--[no-]storage-auto-increase
Storage size can be increased, but it cannot be decreased; storage
increases are permanent for the life of the instance. With this setting
enabled, a spike in storage requirements can result in permanently
increased storage costs for your instance. However, if an instance runs
out of available space, it can result in the instance going offline,
dropping existing connections. This setting is enabled by default. Use
--storage-auto-increase to enable and --no-storage-auto-increase to
disable.
--storage-size=STORAGE_SIZE
Amount of storage allocated to the instance. Must be an integer number
of GB. The default is 10GB. Information on storage limits can be found
here: https://cloud.google.com/sql/docs/quotas#storage_limits
--storage-type=STORAGE_TYPE
The storage type for the instance. The default is SSD. STORAGE_TYPE
must be one of: SSD, HDD, HYPERDISK_BALANCED.
--tier=TIER, -t TIER
Machine type for a shared-core instance e.g. db-g1-small. For all other
instances, instead of using tiers, customize your instance by
specifying its CPU and memory. You can do so with the --cpu and
--memory flags. Learn more about how CPU and memory affects pricing:
https://cloud.google.com/sql/pricing.
--time-zone=TIME_ZONE
Set a non-default time zone. Only available for SQL Server instances.
--timeout=TIMEOUT; default=3600
Time to synchronously wait for the operation to complete, after which
the operation continues asynchronously. Ignored if --async flag is
specified. By default, set to 3600s. To wait indefinitely, set to
unlimited.
--allowed-psc-projects=PROJECT,[PROJECT,...]
A comma-separated list of projects. Each project in this list might be
represented by a project number (numeric) or by a project ID
(alphanumeric). This allows Private Service Connect connections to be
established from specified consumer projects.
--enable-private-service-connect
Enable connecting to the Cloud SQL instance with Private Service
Connect.
Key resource - The Cloud KMS (Key Management Service) cryptokey that will
be used to protect the instance. The 'Compute Engine 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 this resource.
--disk-encryption-key=DISK_ENCRYPTION_KEY
ID of the key or fully qualified identifier for the key.
To set the kms-key attribute:
▸ provide the argument --disk-encryption-key on the command line.
This flag argument must be specified if any of the other arguments in
this group are specified.
--disk-encryption-key-keyring=DISK_ENCRYPTION_KEY_KEYRING
The KMS keyring of the key.
To set the kms-keyring attribute:
▸ provide the argument --disk-encryption-key on the command line
with a fully specified name;
▸ provide the argument --disk-encryption-key-keyring on the command
line.
--disk-encryption-key-location=DISK_ENCRYPTION_KEY_LOCATION
The Google Cloud location for the key.
To set the kms-location attribute:
▸ provide the argument --disk-encryption-key on the command line
with a fully specified name;
▸ provide the argument --disk-encryption-key-location on the
command line.
--disk-encryption-key-project=DISK_ENCRYPTION_KEY_PROJECT
The Google Cloud project for the key.
To set the kms-project attribute:
▸ provide the argument --disk-encryption-key on the command line
with a fully specified name;
▸ provide the argument --disk-encryption-key-project on the command
line;
▸ set the property core/project.
At most one of these can be specified:
--region=REGION
Regional location (e.g. asia-east1, us-east1). See the full list of
regions at https://cloud.google.com/sql/docs/instance-locations.
At most one of these can be specified:
--gce-zone=GCE_ZONE
(DEPRECATED) Preferred Compute Engine zone (e.g. us-central1-a,
us-central1-b, etc.).
Flag --gce-zone is deprecated and will be removed by release
255.0.0. Use --zone instead.
--secondary-zone=SECONDARY_ZONE
Preferred secondary Compute Engine zone (e.g. us-central1-a,
us-central1-b, etc.).
--zone=ZONE
Preferred Compute Engine zone (e.g. us-central1-a, us-central1-b,
etc.).
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,

6
gcloud/alpha/sql/instances/create
View file

@ -53,6 +53,7 @@ SYNOPSIS
[--[no-]storage-auto-increase]
[--storage-auto-increase-limit=STORAGE_AUTO_INCREASE_LIMIT]
[--storage-size=STORAGE_SIZE] [--storage-type=STORAGE_TYPE]
[--tags=TAG=VALUE,[TAG=VALUE,...]]
[--threads-per-core=THREADS_PER_CORE] [--tier=TIER, -t TIER]
[--time-zone=TIME_ZONE] [--timeout=TIMEOUT; default=3600]
[--allowed-psc-projects=PROJECT,[PROJECT,...]
@ -515,6 +516,11 @@ FLAGS
The storage type for the instance. The default is SSD. STORAGE_TYPE
must be one of: SSD, HDD, HYPERDISK_BALANCED.
--tags=TAG=VALUE,[TAG=VALUE,...]
Comma-separated list of tags to set on the instance. Use an equals
signto separate tag name and value.(e.g., --tags
tag1:value1,tag2=value2)
--threads-per-core=THREADS_PER_CORE
The number of threads per core. The value of this flag can be 1 or 2.
To disable SMT, set this flag to 1. Only available in Cloud SQL for SQL

23
gcloud/alpha/sql/instances/delete
View file

@ -2,7 +2,12 @@ NAME
gcloud alpha sql instances delete - deletes a Cloud SQL instance
SYNOPSIS
gcloud alpha sql instances delete INSTANCE [--async] [GCLOUD_WIDE_FLAG ...]
gcloud alpha sql instances delete INSTANCE [--async]
[--enable-final-backup]
[--final-backup-description=FINAL_BACKUP_DESCRIPTION]
[--final-backup-expiry-time=FINAL_BACKUP_EXPIRY_TIME
| --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Deletes a Cloud SQL instance.
@ -16,6 +21,22 @@ FLAGS
Return immediately, without waiting for the operation in progress to
complete.
--enable-final-backup
Enables the final backup to be taken at the time of instance deletion.
--final-backup-description=FINAL_BACKUP_DESCRIPTION
Provides description for the final backup going to be taken.
At most one of these can be specified:
--final-backup-expiry-time=FINAL_BACKUP_EXPIRY_TIME
Specifies the time at which the final backup will expire. Maximum
time allowed is 365 days from now. Format: YYYY-MM-DDTHH:MM:SS.
--final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS
Specifies number of days to retain final backup. The valid range is
between 1 and 365. Default value is 30 days.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,