From 379049f21a74b93c5a705ed624a451ca72a44ce2 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 11 May 2022 08:44:01 +0000 Subject: [PATCH] gcloud: Wed May 11 08:44:01 UTC 2022 --- gcloud/_version | 8 +- gcloud/ai/model-monitoring-jobs/create | 8 +- gcloud/ai/model-monitoring-jobs/update | 10 +- gcloud/alpha/ai/model-monitoring-jobs/create | 8 +- gcloud/alpha/ai/model-monitoring-jobs/update | 10 +- gcloud/alpha/anthos/config/controller/create | 5 +- gcloud/alpha/anthos/config/controller/delete | 5 +- .../alpha/anthos/config/controller/describe | 5 +- .../alpha/anthos/config/operations/describe | 5 +- gcloud/alpha/artifacts/versions/list | 7 + gcloud/alpha/compute/project-info/update | 2 +- gcloud/alpha/config/help | 3 + gcloud/alpha/config/list | 3 + gcloud/alpha/config/set | 3 + gcloud/alpha/config/unset | 3 + gcloud/alpha/container/aws/clusters/create | 3 +- gcloud/alpha/container/aws/clusters/update | 12 + gcloud/alpha/container/aws/node-pools/create | 2 +- gcloud/alpha/container/aws/node-pools/update | 11 + .../network-services/service-bindings/create | 4 +- .../network-services/service-bindings/delete | 4 +- .../service-bindings/describe | 4 +- .../network-services/service-bindings/help | 4 +- .../network-services/service-bindings/list | 4 +- gcloud/alpha/run/jobs/add-iam-policy-binding | 4 +- gcloud/alpha/run/jobs/create | 4 +- gcloud/alpha/run/jobs/delete | 4 +- gcloud/alpha/run/jobs/execute | 4 +- gcloud/alpha/run/jobs/executions/delete | 4 +- gcloud/alpha/run/jobs/executions/list | 4 +- gcloud/alpha/run/jobs/executions/tasks/list | 4 +- gcloud/alpha/run/jobs/list | 4 +- .../alpha/run/jobs/remove-iam-policy-binding | 4 +- gcloud/alpha/run/jobs/set-iam-policy | 4 +- gcloud/alpha/run/jobs/update | 4 +- gcloud/alpha/sql/flags/list | 2 +- gcloud/alpha/sql/instances/create | 9 +- gcloud/alpha/sql/instances/patch | 14 +- gcloud/alpha/storage/cp | 18 +- .../web-security-scanner/scan-configs/create | 2 +- .../web-security-scanner/scan-configs/update | 2 +- gcloud/anthos/config/controller/create | 5 +- gcloud/anthos/config/controller/delete | 5 +- gcloud/anthos/config/controller/describe | 5 +- gcloud/anthos/config/operations/describe | 5 +- gcloud/artifacts/versions/list | 7 + gcloud/beta/ai/model-monitoring-jobs/create | 8 +- gcloud/beta/ai/model-monitoring-jobs/update | 10 +- gcloud/beta/artifacts/versions/list | 7 + gcloud/beta/compute/instance-templates/create | 13 +- gcloud/beta/compute/project-info/update | 2 +- gcloud/beta/config/get | 3 + gcloud/beta/config/help | 3 + gcloud/beta/config/list | 3 + gcloud/beta/config/set | 3 + gcloud/beta/config/unset | 3 + .../network-services/service-bindings/create | 6 +- .../network-services/service-bindings/delete | 6 +- .../service-bindings/describe | 6 +- .../network-services/service-bindings/help | 6 +- .../network-services/service-bindings/list | 6 +- gcloud/beta/run/jobs/add-iam-policy-binding | 140 +++++++++ gcloud/beta/run/jobs/create | 187 ++++++++++++ gcloud/beta/run/jobs/delete | 49 ++++ gcloud/beta/run/jobs/execute | 61 ++++ gcloud/beta/run/jobs/executions/delete | 50 ++++ gcloud/beta/run/jobs/executions/help | 6 + gcloud/beta/run/jobs/executions/list | 84 ++++++ gcloud/beta/run/jobs/executions/tasks/help | 3 + gcloud/beta/run/jobs/executions/tasks/list | 87 ++++++ gcloud/beta/run/jobs/help | 24 ++ gcloud/beta/run/jobs/list | 80 ++++++ .../beta/run/jobs/remove-iam-policy-binding | 146 ++++++++++ gcloud/beta/run/jobs/set-iam-policy | 78 +++++ gcloud/beta/run/jobs/update | 271 ++++++++++++++++++ gcloud/beta/sql/flags/list | 2 +- gcloud/beta/sql/instances/create | 9 +- gcloud/beta/sql/instances/patch | 14 +- gcloud/compute/project-info/update | 2 +- gcloud/config/get | 3 + gcloud/config/help | 3 + gcloud/config/list | 3 + gcloud/config/set | 3 + gcloud/config/unset | 3 + gcloud/container/aws/clusters/create | 3 +- gcloud/container/aws/clusters/update | 12 + gcloud/container/aws/node-pools/create | 2 +- gcloud/container/aws/node-pools/update | 11 + gcloud/eventarc/channel-connections/create | 70 +++++ gcloud/eventarc/channel-connections/delete | 60 ++++ gcloud/eventarc/channel-connections/describe | 54 ++++ gcloud/eventarc/channel-connections/help | 28 ++ gcloud/eventarc/channel-connections/list | 84 ++++++ gcloud/eventarc/channels/create | 73 +++++ gcloud/eventarc/channels/delete | 56 ++++ gcloud/eventarc/channels/describe | 51 ++++ gcloud/eventarc/channels/help | 28 ++ gcloud/eventarc/channels/list | 83 ++++++ gcloud/eventarc/help | 6 + gcloud/eventarc/triggers/create | 21 +- gcloud/network-services/help | 3 + .../network-services/service-bindings/create | 90 ++++++ .../network-services/service-bindings/delete | 69 +++++ .../service-bindings/describe | 64 +++++ gcloud/network-services/service-bindings/help | 36 +++ gcloud/network-services/service-bindings/list | 84 ++++++ gcloud/sql/flags/list | 9 +- gcloud/sql/instances/create | 16 +- gcloud/sql/instances/patch | 16 +- 109 files changed, 2571 insertions(+), 102 deletions(-) create mode 100644 gcloud/beta/run/jobs/add-iam-policy-binding create mode 100644 gcloud/beta/run/jobs/create create mode 100644 gcloud/beta/run/jobs/delete create mode 100644 gcloud/beta/run/jobs/execute create mode 100644 gcloud/beta/run/jobs/executions/delete create mode 100644 gcloud/beta/run/jobs/executions/list create mode 100644 gcloud/beta/run/jobs/executions/tasks/list create mode 100644 gcloud/beta/run/jobs/list create mode 100644 gcloud/beta/run/jobs/remove-iam-policy-binding create mode 100644 gcloud/beta/run/jobs/set-iam-policy create mode 100644 gcloud/beta/run/jobs/update create mode 100644 gcloud/eventarc/channel-connections/create create mode 100644 gcloud/eventarc/channel-connections/delete create mode 100644 gcloud/eventarc/channel-connections/describe create mode 100644 gcloud/eventarc/channel-connections/help create mode 100644 gcloud/eventarc/channel-connections/list create mode 100644 gcloud/eventarc/channels/create create mode 100644 gcloud/eventarc/channels/delete create mode 100644 gcloud/eventarc/channels/describe create mode 100644 gcloud/eventarc/channels/help create mode 100644 gcloud/eventarc/channels/list create mode 100644 gcloud/network-services/service-bindings/create create mode 100644 gcloud/network-services/service-bindings/delete create mode 100644 gcloud/network-services/service-bindings/describe create mode 100644 gcloud/network-services/service-bindings/help create mode 100644 gcloud/network-services/service-bindings/list diff --git a/gcloud/_version b/gcloud/_version index a76682d4f..8b86030ea 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,6 +1,6 @@ -Google Cloud SDK 384.0.1 -alpha 2022.05.04 -beta 2022.05.04 +Google Cloud SDK 385.0.0 +alpha 2022.05.06 +beta 2022.05.06 bq 2.0.74 -core 2022.05.04 +core 2022.05.06 gsutil 5.10 diff --git a/gcloud/ai/model-monitoring-jobs/create b/gcloud/ai/model-monitoring-jobs/create index febbc36be..08c139c70 100644 --- a/gcloud/ai/model-monitoring-jobs/create +++ b/gcloud/ai/model-monitoring-jobs/create @@ -7,7 +7,8 @@ SYNOPSIS --emails=[EMAILS,...] --endpoint=ENDPOINT --prediction-sampling-rate=PREDICTION_SAMPLING_RATE [--analysis-instance-schema=ANALYSIS_INSTANCE_SCHEMA] - [--labels=[KEY=VALUE,...]] [--log-ttl=LOG_TTL] + [--[no-]anomaly-cloud-logging] [--labels=[KEY=VALUE,...]] + [--log-ttl=LOG_TTL] [--monitoring-frequency=MONITORING_FREQUENCY; default=24] [--predict-instance-schema=PREDICT_INSTANCE_SCHEMA] [--region=REGION] [--sample-predict-request=SAMPLE_PREDICT_REQUEST] @@ -98,6 +99,11 @@ OPTIONAL FLAGS single instance that you want Tensorflow Data Validation (TFDV) to analyze. + --[no-]anomaly-cloud-logging + If true, anomaly will be sent to Cloud Logging. Use + --anomaly-cloud-logging to enable and --no-anomaly-cloud-logging to + disable. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/ai/model-monitoring-jobs/update b/gcloud/ai/model-monitoring-jobs/update index d333d395b..805209e59 100644 --- a/gcloud/ai/model-monitoring-jobs/update +++ b/gcloud/ai/model-monitoring-jobs/update @@ -5,8 +5,9 @@ NAME SYNOPSIS gcloud ai model-monitoring-jobs update (MONITORING_JOB : --region=REGION) [--analysis-instance-schema=ANALYSIS_INSTANCE_SCHEMA] - [--display-name=DISPLAY_NAME] [--emails=[EMAILS,...]] - [--log-ttl=LOG_TTL] [--monitoring-frequency=MONITORING_FREQUENCY] + [--[no-]anomaly-cloud-logging] [--display-name=DISPLAY_NAME] + [--emails=[EMAILS,...]] [--log-ttl=LOG_TTL] + [--monitoring-frequency=MONITORING_FREQUENCY] [--prediction-sampling-rate=PREDICTION_SAMPLING_RATE] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] @@ -58,6 +59,11 @@ FLAGS single instance that you want Tensorflow Data Validation (TFDV) to analyze. + --[no-]anomaly-cloud-logging + If true, anomaly will be sent to Cloud Logging. Use + --anomaly-cloud-logging to enable and --no-anomaly-cloud-logging to + disable. + --display-name=DISPLAY_NAME Display name of the model deployment monitoring job. diff --git a/gcloud/alpha/ai/model-monitoring-jobs/create b/gcloud/alpha/ai/model-monitoring-jobs/create index 214c09244..835d9b09c 100644 --- a/gcloud/alpha/ai/model-monitoring-jobs/create +++ b/gcloud/alpha/ai/model-monitoring-jobs/create @@ -7,7 +7,8 @@ SYNOPSIS --emails=[EMAILS,...] --endpoint=ENDPOINT --prediction-sampling-rate=PREDICTION_SAMPLING_RATE [--analysis-instance-schema=ANALYSIS_INSTANCE_SCHEMA] - [--labels=[KEY=VALUE,...]] [--log-ttl=LOG_TTL] + [--[no-]anomaly-cloud-logging] [--labels=[KEY=VALUE,...]] + [--log-ttl=LOG_TTL] [--monitoring-frequency=MONITORING_FREQUENCY; default=24] [--predict-instance-schema=PREDICT_INSTANCE_SCHEMA] [--region=REGION] [--sample-predict-request=SAMPLE_PREDICT_REQUEST] @@ -98,6 +99,11 @@ OPTIONAL FLAGS single instance that you want Tensorflow Data Validation (TFDV) to analyze. + --[no-]anomaly-cloud-logging + If true, anomaly will be sent to Cloud Logging. Use + --anomaly-cloud-logging to enable and --no-anomaly-cloud-logging to + disable. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/ai/model-monitoring-jobs/update b/gcloud/alpha/ai/model-monitoring-jobs/update index 42c3c396d..54c22aca2 100644 --- a/gcloud/alpha/ai/model-monitoring-jobs/update +++ b/gcloud/alpha/ai/model-monitoring-jobs/update @@ -6,8 +6,9 @@ SYNOPSIS gcloud alpha ai model-monitoring-jobs update (MONITORING_JOB : --region=REGION) [--analysis-instance-schema=ANALYSIS_INSTANCE_SCHEMA] - [--display-name=DISPLAY_NAME] [--emails=[EMAILS,...]] - [--log-ttl=LOG_TTL] [--monitoring-frequency=MONITORING_FREQUENCY] + [--[no-]anomaly-cloud-logging] [--display-name=DISPLAY_NAME] + [--emails=[EMAILS,...]] [--log-ttl=LOG_TTL] + [--monitoring-frequency=MONITORING_FREQUENCY] [--prediction-sampling-rate=PREDICTION_SAMPLING_RATE] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] @@ -59,6 +60,11 @@ FLAGS single instance that you want Tensorflow Data Validation (TFDV) to analyze. + --[no-]anomaly-cloud-logging + If true, anomaly will be sent to Cloud Logging. Use + --anomaly-cloud-logging to enable and --no-anomaly-cloud-logging to + disable. + --display-name=DISPLAY_NAME Display name of the model deployment monitoring job. diff --git a/gcloud/alpha/anthos/config/controller/create b/gcloud/alpha/anthos/config/controller/create index f06d150c6..a7b68fa92 100644 --- a/gcloud/alpha/anthos/config/controller/create +++ b/gcloud/alpha/anthos/config/controller/create @@ -43,8 +43,9 @@ POSITIONAL ARGUMENTS --location=LOCATION The name of the Config Controller instance location. Currently, only - us-central1, us-east1, northamerica-northeast1, and asia-northeast1 - are supported. To set the location attribute: + us-central1, us-east1, northamerica-northeast1, europe-north1, + australia-southeast1, and asia-northeast1 are supported. To set the + location attribute: ▸ provide the argument name on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/anthos/config/controller/delete b/gcloud/alpha/anthos/config/controller/delete index 08b78521e..e03b8f283 100644 --- a/gcloud/alpha/anthos/config/controller/delete +++ b/gcloud/alpha/anthos/config/controller/delete @@ -38,8 +38,9 @@ POSITIONAL ARGUMENTS --location=LOCATION The name of the Anthos Config Controller instance location. - Currently, only us-central1, us-east1, northamerica-northeast1, and - asia-northeast1 are supported. To set the location attribute: + Currently, only us-central1, us-east1, northamerica-northeast1, + europe-north1, australia-southeast1 and asia-northeast1 are + supported. To set the location attribute: ▸ provide the argument name on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/anthos/config/controller/describe b/gcloud/alpha/anthos/config/controller/describe index 0b71ef943..b80b15e25 100644 --- a/gcloud/alpha/anthos/config/controller/describe +++ b/gcloud/alpha/anthos/config/controller/describe @@ -39,8 +39,9 @@ POSITIONAL ARGUMENTS --location=LOCATION The name of the Anthos Config Controller instance location. - Currently, only us-central1, us-east1, northamerica-northeast1, and - asia-northeast1 are supported. To set the location attribute: + Currently, only us-central1, us-east1, northamerica-northeast1, + europe-north1, australia-southeast1 and asia-northeast1 are + supported. To set the location attribute: ▸ provide the argument name on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/anthos/config/operations/describe b/gcloud/alpha/anthos/config/operations/describe index 86b02cf4f..957f1fca4 100644 --- a/gcloud/alpha/anthos/config/operations/describe +++ b/gcloud/alpha/anthos/config/operations/describe @@ -39,8 +39,9 @@ POSITIONAL ARGUMENTS --location=LOCATION The name of the Anthos Config Controller instance location. - Currently, only us-central1, us-east1, northamerica-northeast1, and - asia-northeast1 are supported. To set the location attribute: + Currently, only us-central1, us-east1, northamerica-northeast1, + europe-north1, australia-southeast1 and asia-northeast1 are + supported. To set the location attribute: ▸ provide the argument operation on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/artifacts/versions/list b/gcloud/alpha/artifacts/versions/list index 50a7ecb2f..9ae36a339 100644 --- a/gcloud/alpha/artifacts/versions/list +++ b/gcloud/alpha/artifacts/versions/list @@ -19,6 +19,13 @@ EXAMPLES $ gcloud alpha artifacts versions list --limit=5 + The following command lists versions in my-package by specifying the + fully-qualified path: + + $ gcloud alpha artifacts versions list \ + --package=projects/my-project/locations/my-location/\ + repositories/my-repo/packages/my-package + REQUIRED FLAGS Package resource - The parent package for the list of versions. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/alpha/compute/project-info/update b/gcloud/alpha/compute/project-info/update index d96179ef4..bd8bec2ec 100644 --- a/gcloud/alpha/compute/project-info/update +++ b/gcloud/alpha/compute/project-info/update @@ -13,7 +13,7 @@ DESCRIPTION FLAGS --default-network-tier=DEFAULT_NETWORK_TIER The default network tier to assign to the project. DEFAULT_NETWORK_TIER - must be one of: PREMIUM, STANDARD. + must be one of: PREMIUM, STANDARD, FIXED_STANDARD. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index cae85c85f..07b629efa 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -313,6 +313,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index 6542dd85a..b06c735ab 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -318,6 +318,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 0d0d7939b..62d1f41d3 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -331,6 +331,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index 5effff6ed..05381eee5 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -292,6 +292,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/alpha/container/aws/clusters/create b/gcloud/alpha/container/aws/clusters/create index b1b8800e3..d4aeb78f7 100644 --- a/gcloud/alpha/container/aws/clusters/create +++ b/gcloud/alpha/container/aws/clusters/create @@ -179,7 +179,8 @@ OPTIONAL FLAGS IDs of additional security groups to add to control plane replicas. --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR - Name of the EC2 key pair to log in into control plane nodes. + Name of the EC2 key pair authorized to login to the control plane + nodes. --tags=TAG,[TAG,...] Applies the given tags (comma separated) on the cluster. Example: diff --git a/gcloud/alpha/container/aws/clusters/update b/gcloud/alpha/container/aws/clusters/update index 8bf4a344c..1c459b0b4 100644 --- a/gcloud/alpha/container/aws/clusters/update +++ b/gcloud/alpha/container/aws/clusters/update @@ -17,6 +17,7 @@ SYNOPSIS --proxy-secret-version-id=PROXY_SECRET_VERSION_ID] [--clear-security-group-ids | --security-group-ids=[SECURITY_GROUP_ID,...]] + [--clear-ssh-ec2-key-pair | --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -127,6 +128,17 @@ FLAGS --security-group-ids=[SECURITY_GROUP_ID,...] IDs of additional security groups to add to control plane replicas. + SSH config + + At most one of these can be specified: + + --clear-ssh-ec2-key-pair + Clear the EC2 key pair to log in into the control plane nodes. + + --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR + Name of the EC2 key pair authorized to login to the control plane + nodes. + 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/container/aws/node-pools/create b/gcloud/alpha/container/aws/node-pools/create index 91fe40070..df8940cf3 100644 --- a/gcloud/alpha/container/aws/node-pools/create +++ b/gcloud/alpha/container/aws/node-pools/create @@ -134,7 +134,7 @@ OPTIONAL FLAGS IDs of additional security groups to add to nodes. --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR - Name of the EC2 key pair to log in into control plane nodes. + Name of the EC2 key pair authorized to login to the node pool nodes. --tags=TAG,[TAG,...] Applies the given tags (comma separated) on the node pool. Example: diff --git a/gcloud/alpha/container/aws/node-pools/update b/gcloud/alpha/container/aws/node-pools/update index 90f39f4fc..a906a0b63 100644 --- a/gcloud/alpha/container/aws/node-pools/update +++ b/gcloud/alpha/container/aws/node-pools/update @@ -14,6 +14,7 @@ SYNOPSIS --proxy-secret-version-id=PROXY_SECRET_VERSION_ID] [--clear-security-group-ids | --security-group-ids=[SECURITY_GROUP_ID,...]] + [--clear-ssh-ec2-key-pair | --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR] [--max-nodes=MAX_NODES --min-nodes=MIN_NODES] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -120,6 +121,16 @@ FLAGS --security-group-ids=[SECURITY_GROUP_ID,...] IDs of additional security groups to add to nodes. + SSH config + + At most one of these can be specified: + + --clear-ssh-ec2-key-pair + Clear the EC2 key pair to log in into the node pool nodes. + + --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR + Name of the EC2 key pair authorized to login to the node pool nodes. + Node pool autoscaling --max-nodes=MAX_NODES diff --git a/gcloud/alpha/network-services/service-bindings/create b/gcloud/alpha/network-services/service-bindings/create index 0be04f23d..9eba5c6d3 100644 --- a/gcloud/alpha/network-services/service-bindings/create +++ b/gcloud/alpha/network-services/service-bindings/create @@ -86,7 +86,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 network-services service-bindings create $ gcloud beta network-services service-bindings create diff --git a/gcloud/alpha/network-services/service-bindings/delete b/gcloud/alpha/network-services/service-bindings/delete index e515c2d78..0b308b5ad 100644 --- a/gcloud/alpha/network-services/service-bindings/delete +++ b/gcloud/alpha/network-services/service-bindings/delete @@ -65,7 +65,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 network-services service-bindings delete $ gcloud beta network-services service-bindings delete diff --git a/gcloud/alpha/network-services/service-bindings/describe b/gcloud/alpha/network-services/service-bindings/describe index c325d1a52..5b3d4ffc0 100644 --- a/gcloud/alpha/network-services/service-bindings/describe +++ b/gcloud/alpha/network-services/service-bindings/describe @@ -59,7 +59,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 network-services service-bindings describe $ gcloud beta network-services service-bindings describe diff --git a/gcloud/alpha/network-services/service-bindings/help b/gcloud/alpha/network-services/service-bindings/help index 63fc2e314..092cfbe4d 100644 --- a/gcloud/alpha/network-services/service-bindings/help +++ b/gcloud/alpha/network-services/service-bindings/help @@ -33,7 +33,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 network-services service-bindings $ gcloud beta network-services service-bindings diff --git a/gcloud/alpha/network-services/service-bindings/list b/gcloud/alpha/network-services/service-bindings/list index ec5244105..3d8d6f1ce 100644 --- a/gcloud/alpha/network-services/service-bindings/list +++ b/gcloud/alpha/network-services/service-bindings/list @@ -81,7 +81,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 network-services service-bindings list $ gcloud beta network-services service-bindings list diff --git a/gcloud/alpha/run/jobs/add-iam-policy-binding b/gcloud/alpha/run/jobs/add-iam-policy-binding index a150b4c77..0b939469f 100644 --- a/gcloud/alpha/run/jobs/add-iam-policy-binding +++ b/gcloud/alpha/run/jobs/add-iam-policy-binding @@ -136,5 +136,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 run jobs add-iam-policy-binding diff --git a/gcloud/alpha/run/jobs/create b/gcloud/alpha/run/jobs/create index 4c8b2cca8..7228672da 100644 --- a/gcloud/alpha/run/jobs/create +++ b/gcloud/alpha/run/jobs/create @@ -184,5 +184,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 run jobs create diff --git a/gcloud/alpha/run/jobs/delete b/gcloud/alpha/run/jobs/delete index 4d3380f5c..104dd6a03 100644 --- a/gcloud/alpha/run/jobs/delete +++ b/gcloud/alpha/run/jobs/delete @@ -45,5 +45,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 run jobs delete diff --git a/gcloud/alpha/run/jobs/execute b/gcloud/alpha/run/jobs/execute index b9f62d043..7e5147311 100644 --- a/gcloud/alpha/run/jobs/execute +++ b/gcloud/alpha/run/jobs/execute @@ -57,5 +57,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 run jobs execute diff --git a/gcloud/alpha/run/jobs/executions/delete b/gcloud/alpha/run/jobs/executions/delete index 4e7494f07..5a55f98ea 100644 --- a/gcloud/alpha/run/jobs/executions/delete +++ b/gcloud/alpha/run/jobs/executions/delete @@ -46,5 +46,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 run jobs executions delete diff --git a/gcloud/alpha/run/jobs/executions/list b/gcloud/alpha/run/jobs/executions/list index bfbaee561..c90e01057 100644 --- a/gcloud/alpha/run/jobs/executions/list +++ b/gcloud/alpha/run/jobs/executions/list @@ -80,5 +80,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 run jobs executions list diff --git a/gcloud/alpha/run/jobs/executions/tasks/list b/gcloud/alpha/run/jobs/executions/tasks/list index 3424182d0..4a854922d 100644 --- a/gcloud/alpha/run/jobs/executions/tasks/list +++ b/gcloud/alpha/run/jobs/executions/tasks/list @@ -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 beta run jobs executions tasks list diff --git a/gcloud/alpha/run/jobs/list b/gcloud/alpha/run/jobs/list index f35d68c4d..5a0140398 100644 --- a/gcloud/alpha/run/jobs/list +++ b/gcloud/alpha/run/jobs/list @@ -76,5 +76,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 run jobs list diff --git a/gcloud/alpha/run/jobs/remove-iam-policy-binding b/gcloud/alpha/run/jobs/remove-iam-policy-binding index 4abb6466c..6cdce09e8 100644 --- a/gcloud/alpha/run/jobs/remove-iam-policy-binding +++ b/gcloud/alpha/run/jobs/remove-iam-policy-binding @@ -142,5 +142,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 run jobs remove-iam-policy-binding diff --git a/gcloud/alpha/run/jobs/set-iam-policy b/gcloud/alpha/run/jobs/set-iam-policy index 0ee809033..853db7729 100644 --- a/gcloud/alpha/run/jobs/set-iam-policy +++ b/gcloud/alpha/run/jobs/set-iam-policy @@ -74,5 +74,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 run jobs set-iam-policy diff --git a/gcloud/alpha/run/jobs/update b/gcloud/alpha/run/jobs/update index ab88de7ca..852321af5 100644 --- a/gcloud/alpha/run/jobs/update +++ b/gcloud/alpha/run/jobs/update @@ -267,5 +267,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 run jobs update diff --git a/gcloud/alpha/sql/flags/list b/gcloud/alpha/sql/flags/list index 0fd46914a..944a7ee8a 100644 --- a/gcloud/alpha/sql/flags/list +++ b/gcloud/alpha/sql/flags/list @@ -14,7 +14,7 @@ FLAGS --database-version=DATABASE_VERSION The database engine type and versions. If left unspecified, the API defaults are used. See the list of database versions at - https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion + https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index fe1ae166d..6b98a1b9d 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -15,7 +15,8 @@ SYNOPSIS [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] - [--enable-bin-log] [--enable-point-in-time-recovery] + [--enable-bin-log] [--enable-password-policy] + [--enable-point-in-time-recovery] [--failover-replica-name=FAILOVER_REPLICA_NAME] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] @@ -164,7 +165,7 @@ FLAGS --database-version=DATABASE_VERSION The database engine type and versions. If left unspecified, the API defaults are used. See the list of database versions at - https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion + https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10. @@ -180,6 +181,10 @@ FLAGS fraction of a second. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --enable-password-policy + Enable the password policy, which enforces user password management + with the policies configured for the instance. + --enable-point-in-time-recovery Allows for data recovery from a specific point in time, down to a fraction of a second, via write-ahead logs. Must have automatic backups diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index f2ce41b5c..6dce7cba7 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -14,7 +14,8 @@ SYNOPSIS [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--diff] [--[no-]enable-bin-log] [--[no-]enable-database-replication] - [--enable-point-in-time-recovery] [--follow-gae-app=FOLLOW_GAE_APP] + [--enable-password-policy] [--enable-point-in-time-recovery] + [--follow-gae-app=FOLLOW_GAE_APP] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -107,13 +108,6 @@ FLAGS The database engine type and versions. If left unspecified, no changes occur. See the list of database versions at https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. - DATABASE_VERSION must be one of: MYSQL_5_6, MYSQL_5_7, MYSQL_8_0, - POSTGRES_9_6, POSTGRES_10, POSTGRES_11, POSTGRES_12, POSTGRES_13, - POSTGRES_14, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, - SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, - SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, - SQLSERVER_2019_ENTERPRISE, MYSQL_8_0_18, MYSQL_8_0_26, MYSQL_8_0_27, - MYSQL_8_0_28. --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10. @@ -139,6 +133,10 @@ FLAGS --enable-database-replication to enable and --no-enable-database-replication to disable. + --enable-password-policy + Enable the password policy, which enforces user password management + with the policies configured for the instance. + --enable-point-in-time-recovery Allows for data recovery from a specific point in time, down to a fraction of a second, via write-ahead logs. Must have automatic backups diff --git a/gcloud/alpha/storage/cp b/gcloud/alpha/storage/cp index c4a7e0cbf..b45cdb8b6 100644 --- a/gcloud/alpha/storage/cp +++ b/gcloud/alpha/storage/cp @@ -12,8 +12,8 @@ SYNOPSIS [--do-not-decompress] [--if-generation-match=GENERATION] [--if-metageneration-match=METAGENERATION] [--ignore-symlinks] [--manifest-path=MANIFEST_PATH, -L MANIFEST_PATH] - [--print-created-message, -v] [--recursive, -R, -r] - [--skip-unsupported, -U] + [--preserve-posix, -P] [--print-created-message, -v] + [--recursive, -R, -r] [--skip-unsupported, -U] [--storage-class=STORAGE_CLASS, -s STORAGE_CLASS] [--gzip-in-flight-all, -J | --gzip-in-flight-extensions=[FILE_EXTENSIONS,...], @@ -135,6 +135,20 @@ FLAGS file are not retried by future commands. Objects marked as "error" are retried. + --preserve-posix, -P + Causes POSIX attributes to be preserved when objects are copied. With + this feature enabled, gcloud storage will copy several fields provided + by the stat command: access time, modification time, owner UID, owner + group GID, and the mode (permissions) of the file. + + For uploads, these attributes are read off of local files and stored in + the cloud as custom metadata. For downloads, custom cloud metadata is + set as POSIX attributes on files after they are downloaded. + + On Windows, this flag will only set and restore access time and + modification time because Windows doesn't have a notion of POSIX UID, + GID, and mode. + --print-created-message, -v Prints the version-specific URL for each copied object. diff --git a/gcloud/alpha/web-security-scanner/scan-configs/create b/gcloud/alpha/web-security-scanner/scan-configs/create index b8cdd4be0..cf2b1dd91 100644 --- a/gcloud/alpha/web-security-scanner/scan-configs/create +++ b/gcloud/alpha/web-security-scanner/scan-configs/create @@ -54,7 +54,7 @@ OPTIONAL FLAGS --target-platforms=[TARGET_PLATFORMS,...]; default="app_engine,compute" List of platforms the site is running on. Defaults to 'app_engine,compute'. TARGET_PLATFORMS must be one of: app-engine, - compute, target-platform-unspecified. + cloud-run, compute, target-platform-unspecified. --user-agent=USER_AGENT List of user agents to use when crawling. Defaults to 'chrome_linux'. diff --git a/gcloud/alpha/web-security-scanner/scan-configs/update b/gcloud/alpha/web-security-scanner/scan-configs/update index 19af144f8..523f68130 100644 --- a/gcloud/alpha/web-security-scanner/scan-configs/update +++ b/gcloud/alpha/web-security-scanner/scan-configs/update @@ -87,7 +87,7 @@ FLAGS --target-platforms=[TARGET_PLATFORMS,...]; default="app_engine,compute" List of platforms the site is running on. Defaults to 'app_engine,compute'. TARGET_PLATFORMS must be one of: app-engine, - compute, target-platform-unspecified. + cloud-run, compute, target-platform-unspecified. --user-agent=USER_AGENT List of user agents to use when crawling. Defaults to 'chrome_linux'. diff --git a/gcloud/anthos/config/controller/create b/gcloud/anthos/config/controller/create index 147998c41..06148eb8a 100644 --- a/gcloud/anthos/config/controller/create +++ b/gcloud/anthos/config/controller/create @@ -43,8 +43,9 @@ POSITIONAL ARGUMENTS --location=LOCATION The name of the Config Controller instance location. Currently, only - us-central1, us-east1, northamerica-northeast1, and asia-northeast1 - are supported. To set the location attribute: + us-central1, us-east1, northamerica-northeast1, europe-north1, + australia-southeast1, and asia-northeast1 are supported. To set the + location attribute: ▸ provide the argument name on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/anthos/config/controller/delete b/gcloud/anthos/config/controller/delete index 21372ebc0..2914bd061 100644 --- a/gcloud/anthos/config/controller/delete +++ b/gcloud/anthos/config/controller/delete @@ -37,8 +37,9 @@ POSITIONAL ARGUMENTS --location=LOCATION The name of the Anthos Config Controller instance location. - Currently, only us-central1, us-east1, northamerica-northeast1, and - asia-northeast1 are supported. To set the location attribute: + Currently, only us-central1, us-east1, northamerica-northeast1, + europe-north1, australia-southeast1 and asia-northeast1 are + supported. To set the location attribute: ▸ provide the argument name on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/anthos/config/controller/describe b/gcloud/anthos/config/controller/describe index d806eb50c..fd7302a67 100644 --- a/gcloud/anthos/config/controller/describe +++ b/gcloud/anthos/config/controller/describe @@ -39,8 +39,9 @@ POSITIONAL ARGUMENTS --location=LOCATION The name of the Anthos Config Controller instance location. - Currently, only us-central1, us-east1, northamerica-northeast1, and - asia-northeast1 are supported. To set the location attribute: + Currently, only us-central1, us-east1, northamerica-northeast1, + europe-north1, australia-southeast1 and asia-northeast1 are + supported. To set the location attribute: ▸ provide the argument name on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/anthos/config/operations/describe b/gcloud/anthos/config/operations/describe index 8fbc91160..4e22a493f 100644 --- a/gcloud/anthos/config/operations/describe +++ b/gcloud/anthos/config/operations/describe @@ -39,8 +39,9 @@ POSITIONAL ARGUMENTS --location=LOCATION The name of the Anthos Config Controller instance location. - Currently, only us-central1, us-east1, northamerica-northeast1, and - asia-northeast1 are supported. To set the location attribute: + Currently, only us-central1, us-east1, northamerica-northeast1, + europe-north1, australia-southeast1 and asia-northeast1 are + supported. To set the location attribute: ▸ provide the argument operation on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/artifacts/versions/list b/gcloud/artifacts/versions/list index 7ee289e66..0342fb404 100644 --- a/gcloud/artifacts/versions/list +++ b/gcloud/artifacts/versions/list @@ -17,6 +17,13 @@ EXAMPLES $ gcloud artifacts versions list --limit=5 + The following command lists versions in my-package by specifying the + fully-qualified path: + + $ gcloud artifacts versions list \ + --package=projects/my-project/locations/my-location/\ + repositories/my-repo/packages/my-package + REQUIRED FLAGS Package resource - The parent package for the list of versions. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/beta/ai/model-monitoring-jobs/create b/gcloud/beta/ai/model-monitoring-jobs/create index 2923a4a7e..34321c632 100644 --- a/gcloud/beta/ai/model-monitoring-jobs/create +++ b/gcloud/beta/ai/model-monitoring-jobs/create @@ -7,7 +7,8 @@ SYNOPSIS --emails=[EMAILS,...] --endpoint=ENDPOINT --prediction-sampling-rate=PREDICTION_SAMPLING_RATE [--analysis-instance-schema=ANALYSIS_INSTANCE_SCHEMA] - [--labels=[KEY=VALUE,...]] [--log-ttl=LOG_TTL] + [--[no-]anomaly-cloud-logging] [--labels=[KEY=VALUE,...]] + [--log-ttl=LOG_TTL] [--monitoring-frequency=MONITORING_FREQUENCY; default=24] [--predict-instance-schema=PREDICT_INSTANCE_SCHEMA] [--region=REGION] [--sample-predict-request=SAMPLE_PREDICT_REQUEST] @@ -98,6 +99,11 @@ OPTIONAL FLAGS single instance that you want Tensorflow Data Validation (TFDV) to analyze. + --[no-]anomaly-cloud-logging + If true, anomaly will be sent to Cloud Logging. Use + --anomaly-cloud-logging to enable and --no-anomaly-cloud-logging to + disable. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/ai/model-monitoring-jobs/update b/gcloud/beta/ai/model-monitoring-jobs/update index ecf191b53..4c037050c 100644 --- a/gcloud/beta/ai/model-monitoring-jobs/update +++ b/gcloud/beta/ai/model-monitoring-jobs/update @@ -6,8 +6,9 @@ SYNOPSIS gcloud beta ai model-monitoring-jobs update (MONITORING_JOB : --region=REGION) [--analysis-instance-schema=ANALYSIS_INSTANCE_SCHEMA] - [--display-name=DISPLAY_NAME] [--emails=[EMAILS,...]] - [--log-ttl=LOG_TTL] [--monitoring-frequency=MONITORING_FREQUENCY] + [--[no-]anomaly-cloud-logging] [--display-name=DISPLAY_NAME] + [--emails=[EMAILS,...]] [--log-ttl=LOG_TTL] + [--monitoring-frequency=MONITORING_FREQUENCY] [--prediction-sampling-rate=PREDICTION_SAMPLING_RATE] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] @@ -59,6 +60,11 @@ FLAGS single instance that you want Tensorflow Data Validation (TFDV) to analyze. + --[no-]anomaly-cloud-logging + If true, anomaly will be sent to Cloud Logging. Use + --anomaly-cloud-logging to enable and --no-anomaly-cloud-logging to + disable. + --display-name=DISPLAY_NAME Display name of the model deployment monitoring job. diff --git a/gcloud/beta/artifacts/versions/list b/gcloud/beta/artifacts/versions/list index acd86c5c1..b4f774918 100644 --- a/gcloud/beta/artifacts/versions/list +++ b/gcloud/beta/artifacts/versions/list @@ -19,6 +19,13 @@ EXAMPLES $ gcloud beta artifacts versions list --limit=5 + The following command lists versions in my-package by specifying the + fully-qualified path: + + $ gcloud beta artifacts versions list \ + --package=projects/my-project/locations/my-location/\ + repositories/my-repo/packages/my-package + REQUIRED FLAGS Package resource - The parent package for the list of versions. The arguments in this group can be used to specify the attributes of this diff --git a/gcloud/beta/compute/instance-templates/create b/gcloud/beta/compute/instance-templates/create index faa6ee7ef..9bbbff33d 100644 --- a/gcloud/beta/compute/instance-templates/create +++ b/gcloud/beta/compute/instance-templates/create @@ -16,7 +16,8 @@ SYNOPSIS [--[no-]enable-nested-virtualization] [--[no-]enable-uefi-networking] [--host-error-timeout-seconds=HOST_ERROR_TIMEOUT_SECONDS] [--instance-termination-action=INSTANCE_TERMINATION_ACTION] - [--ipv6-network-tier=IPV6_NETWORK_TIER] [--labels=[KEY=VALUE,...]] + [--ipv6-network-tier=IPV6_NETWORK_TIER] + [--key-revocation-action-type=POLICY] [--labels=[KEY=VALUE,...]] [--local-ssd=[device-name=DEVICE-NAME],[interface=INTERFACE]] [--machine-type=MACHINE_TYPE] [--maintenance-policy=MAINTENANCE_POLICY] [--mesh=[gke-cluster=GKE-CLUSTER],[workload=WORKLOAD]] @@ -370,6 +371,16 @@ FLAGS PREMIUM High quality, Google-grade network tier. + --key-revocation-action-type=POLICY + Specifies the behavior of the instance when the KMS key of one of its + attached disks is revoked. The default is none. POLICY must be one of: + + none + No operation is performed. + stop + The instance is stopped when the KMS key of one of its attached + disks is revoked. + --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/beta/compute/project-info/update b/gcloud/beta/compute/project-info/update index 8696fa66d..2aac1ed1d 100644 --- a/gcloud/beta/compute/project-info/update +++ b/gcloud/beta/compute/project-info/update @@ -13,7 +13,7 @@ DESCRIPTION FLAGS --default-network-tier=DEFAULT_NETWORK_TIER The default network tier to assign to the project. DEFAULT_NETWORK_TIER - must be one of: PREMIUM, STANDARD. + must be one of: PREMIUM, STANDARD, FIXED_STANDARD. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index d4852a429..e27ab04ad 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -284,6 +284,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 368c0184f..5f90ef711 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -316,6 +316,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index 2339d15e8..6bc6208ed 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -318,6 +318,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 1288239d9..e352c0c25 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -331,6 +331,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 9c3a53723..6f4f54c3e 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -292,6 +292,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/beta/network-services/service-bindings/create b/gcloud/beta/network-services/service-bindings/create index ab6cb0e20..c696948b6 100644 --- a/gcloud/beta/network-services/service-bindings/create +++ b/gcloud/beta/network-services/service-bindings/create @@ -83,8 +83,10 @@ API REFERENCE 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: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services service-bindings create $ gcloud alpha network-services service-bindings create diff --git a/gcloud/beta/network-services/service-bindings/delete b/gcloud/beta/network-services/service-bindings/delete index 94c1f7241..7d040fd60 100644 --- a/gcloud/beta/network-services/service-bindings/delete +++ b/gcloud/beta/network-services/service-bindings/delete @@ -62,8 +62,10 @@ API REFERENCE 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: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services service-bindings delete $ gcloud alpha network-services service-bindings delete diff --git a/gcloud/beta/network-services/service-bindings/describe b/gcloud/beta/network-services/service-bindings/describe index c8d023536..016c45585 100644 --- a/gcloud/beta/network-services/service-bindings/describe +++ b/gcloud/beta/network-services/service-bindings/describe @@ -56,8 +56,10 @@ API REFERENCE 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: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services service-bindings describe $ gcloud alpha network-services service-bindings describe diff --git a/gcloud/beta/network-services/service-bindings/help b/gcloud/beta/network-services/service-bindings/help index 859f9796d..ea536cfe3 100644 --- a/gcloud/beta/network-services/service-bindings/help +++ b/gcloud/beta/network-services/service-bindings/help @@ -30,8 +30,10 @@ COMMANDS (BETA) List service bindings. 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 network-services service-bindings $ gcloud alpha network-services service-bindings diff --git a/gcloud/beta/network-services/service-bindings/list b/gcloud/beta/network-services/service-bindings/list index 19c42837b..14211692c 100644 --- a/gcloud/beta/network-services/service-bindings/list +++ b/gcloud/beta/network-services/service-bindings/list @@ -78,8 +78,10 @@ API REFERENCE 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: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services service-bindings list $ gcloud alpha network-services service-bindings list diff --git a/gcloud/beta/run/jobs/add-iam-policy-binding b/gcloud/beta/run/jobs/add-iam-policy-binding new file mode 100644 index 000000000..878f4bfcf --- /dev/null +++ b/gcloud/beta/run/jobs/add-iam-policy-binding @@ -0,0 +1,140 @@ +NAME + gcloud beta run jobs add-iam-policy-binding - add IAM policy binding to a + Cloud Run job + +SYNOPSIS + gcloud beta run jobs add-iam-policy-binding JOB --member=PRINCIPAL + --role=ROLE [--region=REGION] + [--condition=[KEY=VALUE,...] + | --condition-from-file=CONDITION_FROM_FILE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Add an IAM policy binding to the IAM policy of a Cloud Run job. One + binding consists of a member, a role, and an optional condition. + +EXAMPLES + To add an IAM policy binding for the role of 'roles/run.invoker' for the + user 'test-user@gmail.com' with job 'my-job' and region 'us-central1', run: + + $ gcloud beta run jobs add-iam-policy-binding my-job \ + --region='us-central1' --member='user:test-user@gmail.com' \ + --role='roles/run.invoker' + + To add an IAM policy binding which expires at the end of the year 2019 for + the role of 'roles/run.invoker' and the user 'test-user@gmail.com' with job + 'my-job' and region 'us-central1', run: + + $ gcloud beta run jobs add-iam-policy-binding my-job \ + --region='us-central1' --member='user:test-user@gmail.com' \ + --role='roles/run.invoker' \ + --condition='expression=request.time < + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ + tion=Expires at midnight on 2019-12-31' + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Job resource - The job for which to add IAM policy binding 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 job on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. To set the region + attribute: + ◆ provide the argument job on the command line with a fully specified + name; + ◆ provide the argument --region on the command line; + ◆ set the property run/region; + ◆ specify from a list of available regions in a prompt. + + This must be specified. + + JOB + ID of the job or fully qualified identifier for the job. To set the + job attribute: + ▸ provide the argument job on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to add the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + Role name to assign to the principal. The role name is the complete + path of a predefined role, such as roles/logging.viewer, or the role ID + for a custom role, such as + organizations/{ORGANIZATION_ID}/roles/logging.viewer. + +OPTIONAL FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + At most one of these can be specified: + + --condition=[KEY=VALUE,...] + A condition to include in the binding. When the condition is + explicitly specified as None (--condition=None), a binding without a + condition is added. When the condition is specified and is not None, + --role cannot be a basic role. Basic roles are roles/editor, + roles/owner, and roles/viewer. For more on conditions, refer to the + conditions overview guide: + https://cloud.google.com/iam/docs/conditions-overview + + When using the --condition flag, include the following key-value + pairs: + + expression + (Required) Condition expression that evaluates to True or False. + This uses a subset of Common Expression Language syntax. + + If the condition expression includes a comma, use a different + delimiter to separate the key-value pairs. Specify the delimiter + before listing the key-value pairs. For example, to specify a + colon (:) as the delimiter, do the following: + --condition=^:^title=TITLE:expression=EXPRESSION. For more + information, see + https://cloud.google.com/sdk/gcloud/reference/topic/escaping. + + title + (Required) A short string describing the purpose of the + expression. + + description + (Optional) Additional description for the expression. + + --condition-from-file=CONDITION_FROM_FILE + Path to a local JSON or YAML file that defines the condition. To see + available fields, see the help for --condition. + +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 run/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/run/ + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha run jobs add-iam-policy-binding + diff --git a/gcloud/beta/run/jobs/create b/gcloud/beta/run/jobs/create new file mode 100644 index 000000000..60d47ebd7 --- /dev/null +++ b/gcloud/beta/run/jobs/create @@ -0,0 +1,187 @@ +NAME + gcloud beta run jobs create - deploy a new job to Cloud Run + +SYNOPSIS + gcloud beta run jobs create [JOB] --image=IMAGE [--args=[ARG,...]] + [--binary-authorization=POLICY] [--breakglass=JUSTIFICATION] + [--command=[COMMAND,...]] [--cpu=CPU] [--execute-now] [--key=KEY] + [--labels=[KEY=VALUE,...]] [--max-retries=MAX_RETRIES] + [--memory=MEMORY] [--parallelism=PARALLELISM] [--region=REGION] + [--service-account=SERVICE_ACCOUNT] + [--set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] + [--set-env-vars=[KEY=VALUE,...]] + [--set-secrets=[KEY=SECRET_NAME:SECRET_VERSION,...]] + [--task-timeout=TASK_TIMEOUT] [--tasks=TASKS; default=1] + [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] + [--async | --wait] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Deploys a new job to Google Cloud Run. + +EXAMPLES + To deploy a new job my-data-transformation on Cloud Run: + + $ gcloud beta run jobs create my-data-transformation \ + --image=us-docker.pkg.dev/project/image + + You may also omit the job name. Then a prompt will be displayed with a + suggested default value: + + $ gcloud beta run jobs create --image=us-docker.pkg.dev/project/image + +POSITIONAL ARGUMENTS + Job resource - Job to create. 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 JOB on the command line with a fully specified + name; + ◆ specify the job name from an interactive prompt with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + [JOB] + ID of the Job or fully qualified identifier for the Job. To set the + jobs attribute: + ▸ provide the argument JOB on the command line; + ▸ specify the job name from an interactive prompt. + +REQUIRED FLAGS + --image=IMAGE + Name of the container image to deploy (e.g. + gcr.io/cloudrun/hello:latest). + +OPTIONAL FLAGS + --args=[ARG,...] + Comma-separated arguments passed to the command run by the container + image. If not specified and no '--command' is provided, the container + image's default Cmd is used. Otherwise, if not specified, no arguments + are passed. To reset this field to its default, pass an empty string. + + --binary-authorization=POLICY + Binary Authorization policy to check against. This must be set to + "default". + + --breakglass=JUSTIFICATION + Justification to bypass Binary Authorization policy constraints and + allow the operation. See + https://cloud.google.com/binary-authorization/docs/using-breakglass for + more information. + + --command=[COMMAND,...] + Entrypoint for the container image. If not specified, the container + image's default Entrypoint is run. To reset this field to its default, + pass an empty string. + + --cpu=CPU + Set a CPU limit in Kubernetes cpu units. + + Cloud Run (fully managed) supports values 1, 2 and 4. For Cloud Run + (fully managed), 4 cpus also requires a minimum 2Gi --memory value. + Examples 2, 2.0, 2000m + + --execute-now + Execute the job immediately after creation. + + --key=KEY + CMEK key reference to encrypt the container with. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + --max-retries=MAX_RETRIES + Number of times an task is allowed to restart in case of failure before + being failed permanently. This applies per-task, not per-job. If set to + 0, tasks will only run once and never be retried on failure. + + --memory=MEMORY + Set a memory limit. Ex: 1024Mi, 4Gi. + + --parallelism=PARALLELISM + Number of tasks that may run concurrently. Must be less than or equal + to the number of tasks. Set to 0 to unset. + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + --service-account=SERVICE_ACCOUNT + Service account associated with the revision of the service. The + service account represents the identity of the running revision, and + determines what permissions the revision has. For the managed platform, + this is the email address of an IAM service account. For the + Kubernetes-based platforms (gke, kubernetes), this is the name of a + Kubernetes service account in the same namespace as the service. If not + provided, the revision will use the default service account of the + project, or default Kubernetes namespace service account respectively. + + --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + You can specify a name of a Cloud SQL instance if it's in the same + project and region as your Cloud Run resource; otherwise specify + :: for the instance. + + --set-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. + + --set-secrets=[KEY=SECRET_NAME:SECRET_VERSION,...] + Specify secrets to provide as environment variables. For example: + '--set-secrets=ENV=mysecret:latest,OTHER_ENV=othersecret:1' will create + an environment variable named ENV whose value is the latest version of + secret 'mysecret' and an environment variable OTHER_ENV whose value is + version of 1 of secret 'othersecret'. + + --task-timeout=TASK_TIMEOUT + Set the maximum time (deadline) a job task attempt can run for. In the + case of retries, this deadline applies to each attempt of a task. If + the task attempt does not complete within this time, it will be killed. + It is specified as a duration; for example, "10m5s" is ten minutes, and + five seconds. If you don't specify a unit, seconds is assumed. For + example, "10" is 10 seconds. + + --tasks=TASKS; default=1 + Number of tasks that must run to completion for the job to be + considered done. Use this flag to trigger multiple runs of the job. + + --vpc-connector=VPC_CONNECTOR + Set a VPC connector for this resource. + + --vpc-egress=VPC_EGRESS + The outbound traffic to send through the VPC connector for this + resource. This resource must have a VPC connector to set VPC egress. + VPC_EGRESS must be one of: + + all + (DEPRECATED) Sends all outbound traffic through the VPC connector. + Provides the same functionality as 'all-traffic'. Prefer to use + 'all-traffic' instead. + all-traffic + Sends all outbound traffic through the VPC connector. + private-ranges-only + Default option. Sends outbound traffic to private IP addresses + defined by RFC1918 through the VPC connector. + + At most one of these can be specified: + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --wait + Wait until the execution has completed running before exiting. If not + set, gcloud exits successfully when the execution has started. + Implies --execute-now. + +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 run jobs create + diff --git a/gcloud/beta/run/jobs/delete b/gcloud/beta/run/jobs/delete new file mode 100644 index 000000000..dadd2ab51 --- /dev/null +++ b/gcloud/beta/run/jobs/delete @@ -0,0 +1,49 @@ +NAME + gcloud beta run jobs delete - delete a job + +SYNOPSIS + gcloud beta run jobs delete JOB [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a job. + +EXAMPLES + To delete a job: + + $ gcloud beta run jobs delete job-name + +POSITIONAL ARGUMENTS + Job resource - Job to delete. 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 JOB 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. + + JOB + ID of the Job or fully qualified identifier for the Job. To set the + jobs attribute: + ▸ provide the argument JOB on the command line. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +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 run jobs delete + diff --git a/gcloud/beta/run/jobs/execute b/gcloud/beta/run/jobs/execute new file mode 100644 index 000000000..b9b13431c --- /dev/null +++ b/gcloud/beta/run/jobs/execute @@ -0,0 +1,61 @@ +NAME + gcloud beta run jobs execute - execute a job + +SYNOPSIS + gcloud beta run jobs execute [JOB] [--region=REGION] [--async | --wait] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Execute a job. + +EXAMPLES + To execute a job: + + $ gcloud beta run jobs execute my-job + +POSITIONAL ARGUMENTS + Job resource - Job to execute. 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 JOB on the command line with a fully specified + name; + ◆ specify the job name from an interactive prompt with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + [JOB] + ID of the Job or fully qualified identifier for the Job. To set the + jobs attribute: + ▸ provide the argument JOB on the command line; + ▸ specify the job name from an interactive prompt. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + At most one of these can be specified: + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --wait + Wait until the execution has completed running before exiting. If not + set, gcloud exits successfully when the execution has started. + +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 run jobs execute + diff --git a/gcloud/beta/run/jobs/executions/delete b/gcloud/beta/run/jobs/executions/delete new file mode 100644 index 000000000..ff9ba7a9c --- /dev/null +++ b/gcloud/beta/run/jobs/executions/delete @@ -0,0 +1,50 @@ +NAME + gcloud beta run jobs executions delete - delete an execution + +SYNOPSIS + gcloud beta run jobs executions delete EXECUTION [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete an execution. + +EXAMPLES + To delete an execution: + + $ gcloud beta run jobs executions delete my-execution + +POSITIONAL ARGUMENTS + Execution resource - Execution to delete. 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 EXECUTION 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. + + EXECUTION + ID of the Execution or fully qualified identifier for the Execution. + To set the executions attribute: + ▸ provide the argument EXECUTION on the command line. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +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 run jobs executions delete + diff --git a/gcloud/beta/run/jobs/executions/help b/gcloud/beta/run/jobs/executions/help index cdecd9601..924dbbc8e 100644 --- a/gcloud/beta/run/jobs/executions/help +++ b/gcloud/beta/run/jobs/executions/help @@ -34,9 +34,15 @@ GROUPS COMMANDS COMMAND is one of the following: + delete + (BETA) Delete an execution. + describe (BETA) Obtain details about executions. + list + (BETA) List executions. + NOTES This command is currently in beta and might change without notice. This variant is also available: diff --git a/gcloud/beta/run/jobs/executions/list b/gcloud/beta/run/jobs/executions/list new file mode 100644 index 000000000..42a7f30a6 --- /dev/null +++ b/gcloud/beta/run/jobs/executions/list @@ -0,0 +1,84 @@ +NAME + gcloud beta run jobs executions list - list executions + +SYNOPSIS + gcloud beta run jobs executions list [--job=JOB] [--namespace=NAMESPACE] + [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List executions. + +EXAMPLES + To list all executions in all regions: + + $ gcloud beta run jobs executions list + +FLAGS + --job=JOB + Limit matched resources to the given job. + + Namespace resource - Namespace to list executions in. This represents a + Cloud resource. + + --namespace=NAMESPACE + ID of the namespace or fully qualified identifier for the namespace. + To set the namespace attribute: + ▸ provide the argument --namespace on the command line; + ▸ set the property run/namespace; + ▸ For Cloud Run on Kubernetes Engine, defaults to "default". + Otherwise, defaults to project ID.; + ▸ provide the argument project on the command line; + ▸ set the property core/project. + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +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 run jobs executions list + diff --git a/gcloud/beta/run/jobs/executions/tasks/help b/gcloud/beta/run/jobs/executions/tasks/help index 3b197e7eb..5254e8a28 100644 --- a/gcloud/beta/run/jobs/executions/tasks/help +++ b/gcloud/beta/run/jobs/executions/tasks/help @@ -31,6 +31,9 @@ COMMANDS describe (BETA) Obtain details about tasks. + list + (BETA) List tasks. + NOTES This command is currently in beta and might change without notice. This variant is also available: diff --git a/gcloud/beta/run/jobs/executions/tasks/list b/gcloud/beta/run/jobs/executions/tasks/list new file mode 100644 index 000000000..3e009f280 --- /dev/null +++ b/gcloud/beta/run/jobs/executions/tasks/list @@ -0,0 +1,87 @@ +NAME + gcloud beta run jobs executions tasks list - list tasks + +SYNOPSIS + gcloud beta run jobs executions tasks list --execution=EXECUTION + [--region=REGION] [--succeeded] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List tasks. + +EXAMPLES + To list all tasks for an execution: + + $ gcloud beta run jobs executions tasks list --execution=my-execution + +REQUIRED FLAGS + Execution resource - Execution for which to list tasks. 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 --execution 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. + + --execution=EXECUTION + ID of the Execution or fully qualified identifier for the Execution. + To set the executions attribute: + ▸ provide the argument --execution on the command line. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + --succeeded + Include succeeded tasks. + +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 run jobs executions tasks list + diff --git a/gcloud/beta/run/jobs/help b/gcloud/beta/run/jobs/help index cbbf54b2e..88dd450fe 100644 --- a/gcloud/beta/run/jobs/help +++ b/gcloud/beta/run/jobs/help @@ -33,12 +33,36 @@ GROUPS COMMANDS COMMAND is one of the following: + add-iam-policy-binding + (BETA) Add IAM policy binding to a Cloud Run job. + + create + (BETA) Deploy a new job to Cloud Run. + + delete + (BETA) Delete a job. + describe (BETA) Obtain details about jobs. + execute + (BETA) Execute a job. + get-iam-policy (BETA) Get the IAM policy for a Cloud Run job. + list + (BETA) List jobs. + + remove-iam-policy-binding + (BETA) Remove IAM policy binding of a Cloud Run job. + + set-iam-policy + (BETA) Set the IAM policy for a job. + + update + (BETA) Update a Cloud Run Job. + NOTES This command is currently in beta and might change without notice. This variant is also available: diff --git a/gcloud/beta/run/jobs/list b/gcloud/beta/run/jobs/list new file mode 100644 index 000000000..f021c8e84 --- /dev/null +++ b/gcloud/beta/run/jobs/list @@ -0,0 +1,80 @@ +NAME + gcloud beta run jobs list - list jobs + +SYNOPSIS + gcloud beta run jobs list [--namespace=NAMESPACE] [--region=REGION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List jobs. + +EXAMPLES + To list all jobs in all regions: + + $ gcloud beta run jobs list + +FLAGS + Namespace resource - Namespace to list jobs in. This represents a Cloud + resource. + + --namespace=NAMESPACE + ID of the namespace or fully qualified identifier for the namespace. + To set the namespace attribute: + ▸ provide the argument --namespace on the command line; + ▸ set the property run/namespace; + ▸ For Cloud Run on Kubernetes Engine, defaults to "default". + Otherwise, defaults to project ID.; + ▸ provide the argument project on the command line; + ▸ set the property core/project. + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +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 run jobs list + diff --git a/gcloud/beta/run/jobs/remove-iam-policy-binding b/gcloud/beta/run/jobs/remove-iam-policy-binding new file mode 100644 index 000000000..f65074349 --- /dev/null +++ b/gcloud/beta/run/jobs/remove-iam-policy-binding @@ -0,0 +1,146 @@ +NAME + gcloud beta run jobs remove-iam-policy-binding - remove IAM policy binding + of a Cloud Run job + +SYNOPSIS + gcloud beta run jobs remove-iam-policy-binding JOB --member=PRINCIPAL + --role=ROLE [--region=REGION] + [--all | --condition=[KEY=VALUE,...] + | --condition-from-file=CONDITION_FROM_FILE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Remove an IAM policy binding from the IAM policy of a job. One + binding consists of a member, a role, and an optional condition. + +EXAMPLES + To remove an IAM policy binding for the role of 'roles/run.invoker' for the + user 'test-user@gmail.com' with servcie 'my-job' and region 'us-central1', + run: + + $ gcloud beta run jobs remove-iam-policy-binding my-job \ + --region='us-central1' --member='user:test-user@gmail.com' \ + --role='roles/run.invoker' + + To remove an IAM policy binding which expires at the end of the year 2019 + for the role of 'roles/run.invoker' and the user 'test-user@gmail.com' with + job 'my-job' and region 'us-central1', run: + + $ gcloud beta run jobs remove-iam-policy-binding my-job \ + --region='us-central1' --member='user:test-user@gmail.com' \ + --role='roles/run.invoker' \ + --condition='expression=request.time < + timestamp("2020-01-01T00:00:00Z"),title=expires_end_of_2019,descrip\ + tion=Expires at midnight on 2019-12-31' + + See https://cloud.google.com/iam/docs/managing-policies for details of + policy role and member types. + +POSITIONAL ARGUMENTS + Job resource - The job for which to remove the IAM policy binding. 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 job on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. To set the region + attribute: + ◆ provide the argument job on the command line with a fully specified + name; + ◆ provide the argument --region on the command line; + ◆ set the property run/region; + ◆ specify from a list of available regions in a prompt. + + This must be specified. + + JOB + ID of the job or fully qualified identifier for the job. To set the + job attribute: + ▸ provide the argument job on the command line. + +REQUIRED FLAGS + --member=PRINCIPAL + The principal to remove the binding for. Should be of the form + user|group|serviceAccount:email or domain:domain. + + Examples: user:test-user@gmail.com, group:admins@example.com, + serviceAccount:test123@example.domain.com, or + domain:example.domain.com. + + Deleted principals have an additional deleted: prefix and a ?uid=UID + suffix, where UID is a unique identifier for the principal. Example: + deleted:user:test-user@gmail.com?uid=123456789012345678901. + + Some resources also accept the following special values: + ◆ allUsers - Special identifier that represents anyone who is on the + internet, with or without a Google account. + ◆ allAuthenticatedUsers - Special identifier that represents anyone + who is authenticated with a Google account or a service account. + + --role=ROLE + The role to remove the principal from. + +OPTIONAL FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + At most one of these can be specified: + + --all + Remove all bindings with this role and principal, irrespective of any + conditions. + + --condition=[KEY=VALUE,...] + The condition of the binding that you want to remove. When the + condition is explicitly specified as None (--condition=None), a + binding without a condition is removed. Otherwise, only a binding + with a condition that exactly matches the specified condition + (including the optional description) is removed. For more on + conditions, refer to the conditions overview guide: + https://cloud.google.com/iam/docs/conditions-overview + + When using the --condition flag, include the following key-value + pairs: + + expression + (Required) Condition expression that evaluates to True or False. + This uses a subset of Common Expression Language syntax. + + If the condition expression includes a comma, use a different + delimiter to separate the key-value pairs. Specify the delimiter + before listing the key-value pairs. For example, to specify a + colon (:) as the delimiter, do the following: + --condition=^:^title=TITLE:expression=EXPRESSION. For more + information, see + https://cloud.google.com/sdk/gcloud/reference/topic/escaping. + + title + (Required) A short string describing the purpose of the + expression. + + description + (Optional) Additional description for the expression. + + --condition-from-file=CONDITION_FROM_FILE + Path to a local JSON or YAML file that defines the condition. To see + available fields, see the help for --condition. + +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 run/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/run/ + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha run jobs remove-iam-policy-binding + diff --git a/gcloud/beta/run/jobs/set-iam-policy b/gcloud/beta/run/jobs/set-iam-policy new file mode 100644 index 000000000..c0eda9eb0 --- /dev/null +++ b/gcloud/beta/run/jobs/set-iam-policy @@ -0,0 +1,78 @@ +NAME + gcloud beta run jobs set-iam-policy - set the IAM policy for a job + +SYNOPSIS + gcloud beta run jobs set-iam-policy JOB POLICY_FILE [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command replaces the existing IAM policy for a job, given a job + and a file encoded in JSON or YAML that contains the IAM policy. If the + given policy file specifies an "etag" value, then the replacement will + succeed only if the policy already in place matches that etag. (An etag + obtain via get-iam-policy will prevent the replacement if the policy for + the job has been subsequently updated.) A policy file that does not contain + an etag value will replace any existing policy for the job. + +EXAMPLES + The following command will read an IAM policy defined in a JSON file + 'policy.json' and set it for a job with identifier 'my-job' + + $ gcloud beta run jobs set-iam-policy --region=us-central1 my-job \ + policy.json + + See https://cloud.google.com/iam/docs/managing-policies for details of the + policy file format and contents. + +POSITIONAL ARGUMENTS + Job resource - The job for which to set the IAM policy. 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 job on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. To set the region + attribute: + ◆ provide the argument job on the command line with a fully specified + name; + ◆ provide the argument --region on the command line; + ◆ set the property run/region; + ◆ specify from a list of available regions in a prompt. + + This must be specified. + + JOB + ID of the job or fully qualified identifier for the job. To set the + job attribute: + ▸ provide the argument job 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). + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +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 run/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/run/ + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha run jobs set-iam-policy + diff --git a/gcloud/beta/run/jobs/update b/gcloud/beta/run/jobs/update new file mode 100644 index 000000000..d5eb92ae0 --- /dev/null +++ b/gcloud/beta/run/jobs/update @@ -0,0 +1,271 @@ +NAME + gcloud beta run jobs update - update a Cloud Run Job + +SYNOPSIS + gcloud beta run jobs update [JOB] [--args=[ARG,...]] [--async] + [--breakglass=JUSTIFICATION] [--clear-vpc-connector] + [--command=[COMMAND,...]] [--cpu=CPU] [--image=IMAGE] [--key=KEY] + [--max-retries=MAX_RETRIES] [--memory=MEMORY] + [--parallelism=PARALLELISM] [--region=REGION] + [--service-account=SERVICE_ACCOUNT] [--task-timeout=TASK_TIMEOUT] + [--tasks=TASKS; default=1] [--vpc-connector=VPC_CONNECTOR] + [--vpc-egress=VPC_EGRESS] + [--add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + | --clear-cloudsql-instances + | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + | --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...]] + [--binary-authorization=POLICY | --clear-binary-authorization] + [--clear-env-vars | --env-vars-file=FILE_PATH + | --set-env-vars=[KEY=VALUE,...] + | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...] --labels=[KEY=VALUE,...] + | --update-labels=[KEY=VALUE,...]] + [--clear-secrets | --set-secrets=[KEY=VALUE,...] + | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Updates a Cloud Run job. + +EXAMPLES + To update the container image of Cloud Run job my-job: + + $ gcloud beta run jobs update my-job \ + --image=us-docker.pkg.dev/project/image + +POSITIONAL ARGUMENTS + Job resource - Job to update. 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 JOB on the command line with a fully specified + name; + ◆ specify the job name from an interactive prompt with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + [JOB] + ID of the Job or fully qualified identifier for the Job. To set the + jobs attribute: + ▸ provide the argument JOB on the command line; + ▸ specify the job name from an interactive prompt. + +FLAGS + --args=[ARG,...] + Comma-separated arguments passed to the command run by the container + image. If not specified and no '--command' is provided, the container + image's default Cmd is used. Otherwise, if not specified, no arguments + are passed. To reset this field to its default, pass an empty string. + + --async + Return immediately, without waiting for the operation in progress to + complete. + + --breakglass=JUSTIFICATION + Justification to bypass Binary Authorization policy constraints and + allow the operation. See + https://cloud.google.com/binary-authorization/docs/using-breakglass for + more information. + + --clear-vpc-connector + Remove the VPC connector for this resource. + + --command=[COMMAND,...] + Entrypoint for the container image. If not specified, the container + image's default Entrypoint is run. To reset this field to its default, + pass an empty string. + + --cpu=CPU + Set a CPU limit in Kubernetes cpu units. + + Cloud Run (fully managed) supports values 1, 2 and 4. For Cloud Run + (fully managed), 4 cpus also requires a minimum 2Gi --memory value. + Examples 2, 2.0, 2000m + + --image=IMAGE + Name of the container image to deploy (e.g. + gcr.io/cloudrun/hello:latest). + + --key=KEY + CMEK key reference to encrypt the container with. + + --max-retries=MAX_RETRIES + Number of times an task is allowed to restart in case of failure before + being failed permanently. This applies per-task, not per-job. If set to + 0, tasks will only run once and never be retried on failure. + + --memory=MEMORY + Set a memory limit. Ex: 1024Mi, 4Gi. + + --parallelism=PARALLELISM + Number of tasks that may run concurrently. Must be less than or equal + to the number of tasks. Set to 0 to unset. + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + --service-account=SERVICE_ACCOUNT + Service account associated with the revision of the service. The + service account represents the identity of the running revision, and + determines what permissions the revision has. For the managed platform, + this is the email address of an IAM service account. For the + Kubernetes-based platforms (gke, kubernetes), this is the name of a + Kubernetes service account in the same namespace as the service. If not + provided, the revision will use the default service account of the + project, or default Kubernetes namespace service account respectively. + + --task-timeout=TASK_TIMEOUT + Set the maximum time (deadline) a job task attempt can run for. In the + case of retries, this deadline applies to each attempt of a task. If + the task attempt does not complete within this time, it will be killed. + It is specified as a duration; for example, "10m5s" is ten minutes, and + five seconds. If you don't specify a unit, seconds is assumed. For + example, "10" is 10 seconds. + + --tasks=TASKS; default=1 + Number of tasks that must run to completion for the job to be + considered done. Use this flag to trigger multiple runs of the job. + + --vpc-connector=VPC_CONNECTOR + Set a VPC connector for this resource. + + --vpc-egress=VPC_EGRESS + The outbound traffic to send through the VPC connector for this + resource. This resource must have a VPC connector to set VPC egress. + VPC_EGRESS must be one of: + + all + (DEPRECATED) Sends all outbound traffic through the VPC connector. + Provides the same functionality as 'all-traffic'. Prefer to use + 'all-traffic' instead. + all-traffic + Sends all outbound traffic through the VPC connector. + private-ranges-only + Default option. Sends outbound traffic to private IP addresses + defined by RFC1918 through the VPC connector. + + These flags modify the Cloud SQL instances this Service connects to. You + can specify a name of a Cloud SQL instance if it's in the same project and + region as your Cloud Run service; otherwise specify + :: for the instance. + + At most one of these can be specified: + + --add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Append the given values to the current Cloud SQL instances. + + --clear-cloudsql-instances + Empty the current Cloud SQL instances. + + --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Remove the given values from the current Cloud SQL instances. + + --set-cloudsql-instances=[CLOUDSQL-INSTANCES,...] + Completely replace the current Cloud SQL instances with the given + values. + + At most one of these can be specified: + + --binary-authorization=POLICY + Binary Authorization policy to check against. This must be set to + "default". + + --clear-binary-authorization + Remove any previously set Binary Authorization policy. + + At most one of these can be specified: + + --clear-env-vars + 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. + + --set-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. All existing + environment variables will be removed first. + + Only --update-env-vars and --remove-env-vars can be used together. If + both are specified, --remove-env-vars will be applied first. + + --remove-env-vars=[KEY,...] + List of environment variables to be removed. + + --update-env-vars=[KEY=VALUE,...] + List of key-value pairs to set as environment variables. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta run jobs update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta run jobs update --clear-labels \ + --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + + At most one of these can be specified: + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + An alias to --update-labels. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Specify secrets to mount or provide as environment variables. Keys + starting with a forward slash '/' are mount paths. All other keys + correspond to environment variables. Values should be in the form + SECRET_NAME:SECRET_VERSION. For example: + '--update-secrets=/secrets/api/key=mysecret:latest,ENV=othersecret:1' will + mount a volume at '/secrets/api' containing a file 'key' with the latest + version of secret 'mysecret'. An environment variable named ENV will also + be created whose value is version 1 of secret 'othersecret'. + + At most one of these can be specified: + + --clear-secrets + Remove all secrets. + + --set-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. All existing secrets will + be removed first. + + Only --update-secrets and --remove-secrets can be used together. If both + are specified, --remove-secrets will be applied first. + + --remove-secrets=[KEY,...] + List of secrets to be removed. + + --update-secrets=[KEY=VALUE,...] + List of key-value pairs to set as secrets. + +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 run jobs update + diff --git a/gcloud/beta/sql/flags/list b/gcloud/beta/sql/flags/list index d96213cca..b69c20dbf 100644 --- a/gcloud/beta/sql/flags/list +++ b/gcloud/beta/sql/flags/list @@ -14,7 +14,7 @@ FLAGS --database-version=DATABASE_VERSION The database engine type and versions. If left unspecified, the API defaults are used. See the list of database versions at - https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion + https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 811f6a7ed..7f68ded63 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -15,7 +15,8 @@ SYNOPSIS [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] - [--enable-bin-log] [--enable-point-in-time-recovery] + [--enable-bin-log] [--enable-password-policy] + [--enable-point-in-time-recovery] [--failover-replica-name=FAILOVER_REPLICA_NAME] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] @@ -164,7 +165,7 @@ FLAGS --database-version=DATABASE_VERSION The database engine type and versions. If left unspecified, the API defaults are used. See the list of database versions at - https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion + https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10. @@ -180,6 +181,10 @@ FLAGS fraction of a second. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --enable-password-policy + Enable the password policy, which enforces user password management + with the policies configured for the instance. + --enable-point-in-time-recovery Allows for data recovery from a specific point in time, down to a fraction of a second, via write-ahead logs. Must have automatic backups diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index 632d41985..423cbb061 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -14,7 +14,8 @@ SYNOPSIS [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--diff] [--[no-]enable-bin-log] [--[no-]enable-database-replication] - [--enable-point-in-time-recovery] [--follow-gae-app=FOLLOW_GAE_APP] + [--enable-password-policy] [--enable-point-in-time-recovery] + [--follow-gae-app=FOLLOW_GAE_APP] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -107,13 +108,6 @@ FLAGS The database engine type and versions. If left unspecified, no changes occur. See the list of database versions at https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. - DATABASE_VERSION must be one of: MYSQL_5_6, MYSQL_5_7, MYSQL_8_0, - POSTGRES_9_6, POSTGRES_10, POSTGRES_11, POSTGRES_12, POSTGRES_13, - POSTGRES_14, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, - SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, - SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, - SQLSERVER_2019_ENTERPRISE, MYSQL_8_0_18, MYSQL_8_0_26, MYSQL_8_0_27, - MYSQL_8_0_28. --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10. @@ -139,6 +133,10 @@ FLAGS --enable-database-replication to enable and --no-enable-database-replication to disable. + --enable-password-policy + Enable the password policy, which enforces user password management + with the policies configured for the instance. + --enable-point-in-time-recovery Allows for data recovery from a specific point in time, down to a fraction of a second, via write-ahead logs. Must have automatic backups diff --git a/gcloud/compute/project-info/update b/gcloud/compute/project-info/update index e7422d337..799764b80 100644 --- a/gcloud/compute/project-info/update +++ b/gcloud/compute/project-info/update @@ -13,7 +13,7 @@ DESCRIPTION FLAGS --default-network-tier=DEFAULT_NETWORK_TIER The default network tier to assign to the project. DEFAULT_NETWORK_TIER - must be one of: PREMIUM, STANDARD. + must be one of: PREMIUM, STANDARD, FIXED_STANDARD. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/config/get b/gcloud/config/get index d533c3c2e..38691ae51 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -284,6 +284,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/config/help b/gcloud/config/help index 3ed59104e..d2969081c 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -316,6 +316,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/config/list b/gcloud/config/list index 4018ef265..be1af1ee7 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -318,6 +318,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/config/set b/gcloud/config/set index b74f56cbc..c3fa4a665 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -331,6 +331,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/config/unset b/gcloud/config/unset index ad4047d41..261d4b11f 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -292,6 +292,9 @@ AVAILABLE PROPERTIES eventarc Overrides API endpoint for gcloud eventarc command group. + eventarcpublishing + Overrides API endpoint for gcloud eventarc publish command group. + events Overrides API endpoint for gcloud events command group. diff --git a/gcloud/container/aws/clusters/create b/gcloud/container/aws/clusters/create index b2c12571c..9d60b6df6 100644 --- a/gcloud/container/aws/clusters/create +++ b/gcloud/container/aws/clusters/create @@ -161,7 +161,8 @@ OPTIONAL FLAGS IDs of additional security groups to add to control plane replicas. --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR - Name of the EC2 key pair to log in into control plane nodes. + Name of the EC2 key pair authorized to login to the control plane + nodes. --tags=TAG,[TAG,...] Applies the given tags (comma separated) on the cluster. Example: diff --git a/gcloud/container/aws/clusters/update b/gcloud/container/aws/clusters/update index 8b6808e3b..7cfa1c1e9 100644 --- a/gcloud/container/aws/clusters/update +++ b/gcloud/container/aws/clusters/update @@ -16,6 +16,7 @@ SYNOPSIS --proxy-secret-version-id=PROXY_SECRET_VERSION_ID] [--clear-security-group-ids | --security-group-ids=[SECURITY_GROUP_ID,...]] + [--clear-ssh-ec2-key-pair | --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -126,6 +127,17 @@ FLAGS --security-group-ids=[SECURITY_GROUP_ID,...] IDs of additional security groups to add to control plane replicas. + SSH config + + At most one of these can be specified: + + --clear-ssh-ec2-key-pair + Clear the EC2 key pair to log in into the control plane nodes. + + --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR + Name of the EC2 key pair authorized to login to the control plane + nodes. + 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/container/aws/node-pools/create b/gcloud/container/aws/node-pools/create index 854fcd089..444c18714 100644 --- a/gcloud/container/aws/node-pools/create +++ b/gcloud/container/aws/node-pools/create @@ -121,7 +121,7 @@ OPTIONAL FLAGS IDs of additional security groups to add to nodes. --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR - Name of the EC2 key pair to log in into control plane nodes. + Name of the EC2 key pair authorized to login to the node pool nodes. --tags=TAG,[TAG,...] Applies the given tags (comma separated) on the node pool. Example: diff --git a/gcloud/container/aws/node-pools/update b/gcloud/container/aws/node-pools/update index f3ce43bb8..c5cef059f 100644 --- a/gcloud/container/aws/node-pools/update +++ b/gcloud/container/aws/node-pools/update @@ -14,6 +14,7 @@ SYNOPSIS --proxy-secret-version-id=PROXY_SECRET_VERSION_ID] [--clear-security-group-ids | --security-group-ids=[SECURITY_GROUP_ID,...]] + [--clear-ssh-ec2-key-pair | --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR] [--max-nodes=MAX_NODES --min-nodes=MIN_NODES] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -120,6 +121,16 @@ FLAGS --security-group-ids=[SECURITY_GROUP_ID,...] IDs of additional security groups to add to nodes. + SSH config + + At most one of these can be specified: + + --clear-ssh-ec2-key-pair + Clear the EC2 key pair to log in into the node pool nodes. + + --ssh-ec2-key-pair=SSH_EC2_KEY_PAIR + Name of the EC2 key pair authorized to login to the node pool nodes. + Node pool autoscaling --max-nodes=MAX_NODES diff --git a/gcloud/eventarc/channel-connections/create b/gcloud/eventarc/channel-connections/create new file mode 100644 index 000000000..18b013e7e --- /dev/null +++ b/gcloud/eventarc/channel-connections/create @@ -0,0 +1,70 @@ +NAME + gcloud eventarc channel-connections create - create an Eventarc channel + connection + +SYNOPSIS + gcloud eventarc channel-connections create + (CHANNEL_CONNECTION : --location=LOCATION) + --activation-token=ACTIVATION_TOKEN --channel=CHANNEL [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create an Eventarc channel connection. + +EXAMPLES + To create a new channel connection my-channel-connection for channel + my-channel with activation token channel-activation-token, run: + + $ gcloud eventarc channel-connections create my-channel-connection \ + --channel=my-channel --activation-token=channel-activation-token + +POSITIONAL ARGUMENTS + Channel connection resource - Channel connection to create. 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 channel_connection 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. + + CHANNEL_CONNECTION + ID of the channel connection or fully qualified identifier for the + channel connection. To set the channel-connection attribute: + ▸ provide the argument channel_connection on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location for the Eventarc channel connection, which should be + either global or one of the supported regions. Alternatively, set the + [eventarc/location] property. To set the location attribute: + ▸ provide the argument channel_connection on the command line with + a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location. + +REQUIRED FLAGS + --activation-token=ACTIVATION_TOKEN + Activation token for the specified channel. + + --channel=CHANNEL + Subscriber channel for which to create the channel connection. This + argument should be the full channel name, including project, location + and the channel id. + +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. diff --git a/gcloud/eventarc/channel-connections/delete b/gcloud/eventarc/channel-connections/delete new file mode 100644 index 000000000..727270d5d --- /dev/null +++ b/gcloud/eventarc/channel-connections/delete @@ -0,0 +1,60 @@ +NAME + gcloud eventarc channel-connections delete - delete an Eventarc channel + connection + +SYNOPSIS + gcloud eventarc channel-connections delete + (CHANNEL_CONNECTION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete an Eventarc channel connection. + +EXAMPLES + To delete the channel connection my-channel-connection in location + us-central1, run: + + $ gcloud eventarc channel-connections delete my-channel-connection \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Channel connection resource - Channel connection to delete. 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 channel_connection 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. + + CHANNEL_CONNECTION + ID of the channel connection or fully qualified identifier for the + channel connection. To set the channel-connection attribute: + ▸ provide the argument channel_connection on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location for the Eventarc channel connection, which should be + either global or one of the supported regions. Alternatively, set the + [eventarc/location] property. To set the location attribute: + ▸ provide the argument channel_connection on the command line with + a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location. + +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. diff --git a/gcloud/eventarc/channel-connections/describe b/gcloud/eventarc/channel-connections/describe new file mode 100644 index 000000000..6a99d4639 --- /dev/null +++ b/gcloud/eventarc/channel-connections/describe @@ -0,0 +1,54 @@ +NAME + gcloud eventarc channel-connections describe - describe an Eventarc channel + connection + +SYNOPSIS + gcloud eventarc channel-connections describe + (CHANNEL_CONNECTION : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an Eventarc channel connection. + +EXAMPLES + To describe the channel connection my-channel-connection in location + us-central1, run: + + $ gcloud eventarc channel-connections describe \ + my-channel-connection --location=us-central1 + +POSITIONAL ARGUMENTS + Channel connection resource - Channel connection to describe. 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 channel_connection 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. + + CHANNEL_CONNECTION + ID of the channel connection or fully qualified identifier for the + channel connection. To set the channel-connection attribute: + ▸ provide the argument channel_connection on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location for the Eventarc channel connection, which should be + either global or one of the supported regions. Alternatively, set the + [eventarc/location] property. To set the location attribute: + ▸ provide the argument channel_connection on the command line with + a fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location. + +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. diff --git a/gcloud/eventarc/channel-connections/help b/gcloud/eventarc/channel-connections/help new file mode 100644 index 000000000..ba3b4a4eb --- /dev/null +++ b/gcloud/eventarc/channel-connections/help @@ -0,0 +1,28 @@ +NAME + gcloud eventarc channel-connections - manage Eventarc channel connections + +SYNOPSIS + gcloud eventarc channel-connections COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Eventarc channel connections. + +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 an Eventarc channel connection. + + delete + Delete an Eventarc channel connection. + + describe + Describe an Eventarc channel connection. + + list + List Eventarc channel connections. diff --git a/gcloud/eventarc/channel-connections/list b/gcloud/eventarc/channel-connections/list new file mode 100644 index 000000000..f6f0f0d8e --- /dev/null +++ b/gcloud/eventarc/channel-connections/list @@ -0,0 +1,84 @@ +NAME + gcloud eventarc channel-connections list - list Eventarc channel + connections + +SYNOPSIS + gcloud eventarc channel-connections list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Eventarc channel connections. + +EXAMPLES + To list all channel connections in location us-central1, run: + + $ gcloud eventarc channel-connections list --location=us-central1 + + To list all channel connections in all locations, run: + + $ gcloud eventarc channel-connections list --location=- + + or + + $ gcloud eventarc channel-connections list + +FLAGS + Location resource - Location for which to list channel connections. This + should be one of the supported regions. 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; + ◆ set the property eventarc/location with a fully specified name; + ◆ use '-' location to aggregate results for all Eventarc locations 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; + ▸ set the property eventarc/location; + ▸ use '-' location to aggregate results for all Eventarc locations. + +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. diff --git a/gcloud/eventarc/channels/create b/gcloud/eventarc/channels/create new file mode 100644 index 000000000..498c828c8 --- /dev/null +++ b/gcloud/eventarc/channels/create @@ -0,0 +1,73 @@ +NAME + gcloud eventarc channels create - create an Eventarc channel + +SYNOPSIS + gcloud eventarc channels create (CHANNEL : --location=LOCATION) + --provider=PROVIDER [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create an Eventarc channel. + +EXAMPLES + To create a new channel my-channel in location us-central1, run: + + $ gcloud eventarc channels create my-channel --location=us-central1 + +POSITIONAL ARGUMENTS + Channel resource - Channel to create. 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 channel 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. + + CHANNEL + ID of the channel or fully qualified identifier for the channel. To + set the channel attribute: + ▸ provide the argument channel on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location for the Eventarc channel, which should be either global + or one of the supported regions. Alternatively, set the + [eventarc/location] property. To set the location attribute: + ▸ provide the argument channel on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location. + +FLAGS + Provider resource - Provider to use for the channel. 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 --provider 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 --provider on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property eventarc/location. + + --provider=PROVIDER + ID of the provider or fully qualified identifier for the provider. To + set the provider attribute: + ▸ provide the argument --provider on the command line. + + --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. diff --git a/gcloud/eventarc/channels/delete b/gcloud/eventarc/channels/delete new file mode 100644 index 000000000..86d0f4ab9 --- /dev/null +++ b/gcloud/eventarc/channels/delete @@ -0,0 +1,56 @@ +NAME + gcloud eventarc channels delete - deletes an Eventarc channel + +SYNOPSIS + gcloud eventarc channels delete (CHANNEL : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Deletes an Eventarc channel. + +EXAMPLES + To delete the channel my-channel in location us-central1, run: + + $ gcloud eventarc channels delete my-channel --location=us-central1 + +POSITIONAL ARGUMENTS + Channel resource - Channel to delete. 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 channel 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. + + CHANNEL + ID of the channel or fully qualified identifier for the channel. To + set the channel attribute: + ▸ provide the argument channel on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location for the Eventarc channel, which should be either global + or one of the supported regions. Alternatively, set the + [eventarc/location] property. To set the location attribute: + ▸ provide the argument channel on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location. + +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. diff --git a/gcloud/eventarc/channels/describe b/gcloud/eventarc/channels/describe new file mode 100644 index 000000000..66d1358fb --- /dev/null +++ b/gcloud/eventarc/channels/describe @@ -0,0 +1,51 @@ +NAME + gcloud eventarc channels describe - describes an Eventarc channel + +SYNOPSIS + gcloud eventarc channels describe (CHANNEL : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describes an Eventarc channel. + +EXAMPLES + To describe the channel my-channel in location us-central1, run: + + $ gcloud eventarc channels describe my-channel --location=us-central1 + +POSITIONAL ARGUMENTS + Channel resource - Channel to describe. 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 channel 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. + + CHANNEL + ID of the channel or fully qualified identifier for the channel. To + set the channel attribute: + ▸ provide the argument channel on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location for the Eventarc channel, which should be either global + or one of the supported regions. Alternatively, set the + [eventarc/location] property. To set the location attribute: + ▸ provide the argument channel on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location. + +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. diff --git a/gcloud/eventarc/channels/help b/gcloud/eventarc/channels/help new file mode 100644 index 000000000..f351cb0a9 --- /dev/null +++ b/gcloud/eventarc/channels/help @@ -0,0 +1,28 @@ +NAME + gcloud eventarc channels - manage Eventarc channels + +SYNOPSIS + gcloud eventarc channels COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Eventarc channels. + +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 an Eventarc channel. + + delete + Deletes an Eventarc channel. + + describe + Describes an Eventarc channel. + + list + List Eventarc channels. diff --git a/gcloud/eventarc/channels/list b/gcloud/eventarc/channels/list new file mode 100644 index 000000000..181e61ea4 --- /dev/null +++ b/gcloud/eventarc/channels/list @@ -0,0 +1,83 @@ +NAME + gcloud eventarc channels list - list Eventarc channels + +SYNOPSIS + gcloud eventarc channels list [--location=LOCATION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List Eventarc channels. + +EXAMPLES + To list all channels in location us-central1, run: + + $ gcloud eventarc channels list --location=us-central1 + + To list all channels in all locations, run: + + $ gcloud eventarc channels list --location=- + + or + + $ gcloud eventarc channels list + +FLAGS + Location resource - Location for which to list channels. This should be + one of the supported regions. 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; + ◆ set the property eventarc/location with a fully specified name; + ◆ use '-' location to aggregate results for all Eventarc locations 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; + ▸ set the property eventarc/location; + ▸ use '-' location to aggregate results for all Eventarc locations. + +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. diff --git a/gcloud/eventarc/help b/gcloud/eventarc/help index 47eb88026..3511c7d18 100644 --- a/gcloud/eventarc/help +++ b/gcloud/eventarc/help @@ -15,6 +15,12 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + channel-connections + Manage Eventarc channel connections. + + channels + Manage Eventarc channels. + locations Explore locations available for Eventarc. diff --git a/gcloud/eventarc/triggers/create b/gcloud/eventarc/triggers/create index 696602c72..d24ebe7d0 100644 --- a/gcloud/eventarc/triggers/create +++ b/gcloud/eventarc/triggers/create @@ -11,7 +11,7 @@ SYNOPSIS --destination-gke-path=DESTINATION_GKE_PATH] | [--destination-run-service=DESTINATION_RUN_SERVICE : --destination-run-path=DESTINATION_RUN_PATH - --destination-run-region=DESTINATION_RUN_REGION]) + --destination-run-region=DESTINATION_RUN_REGION]) --channel=CHANNEL --transport-topic=TRANSPORT_TOPIC [--async] [--event-filters-path-pattern=[ATTRIBUTE=PATH_PATTERN,...]] [--service-account=SERVICE_ACCOUNT] [GCLOUD_WIDE_FLAG ...] @@ -120,6 +120,25 @@ REQUIRED FLAGS as the trigger. OPTIONAL FLAGS + Channel resource - The channel to use in the trigger. The channel is + needed only if trigger is created for a third-party provider. 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 --channel 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 --channel on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property eventarc/location. + + --channel=CHANNEL + ID of the channel or fully qualified identifier for the channel. To + set the channel attribute: + ▸ provide the argument --channel on the command line. + Pub/Sub topic resource - The Cloud Pub/Sub topic to use for the trigger's transport intermediary. This feature is currently only available for triggers of event type google.cloud.pubsub.topic.v1.messagePublished. The diff --git a/gcloud/network-services/help b/gcloud/network-services/help index 68341401d..d4e34b8ea 100644 --- a/gcloud/network-services/help +++ b/gcloud/network-services/help @@ -18,6 +18,9 @@ GROUPS endpoint-policies Manage Network Services EndpointPolicies. + service-bindings + Manage Network Services Bindings. + NOTES These variants are also available: diff --git a/gcloud/network-services/service-bindings/create b/gcloud/network-services/service-bindings/create new file mode 100644 index 000000000..7f3b6581a --- /dev/null +++ b/gcloud/network-services/service-bindings/create @@ -0,0 +1,90 @@ +NAME + gcloud network-services service-bindings create - create a service binding + +SYNOPSIS + gcloud network-services service-bindings create + (SERVICE_BINDING : --location=LOCATION) + --service-directory-namespace=SERVICE_DIRECTORY_NAMESPACE + --service-directory-region=SERVICE_DIRECTORY_REGION + --service-directory-service=SERVICE_DIRECTORY_SERVICE [--async] + [--description=DESCRIPTION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new service binding with the given name. + +EXAMPLES + Create a service binding with the name 'my-service-binding', + service-directory-region 'my-region', service-directory-namespace + 'my-namespace', service-directory-service 'my-service' and location + 'global'. + + $ gcloud network-services service-bindings create \ + my-service-binding --service-directory-region="my-region" \ + --service-directory-namespace="my-namespace" \ + --service-directory-service="my-service" --location="global" + +POSITIONAL ARGUMENTS + Service binding resource - Name of the service binding to be created. 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 service_binding on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + SERVICE_BINDING + ID of the service binding or fully qualified identifier for the + service binding. To set the service_binding attribute: + ▸ provide the argument service_binding on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument service_binding on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --service-directory-namespace=SERVICE_DIRECTORY_NAMESPACE + Namespace of the Service Directory service. + + --service-directory-region=SERVICE_DIRECTORY_REGION + Region of the Service Directory service. + + --service-directory-service=SERVICE_DIRECTORY_SERVICE + Service name of the Service Directory service. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the service binding. + +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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services service-bindings create + + $ gcloud beta network-services service-bindings create + diff --git a/gcloud/network-services/service-bindings/delete b/gcloud/network-services/service-bindings/delete new file mode 100644 index 000000000..77c697238 --- /dev/null +++ b/gcloud/network-services/service-bindings/delete @@ -0,0 +1,69 @@ +NAME + gcloud network-services service-bindings delete - delete service binding + +SYNOPSIS + gcloud network-services service-bindings delete + (SERVICE_BINDING : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete the specified service binding. + +EXAMPLES + To delete a service binding called 'my-service-binding', run: + + $ gcloud network-services service-bindings delete \ + my-service-binding --location=global + +POSITIONAL ARGUMENTS + Service binding resource - Name of the service binding you want to delete. + 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 service_binding on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + SERVICE_BINDING + ID of the service binding or fully qualified identifier for the + service binding. To set the service_binding attribute: + ▸ provide the argument service_binding on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument service_binding 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. + +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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services service-bindings delete + + $ gcloud beta network-services service-bindings delete + diff --git a/gcloud/network-services/service-bindings/describe b/gcloud/network-services/service-bindings/describe new file mode 100644 index 000000000..78b5c2c22 --- /dev/null +++ b/gcloud/network-services/service-bindings/describe @@ -0,0 +1,64 @@ +NAME + gcloud network-services service-bindings describe - describe a service + binding + +SYNOPSIS + gcloud network-services service-bindings describe + (SERVICE_BINDING : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a service binding. + +EXAMPLES + Show details about a service binding named 'my-service-binding'. + + $ gcloud network-services service-bindings describe \ + my-service-binding --location=global + +POSITIONAL ARGUMENTS + Service binding resource - Name of the service binding 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 service_binding on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + SERVICE_BINDING + ID of the service binding or fully qualified identifier for the + service binding. To set the service_binding attribute: + ▸ provide the argument service_binding on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument service_binding 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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services service-bindings describe + + $ gcloud beta network-services service-bindings describe + diff --git a/gcloud/network-services/service-bindings/help b/gcloud/network-services/service-bindings/help new file mode 100644 index 000000000..0c947c297 --- /dev/null +++ b/gcloud/network-services/service-bindings/help @@ -0,0 +1,36 @@ +NAME + gcloud network-services service-bindings - manage Network Services Bindings + +SYNOPSIS + gcloud network-services service-bindings COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services Bindings. + +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 service binding. + + delete + Delete service binding. + + describe + Describe a service binding. + + list + List service bindings. + +NOTES + These variants are also available: + + $ gcloud alpha network-services service-bindings + + $ gcloud beta network-services service-bindings + diff --git a/gcloud/network-services/service-bindings/list b/gcloud/network-services/service-bindings/list new file mode 100644 index 000000000..fb5850bcd --- /dev/null +++ b/gcloud/network-services/service-bindings/list @@ -0,0 +1,84 @@ +NAME + gcloud network-services service-bindings list - list service bindings + +SYNOPSIS + gcloud network-services service-bindings list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all service bindings in the specified location of the current project. + +EXAMPLES + To list the service bindings in the current project, run: + + $ gcloud network-services service-bindings list --location=global + +REQUIRED FLAGS + Location resource - The project of the service bindings to display. 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; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + 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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services service-bindings list + + $ gcloud beta network-services service-bindings list + diff --git a/gcloud/sql/flags/list b/gcloud/sql/flags/list index dd358dbb6..38be1e820 100644 --- a/gcloud/sql/flags/list +++ b/gcloud/sql/flags/list @@ -15,10 +15,11 @@ FLAGS The database engine type and versions. If left unspecified, the API defaults are used. See the list of database versions at https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. - DATABASE_VERSION must be one of: MYSQL_5_6, MYSQL_5_7, MYSQL_8_0, - POSTGRES_9_6, POSTGRES_10, POSTGRES_11, POSTGRES_12, POSTGRES_13, - POSTGRES_14, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, - SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, + Apart from listed major versions, DATABASE_VERSION also accepts + supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, + MYSQL_5_7, MYSQL_8_0, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, + POSTGRES_12, POSTGRES_13, POSTGRES_14, SQLSERVER_2017_EXPRESS, + SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE. diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index 63e765d00..1bd48f2e7 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -14,7 +14,8 @@ SYNOPSIS [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] - [--enable-bin-log] [--enable-point-in-time-recovery] + [--enable-bin-log] [--enable-password-policy] + [--enable-point-in-time-recovery] [--failover-replica-name=FAILOVER_REPLICA_NAME] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] @@ -148,10 +149,11 @@ FLAGS The database engine type and versions. If left unspecified, the API defaults are used. See the list of database versions at https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. - DATABASE_VERSION must be one of: MYSQL_5_6, MYSQL_5_7, MYSQL_8_0, - POSTGRES_9_6, POSTGRES_10, POSTGRES_11, POSTGRES_12, POSTGRES_13, - POSTGRES_14, SQLSERVER_2017_EXPRESS, SQLSERVER_2017_WEB, - SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, + Apart from listed major versions, DATABASE_VERSION also accepts + supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, + MYSQL_5_7, MYSQL_8_0, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, + POSTGRES_12, POSTGRES_13, POSTGRES_14, SQLSERVER_2017_EXPRESS, + SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, SQLSERVER_2019_ENTERPRISE. @@ -169,6 +171,10 @@ FLAGS fraction of a second. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --enable-password-policy + Enable the password policy, which enforces user password management + with the policies configured for the instance. + --enable-point-in-time-recovery Allows for data recovery from a specific point in time, down to a fraction of a second, via write-ahead logs. Must have automatic backups diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 8c6129c4f..1948c0052 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -11,7 +11,8 @@ SYNOPSIS [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--diff] [--[no-]enable-bin-log] [--[no-]enable-database-replication] - [--enable-point-in-time-recovery] [--follow-gae-app=FOLLOW_GAE_APP] + [--enable-password-policy] [--enable-point-in-time-recovery] + [--follow-gae-app=FOLLOW_GAE_APP] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -95,8 +96,13 @@ FLAGS The database engine type and versions. If left unspecified, no changes occur. See the list of database versions at https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/SqlDatabaseVersion. - DATABASE_VERSION must be one of: MYSQL_8_0_18, MYSQL_8_0_26, - MYSQL_8_0_27, MYSQL_8_0_28. + Apart from listed major versions, DATABASE_VERSION also accepts + supported minor versions. DATABASE_VERSION must be one of: MYSQL_5_6, + MYSQL_5_7, MYSQL_8_0, POSTGRES_9_6, POSTGRES_10, POSTGRES_11, + POSTGRES_12, POSTGRES_13, POSTGRES_14, SQLSERVER_2017_EXPRESS, + SQLSERVER_2017_WEB, SQLSERVER_2017_STANDARD, SQLSERVER_2017_ENTERPRISE, + SQLSERVER_2019_EXPRESS, SQLSERVER_2019_WEB, SQLSERVER_2019_STANDARD, + SQLSERVER_2019_ENTERPRISE. --deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE Date when the deny maintenance period ends, that is 2021-01-10. @@ -122,6 +128,10 @@ FLAGS --enable-database-replication to enable and --no-enable-database-replication to disable. + --enable-password-policy + Enable the password policy, which enforces user password management + with the policies configured for the instance. + --enable-point-in-time-recovery Allows for data recovery from a specific point in time, down to a fraction of a second, via write-ahead logs. Must have automatic backups