diff --git a/gcloud/_version b/gcloud/_version index fa0cd6353..a5217cd17 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 539.0.0 -alpha 2025.09.12 -beta 2025.09.12 +Google Cloud SDK 540.0.0 +alpha 2025.09.23 +beta 2025.09.23 bq 2.1.23 bundled-python3-unix 3.12.9 -core 2025.09.12 +core 2025.09.23 gcloud-crc32c 1.0.0 gsutil 5.35 diff --git a/gcloud/alloydb/instances/create b/gcloud/alloydb/instances/create index f22c8be91..547ecc3ce 100644 --- a/gcloud/alloydb/instances/create +++ b/gcloud/alloydb/instances/create @@ -9,8 +9,21 @@ SYNOPSIS [--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]] [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] - [--availability-type=AVAILABILITY_TYPE] [--cpu-count=CPU_COUNT] - [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--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] @@ -108,6 +121,51 @@ OPTIONAL FLAGS 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 + is disconnected. + + --connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,...] + Comma-separated list of startup parameters that should be ignored by + the connection 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 been connected longer than this. Setting it to 0 + means the connection is to be used only 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 the instance does not have a machine-type, the vCPU count @@ -128,6 +186,11 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_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. diff --git a/gcloud/alloydb/instances/create-secondary b/gcloud/alloydb/instances/create-secondary index 9adc10bc6..bf09a16ee 100644 --- a/gcloud/alloydb/instances/create-secondary +++ b/gcloud/alloydb/instances/create-secondary @@ -10,8 +10,20 @@ SYNOPSIS [--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,...]] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] - [--[no-]outbound-public-ip] + [--[no-]enable-connection-pooling] [--[no-]outbound-public-ip] [--psc-auto-connections=[network=NETWORK],[project=PROJECT]] [--psc-network-attachment-uri=PSC_NETWORK_ATTACHMENT_URI] [--[no-]require-connectors] [--ssl-mode=SSL_MODE] @@ -85,6 +97,51 @@ OPTIONAL FLAGS 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 + is disconnected. + + --connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,...] + Comma-separated list of startup parameters that should be ignored by + the connection 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 been connected longer than this. Setting it to 0 + means the connection is to be used only once, then closed. + + --connection-pooling-stats-users=[STATS_USERS,...] + Comma-separated list of database users to access connection pooling + stats. + --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 @@ -93,6 +150,11 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_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. + --[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. diff --git a/gcloud/alloydb/instances/update b/gcloud/alloydb/instances/update index 6d9116ace..f5b884a61 100644 --- a/gcloud/alloydb/instances/update +++ b/gcloud/alloydb/instances/update @@ -9,8 +9,21 @@ SYNOPSIS [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] [--availability-type=AVAILABILITY_TYPE] - [--clear-psc-network-attachment-uri] [--cpu-count=CPU_COUNT] - [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--clear-psc-network-attachment-uri] + [--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] @@ -94,6 +107,51 @@ OPTIONAL FLAGS Disable outbound connectivity from an AlloyDB instance which uses Private Service Connect (PSC). + --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 + is disconnected. + + --connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,...] + Comma-separated list of startup parameters that should be ignored by + the connection 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 been connected longer than this. Setting it to 0 + means the connection is to be used only 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 the instance does not have a machine-type, the vCPU count @@ -114,6 +172,11 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_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. diff --git a/gcloud/alpha/alloydb/clusters/restore b/gcloud/alpha/alloydb/clusters/restore index ba4f4b3e3..49acfafd9 100644 --- a/gcloud/alpha/alloydb/clusters/restore +++ b/gcloud/alpha/alloydb/clusters/restore @@ -4,8 +4,10 @@ NAME SYNOPSIS gcloud alpha alloydb clusters restore CLUSTER --region=REGION - (--backup=BACKUP - | --point-in-time=POINT_IN_TIME --source-cluster=SOURCE_CLUSTER) + (--backup=BACKUP | --backupdr-backup=BACKUPDR_BACKUP + | --point-in-time=POINT_IN_TIME + (--backupdr-data-source=BACKUPDR_DATA_SOURCE + | --source-cluster=SOURCE_CLUSTER)) [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] [--async] [--enable-private-service-connect] [--network=NETWORK] [--tags=[KEY=VALUE,...]] @@ -49,6 +51,10 @@ REQUIRED FLAGS location are assumed to be the same as the restored cluster that is being created. + --backupdr-backup=BACKUPDR_BACKUP + Backup DR backup to restore from. This is a resource path of the form + projects/myProject/locations/us-central1/backupVaults/myBackupVault/dataSources/myDataSource/backups/myBackup. + Restore a cluster from a source cluster at a given point in time. --point-in-time=POINT_IN_TIME @@ -62,6 +68,11 @@ REQUIRED FLAGS Exactly one of these must be specified: + --backupdr-data-source=BACKUPDR_DATA_SOURCE + Backup DR data source to restore from. This is a resource path of + the form + projects/myProject/locations/us-central1/backupVaults/myBackupVault/dataSources/myDataSource. + --source-cluster=SOURCE_CLUSTER AlloyDB source cluster to restore from. This must either be the full cluster name diff --git a/gcloud/alpha/backup-dr/data-source-references/fetch-for-resource-type b/gcloud/alpha/backup-dr/data-source-references/fetch-for-resource-type index d9beb79c9..7e70ab280 100644 --- a/gcloud/alpha/backup-dr/data-source-references/fetch-for-resource-type +++ b/gcloud/alpha/backup-dr/data-source-references/fetch-for-resource-type @@ -19,7 +19,7 @@ EXAMPLES $ gcloud alpha backup-dr data-source-references \ fetch-for-resource-type sqladmin.googleapis.com/Instance \ - --location="us-central1" --project-id="test-project" + --location="us-central1" --project="test-project" POSITIONAL ARGUMENTS RESOURCE_TYPE diff --git a/gcloud/alpha/cloudlocationfinder/cloud-locations/describe b/gcloud/alpha/cloudlocationfinder/cloud-locations/describe index 799893657..38f856fb1 100644 --- a/gcloud/alpha/cloudlocationfinder/cloud-locations/describe +++ b/gcloud/alpha/cloudlocationfinder/cloud-locations/describe @@ -64,5 +64,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud cloudlocationfinder cloud-locations describe diff --git a/gcloud/alpha/cloudlocationfinder/cloud-locations/help b/gcloud/alpha/cloudlocationfinder/cloud-locations/help index 9198f1274..2bb0b45a6 100644 --- a/gcloud/alpha/cloudlocationfinder/cloud-locations/help +++ b/gcloud/alpha/cloudlocationfinder/cloud-locations/help @@ -30,5 +30,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud cloudlocationfinder cloud-locations diff --git a/gcloud/alpha/cloudlocationfinder/cloud-locations/list b/gcloud/alpha/cloudlocationfinder/cloud-locations/list index f6c5b5ee5..0029ed781 100644 --- a/gcloud/alpha/cloudlocationfinder/cloud-locations/list +++ b/gcloud/alpha/cloudlocationfinder/cloud-locations/list @@ -71,5 +71,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud cloudlocationfinder cloud-locations list diff --git a/gcloud/alpha/cloudlocationfinder/cloud-locations/search b/gcloud/alpha/cloudlocationfinder/cloud-locations/search index 4ab9b94ce..da71325db 100644 --- a/gcloud/alpha/cloudlocationfinder/cloud-locations/search +++ b/gcloud/alpha/cloudlocationfinder/cloud-locations/search @@ -16,7 +16,7 @@ EXAMPLES $ gcloud alpha cloudlocationfinder cloud-locations search \ --source-cloud-location=aws-us-east-1 \ - --query=displayName=us-east4 + --query=display_name="us-east4" REQUIRED FLAGS Source cloud location resource - The source Cloud location. This @@ -84,5 +84,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud cloudlocationfinder cloud-locations search diff --git a/gcloud/alpha/cloudlocationfinder/help b/gcloud/alpha/cloudlocationfinder/help index 7aef9b609..23d2130be 100644 --- a/gcloud/alpha/cloudlocationfinder/help +++ b/gcloud/alpha/cloudlocationfinder/help @@ -22,5 +22,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud cloudlocationfinder diff --git a/gcloud/alpha/cluster-director/clusters/create b/gcloud/alpha/cluster-director/clusters/create index 14e42f647..2af83aaab 100644 --- a/gcloud/alpha/cluster-director/clusters/create +++ b/gcloud/alpha/cluster-director/clusters/create @@ -5,9 +5,9 @@ NAME SYNOPSIS gcloud alpha cluster-director clusters create (CLUSTER : --location=LOCATION) - (--config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS], - [name=NAME], - [networks=NETWORKS],[orchestrator=ORCHESTRATOR],[storages=STORAGES] + (--config=[computeResources=COMPUTERESOURCES],[description=DESCRIPTION], + [labels=LABELS],[name=NAME],[networkResources=NETWORKRESOURCES], + [orchestrator=ORCHESTRATOR],[storageResources=STORAGERESOURCES] | [--slurm-login-node=[count=COUNT],[enableOSLogin=ENABLEOSLOGIN], [enablePublicIPs=ENABLEPUBLICIPS],[labels=LABELS], [machineType=MACHINETYPE],[startupScript=STARTUPSCRIPT],[zone=ZONE] @@ -122,69 +122,57 @@ REQUIRED FLAGS Exactly one of these must be specified: - --config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networks=NETWORKS],[orchestrator=ORCHESTRATOR],[storages=STORAGES] + --config=[computeResources=COMPUTERESOURCES],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networkResources=NETWORKRESOURCES],[orchestrator=ORCHESTRATOR],[storageResources=STORAGERESOURCES] Configuration of the cluster specs in the form of a JSON object. Sets config value. - compute - Sets compute value. + computeResources + Sets computeResources value. - resourceRequests - Sets resourceRequests value. + KEY + Sets KEY value. - disks - Sets disks value. + VALUE + Sets VALUE value. - boot - Sets boot value. + newDwsFlexInstances + Sets newDwsFlexInstances value. - sizeGb - Required, sets sizeGb value. + machineType + Sets machineType value. - sourceImage - Sets sourceImage value. + maxDuration + Sets maxDuration value. - type - Required, sets type value. + zone + Sets zone value. - guestAccelerators - Sets guestAccelerators value. + newOnDemandInstances + Sets newOnDemandInstances value. - acceleratorType - Sets acceleratorType value. + machineType + Sets machineType value. - count - Sets count value. + zone + Sets zone value. - id - Sets id value. + newReservedInstances + Sets newReservedInstances value. - machineType - Sets machineType value. + machineType + Sets machineType value. - maxRunDuration - Sets maxRunDuration value. + reservation + Sets reservation value. - provisioningModel - Sets provisioningModel value. + newSpotInstances + Sets newSpotInstances value. - reservationAffinity - Sets reservationAffinity value. + machineType + Sets machineType value. - key - Sets key value. - - type - Sets type value. - - values - Sets values value. - - terminationAction - Sets terminationAction value. - - zone - Sets zone value. + zone + Sets zone value. description Sets description value. @@ -201,26 +189,35 @@ REQUIRED FLAGS name Sets name value. - networks - Sets networks value. + networkResources + Sets networkResources value. - initializeParams - Sets initializeParams value. + KEY + Sets KEY value. - description - Sets description value. + VALUE + Sets VALUE value. - network - Sets network value. + config + Sets config value. - networkSource - Sets networkSource value. + existingNetwork + Sets existingNetwork value. - network - Sets network value. + network + Sets network value. - subnetwork - Sets subnetwork value. + subnetwork + Sets subnetwork value. + + newNetwork + Sets newNetwork value. + + description + Sets description value. + + network + Sets network value. orchestrator Sets orchestrator value. @@ -228,27 +225,9 @@ REQUIRED FLAGS slurm Sets slurm value. - config - Sets config value. - - prologEpilogTimeout - Sets prologEpilogTimeout value. - - prologFlags - Sets prologFlags value. - - requeueExitCodes - Sets requeueExitCodes value. - - requeueHoldExitCodes - Sets requeueHoldExitCodes value. - defaultPartition Sets defaultPartition value. - epilogBashScripts - Sets epilogBashScripts value. - loginNodes Sets loginNodes value. @@ -259,10 +238,10 @@ REQUIRED FLAGS Sets disks value. boot - Sets boot value. + Required, sets boot value. sizeGb - Required, sets sizeGb value. + Sets sizeGb value. sourceImage Sets sourceImage value. @@ -288,15 +267,6 @@ REQUIRED FLAGS machineType Sets machineType value. - serviceAccount - Sets serviceAccount value. - - email - Sets email value. - - scopes - Sets scopes value. - startupScript Sets startupScript value. @@ -315,14 +285,20 @@ REQUIRED FLAGS nodeSets Sets nodeSets value. - canIpForward - Sets canIpForward value. + bootDisk + Sets bootDisk value. - enableOsLogin - Sets enableOsLogin value. + boot + Required, sets boot value. - enablePublicIps - Sets enablePublicIps value. + sizeGb + Sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Required, sets type value. id Sets id value. @@ -342,15 +318,6 @@ REQUIRED FLAGS resourceRequestId Sets resourceRequestId value. - serviceAccount - Sets serviceAccount value. - - email - Sets email value. - - scopes - Sets scopes value. - startupScript Sets startupScript value. @@ -378,106 +345,103 @@ REQUIRED FLAGS nodeSetIds Sets nodeSetIds value. - prologBashScripts - Sets prologBashScripts value. + storageResources + Sets storageResources value. - taskEpilogBashScripts - Sets taskEpilogBashScripts value. + KEY + Sets KEY value. - taskPrologBashScripts - Sets taskPrologBashScripts value. + VALUE + Sets VALUE value. - storages - Sets storages value. + config + Sets config value. - id - Sets id value. + existingBucket + Sets existingBucket value. - initializeParams - Sets initializeParams value. + bucket + Sets bucket value. - filestore - Sets filestore value. + existingFilestore + Sets existingFilestore value. - description - Sets description value. + filestore + Sets filestore value. - fileShares - Sets fileShares value. + existingLustre + Sets existingLustre value. + + lustre + Sets lustre value. + + newBucket + Sets newBucket value. + + autoclass + Sets autoclass value. + + enabled + Sets enabled value. + + bucket + Sets bucket value. + + hierarchicalNamespace + Sets hierarchicalNamespace value. + + enabled + Sets enabled value. + + storageClass + Sets storageClass value. + + newFilestore + Sets newFilestore value. + + description + Sets description value. + + fileShares + Sets fileShares value. + + capacityGb + Sets capacityGb value. + + fileShare + Sets fileShare value. + + filestore + Sets filestore value. + + protocol + Sets protocol value. + + tier + Sets tier value. + + newLustre + Sets newLustre value. capacityGb Sets capacityGb value. - fileShare - Sets fileShare value. + description + Sets description value. - filestore - Sets filestore value. + filesystem + Sets filesystem value. - protocol - Sets protocol value. - - tier - Sets tier value. - - gcs - Sets gcs value. - - autoclass - Sets autoclass value. - - enabled - Sets enabled value. - - terminalStorageClass - Sets terminalStorageClass value. - - bucket - Sets bucket value. - - hierarchicalNamespace - Sets hierarchicalNamespace value. - - enabled - Sets enabled value. - - storageClass - Sets storageClass value. - - lustre - Sets lustre value. - - capacityGb - Sets capacityGb value. - - description - Sets description value. - - filesystem - Sets filesystem value. - - lustre - Sets lustre value. - - storageSource - Sets storageSource value. - - bucket - Sets bucket value. - - filestore - Sets filestore value. - - lustre - Sets lustre value. + lustre + Sets lustre value. Shorthand Example: - --config=compute={resourceRequests=[{disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],guestAccelerators=[{acceleratorType=string,count=int}],id=string,machineType=string,maxRunDuration=int,provisioningModel=string,reservationAffinity={key=string,type=string,values},terminationAction=string,zone=string}]},description=string,labels={string=string},name=string,networks=[{initializeParams={description=string,network=string},networkSource={network=string,subnetwork=string}}],orchestrator={slurm={config={prologEpilogTimeout=string,prologFlags,requeueExitCodes,requeueHoldExitCodes},defaultPartition=string,epilogBashScripts,loginNodes={count=int,disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,serviceAccount={email=string,scopes},startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{canIpForward=boolean,enableOsLogin=boolean,enablePublicIps=boolean,id=string,labels={string=string},maxDynamicNodeCount=int,resourceRequestId=string,serviceAccount={email=string,scopes},startupScript=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts,taskEpilogBashScripts,taskPrologBashScripts}},storages=[{id=string,initializeParams={filestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},gcs={autoclass={enabled=boolean,terminalStorageClass=string},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},lustre={capacityGb=int,description=string,filesystem=string,lustre=string}},storageSource={bucket=string,filestore=string,lustre=string}}] + --config=computeResources={string={newDwsFlexInstances={machineType=string,maxDuration=string,zone=string},newOnDemandInstances={machineType=string,zone=string},newReservedInstances={machineType=string,reservation=string},newSpotInstances={machineType=string,zone=string}}},description=string,labels={string=string},name=string,networkResources={string={config={existingNetwork={network=string,subnetwork=string},newNetwork={description=string,network=string}}}},orchestrator={slurm={defaultPartition=string,loginNodes={count=int,disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{bootDisk={boot=boolean,sizeGb=int,sourceImage=string,type=string},id=string,labels={string=string},maxDynamicNodeCount=int,resourceRequestId=string,startupScript=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}]}},storageResources={string={config={existingBucket={bucket=string},existingFilestore={filestore=string},existingLustre={lustre=string},newBucket={autoclass={enabled=boolean},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},newFilestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},newLustre={capacityGb=int,description=string,filesystem=string,lustre=string}}}} JSON Example: - --config='{"compute": {"resourceRequests": [{"disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "guestAccelerators": [{"acceleratorType": "string", "count": int}], "id": "string", "machineType": "string", "maxRunDuration": int, "provisioningModel": "string", "reservationAffinity": {"key": "string", "type": "string", "values"}, "terminationAction": "string", "zone": "string"}]}, "description": "string", "labels": {"string": "string"}, "name": "string", "networks": [{"initializeParams": {"description": "string", "network": "string"}, "networkSource": {"network": "string", "subnetwork": "string"}}], "orchestrator": {"slurm": {"config": {"prologEpilogTimeout": "string", "prologFlags", "requeueExitCodes", "requeueHoldExitCodes"}, "defaultPartition": "string", "epilogBashScripts", "loginNodes": {"count": int, "disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"canIpForward": boolean, "enableOsLogin": boolean, "enablePublicIps": boolean, "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "resourceRequestId": "string", "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts", "taskEpilogBashScripts", "taskPrologBashScripts"}}, "storages": [{"id": "string", "initializeParams": {"filestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "gcs": {"autoclass": {"enabled": boolean, "terminalStorageClass": "string"}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "lustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}, "storageSource": {"bucket": "string", "filestore": "string", "lustre": "string"}}]}' + --config='{"computeResources": {"string": {"newDwsFlexInstances": {"machineType": "string", "maxDuration": "string", "zone": "string"}, "newOnDemandInstances": {"machineType": "string", "zone": "string"}, "newReservedInstances": {"machineType": "string", "reservation": "string"}, "newSpotInstances": {"machineType": "string", "zone": "string"}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"config": {"existingNetwork": {"network": "string", "subnetwork": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "orchestrator": {"slurm": {"defaultPartition": "string", "loginNodes": {"count": int, "disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"bootDisk": {"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}, "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "resourceRequestId": "string", "startupScript": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}]}}, "storageResources": {"string": {"config": {"existingBucket": {"bucket": "string"}, "existingFilestore": {"filestore": "string"}, "existingLustre": {"lustre": "string"}, "newBucket": {"autoclass": {"enabled": boolean}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "newFilestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "newLustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}}}}' File Example: diff --git a/gcloud/alpha/cluster-director/clusters/update b/gcloud/alpha/cluster-director/clusters/update index bc795e50d..034ee7e09 100644 --- a/gcloud/alpha/cluster-director/clusters/update +++ b/gcloud/alpha/cluster-director/clusters/update @@ -32,9 +32,10 @@ SYNOPSIS [staticNodeCount=STATICNODECOUNT] --update-slurm-partitions=[exclusive=EXCLUSIVE], [id=ID],[nodesetIds=NODESETIDS] - | --config=[compute=COMPUTE],[description=DESCRIPTION], - [labels=LABELS],[name=NAME], - [networks=NETWORKS],[orchestrator=ORCHESTRATOR],[storages=STORAGES] + | --config=[computeResources=COMPUTERESOURCES], + [description=DESCRIPTION],[labels=LABELS],[name=NAME], + [networkResources=NETWORKRESOURCES], + [orchestrator=ORCHESTRATOR],[storageResources=STORAGERESOURCES] --update-mask=UPDATE_MASK) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -508,69 +509,57 @@ REQUIRED FLAGS Cluster configuration for updates. - --config=[compute=COMPUTE],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networks=NETWORKS],[orchestrator=ORCHESTRATOR],[storages=STORAGES] + --config=[computeResources=COMPUTERESOURCES],[description=DESCRIPTION],[labels=LABELS],[name=NAME],[networkResources=NETWORKRESOURCES],[orchestrator=ORCHESTRATOR],[storageResources=STORAGERESOURCES] Configuration of the cluster specs in the form of a JSON object. Required, sets config value. - compute - Sets compute value. + computeResources + Sets computeResources value. - resourceRequests - Sets resourceRequests value. + KEY + Sets KEY value. - disks - Sets disks value. + VALUE + Sets VALUE value. - boot - Sets boot value. + newDwsFlexInstances + Sets newDwsFlexInstances value. - sizeGb - Required, sets sizeGb value. + machineType + Sets machineType value. - sourceImage - Sets sourceImage value. + maxDuration + Sets maxDuration value. - type - Required, sets type value. + zone + Sets zone value. - guestAccelerators - Sets guestAccelerators value. + newOnDemandInstances + Sets newOnDemandInstances value. - acceleratorType - Sets acceleratorType value. + machineType + Sets machineType value. - count - Sets count value. + zone + Sets zone value. - id - Sets id value. + newReservedInstances + Sets newReservedInstances value. - machineType - Sets machineType value. + machineType + Sets machineType value. - maxRunDuration - Sets maxRunDuration value. + reservation + Sets reservation value. - provisioningModel - Sets provisioningModel value. + newSpotInstances + Sets newSpotInstances value. - reservationAffinity - Sets reservationAffinity value. + machineType + Sets machineType value. - key - Sets key value. - - type - Sets type value. - - values - Sets values value. - - terminationAction - Sets terminationAction value. - - zone - Sets zone value. + zone + Sets zone value. description Sets description value. @@ -587,26 +576,35 @@ REQUIRED FLAGS name Sets name value. - networks - Sets networks value. + networkResources + Sets networkResources value. - initializeParams - Sets initializeParams value. + KEY + Sets KEY value. - description - Sets description value. + VALUE + Sets VALUE value. - network - Sets network value. + config + Sets config value. - networkSource - Sets networkSource value. + existingNetwork + Sets existingNetwork value. - network - Sets network value. + network + Sets network value. - subnetwork - Sets subnetwork value. + subnetwork + Sets subnetwork value. + + newNetwork + Sets newNetwork value. + + description + Sets description value. + + network + Sets network value. orchestrator Sets orchestrator value. @@ -614,27 +612,9 @@ REQUIRED FLAGS slurm Sets slurm value. - config - Sets config value. - - prologEpilogTimeout - Sets prologEpilogTimeout value. - - prologFlags - Sets prologFlags value. - - requeueExitCodes - Sets requeueExitCodes value. - - requeueHoldExitCodes - Sets requeueHoldExitCodes value. - defaultPartition Sets defaultPartition value. - epilogBashScripts - Sets epilogBashScripts value. - loginNodes Sets loginNodes value. @@ -645,10 +625,10 @@ REQUIRED FLAGS Sets disks value. boot - Sets boot value. + Required, sets boot value. sizeGb - Required, sets sizeGb value. + Sets sizeGb value. sourceImage Sets sourceImage value. @@ -674,15 +654,6 @@ REQUIRED FLAGS machineType Sets machineType value. - serviceAccount - Sets serviceAccount value. - - email - Sets email value. - - scopes - Sets scopes value. - startupScript Sets startupScript value. @@ -701,14 +672,20 @@ REQUIRED FLAGS nodeSets Sets nodeSets value. - canIpForward - Sets canIpForward value. + bootDisk + Sets bootDisk value. - enableOsLogin - Sets enableOsLogin value. + boot + Required, sets boot value. - enablePublicIps - Sets enablePublicIps value. + sizeGb + Sets sizeGb value. + + sourceImage + Sets sourceImage value. + + type + Required, sets type value. id Sets id value. @@ -728,15 +705,6 @@ REQUIRED FLAGS resourceRequestId Sets resourceRequestId value. - serviceAccount - Sets serviceAccount value. - - email - Sets email value. - - scopes - Sets scopes value. - startupScript Sets startupScript value. @@ -764,106 +732,103 @@ REQUIRED FLAGS nodeSetIds Sets nodeSetIds value. - prologBashScripts - Sets prologBashScripts value. + storageResources + Sets storageResources value. - taskEpilogBashScripts - Sets taskEpilogBashScripts value. + KEY + Sets KEY value. - taskPrologBashScripts - Sets taskPrologBashScripts value. + VALUE + Sets VALUE value. - storages - Sets storages value. + config + Sets config value. - id - Sets id value. + existingBucket + Sets existingBucket value. - initializeParams - Sets initializeParams value. + bucket + Sets bucket value. - filestore - Sets filestore value. + existingFilestore + Sets existingFilestore value. - description - Sets description value. + filestore + Sets filestore value. - fileShares - Sets fileShares value. + existingLustre + Sets existingLustre value. + + lustre + Sets lustre value. + + newBucket + Sets newBucket value. + + autoclass + Sets autoclass value. + + enabled + Sets enabled value. + + bucket + Sets bucket value. + + hierarchicalNamespace + Sets hierarchicalNamespace value. + + enabled + Sets enabled value. + + storageClass + Sets storageClass value. + + newFilestore + Sets newFilestore value. + + description + Sets description value. + + fileShares + Sets fileShares value. + + capacityGb + Sets capacityGb value. + + fileShare + Sets fileShare value. + + filestore + Sets filestore value. + + protocol + Sets protocol value. + + tier + Sets tier value. + + newLustre + Sets newLustre value. capacityGb Sets capacityGb value. - fileShare - Sets fileShare value. + description + Sets description value. - filestore - Sets filestore value. + filesystem + Sets filesystem value. - protocol - Sets protocol value. - - tier - Sets tier value. - - gcs - Sets gcs value. - - autoclass - Sets autoclass value. - - enabled - Sets enabled value. - - terminalStorageClass - Sets terminalStorageClass value. - - bucket - Sets bucket value. - - hierarchicalNamespace - Sets hierarchicalNamespace value. - - enabled - Sets enabled value. - - storageClass - Sets storageClass value. - - lustre - Sets lustre value. - - capacityGb - Sets capacityGb value. - - description - Sets description value. - - filesystem - Sets filesystem value. - - lustre - Sets lustre value. - - storageSource - Sets storageSource value. - - bucket - Sets bucket value. - - filestore - Sets filestore value. - - lustre - Sets lustre value. + lustre + Sets lustre value. Shorthand Example: - --config=compute={resourceRequests=[{disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],guestAccelerators=[{acceleratorType=string,count=int}],id=string,machineType=string,maxRunDuration=int,provisioningModel=string,reservationAffinity={key=string,type=string,values},terminationAction=string,zone=string}]},description=string,labels={string=string},name=string,networks=[{initializeParams={description=string,network=string},networkSource={network=string,subnetwork=string}}],orchestrator={slurm={config={prologEpilogTimeout=string,prologFlags,requeueExitCodes,requeueHoldExitCodes},defaultPartition=string,epilogBashScripts,loginNodes={count=int,disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,serviceAccount={email=string,scopes},startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{canIpForward=boolean,enableOsLogin=boolean,enablePublicIps=boolean,id=string,labels={string=string},maxDynamicNodeCount=int,resourceRequestId=string,serviceAccount={email=string,scopes},startupScript=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}],prologBashScripts,taskEpilogBashScripts,taskPrologBashScripts}},storages=[{id=string,initializeParams={filestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},gcs={autoclass={enabled=boolean,terminalStorageClass=string},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},lustre={capacityGb=int,description=string,filesystem=string,lustre=string}},storageSource={bucket=string,filestore=string,lustre=string}}] + --config=computeResources={string={newDwsFlexInstances={machineType=string,maxDuration=string,zone=string},newOnDemandInstances={machineType=string,zone=string},newReservedInstances={machineType=string,reservation=string},newSpotInstances={machineType=string,zone=string}}},description=string,labels={string=string},name=string,networkResources={string={config={existingNetwork={network=string,subnetwork=string},newNetwork={description=string,network=string}}}},orchestrator={slurm={defaultPartition=string,loginNodes={count=int,disks=[{boot=boolean,sizeGb=int,sourceImage=string,type=string}],enableOsLogin=boolean,enablePublicIps=boolean,labels={string=string},machineType=string,startupScript=string,storageConfigs=[{id=string,localMount=string}],zone=string},nodeSets=[{bootDisk={boot=boolean,sizeGb=int,sourceImage=string,type=string},id=string,labels={string=string},maxDynamicNodeCount=int,resourceRequestId=string,startupScript=string,staticNodeCount=int,storageConfigs=[{id=string,localMount=string}]}],partitions=[{exclusive=boolean,id=string,nodeSetIds=[string]}]}},storageResources={string={config={existingBucket={bucket=string},existingFilestore={filestore=string},existingLustre={lustre=string},newBucket={autoclass={enabled=boolean},bucket=string,hierarchicalNamespace={enabled=boolean},storageClass=string},newFilestore={description=string,fileShares=[{capacityGb=int,fileShare=string}],filestore=string,protocol=string,tier=string},newLustre={capacityGb=int,description=string,filesystem=string,lustre=string}}}} JSON Example: - --config='{"compute": {"resourceRequests": [{"disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "guestAccelerators": [{"acceleratorType": "string", "count": int}], "id": "string", "machineType": "string", "maxRunDuration": int, "provisioningModel": "string", "reservationAffinity": {"key": "string", "type": "string", "values"}, "terminationAction": "string", "zone": "string"}]}, "description": "string", "labels": {"string": "string"}, "name": "string", "networks": [{"initializeParams": {"description": "string", "network": "string"}, "networkSource": {"network": "string", "subnetwork": "string"}}], "orchestrator": {"slurm": {"config": {"prologEpilogTimeout": "string", "prologFlags", "requeueExitCodes", "requeueHoldExitCodes"}, "defaultPartition": "string", "epilogBashScripts", "loginNodes": {"count": int, "disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"canIpForward": boolean, "enableOsLogin": boolean, "enablePublicIps": boolean, "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "resourceRequestId": "string", "serviceAccount": {"email": "string", "scopes"}, "startupScript": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}], "prologBashScripts", "taskEpilogBashScripts", "taskPrologBashScripts"}}, "storages": [{"id": "string", "initializeParams": {"filestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "gcs": {"autoclass": {"enabled": boolean, "terminalStorageClass": "string"}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "lustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}, "storageSource": {"bucket": "string", "filestore": "string", "lustre": "string"}}]}' + --config='{"computeResources": {"string": {"newDwsFlexInstances": {"machineType": "string", "maxDuration": "string", "zone": "string"}, "newOnDemandInstances": {"machineType": "string", "zone": "string"}, "newReservedInstances": {"machineType": "string", "reservation": "string"}, "newSpotInstances": {"machineType": "string", "zone": "string"}}}, "description": "string", "labels": {"string": "string"}, "name": "string", "networkResources": {"string": {"config": {"existingNetwork": {"network": "string", "subnetwork": "string"}, "newNetwork": {"description": "string", "network": "string"}}}}, "orchestrator": {"slurm": {"defaultPartition": "string", "loginNodes": {"count": int, "disks": [{"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}], "enableOsLogin": boolean, "enablePublicIps": boolean, "labels": {"string": "string"}, "machineType": "string", "startupScript": "string", "storageConfigs": [{"id": "string", "localMount": "string"}], "zone": "string"}, "nodeSets": [{"bootDisk": {"boot": boolean, "sizeGb": int, "sourceImage": "string", "type": "string"}, "id": "string", "labels": {"string": "string"}, "maxDynamicNodeCount": int, "resourceRequestId": "string", "startupScript": "string", "staticNodeCount": int, "storageConfigs": [{"id": "string", "localMount": "string"}]}], "partitions": [{"exclusive": boolean, "id": "string", "nodeSetIds": ["string"]}]}}, "storageResources": {"string": {"config": {"existingBucket": {"bucket": "string"}, "existingFilestore": {"filestore": "string"}, "existingLustre": {"lustre": "string"}, "newBucket": {"autoclass": {"enabled": boolean}, "bucket": "string", "hierarchicalNamespace": {"enabled": boolean}, "storageClass": "string"}, "newFilestore": {"description": "string", "fileShares": [{"capacityGb": int, "fileShare": "string"}], "filestore": "string", "protocol": "string", "tier": "string"}, "newLustre": {"capacityGb": int, "description": "string", "filesystem": "string", "lustre": "string"}}}}}' File Example: diff --git a/gcloud/alpha/compute/addresses/create b/gcloud/alpha/compute/addresses/create index 6ceaf23d9..e4019fbe5 100644 --- a/gcloud/alpha/compute/addresses/create +++ b/gcloud/alpha/compute/addresses/create @@ -4,8 +4,9 @@ NAME SYNOPSIS gcloud alpha compute addresses create [NAME ...] [--description=DESCRIPTION] [--endpoint-type=ENDPOINT_TYPE] - [--network=NETWORK] [--network-tier=NETWORK_TIER] - [--prefix-length=PREFIX_LENGTH] [--purpose=PURPOSE] [--subnet=SUBNET] + [--ip-collection=IP_COLLECTION] [--network=NETWORK] + [--network-tier=NETWORK_TIER] [--prefix-length=PREFIX_LENGTH] + [--purpose=PURPOSE] [--subnet=SUBNET] [--addresses=ADDRESS,[ADDRESS,...] | --ip-version=IP_VERSION] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] @@ -76,6 +77,12 @@ FLAGS The endpoint type of the external IPv6 address to be reserved. ENDPOINT_TYPE must be one of: VM, NETLB. + --ip-collection=IP_COLLECTION + If specified, the public delegated prefix (PDP) from which to allocate + the BYOIP IP address. The PDP must support enhanced IPv4 allocations. + If not specified, the address will be allocated from the Google-owned + IP pool. + --network=NETWORK If specified, the network resource in which the address(es) should be reserved. diff --git a/gcloud/alpha/compute/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index 4377ab76c..471851eb2 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -787,6 +787,10 @@ FLAGS Specifies the network attachment that this interface should connect to. Mutually exclusive with --network and --subnet flags. + enable-vpc-scoped-dns + If specified with network_attachment, DNS resolution will be + enabled over this interface. + vlan VLAN tag of a dynamic network interface, must be an integer in the range from 2 to 255 inclusively. diff --git a/gcloud/alpha/compute/instance-templates/create-with-container b/gcloud/alpha/compute/instance-templates/create-with-container index 91d176d81..e7afb6e8b 100644 --- a/gcloud/alpha/compute/instance-templates/create-with-container +++ b/gcloud/alpha/compute/instance-templates/create-with-container @@ -63,10 +63,15 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha compute instance-templates create-with-container - creates a Compute Engine virtual machine instance template that runs a - container image. To create an instance template named 'instance-template-1' - that runs the 'busybox' image, run: + (ALPHA) (DEPRECATED) The option to deploy a container during VM creation + using the container startup agent is deprecated. Use alternative services + to run containers on your VMs. Learn more at + https://cloud.google.com/compute/docs/containers/migrate-containers. + + gcloud alpha compute instance-templates create-with-container creates a + Compute Engine virtual machine instance template that runs a container + image. To create an instance template named 'instance-template-1' that runs + the 'busybox' image, run: $ gcloud alpha compute instance-templates create-with-container \ instance-template-1 \ diff --git a/gcloud/alpha/compute/instance-templates/help b/gcloud/alpha/compute/instance-templates/help index f6e43ae52..7bf4872b8 100644 --- a/gcloud/alpha/compute/instance-templates/help +++ b/gcloud/alpha/compute/instance-templates/help @@ -30,8 +30,8 @@ COMMANDS (ALPHA) Create a Compute Engine virtual machine instance template. create-with-container - (ALPHA) Creates a Compute Engine a virtual machine instance template - that runs a Docker container. + (ALPHA) (DEPRECATED) Creates a Compute Engine a virtual machine + instance template that runs a Docker container. delete (ALPHA) Delete Compute Engine virtual machine instance templates. diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 170529c2c..4084bff75 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -1460,6 +1460,10 @@ FLAGS Specifies the network attachment that this interface should connect to. Mutually exclusive with --network and --subnet flags. + enable-vpc-scoped-dns + If specified with network_attachment, DNS resolution will be + enabled over this interface. + vlan VLAN tag of a dynamic network interface, must be an integer in the range from 2 to 255 inclusively. diff --git a/gcloud/alpha/compute/instances/create-with-container b/gcloud/alpha/compute/instances/create-with-container index e9c1a8ae9..89e69fb16 100644 --- a/gcloud/alpha/compute/instances/create-with-container +++ b/gcloud/alpha/compute/instances/create-with-container @@ -82,8 +82,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha compute instances create-with-container creates - Compute Engine virtual machines that runs a Docker image. For example: + (ALPHA) (DEPRECATED) The option to deploy a container during VM creation + using the container startup agent is deprecated. Use alternative services + to run containers on your VMs. Learn more at + https://cloud.google.com/compute/docs/containers/migrate-containers. + + gcloud alpha compute instances create-with-container creates Compute Engine + virtual machines that runs a Docker image. For example: $ gcloud alpha compute instances create-with-container instance-1 \ --zone us-central1-a \ diff --git a/gcloud/alpha/compute/instances/help b/gcloud/alpha/compute/instances/help index d8a6ebd3c..987776a4c 100644 --- a/gcloud/alpha/compute/instances/help +++ b/gcloud/alpha/compute/instances/help @@ -74,8 +74,8 @@ COMMANDS (ALPHA) Create Compute Engine virtual machine instances. create-with-container - (ALPHA) Creates Compute Engine virtual machine instances running - container images. + (ALPHA) (DEPRECATED) Creates Compute Engine virtual machine instances + running container images. delete (ALPHA) Delete Compute Engine virtual machine instances. @@ -200,8 +200,8 @@ COMMANDS (ALPHA) Update a Compute Engine virtual machine access configuration. update-container - (ALPHA) Updates Compute Engine virtual machine instances running - container images. + (ALPHA) (DEPRECATED) Updates Compute Engine virtual machine instances + running container images. update-from-file (ALPHA) Update a Compute Engine virtual machine instance using a diff --git a/gcloud/alpha/compute/instances/update-container b/gcloud/alpha/compute/instances/update-container index a14d050ca..c33e8b331 100644 --- a/gcloud/alpha/compute/instances/update-container +++ b/gcloud/alpha/compute/instances/update-container @@ -24,8 +24,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) gcloud alpha compute instances update-container updates Compute - Engine virtual machines that runs a Docker image. For example: + (ALPHA) (DEPRECATED) The option to deploy a container during VM creation + using the container startup agent is deprecated. Use alternative services + to run containers on your VMs. Learn more at + https://cloud.google.com/compute/docs/containers/migrate-containers. + + gcloud alpha compute instances update-container updates Compute Engine + virtual machines that runs a Docker image. For example: $ gcloud alpha compute instances update-container instance-1 \ --zone us-central1-a \ diff --git a/gcloud/alpha/compute/interconnects/wire-groups/create b/gcloud/alpha/compute/interconnects/wire-groups/create index f182ba7ba..e7e2d8d87 100644 --- a/gcloud/alpha/compute/interconnects/wire-groups/create +++ b/gcloud/alpha/compute/interconnects/wire-groups/create @@ -4,9 +4,9 @@ NAME SYNOPSIS gcloud alpha compute interconnects wire-groups create NAME + --bandwidth-allocation=BANDWIDTH_ALLOCATION --bandwidth-unmetered=BANDWIDTH_UNMETERED --cross-site-network=CROSS_SITE_NETWORK [--admin-enabled] - [--bandwidth-allocation=BANDWIDTH_ALLOCATION] [--bandwidth-metered=BANDWIDTH_METERED] [--description=DESCRIPTION] [--fault-response=FAULT_RESPONSE] [--network-service-class=NETWORK_SERVICE_CLASS] [--type=TYPE] @@ -33,19 +33,6 @@ POSITIONAL ARGUMENTS Name of the wire group to create. REQUIRED FLAGS - --bandwidth-unmetered=BANDWIDTH_UNMETERED - The amount of unmetered bandwidth to assign to the wire group. - - --cross-site-network=CROSS_SITE_NETWORK - Name of the crossSiteNetwork to operate on. - -OPTIONAL FLAGS - --admin-enabled - Administrative status of the wire group. If not provided on creation, - defaults to enabled. When this is enabled, the wire group is - operational and will carry traffic. Use --no-admin-enabled to disable - it. - --bandwidth-allocation=BANDWIDTH_ALLOCATION The bandwidth allocation for the wire group. BANDWIDTH_ALLOCATION must be one of: @@ -58,9 +45,20 @@ OPTIONAL FLAGS The unmetered bandwidth is divided equally across each wire in the group, but dynamic throttling reallocates unused unmetered bandwidth from unused or underused wires to other wires in the - group. For example, with a four-wire box-and-cross group, when one - Interconnect connection is down, the unmetered bandwidth of the two - down wires is reallocated to the remaining up wires. + group. + + --bandwidth-unmetered=BANDWIDTH_UNMETERED + The amount of unmetered bandwidth to assign to the wire group. + + --cross-site-network=CROSS_SITE_NETWORK + Name of the crossSiteNetwork to operate on. + +OPTIONAL FLAGS + --admin-enabled + Administrative status of the wire group. If not provided on creation, + defaults to enabled. When this is enabled, the wire group is + operational and will carry traffic. Use --no-admin-enabled to disable + it. --bandwidth-metered=BANDWIDTH_METERED The amount of metered bandwidth to assign to the wire group. diff --git a/gcloud/alpha/compute/interconnects/wire-groups/update b/gcloud/alpha/compute/interconnects/wire-groups/update index 44ff3cd49..4b73a40be 100644 --- a/gcloud/alpha/compute/interconnects/wire-groups/update +++ b/gcloud/alpha/compute/interconnects/wire-groups/update @@ -42,9 +42,7 @@ OPTIONAL FLAGS The unmetered bandwidth is divided equally across each wire in the group, but dynamic throttling reallocates unused unmetered bandwidth from unused or underused wires to other wires in the - group. For example, with a four-wire box-and-cross group, when one - Interconnect connection is down, the unmetered bandwidth of the two - down wires is reallocated to the remaining up wires. + group. --bandwidth-metered=BANDWIDTH_METERED The amount of metered bandwidth to assign to the wire group. diff --git a/gcloud/alpha/compute/network-firewall-policies/create b/gcloud/alpha/compute/network-firewall-policies/create index ff372b890..2a0d1c490 100644 --- a/gcloud/alpha/compute/network-firewall-policies/create +++ b/gcloud/alpha/compute/network-firewall-policies/create @@ -35,7 +35,7 @@ FLAGS --policy-type=POLICY_TYPE Network firewall policy type. POLICY_TYPE must be one of: VPC_POLICY, - RDMA_ROCE_POLICY. + RDMA_ROCE_POLICY, ULL_POLICY. At most one of these can be specified: diff --git a/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/create b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/create index df54ffd84..e2471852c 100644 --- a/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/create +++ b/gcloud/alpha/design-center/spaces/catalogs/templates/revisions/create @@ -6,10 +6,8 @@ SYNOPSIS gcloud alpha design-center spaces catalogs templates revisions create (REVISION : --catalog=CATALOG --location=LOCATION --space=SPACE --template=TEMPLATE) - --developer-connect-repo=DEVELOPER_CONNECT_REPO - --developer-connect-repo-dir=DEVELOPER_CONNECT_REPO_DIR - --developer-connect-repo-ref=DEVELOPER_CONNECT_REPO_REF [--async] - [--description=DESCRIPTION] [--metadata=METADATA] + (--application-template-revision-source=APPLICATION_TEMPLATE_REVISION_SOURCE | --gcs-source-uri=GCS_SOURCE_URI | --developer-connect-repo=DEVELOPER_CONNECT_REPO --developer-connect-repo-dir=DEVELOPER_CONNECT_REPO_DIR --developer-connect-repo-ref=DEVELOPER_CONNECT_REPO_REF | [--git-source-ref-tag=GIT_SOURCE_REF_TAG --git-source-repo=GIT_SOURCE_REPO : --git-source-dir=GIT_SOURCE_DIR] | [--oci-repo-uri=OCI_REPO_URI : --oci-repo-version=OCI_REPO_VERSION]) + [--async] [--description=DESCRIPTION] [--metadata=METADATA] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -53,6 +51,49 @@ EXAMPLES --developer-connect-repo-dir=modules/my-product \ --metadata=/path/to/metadata.yaml + To create a revision using a Git repository as the source, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + create my-revision --project=my-project --location=us-central1 \ + --space=my-space --catalog=my-catalog --template=my-template \ + --git-source-repo=GoogleCloudPlatform/\ + terraform-google-cloud-run --git-source-ref-tag=v1.0.0 \ + --git-source-dir=modules/my-product + + To create a revision using a Google Cloud Storage URI as the source, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + create my-revision --project=my-project --location=us-central1 \ + --space=my-space --catalog=my-catalog --template=my-template \ + --gcs-source-uri=gs://my-bucket/my-template + + To create a revision using an OCI repository as the source, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + create my-revision --project=my-project --location=us-central1 \ + --space=my-space --catalog=my-catalog --template=my-template \ + --oci-repo-uri=oci://us-west1-docker.pkg.dev/my-project/\ + my-repo/my-chart --oci-repo-version=1.0.0 + + To create a revision using an Application Template Revision as the source, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + create my-revision --project=my-project --location=us-central1 \ + --space=my-space --catalog=my-catalog --template=my-template \ + --application-template-revision-source=projects/my-project/\ + locations/us-central1/spaces/my-space/applicationTemplates/\ + my-app-template/revisions/a1 + + To create a revision using Git source and a metadata file from a local path, run: + + $ gcloud alpha design-center spaces catalogs templates revisions \ + create my-revision --project=my-project --location=us-central1 \ + --space=my-space --catalog=my-catalog --template=my-template \ + --git-source-repo=GoogleCloudPlatform/\ + terraform-google-cloud-run --git-source-ref-tag=v1.0.0 \ + --git-source-dir=modules/my-product \ + --metadata=/path/to/metadata.yaml + POSITIONAL ARGUMENTS Revision resource - The revision to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some @@ -109,18 +150,71 @@ POSITIONAL ARGUMENTS ▸ provide the argument --template on the command line. REQUIRED FLAGS - --developer-connect-repo=DEVELOPER_CONNECT_REPO - The Developer Connect repository to use as a source. Example: - projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo + Exactly one of these must be specified: - --developer-connect-repo-dir=DEVELOPER_CONNECT_REPO_DIR - The directory within the repository to use. Example: - "modules/my-product" + --application-template-revision-source=APPLICATION_TEMPLATE_REVISION_SOURCE + Application template revision to use as source. Example: + projects/my-project/locations/us-central1/spaces/my-space/catalogs/my-catalog/templates/my-template/revisions/r1 - --developer-connect-repo-ref=DEVELOPER_CONNECT_REPO_REF - The Git ref (branch or tag) within the repository to use. Example: - "refs/tags/v1.0.0" or "refs/heads/main" or - "refs/commits/269b518b99d06b31ff938a2d182e75f5e41941c7". + --gcs-source-uri=GCS_SOURCE_URI + Google Cloud Storage URI for source. Example: + gs://my-bucket/my-template. + + Flags for Developer Connect source. + + --developer-connect-repo=DEVELOPER_CONNECT_REPO + The Developer Connect repository to use as a source. Example: + projects/my-project/locations/us-central1/connections/my-connection/gitRepositoryLinks/my-repo + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --developer-connect-repo-dir=DEVELOPER_CONNECT_REPO_DIR + The directory within the repository to use. Example: + "modules/my-product" + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --developer-connect-repo-ref=DEVELOPER_CONNECT_REPO_REF + The Git ref (branch or tag) within the repository to use. Example: + "refs/tags/v1.0.0" or "refs/heads/main" or + "refs/commits/269b518b99d06b31ff938a2d182e75f5e41941c7". + + This flag argument must be specified if any of the other arguments + in this group are specified. + + Flags for Git source. + + --git-source-ref-tag=GIT_SOURCE_REF_TAG + Git reference tag for Git source. Example: "v1.0.0" + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --git-source-repo=GIT_SOURCE_REPO + Git repository for Git source. Example: + GoogleCloudPlatform/terraform-google-cloud-run + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --git-source-dir=GIT_SOURCE_DIR + Git directory for Git source. Example: "modules/my-product". This + field is optional. + + Flags for OCI Repo source. + + --oci-repo-uri=OCI_REPO_URI + OCI Repo URI for OCI Repo source. Example: + oci://us-west1-docker.pkg.dev/my-project/my-repo/my-chart + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --oci-repo-version=OCI_REPO_VERSION + OCI Repo version for OCI Repo source. Example: "1.0.0". This field + is optional. OPTIONAL FLAGS --async @@ -131,7 +225,8 @@ OPTIONAL FLAGS A description for the revision. --metadata=METADATA - Path to a local YAML file containing the template metadata. + Path to a local YAML file containing the template metadata. Example: + "path/to/metadata.yaml". GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/iam/workforce-pools/providers/scim-tenants/delete b/gcloud/alpha/iam/workforce-pools/providers/scim-tenants/delete index d31bba282..7277f4832 100644 --- a/gcloud/alpha/iam/workforce-pools/providers/scim-tenants/delete +++ b/gcloud/alpha/iam/workforce-pools/providers/scim-tenants/delete @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha iam workforce-pools providers scim-tenants delete (SCIM_TENANT : --location=LOCATION - --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) [--hard-delete] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -70,6 +70,12 @@ POSITIONAL ARGUMENTS specified name; ▸ provide the argument --workforce-pool on the command line. +FLAGS + --hard-delete + If set, hard delete the scim tenant. This will delete the scim tenant + resources i.e. the scim tenant project and service account associated + with it. This action cannot be undone. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/iam/workload-identity-pools/create-cred-config b/gcloud/alpha/iam/workload-identity-pools/create-cred-config index 7f0c494c0..7094d1ef3 100644 --- a/gcloud/alpha/iam/workload-identity-pools/create-cred-config +++ b/gcloud/alpha/iam/workload-identity-pools/create-cred-config @@ -12,7 +12,7 @@ SYNOPSIS [--credential-source-field-name=CREDENTIAL_SOURCE_FIELD_NAME] [--credential-source-headers=[key=value,...]] [--credential-source-type=CREDENTIAL_SOURCE_TYPE] [--enable-imdsv2] - [--subject-token-type=SUBJECT_TOKEN_TYPE] + [--sts-location=STS_LOCATION] [--subject-token-type=SUBJECT_TOKEN_TYPE] [--credential-cert-private-key-path=CREDENTIAL_CERT_PRIVATE_KEY_PATH : --credential-cert-configuration-output-file=CREDENTIAL_CERT_CONFIGURATION_OUTPUT_FILE --credential-cert-trust-chain-path=CREDENTIAL_CERT_TRUST_CHAIN_PATH] [--executable-output-file=EXECUTABLE_OUTPUT_FILE @@ -135,6 +135,12 @@ OPTIONAL FLAGS Adds the AWS IMDSv2 session token Url to the credential source to enforce the AWS IMDSv2 flow. + --sts-location=STS_LOCATION + The location to use for the Security Token Service token endpoint. For + example, specifying us-central1 will configure the client to use the + regional endpoint sts.us-central1.rep.googleapis.com. If not specified, + the global endpoint sts.googleapis.com is used. + --subject-token-type=SUBJECT_TOKEN_TYPE The type of token being used for authorization. This defaults to urn:ietf:params:oauth:token-type:jwt. diff --git a/gcloud/alpha/lustre/instances/create b/gcloud/alpha/lustre/instances/create index b8ae5a01e..bd9c7bd1f 100644 --- a/gcloud/alpha/lustre/instances/create +++ b/gcloud/alpha/lustre/instances/create @@ -55,7 +55,11 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --capacity-gib=CAPACITY_GIB The storage capacity of the instance in gibibytes (GiB). Allowed values - are from 18000 to 954000, in increments of 9000. + are from 18000 to 7632000, depending on the perUnitStorageThroughput. + See Performance tiers and maximum storage capacities + (https://cloud.google.com/managed-lustre/docs/create-instance#performance-tiers) + for specific minimums, maximums, and step sizes for each performance + tier. --filesystem=FILESYSTEM The filesystem name for this instance. This name is used by client-side @@ -84,7 +88,9 @@ REQUIRED FLAGS --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT The throughput of the instance in MB/s/TiB. Valid values are 125, 250, - 500, 1000. + 500, 1000. See Performance tiers and maximum storage capacities + (https://cloud.google.com/managed-lustre/docs/create-instance#performance-tiers) + for more information. OPTIONAL FLAGS --async diff --git a/gcloud/alpha/lustre/instances/update b/gcloud/alpha/lustre/instances/update index 5b2762da4..e36636ed1 100644 --- a/gcloud/alpha/lustre/instances/update +++ b/gcloud/alpha/lustre/instances/update @@ -60,7 +60,11 @@ FLAGS --capacity-gib=CAPACITY_GIB The storage capacity of the instance in gibibytes (GiB). Allowed values - are from 18000 to 954000, in increments of 9000. + are from 18000 to 7632000, depending on the perUnitStorageThroughput. + See Performance tiers and maximum storage capacities + (https://cloud.google.com/managed-lustre/docs/create-instance#performance-tiers) + for specific minimums, maximums, and step sizes for each performance + tier. --description=DESCRIPTION A user-readable description of the instance. @@ -73,7 +77,9 @@ FLAGS --per-unit-storage-throughput=PER_UNIT_STORAGE_THROUGHPUT The throughput of the instance in MB/s/TiB. Valid values are 125, 250, - 500, 1000. + 500, 1000. See Performance tiers and maximum storage capacities + (https://cloud.google.com/managed-lustre/docs/create-instance#performance-tiers) + for more information. --request-id=REQUEST_ID An optional request ID to identify requests. Specify a unique request diff --git a/gcloud/alpha/netapp/volumes/restore-backup-files b/gcloud/alpha/netapp/volumes/restore-backup-files index 3e2d243e2..deeb64bdb 100644 --- a/gcloud/alpha/netapp/volumes/restore-backup-files +++ b/gcloud/alpha/netapp/volumes/restore-backup-files @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud alpha netapp volumes restore-backup-files (VOLUME : --location=LOCATION) --file-list=FILE_LIST,[FILE_LIST,...] - --restore-destination-path=RESTORE_DESTINATION_PATH (--backup=BACKUP : --backup_vault=BACKUP_VAULT) [--async] + [--restore-destination-path=RESTORE_DESTINATION_PATH] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -59,9 +59,6 @@ REQUIRED FLAGS List of files to be restored in the form of their absolute path as in source volume. - --restore-destination-path=RESTORE_DESTINATION_PATH - Name of the absolute directory path in the destination volume.. - Backup resource - The Backup from which files are restored back to the Volume. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this @@ -103,6 +100,9 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --restore-destination-path=RESTORE_DESTINATION_PATH + Name of the absolute directory path in the destination volume.. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, @@ -115,7 +115,9 @@ 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. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud netapp volumes restore-backup-files $ gcloud beta netapp volumes restore-backup-files diff --git a/gcloud/alpha/network-security/mirroring-endpoint-groups/create b/gcloud/alpha/network-security/mirroring-endpoint-groups/create index d09af42c5..5e1fe6fe5 100644 --- a/gcloud/alpha/network-security/mirroring-endpoint-groups/create +++ b/gcloud/alpha/network-security/mirroring-endpoint-groups/create @@ -8,7 +8,8 @@ SYNOPSIS (--mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP : --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION) [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + [--max-wait=MAX_WAIT; default="20m"] [--type=TYPE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a mirroring endpoint group. Successful creation of an @@ -140,6 +141,10 @@ OPTIONAL FLAGS specified. See $ gcloud topic datetimes for information on time formats. + --type=TYPE + The type of the endpoint group. If not specified, the default type is + DIRECT. TYPE must be one of: DIRECT, BROKER. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-security/security-profiles/custom-mirroring/create b/gcloud/alpha/network-security/security-profiles/custom-mirroring/create index fe26b70b2..4860de630 100644 --- a/gcloud/alpha/network-security/security-profiles/custom-mirroring/create +++ b/gcloud/alpha/network-security/security-profiles/custom-mirroring/create @@ -8,6 +8,7 @@ SYNOPSIS (--mirroring-endpoint-group=MIRRORING_ENDPOINT_GROUP : --mirroring-endpoint-group-location=MIRRORING_ENDPOINT_GROUP_LOCATION) [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--mirroring-deployment-groups=[MIRRORING_DEPLOYMENT_GROUPS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -108,6 +109,10 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --mirroring-deployment-groups=[MIRRORING_DEPLOYMENT_GROUPS,...] + List of comma-separated full names of mirroring-deployment-group + resources. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-security/security-profiles/describe b/gcloud/alpha/network-security/security-profiles/describe index 01033500a..6ad83b2ea 100644 --- a/gcloud/alpha/network-security/security-profiles/describe +++ b/gcloud/alpha/network-security/security-profiles/describe @@ -66,5 +66,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles describe diff --git a/gcloud/alpha/network-security/security-profiles/export b/gcloud/alpha/network-security/security-profiles/export index f704bb47d..5180f4860 100644 --- a/gcloud/alpha/network-security/security-profiles/export +++ b/gcloud/alpha/network-security/security-profiles/export @@ -75,5 +75,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles export diff --git a/gcloud/alpha/network-security/security-profiles/help b/gcloud/alpha/network-security/security-profiles/help index 199a397ec..38fc60821 100644 --- a/gcloud/alpha/network-security/security-profiles/help +++ b/gcloud/alpha/network-security/security-profiles/help @@ -26,6 +26,9 @@ GROUPS threat-prevention (ALPHA) Manage Security Profiles - Threat Prevention Profile. + url-filtering + (ALPHA) Manage Security Profiles - Url Filtering Profile. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/alpha/network-security/security-profiles/import b/gcloud/alpha/network-security/security-profiles/import index 86f08fd37..a45bbc1e2 100644 --- a/gcloud/alpha/network-security/security-profiles/import +++ b/gcloud/alpha/network-security/security-profiles/import @@ -82,5 +82,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles import diff --git a/gcloud/alpha/network-security/security-profiles/list b/gcloud/alpha/network-security/security-profiles/list index 4b6f5503e..65c3df546 100644 --- a/gcloud/alpha/network-security/security-profiles/list +++ b/gcloud/alpha/network-security/security-profiles/list @@ -89,5 +89,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud beta network-security security-profiles list diff --git a/gcloud/alpha/network-security/security-profiles/url-filtering/create b/gcloud/alpha/network-security/security-profiles/url-filtering/create new file mode 100644 index 000000000..e1ffb2aa3 --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/url-filtering/create @@ -0,0 +1,85 @@ +NAME + gcloud alpha network-security security-profiles url-filtering create - + create a new URL Filtering Profile + +SYNOPSIS + gcloud alpha network-security security-profiles url-filtering create + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new URL Filtering Security Profile. + +EXAMPLES + To create a URL Filtering Security Profile named my-urlf-security-profile + with an optional description as New URLF Security Profile, run: + + $ gcloud alpha network-security security-profiles url-filtering \ + create my-urlf-security-profile \ + --description="New URLF Security Profile" + +POSITIONAL ARGUMENTS + Security profile resource - Security Profile Name. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + location of the security_profile - Global. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + Organization ID to which the changes should apply. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --description=DESCRIPTION + Brief description of the security profile + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +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. This variant is also available: + + $ gcloud beta network-security security-profiles url-filtering create + diff --git a/gcloud/alpha/network-security/security-profiles/url-filtering/delete b/gcloud/alpha/network-security/security-profiles/url-filtering/delete new file mode 100644 index 000000000..1998f269f --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/url-filtering/delete @@ -0,0 +1,77 @@ +NAME + gcloud alpha network-security security-profiles url-filtering delete - + delete a Security Profile + +SYNOPSIS + gcloud alpha network-security security-profiles url-filtering delete + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete the specified Security Profile. + +EXAMPLES + To delete a Security Profile called my-security-profile run: + + $ gcloud alpha network-security security-profiles url-filtering \ + delete my-security-profile + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile you want to + delete. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 networksecurity/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +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. This variant is also available: + + $ gcloud beta network-security security-profiles url-filtering delete + diff --git a/gcloud/alpha/network-security/security-profiles/url-filtering/describe b/gcloud/alpha/network-security/security-profiles/url-filtering/describe new file mode 100644 index 000000000..cfe2d0be9 --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/url-filtering/describe @@ -0,0 +1,73 @@ +NAME + gcloud alpha network-security security-profiles url-filtering describe - + describe a URL Filtering Security Profile + +SYNOPSIS + gcloud alpha network-security security-profiles url-filtering describe + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of the Security Profile. + +EXAMPLES + To show details of a Security Profile named my-urlf-sp run: + + $ gcloud alpha network-security security-profiles url-filtering \ + describe my-urlf-sp --organization=1234 --location=global + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile to be described. + The arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +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 networksecurity/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +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. This variant is also available: + + $ gcloud beta network-security security-profiles url-filtering \ + describe + diff --git a/gcloud/alpha/network-security/security-profiles/url-filtering/help b/gcloud/alpha/network-security/security-profiles/url-filtering/help new file mode 100644 index 000000000..4d7c40643 --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/url-filtering/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha network-security security-profiles url-filtering - manage + Security Profiles - Url Filtering Profile + +SYNOPSIS + gcloud alpha network-security security-profiles url-filtering COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Security Profiles - Url Filtering Profile. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a new URL Filtering Profile. + + delete + (ALPHA) Delete a Security Profile. + + describe + (ALPHA) Describe a URL Filtering Security Profile. + + list + (ALPHA) List URL Filtering Security Profiles. + +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. This variant is also available: + + $ gcloud beta network-security security-profiles url-filtering + diff --git a/gcloud/alpha/network-security/security-profiles/url-filtering/list b/gcloud/alpha/network-security/security-profiles/url-filtering/list new file mode 100644 index 000000000..f33c6066a --- /dev/null +++ b/gcloud/alpha/network-security/security-profiles/url-filtering/list @@ -0,0 +1,91 @@ +NAME + gcloud alpha network-security security-profiles url-filtering list - list + URL Filtering Security Profiles + +SYNOPSIS + gcloud alpha network-security security-profiles url-filtering list + (--location=LOCATION : --organization=ORGANIZATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List URL Filtering Security Profiles. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list URL Filtering security profiles in an organization, run: + + $ gcloud alpha network-security security-profiles url-filtering \ list --organization=12345 --location=global + +REQUIRED FLAGS + Location resource - Parent resource for the list operation. The arguments + in this group can be used to specify the attributes of this resource. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --organization=ORGANIZATION + Organization ID of the location. + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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. This variant is also available: + + $ gcloud beta network-security security-profiles url-filtering list + diff --git a/gcloud/alpha/pam/grants/create b/gcloud/alpha/pam/grants/create index ff3542926..2fd85d85b 100644 --- a/gcloud/alpha/pam/grants/create +++ b/gcloud/alpha/pam/grants/create @@ -7,7 +7,10 @@ SYNOPSIS (--entitlement=ENTITLEMENT : --folder=FOLDER --location=LOCATION --organization=ORGANIZATION) [--additional-email-recipients=[ADDITIONAL_EMAIL_RECIPIENTS,...]] - [--justification=JUSTIFICATION] [GCLOUD_WIDE_FLAG ...] + [--justification=JUSTIFICATION] + [--requested-access-from-file=[REQUESTED_ACCESS_FROM_FILE,...] + | --requested-resources=[REQUESTED_RESOURCES,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a new Privileged Access Manager (PAM) grant under an @@ -91,6 +94,20 @@ OPTIONAL FLAGS --justification=JUSTIFICATION Justification for the grant. + Specify the grant's scope using either high-level resource or a + fine-grained scope configuration. + + At most one of these can be specified: + + --requested-access-from-file=[REQUESTED_ACCESS_FROM_FILE,...] + Path to a YAML file defining the fine-grained scope for the grant. + + --requested-resources=[REQUESTED_RESOURCES,...] + The Google Cloud resources to be granted access to. Format: + {resource-type}/{resource_id}. Example: projects/{project_id} or + folders/{folder_id} or organizations/{organization_id}. This command + currently accepts only one resource. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/pam/grants/help b/gcloud/alpha/pam/grants/help index a45444c7a..e6ab5587e 100644 --- a/gcloud/alpha/pam/grants/help +++ b/gcloud/alpha/pam/grants/help @@ -63,6 +63,10 @@ EXAMPLES $ gcloud alpha pam grants search --entitlement=ENTITLEMENT_NAME \ --caller-relationship=can-approve + To withdraw a grant with the full name GRANT_NAME, run: + + $ gcloud alpha pam grants withdraw GRANT_NAME + GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -94,6 +98,9 @@ COMMANDS (ALPHA) Search for and list all Privileged Access Manager (PAM) grants you have created, have approved, or can approve. + withdraw + (ALPHA) Withdraw a Privileged Access Manager (PAM) grant. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/pam/grants/withdraw b/gcloud/alpha/pam/grants/withdraw new file mode 100644 index 000000000..091df0820 --- /dev/null +++ b/gcloud/alpha/pam/grants/withdraw @@ -0,0 +1,100 @@ +NAME + gcloud alpha pam grants withdraw - withdraw a Privileged Access Manager + grant + +SYNOPSIS + gcloud alpha pam grants withdraw + (GRANT : --entitlement=ENTITLEMENT + --folder=FOLDER --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Withdraw a Privileged Access Manager (PAM) grant. + +EXAMPLES + The following command withdraws a grant with the full name GRANT_NAME: + + $ gcloud alpha pam grants withdraw GRANT_NAME + +POSITIONAL ARGUMENTS + Grant resource - Name of the grant to withdraw. The arguments in this + group can be used to specify the attributes of this 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 grant on the command line with a fully specified + name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This resource can be one of the + following types: + [privilegedaccessmanager.projects.locations.entitlements.grants, + privilegedaccessmanager.folders.locations.entitlements.grants, + privilegedaccessmanager.organizations.locations.entitlements.grants]. + + This must be specified. + + GRANT + ID of the grant or fully qualified identifier for the grant. + + To set the grant attribute: + ▸ provide the argument grant on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --entitlement=ENTITLEMENT + The entitlement id + + To set the entitlement attribute: + ▸ provide the argument grant on the command line with a fully + specified name; + ▸ provide the argument --entitlement on the command line. + + --folder=FOLDER + The name of the folder + + To set the folder attribute: + ▸ provide the argument grant on the command line with a fully + specified name; + ▸ provide the argument --folder on the command line. Must be + specified for resource of type + [privilegedaccessmanager.folders.locations.entitlements.grants]. + + --location=LOCATION + The resource location + + To set the location attribute: + ▸ provide the argument grant on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + The name of the organization + + To set the organization attribute: + ▸ provide the argument grant on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. Must be + specified for resource of type + [privilegedaccessmanager.organizations.locations.entitlements.grants]. + +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 privilegedaccessmanager/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview + +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. + diff --git a/gcloud/alpha/pam/help b/gcloud/alpha/pam/help index 735e3c8d0..36cf13af3 100644 --- a/gcloud/alpha/pam/help +++ b/gcloud/alpha/pam/help @@ -44,6 +44,9 @@ GROUPS operations (ALPHA) Manage Privileged Access Manager (PAM) Long Running Operations. + settings + (ALPHA) Manage Privileged Access Manager (PAM) Settings. + COMMANDS COMMAND is one of the following: diff --git a/gcloud/alpha/pam/settings/describe b/gcloud/alpha/pam/settings/describe new file mode 100644 index 000000000..94c745e68 --- /dev/null +++ b/gcloud/alpha/pam/settings/describe @@ -0,0 +1,97 @@ +NAME + gcloud alpha pam settings describe - show details of Privileged Access + Manager settings on a resource + +SYNOPSIS + gcloud alpha pam settings describe + (--location=LOCATION : --folder=FOLDER --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show details of Privileged Access Manager (PAM) settings on a + resource. + +EXAMPLES + The following command describes settings on a project named sample-project, + and in location global: + + $ gcloud alpha pam settings describe --project=sample-project \ + --location=global + + The following command describes settings on a folder with ID FOLDER_ID, and + in location global: + + $ gcloud alpha pam settings describe --folder=FOLDER_ID \ + --location=global + + The following command describes settings on an organization with ID + ORGANIZATION_ID, and in location global: + + $ gcloud alpha pam settings describe \ + --organization=ORGANIZATION_ID --location=global + +REQUIRED FLAGS + Location resource - The project/organization/folder location for which the + settings are to be described. The arguments in this group can be used to + specify the attributes of this 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This resource can be one of the + following types: [privilegedaccessmanager.projects.locations, + privilegedaccessmanager.folders.locations, + privilegedaccessmanager.organizations.locations]. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --folder=FOLDER + The name of the folder + + To set the folder attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --folder on the command line. Must be + specified for resource of type + [privilegedaccessmanager.folders.locations]. + + --organization=ORGANIZATION + The name of the organization + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. Must be + specified for resource of type + [privilegedaccessmanager.organizations.locations]. + +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 privilegedaccessmanager/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview + +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. + diff --git a/gcloud/alpha/pam/settings/describe-effective b/gcloud/alpha/pam/settings/describe-effective new file mode 100644 index 000000000..9f7d25eaa --- /dev/null +++ b/gcloud/alpha/pam/settings/describe-effective @@ -0,0 +1,101 @@ +NAME + gcloud alpha pam settings describe-effective - show effective Privileged + Access Manager settings on a resource + +SYNOPSIS + gcloud alpha pam settings describe-effective + (--location=LOCATION : --folder=FOLDER --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Show effective Privileged Access Manager (PAM) settings on a + resource. The "effective value" of a setting on a given resource refers to + the final or active value of a setting configuration that is applied to a + resource. For each configuration type field in settings resource, a + hierarchy evaluation will happen to calculate effective value on the + resource node. + +EXAMPLES + The following command describes effective settings on a project named + sample-project, and in location global: + + $ gcloud alpha pam settings describe-effective \ + --project=sample-project --location=global + + The following command describes effective settings on a folder with ID + FOLDER_ID, and in location global: + + $ gcloud alpha pam settings describe-effective --folder=FOLDER_ID \ + --location=global + + The following command describes effective settings on an organization with + ID ORGANIZATION_ID, and in location global: + + $ gcloud alpha pam settings describe-effective \ + --organization=ORGANIZATION_ID --location=global + +REQUIRED FLAGS + Location resource - The project/organization/folder location for which the + effective settings are to be described. The arguments in this group can be + used to specify the attributes of this 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This resource can be one of the + following types: [privilegedaccessmanager.projects.locations, + privilegedaccessmanager.folders.locations, + privilegedaccessmanager.organizations.locations]. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --folder=FOLDER + The name of the folder + + To set the folder attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --folder on the command line. Must be + specified for resource of type + [privilegedaccessmanager.folders.locations]. + + --organization=ORGANIZATION + The name of the organization + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. Must be + specified for resource of type + [privilegedaccessmanager.organizations.locations]. + +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 privilegedaccessmanager/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview + +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. + diff --git a/gcloud/alpha/pam/settings/export b/gcloud/alpha/pam/settings/export new file mode 100644 index 000000000..2d40fc8b5 --- /dev/null +++ b/gcloud/alpha/pam/settings/export @@ -0,0 +1,108 @@ +NAME + gcloud alpha pam settings export - export Privileged Access Manager + settings configured on a project, folder, or organization to a local + YAML file + +SYNOPSIS + gcloud alpha pam settings export + (--location=LOCATION : --folder=FOLDER --organization=ORGANIZATION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Export the Privileged Access Manager (PAM) settings configured for + a specified project, folder, or organization to a local YAML file. + +EXAMPLES + The following command exports PAM settings for the project named + sample-project in location global to a local YAML file named + pam-settings.yaml: + + $ gcloud alpha pam settings export --project=sample-project \ + --location=global --destination=pam-settings.yaml + + The following command exports PAM settings for the folder with ID FOLDER_ID + in location global to a local YAML file named pam-settings.yaml: + + $ gcloud alpha pam settings export --folder=FOLDER_ID \ + --location=global --destination=pam-settings.yaml + + The following command exports PAM settings for the organization with ID + ORGANIZATION_ID in location global to a local YAML file named + pam-settings.yaml: + + $ gcloud alpha pam settings export --organization=ORGANIZATION_ID \ + --location=global --destination=pam-settings.yaml + +REQUIRED FLAGS + Location resource - The project/organization/folder location for which the + settings needs to be exported. The arguments in this group can be used to + specify the attributes of this 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This resource can be one of the + following types: [privilegedaccessmanager.projects.locations, + privilegedaccessmanager.folders.locations, + privilegedaccessmanager.organizations.locations]. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --folder=FOLDER + The name of the folder + + To set the folder attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --folder on the command line. Must be + specified for resource of type + [privilegedaccessmanager.folders.locations]. + + --organization=ORGANIZATION + The name of the organization + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. Must be + specified for resource of type + [privilegedaccessmanager.organizations.locations]. + +OPTIONAL FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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 privilegedaccessmanager/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview + +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. + diff --git a/gcloud/alpha/pam/settings/help b/gcloud/alpha/pam/settings/help new file mode 100644 index 000000000..0b8da86b6 --- /dev/null +++ b/gcloud/alpha/pam/settings/help @@ -0,0 +1,117 @@ +NAME + gcloud alpha pam settings - manage Privileged Access Manager Settings + +SYNOPSIS + gcloud alpha pam settings COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) The gcloud pam settings command group lets you manage Privileged + Access Manager (PAM) settings. + +EXAMPLES + To describe the PAM Settings on a project named sample-project and in + location global, run: + + $ gcloud alpha pam settings describe --project=sample-project \ + --location=global + + To describe the PAM Settings on a folder with ID FOLDER_ID and in location + global, run: + + $ gcloud alpha pam settings describe --folder=FOLDER_ID \ + --location=global + + To describe the PAM Settings on an organization with ID ORGANIZATION_ID and + in location global, run: + + $ gcloud alpha pam settings describe \ + --organization=ORGANIZATION_ID --location=global + + To describe the effective PAM Settings on a project named sample-project + and in location global, run: + + $ gcloud alpha pam settings describe-effective \ + --project=sample-project --location=global + + To describe the effective PAM Settings on a folder with ID FOLDER_ID and in + location global, run: + + $ gcloud alpha pam settings describe-effective --folder=FOLDER_ID \ + --location=global + + To describe the effective PAM Settings on an organization with ID + ORGANIZATION_ID and in location global, run: + + $ gcloud alpha pam settings describe-effective \ + --organization=ORGANIZATION_ID --location=global + + To export the PAM Settings configured on a project named sample-project, + and in location global to a local YAML file named pam-settings.yaml, run: + + $ gcloud alpha pam settings export --project=sample-project \ + --location=global --destination=pam-settings.yaml + + To export the PAM Settings configured on a folder with ID FOLDER_ID, and in + location global to a local YAML file named pam-settings.yaml, run: + + $ gcloud alpha pam settings export --folder=FOLDER_ID \ + --location=global --destination=pam-settings.yaml + + To export the PAM settings configured for an organization with ID + ORGANIZATION_ID in location global to a local YAML file named + pam-settings.yaml, run: + + $ gcloud alpha pam settings export --organization=ORGANIZATION_ID \ + --location=global --destination=pam-settings.yaml + + To update the PAM Settings on a project named sample-project and in + location global, and the new updated settings configuration stored in a + file named pam-settings.yaml, run: + + $ gcloud alpha pam settings update --project=sample-project \ + --location=global --settings-file=pam-settings.yaml + + To update the PAM Settings on a folder with ID FOLDER_ID and in location + global, and the new updated settings configuration stored in a file named + pam-settings.yaml, run: + + $ gcloud alpha pam settings update --folder=FOLDER_ID \ + --location=global --settings-file=pam-settings.yaml + + To update the PAM Settings on an organization with ID ORGANIZATION_ID and + in location global, and the new updated settings configuration stored in a + file named pam-settings.yaml, run: + + $ gcloud alpha pam settings update --organization=ORGANIZATION_ID \ + --location=global --settings-file=pam-settings.yaml + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Show details of Privileged Access Manager (PAM) settings on a + resource. + + describe-effective + (ALPHA) Show effective Privileged Access Manager (PAM) settings on a + resource. + + export + (ALPHA) Export Privileged Access Manager (PAM) settings configured on a + project, folder, or organization to a local YAML file. + + update + (ALPHA) Update Privileged Access Manager (PAM) settings configured on a + project, folder, or organization. + +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. + diff --git a/gcloud/alpha/pam/settings/update b/gcloud/alpha/pam/settings/update new file mode 100644 index 000000000..86cd92d1b --- /dev/null +++ b/gcloud/alpha/pam/settings/update @@ -0,0 +1,111 @@ +NAME + gcloud alpha pam settings update - update Privileged Access Manager + settings configured on a project, folder, or organization + +SYNOPSIS + gcloud alpha pam settings update --settings-file=PATH_TO_FILE + (--location=LOCATION : --folder=FOLDER --organization=ORGANIZATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update the Privileged Access Manager (PAM) settings configured for + a specified project, folder, or organization. This command allows you to + modify the settings using a YAML file. + +EXAMPLES + The following command updates PAM settings for the project named + sample-project in location global, using the settings defined in a file + named pam_settings.yaml: + + $ gcloud alpha pam settings update --project=sample-project \ + --location=global --settings-file=pam_settings.yaml + + The following command updates PAM settings for the folder with ID FOLDER_ID + in location global, using the settings defined in a file named + pam_settings.yaml: + + $ gcloud alpha pam settings update --folder=FOLDER_ID \ + --location=global --settings-file=pam_settings.yaml + + The following command updates PAM settings for the organization with ID + ORGANIZATION_ID in location global, using the settings defined in a file + named pam_settings.yaml: + + $ gcloud alpha pam settings update --organization=ORGANIZATION_ID \ + --location=global --settings-file=pam_settings.yaml + +REQUIRED FLAGS + --settings-file=PATH_TO_FILE + YAML file containing the new configuration of the PAM settings. Use a + full or relative path to a local file containing the value of + settings_file. + + Location resource - The project/organization/folder location for which the + settings are to be updated. The arguments in this group can be used to + specify the attributes of this 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. This resource can be one of the + following types: [privilegedaccessmanager.projects.locations, + privilegedaccessmanager.folders.locations, + privilegedaccessmanager.organizations.locations]. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --folder=FOLDER + The name of the folder + + To set the folder attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --folder on the command line. Must be + specified for resource of type + [privilegedaccessmanager.folders.locations]. + + --organization=ORGANIZATION + The name of the organization + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. Must be + specified for resource of type + [privilegedaccessmanager.organizations.locations]. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 privilegedaccessmanager/v1alpha API. The full + documentation for this API can be found at: + https://cloud.google.com/iam/docs/pam-overview + +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. + diff --git a/gcloud/alpha/run/multi-region-services/update b/gcloud/alpha/run/multi-region-services/update index 2616c1cc3..7737f4d8b 100644 --- a/gcloud/alpha/run/multi-region-services/update +++ b/gcloud/alpha/run/multi-region-services/update @@ -468,13 +468,17 @@ FLAGS Remove all environment variables. --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed - before the new environment variables are added. Example YAML - content: + Path to a local YAML or ENV file with definitions for all + environment variables. All existing environment variables will be + removed before the new environment variables are added. Example + YAML content: KEY_1: "value1" KEY_2: "value 2" + Example ENV content: + + KEY_1="value1" + KEY_2="value 2" --set-env-vars=[KEY=VALUE,...] List of key-value pairs to set as environment variables. All diff --git a/gcloud/alpha/sql/backups/restore b/gcloud/alpha/sql/backups/restore index e2b45ef1c..bbb301086 100644 --- a/gcloud/alpha/sql/backups/restore +++ b/gcloud/alpha/sql/backups/restore @@ -13,7 +13,8 @@ SYNOPSIS [--availability-type=AVAILABILITY_TYPE] [--no-backup] [--backup-instance=BACKUP_INSTANCE] [--backup-location=BACKUP_LOCATION] [--backup-project=BACKUP_PROJECT] - [--backup-start-time=BACKUP_START_TIME] [--clear-network] + [--backup-start-time=BACKUP_START_TIME] + [--clear-disk-encryption=CLEAR_DISK_ENCRYPTION] [--clear-network] [--collation=COLLATION] [--connector-enforcement=CONNECTOR_ENFORCEMENT] [--cpu=CPU] [--database-version=DATABASE_VERSION] [--[no-]deletion-protection] @@ -142,6 +143,9 @@ OPTIONAL FLAGS Start time of daily backups, specified in the HH:MM format, in the UTC timezone. + --clear-disk-encryption=CLEAR_DISK_ENCRYPTION + Disables CMEK in the restored instance. + --clear-network Clears the network setting. This is useful to restore a backup to a different project or region where the original network configuration diff --git a/gcloud/alpha/sql/connect b/gcloud/alpha/sql/connect index b69d00580..cd632eb27 100644 --- a/gcloud/alpha/sql/connect +++ b/gcloud/alpha/sql/connect @@ -2,9 +2,11 @@ NAME gcloud alpha sql connect - connects to a Cloud SQL instance SYNOPSIS - gcloud alpha sql connect INSTANCE [--database=DATABASE, -d DATABASE] - [--port=PORT; default=9470] [--user=USER, -u USER] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha sql connect INSTANCE [--auto-iam-authn] + [--database=DATABASE, -d DATABASE] [--debug-logs] + [--port=PORT; default=9470] [--run-connection-test] [--skip-ssl] + [--sqladmin-api-endpoint=SQLADMIN_API_ENDPOINT] [--user=USER, -u USER] + [--auto-ip | --private-ip | --psc] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Connects to a Cloud SQL instance. @@ -19,16 +21,45 @@ POSITIONAL ARGUMENTS Cloud SQL instance ID. FLAGS + --auto-iam-authn + Enables IAM database authentication for connections to MySQL and + Postgres instances. + --database=DATABASE, -d DATABASE The PostgreSQL or SQL Server database to connect to. + --debug-logs + Enable verbose debug logs for Cloud SQL Proxy. + --port=PORT; default=9470 Port number that gcloud will use to connect to the Cloud SQL Proxy through localhost. + --run-connection-test + Run connection test for Cloud SQL Proxy. + + --skip-ssl + Skip SSL certificate verification for MySQL instances. + + --sqladmin-api-endpoint=SQLADMIN_API_ENDPOINT + Cloud SQL Admin API endpoint for Cloud SQL Proxy to use. + --user=USER, -u USER Cloud SQL instance user to connect as. + IP address selection settings for Cloud SQL Proxy connection. + + At most one of these can be specified: + + --auto-ip + Connect to the Cloud SQL instance with auto IP detection. + + --private-ip + Connect to the Cloud SQL instance using private IP. + + --psc + Connect to the Cloud SQL instance using PSC. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/sql/instances/execute-sql b/gcloud/alpha/sql/instances/execute-sql new file mode 100644 index 000000000..1dd2a367a --- /dev/null +++ b/gcloud/alpha/sql/instances/execute-sql @@ -0,0 +1,73 @@ +NAME + gcloud alpha sql instances execute-sql - executes a statement on a Cloud + SQL instance + +SYNOPSIS + gcloud alpha sql instances execute-sql INSTANCE --sql=SQL + [--database=DATABASE, -d DATABASE] + [--partial_result_mode=PARTIAL_RESULT_MODE] [--row_limit=ROW_LIMIT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Executes a statement on a Cloud SQL instance. It will use the + credentials of the specified Google Cloud account to connect to the + instance, so an IAM user with the same name must exist in the instance. It + doesn't support DQL or DML statements yet. WARNING: The requests and + responses might transit through intermediate locations between your client + and the location of the target instance. + +EXAMPLES + To execute a statement on a Cloud SQL instance, run: + + $ gcloud alpha sql instances execute-sql instance-foo \ + --sql="ALTER TABLE employees RENAME TO personnel;" \ + --database=db1 + +POSITIONAL ARGUMENTS + INSTANCE + Cloud SQL instance ID. + +REQUIRED FLAGS + --sql=SQL + SQL statement(s) to execute. It supports multiple statements as well. + When it starts with the character '@', the rest should be a filepath to + read the SQL statement(s) from. + +OPTIONAL FLAGS + --database=DATABASE, -d DATABASE + Database on which the statement is executed. + + --partial_result_mode=PARTIAL_RESULT_MODE + Controls how the API should respond when the SQL execution result is + incomplete due to size limit or other reasons. The default mode is to + throw an error instead of returning the partial result. + PARTIAL_RESULT_MODE must be one of: + + ALLOW_PARTIAL_RESULT + Return the partial result and mark the field partial_result to true + if the complete result can't be returned. Don't throw an error. + FAIL_PARTIAL_RESULT + Throw an error if the complete result can't be returned. Don't + return the partial result. + PARTIAL_RESULT_MODE_UNSPECIFIED + Unspecified mode, effectively the same as FAIL_PARTIAL_RESULT. + + --row_limit=ROW_LIMIT + Maximum number of rows to return. The default is unlimited. + +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. This variant is also available: + + $ gcloud beta sql instances execute-sql + diff --git a/gcloud/alpha/sql/instances/help b/gcloud/alpha/sql/instances/help index 532b0b45a..9f017a092 100644 --- a/gcloud/alpha/sql/instances/help +++ b/gcloud/alpha/sql/instances/help @@ -35,6 +35,9 @@ COMMANDS describe (ALPHA) Displays configuration and metadata about a Cloud SQL instance. + execute-sql + (ALPHA) Executes a statement on a Cloud SQL instance. + export (ALPHA) (DEPRECATED) Exports data from a Cloud SQL instance. diff --git a/gcloud/alpha/storage/diagnose b/gcloud/alpha/storage/diagnose index 439648197..6379859f7 100644 --- a/gcloud/alpha/storage/diagnose +++ b/gcloud/alpha/storage/diagnose @@ -175,5 +175,7 @@ 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. + access allowlist. This variant is also available: + + $ gcloud storage diagnose diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index a2f1e656b..3245ae707 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -25,6 +25,7 @@ SYNOPSIS [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT] [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] [--replica-zones=[REPLICA_ZONES,...]] + [--reservation-affinity=[RESERVATION_AFFINITY,...]] [--running-timeout=RUNNING_TIMEOUT; default=7200] [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] @@ -187,13 +188,25 @@ FLAGS pool-size Sets pool-size value. + reservation-affinity + Sets reservation-affinity value. + + consume-reservation-type + Sets consume-reservation-type value. + + key + Sets key value. + + values + Sets values value. + Shorthand Example: - --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int + --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int,reservation-affinity={consume-reservation-type=string,key=string,values} JSON Example: - --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int}' + --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int, "reservation-affinity": {"consume-reservation-type": "string", "key": "string", "values"}}' File Example: @@ -356,6 +369,38 @@ FLAGS $ gcloud alpha workstations configs create \ --replica-zones=us-central1-a,us-central1-f + --reservation-affinity=[RESERVATION_AFFINITY,...] + Reservation Affinity for the VM. This includes key, values, and + consumeReservationType. + + Example: $ gcloud alpha workstations configs create \ + --reservation-affinity=key=compute.googleapis.com/\ + reservation-name,consumeReservationType=SPECIFIC_RESERVATION,\ + values=my-reservation + + Sets reservation_affinity value. + + consume-reservation-type + Sets consume-reservation-type value. + + key + Sets key value. + + values + Sets values value. + + Shorthand Example: + + --reservation-affinity=consume-reservation-type=string,key=string,values + + JSON Example: + + --reservation-affinity='{"consume-reservation-type": "string", "key": "string", "values"}' + + File Example: + + --reservation-affinity=path_to_file.(yaml|json) + --running-timeout=RUNNING_TIMEOUT; default=7200 How long (in seconds) to wait before automatically stopping a workstation after it started. A value of 0 indicates that workstations diff --git a/gcloud/alpha/workstations/configs/update b/gcloud/alpha/workstations/configs/update index cef108d1f..8d322b7ce 100644 --- a/gcloud/alpha/workstations/configs/update +++ b/gcloud/alpha/workstations/configs/update @@ -19,6 +19,7 @@ SYNOPSIS [--machine-type=MACHINE_TYPE] [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT] [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] + [--reservation-affinity=[RESERVATION_AFFINITY,...]] [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] @@ -168,13 +169,25 @@ FLAGS pool-size Sets pool-size value. + reservation-affinity + Sets reservation-affinity value. + + consume-reservation-type + Sets consume-reservation-type value. + + key + Sets key value. + + values + Sets values value. + Shorthand Example: - --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int + --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int,reservation-affinity={consume-reservation-type=string,key=string,values} JSON Example: - --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int}' + --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int, "reservation-affinity": {"consume-reservation-type": "string", "key": "string", "values"}}' File Example: @@ -272,6 +285,38 @@ FLAGS --pool-size=POOL_SIZE Number of instances to pool for faster Workstation startup. + --reservation-affinity=[RESERVATION_AFFINITY,...] + Reservation Affinity for the VM. This includes key, values, and + consumeReservationType. + + Example: $ gcloud alpha workstations configs update \ + --reservation-affinity=key=compute.googleapis.com/\ + reservation-name,consumeReservationType=SPECIFIC_RESERVATION,\ + values=my-reservation + + Sets reservation_affinity value. + + consume-reservation-type + Sets consume-reservation-type value. + + key + Sets key value. + + values + Sets values value. + + Shorthand Example: + + --reservation-affinity=consume-reservation-type=string,key=string,values + + JSON Example: + + --reservation-affinity='{"consume-reservation-type": "string", "key": "string", "values"}' + + File Example: + + --reservation-affinity=path_to_file.(yaml|json) + --running-timeout=RUNNING_TIMEOUT How long (in seconds) to wait before automatically stopping a workstation after it started. A value of 0 indicates that workstations diff --git a/gcloud/backup-dr/data-source-references/fetch-for-resource-type b/gcloud/backup-dr/data-source-references/fetch-for-resource-type index 53201e034..ae8bb56f9 100644 --- a/gcloud/backup-dr/data-source-references/fetch-for-resource-type +++ b/gcloud/backup-dr/data-source-references/fetch-for-resource-type @@ -18,7 +18,7 @@ EXAMPLES $ gcloud backup-dr data-source-references fetch-for-resource-type \ sqladmin.googleapis.com/Instance --location="us-central1" \ - --project-id="test-project" + --project="test-project" POSITIONAL ARGUMENTS RESOURCE_TYPE diff --git a/gcloud/beta/alloydb/clusters/restore b/gcloud/beta/alloydb/clusters/restore index e334d3bb3..5c315c5f2 100644 --- a/gcloud/beta/alloydb/clusters/restore +++ b/gcloud/beta/alloydb/clusters/restore @@ -4,8 +4,10 @@ NAME SYNOPSIS gcloud beta alloydb clusters restore CLUSTER --region=REGION - (--backup=BACKUP - | --point-in-time=POINT_IN_TIME --source-cluster=SOURCE_CLUSTER) + (--backup=BACKUP | --backupdr-backup=BACKUPDR_BACKUP + | --point-in-time=POINT_IN_TIME + (--backupdr-data-source=BACKUPDR_DATA_SOURCE + | --source-cluster=SOURCE_CLUSTER)) [--allocated-ip-range-name=ALLOCATED_IP_RANGE_NAME] [--async] [--enable-private-service-connect] [--network=NETWORK] [--tags=[KEY=VALUE,...]] @@ -49,6 +51,10 @@ REQUIRED FLAGS location are assumed to be the same as the restored cluster that is being created. + --backupdr-backup=BACKUPDR_BACKUP + Backup DR backup to restore from. This is a resource path of the form + projects/myProject/locations/us-central1/backupVaults/myBackupVault/dataSources/myDataSource/backups/myBackup. + Restore a cluster from a source cluster at a given point in time. --point-in-time=POINT_IN_TIME @@ -62,6 +68,11 @@ REQUIRED FLAGS Exactly one of these must be specified: + --backupdr-data-source=BACKUPDR_DATA_SOURCE + Backup DR data source to restore from. This is a resource path of + the form + projects/myProject/locations/us-central1/backupVaults/myBackupVault/dataSources/myDataSource. + --source-cluster=SOURCE_CLUSTER AlloyDB source cluster to restore from. This must either be the full cluster name diff --git a/gcloud/beta/alloydb/instances/create b/gcloud/beta/alloydb/instances/create index d52974d9e..78ffdc265 100644 --- a/gcloud/beta/alloydb/instances/create +++ b/gcloud/beta/alloydb/instances/create @@ -9,8 +9,21 @@ SYNOPSIS [--allowed-psc-projects=[ALLOWED_PSC_PROJECTS,...]] [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] - [--availability-type=AVAILABILITY_TYPE] [--cpu-count=CPU_COUNT] - [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--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] @@ -115,6 +128,51 @@ OPTIONAL FLAGS 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 + is disconnected. + + --connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,...] + Comma-separated list of startup parameters that should be ignored by + the connection 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 been connected longer than this. Setting it to 0 + means the connection is to be used only 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 the instance does not have a machine-type, the vCPU count @@ -135,6 +193,11 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_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. diff --git a/gcloud/beta/alloydb/instances/create-secondary b/gcloud/beta/alloydb/instances/create-secondary index eaf80bb90..ae308d2b0 100644 --- a/gcloud/beta/alloydb/instances/create-secondary +++ b/gcloud/beta/alloydb/instances/create-secondary @@ -10,8 +10,20 @@ SYNOPSIS [--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,...]] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] - [--[no-]outbound-public-ip] + [--[no-]enable-connection-pooling] [--[no-]outbound-public-ip] [--psc-auto-connections=[network=NETWORK],[project=PROJECT]] [--psc-network-attachment-uri=PSC_NETWORK_ATTACHMENT_URI] [--[no-]require-connectors] [--ssl-mode=SSL_MODE] @@ -85,6 +97,51 @@ OPTIONAL FLAGS 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 + is disconnected. + + --connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,...] + Comma-separated list of startup parameters that should be ignored by + the connection 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 been connected longer than this. Setting it to 0 + means the connection is to be used only once, then closed. + + --connection-pooling-stats-users=[STATS_USERS,...] + Comma-separated list of database users to access connection pooling + stats. + --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 @@ -93,6 +150,11 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_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. + --[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. diff --git a/gcloud/beta/alloydb/instances/update b/gcloud/beta/alloydb/instances/update index 7bdb0361f..eaf7f32ad 100644 --- a/gcloud/beta/alloydb/instances/update +++ b/gcloud/beta/alloydb/instances/update @@ -9,8 +9,21 @@ SYNOPSIS [--assign-inbound-public-ip=ASSIGN_INBOUND_PUBLIC_IP] [--async] [--authorized-external-networks=[AUTHORIZED_NETWORK,...]] [--availability-type=AVAILABILITY_TYPE] - [--clear-psc-network-attachment-uri] [--cpu-count=CPU_COUNT] - [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--clear-psc-network-attachment-uri] + [--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] @@ -101,6 +114,51 @@ OPTIONAL FLAGS Disable outbound connectivity from an AlloyDB instance which uses Private Service Connect (PSC). + --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 + is disconnected. + + --connection-pooling-ignore-startup-parameters=[STARTUP_PARAMETERS,...] + Comma-separated list of startup parameters that should be ignored by + the connection 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 been connected longer than this. Setting it to 0 + means the connection is to be used only 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 the instance does not have a machine-type, the vCPU count @@ -121,6 +179,11 @@ OPTIONAL FLAGS API for allowed flags. (e.g., --database-flags max_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. diff --git a/gcloud/beta/beyondcorp/security-gateways/applications/get-iam-policy b/gcloud/beta/beyondcorp/security-gateways/applications/get-iam-policy new file mode 100644 index 000000000..0c484e182 --- /dev/null +++ b/gcloud/beta/beyondcorp/security-gateways/applications/get-iam-policy @@ -0,0 +1,102 @@ +NAME + gcloud beta beyondcorp security-gateways applications get-iam-policy - get + the IAM policy for a security gateway application + +SYNOPSIS + gcloud beta beyondcorp security-gateways applications get-iam-policy + (APPLICATION : --location=LOCATION --security_gateway=SECURITY_GATEWAY) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Gets the IAM policy for the given security gateway application. + +EXAMPLES + To get the IAM policy for a security gateway application + my-security-gateway-application run: + + $ gcloud beta beyondcorp security-gateways applications \ get-iam-policy my-security-gateway-application \ + --project=consumer-project-id --location=global + +POSITIONAL ARGUMENTS + Application resource - The security gateway application for which to get + the IAM policy. The arguments in this group can be used to specify the + attributes of this 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 application on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the application resource. We support only global + location. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --security_gateway=SECURITY_GATEWAY + The securityGateway id of the application resource. + + To set the security_gateway attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --security_gateway on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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 beyondcorp/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/beyondcorp/security-gateways/applications/help b/gcloud/beta/beyondcorp/security-gateways/applications/help index f72778230..dfe2f85a8 100644 --- a/gcloud/beta/beyondcorp/security-gateways/applications/help +++ b/gcloud/beta/beyondcorp/security-gateways/applications/help @@ -26,9 +26,15 @@ COMMANDS describe (BETA) Describe applications. + get-iam-policy + (BETA) Get the IAM policy for a security gateway application. + list (BETA) List applications. + set-iam-policy + (BETA) Set the IAM policy for a security gateway application. + update (BETA) Update applications. diff --git a/gcloud/beta/beyondcorp/security-gateways/applications/set-iam-policy b/gcloud/beta/beyondcorp/security-gateways/applications/set-iam-policy new file mode 100644 index 000000000..28aee09f8 --- /dev/null +++ b/gcloud/beta/beyondcorp/security-gateways/applications/set-iam-policy @@ -0,0 +1,84 @@ +NAME + gcloud beta beyondcorp security-gateways applications set-iam-policy - set + the IAM policy for a security gateway application + +SYNOPSIS + gcloud beta beyondcorp security-gateways applications set-iam-policy + (APPLICATION : --location=LOCATION --security_gateway=SECURITY_GATEWAY) + POLICY_FILE [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Sets the IAM policy for the given security gateway application. + +EXAMPLES + The following command will read an IAM policy defined in a JSON file + 'policy.json' and set it for the security gateway application with ID + my-security-gateway-application: + + $ gcloud beta beyondcorp security-gateways applications \ + set-iam-policy my-security-gateway-application policy.json \ + --location=global + +POSITIONAL ARGUMENTS + Application resource - The security gateway application for which to set + the IAM policy. The arguments in this group can be used to specify the + attributes of this 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 application on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + APPLICATION + ID of the application or fully qualified identifier for the + application. + + To set the application attribute: + ▸ provide the argument application on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the application resource. We support only global + location. + + To set the location attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --security_gateway=SECURITY_GATEWAY + The securityGateway id of the application resource. + + To set the security_gateway attribute: + ▸ provide the argument application on the command line with a fully + specified name; + ▸ provide the argument --security_gateway on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +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 beyondcorp/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/beyondcorp/security-gateways/get-iam-policy b/gcloud/beta/beyondcorp/security-gateways/get-iam-policy new file mode 100644 index 000000000..7bf5073db --- /dev/null +++ b/gcloud/beta/beyondcorp/security-gateways/get-iam-policy @@ -0,0 +1,94 @@ +NAME + gcloud beta beyondcorp security-gateways get-iam-policy - get the IAM + policy for a security gateway + +SYNOPSIS + gcloud beta beyondcorp security-gateways get-iam-policy + (SECURITY_GATEWAY : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Gets the IAM policy for the given security gateway. + +EXAMPLES + To get the IAM policy for a security gateway my-security-gateway run: + + $ gcloud beta beyondcorp security-gateways get-iam-policy \ + my-security-gateway --project=consumer-project-id \ + --location=global + +POSITIONAL ARGUMENTS + SecurityGateway resource - The security gateway for which to get the IAM + policy. The arguments in this group can be used to specify the attributes + of this 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 security_gateway on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SECURITY_GATEWAY + ID of the securityGateway or fully qualified identifier for the + securityGateway. + + To set the security_gateway attribute: + ▸ provide the argument security_gateway on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the securityGateway resource. We support only + global location. + + To set the location attribute: + ▸ provide the argument security_gateway on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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 beyondcorp/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/beyondcorp/security-gateways/help b/gcloud/beta/beyondcorp/security-gateways/help index 4a39ef4b9..84825ecc8 100644 --- a/gcloud/beta/beyondcorp/security-gateways/help +++ b/gcloud/beta/beyondcorp/security-gateways/help @@ -32,9 +32,15 @@ COMMANDS describe (BETA) Describe securityGateways. + get-iam-policy + (BETA) Get the IAM policy for a security gateway. + list (BETA) List securityGateways. + set-iam-policy + (BETA) Set the IAM policy for a security gateway. + update (BETA) Update securityGateways. diff --git a/gcloud/beta/beyondcorp/security-gateways/set-iam-policy b/gcloud/beta/beyondcorp/security-gateways/set-iam-policy new file mode 100644 index 000000000..8c79c0426 --- /dev/null +++ b/gcloud/beta/beyondcorp/security-gateways/set-iam-policy @@ -0,0 +1,75 @@ +NAME + gcloud beta beyondcorp security-gateways set-iam-policy - set the IAM + policy for a security gateway + +SYNOPSIS + gcloud beta beyondcorp security-gateways set-iam-policy + (SECURITY_GATEWAY : --location=LOCATION) POLICY_FILE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Sets the IAM policy for the given security gateway. + +EXAMPLES + The following command will read an IAM policy defined in a JSON file + 'policy.json' and set it for the security gateway with ID + my-security-gateway: + + $ gcloud beta beyondcorp security-gateways set-iam-policy \ + my-security-gateway policy.json --location=global + +POSITIONAL ARGUMENTS + SecurityGateway resource - The security gateway for which to set the IAM + policy. The arguments in this group can be used to specify the attributes + of this 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 security_gateway on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + SECURITY_GATEWAY + ID of the securityGateway or fully qualified identifier for the + securityGateway. + + To set the security_gateway attribute: + ▸ provide the argument security_gateway on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the securityGateway resource. We support only + global location. + + To set the location attribute: + ▸ provide the argument security_gateway on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + POLICY_FILE + Path to a local JSON or YAML formatted file containing a valid policy. + + The output of the get-iam-policy command is a valid file, as is any + JSON or YAML file conforming to the structure of a Policy + (https://cloud.google.com/iam/reference/rest/v1/Policy). + +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 beyondcorp/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/compute/addresses/create b/gcloud/beta/compute/addresses/create index 468ee18cf..1686a6692 100644 --- a/gcloud/beta/compute/addresses/create +++ b/gcloud/beta/compute/addresses/create @@ -3,9 +3,9 @@ NAME SYNOPSIS gcloud beta compute addresses create [NAME ...] [--description=DESCRIPTION] - [--endpoint-type=ENDPOINT_TYPE] [--network=NETWORK] - [--network-tier=NETWORK_TIER] [--prefix-length=PREFIX_LENGTH] - [--purpose=PURPOSE] [--subnet=SUBNET] + [--endpoint-type=ENDPOINT_TYPE] [--ip-collection=IP_COLLECTION] + [--network=NETWORK] [--network-tier=NETWORK_TIER] + [--prefix-length=PREFIX_LENGTH] [--purpose=PURPOSE] [--subnet=SUBNET] [--addresses=ADDRESS,[ADDRESS,...] | --ip-version=IP_VERSION] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] @@ -76,6 +76,12 @@ FLAGS The endpoint type of the external IPv6 address to be reserved. ENDPOINT_TYPE must be one of: VM, NETLB. + --ip-collection=IP_COLLECTION + If specified, the public delegated prefix (PDP) from which to allocate + the BYOIP IP address. The PDP must support enhanced IPv4 allocations. + If not specified, the address will be allocated from the Google-owned + IP pool. + --network=NETWORK If specified, the network resource in which the address(es) should be reserved. diff --git a/gcloud/beta/compute/instance-templates/create-with-container b/gcloud/beta/compute/instance-templates/create-with-container index 6849ceda9..f32063e58 100644 --- a/gcloud/beta/compute/instance-templates/create-with-container +++ b/gcloud/beta/compute/instance-templates/create-with-container @@ -58,8 +58,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta compute instance-templates create-with-container creates - a Compute Engine virtual machine instance template that runs a container + (BETA) (DEPRECATED) The option to deploy a container during VM creation + using the container startup agent is deprecated. Use alternative services + to run containers on your VMs. Learn more at + https://cloud.google.com/compute/docs/containers/migrate-containers. + + gcloud beta compute instance-templates create-with-container creates a + Compute Engine virtual machine instance template that runs a container image. To create an instance template named 'instance-template-1' that runs the 'busybox' image, run: diff --git a/gcloud/beta/compute/instance-templates/help b/gcloud/beta/compute/instance-templates/help index ff8446018..69d5d8a35 100644 --- a/gcloud/beta/compute/instance-templates/help +++ b/gcloud/beta/compute/instance-templates/help @@ -30,8 +30,8 @@ COMMANDS (BETA) Create a Compute Engine virtual machine instance template. create-with-container - (BETA) Creates a Compute Engine a virtual machine instance template - that runs a Docker container. + (BETA) (DEPRECATED) Creates a Compute Engine a virtual machine instance + template that runs a Docker container. delete (BETA) Delete Compute Engine virtual machine instance templates. diff --git a/gcloud/beta/compute/instances/create-with-container b/gcloud/beta/compute/instances/create-with-container index b94fc6da1..f31aa849c 100644 --- a/gcloud/beta/compute/instances/create-with-container +++ b/gcloud/beta/compute/instances/create-with-container @@ -76,8 +76,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta compute instances create-with-container creates Compute - Engine virtual machines that runs a Docker image. For example: + (BETA) (DEPRECATED) The option to deploy a container during VM creation + using the container startup agent is deprecated. Use alternative services + to run containers on your VMs. Learn more at + https://cloud.google.com/compute/docs/containers/migrate-containers. + + gcloud beta compute instances create-with-container creates Compute Engine + virtual machines that runs a Docker image. For example: $ gcloud beta compute instances create-with-container instance-1 \ --zone us-central1-a \ diff --git a/gcloud/beta/compute/instances/help b/gcloud/beta/compute/instances/help index 131a2c94e..271a97fe3 100644 --- a/gcloud/beta/compute/instances/help +++ b/gcloud/beta/compute/instances/help @@ -68,8 +68,8 @@ COMMANDS (BETA) Create Compute Engine virtual machine instances. create-with-container - (BETA) Creates Compute Engine virtual machine instances running - container images. + (BETA) (DEPRECATED) Creates Compute Engine virtual machine instances + running container images. delete (BETA) Delete Compute Engine virtual machine instances. @@ -193,8 +193,8 @@ COMMANDS (BETA) Update a Compute Engine virtual machine access configuration. update-container - (BETA) Updates Compute Engine virtual machine instances running - container images. + (BETA) (DEPRECATED) Updates Compute Engine virtual machine instances + running container images. update-from-file (BETA) Update a Compute Engine virtual machine instance using a diff --git a/gcloud/beta/compute/instances/update-container b/gcloud/beta/compute/instances/update-container index 5ea136684..18ba06cc8 100644 --- a/gcloud/beta/compute/instances/update-container +++ b/gcloud/beta/compute/instances/update-container @@ -24,8 +24,13 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) gcloud beta compute instances update-container updates Compute - Engine virtual machines that runs a Docker image. For example: + (BETA) (DEPRECATED) The option to deploy a container during VM creation + using the container startup agent is deprecated. Use alternative services + to run containers on your VMs. Learn more at + https://cloud.google.com/compute/docs/containers/migrate-containers. + + gcloud beta compute instances update-container updates Compute Engine + virtual machines that runs a Docker image. For example: $ gcloud beta compute instances update-container instance-1 \ --zone us-central1-a \ diff --git a/gcloud/beta/compute/interconnects/wire-groups/create b/gcloud/beta/compute/interconnects/wire-groups/create index be598e7c0..d9d6d3675 100644 --- a/gcloud/beta/compute/interconnects/wire-groups/create +++ b/gcloud/beta/compute/interconnects/wire-groups/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud beta compute interconnects wire-groups create NAME + --bandwidth-allocation=BANDWIDTH_ALLOCATION --bandwidth-unmetered=BANDWIDTH_UNMETERED --cross-site-network=CROSS_SITE_NETWORK [--admin-enabled] [--description=DESCRIPTION] [--fault-response=FAULT_RESPONSE] @@ -30,6 +31,20 @@ POSITIONAL ARGUMENTS Name of the wire group to create. REQUIRED FLAGS + --bandwidth-allocation=BANDWIDTH_ALLOCATION + The bandwidth allocation for the wire group. BANDWIDTH_ALLOCATION must + be one of: + + ALLOCATE_PER_WIRE + Configures a separate unmetered bandwidth allocation (and + associated charges) for each wire in the group. + SHARED_WITH_WIRE_GROUP + Configures one unmetered bandwidth allocation for the wire group. + The unmetered bandwidth is divided equally across each wire in the + group, but dynamic throttling reallocates unused unmetered + bandwidth from unused or underused wires to other wires in the + group. + --bandwidth-unmetered=BANDWIDTH_UNMETERED The amount of unmetered bandwidth to assign to the wire group. diff --git a/gcloud/beta/compute/interconnects/wire-groups/update b/gcloud/beta/compute/interconnects/wire-groups/update index 8a6f4b630..56bc84095 100644 --- a/gcloud/beta/compute/interconnects/wire-groups/update +++ b/gcloud/beta/compute/interconnects/wire-groups/update @@ -5,6 +5,7 @@ NAME SYNOPSIS gcloud beta compute interconnects wire-groups update NAME --cross-site-network=CROSS_SITE_NETWORK [--admin-enabled] + [--bandwidth-allocation=BANDWIDTH_ALLOCATION] [--bandwidth-unmetered=BANDWIDTH_UNMETERED] [--description=DESCRIPTION] [--fault-response=FAULT_RESPONSE] [--type=TYPE] [--validate-only] [GCLOUD_WIDE_FLAG ...] @@ -27,6 +28,20 @@ OPTIONAL FLAGS group is operational and will carry traffic. Use --no-admin-enabled to disable it. + --bandwidth-allocation=BANDWIDTH_ALLOCATION + The bandwidth allocation for the wire group. BANDWIDTH_ALLOCATION must + be one of: + + ALLOCATE_PER_WIRE + Configures a separate unmetered bandwidth allocation (and + associated charges) for each wire in the group. + SHARED_WITH_WIRE_GROUP + Configures one unmetered bandwidth allocation for the wire group. + The unmetered bandwidth is divided equally across each wire in the + group, but dynamic throttling reallocates unused unmetered + bandwidth from unused or underused wires to other wires in the + group. + --bandwidth-unmetered=BANDWIDTH_UNMETERED The amount of unmetered bandwidth to assign to the wire group. diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 39e84b2de..3c6db2e28 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -1356,7 +1356,7 @@ FLAGS --stack-type=STACK_TYPE IP stack type of the cluster nodes. STACK_TYPE must be one of: ipv4, - ipv4-ipv6. + ipv4-ipv6, ipv6. --storage-pools=STORAGE_POOL,[...] A list of storage pools where the cluster's boot disks will be diff --git a/gcloud/beta/eventarc/google-api-sources/create b/gcloud/beta/eventarc/google-api-sources/create index cfd792cc2..ac8728824 100644 --- a/gcloud/beta/eventarc/google-api-sources/create +++ b/gcloud/beta/eventarc/google-api-sources/create @@ -8,7 +8,10 @@ SYNOPSIS (--destination-message-bus=DESTINATION_MESSAGE_BUS : --destination-message-bus-project=DESTINATION_MESSAGE_BUS_PROJECT) [--async] [--crypto-key=CRYPTO_KEY] [--labels=[KEY=VALUE,...]] - [--logging-config=LOGGING_CONFIG] [GCLOUD_WIDE_FLAG ...] + [--logging-config=LOGGING_CONFIG] + [--[no-]organization-subscription + | --project-subscriptions=GAS_PROJECT_SUBSCRIPTION,[...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create an Eventarc Google API source. @@ -115,6 +118,16 @@ OPTIONAL FLAGS one of: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. + At most one of these can be specified: + + --[no-]organization-subscription + The organization subscription for the resource. Use + --organization-subscription to enable and + --no-organization-subscription to disable. + + --project-subscriptions=GAS_PROJECT_SUBSCRIPTION,[...] + The project subscriptions for the resource. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/eventarc/google-api-sources/update b/gcloud/beta/eventarc/google-api-sources/update index 579193ec8..b01af9922 100644 --- a/gcloud/beta/eventarc/google-api-sources/update +++ b/gcloud/beta/eventarc/google-api-sources/update @@ -8,6 +8,8 @@ SYNOPSIS [--logging-config=LOGGING_CONFIG] [--update-labels=[KEY=VALUE,...]] [--clear-crypto-key | --crypto-key=CRYPTO_KEY] [--clear-labels | --remove-labels=[KEY,...]] + [--clear-project-subscriptions | --[no-]organization-subscription + | --project-subscriptions=GAS_PROJECT_SUBSCRIPTION,[...]] [--destination-message-bus=DESTINATION_MESSAGE_BUS : --destination-message-bus-project=DESTINATION_MESSAGE_BUS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -123,6 +125,19 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + At most one of these can be specified: + + --clear-project-subscriptions + Clear the project subscriptions for the resource. + + --[no-]organization-subscription + The organization subscription for the resource. Use + --organization-subscription to enable and + --no-organization-subscription to disable. + + --project-subscriptions=GAS_PROJECT_SUBSCRIPTION,[...] + The project subscriptions for the resource. + Message bus resource - The destination message bus of the Google API source. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this diff --git a/gcloud/beta/iam/workload-identity-pools/create-cred-config b/gcloud/beta/iam/workload-identity-pools/create-cred-config index 7080c268f..d248ef329 100644 --- a/gcloud/beta/iam/workload-identity-pools/create-cred-config +++ b/gcloud/beta/iam/workload-identity-pools/create-cred-config @@ -12,7 +12,7 @@ SYNOPSIS [--credential-source-field-name=CREDENTIAL_SOURCE_FIELD_NAME] [--credential-source-headers=[key=value,...]] [--credential-source-type=CREDENTIAL_SOURCE_TYPE] [--enable-imdsv2] - [--subject-token-type=SUBJECT_TOKEN_TYPE] + [--sts-location=STS_LOCATION] [--subject-token-type=SUBJECT_TOKEN_TYPE] [--credential-cert-private-key-path=CREDENTIAL_CERT_PRIVATE_KEY_PATH : --credential-cert-configuration-output-file=CREDENTIAL_CERT_CONFIGURATION_OUTPUT_FILE --credential-cert-trust-chain-path=CREDENTIAL_CERT_TRUST_CHAIN_PATH] [--executable-output-file=EXECUTABLE_OUTPUT_FILE @@ -135,6 +135,12 @@ OPTIONAL FLAGS Adds the AWS IMDSv2 session token Url to the credential source to enforce the AWS IMDSv2 flow. + --sts-location=STS_LOCATION + The location to use for the Security Token Service token endpoint. For + example, specifying us-central1 will configure the client to use the + regional endpoint sts.us-central1.rep.googleapis.com. If not specified, + the global endpoint sts.googleapis.com is used. + --subject-token-type=SUBJECT_TOKEN_TYPE The type of token being used for authorization. This defaults to urn:ietf:params:oauth:token-type:jwt. diff --git a/gcloud/beta/netapp/volumes/restore-backup-files b/gcloud/beta/netapp/volumes/restore-backup-files index c7b1f9d4f..d684318cd 100644 --- a/gcloud/beta/netapp/volumes/restore-backup-files +++ b/gcloud/beta/netapp/volumes/restore-backup-files @@ -5,8 +5,8 @@ NAME SYNOPSIS gcloud beta netapp volumes restore-backup-files (VOLUME : --location=LOCATION) --file-list=FILE_LIST,[FILE_LIST,...] - --restore-destination-path=RESTORE_DESTINATION_PATH (--backup=BACKUP : --backup_vault=BACKUP_VAULT) [--async] + [--restore-destination-path=RESTORE_DESTINATION_PATH] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -59,9 +59,6 @@ REQUIRED FLAGS List of files to be restored in the form of their absolute path as in source volume. - --restore-destination-path=RESTORE_DESTINATION_PATH - Name of the absolute directory path in the destination volume.. - Backup resource - The Backup from which files are restored back to the Volume. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this @@ -103,6 +100,9 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --restore-destination-path=RESTORE_DESTINATION_PATH + Name of the absolute directory path in the destination volume.. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, @@ -112,8 +112,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud netapp volumes restore-backup-files $ gcloud alpha netapp volumes restore-backup-files diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/create b/gcloud/beta/network-management/vpc-flow-logs-configs/create index fee248920..6c5ebb5b1 100644 --- a/gcloud/beta/network-management/vpc-flow-logs-configs/create +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/create @@ -65,13 +65,17 @@ EXAMPLES --network="projects/{project_id}/global/networks/{network_id}" POSITIONAL ARGUMENTS - VpcFlowLogsConfig resource - Identifier. Unique name of the configuration - using one of the forms: - projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} - organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} - The arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + VpcFlowLogsConfig resource - Identifier. Unique name of the configuration. + The name can have one of the following forms: + + ◆ For project-level configurations: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + + ◆ For organization-level configurations: + organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + The arguments in this group can be used to specify the attributes of + this 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 vpc_flow_logs_config on the command line with a diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/delete b/gcloud/beta/network-management/vpc-flow-logs-configs/delete index 60c3aa033..6ab1a0ac8 100644 --- a/gcloud/beta/network-management/vpc-flow-logs-configs/delete +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/delete @@ -24,13 +24,17 @@ EXAMPLES my-config --location=global POSITIONAL ARGUMENTS - VpcFlowLogsConfig resource - VpcFlowLogsConfig resource name using one of - the form: - projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config} - organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config} - The arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + VpcFlowLogsConfig resource - The resource name of the VpcFlowLogsConfig, + in one of the following formats: + + ◆ For a project-level resource: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + + ◆ For an organization-level resource: + organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + The arguments in this group can be used to specify the attributes of + this 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 vpc_flow_logs_config on the command line with a diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/describe b/gcloud/beta/network-management/vpc-flow-logs-configs/describe index c27138ce2..5fbb01cbe 100644 --- a/gcloud/beta/network-management/vpc-flow-logs-configs/describe +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/describe @@ -24,13 +24,17 @@ EXAMPLES my-config --location=global POSITIONAL ARGUMENTS - VpcFlowLogsConfig resource - VpcFlowLogsConfig resource name using the - form: - projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config} - organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config} - The arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + VpcFlowLogsConfig resource - The resource name of the VpcFlowLogsConfig, + in one of the following formats: + + ◆ For project-level resources: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + + ◆ For organization-level resources: + organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + The arguments in this group can be used to specify the attributes of + this 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 vpc_flow_logs_config on the command line with a diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/help b/gcloud/beta/network-management/vpc-flow-logs-configs/help index 1fcff52ad..3ebcd0cbd 100644 --- a/gcloud/beta/network-management/vpc-flow-logs-configs/help +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/help @@ -36,6 +36,9 @@ COMMANDS (BETA) Fetch all organization-level VPC Flow Logs configurations associated with the project. + show-effective-flow-logs-configs + (BETA) Show all effective VPC Flow Logs configurations for a resource. + update (BETA) Updates one or more fields in an existing VPC Flow Logs configuration. diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/list b/gcloud/beta/network-management/vpc-flow-logs-configs/list index 79b6028f7..5bff75b2b 100644 --- a/gcloud/beta/network-management/vpc-flow-logs-configs/list +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/list @@ -25,12 +25,16 @@ EXAMPLES --location=global --filter="state:ENABLED" REQUIRED FLAGS - Location resource - The parent resource of the VpcFlowLogsConfig: - projects/{project_id}/locations/global - organizations/{organization_id}/locations/global The arguments in this - group can be used to specify the attributes of this resource. (NOTE) Some - attributes are not given arguments in this group but can be set in other - ways. + Location resource - The parent resource of the VpcFlowLogsConfig, in one + of the following formats: + + ◆ For project-level resourcs: projects/{project_id}/locations/global + + ◆ For organization-level resources: + organizations/{organization_id}/locations/global The arguments in this + group can be used to specify the attributes of this 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 --location on the command line with a fully diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/query-org-vpc-flow-logs-configs b/gcloud/beta/network-management/vpc-flow-logs-configs/query-org-vpc-flow-logs-configs index 8a207c139..7b3fa953c 100644 --- a/gcloud/beta/network-management/vpc-flow-logs-configs/query-org-vpc-flow-logs-configs +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/query-org-vpc-flow-logs-configs @@ -21,10 +21,10 @@ EXAMPLES $ gcloud beta network-management vpc-flow-logs-configs \ query-org-vpc-flow-logs-configs --location=global REQUIRED FLAGS - Location resource - The parent resource of the VpcFlowLogsConfig: - projects/{project_id}/locations/global This represents a Cloud resource. - (NOTE) Some attributes are not given arguments in this group but can be - set in other ways. + Location resource - The parent resource of the VpcFlowLogsConfig, + specified in the following format: projects/{project_id}/locations/global + 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 --location on the command line with a fully @@ -79,5 +79,9 @@ API REFERENCE for this API can be found at: https://cloud.google.com/ NOTES - This command is currently in beta and might change without notice. + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-management vpc-flow-logs-configs \ + query-org-vpc-flow-logs-configs diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/show-effective-flow-logs-configs b/gcloud/beta/network-management/vpc-flow-logs-configs/show-effective-flow-logs-configs new file mode 100644 index 000000000..40728b65b --- /dev/null +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/show-effective-flow-logs-configs @@ -0,0 +1,95 @@ +NAME + gcloud beta network-management vpc-flow-logs-configs + show-effective-flow-logs-configs - show all effective VPC Flow Logs + configurations for a resource + +SYNOPSIS + gcloud beta network-management vpc-flow-logs-configs + show-effective-flow-logs-configs --location=LOCATION + --resource=RESOURCE [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Shows all effective VPC Flow Logs configurations for a resource. The + effective configurations include all configurations that apply to the + resource, including inherited ones from parent resources. + +EXAMPLES + To show all effective VPC Flow Logs configurations for a network my-network + in project my-project, run: + + $ gcloud beta network-management vpc-flow-logs-configs \ + show-effective-flow-logs-configs --location=global \ + --resource="projects/my-project/global/networks/my-network" + +REQUIRED FLAGS + Location resource - The parent resource of the VpcFlowLogsConfig, + specified in the following format: projects/{project_id}/locations/global + 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + --resource=RESOURCE + The resource to get the effective VPC Flow Logs configuration for. The + resource must belong to the same project as the parent. The resource + must be a network, subnetwork, interconnect attachment, VPN tunnel, or + a project. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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 networkmanagement/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/ + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-management vpc-flow-logs-configs \ + show-effective-flow-logs-configs + diff --git a/gcloud/beta/network-management/vpc-flow-logs-configs/update b/gcloud/beta/network-management/vpc-flow-logs-configs/update index bbac98790..b27837e4f 100644 --- a/gcloud/beta/network-management/vpc-flow-logs-configs/update +++ b/gcloud/beta/network-management/vpc-flow-logs-configs/update @@ -40,13 +40,17 @@ EXAMPLES my-config --location=global --state=DISABLED POSITIONAL ARGUMENTS - VpcFlowLogsConfig resource - Identifier. Unique name of the configuration - using one of the forms: - projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} - organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} - The arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + VpcFlowLogsConfig resource - Identifier. Unique name of the configuration. + The name can have one of the following forms: + + ◆ For project-level configurations: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + + ◆ For organization-level configurations: + organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + The arguments in this group can be used to specify the attributes of + this 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 vpc_flow_logs_config on the command line with a diff --git a/gcloud/beta/network-security/security-profile-groups/create b/gcloud/beta/network-security/security-profile-groups/create index 7c27cb47e..498eae0c0 100644 --- a/gcloud/beta/network-security/security-profile-groups/create +++ b/gcloud/beta/network-security/security-profile-groups/create @@ -7,7 +7,7 @@ SYNOPSIS (SECURITY_PROFILE_GROUP : --location=LOCATION --organization=ORGANIZATION) ([--custom-intercept-profile=CUSTOM_INTERCEPT_PROFILE - : --custom-intercept-profile-location=CUSTOM_INTERCEPT_PROFILE_LOCATION --custom-intercept-profile-organization=CUSTOM_INTERCEPT_PROFILE_ORGANIZATION] [--custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE : --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION] [--threat-prevention-profile=THREAT_PREVENTION_PROFILE : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION]) + : --custom-intercept-profile-location=CUSTOM_INTERCEPT_PROFILE_LOCATION --custom-intercept-profile-organization=CUSTOM_INTERCEPT_PROFILE_ORGANIZATION] [--custom-mirroring-profile=CUSTOM_MIRRORING_PROFILE : --custom-mirroring-profile-location=CUSTOM_MIRRORING_PROFILE_LOCATION --custom-mirroring-profile-organization=CUSTOM_MIRRORING_PROFILE_ORGANIZATION] [--threat-prevention-profile=THREAT_PREVENTION_PROFILE : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] [--url-filtering-profile=URL_FILTERING_PROFILE : --url-filtering-profile-location=URL_FILTERING_PROFILE_LOCATION --url-filtering-profile-organization=URL_FILTERING_PROFILE_ORGANIZATION]) [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] @@ -192,6 +192,48 @@ REQUIRED FLAGS networksecurity.organizations.locations.securityProfileGroups on the command line with a fully specified name. + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --url-filtering-profile=URL_FILTERING_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the name attribute: + ▫ provide the argument --url-filtering-profile on the command + line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --url-filtering-profile-location=URL_FILTERING_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security + profiles are supported. + + To set the location attribute: + ▫ provide the argument --url-filtering-profile on the command + line with a fully specified name; + ▫ provide the argument --url-filtering-profile-location on the + command line; + ▫ provide the argument --location on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --url-filtering-profile-organization=URL_FILTERING_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the organization attribute: + ▫ provide the argument --url-filtering-profile on the command + line with a fully specified name; + ▫ provide the argument --url-filtering-profile-organization on + the command line; + ▫ provide the argument --organization on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to diff --git a/gcloud/beta/network-security/security-profile-groups/update b/gcloud/beta/network-security/security-profile-groups/update index 6265a3b7d..4c882ffc4 100644 --- a/gcloud/beta/network-security/security-profile-groups/update +++ b/gcloud/beta/network-security/security-profile-groups/update @@ -8,8 +8,13 @@ SYNOPSIS : --location=LOCATION --organization=ORGANIZATION) [--async] [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] - [--threat-prevention-profile=THREAT_PREVENTION_PROFILE - : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION] + [--clear-threat-prevention-profile + | [--threat-prevention-profile=THREAT_PREVENTION_PROFILE + : --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION]] + [--clear-url-filtering-profile + | [--url-filtering-profile=URL_FILTERING_PROFILE + : --url-filtering-profile-location=URL_FILTERING_PROFILE_LOCATION + --url-filtering-profile-organization=URL_FILTERING_PROFILE_ORGANIZATION]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -97,51 +102,103 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. - Security Profile resource - Path to Security Profile resource. The - arguments in this group can be used to specify the attributes of this - resource. + At most one of these can be specified: - --threat-prevention-profile=THREAT_PREVENTION_PROFILE - ID of the Security Profile or fully qualified identifier for the - Security Profile. + --clear-threat-prevention-profile + Clear the threat-prevention-profile field. - To set the name attribute: - ▸ provide the argument --threat-prevention-profile on the command - line. + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. - This flag argument must be specified if any of the other arguments in - this group are specified. + --threat-prevention-profile=THREAT_PREVENTION_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. - --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION - Location of the Security Profile. NOTE: Only global security profiles - are supported. + To set the name attribute: + ▫ provide the argument --threat-prevention-profile on the command + line. - To set the location attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --threat-prevention-profile-location on the - command line; - ▸ provide the argument --security-profile-location on the command - line; - ▸ provide the argument --location on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. + This flag argument must be specified if any of the other arguments + in this group are specified. - --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION - Organization ID of the Security Profile. + --threat-prevention-profile-location=THREAT_PREVENTION_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security + profiles are supported. - To set the organization attribute: - ▸ provide the argument --threat-prevention-profile on the command - line with a fully specified name; - ▸ provide the argument --threat-prevention-profile-organization on - the command line; - ▸ provide the argument --security-profile-organization on the - command line; - ▸ provide the argument --organization on the command line; - ▸ provide the argument - networksecurity.organizations.locations.securityProfileGroups on - the command line with a fully specified name. + To set the location attribute: + ▫ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▫ provide the argument --threat-prevention-profile-location on + the command line; + ▫ provide the argument --security-profile-location on the command + line; + ▫ provide the argument --location on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --threat-prevention-profile-organization=THREAT_PREVENTION_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the organization attribute: + ▫ provide the argument --threat-prevention-profile on the command + line with a fully specified name; + ▫ provide the argument --threat-prevention-profile-organization + on the command line; + ▫ provide the argument --security-profile-organization on the + command line; + ▫ provide the argument --organization on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + At most one of these can be specified: + + --clear-url-filtering-profile + Clear the url-filtering-profile field. + + Security Profile resource - Path to Security Profile resource. The + arguments in this group can be used to specify the attributes of this + resource. + + --url-filtering-profile=URL_FILTERING_PROFILE + ID of the Security Profile or fully qualified identifier for the + Security Profile. + + To set the name attribute: + ▫ provide the argument --url-filtering-profile on the command + line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --url-filtering-profile-location=URL_FILTERING_PROFILE_LOCATION + Location of the Security Profile. NOTE: Only global security + profiles are supported. + + To set the location attribute: + ▫ provide the argument --url-filtering-profile on the command + line with a fully specified name; + ▫ provide the argument --url-filtering-profile-location on the + command line; + ▫ provide the argument --location on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. + + --url-filtering-profile-organization=URL_FILTERING_PROFILE_ORGANIZATION + Organization ID of the Security Profile. + + To set the organization attribute: + ▫ provide the argument --url-filtering-profile on the command + line with a fully specified name; + ▫ provide the argument --url-filtering-profile-organization on + the command line; + ▫ provide the argument --organization on the command line; + ▫ provide the argument + networksecurity.organizations.locations.securityProfileGroups on + the command line with a fully specified name. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/network-security/security-profiles/describe b/gcloud/beta/network-security/security-profiles/describe new file mode 100644 index 000000000..7713044a0 --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/describe @@ -0,0 +1,70 @@ +NAME + gcloud beta network-security security-profiles describe - describe a + Security Profile + +SYNOPSIS + gcloud beta network-security security-profiles describe + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Show details of a Security Profile. + +EXAMPLES + To show details of a Security Profile named my-security-profile run: + + $ gcloud beta network-security security-profiles describe \ + my-security-profile --organization=1234 --location=global + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile to be described. + The arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +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 networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles describe + diff --git a/gcloud/beta/network-security/security-profiles/export b/gcloud/beta/network-security/security-profiles/export new file mode 100644 index 000000000..17ff39eea --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/export @@ -0,0 +1,79 @@ +NAME + gcloud beta network-security security-profiles export - export Security + Profile + +SYNOPSIS + gcloud beta network-security security-profiles export + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Export a Security Profile. + +EXAMPLES + To export a Security Profile, run: + + $ gcloud beta network-security security-profiles export \ + my-security-profile --organization=1234 --location=global \ + --destination=my-security-profile.yaml + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile to export. The + arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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 networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles export + diff --git a/gcloud/beta/network-security/security-profiles/help b/gcloud/beta/network-security/security-profiles/help index ae71d8359..5e2fc19ae 100644 --- a/gcloud/beta/network-security/security-profiles/help +++ b/gcloud/beta/network-security/security-profiles/help @@ -3,7 +3,8 @@ NAME Security Profiles SYNOPSIS - gcloud beta network-security security-profiles GROUP [GCLOUD_WIDE_FLAG ...] + gcloud beta network-security security-profiles GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Manage Network Security - Security Profiles. @@ -25,6 +26,24 @@ GROUPS threat-prevention (BETA) Manage Security Profiles - Threat Prevention Profile. + url-filtering + (BETA) Manage Security Profiles - Url Filtering Profile. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe a Security Profile. + + export + (BETA) Export Security Profile. + + import + (BETA) Import Security Profile. + + list + (BETA) List Security Profiles. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/network-security/security-profiles/import b/gcloud/beta/network-security/security-profiles/import new file mode 100644 index 000000000..96a48c9af --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/import @@ -0,0 +1,86 @@ +NAME + gcloud beta network-security security-profiles import - import Security + Profile + +SYNOPSIS + gcloud beta network-security security-profiles import + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Import a Security Profile. + +EXAMPLES + To import a Security Profile from a YAML file, run: + + $ gcloud beta network-security security-profiles import \ + my-security-profile --organization=1234 --location=global \ + --source=my-security-profile.yaml + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile to import. The + arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +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 networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles import + diff --git a/gcloud/beta/network-security/security-profiles/list b/gcloud/beta/network-security/security-profiles/list new file mode 100644 index 000000000..5334a0ec0 --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/list @@ -0,0 +1,93 @@ +NAME + gcloud beta network-security security-profiles list - list Security + Profiles + +SYNOPSIS + gcloud beta network-security security-profiles list + (--location=LOCATION : --organization=ORGANIZATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all Security Profiles in the specified location. + +EXAMPLES + To list Security Profiles in specifed location, run: + + $ gcloud beta network-security security-profiles list \ + --location=global + +REQUIRED FLAGS + Location resource - The location of Security Profiles to display. The + arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles list + diff --git a/gcloud/beta/network-security/security-profiles/url-filtering/create b/gcloud/beta/network-security/security-profiles/url-filtering/create new file mode 100644 index 000000000..f93c7d8f8 --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/url-filtering/create @@ -0,0 +1,84 @@ +NAME + gcloud beta network-security security-profiles url-filtering create - + create a new URL Filtering Profile + +SYNOPSIS + gcloud beta network-security security-profiles url-filtering create + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new URL Filtering Security Profile. + +EXAMPLES + To create a URL Filtering Security Profile named my-urlf-security-profile + with an optional description as New URLF Security Profile, run: + + $ gcloud beta network-security security-profiles url-filtering \ + create my-urlf-security-profile \ + --description="New URLF Security Profile" + +POSITIONAL ARGUMENTS + Security profile resource - Security Profile Name. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + location of the security_profile - Global. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + Organization ID to which the changes should apply. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is False. + + --description=DESCRIPTION + Brief description of the security profile + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +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 beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles url-filtering \ + create + diff --git a/gcloud/beta/network-security/security-profiles/url-filtering/delete b/gcloud/beta/network-security/security-profiles/url-filtering/delete new file mode 100644 index 000000000..21abcac6d --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/url-filtering/delete @@ -0,0 +1,76 @@ +NAME + gcloud beta network-security security-profiles url-filtering delete - + delete a Security Profile + +SYNOPSIS + gcloud beta network-security security-profiles url-filtering delete + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete the specified Security Profile. + +EXAMPLES + To delete a Security Profile called my-security-profile run: + + $ gcloud beta network-security security-profiles url-filtering \ + delete my-security-profile + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile you want to + delete. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +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 networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles url-filtering \ + delete + diff --git a/gcloud/beta/network-security/security-profiles/url-filtering/describe b/gcloud/beta/network-security/security-profiles/url-filtering/describe new file mode 100644 index 000000000..ee82595e9 --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/url-filtering/describe @@ -0,0 +1,71 @@ +NAME + gcloud beta network-security security-profiles url-filtering describe - + describe a URL Filtering Security Profile + +SYNOPSIS + gcloud beta network-security security-profiles url-filtering describe + (SECURITY_PROFILE : --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Show details of the Security Profile. + +EXAMPLES + To show details of a Security Profile named my-urlf-sp run: + + $ gcloud beta network-security security-profiles url-filtering \ + describe my-urlf-sp --organization=1234 --location=global + +POSITIONAL ARGUMENTS + Security profile resource - Name of the Security Profile to be described. + The arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + SECURITY_PROFILE + ID of the security_profile or fully qualified identifier for the + security_profile. + + To set the security_profile attribute: + ▸ provide the argument security_profile on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ use default global location . + + --organization=ORGANIZATION + Organization number. + + To set the organization attribute: + ▸ provide the argument security_profile on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +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 networksecurity/v1beta1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles url-filtering \ + describe + diff --git a/gcloud/beta/network-security/security-profiles/url-filtering/help b/gcloud/beta/network-security/security-profiles/url-filtering/help new file mode 100644 index 000000000..ff310f01c --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/url-filtering/help @@ -0,0 +1,37 @@ +NAME + gcloud beta network-security security-profiles url-filtering - manage + Security Profiles - Url Filtering Profile + +SYNOPSIS + gcloud beta network-security security-profiles url-filtering COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Security Profiles - Url Filtering Profile. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a new URL Filtering Profile. + + delete + (BETA) Delete a Security Profile. + + describe + (BETA) Describe a URL Filtering Security Profile. + + list + (BETA) List URL Filtering Security Profiles. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles url-filtering + diff --git a/gcloud/beta/network-security/security-profiles/url-filtering/list b/gcloud/beta/network-security/security-profiles/url-filtering/list new file mode 100644 index 000000000..d2c3ac0bb --- /dev/null +++ b/gcloud/beta/network-security/security-profiles/url-filtering/list @@ -0,0 +1,89 @@ +NAME + gcloud beta network-security security-profiles url-filtering list - list + URL Filtering Security Profiles + +SYNOPSIS + gcloud beta network-security security-profiles url-filtering list + (--location=LOCATION : --organization=ORGANIZATION) + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List URL Filtering Security Profiles. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list URL Filtering security profiles in an organization, run: + + $ gcloud beta network-security security-profiles url-filtering \ list --organization=12345 --location=global + +REQUIRED FLAGS + Location resource - Parent resource for the list operation. The arguments + in this group can be used to specify the attributes of this resource. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --organization=ORGANIZATION + Organization ID of the location. + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security security-profiles url-filtering list + diff --git a/gcloud/beta/run/multi-region-services/update b/gcloud/beta/run/multi-region-services/update index 798bc5edf..2911898af 100644 --- a/gcloud/beta/run/multi-region-services/update +++ b/gcloud/beta/run/multi-region-services/update @@ -447,13 +447,17 @@ FLAGS Remove all environment variables. --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed - before the new environment variables are added. Example YAML - content: + Path to a local YAML or ENV file with definitions for all + environment variables. All existing environment variables will be + removed before the new environment variables are added. Example + YAML content: KEY_1: "value1" KEY_2: "value 2" + Example ENV content: + + KEY_1="value1" + KEY_2="value 2" --set-env-vars=[KEY=VALUE,...] List of key-value pairs to set as environment variables. All diff --git a/gcloud/beta/sql/backups/restore b/gcloud/beta/sql/backups/restore index 3f00c51b8..766b2fe12 100644 --- a/gcloud/beta/sql/backups/restore +++ b/gcloud/beta/sql/backups/restore @@ -12,7 +12,8 @@ SYNOPSIS [--availability-type=AVAILABILITY_TYPE] [--no-backup] [--backup-instance=BACKUP_INSTANCE] [--backup-location=BACKUP_LOCATION] [--backup-project=BACKUP_PROJECT] - [--backup-start-time=BACKUP_START_TIME] [--clear-network] + [--backup-start-time=BACKUP_START_TIME] + [--clear-disk-encryption=CLEAR_DISK_ENCRYPTION] [--clear-network] [--collation=COLLATION] [--connector-enforcement=CONNECTOR_ENFORCEMENT] [--cpu=CPU] [--database-version=DATABASE_VERSION] [--[no-]deletion-protection] @@ -141,6 +142,9 @@ OPTIONAL FLAGS Start time of daily backups, specified in the HH:MM format, in the UTC timezone. + --clear-disk-encryption=CLEAR_DISK_ENCRYPTION + Disables CMEK in the restored instance. + --clear-network Clears the network setting. This is useful to restore a backup to a different project or region where the original network configuration diff --git a/gcloud/beta/sql/instances/execute-sql b/gcloud/beta/sql/instances/execute-sql new file mode 100644 index 000000000..76e1aee8d --- /dev/null +++ b/gcloud/beta/sql/instances/execute-sql @@ -0,0 +1,71 @@ +NAME + gcloud beta sql instances execute-sql - executes a statement on a Cloud SQL + instance + +SYNOPSIS + gcloud beta sql instances execute-sql INSTANCE --sql=SQL + [--database=DATABASE, -d DATABASE] + [--partial_result_mode=PARTIAL_RESULT_MODE] [--row_limit=ROW_LIMIT] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Executes a statement on a Cloud SQL instance. It will use the + credentials of the specified Google Cloud account to connect to the + instance, so an IAM user with the same name must exist in the instance. It + doesn't support DQL or DML statements yet. WARNING: The requests and + responses might transit through intermediate locations between your client + and the location of the target instance. + +EXAMPLES + To execute a statement on a Cloud SQL instance, run: + + $ gcloud beta sql instances execute-sql instance-foo \ + --sql="ALTER TABLE employees RENAME TO personnel;" \ + --database=db1 + +POSITIONAL ARGUMENTS + INSTANCE + Cloud SQL instance ID. + +REQUIRED FLAGS + --sql=SQL + SQL statement(s) to execute. It supports multiple statements as well. + When it starts with the character '@', the rest should be a filepath to + read the SQL statement(s) from. + +OPTIONAL FLAGS + --database=DATABASE, -d DATABASE + Database on which the statement is executed. + + --partial_result_mode=PARTIAL_RESULT_MODE + Controls how the API should respond when the SQL execution result is + incomplete due to size limit or other reasons. The default mode is to + throw an error instead of returning the partial result. + PARTIAL_RESULT_MODE must be one of: + + ALLOW_PARTIAL_RESULT + Return the partial result and mark the field partial_result to true + if the complete result can't be returned. Don't throw an error. + FAIL_PARTIAL_RESULT + Throw an error if the complete result can't be returned. Don't + return the partial result. + PARTIAL_RESULT_MODE_UNSPECIFIED + Unspecified mode, effectively the same as FAIL_PARTIAL_RESULT. + + --row_limit=ROW_LIMIT + Maximum number of rows to return. The default is unlimited. + +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 beta and might change without notice. This + variant is also available: + + $ gcloud alpha sql instances execute-sql + diff --git a/gcloud/beta/sql/instances/help b/gcloud/beta/sql/instances/help index a2b61b2c2..0cbe80884 100644 --- a/gcloud/beta/sql/instances/help +++ b/gcloud/beta/sql/instances/help @@ -29,6 +29,9 @@ COMMANDS describe (BETA) Displays configuration and metadata about a Cloud SQL instance. + execute-sql + (BETA) Executes a statement on a Cloud SQL instance. + export (BETA) (DEPRECATED) Exports data from a Cloud SQL instance. diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index 7f11b36d8..c01100621 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -25,6 +25,7 @@ SYNOPSIS [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT] [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] [--replica-zones=[REPLICA_ZONES,...]] + [--reservation-affinity=[RESERVATION_AFFINITY,...]] [--running-timeout=RUNNING_TIMEOUT; default=7200] [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] @@ -187,13 +188,25 @@ FLAGS pool-size Sets pool-size value. + reservation-affinity + Sets reservation-affinity value. + + consume-reservation-type + Sets consume-reservation-type value. + + key + Sets key value. + + values + Sets values value. + Shorthand Example: - --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int + --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int,reservation-affinity={consume-reservation-type=string,key=string,values} JSON Example: - --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int}' + --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int, "reservation-affinity": {"consume-reservation-type": "string", "key": "string", "values"}}' File Example: @@ -356,6 +369,38 @@ FLAGS $ gcloud beta workstations configs create \ --replica-zones=us-central1-a,us-central1-f + --reservation-affinity=[RESERVATION_AFFINITY,...] + Reservation Affinity for the VM. This includes key, values, and + consumeReservationType. + + Example: $ gcloud beta workstations configs create \ + --reservation-affinity=key=compute.googleapis.com/\ + reservation-name,consumeReservationType=SPECIFIC_RESERVATION,\ + values=my-reservation + + Sets reservation_affinity value. + + consume-reservation-type + Sets consume-reservation-type value. + + key + Sets key value. + + values + Sets values value. + + Shorthand Example: + + --reservation-affinity=consume-reservation-type=string,key=string,values + + JSON Example: + + --reservation-affinity='{"consume-reservation-type": "string", "key": "string", "values"}' + + File Example: + + --reservation-affinity=path_to_file.(yaml|json) + --running-timeout=RUNNING_TIMEOUT; default=7200 How long (in seconds) to wait before automatically stopping a workstation after it started. A value of 0 indicates that workstations diff --git a/gcloud/beta/workstations/configs/update b/gcloud/beta/workstations/configs/update index fe20d80be..c84c48b6c 100644 --- a/gcloud/beta/workstations/configs/update +++ b/gcloud/beta/workstations/configs/update @@ -19,6 +19,7 @@ SYNOPSIS [--machine-type=MACHINE_TYPE] [--max-usable-workstations-count=MAX_USABLE_WORKSTATIONS_COUNT] [--network-tags=[NETWORK_TAGS,...]] [--pool-size=POOL_SIZE] + [--reservation-affinity=[RESERVATION_AFFINITY,...]] [--running-timeout=RUNNING_TIMEOUT] [--service-account=SERVICE_ACCOUNT] [--service-account-scopes=[SERVICE_ACCOUNT_SCOPES,...]] [--shielded-integrity-monitoring] [--shielded-secure-boot] @@ -168,13 +169,25 @@ FLAGS pool-size Sets pool-size value. + reservation-affinity + Sets reservation-affinity value. + + consume-reservation-type + Sets consume-reservation-type value. + + key + Sets key value. + + values + Sets values value. + Shorthand Example: - --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int + --boost-config=accelerator-count=int,accelerator-type=string,boot-disk-size=int,enable-nested-virtualization=boolean,id=string,machine-type=string,pool-size=int,reservation-affinity={consume-reservation-type=string,key=string,values} JSON Example: - --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int}' + --boost-config='{"accelerator-count": int, "accelerator-type": "string", "boot-disk-size": int, "enable-nested-virtualization": boolean, "id": "string", "machine-type": "string", "pool-size": int, "reservation-affinity": {"consume-reservation-type": "string", "key": "string", "values"}}' File Example: @@ -272,6 +285,38 @@ FLAGS --pool-size=POOL_SIZE Number of instances to pool for faster Workstation startup. + --reservation-affinity=[RESERVATION_AFFINITY,...] + Reservation Affinity for the VM. This includes key, values, and + consumeReservationType. + + Example: $ gcloud beta workstations configs update \ + --reservation-affinity=key=compute.googleapis.com/\ + reservation-name,consumeReservationType=SPECIFIC_RESERVATION,\ + values=my-reservation + + Sets reservation_affinity value. + + consume-reservation-type + Sets consume-reservation-type value. + + key + Sets key value. + + values + Sets values value. + + Shorthand Example: + + --reservation-affinity=consume-reservation-type=string,key=string,values + + JSON Example: + + --reservation-affinity='{"consume-reservation-type": "string", "key": "string", "values"}' + + File Example: + + --reservation-affinity=path_to_file.(yaml|json) + --running-timeout=RUNNING_TIMEOUT How long (in seconds) to wait before automatically stopping a workstation after it started. A value of 0 indicates that workstations diff --git a/gcloud/cloudlocationfinder/cloud-locations/describe b/gcloud/cloudlocationfinder/cloud-locations/describe new file mode 100644 index 000000000..b89ec18e5 --- /dev/null +++ b/gcloud/cloudlocationfinder/cloud-locations/describe @@ -0,0 +1,65 @@ +NAME + gcloud cloudlocationfinder cloud-locations describe - describe a Cloud + Location + +SYNOPSIS + gcloud cloudlocationfinder cloud-locations describe + (CLOUD_LOCATION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Cloud Location + +EXAMPLES + To describe the Cloud Location with name "gcp-us-central1", run: + + $ gcloud cloudlocationfinder cloud-locations describe gcp-us-central1 + +POSITIONAL ARGUMENTS + CloudLocation resource - Name of the resource. The arguments in this group + can be used to specify the attributes of this 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 cloud_location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + CLOUD_LOCATION + ID of the cloudLocation or fully qualified identifier for the + cloudLocation. + + To set the cloud_location attribute: + ▸ provide the argument cloud_location on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the cloudLocation resource. + + To set the location attribute: + ▸ provide the argument cloud_location on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +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 cloudlocationfinder/v1 API. The full documentation + for this API can be found at: https://cloud.google.com/location-finder/docs + +NOTES + This variant is also available: + + $ gcloud alpha cloudlocationfinder cloud-locations describe + diff --git a/gcloud/cloudlocationfinder/cloud-locations/help b/gcloud/cloudlocationfinder/cloud-locations/help new file mode 100644 index 000000000..92c819737 --- /dev/null +++ b/gcloud/cloudlocationfinder/cloud-locations/help @@ -0,0 +1,32 @@ +NAME + gcloud cloudlocationfinder cloud-locations - manage Cloud Location + resources + +SYNOPSIS + gcloud cloudlocationfinder cloud-locations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloud Location resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe a Cloud Location. + + list + List cloudLocations. + + search + Search cloudLocations. + +NOTES + This variant is also available: + + $ gcloud alpha cloudlocationfinder cloud-locations + diff --git a/gcloud/cloudlocationfinder/cloud-locations/list b/gcloud/cloudlocationfinder/cloud-locations/list new file mode 100644 index 000000000..a362eb617 --- /dev/null +++ b/gcloud/cloudlocationfinder/cloud-locations/list @@ -0,0 +1,74 @@ +NAME + gcloud cloudlocationfinder cloud-locations list - list cloudLocations + +SYNOPSIS + gcloud cloudlocationfinder cloud-locations list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Request for listing Cloudlocations. + +EXAMPLES + To list CloudLocations, run: + + $ gcloud cloudlocationfinder cloud-locations list + +FLAGS + Location resource - The resource location. 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 --location on the command line with a fully + specified name; + ◆ location is always global with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ location is always global. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 variant is also available: + + $ gcloud alpha cloudlocationfinder cloud-locations list + diff --git a/gcloud/cloudlocationfinder/cloud-locations/search b/gcloud/cloudlocationfinder/cloud-locations/search new file mode 100644 index 000000000..7940164be --- /dev/null +++ b/gcloud/cloudlocationfinder/cloud-locations/search @@ -0,0 +1,86 @@ +NAME + gcloud cloudlocationfinder cloud-locations search - search cloudLocations + +SYNOPSIS + gcloud cloudlocationfinder cloud-locations search + --source-cloud-location=SOURCE_CLOUD_LOCATION [--limit=LIMIT] + [--location=LOCATION] [--page-size=PAGE_SIZE] [--query=QUERY] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Search Cloudlocations. + +EXAMPLES + To search CloudLocations, run: + + $ gcloud cloudlocationfinder cloud-locations search \ + --source-cloud-location=aws-us-east-1 \ + --query=display_name="us-east4" + +REQUIRED FLAGS + Source cloud location resource - The source Cloud location. 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 --source-cloud-location 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 --source-cloud-location on the command line with + a fully specified name; + ◆ provide the argument --location on the command line; + ◆ location is always global. + + This must be specified. + + --source-cloud-location=SOURCE_CLOUD_LOCATION + ID of the source_cloud_location or fully qualified identifier for the + source_cloud_location. + + To set the cloud_location attribute: + ▸ provide the argument --source-cloud-location on the command line. + +OPTIONAL FLAGS + --limit=LIMIT + Maximum number of resources to return. + + Location resource - The resource location. 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 --location on the command line with a fully + specified name; + ◆ location is always global with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ location is always global. + + --page-size=PAGE_SIZE + Maximum number of resources per page. + + --query=QUERY + Query to use for searching Cloudlocations. + +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 variant is also available: + + $ gcloud alpha cloudlocationfinder cloud-locations search + diff --git a/gcloud/cloudlocationfinder/help b/gcloud/cloudlocationfinder/help new file mode 100644 index 000000000..ab99aebf3 --- /dev/null +++ b/gcloud/cloudlocationfinder/help @@ -0,0 +1,25 @@ +NAME + gcloud cloudlocationfinder - manage Cloudlocationfinder resources + +SYNOPSIS + gcloud cloudlocationfinder GROUP [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Cloudlocationfinder resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + cloud-locations + Manage Cloud Location resources. + +NOTES + This variant is also available: + + $ gcloud alpha cloudlocationfinder + diff --git a/gcloud/compute/instance-templates/create b/gcloud/compute/instance-templates/create index e7dab2ac2..26e1461fa 100644 --- a/gcloud/compute/instance-templates/create +++ b/gcloud/compute/instance-templates/create @@ -44,7 +44,8 @@ SYNOPSIS [--resource-manager-tags=[KEY=VALUE,...]] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance=SOURCE_INSTANCE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance=SOURCE_INSTANCE] [--source-instance-zone=SOURCE_INSTANCE_ZONE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] @@ -834,6 +835,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance=SOURCE_INSTANCE The name of the source instance that the instance template will be created from. diff --git a/gcloud/compute/instance-templates/create-with-container b/gcloud/compute/instance-templates/create-with-container index 8f27c116c..2caffeff9 100644 --- a/gcloud/compute/instance-templates/create-with-container +++ b/gcloud/compute/instance-templates/create-with-container @@ -42,8 +42,9 @@ SYNOPSIS [--provisioning-model=PROVISIONING_MODEL] [--region=REGION] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--stack-type=STACK_TYPE] [--subnet=SUBNET] - [--tags=TAG,[TAG,...]] [--address=ADDRESS | --no-address] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] + [--address=ADDRESS | --no-address] [--custom-cpu=CUSTOM_CPU --custom-memory=CUSTOM_MEMORY : --custom-extensions --custom-vm-type=CUSTOM_VM_TYPE] [--image-project=IMAGE_PROJECT --image=IMAGE @@ -55,6 +56,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) The option to deploy a container during VM creation using the + container startup agent is deprecated. Use alternative services to run + containers on your VMs. Learn more at + https://cloud.google.com/compute/docs/containers/migrate-containers. + gcloud compute instance-templates create-with-container creates a Compute Engine virtual machine instance template that runs a container image. To create an instance template named 'instance-template-1' that runs the @@ -720,6 +726,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --stack-type=STACK_TYPE Specifies whether IPv6 is enabled on the default network interface. If not specified, IPV4_ONLY will be used. STACK_TYPE must be one of: diff --git a/gcloud/compute/instance-templates/help b/gcloud/compute/instance-templates/help index a9a2ddf15..9c0ffbd03 100644 --- a/gcloud/compute/instance-templates/help +++ b/gcloud/compute/instance-templates/help @@ -29,8 +29,8 @@ COMMANDS Create a Compute Engine virtual machine instance template. create-with-container - Creates a Compute Engine a virtual machine instance template that runs - a Docker container. + (DEPRECATED) Creates a Compute Engine a virtual machine instance + template that runs a Docker container. delete Delete Compute Engine virtual machine instance templates. diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index 8752e6965..06fa5f99d 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -42,7 +42,8 @@ SYNOPSIS [--resource-manager-tags=[KEY=VALUE,...]] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--target-distribution-shape=SHAPE] [--termination-time=TERMINATION_TIME] @@ -752,6 +753,12 @@ OPTIONAL FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance-template=SOURCE_INSTANCE_TEMPLATE The name of the instance template that the instance will be created from. Users can override fields by specifying other flags. diff --git a/gcloud/compute/instances/create b/gcloud/compute/instances/create index ddcec5daa..1fc3c7e41 100644 --- a/gcloud/compute/instances/create +++ b/gcloud/compute/instances/create @@ -52,7 +52,8 @@ SYNOPSIS [--resource-manager-tags=[KEY=VALUE,...]] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--source-machine-image=SOURCE_MACHINE_IMAGE] [--source-machine-image-csek-key-file=FILE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] @@ -934,6 +935,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance-template=SOURCE_INSTANCE_TEMPLATE The name of the instance template that the instance will be created from. An instance template can be a global/regional resource. diff --git a/gcloud/compute/instances/create-with-container b/gcloud/compute/instances/create-with-container index e6f2d8e7c..3e6d2afe1 100644 --- a/gcloud/compute/instances/create-with-container +++ b/gcloud/compute/instances/create-with-container @@ -52,7 +52,8 @@ SYNOPSIS [--request-valid-for-duration=REQUEST_VALID_FOR_DURATION] [--resource-policies=[RESOURCE_POLICY,...]] [--no-restart-on-failure] [--shielded-integrity-monitoring] [--shielded-secure-boot] - [--shielded-vtpm] [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] + [--shielded-vtpm] [--[no-]skip-guest-os-shutdown] + [--source-instance-template=SOURCE_INSTANCE_TEMPLATE] [--stack-type=STACK_TYPE] [--subnet=SUBNET] [--tags=TAG,[TAG,...]] [--termination-time=TERMINATION_TIME] [--threads-per-core=THREADS_PER_CORE] @@ -72,6 +73,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) The option to deploy a container during VM creation using the + container startup agent is deprecated. Use alternative services to run + containers on your VMs. Learn more at + https://cloud.google.com/compute/docs/containers/migrate-containers. + gcloud compute instances create-with-container creates Compute Engine virtual machines that runs a Docker image. For example: @@ -825,6 +831,12 @@ FLAGS about how to modify Shielded VM options, see https://cloud.google.com/compute/docs/instances/modifying-shielded-vm. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --source-instance-template=SOURCE_INSTANCE_TEMPLATE The name of the instance template that the instance will be created from. An instance template can be a global/regional resource. diff --git a/gcloud/compute/instances/help b/gcloud/compute/instances/help index 17ccb34ef..af787c9de 100644 --- a/gcloud/compute/instances/help +++ b/gcloud/compute/instances/help @@ -65,8 +65,8 @@ COMMANDS Create Compute Engine virtual machine instances. create-with-container - Creates Compute Engine virtual machine instances running container - images. + (DEPRECATED) Creates Compute Engine virtual machine instances running + container images. delete Delete Compute Engine virtual machine instances. @@ -184,8 +184,8 @@ COMMANDS Update a Compute Engine virtual machine access configuration. update-container - Updates Compute Engine virtual machine instances running container - images. + (DEPRECATED) Updates Compute Engine virtual machine instances running + container images. update-from-file Update a Compute Engine virtual machine instance using a configuration diff --git a/gcloud/compute/instances/set-scheduling b/gcloud/compute/instances/set-scheduling index 9acded584..10f6562e7 100644 --- a/gcloud/compute/instances/set-scheduling +++ b/gcloud/compute/instances/set-scheduling @@ -9,7 +9,8 @@ SYNOPSIS [--local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT] [--maintenance-policy=MAINTENANCE_POLICY] [--min-node-cpu=MIN_NODE_CPU] [--[no-]preemptible] [--provisioning-model=PROVISIONING_MODEL] - [--[no-]restart-on-failure] [--zone=ZONE] + [--[no-]restart-on-failure] [--[no-]skip-guest-os-shutdown] + [--zone=ZONE] [--clear-discard-local-ssds-at-termination-timestamp | --discard-local-ssds-at-termination-timestamp=DISCARD_LOCAL_SSDS_AT_TERMINATION_TIMESTAMP] [--clear-instance-termination-action @@ -102,6 +103,12 @@ FLAGS option is mutually exclusive with --preemptible. Use --restart-on-failure to enable and --no-restart-on-failure to disable. + --[no-]skip-guest-os-shutdown + If enabled, then, when the instance is stopped or deleted, the instance + is immediately stopped without giving time to the guest OS to cleanly + shut down. Use --skip-guest-os-shutdown to enable and + --no-skip-guest-os-shutdown to disable. + --zone=ZONE Zone of the instance to operate on. If not specified, you might be prompted to select a zone (interactive mode only). gcloud attempts to diff --git a/gcloud/compute/instances/update-container b/gcloud/compute/instances/update-container index 639bb4f03..dcf32ce83 100644 --- a/gcloud/compute/instances/update-container +++ b/gcloud/compute/instances/update-container @@ -24,6 +24,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION + (DEPRECATED) The option to deploy a container during VM creation using the + container startup agent is deprecated. Use alternative services to run + containers on your VMs. Learn more at + https://cloud.google.com/compute/docs/containers/migrate-containers. + gcloud compute instances update-container updates Compute Engine virtual machines that runs a Docker image. For example: diff --git a/gcloud/eventarc/google-api-sources/create b/gcloud/eventarc/google-api-sources/create index a744521c5..7d70d156c 100644 --- a/gcloud/eventarc/google-api-sources/create +++ b/gcloud/eventarc/google-api-sources/create @@ -8,7 +8,10 @@ SYNOPSIS (--destination-message-bus=DESTINATION_MESSAGE_BUS : --destination-message-bus-project=DESTINATION_MESSAGE_BUS_PROJECT) [--async] [--crypto-key=CRYPTO_KEY] [--labels=[KEY=VALUE,...]] - [--logging-config=LOGGING_CONFIG] [GCLOUD_WIDE_FLAG ...] + [--logging-config=LOGGING_CONFIG] + [--[no-]organization-subscription + | --project-subscriptions=GAS_PROJECT_SUBSCRIPTION,[...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create an Eventarc Google API source. @@ -114,6 +117,16 @@ OPTIONAL FLAGS one of: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. + At most one of these can be specified: + + --[no-]organization-subscription + The organization subscription for the resource. Use + --organization-subscription to enable and + --no-organization-subscription to disable. + + --project-subscriptions=GAS_PROJECT_SUBSCRIPTION,[...] + The project subscriptions for the resource. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/eventarc/google-api-sources/update b/gcloud/eventarc/google-api-sources/update index 85853471b..1555bb519 100644 --- a/gcloud/eventarc/google-api-sources/update +++ b/gcloud/eventarc/google-api-sources/update @@ -8,6 +8,8 @@ SYNOPSIS [--logging-config=LOGGING_CONFIG] [--update-labels=[KEY=VALUE,...]] [--clear-crypto-key | --crypto-key=CRYPTO_KEY] [--clear-labels | --remove-labels=[KEY,...]] + [--clear-project-subscriptions | --[no-]organization-subscription + | --project-subscriptions=GAS_PROJECT_SUBSCRIPTION,[...]] [--destination-message-bus=DESTINATION_MESSAGE_BUS : --destination-message-bus-project=DESTINATION_MESSAGE_BUS_PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -121,6 +123,19 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + At most one of these can be specified: + + --clear-project-subscriptions + Clear the project subscriptions for the resource. + + --[no-]organization-subscription + The organization subscription for the resource. Use + --organization-subscription to enable and + --no-organization-subscription to disable. + + --project-subscriptions=GAS_PROJECT_SUBSCRIPTION,[...] + The project subscriptions for the resource. + Message bus resource - The destination message bus of the Google API source. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this diff --git a/gcloud/iam/workload-identity-pools/create-cred-config b/gcloud/iam/workload-identity-pools/create-cred-config index 0e339277f..c45d89a7c 100644 --- a/gcloud/iam/workload-identity-pools/create-cred-config +++ b/gcloud/iam/workload-identity-pools/create-cred-config @@ -12,7 +12,7 @@ SYNOPSIS [--credential-source-field-name=CREDENTIAL_SOURCE_FIELD_NAME] [--credential-source-headers=[key=value,...]] [--credential-source-type=CREDENTIAL_SOURCE_TYPE] [--enable-imdsv2] - [--subject-token-type=SUBJECT_TOKEN_TYPE] + [--sts-location=STS_LOCATION] [--subject-token-type=SUBJECT_TOKEN_TYPE] [--credential-cert-private-key-path=CREDENTIAL_CERT_PRIVATE_KEY_PATH : --credential-cert-configuration-output-file=CREDENTIAL_CERT_CONFIGURATION_OUTPUT_FILE --credential-cert-trust-chain-path=CREDENTIAL_CERT_TRUST_CHAIN_PATH] [--executable-output-file=EXECUTABLE_OUTPUT_FILE @@ -135,6 +135,12 @@ OPTIONAL FLAGS Adds the AWS IMDSv2 session token Url to the credential source to enforce the AWS IMDSv2 flow. + --sts-location=STS_LOCATION + The location to use for the Security Token Service token endpoint. For + example, specifying us-central1 will configure the client to use the + regional endpoint sts.us-central1.rep.googleapis.com. If not specified, + the global endpoint sts.googleapis.com is used. + --subject-token-type=SUBJECT_TOKEN_TYPE The type of token being used for authorization. This defaults to urn:ietf:params:oauth:token-type:jwt. diff --git a/gcloud/netapp/volumes/create b/gcloud/netapp/volumes/create index 970514834..5111bef78 100644 --- a/gcloud/netapp/volumes/create +++ b/gcloud/netapp/volumes/create @@ -8,6 +8,11 @@ SYNOPSIS [--backup-config=[backup-policies=BACKUP-POLICIES], [backup-vault=BACKUP-VAULT], [enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS]] + [--cache-parameters=[cache-config=CACHE-CONFIG], + [enable-global-file-lock=ENABLE-GLOBAL-FILE-LOCK], + [peer-cluster-name=PEER-CLUSTER-NAME], + [peer-ip-addresses=PEER-IP-ADDRESSES], + [peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME]] [--description=DESCRIPTION] [--enable-kerberos=ENABLE_KERBEROS] [--export-policy=[access-type=ACCESS-TYPE], [allowed-clients=ALLOWED-CLIENTS],[has-root-access=HAS-ROOT-ACCESS], @@ -153,6 +158,24 @@ OPTIONAL FLAGS enable-scheduled-backups is a Boolean value indicating whether or not scheduled backups are enabled on the volume. + --cache-parameters=[cache-config=CACHE-CONFIG],[enable-global-file-lock=ENABLE-GLOBAL-FILE-LOCK],[peer-cluster-name=PEER-CLUSTER-NAME],[peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME] + Cache Parameters contains cache parameters of a volume. + + Cache Parameters will have the following format + `--cache-parameters=peer-volume-name=PEER_VOLUME_NAME, + peer-cluster-name=PEER_CLUSTER_NAME, + peer-svm-name=PEER_SVM_NAME, + peer-ip-addresses=[PEER-IP-ADDRESS1#PEER-IP-ADDRESS2#...], + enable-global-file-lock=ENABLE_GLOBAL_FILE_LOCK, + cache-config=CACHE_CONFIG` + + *peer-volume-name*::: Name of the user's local source volume + *peer-cluster-name*::: Name of the user's local source cluster + *peer-svm-name*::: Name of the user's local source vserver svm + *peer-ip-addresses*::: Hashtag-separated(#) list of IP addresses + *enable-global-file-lock*::: If true, enable global file lock + *cache-config*::: Cache-config as a hashtag-separated(#) list of key-value pairs + --description=DESCRIPTION A description of the Cloud NetApp Volume diff --git a/gcloud/netapp/volumes/help b/gcloud/netapp/volumes/help index 7e366dae6..278e39c58 100644 --- a/gcloud/netapp/volumes/help +++ b/gcloud/netapp/volumes/help @@ -39,6 +39,9 @@ COMMANDS list List Cloud NetApp Volumes. + restore-backup-files + Restore specific files from a backup to a Volume. + revert Revert a Cloud NetApp Volume back to a specified Snapshot. diff --git a/gcloud/netapp/volumes/restore-backup-files b/gcloud/netapp/volumes/restore-backup-files new file mode 100644 index 000000000..1e74907f8 --- /dev/null +++ b/gcloud/netapp/volumes/restore-backup-files @@ -0,0 +1,120 @@ +NAME + gcloud netapp volumes restore-backup-files - restore specific files from a + backup to a Volume + +SYNOPSIS + gcloud netapp volumes restore-backup-files (VOLUME : --location=LOCATION) + --file-list=FILE_LIST,[FILE_LIST,...] + (--backup=BACKUP : --backup_vault=BACKUP_VAULT) [--async] + [--restore-destination-path=RESTORE_DESTINATION_PATH] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Restore specific files from a backup to a Volume + +EXAMPLES + The following command restores file1.txt and file2.txt from the given + backup to a Volume named NAME to the directory + /path/to/destination/directory. + + $ gcloud netapp volumes restore-backup-files NAME \ + --location=us-central1 --backup=backup-1 \ + --file-list=file1.txt,file2.txt \ + --restore-destination-path=/path/to/destination/directory + +POSITIONAL ARGUMENTS + Volume resource - The Volume to restore into. The arguments in this group + can be used to specify the attributes of this 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 volume on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument volume on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the volume. + + To set the location attribute: + ▸ provide the argument volume on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +REQUIRED FLAGS + --file-list=FILE_LIST,[FILE_LIST,...] + List of files to be restored in the form of their absolute path as in + source volume. + + Backup resource - The Backup from which files are restored back to the + Volume. The arguments in this group can be used to specify the attributes + of this 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 --backup 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 --backup on the command line with a fully + specified name; + ◆ set the property netapp/location. + + This must be specified. + + --backup=BACKUP + ID of the backup or fully qualified identifier for the backup. + + To set the backup attribute: + ▸ provide the argument --backup on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --backup_vault=BACKUP_VAULT + The Backup Vault of the backup. + + To set the backup_vault attribute: + ▸ provide the argument --backup on the command line with a fully + specified name; + ▸ provide the argument --backup_vault on the command line; + ▸ provide the argument --backup-vault on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --restore-destination-path=RESTORE_DESTINATION_PATH + Name of the absolute directory path in the destination volume.. + +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 + These variants are also available: + + $ gcloud alpha netapp volumes restore-backup-files + + $ gcloud beta netapp volumes restore-backup-files + diff --git a/gcloud/netapp/volumes/update b/gcloud/netapp/volumes/update index 4c29dd167..83d78a98a 100644 --- a/gcloud/netapp/volumes/update +++ b/gcloud/netapp/volumes/update @@ -6,6 +6,11 @@ SYNOPSIS [--backup-config=[backup-policies=BACKUP-POLICIES], [backup-vault=BACKUP-VAULT], [enable-scheduled-backups=ENABLE-SCHEDULED-BACKUPS]] + [--cache-parameters=[cache-config=CACHE-CONFIG], + [enable-global-file-lock=ENABLE-GLOBAL-FILE-LOCK], + [peer-cluster-name=PEER-CLUSTER-NAME], + [peer-ip-addresses=PEER-IP-ADDRESSES], + [peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME]] [--capacity=CAPACITY] [--description=DESCRIPTION] [--enable-kerberos=ENABLE_KERBEROS] [--export-policy=[access-type=ACCESS-TYPE], @@ -100,6 +105,24 @@ FLAGS enable-scheduled-backups is a Boolean value indicating whether or not scheduled backups are enabled on the volume. + --cache-parameters=[cache-config=CACHE-CONFIG],[enable-global-file-lock=ENABLE-GLOBAL-FILE-LOCK],[peer-cluster-name=PEER-CLUSTER-NAME],[peer-ip-addresses=PEER-IP-ADDRESSES],[peer-svm-name=PEER-SVM-NAME],[peer-volume-name=PEER-VOLUME-NAME] + Cache Parameters contains cache parameters of a volume. + + Cache Parameters will have the following format + `--cache-parameters=peer-volume-name=PEER_VOLUME_NAME, + peer-cluster-name=PEER_CLUSTER_NAME, + peer-svm-name=PEER_SVM_NAME, + peer-ip-addresses=[PEER-IP-ADDRESS1#PEER-IP-ADDRESS2#...], + enable-global-file-lock=ENABLE_GLOBAL_FILE_LOCK, + cache-config=CACHE_CONFIG` + + *peer-volume-name*::: Name of the user's local source volume + *peer-cluster-name*::: Name of the user's local source cluster + *peer-svm-name*::: Name of the user's local source vserver svm + *peer-ip-addresses*::: Hashtag-separated(#) list of IP addresses + *enable-global-file-lock*::: If true, enable global file lock + *cache-config*::: Cache-config as a hashtag-separated(#) list of key-value pairs + --capacity=CAPACITY The desired capacity of the Volume in GiB or TiB units.If no capacity unit is specified, GiB is assumed. diff --git a/gcloud/network-management/vpc-flow-logs-configs/create b/gcloud/network-management/vpc-flow-logs-configs/create index b8eb096ad..739b250e3 100644 --- a/gcloud/network-management/vpc-flow-logs-configs/create +++ b/gcloud/network-management/vpc-flow-logs-configs/create @@ -1,52 +1,90 @@ NAME gcloud network-management vpc-flow-logs-configs create - creates a new VPC - Flow Logs configuration in the specified project + Flow Logs configuration SYNOPSIS gcloud network-management vpc-flow-logs-configs create - (VPC_FLOW_LOGS_CONFIG : --location=LOCATION) + (VPC_FLOW_LOGS_CONFIG + : --location=LOCATION --organization=ORGANIZATION) [--aggregation-interval=AGGREGATION_INTERVAL] [--async] + [--cross-project-metadata=CROSS_PROJECT_METADATA] [--description=DESCRIPTION] [--filter-expr=FILTER_EXPR] [--flow-sampling=FLOW_SAMPLING] [--labels=[LABELS,...]] [--metadata=METADATA] [--metadata-fields=[METADATA_FIELDS,...]] [--state=STATE] - [--interconnect-attachment=INTERCONNECT_ATTACHMENT - | --vpn-tunnel=VPN_TUNNEL] [GCLOUD_WIDE_FLAG ...] + [--interconnect-attachment=INTERCONNECT_ATTACHMENT | --network=NETWORK + | --subnet=SUBNET | --vpn-tunnel=VPN_TUNNEL] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Creates a new VPC Flow Logs configuration in the specified project. The - target-resource project must be the same as the configuration project. + Creates a new VPC Flow Logs configuration. + + Project-level configuration: Specify a target resource, either: --subnet, + --network, --interconnect-attachment, or --vpn-tunnel + + Organization-level configuration: Specify the --organization flag without a + target resource to apply the configuration across an entire organization. + + The --location=global flag is always required. EXAMPLES + To create a new VPC Flow Logs configuration my-config in organization + my-org-number, run: + + $ gcloud network-management vpc-flow-logs-configs create my-config \ + --location=global --organization= + To create a new VPC Flow Logs configuration my-config in project my-project for a VLAN attachment for Cloud Interconnect, run: $ gcloud network-management vpc-flow-logs-configs create my-config \ --location=global \ - --interconnect-attachment="projects/my-project/regions/{region}/\ - interconnectAttachments/{interconnect_attachment_id}" + --interconnect-attachment="projects/{project_id}/regions/{region\ + }/interconnectAttachments/{interconnect_attachment_id}" To create a new VPC Flow Logs configuration my-config in project my-project for a Cloud VPN tunnel, run: $ gcloud network-management vpc-flow-logs-configs create my-config \ --location=global \ - --vpn-tunnel="projects/my-project/regions/{region}/vpnTunnels/{v\ - pn_tunnel_id}" + --subnet="projects/{project_id}/regions/{region}/vpnTunnels/{vpn\ + _tunnel_id}" + + To create a new VPC Flow Logs configuration my-config in project my-project + for a subnet, run: + + $ gcloud network-management vpc-flow-logs-configs create my-config \ + --location=global \ + --subnet="projects/{project_id}/regions/{region}/subnets/{subnet\ + _id}" + + To create a new VPC Flow Logs configuration my-config in project my-project + for a VPC network, run: + + $ gcloud network-management vpc-flow-logs-configs create my-config \ + --location=global \ + --network="projects/{project_id}/global/networks/{network_id}" POSITIONAL ARGUMENTS - VpcFlowLogsConfig resource - Identifier. Unique name of the configuration - using the form: - projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} - The arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + VpcFlowLogsConfig resource - Identifier. Unique name of the configuration. + The name can have one of the following forms: + + ◆ For project-level configurations: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + + ◆ For organization-level configurations: + organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + The arguments in this group can be used to specify the attributes of + this 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 vpc_flow_logs_config on the command line with a fully specified name; ◆ provide the argument --project on the command line; - ◆ set the property core/project. + ◆ set the property core/project. This resource can be one of the + following types: + [networkmanagement.organizations.locations.vpcFlowLogsConfigs, + networkmanagement.projects.locations.vpcFlowLogsConfigs]. This must be specified. @@ -68,6 +106,16 @@ POSITIONAL ARGUMENTS with a fully specified name; ▸ provide the argument --location on the command line. + --organization=ORGANIZATION + The organization id of the vpcFlowLogsConfig resource. + + To set the organization attribute: + ▸ provide the argument vpc_flow_logs_config on the command line + with a fully specified name; + ▸ provide the argument --organization on the command line. Must be + specified for resource of type + [networkmanagement.organizations.locations.vpcFlowLogsConfigs]. + FLAGS Arguments for the aggregation interval. @@ -92,6 +140,22 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + Arguments for the cross project metadata. + + --cross-project-metadata=CROSS_PROJECT_METADATA + Determines whether to include cross project annotations in the logs. + This field is available only for organization configurations. If not + specified in org configs will be set to + CROSS_PROJECT_METADATA_ENABLED. CROSS_PROJECT_METADATA must be one + of: + + cross-project-metadata-disabled + When CROSS_PROJECT_METADATA_DISABLED, metadata from other + projects will not be included in the logs. + cross-project-metadata-enabled + When CROSS_PROJECT_METADATA_ENABLED, metadata from other projects + will be included in the logs. + Arguments for the description. --description=DESCRIPTION @@ -156,8 +220,9 @@ FLAGS --state=STATE The state of the VPC Flow Log configuration. Default value is - ENABLED. When creating a new configuration, it must be enabled. STATE - must be one of: + ENABLED. When creating a new configuration, it must be enabled. + Setting state=DISABLED will pause the log generation for this config. + STATE must be one of: disabled When DISABLED, this configuration will not generate logs. @@ -172,6 +237,15 @@ FLAGS Traffic will be logged from the Interconnect Attachment. Format: projects/{project_id}/regions/{region}/interconnectAttachments/{name} + --network=NETWORK + Traffic will be logged from VMs, VPN tunnels and Interconnect + Attachments within the network. Format: + projects/{project_id}/global/networks/{name} + + --subnet=SUBNET + Traffic will be logged from VMs within the subnetwork. Format: + projects/{project_id}/regions/{region}/subnetworks/{name} + --vpn-tunnel=VPN_TUNNEL Traffic will be logged from the VPN Tunnel. Format: projects/{project_id}/regions/{region}/vpnTunnels/{name} diff --git a/gcloud/network-management/vpc-flow-logs-configs/delete b/gcloud/network-management/vpc-flow-logs-configs/delete index eb48406f0..95fcbc72a 100644 --- a/gcloud/network-management/vpc-flow-logs-configs/delete +++ b/gcloud/network-management/vpc-flow-logs-configs/delete @@ -4,31 +4,46 @@ NAME SYNOPSIS gcloud network-management vpc-flow-logs-configs delete - (VPC_FLOW_LOGS_CONFIG : --location=LOCATION) [--async] + (VPC_FLOW_LOGS_CONFIG + : --location=LOCATION --organization=ORGANIZATION) [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Deletes the specified VPC Flow Logs configuration. EXAMPLES + To delete a VPC Flow Logs configuration my-config within the organization + my-org-number, run: + + $ gcloud network-management vpc-flow-logs-configs delete my-config \ + --location=global --organization= + To delete a VPC Flow Logs configuration my-config, run: $ gcloud network-management vpc-flow-logs-configs delete my-config \ --location=global POSITIONAL ARGUMENTS - VpcFlowLogsConfig resource - VpcFlowLogsConfig resource name using the - form: - projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config} - The arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + VpcFlowLogsConfig resource - The resource name of the VpcFlowLogsConfig, + in one of the following formats: + + ◆ For a project-level resource: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + + ◆ For an organization-level resource: + organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + The arguments in this group can be used to specify the attributes of + this 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 vpc_flow_logs_config on the command line with a fully specified name; ◆ provide the argument --project on the command line; - ◆ set the property core/project. + ◆ set the property core/project. This resource can be one of the + following types: + [networkmanagement.organizations.locations.vpcFlowLogsConfigs, + networkmanagement.projects.locations.vpcFlowLogsConfigs]. This must be specified. @@ -50,6 +65,16 @@ POSITIONAL ARGUMENTS with a fully specified name; ▸ provide the argument --location on the command line. + --organization=ORGANIZATION + The organization id of the vpcFlowLogsConfig resource. + + To set the organization attribute: + ▸ provide the argument vpc_flow_logs_config on the command line + with a fully specified name; + ▸ provide the argument --organization on the command line. Must be + specified for resource of type + [networkmanagement.organizations.locations.vpcFlowLogsConfigs]. + FLAGS --async Return immediately, without waiting for the operation in progress to diff --git a/gcloud/network-management/vpc-flow-logs-configs/describe b/gcloud/network-management/vpc-flow-logs-configs/describe index c87b45573..62622fa96 100644 --- a/gcloud/network-management/vpc-flow-logs-configs/describe +++ b/gcloud/network-management/vpc-flow-logs-configs/describe @@ -4,30 +4,46 @@ NAME SYNOPSIS gcloud network-management vpc-flow-logs-configs describe - (VPC_FLOW_LOGS_CONFIG : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + (VPC_FLOW_LOGS_CONFIG + : --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Describes the details of a specific VPC Flow Logs configuration. EXAMPLES + To get the details of a VPC Flow Logs configuration my-config, within the + organization my-org-number, run: + + $ gcloud network-management vpc-flow-logs-configs describe \ + my-config --location=global --organization= + To get the details of a VPC Flow Logs configuration my-config, run: $ gcloud network-management vpc-flow-logs-configs describe \ my-config --location=global POSITIONAL ARGUMENTS - VpcFlowLogsConfig resource - VpcFlowLogsConfig resource name using the - form: - projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config} - The arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + VpcFlowLogsConfig resource - The resource name of the VpcFlowLogsConfig, + in one of the following formats: + + ◆ For project-level resources: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + + ◆ For organization-level resources: + organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + The arguments in this group can be used to specify the attributes of + this 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 vpc_flow_logs_config on the command line with a fully specified name; ◆ provide the argument --project on the command line; - ◆ set the property core/project. + ◆ set the property core/project. This resource can be one of the + following types: + [networkmanagement.organizations.locations.vpcFlowLogsConfigs, + networkmanagement.projects.locations.vpcFlowLogsConfigs]. This must be specified. @@ -49,6 +65,16 @@ POSITIONAL ARGUMENTS with a fully specified name; ▸ provide the argument --location on the command line. + --organization=ORGANIZATION + The organization id of the vpcFlowLogsConfig resource. + + To set the organization attribute: + ▸ provide the argument vpc_flow_logs_config on the command line + with a fully specified name; + ▸ provide the argument --organization on the command line. Must be + specified for resource of type + [networkmanagement.organizations.locations.vpcFlowLogsConfigs]. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/network-management/vpc-flow-logs-configs/help b/gcloud/network-management/vpc-flow-logs-configs/help index bf8f659fd..b360d2b39 100644 --- a/gcloud/network-management/vpc-flow-logs-configs/help +++ b/gcloud/network-management/vpc-flow-logs-configs/help @@ -9,6 +9,9 @@ SYNOPSIS DESCRIPTION The flag --location=global is required for all the commands. + You can either specify resources for project-level configurations, or use + the --organization flag to apply organization-level configurations. + GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -18,7 +21,7 @@ COMMANDS COMMAND is one of the following: create - Creates a new VPC Flow Logs configuration in the specified project. + Creates a new VPC Flow Logs configuration. delete Deletes the specified VPC Flow Logs configuration. @@ -27,7 +30,14 @@ COMMANDS Describe the details of a specific VPC Flow Logs configuration. list - List all VPC Flow Logs configurations in the project. + List all VPC Flow Logs configurations. + + query-org-vpc-flow-logs-configs + Fetch all organization-level VPC Flow Logs configurations associated + with the project. + + show-effective-flow-logs-configs + Show all effective VPC Flow Logs configurations for a resource. update Updates one or more fields in an existing VPC Flow Logs configuration. diff --git a/gcloud/network-management/vpc-flow-logs-configs/list b/gcloud/network-management/vpc-flow-logs-configs/list index 11d7a2cff..d7a48181e 100644 --- a/gcloud/network-management/vpc-flow-logs-configs/list +++ b/gcloud/network-management/vpc-flow-logs-configs/list @@ -1,14 +1,16 @@ NAME gcloud network-management vpc-flow-logs-configs list - list all VPC Flow - Logs configurations in the project + Logs configurations SYNOPSIS - gcloud network-management vpc-flow-logs-configs list --location=LOCATION + gcloud network-management vpc-flow-logs-configs list + (--location=LOCATION : --organization=ORGANIZATION) [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Lists all VPC Flow Logs configurations in the project. + By default, lists all project-level VPC Flow Logs configurations. Use the + --organization flag to list all organization-level configurations. EXAMPLES To list all the VPC Flow Logs configurations within the project, run: @@ -23,16 +25,24 @@ EXAMPLES --location=global --filter="state:ENABLED" REQUIRED FLAGS - Location resource - The parent resource of the VpcFlowLogsConfig: - projects/{project_id}/locations/global This represents a Cloud resource. - (NOTE) Some attributes are not given arguments in this group but can be - set in other ways. + Location resource - The parent resource of the VpcFlowLogsConfig, in one + of the following formats: + + ◆ For project-level resourcs: projects/{project_id}/locations/global + + ◆ For organization-level resources: + organizations/{organization_id}/locations/global The arguments in this + group can be used to specify the attributes of this 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 --location on the command line with a fully specified name; ◆ provide the argument --project on the command line; - ◆ set the property core/project. + ◆ set the property core/project. This resource can be one of the + following types: [networkmanagement.organizations.locations, + networkmanagement.projects.locations]. This must be specified. @@ -42,6 +52,19 @@ REQUIRED FLAGS To set the location attribute: ▸ provide the argument --location on the command line. + This flag argument must be specified if any of the other arguments in + this group are specified. + + --organization=ORGANIZATION + The organization id of the location resource. + + To set the organization attribute: + ▸ provide the argument --location on the command line with a fully + specified name; + ▸ provide the argument --organization on the command line. Must be + specified for resource of type + [networkmanagement.organizations.locations]. + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/network-management/vpc-flow-logs-configs/query-org-vpc-flow-logs-configs b/gcloud/network-management/vpc-flow-logs-configs/query-org-vpc-flow-logs-configs new file mode 100644 index 000000000..340ed4283 --- /dev/null +++ b/gcloud/network-management/vpc-flow-logs-configs/query-org-vpc-flow-logs-configs @@ -0,0 +1,86 @@ +NAME + gcloud network-management vpc-flow-logs-configs + query-org-vpc-flow-logs-configs - fetch all organization-level VPC Flow + Logs configurations associated with the project + +SYNOPSIS + gcloud network-management vpc-flow-logs-configs + query-org-vpc-flow-logs-configs --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Fetch all organization-level VPC Flow Logs configurations that the project + is associated with. This method allows you to retrieve which + organization-level configurations are applied to the current project. + +EXAMPLES + To fetch all the organization-level VPC Flow Logs configurations associated + with the project, run: + + $ gcloud network-management vpc-flow-logs-configs \ query-org-vpc-flow-logs-configs --location=global + +REQUIRED FLAGS + Location resource - The parent resource of the VpcFlowLogsConfig, + specified in the following format: projects/{project_id}/locations/global + 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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 networkmanagement/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/ + +NOTES + This variant is also available: + + $ gcloud beta network-management vpc-flow-logs-configs \ + query-org-vpc-flow-logs-configs + diff --git a/gcloud/network-management/vpc-flow-logs-configs/show-effective-flow-logs-configs b/gcloud/network-management/vpc-flow-logs-configs/show-effective-flow-logs-configs new file mode 100644 index 000000000..f52d341bc --- /dev/null +++ b/gcloud/network-management/vpc-flow-logs-configs/show-effective-flow-logs-configs @@ -0,0 +1,94 @@ +NAME + gcloud network-management vpc-flow-logs-configs + show-effective-flow-logs-configs - show all effective VPC Flow Logs + configurations for a resource + +SYNOPSIS + gcloud network-management vpc-flow-logs-configs + show-effective-flow-logs-configs --location=LOCATION + --resource=RESOURCE [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Shows all effective VPC Flow Logs configurations for a resource. The + effective configurations include all configurations that apply to the + resource, including inherited ones from parent resources. + +EXAMPLES + To show all effective VPC Flow Logs configurations for a network my-network + in project my-project, run: + + $ gcloud network-management vpc-flow-logs-configs \ + show-effective-flow-logs-configs --location=global \ + --resource="projects/my-project/global/networks/my-network" + +REQUIRED FLAGS + Location resource - The parent resource of the VpcFlowLogsConfig, + specified in the following format: projects/{project_id}/locations/global + 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + + --resource=RESOURCE + The resource to get the effective VPC Flow Logs configuration for. The + resource must belong to the same project as the parent. The resource + must be a network, subnetwork, interconnect attachment, VPN tunnel, or + a project. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + +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 networkmanagement/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/ + +NOTES + This variant is also available: + + $ gcloud beta network-management vpc-flow-logs-configs \ + show-effective-flow-logs-configs + diff --git a/gcloud/network-management/vpc-flow-logs-configs/update b/gcloud/network-management/vpc-flow-logs-configs/update index 4f26d40fb..ab106ebcd 100644 --- a/gcloud/network-management/vpc-flow-logs-configs/update +++ b/gcloud/network-management/vpc-flow-logs-configs/update @@ -4,12 +4,14 @@ NAME SYNOPSIS gcloud network-management vpc-flow-logs-configs update - (VPC_FLOW_LOGS_CONFIG : --location=LOCATION) + (VPC_FLOW_LOGS_CONFIG + : --location=LOCATION --organization=ORGANIZATION) [--aggregation-interval=AGGREGATION_INTERVAL] [--async] + [--cross-project-metadata=CROSS_PROJECT_METADATA] [--description=DESCRIPTION] [--filter-expr=FILTER_EXPR] [--flow-sampling=FLOW_SAMPLING] [--metadata=METADATA] [--state=STATE] - [--interconnect-attachment=INTERCONNECT_ATTACHMENT - | --vpn-tunnel=VPN_TUNNEL] + [--interconnect-attachment=INTERCONNECT_ATTACHMENT | --network=NETWORK + | --subnet=SUBNET | --vpn-tunnel=VPN_TUNNEL] [--labels=[LABELS,...] | --update-labels=[UPDATE_LABELS,...] --clear-labels | --remove-labels=REMOVE_LABELS] @@ -23,6 +25,13 @@ DESCRIPTION Updates one or more fields in an existing VPC Flow Logs configuration. EXAMPLES + To update the state field to be 'DISABLED' in the VPC Flow Logs + configuration my-config, run: + + $ gcloud network-management vpc-flow-logs-configs update my-config \ + --location=global --organization= \ + --state=DISABLED + To update the state field to be 'DISABLED' in the VPC Flow Logs configuration my-config, run: @@ -30,18 +39,26 @@ EXAMPLES --location=global --state=DISABLED POSITIONAL ARGUMENTS - VpcFlowLogsConfig resource - Identifier. Unique name of the configuration - using the form: - projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} - The arguments in this group can be used to specify the attributes of this - resource. (NOTE) Some attributes are not given arguments in this group but - can be set in other ways. + VpcFlowLogsConfig resource - Identifier. Unique name of the configuration. + The name can have one of the following forms: + + ◆ For project-level configurations: + projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + + ◆ For organization-level configurations: + organizations/{organization_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id} + The arguments in this group can be used to specify the attributes of + this 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 vpc_flow_logs_config on the command line with a fully specified name; ◆ provide the argument --project on the command line; - ◆ set the property core/project. + ◆ set the property core/project. This resource can be one of the + following types: + [networkmanagement.organizations.locations.vpcFlowLogsConfigs, + networkmanagement.projects.locations.vpcFlowLogsConfigs]. This must be specified. @@ -63,6 +80,16 @@ POSITIONAL ARGUMENTS with a fully specified name; ▸ provide the argument --location on the command line. + --organization=ORGANIZATION + The organization id of the vpcFlowLogsConfig resource. + + To set the organization attribute: + ▸ provide the argument vpc_flow_logs_config on the command line + with a fully specified name; + ▸ provide the argument --organization on the command line. Must be + specified for resource of type + [networkmanagement.organizations.locations.vpcFlowLogsConfigs]. + FLAGS Arguments for the aggregation interval. @@ -87,6 +114,22 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + Arguments for the cross project metadata. + + --cross-project-metadata=CROSS_PROJECT_METADATA + Determines whether to include cross project annotations in the logs. + This field is available only for organization configurations. If not + specified in org configs will be set to + CROSS_PROJECT_METADATA_ENABLED. CROSS_PROJECT_METADATA must be one + of: + + cross-project-metadata-disabled + When CROSS_PROJECT_METADATA_DISABLED, metadata from other + projects will not be included in the logs. + cross-project-metadata-enabled + When CROSS_PROJECT_METADATA_ENABLED, metadata from other projects + will be included in the logs. + Arguments for the description. --description=DESCRIPTION @@ -124,8 +167,9 @@ FLAGS --state=STATE The state of the VPC Flow Log configuration. Default value is - ENABLED. When creating a new configuration, it must be enabled. STATE - must be one of: + ENABLED. When creating a new configuration, it must be enabled. + Setting state=DISABLED will pause the log generation for this config. + STATE must be one of: disabled When DISABLED, this configuration will not generate logs. @@ -140,6 +184,15 @@ FLAGS Traffic will be logged from the Interconnect Attachment. Format: projects/{project_id}/regions/{region}/interconnectAttachments/{name} + --network=NETWORK + Traffic will be logged from VMs, VPN tunnels and Interconnect + Attachments within the network. Format: + projects/{project_id}/global/networks/{name} + + --subnet=SUBNET + Traffic will be logged from VMs within the subnetwork. Format: + projects/{project_id}/regions/{region}/subnetworks/{name} + --vpn-tunnel=VPN_TUNNEL Traffic will be logged from the VPN Tunnel. Format: projects/{project_id}/regions/{region}/vpnTunnels/{name} diff --git a/gcloud/oracle-database/autonomous-databases/failover b/gcloud/oracle-database/autonomous-databases/failover new file mode 100644 index 000000000..b27a7b596 --- /dev/null +++ b/gcloud/oracle-database/autonomous-databases/failover @@ -0,0 +1,98 @@ +NAME + gcloud oracle-database autonomous-databases failover - failovers a standby + AutonomousDatabase to a new primary + +SYNOPSIS + gcloud oracle-database autonomous-databases failover AUTONOMOUS_DATABASE + --peer-autonomous-database=PEER_AUTONOMOUS_DATABASE [--async] + [--location=LOCATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Failovers an AutonomousDatabase from a standby database to a new primary. + +EXAMPLES + To failover an AutonomousDatabase with id my-instance in the location + us-east4 with primary database name as + 'projects/project-id/locations/us-west3/autonomousDatabases/my-peer-instance' + run: + + $ gcloud oracle-database autonomous-databases failover my-instance \ + --location=us-east4 \ + --peer-autonomous-database=projects/project-id/locations/\ + us-west3/autonomousDatabases/my-peer-instance + +POSITIONAL ARGUMENTS + AutonomousDatabase resource - The name of the Autonomous Database in the + following format: + projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}. + 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 autonomous_database 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 autonomous_database on the command line with a + fully specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + AUTONOMOUS_DATABASE + ID of the autonomousDatabase or fully qualified identifier for the + autonomousDatabase. + + To set the autonomous_database attribute: + ▸ provide the argument autonomous_database on the command line. + +REQUIRED FLAGS + AutonomousDatabase resource - The peer database name to fail over to. 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 --peer-autonomous-database 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 --peer-autonomous-database on the command line + with a fully specified name; + ◆ provide the argument --location on the command line. + + This must be specified. + + --peer-autonomous-database=PEER_AUTONOMOUS_DATABASE + ID of the autonomousDatabase or fully qualified identifier for the + autonomousDatabase. + + To set the autonomous-database attribute: + ▸ provide the argument --peer-autonomous-database on the command + line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --location=LOCATION + For resources [autonomous_database, peer-autonomous-database], provides + fallback value for resource location attribute. When the resource's + full URI path is not provided, location will fallback to this flag + value. + +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 diff --git a/gcloud/oracle-database/autonomous-databases/help b/gcloud/oracle-database/autonomous-databases/help index a65c79131..f3d30cfa2 100644 --- a/gcloud/oracle-database/autonomous-databases/help +++ b/gcloud/oracle-database/autonomous-databases/help @@ -25,6 +25,9 @@ COMMANDS describe Get details of an AutonomousDatabase. + failover + Failovers a standby AutonomousDatabase to a new primary. + generate-wallet Generate wallet for an AutonomousDatabase. diff --git a/gcloud/oracle-database/database-character-sets/help b/gcloud/oracle-database/database-character-sets/help new file mode 100644 index 000000000..b2ff29937 --- /dev/null +++ b/gcloud/oracle-database/database-character-sets/help @@ -0,0 +1,21 @@ +NAME + gcloud oracle-database database-character-sets - manage Database Character + Set resources + +SYNOPSIS + gcloud oracle-database database-character-sets COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Database Character Set resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List all DatabaseCharacterSets. diff --git a/gcloud/oracle-database/database-character-sets/list b/gcloud/oracle-database/database-character-sets/list new file mode 100644 index 000000000..2efd44d8d --- /dev/null +++ b/gcloud/oracle-database/database-character-sets/list @@ -0,0 +1,82 @@ +NAME + gcloud oracle-database database-character-sets list - list all + DatabaseCharacterSets + +SYNOPSIS + gcloud oracle-database database-character-sets list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all DatabaseCharacterSets. + +EXAMPLES + To list all DatabaseCharacterSets in the location us-east4 for character + set character-set, run: + + $ gcloud oracle-database database-character-sets list \ + --location=us-east4 --filter="character_set_type=character-set" + +REQUIRED FLAGS + Location resource - The parent value for DatabaseCharacterSets in the + following format: projects/{project}/locations/{location}. 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 diff --git a/gcloud/oracle-database/databases/describe b/gcloud/oracle-database/databases/describe new file mode 100644 index 000000000..56ac2f8e3 --- /dev/null +++ b/gcloud/oracle-database/databases/describe @@ -0,0 +1,60 @@ +NAME + gcloud oracle-database databases describe - get details of a Database + +SYNOPSIS + gcloud oracle-database databases describe (DATABASE : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details of a Database. + +EXAMPLES + To get a Database with id my-database in the location us-east4 for a given + DbSystem with id my-db-system, run: + + $ gcloud oracle-database databases describe my-database \ + --location=us-east4 + +POSITIONAL ARGUMENTS + Database resource - The name of the Database resource in the following + format: projects/{project}/locations/{region}/databases/{database} The + arguments in this group can be used to specify the attributes of this + 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 database on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + DATABASE + ID of the database or fully qualified identifier for the database. + + To set the database attribute: + ▸ provide the argument database on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the database resource. + + To set the location attribute: + ▸ provide the argument database on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +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 diff --git a/gcloud/oracle-database/databases/help b/gcloud/oracle-database/databases/help new file mode 100644 index 000000000..8067c861f --- /dev/null +++ b/gcloud/oracle-database/databases/help @@ -0,0 +1,22 @@ +NAME + gcloud oracle-database databases - manage Database resources + +SYNOPSIS + gcloud oracle-database databases COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Database resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Get details of a Database. + + list + List all Databases. diff --git a/gcloud/oracle-database/databases/list b/gcloud/oracle-database/databases/list new file mode 100644 index 000000000..436efe911 --- /dev/null +++ b/gcloud/oracle-database/databases/list @@ -0,0 +1,82 @@ +NAME + gcloud oracle-database databases list - list all Databases + +SYNOPSIS + gcloud oracle-database databases list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all Databases. + +EXAMPLES + To list all Databases in the location us-east4 for a given DbSystem with id + my-db-system, run: + + $ gcloud oracle-database databases list --location=us-east4 \ + --filter="dbSystem=projects/project-id/locations/us-east4/dbSyst\ + ems/my-db-system" + +REQUIRED FLAGS + Location resource - The parent resource name in the following format: + projects/{project}/locations/{region} 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 diff --git a/gcloud/oracle-database/db-system-initial-storage-sizes/help b/gcloud/oracle-database/db-system-initial-storage-sizes/help new file mode 100644 index 000000000..0c0039d0b --- /dev/null +++ b/gcloud/oracle-database/db-system-initial-storage-sizes/help @@ -0,0 +1,21 @@ +NAME + gcloud oracle-database db-system-initial-storage-sizes - manage Db System + Initial Storage Size resources + +SYNOPSIS + gcloud oracle-database db-system-initial-storage-sizes COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Db System Initial Storage Size resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List all DbSystemInitialStorageSizes. diff --git a/gcloud/oracle-database/db-system-initial-storage-sizes/list b/gcloud/oracle-database/db-system-initial-storage-sizes/list new file mode 100644 index 000000000..32cdc98ee --- /dev/null +++ b/gcloud/oracle-database/db-system-initial-storage-sizes/list @@ -0,0 +1,82 @@ +NAME + gcloud oracle-database db-system-initial-storage-sizes list - list all + DbSystemInitialStorageSizes + +SYNOPSIS + gcloud oracle-database db-system-initial-storage-sizes list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all DbSystemInitialStorageSizes. + +EXAMPLES + To list all DbSystemInitialStorageSizes in the location us-east4, run: + + $ gcloud oracle-database db-system-initial-storage-sizes list \ + --location=us-east4 + +REQUIRED FLAGS + Location resource - The parent value for the DbSystemInitialStorageSize + resource with the format: projects/{project}/locations/{location} 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 diff --git a/gcloud/oracle-database/db-systems/create b/gcloud/oracle-database/db-systems/create new file mode 100644 index 000000000..61c25326c --- /dev/null +++ b/gcloud/oracle-database/db-systems/create @@ -0,0 +1,461 @@ +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 diff --git a/gcloud/oracle-database/db-systems/delete b/gcloud/oracle-database/db-systems/delete new file mode 100644 index 000000000..4a00dab4c --- /dev/null +++ b/gcloud/oracle-database/db-systems/delete @@ -0,0 +1,74 @@ +NAME + gcloud oracle-database db-systems delete - delete a DbSystem + +SYNOPSIS + gcloud oracle-database db-systems delete (DB_SYSTEM : --location=LOCATION) + [--async] [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a DbSystem. + +EXAMPLES + To delete a DbSystem with id my-db-system in the location us-east4, run: + + $ gcloud oracle-database db-systems delete my-db-system \ + --location=us-east4 + +POSITIONAL ARGUMENTS + DbSystem resource - The name of the DbSystem in the following format: + projects/{project}/locations/{location}/dbSystems/{db_system}. The + arguments in this group can be used to specify the attributes of this + 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the dbSystem resource. + + 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. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --request-id=REQUEST_ID + An optional ID to identify the request. This value is used to identify + duplicate requests. If you make a request with the same request ID and + the original request is still in progress or completed, the server + ignores 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). + +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 diff --git a/gcloud/oracle-database/db-systems/describe b/gcloud/oracle-database/db-systems/describe new file mode 100644 index 000000000..b09b46e42 --- /dev/null +++ b/gcloud/oracle-database/db-systems/describe @@ -0,0 +1,59 @@ +NAME + gcloud oracle-database db-systems describe - get details of a DbSystem + +SYNOPSIS + gcloud oracle-database db-systems describe + (DB_SYSTEM : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details of a DbSystem. + +EXAMPLES + To get a DbSystem with id my-db-system in the location us-east4, run: + + $ gcloud oracle-database db-systems describe my-db-system \ + --location=us-east4 + +POSITIONAL ARGUMENTS + DbSystem resource - The name of the DbSystem in the following format: + projects/{project}/locations/{location}/dbSystems/{db_system}. The + arguments in this group can be used to specify the attributes of this + 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the dbSystem resource. + + 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. + +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 diff --git a/gcloud/oracle-database/db-systems/help b/gcloud/oracle-database/db-systems/help new file mode 100644 index 000000000..8139894a6 --- /dev/null +++ b/gcloud/oracle-database/db-systems/help @@ -0,0 +1,28 @@ +NAME + gcloud oracle-database db-systems - manage Db System resources + +SYNOPSIS + gcloud oracle-database db-systems COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Db System resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a new DbSystem. + + delete + Delete a DbSystem. + + describe + Get details of a DbSystem. + + list + List all DbSystems. diff --git a/gcloud/oracle-database/db-systems/list b/gcloud/oracle-database/db-systems/list new file mode 100644 index 000000000..1e4aa8db2 --- /dev/null +++ b/gcloud/oracle-database/db-systems/list @@ -0,0 +1,80 @@ +NAME + gcloud oracle-database db-systems list - list all DbSystems + +SYNOPSIS + gcloud oracle-database db-systems list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all DbSystems. + +EXAMPLES + To list all DbSystems in the location us-east4 for a given DbSystem with id + my-db-system, run: + + $ gcloud oracle-database db-systems list --location=us-east4 + +REQUIRED FLAGS + Location resource - The parent value for DbSystems in the following + format: projects/{project}/locations/{location}. 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 diff --git a/gcloud/oracle-database/db-versions/help b/gcloud/oracle-database/db-versions/help new file mode 100644 index 000000000..e2a7f7213 --- /dev/null +++ b/gcloud/oracle-database/db-versions/help @@ -0,0 +1,19 @@ +NAME + gcloud oracle-database db-versions - manage Db Version resources + +SYNOPSIS + gcloud oracle-database db-versions COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Db Version resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + list + List all DbVersions. diff --git a/gcloud/oracle-database/db-versions/list b/gcloud/oracle-database/db-versions/list new file mode 100644 index 000000000..b4e833620 --- /dev/null +++ b/gcloud/oracle-database/db-versions/list @@ -0,0 +1,82 @@ +NAME + gcloud oracle-database db-versions list - list all DbVersions + +SYNOPSIS + gcloud oracle-database db-versions list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all DbVersions. + +EXAMPLES + To list all DbVersions for a given DbSystemShape and StorageManagement with + db-system-shape and storage-management in the location us-east4, run: + + $ gcloud oracle-database db-versions list --location=us-east4 \ + --filter="db-system-shape=db-system-shape AND \ + storage-management=storage-management" + +REQUIRED FLAGS + Location resource - The parent value for the DbVersion resource with the + format: projects/{project}/locations/{location} 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 diff --git a/gcloud/oracle-database/help b/gcloud/oracle-database/help index 61c74469d..654d0456f 100644 --- a/gcloud/oracle-database/help +++ b/gcloud/oracle-database/help @@ -33,9 +33,24 @@ GROUPS cloud-vm-clusters Manage Cloud Vm Cluster resources. + database-character-sets + Manage Database Character Set resources. + + databases + Manage Database resources. + + db-system-initial-storage-sizes + Manage Db System Initial Storage Size resources. + db-system-shapes Manage Db System Shape resources. + db-systems + Manage Db System resources. + + db-versions + Manage Db Version resources. + entitlements Manage Entitlement resources. @@ -47,3 +62,6 @@ GROUPS operations Manage Operation resources. + + pluggable-databases + Manage Pluggable Database resources. diff --git a/gcloud/oracle-database/odb-networks/create b/gcloud/oracle-database/odb-networks/create index c16013d64..e7ac249a3 100644 --- a/gcloud/oracle-database/odb-networks/create +++ b/gcloud/oracle-database/odb-networks/create @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud oracle-database odb-networks create (ODB_NETWORK : --location=LOCATION) --network=NETWORK [--async] - [--labels=[LABELS,...]] [--request-id=REQUEST_ID] - [GCLOUD_WIDE_FLAG ...] + [--gcp-oracle-zone=GCP_ORACLE_ZONE] [--labels=[LABELS,...]] + [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new OdbNetwork. @@ -78,6 +78,10 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --gcp-oracle-zone=GCP_ORACLE_ZONE + The GCP Oracle zone where OdbNetwork is hosted. Example: us-east4-b-r2. + If not specified, the system will pick a zone based on availability. + --labels=[LABELS,...] Labels or tags associated with the resource. diff --git a/gcloud/oracle-database/pluggable-databases/describe b/gcloud/oracle-database/pluggable-databases/describe new file mode 100644 index 000000000..cadabc284 --- /dev/null +++ b/gcloud/oracle-database/pluggable-databases/describe @@ -0,0 +1,63 @@ +NAME + gcloud oracle-database pluggable-databases describe - get details of a + PluggableDatabase + +SYNOPSIS + gcloud oracle-database pluggable-databases describe + (PLUGGABLE_DATABASE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Get details of a PluggableDatabase. + +EXAMPLES + To get a PluggableDatabase with id my-pluggable-database in the location + us-east4 for a given DbSystem with id my-db-system, run: + + $ gcloud oracle-database pluggable-databases describe \ + my-pluggable-database --location=us-east4 + +POSITIONAL ARGUMENTS + PluggableDatabase resource - The name of the PluggableDatabase resource in + the following format: + projects/{project}/locations/{region}/pluggableDatabases/{pluggable_database} + The arguments in this group can be used to specify the attributes of this + 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 pluggable_database on the command line with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + PLUGGABLE_DATABASE + ID of the pluggableDatabase or fully qualified identifier for the + pluggableDatabase. + + To set the pluggable_database attribute: + ▸ provide the argument pluggable_database on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the pluggableDatabase resource. + + To set the location attribute: + ▸ provide the argument pluggable_database on the command line with + a fully specified name; + ▸ provide the argument --location on the command line. + +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 diff --git a/gcloud/oracle-database/pluggable-databases/help b/gcloud/oracle-database/pluggable-databases/help new file mode 100644 index 000000000..e9c240fea --- /dev/null +++ b/gcloud/oracle-database/pluggable-databases/help @@ -0,0 +1,23 @@ +NAME + gcloud oracle-database pluggable-databases - manage Pluggable Database + resources + +SYNOPSIS + gcloud oracle-database pluggable-databases COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Pluggable Database resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Get details of a PluggableDatabase. + + list + List pluggableDatabases. diff --git a/gcloud/oracle-database/pluggable-databases/list b/gcloud/oracle-database/pluggable-databases/list new file mode 100644 index 000000000..847fd3e61 --- /dev/null +++ b/gcloud/oracle-database/pluggable-databases/list @@ -0,0 +1,79 @@ +NAME + gcloud oracle-database pluggable-databases list - list pluggableDatabases + +SYNOPSIS + gcloud oracle-database pluggable-databases list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List pluggableDatabases + +EXAMPLES + To list all pluggableDatabases, run: + + $ gcloud oracle-database pluggable-databases list + +REQUIRED FLAGS + Location resource - The parent, which owns this collection of + PluggableDatabases. Format: projects/{project}/locations/{location} 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 --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +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 diff --git a/gcloud/run/deploy b/gcloud/run/deploy index ddf66ca1e..616cfb42c 100644 --- a/gcloud/run/deploy +++ b/gcloud/run/deploy @@ -10,9 +10,9 @@ SYNOPSIS [--description=DESCRIPTION] [--execution-environment=EXECUTION_ENVIRONMENT] [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--ingress=INGRESS; default="all"] - [--[no-]invoker-iam-check] [--max-instances=MAX_INSTANCES] [--min=MIN] - [--min-instances=MIN_INSTANCES] [--region=REGION] [--regions=REGIONS] - [--remove-containers=[CONTAINER,...]] + [--[no-]invoker-iam-check] [--max=MAX] [--max-instances=MAX_INSTANCES] + [--min=MIN] [--min-instances=MIN_INSTANCES] [--region=REGION] + [--regions=REGIONS] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] [--service-account=SERVICE_ACCOUNT] [--[no-]session-affinity] [--tag=TAG] [--timeout=TIMEOUT] [--no-traffic] @@ -210,6 +210,12 @@ FLAGS Use --invoker-iam-check to enable and --no-invoker-iam-check to disable. + --max=MAX + The maximum number of container instances to run for this Service. This + instance limit will be divided among all Revisions receiving a + percentage of traffic and can be modified without deploying a new + Revision. + --max-instances=MAX_INSTANCES The maximum number of container instances for this Revision to run or 'default' to remove. This setting is immutably set on each new Revision @@ -359,6 +365,9 @@ FLAGS this volume ◆ readonly: (optional) A boolean. If true, this volume will be read-only from all mounts. + ◆ mount-options: (optional) A list of flags to pass to GCSFuse. Flags + should be specified without leading dashes and separated by + semicolons. in-memory: An ephemeral volume that stores data in the instance's memory. With this type of volume, data is not shared between instances @@ -545,13 +554,17 @@ FLAGS Remove all environment variables. --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed - before the new environment variables are added. Example YAML - content: + Path to a local YAML or ENV file with definitions for all + environment variables. All existing environment variables will be + removed before the new environment variables are added. Example + YAML content: KEY_1: "value1" KEY_2: "value 2" + Example ENV content: + + KEY_1="value1" + KEY_2="value 2" --set-env-vars=[KEY=VALUE,...] List of key-value pairs to set as environment variables. All diff --git a/gcloud/run/jobs/create b/gcloud/run/jobs/create index 83364a304..33fb397e5 100644 --- a/gcloud/run/jobs/create +++ b/gcloud/run/jobs/create @@ -161,6 +161,9 @@ FLAGS this volume ◆ readonly: (optional) A boolean. If true, this volume will be read-only from all mounts. + ◆ mount-options: (optional) A list of flags to pass to GCSFuse. Flags + should be specified without leading dashes and separated by + semicolons. in-memory: An ephemeral volume that stores data in the instance's memory. With this type of volume, data is not shared between instances @@ -253,13 +256,17 @@ FLAGS Remove all environment variables. --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed - before the new environment variables are added. Example YAML - content: + Path to a local YAML or ENV file with definitions for all + environment variables. All existing environment variables will be + removed before the new environment variables are added. Example + YAML content: KEY_1: "value1" KEY_2: "value 2" + Example ENV content: + + KEY_1="value1" + KEY_2="value 2" --set-env-vars=[KEY=VALUE,...] List of key-value pairs to set as environment variables. All diff --git a/gcloud/run/jobs/deploy b/gcloud/run/jobs/deploy index ed7082ae1..746948d49 100644 --- a/gcloud/run/jobs/deploy +++ b/gcloud/run/jobs/deploy @@ -166,6 +166,9 @@ FLAGS this volume ◆ readonly: (optional) A boolean. If true, this volume will be read-only from all mounts. + ◆ mount-options: (optional) A list of flags to pass to GCSFuse. Flags + should be specified without leading dashes and separated by + semicolons. in-memory: An ephemeral volume that stores data in the instance's memory. With this type of volume, data is not shared between instances @@ -255,13 +258,17 @@ FLAGS Remove all environment variables. --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed - before the new environment variables are added. Example YAML - content: + Path to a local YAML or ENV file with definitions for all + environment variables. All existing environment variables will be + removed before the new environment variables are added. Example + YAML content: KEY_1: "value1" KEY_2: "value 2" + Example ENV content: + + KEY_1="value1" + KEY_2="value 2" --set-env-vars=[KEY=VALUE,...] List of key-value pairs to set as environment variables. All diff --git a/gcloud/run/jobs/update b/gcloud/run/jobs/update index 5da7001ca..4211c3d0a 100644 --- a/gcloud/run/jobs/update +++ b/gcloud/run/jobs/update @@ -177,6 +177,9 @@ FLAGS this volume ◆ readonly: (optional) A boolean. If true, this volume will be read-only from all mounts. + ◆ mount-options: (optional) A list of flags to pass to GCSFuse. Flags + should be specified without leading dashes and separated by + semicolons. in-memory: An ephemeral volume that stores data in the instance's memory. With this type of volume, data is not shared between instances @@ -270,13 +273,17 @@ FLAGS Remove all environment variables. --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed - before the new environment variables are added. Example YAML - content: + Path to a local YAML or ENV file with definitions for all + environment variables. All existing environment variables will be + removed before the new environment variables are added. Example + YAML content: KEY_1: "value1" KEY_2: "value 2" + Example ENV content: + + KEY_1="value1" + KEY_2="value 2" --set-env-vars=[KEY=VALUE,...] List of key-value pairs to set as environment variables. All diff --git a/gcloud/run/multi-region-services/update b/gcloud/run/multi-region-services/update index 110219cfd..1d8cdfa56 100644 --- a/gcloud/run/multi-region-services/update +++ b/gcloud/run/multi-region-services/update @@ -10,8 +10,8 @@ SYNOPSIS [--[no-]cpu-throttling] [--[no-]default-url] [--execution-environment=EXECUTION_ENVIRONMENT] [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--ingress=INGRESS; default="all"] - [--[no-]invoker-iam-check] [--max-instances=MAX_INSTANCES] [--min=MIN] - [--min-instances=MIN_INSTANCES] [--region=REGION] + [--[no-]invoker-iam-check] [--max=MAX] [--max-instances=MAX_INSTANCES] + [--min=MIN] [--min-instances=MIN_INSTANCES] [--region=REGION] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] [--service-account=SERVICE_ACCOUNT] [--[no-]session-affinity] @@ -174,6 +174,12 @@ FLAGS Use --invoker-iam-check to enable and --no-invoker-iam-check to disable. + --max=MAX + The maximum number of container instances to run for this Service. This + instance limit will be divided among all Revisions receiving a + percentage of traffic and can be modified without deploying a new + Revision. + --max-instances=MAX_INSTANCES The maximum number of container instances for this Revision to run or 'default' to remove. This setting is immutably set on each new Revision @@ -420,13 +426,17 @@ FLAGS Remove all environment variables. --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed - before the new environment variables are added. Example YAML - content: + Path to a local YAML or ENV file with definitions for all + environment variables. All existing environment variables will be + removed before the new environment variables are added. Example + YAML content: KEY_1: "value1" KEY_2: "value 2" + Example ENV content: + + KEY_1="value1" + KEY_2="value 2" --set-env-vars=[KEY=VALUE,...] List of key-value pairs to set as environment variables. All diff --git a/gcloud/run/services/update b/gcloud/run/services/update index 52be41580..11ef7efc1 100644 --- a/gcloud/run/services/update +++ b/gcloud/run/services/update @@ -9,8 +9,8 @@ SYNOPSIS [--[no-]cpu-throttling] [--[no-]default-url] [--execution-environment=EXECUTION_ENVIRONMENT] [--gpu-type=GPU_TYPE] [--[no-]gpu-zonal-redundancy] [--ingress=INGRESS; default="all"] - [--[no-]invoker-iam-check] [--max-instances=MAX_INSTANCES] [--min=MIN] - [--min-instances=MIN_INSTANCES] [--region=REGION] + [--[no-]invoker-iam-check] [--max=MAX] [--max-instances=MAX_INSTANCES] + [--min=MIN] [--min-instances=MIN_INSTANCES] [--region=REGION] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] [--service-account=SERVICE_ACCOUNT] [--[no-]session-affinity] @@ -172,6 +172,12 @@ FLAGS Use --invoker-iam-check to enable and --no-invoker-iam-check to disable. + --max=MAX + The maximum number of container instances to run for this Service. This + instance limit will be divided among all Revisions receiving a + percentage of traffic and can be modified without deploying a new + Revision. + --max-instances=MAX_INSTANCES The maximum number of container instances for this Revision to run or 'default' to remove. This setting is immutably set on each new Revision @@ -317,6 +323,9 @@ FLAGS this volume ◆ readonly: (optional) A boolean. If true, this volume will be read-only from all mounts. + ◆ mount-options: (optional) A list of flags to pass to GCSFuse. Flags + should be specified without leading dashes and separated by + semicolons. in-memory: An ephemeral volume that stores data in the instance's memory. With this type of volume, data is not shared between instances @@ -443,13 +452,17 @@ FLAGS Remove all environment variables. --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed - before the new environment variables are added. Example YAML - content: + Path to a local YAML or ENV file with definitions for all + environment variables. All existing environment variables will be + removed before the new environment variables are added. Example + YAML content: KEY_1: "value1" KEY_2: "value 2" + Example ENV content: + + KEY_1="value1" + KEY_2="value 2" --set-env-vars=[KEY=VALUE,...] List of key-value pairs to set as environment variables. All diff --git a/gcloud/sql/backups/restore b/gcloud/sql/backups/restore index 29bc79a5e..ea1063bfd 100644 --- a/gcloud/sql/backups/restore +++ b/gcloud/sql/backups/restore @@ -12,7 +12,8 @@ SYNOPSIS [--availability-type=AVAILABILITY_TYPE] [--no-backup] [--backup-instance=BACKUP_INSTANCE] [--backup-location=BACKUP_LOCATION] [--backup-project=BACKUP_PROJECT] - [--backup-start-time=BACKUP_START_TIME] [--clear-network] + [--backup-start-time=BACKUP_START_TIME] + [--clear-disk-encryption=CLEAR_DISK_ENCRYPTION] [--clear-network] [--collation=COLLATION] [--connector-enforcement=CONNECTOR_ENFORCEMENT] [--cpu=CPU] [--database-version=DATABASE_VERSION] [--[no-]deletion-protection] @@ -141,6 +142,9 @@ OPTIONAL FLAGS Start time of daily backups, specified in the HH:MM format, in the UTC timezone. + --clear-disk-encryption=CLEAR_DISK_ENCRYPTION + Disables CMEK in the restored instance. + --clear-network Clears the network setting. This is useful to restore a backup to a different project or region where the original network configuration diff --git a/gcloud/storage/diagnose b/gcloud/storage/diagnose new file mode 100644 index 000000000..947de3e3b --- /dev/null +++ b/gcloud/storage/diagnose @@ -0,0 +1,178 @@ +NAME + gcloud storage diagnose - diagnose Google Cloud Storage + +SYNOPSIS + gcloud storage diagnose URL [--test-type=[TEST_TYPES,...]] + [--download-type=DOWNLOAD_TYPE; default=] + [--logs-path=LOGS_PATH] + [--upload-type=UPLOAD_TYPE; default=] + [--process-count=PROCESS_COUNT] [--thread-count=THREAD_COUNT] + [--object-count=OBJECT_COUNT (--object-size=OBJECT_SIZE + | --object-sizes=[OBJECT_SIZES,...])] + [--export : --destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + The diagnose command runs a series of diagnostic tests for common gcloud + storage issues. + + The URL argument must name an exisiting bucket for which the user already + has write permissions. Standard billing also applies. Several test + files/objects will be uploaded and downloaded to this bucket to gauge out + the performance metrics. All the temporary files will be deleted on + successfull completion of the command. + + By default, the command executes DOWNLOAD_THROUGHPUT, UPLOAD_THROUGHPUT and + LATENCY tests. Tests to execute can be overriden by using the --test-type + flag. Each test uses the command defaults or gcloud CLI configurations for + performing the operations. This command also provides a way to override + these values via means of different flags like --process-count, + --thread-count, --download-type, etc. + + The command outputs a diagnostic report with sytem information like free + memory, available CPU, average CPU load per test, disk counter deltas and + diagnostic information specific to individual tests on successful + completion. + +EXAMPLES + The following command runs the default diagnostic tests on my-bucket + bucket: + + $ gcloud storage diagnose gs://my-bucket + + The following command runs only UPLOAD_THROUGHPUT and DOWNLOAD_THROUGHPUT + diagnostic tests: + + $ gcloud storage diagnose gs://my-bucket \ + --test-type=UPLOAD_THROUGHPUT,DOWNLOAD_THROUGHPUT + + The following command runs the diagnostic tests using 10 objects of 1MiB + size each with 10 threads and 10 processes at max: + + $ gcloud storage diagnose gs://my-bucket --no-of-objects=10 \ + --object-size=1MiB --process-count=10 --thread-count=10 + + The following command can be used to bundle and export the diagnostic + information to a user defined PATH destination: + + $ gcloud storage diagnose gs://my-bucket --export \ + --destination= + +POSITIONAL ARGUMENTS + URL + Bucket URL to use for the diagnostic tests. + +FLAGS + --test-type=[TEST_TYPES,...] + Tests to run as part of this diagnosis. Following tests are supported: + + DIRECT_CONNECTIVITY: Run a test upload over the Direct Connectivity + network path and run other diagnostics if the upload fails. + + DOWNLOAD_THROUGHPUT: Upload objects to the specified bucket and record + the number of bytes transferred per second. + + UPLOAD_THROUGHPUT: Download objects from the specified bucket and + record the number of bytes transferred per second. + + LATENCY: Write the objects, retrieve their metadata, read the objects, + and record latency of each operation. + + TEST_TYPES must be one of: DIRECT_CONNECTIVITY, DOWNLOAD_THROUGHPUT, + LATENCY, UPLOAD_THROUGHPUT. + + --download-type=DOWNLOAD_TYPE; default= + Download strategy to use for the DOWNLOAD_THROUGHPUT diagnostic test. + + STREAMING: Downloads the file in memory, does not use parallelism. + --process-count and --thread-count flag values will be ignored if + provided. + + SLICED: Performs a sliced download + (https://cloud.google.com/storage/docs/sliced-object-downloads) of + objects to a directory. Parallelism can be controlled via + --process-count and --thread-count flags. + + FILE: Download objects as files. Parallelism can be controlled via + --process-count and --thread-count flags. + + DOWNLOAD_TYPE must be one of: FILE, SLICED, STREAMING. + + --logs-path=LOGS_PATH + If the diagnostic supports writing logs, write the logs to this file + location. + + --upload-type=UPLOAD_TYPE; default= + Upload strategy to use for the UPLOAD_THROUGHPUT diagnostic test. + + FILE: Uploads files to a bucket. Parallelism can be controlled via + --process-count and --thread-count flags. + + PARALLEL_COMPOSITE: Uploads files using a parallel composite strategy + (https://cloud.google.com/storage/docs/parallel-composite-uploads). + Parallelism can be controlled via --process-count and --thread-count + flags. + + STREAMING: Streams the data to the bucket, does not use parallelism. + --process-count and --thread-count flag values will be ignored if + provided. + + UPLOAD_TYPE must be one of: FILE, PARALLEL_COMPOSITE, STREAMING. + + --process-count=PROCESS_COUNT + Number of processes at max to use for each diagnostic test. + + --thread-count=THREAD_COUNT + Number of threads at max to use for each diagnostic test. + + Object properties: + + --object-count=OBJECT_COUNT + Number of objects to use for each diagnostic test. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + Object size properties: + + Exactly one of these must be specified: + + --object-size=OBJECT_SIZE + Object size to use for the diagnostic tests. + + --object-sizes=[OBJECT_SIZES,...] + List of object sizes to use for the tests. Sizes should be provided + for each object specified using --object-count flag. + + Export diagnostic bundle. + + --export + Generate and export a diagnostic bundle. The following information + will be bundled and exported into a gzipped tarball (.tar.gz): + + ▸ Latest gcloud CLI logs. + ▸ Output of running the gcloud storage diagnose command. + ▸ Output of running the gcloud info --anonymize command. + + Note: This command generates a bundle containing system information + like disk counter detlas, CPU information and system configurations. + Please exercise caution while sharing. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --destination=DESTINATION + Destination file path where the diagnostic bundle will be exported. + +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 variant is also available: + + $ gcloud alpha storage diagnose + diff --git a/gcloud/storage/help b/gcloud/storage/help index d83f5cc50..a818b24c5 100644 --- a/gcloud/storage/help +++ b/gcloud/storage/help @@ -53,6 +53,9 @@ COMMANDS cp Upload, download, and copy Cloud Storage objects. + diagnose + Diagnose Google Cloud Storage. + du Displays the amount of space in bytes used by storage resources.