diff --git a/gcloud/_version b/gcloud/_version index 68f43aa85..0b214333e 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 508.0.0 -alpha 2025.01.24 -beta 2025.01.24 +Google Cloud SDK 509.0.0 +alpha 2025.01.31 +beta 2025.01.31 bq 2.1.12 -bundled-python3-unix 3.11.9 -core 2025.01.24 +bundled-python3-unix 3.12.8 +core 2025.01.31 gcloud-crc32c 1.0.0 gsutil 5.33 diff --git a/gcloud/alpha/backup-dr/backups/restore/compute b/gcloud/alpha/backup-dr/backups/restore/compute index 93396f04e..9120cbfe0 100644 --- a/gcloud/alpha/backup-dr/backups/restore/compute +++ b/gcloud/alpha/backup-dr/backups/restore/compute @@ -249,8 +249,7 @@ OPTIONAL FLAGS startup-script Specifies a script that will be executed by the instances once they - start running. For convenience, --metadata-from-file can be used to - pull the value from a file. + start running. startup-script-url Same as startup-script except that the script contents are pulled diff --git a/gcloud/alpha/compute/disks/get-async-replication-status b/gcloud/alpha/compute/disks/get-async-replication-status new file mode 100644 index 000000000..64d4e5c25 --- /dev/null +++ b/gcloud/alpha/compute/disks/get-async-replication-status @@ -0,0 +1,90 @@ +NAME + gcloud alpha compute disks get-async-replication-status - retrieves the + status of asynchronous replication for a Compute Engine persistent + disk-pair + +SYNOPSIS + gcloud alpha compute disks get-async-replication-status DISK_NAME + [--region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute disks get-async-replication-status fetches the + current status of async replication on a Compute Engine persistent + disk-pair. This command can be invoked on either the primary disk or the + secondary-disk but the scope respective to the disk must be provided. + +EXAMPLES + Replication status can be fetched by using either the primary or the + secondary disk. To get the current replication status of the disk-pair with + the primary disk 'primary-disk-1' in zone 'us-east1-a', and project + 'my-project1' and the secondary disk 'secondary-disk-1' in zone + 'us-west1-a', and the project 'my-project2', the following commands can be + used: + + $ gcloud alpha compute disks get-async-replication-status \ + primary-disk-1 --zone=us-east1-a --project=my-project1 or + $ gcloud alpha compute disks get-async-replication-status \ + secondary-disk-1 --zone=us-west1-a --project=my-project2 + +POSITIONAL ARGUMENTS + DISK_NAME + Name of the disk to operate on. + +FLAGS + At most one of these can be specified: + + --region=REGION + Region of the disk to operate on. If not specified, you might be + prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --zone=ZONE + Zone of the disk to operate on. If not specified and the compute/zone + property isn't set, you might be prompted to select a zone + (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/disks/help b/gcloud/alpha/compute/disks/help index a220126ef..3b4c63fce 100644 --- a/gcloud/alpha/compute/disks/help +++ b/gcloud/alpha/compute/disks/help @@ -53,6 +53,10 @@ COMMANDS describe (ALPHA) Describe a Compute Engine disk. + get-async-replication-status + (ALPHA) Retrieves the status of asynchronous replication for a Compute + Engine persistent disk-pair. + get-iam-policy (ALPHA) Get the IAM policy for a Compute Engine disk. diff --git a/gcloud/alpha/compute/future-reservations/create b/gcloud/alpha/compute/future-reservations/create index 5fd5469e6..ccda4d721 100644 --- a/gcloud/alpha/compute/future-reservations/create +++ b/gcloud/alpha/compute/future-reservations/create @@ -4,21 +4,23 @@ NAME SYNOPSIS gcloud alpha compute future-reservations create FUTURE_RESERVATION - --[no-]auto-delete-auto-created-reservations --total-count=TOTAL_COUNT + --[no-]auto-delete-auto-created-reservations (--source-instance-template=SOURCE_INSTANCE_TEMPLATE | [--machine-type=MACHINE_TYPE : --accelerator=[count=COUNT],[type=TYPE] --local-ssd=[count=COUNT],[interface=INTERFACE],[size=SIZE] --maintenance-freeze-duration=MAINTENANCE_FREEZE_DURATION --maintenance-interval=MAINTENANCE_INTERVAL - --min-cpu-platform=MIN_CPU_PLATFORM]) + --min-cpu-platform=MIN_CPU_PLATFORM] | [--tpu-version=TPU_VERSION + : --tpu-count=TPU_COUNT --workload-type=WORKLOAD_TYPE]) (--start-time=START_TIME (--duration=DURATION | --end-time=END_TIME)) [--deployment-type=DEPLOYMENT_TYPE] [--description=DESCRIPTION] [--name-prefix=NAME_PREFIX] [--planning-status=PLANNING_STATUS] [--[no-]require-specific-reservation] [--reservation-mode=RESERVATION_MODE] [--reservation-name=RESERVATION_NAME] - [--scheduling-type=SCHEDULING_TYPE] [--zone=ZONE] + [--scheduling-type=SCHEDULING_TYPE] [--total-count=TOTAL_COUNT] + [--zone=ZONE] [--auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME | --auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION] [--commitment-name=COMMITMENT_NAME --commitment-plan=COMMITMENT_PLAN --previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS] @@ -61,13 +63,10 @@ REQUIRED FLAGS Use --auto-delete-auto-created-reservations to enable and --no-auto-delete-auto-created-reservations to disable. - --total-count=TOTAL_COUNT - The total number of instances for which capacity assurance is requested - at a future time period. - - Manage the instance properties for the auto-created reservations. You must - either provide a source instance template or define the instance - properties. + To create a future reservation request, specify the properties of the + resources that you want to reserve and when you want to start using them. + After the request is approved, Compute Engine automatically creates + reservations for your requested resources at your specified start time. Exactly one of these must be specified: @@ -140,6 +139,35 @@ REQUIRED FLAGS --min-cpu-platform=MIN_CPU_PLATFORM Optional minimum CPU platform of the reservation to create. + You must define the version and number of TPUs to reserve. + + --tpu-version=TPU_VERSION + The version of Cloud TPU to reserve. TPU_VERSION must be one of: + + V5E + Cloud TPU v5e Lite + V5P + Cloud TPU v5p + V6E + Cloud TPU v6e + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --tpu-count=TPU_COUNT + The number of TPUs to reserve. + + --workload-type=WORKLOAD_TYPE + The workload type of the TPU reservation. WORKLOAD_TYPE must be one + of: + + BATCH + Reserved resources will be optimized for BATCH workloads, such + as ML training. + SERVING + Reserved resources will be optimized for SERVING workloads, + such as ML inference + Manage the time specific properties for requesting future capacity This must be specified. @@ -238,6 +266,10 @@ OPTIONAL FLAGS In INDEPENDENT mode, maintenance is not synchronized for this reservation, and each instance has its own maintenance window. + --total-count=TOTAL_COUNT + The total number of instances for which capacity assurance is requested + at a future time period. + --zone=ZONE Zone of the future reservation to create. If not specified and the compute/zone property isn't set, you might be prompted to select a zone diff --git a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create index 538c588e5..c788891b9 100644 --- a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create +++ b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create @@ -9,7 +9,8 @@ SYNOPSIS [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] [--security-profile-group=SECURITY_PROFILE_GROUP] - [--src-ip-ranges=[SRC_IP_RANGE,...]] [GCLOUD_WIDE_FLAG ...] + [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute network-firewall-policies mirroring-rules @@ -72,6 +73,10 @@ OPTIONAL FLAGS --src-secure-tags.Multiple IP address blocks can be specified if they are separated by commas. + --target-secure-tags=[TARGET_SECURE_TAGS,...] + An optional, list of target secure tags with a name of the format + tagValues/ or full namespaced name + 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/compute/network-firewall-policies/mirroring-rules/update b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update index 9ea9d34ab..2a90ca295 100644 --- a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update +++ b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update @@ -10,7 +10,8 @@ SYNOPSIS [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] [--new-priority=NEW_PRIORITY] [--security-profile-group=SECURITY_PROFILE_GROUP] - [--src-ip-ranges=[SRC_IP_RANGE,...]] [GCLOUD_WIDE_FLAG ...] + [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute network-firewall-policies mirroring-rules @@ -77,6 +78,10 @@ OPTIONAL FLAGS --src-secure-tags.Multiple IP address blocks can be specified if they are separated by commas. + --target-secure-tags=[TARGET_SECURE_TAGS,...] + An optional, list of target secure tags with a name of the format + tagValues/ or full namespaced name + 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/compute/reservations/blocks/help b/gcloud/alpha/compute/reservations/blocks/help index cc8024c91..25d529075 100644 --- a/gcloud/alpha/compute/reservations/blocks/help +++ b/gcloud/alpha/compute/reservations/blocks/help @@ -22,7 +22,8 @@ COMMANDS (ALPHA) List Compute Engine reservation blocks. perform-maintenance - (ALPHA) Perform maintenance on a reservation block. + (ALPHA) Perform maintenance on a reservation block within a + reservation. NOTES This command is currently in alpha and might change without notice. If this diff --git a/gcloud/alpha/compute/reservations/blocks/perform-maintenance b/gcloud/alpha/compute/reservations/blocks/perform-maintenance index a96335cf6..0f5bf4aba 100644 --- a/gcloud/alpha/compute/reservations/blocks/perform-maintenance +++ b/gcloud/alpha/compute/reservations/blocks/perform-maintenance @@ -1,6 +1,6 @@ NAME gcloud alpha compute reservations blocks perform-maintenance - perform - maintenance on a reservation block + maintenance on a reservation block within a reservation SYNOPSIS gcloud alpha compute reservations blocks perform-maintenance RESERVATION @@ -8,7 +8,7 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Perform maintenance on a reservation block. + (ALPHA) Perform maintenance on a reservation block within a reservation. EXAMPLES To perform maintenance on a reservation block in reservation exr1 in @@ -31,14 +31,13 @@ OPTIONAL FLAGS one of: all - Maintenance should be performed on all hosts in the reservation - block. + Perform maintenance on all hosts in the reservation block. running - Maintenance should be performed only on the hosts in the - reservation block which have running VMs. + Perform maintenance only on the hosts in the reservation block that + have running VMs. unused - Maintenance should be performed only on the hosts in the - reservation block which have no running VMs. + Perform maintenance only on the hosts in the reservation block that + don't have running VMs. --zone=ZONE Zone of the reservation to perform-maintenance. If not specified and @@ -73,5 +72,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 compute reservations blocks perform-maintenance diff --git a/gcloud/alpha/compute/reservations/help b/gcloud/alpha/compute/reservations/help index 088c44b55..195a41a15 100644 --- a/gcloud/alpha/compute/reservations/help +++ b/gcloud/alpha/compute/reservations/help @@ -46,7 +46,8 @@ COMMANDS (ALPHA) List Compute Engine reservations. perform-maintenance - (ALPHA) Perform maintenance on a reservation. + (ALPHA) Perform maintenance on a reservation, only applicable to + reservations with reservation blocks. remove-iam-policy-binding (ALPHA) Remove IAM policy binding from a Compute Engine reservation. diff --git a/gcloud/alpha/compute/reservations/perform-maintenance b/gcloud/alpha/compute/reservations/perform-maintenance index f275999c8..b23d68a28 100644 --- a/gcloud/alpha/compute/reservations/perform-maintenance +++ b/gcloud/alpha/compute/reservations/perform-maintenance @@ -1,13 +1,15 @@ NAME gcloud alpha compute reservations perform-maintenance - perform maintenance - on a reservation + on a reservation, only applicable to reservations with reservation + blocks SYNOPSIS gcloud alpha compute reservations perform-maintenance RESERVATION [--scope=SCOPE] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Perform maintenance on a reservation. + (ALPHA) Perform maintenance on a reservation, only applicable to + reservations with reservation blocks. EXAMPLES To perform maintenance on reservation exr1 in my-zone with scope all, run: @@ -24,13 +26,13 @@ FLAGS The maintenance scope to set for the reservation. SCOPE must be one of: all - Maintenance should be performed on all hosts in the reservation. + Perform maintenance on all hosts in the reservation. running - Maintenance should be performed only on the hosts in the - reservation which have running VMs. + Perform maintenance only on the hosts in the reservation that have + running VMs. unused - Maintenance should be performed only on the hosts in the - reservation which have no running VMs. + Perform maintenance only on the hosts in the reservation that don't + have running VMs. --zone=ZONE Zone of the reservation to perform-maintenance. If not specified and @@ -65,5 +67,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 compute reservations perform-maintenance diff --git a/gcloud/alpha/compute/snapshot-settings/update b/gcloud/alpha/compute/snapshot-settings/update index e341b7fe5..8010d9193 100644 --- a/gcloud/alpha/compute/snapshot-settings/update +++ b/gcloud/alpha/compute/snapshot-settings/update @@ -3,6 +3,7 @@ NAME SYNOPSIS gcloud alpha compute snapshot-settings update + [--access-location-policy=ACCESS_LOCATION_POLICY] [--add-access-locations=[ADD_ACCESS_LOCATIONS,...]] [--async] [--region=REGION] [--remove-access-locations=[REMOVE_ACCESS_LOCATIONS,...]] @@ -34,6 +35,10 @@ EXAMPLES --storage-location-names=us-west1 FLAGS + --access-location-policy=ACCESS_LOCATION_POLICY + The access location policy. ACCESS_LOCATION_POLICY must be one of: + all-regions, specific-regions. + --add-access-locations=[ADD_ACCESS_LOCATIONS,...] Access locations to add to snapshot settings diff --git a/gcloud/alpha/compute/url-maps/invalidate-cdn-cache b/gcloud/alpha/compute/url-maps/invalidate-cdn-cache index 64744decd..6671ff2fd 100644 --- a/gcloud/alpha/compute/url-maps/invalidate-cdn-cache +++ b/gcloud/alpha/compute/url-maps/invalidate-cdn-cache @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha compute url-maps invalidate-cdn-cache URLMAP --path=PATH - [--async] [--global] [--host=HOST] [GCLOUD_WIDE_FLAG ...] + [--async] [--global] [--host=HOST] [--tags=TAGS] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute url-maps invalidate-cdn-cache requests that @@ -51,6 +51,13 @@ OPTIONAL FLAGS If set, this invalidation will apply only to requests to the specified host. + --tags=TAGS + A single tag or a comma-delimited list of tags. When multiple tags are + specified, the invalidation will apply them using boolean OR logic. + + Example: + ◆ --tags=abcd,user123 + 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/dataproc/clusters/create b/gcloud/alpha/dataproc/clusters/create index e57701a61..489f16f92 100644 --- a/gcloud/alpha/dataproc/clusters/create +++ b/gcloud/alpha/dataproc/clusters/create @@ -4,7 +4,6 @@ NAME SYNOPSIS gcloud alpha dataproc clusters create (CLUSTER : --region=REGION) [--async] [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] - [--dataproc-metastore=DATAPROC_METASTORE] [--driver-pool-accelerator=[type=TYPE,[count=COUNT],...]] [--driver-pool-boot-disk-size=DRIVER_POOL_BOOT_DISK_SIZE] [--driver-pool-boot-disk-type=DRIVER_POOL_BOOT_DISK_TYPE] @@ -51,6 +50,8 @@ SYNOPSIS [--worker-boot-disk-type=WORKER_BOOT_DISK_TYPE] [--worker-local-ssd-interface=WORKER_LOCAL_SSD_INTERFACE] [--worker-min-cpu-platform=PLATFORM] [--zone=ZONE, -z ZONE] + [--dataproc-metastore=DATAPROC_METASTORE | --bigquery-metastore + --bigquery-metastore-database-location=BIGQUERY_METASTORE_DATABASE_LOCATION --bigquery-metastore-project-id=BIGQUERY_METASTORE_PROJECT_ID] [--expiration-time=EXPIRATION_TIME | --max-age=MAX_AGE] [--gce-pd-kms-key=GCE_PD_KMS_KEY : --gce-pd-kms-key-keyring=GCE_PD_KMS_KEY_KEYRING @@ -136,11 +137,6 @@ FLAGS dependencies, miscellaneous config files, and job driver console output when using this cluster. - --dataproc-metastore=DATAPROC_METASTORE - Specify the name of a Dataproc Metastore service to be used as an - external metastore in the format: - "projects/{project-id}/locations/{region}/services/{service-name}". - --driver-pool-accelerator=[type=TYPE,[count=COUNT],...] Attaches accelerators, such as GPUs, to the driver-pool instance(s). @@ -482,6 +478,26 @@ FLAGS zone in the region. Overrides the default compute/zone property value for this command invocation. + At most one of these can be specified: + + --dataproc-metastore=DATAPROC_METASTORE + Specify the name of a Dataproc Metastore service to be used as an + external metastore in the format: + "projects/{project-id}/locations/{region}/services/{service-name}". + + BQMS flags + + --bigquery-metastore + Indicates that BigQuery metastore is to be used. + + --bigquery-metastore-database-location=BIGQUERY_METASTORE_DATABASE_LOCATION + Location of the BigQuery metastore database to be used as an + external metastore. + + --bigquery-metastore-project-id=BIGQUERY_METASTORE_PROJECT_ID + The project ID of the BigQuery metastore database to be used as an + external metastore. + At most one of these can be specified: --expiration-time=EXPIRATION_TIME diff --git a/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster b/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster index ef1e1b1f2..1d766e178 100644 --- a/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/alpha/dataproc/workflow-templates/set-managed-cluster @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha dataproc workflow-templates set-managed-cluster (TEMPLATE : --region=REGION) [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] [--cluster-name=CLUSTER_NAME] - [--dataproc-metastore=DATAPROC_METASTORE] [--enable-component-gateway] + [--enable-component-gateway] [--initialization-action-timeout=TIMEOUT; default="10m"] [--initialization-actions=CLOUD_STORAGE_URI,[...]] [--labels=[KEY=VALUE,...]] @@ -44,6 +44,8 @@ SYNOPSIS [--worker-boot-disk-type=WORKER_BOOT_DISK_TYPE] [--worker-local-ssd-interface=WORKER_LOCAL_SSD_INTERFACE] [--worker-min-cpu-platform=PLATFORM] [--zone=ZONE, -z ZONE] + [--dataproc-metastore=DATAPROC_METASTORE | --bigquery-metastore + --bigquery-metastore-database-location=BIGQUERY_METASTORE_DATABASE_LOCATION --bigquery-metastore-project-id=BIGQUERY_METASTORE_PROJECT_ID] [--image=IMAGE | --image-version=VERSION] [--kerberos-config-file=KERBEROS_CONFIG_FILE | --enable-kerberos --kerberos-root-principal-password-uri=KERBEROS_ROOT_PRINCIPAL_PASSWORD_URI [--kerberos-kms-key=KERBEROS_KMS_KEY : --kerberos-kms-key-keyring=KERBEROS_KMS_KEY_KEYRING --kerberos-kms-key-location=KERBEROS_KMS_KEY_LOCATION --kerberos-kms-key-project=KERBEROS_KMS_KEY_PROJECT]] @@ -125,11 +127,6 @@ FLAGS The name of the managed dataproc cluster. If unspecified, the workflow template ID will be used. - --dataproc-metastore=DATAPROC_METASTORE - Specify the name of a Dataproc Metastore service to be used as an - external metastore in the format: - "projects/{project-id}/locations/{region}/services/{service-name}". - --enable-component-gateway Enable access to the web UIs of selected components on the cluster through the component gateway. @@ -414,6 +411,26 @@ FLAGS zone in the region. Overrides the default compute/zone property value for this command invocation. + At most one of these can be specified: + + --dataproc-metastore=DATAPROC_METASTORE + Specify the name of a Dataproc Metastore service to be used as an + external metastore in the format: + "projects/{project-id}/locations/{region}/services/{service-name}". + + BQMS flags + + --bigquery-metastore + Indicates that BigQuery metastore is to be used. + + --bigquery-metastore-database-location=BIGQUERY_METASTORE_DATABASE_LOCATION + Location of the BigQuery metastore database to be used as an + external metastore. + + --bigquery-metastore-project-id=BIGQUERY_METASTORE_PROJECT_ID + The project ID of the BigQuery metastore database to be used as an + external metastore. + At most one of these can be specified: --image=IMAGE diff --git a/gcloud/alpha/developer-connect/connections/create b/gcloud/alpha/developer-connect/connections/create index 7480cb7ee..94a11b20c 100644 --- a/gcloud/alpha/developer-connect/connections/create +++ b/gcloud/alpha/developer-connect/connections/create @@ -7,8 +7,7 @@ SYNOPSIS [--annotations=[ANNOTATIONS,...]] [--async] [--disabled] [--etag=ETAG] [--labels=[LABELS,...]] [--location=LOCATION] [--namespace=NAMESPACE] [--request-id=REQUEST_ID] [--secret=SECRET] [--validate-only] - [[--github-config-app=GITHUB_CONFIG_APP - : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] | [--github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI : --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION] | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION | [--gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-webhook-secret-version=GITLAB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION : --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE]] + [--bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-webhook-secret-version=BITBUCKET_CLOUD_CONFIG_WEBHOOK_SECRET_VERSION --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE | [--bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-webhook-secret-version=BITBUCKET_DATA_CENTER_CONFIG_WEBHOOK_SECRET_VERSION : --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE] | [--github-config-app=GITHUB_CONFIG_APP : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] | [--github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI : --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION] | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION | [--gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-webhook-secret-version=GITLAB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION : --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE]] [(--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE : --key-ring=KEY_RING)] [GCLOUD_WIDE_FLAG ...] @@ -147,6 +146,259 @@ FLAGS At most one of these can be specified: + Configuration for connections to an instance of Bitbucket Cloud. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line. + + SecretVersion resource - SecretManager resource containing the webhook + secret used to verify webhook events, formatted as + projects/*/secrets/*/versions/*. This is used to validate and create + webhooks. 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 + --bitbucket-cloud-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument + --bitbucket-cloud-config-webhook-secret-version on the command line + with a fully specified name; + ▫ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-cloud-config-webhook-secret-version=BITBUCKET_CLOUD_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --bitbucket-cloud-config-webhook-secret-version on the command + line. + + --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE + The Bitbucket Cloud Workspace ID to be connected to Google Cloud + Platform. + + Configuration for connections to an instance of Bitbucket Data Center. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line. + + --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI + The URI of the Bitbucket Data Center host this connection is for. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line. + + SecretVersion resource - SecretManager resource containing the webhook + secret used to verify webhook events, formatted as + projects/*/secrets/*/versions/*. This is used to validate webhooks. + 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 + --bitbucket-data-center-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument + --bitbucket-data-center-config-webhook-secret-version on the + command line with a fully specified name; + ▫ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-data-center-config-webhook-secret-version=BITBUCKET_DATA_CENTER_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --bitbucket-data-center-config-webhook-secret-version on the + command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + Service resource - The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + 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 + --bitbucket-data-center-config-service-directory 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 + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --location on the command line. + + To set the namespace attribute: + ◇ provide the argument + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --namespace on the command line. + + This must be specified. + + --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY + ID of the service or fully qualified identifier for the + service. + + To set the service attribute: + ▹ provide the argument + --bitbucket-data-center-config-service-directory on the + command line. + + --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE + SSL certificate authority to trust when making requests to + Bitbucket Data Center. + Configuration for connections to github.com. --github-config-app=GITHUB_CONFIG_APP diff --git a/gcloud/alpha/developer-connect/connections/update b/gcloud/alpha/developer-connect/connections/update index 79714f6b3..4bdd9da77 100644 --- a/gcloud/alpha/developer-connect/connections/update +++ b/gcloud/alpha/developer-connect/connections/update @@ -10,8 +10,7 @@ SYNOPSIS [--annotations=[ANNOTATIONS,...] | --update-annotations=[UPDATE_ANNOTATIONS,...] --clear-annotations | --remove-annotations=[__REMOVE_ANNOTATIONS,...]] - [--github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID - --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION | --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --clear-github-enterprise-config-private-key-secret-version | --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --clear-github-enterprise-config-webhook-secret-version | --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION | --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE] + [--bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE | --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE | --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION | --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --clear-github-enterprise-config-private-key-secret-version | --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --clear-github-enterprise-config-webhook-secret-version | --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION | --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE] [--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE : --key-ring=KEY_RING] [--labels=[LABELS,...] @@ -173,6 +172,181 @@ FLAGS At most one of these can be specified: + Configuration for connections to an instance of Bitbucket Cloud. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line. + + --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE + The Bitbucket Cloud Workspace ID to be connected to Google Cloud + Platform. + + Configuration for connections to an instance of Bitbucket Data Center. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line. + + --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI + The URI of the Bitbucket Data Center host this connection is for. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + Service resource - The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + 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 + --bitbucket-data-center-config-service-directory 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 + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --location on the command line. + + To set the namespace attribute: + ◇ provide the argument + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --namespace on the command line. + + --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY + ID of the service or fully qualified identifier for the + service. + + To set the service attribute: + ▹ provide the argument + --bitbucket-data-center-config-service-directory on the + command line. + + --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE + SSL certificate authority to trust when making requests to + Bitbucket Data Center. + Configuration for connections to github.com. --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID diff --git a/gcloud/alpha/functions/detach b/gcloud/alpha/functions/detach new file mode 100644 index 000000000..ade6863b3 --- /dev/null +++ b/gcloud/alpha/functions/detach @@ -0,0 +1,61 @@ +NAME + gcloud alpha functions detach - detach a GCF 2nd gen function from GCF and + make it a native Cloud Run function + +SYNOPSIS + gcloud alpha functions detach (NAME : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Detach a GCF 2nd gen function from GCF and make it a native Cloud + Run function. + +POSITIONAL ARGUMENTS + Function resource - The Cloud Function name to detach. 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 NAME 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. + + NAME + ID of the function or fully qualified identifier for the function. + + To set the function attribute: + ▸ provide the argument NAME on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud region for the function. Overrides the default + functions/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument NAME on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property functions/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 alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta functions detach + diff --git a/gcloud/alpha/functions/help b/gcloud/alpha/functions/help index f07ccb10c..f7737fe8f 100644 --- a/gcloud/alpha/functions/help +++ b/gcloud/alpha/functions/help @@ -53,6 +53,10 @@ COMMANDS describe (ALPHA) Display details of a Google Cloud Function. + detach + (ALPHA) Detach a GCF 2nd gen function from GCF and make it a native + Cloud Run function. + get-iam-policy (ALPHA) Gets IAM policy for a Google Cloud Function. diff --git a/gcloud/alpha/network-services/multicast-group-definitions/create b/gcloud/alpha/network-services/multicast-group-definitions/create index d922d6409..f1bed457a 100644 --- a/gcloud/alpha/network-services/multicast-group-definitions/create +++ b/gcloud/alpha/network-services/multicast-group-definitions/create @@ -9,7 +9,7 @@ SYNOPSIS --reserved-internal-range=RESERVED_INTERNAL_RANGE [--async] [--consumer-accept-list=[CONSUMER_ACCEPT_LIST,...]] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + [--require-explicit-accept] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a multicast group definition in the specified location of @@ -85,6 +85,10 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --require-explicit-accept + Whether an empty consumer accept list will reject all consumer + projects. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/network-services/multicast-group-ranges/create b/gcloud/alpha/network-services/multicast-group-ranges/create index 90bc3983b..a64a8a72b 100644 --- a/gcloud/alpha/network-services/multicast-group-ranges/create +++ b/gcloud/alpha/network-services/multicast-group-ranges/create @@ -9,7 +9,7 @@ SYNOPSIS --reserved-internal-range=RESERVED_INTERNAL_RANGE [--async] [--consumer-accept-list=[CONSUMER_ACCEPT_LIST,...]] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + [--require-explicit-accept] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a multicast group range in the specified location of the @@ -83,6 +83,10 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --require-explicit-accept + Whether an empty consumer accept list will reject all consumer + projects. + 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/run/deploy b/gcloud/alpha/run/deploy index cb177ba3e..6cc9c7d0b 100644 --- a/gcloud/alpha/run/deploy +++ b/gcloud/alpha/run/deploy @@ -659,7 +659,9 @@ FLAGS us-docker.pkg.dev/cloudrun/container/hello:latest). When used with --source, the image must be the URI of an Artifact Registry Docker repository in the Docker format - ($REGION-docker.pkg.dev/$PROJECT/$REPOSITORY"). + ($REGION-docker.pkg.dev/$PROJECT/$REPOSITORY") or + ($REGION-docker.pkg.dev/$PROJECT/$REPOSITORY/$IMAGE_NAME"). The + image name must be the same as the name of the service. --source=SOURCE The location of the source to build. If a Dockerfile is present in diff --git a/gcloud/alpha/scc/help b/gcloud/alpha/scc/help index 0b6eaf2a2..887e414f5 100644 --- a/gcloud/alpha/scc/help +++ b/gcloud/alpha/scc/help @@ -53,6 +53,10 @@ GROUPS postures (ALPHA) Manage Cloud Security Command Center (SCC) postures. + remediation-intents + (ALPHA) Manages Cloud Security Command Center (SCC) RemediationIntent + resource. + settings (ALPHA) Manage Cloud SCC (Security Command Center) settings. diff --git a/gcloud/alpha/scc/remediation-intents/create b/gcloud/alpha/scc/remediation-intents/create new file mode 100644 index 000000000..1ca071bbf --- /dev/null +++ b/gcloud/alpha/scc/remediation-intents/create @@ -0,0 +1,51 @@ +NAME + gcloud alpha scc remediation-intents create - creates a remediation intent + resource + +SYNOPSIS + gcloud alpha scc remediation-intents create --parent=PARENT + --workflow-type=WORKFLOW_TYPE [--finding-name=FINDING_NAME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a Cloud Security Command Center (SCC) RemediationIntent + resource. Created resource is returned as the response of the command. + +EXAMPLES + Sample usage: Create a manual workflow remediation intent resource: $ + {command} scc remediation-intents create \ --parent=organizations/123456789/locations/global \ + --finding-name=projects/123456789/sources/123456789/locations/\ + global/findings/123456789 --workflow-type=manual + + Create a semi-autonomous workflow remediation intent resource: $ {command} + scc remediation-intents create \ --parent=organizations/123456789/locations/global \ + --workflow-type=semi-autonomous + +REQUIRED FLAGS + --parent=PARENT + The parent resource to create the remediation intent under. Format: + organizations/{org_id}/locations/{loc_id} + + --workflow-type=WORKFLOW_TYPE + Type of the workflow to be created. WORKFLOW_TYPE must be one of: + semi-autonomous, manual. + +OPTIONAL FLAGS + --finding-name=FINDING_NAME + Canonical name of the SCC finding Format: + projects/{proj_id}/sources/{src_id}/locations/{loc_id}/findings/{finding_id} + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/scc/remediation-intents/delete b/gcloud/alpha/scc/remediation-intents/delete new file mode 100644 index 000000000..87190a4ff --- /dev/null +++ b/gcloud/alpha/scc/remediation-intents/delete @@ -0,0 +1,70 @@ +NAME + gcloud alpha scc remediation-intents delete - deletes a remediation intent + resource + +SYNOPSIS + gcloud alpha scc remediation-intents delete + (REMEDIATIONINTENT : --location=LOCATION --organization=ORGANIZATION) + [--etag=ETAG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Deletes a Cloud Security Command Center (SCC) RemediationIntent + resource. + +EXAMPLES + Sample usage: Delete a remediation intent resource of name + organizations/123456789/locations/global/remediationIntents/123: $ + {command} scc remediation-intents delete \ organizations/123456789/locations/global/remediationIntents/123 + +POSITIONAL ARGUMENTS + RemediationIntent resource - The remediation intent resource. The + arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + REMEDIATIONINTENT + ID of the remediationIntent or fully qualified identifier for the + remediationIntent. + + To set the remediation-intent attribute: + ▸ provide the argument remediationintent on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Google Cloud location for the remediationIntent. + + To set the location attribute: + ▸ provide the argument remediationintent on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + The Google Cloud organization for the remediationIntent. + + To set the organization attribute: + ▸ provide the argument remediationintent on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +FLAGS + --etag=ETAG + Etag is an optional flag. If the provided Etag doesn't match the server + generated Etag, the operation won't proceed. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/scc/remediation-intents/describe b/gcloud/alpha/scc/remediation-intents/describe new file mode 100644 index 000000000..05fac4615 --- /dev/null +++ b/gcloud/alpha/scc/remediation-intents/describe @@ -0,0 +1,65 @@ +NAME + gcloud alpha scc remediation-intents describe - describes a remediation + intent resource + +SYNOPSIS + gcloud alpha scc remediation-intents describe + (REMEDIATIONINTENT : --location=LOCATION --organization=ORGANIZATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Cloud Security Command Center (SCC) RemediationIntent + resource. The resource is returned as the response of the command. + +EXAMPLES + Sample usage: Describe a remediation intent resource of id 1234 under + organization 12345 and location global: $ {command} scc remediation-intents + describe \ organizations/12345/locations/global/remediationIntents/1234 + +POSITIONAL ARGUMENTS + RemediationIntent resource - The remediation intent resource. The + arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + REMEDIATIONINTENT + ID of the remediationIntent or fully qualified identifier for the + remediationIntent. + + To set the remediation-intent attribute: + ▸ provide the argument remediationintent on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Google Cloud location for the remediationIntent. + + To set the location attribute: + ▸ provide the argument remediationintent on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + The Google Cloud organization for the remediationIntent. + + To set the organization attribute: + ▸ provide the argument remediationintent on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/scc/remediation-intents/help b/gcloud/alpha/scc/remediation-intents/help new file mode 100644 index 000000000..b4c3e7d27 --- /dev/null +++ b/gcloud/alpha/scc/remediation-intents/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha scc remediation-intents - manages Cloud Security Command + Center RemediationIntent resource + +SYNOPSIS + gcloud alpha scc remediation-intents COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manages Cloud Security Command Center (SCC) RemediationIntent + resource. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Creates a remediation intent resource. + + delete + (ALPHA) Deletes a remediation intent resource. + + describe + (ALPHA) Describes a remediation intent resource. + + list + (ALPHA) Lists the remediation intent resources. + + update + (ALPHA) Updates a remediation intent resource. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/scc/remediation-intents/list b/gcloud/alpha/scc/remediation-intents/list new file mode 100644 index 000000000..369927fe9 --- /dev/null +++ b/gcloud/alpha/scc/remediation-intents/list @@ -0,0 +1,69 @@ +NAME + gcloud alpha scc remediation-intents list - lists the remediation intent + resources + +SYNOPSIS + gcloud alpha scc remediation-intents list PARENT [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Lists the Cloud Security Command Center (SCC) RemediationIntent + resources. List of resources is returned as the response of the command. + +EXAMPLES + Sample usage: List all remediation intent resource under parent + organizations/123456789/locations/global: $ {command} scc + remediation-intents list \ organizations/123456789/locations/global + +POSITIONAL ARGUMENTS + PARENT + The parent resource to create the remediation intent under. Format: + organizations/{org_id}/locations/{loc_id} + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/scc/remediation-intents/update b/gcloud/alpha/scc/remediation-intents/update new file mode 100644 index 000000000..43611721e --- /dev/null +++ b/gcloud/alpha/scc/remediation-intents/update @@ -0,0 +1,108 @@ +NAME + gcloud alpha scc remediation-intents update - updates a remediation intent + resource + +SYNOPSIS + gcloud alpha scc remediation-intents update + (REMEDIATIONINTENT : --location=LOCATION --organization=ORGANIZATION) + --ri-from-file=RI_FROM_FILE [--update-mask=UPDATE_MASK] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Updates a Cloud Security Command Center (SCC) RemediationIntent + resource. + + Fields specified in update-mask flag are updated. Updatable fields depends + on the state transition. + + Valid state transitions are: + + a) ENQUEUED to IN_PROGRESS (mask: state,remediation_input) + + b) REMEDIATION_SUCCESS to PR_GENERATION_SUCCESS (mask: + state,remediation_artifacts) + + c) REMEDIATION_SUCCESS to PR_GENERATION_FAILED (mask: state,error_details) + + An empty or * as field mask will result in updating the relevant fields as + per the transition. + + Updated resource is returned as the response of the command. + +EXAMPLES + Sample usage: Update the remediation intent resource's state from ENQUEUED + to IN_PROGRESS: $ {command} scc remediation-intents update \ organizations/123456789/locations/global/remediationIntents/\ + 123456789 --ri-from-file=/path/to/resource.yaml \ + --update-mask=state,remediation_input + + Update the remediation intent resource's state from ENQUEUED to IN_PROGRESS + (with empty update mask): $ {command} scc remediation-intents update \ organizations/123456789/locations/global/remediationIntents/\ + 123456789 --ri-from-file=/path/to/resource.yaml + + Update the remediation intent resource's state from REMEDIATION_SUCCESS to + PR_GENERATION_SUCCESS: $ {command} scc remediation-intents update \ organizations/123456789/locations/global/remediationIntents/\ + 123456789 --ri-from-file=/path/to/resource.yaml \ + --update-mask=state,remediation_artifacts + + Update the remediation intent resource's state from REMEDIATION_SUCCESS to + PR_GENERATION_FAILED: $ {command} scc remediation-intents update \ organizations/123456789/locations/global/remediationIntents/\ + 123456789 --ri-from-file=/path/to/resource.yaml \ + --update-mask=state,error_details + +POSITIONAL ARGUMENTS + RemediationIntent resource - The remediation intent resource. The + arguments in this group can be used to specify the attributes of this + resource. + + This must be specified. + + REMEDIATIONINTENT + ID of the remediationIntent or fully qualified identifier for the + remediationIntent. + + To set the remediation-intent attribute: + ▸ provide the argument remediationintent on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The Google Cloud location for the remediationIntent. + + To set the location attribute: + ▸ provide the argument remediationintent on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + + --organization=ORGANIZATION + The Google Cloud organization for the remediationIntent. + + To set the organization attribute: + ▸ provide the argument remediationintent on the command line with a + fully specified name; + ▸ provide the argument --organization on the command line. + +REQUIRED FLAGS + --ri-from-file=RI_FROM_FILE + Path to the YAML file containing the remediation intent resource. + Format: /path/to/file.yaml. + +OPTIONAL FLAGS + --update-mask=UPDATE_MASK + Comma separated string containing list of fields to be updated. Format: + field1,field2. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/services/api-keys/create b/gcloud/alpha/services/api-keys/create index fd75dfe43..3318e4648 100644 --- a/gcloud/alpha/services/api-keys/create +++ b/gcloud/alpha/services/api-keys/create @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud alpha services api-keys create [--annotations=[KEY=VALUE,...]] [--async] [--display-name=DISPLAY_NAME] [--key-id=KEY_ID] + [--service-account=SERVICE_ACCOUNT] [--api-target=service=SERVICE,[...] --allowed-application=[sha1_fingerprint=SHA1_FINGERPRINT, package_name=PACKAGE_NAME,...] @@ -15,7 +16,7 @@ DESCRIPTION (ALPHA) Create an API key. EXAMPLES - To create a key with display name and allowed ips specified: + To create a key with display name and allowed IPs specified: $ gcloud alpha services api-keys create --display-name="test name" \ --allowed-ips=2620:15c:2c4:203:2776:1f90:6b3b:217,104.133.8.78 @@ -24,7 +25,7 @@ EXAMPLES $ gcloud alpha services api-keys create --annotations=foo=bar,abc=def - To create a key with user-specified key id: + To create a key with user-specified key ID: $ gcloud alpha services api-keys create --key-id="my-key-id" @@ -34,29 +35,34 @@ EXAMPLES --allowed-referrers="https://www.example.com/*,http://sub.exampl\ e.com/*" - To create a key with allowed ios app bundle ids: + To create a key with allowed IOS app bundle IDs: $ gcloud alpha services api-keys create --allowed-bundle-ids=my.app - To create a key with allowed android application: + To create a key with allowed Android application: $ gcloud alpha services api-keys create \ --allowed-application=sha1_fingerprint=foo1,\ package_name=bar.foo \ --allowed-application=sha1_fingerprint=foo2,package_name=foo.bar - To create a key with allowed api targets (service name only): + To create a key with allowed API targets (service name only): $ gcloud alpha services api-keys create \ --api-target=service=bar.service.com \ --api-target=service=foo.service.com - To create a keys with allowed api targets (service and methods are + To create a key with service account: + + $ gcloud alpha services api-keys create \ + --service-account=my-service-account + + To create a key with allowed API targets (service and methods are specified): $ gcloud alpha services api-keys create --flags-file=my-flags.yaml - The content of 'my-flags.yaml' is as following: + The content of 'my-flags.yaml' is as follows: - --api-target: service: "foo.service.com" @@ -81,6 +87,10 @@ FLAGS --key-id=KEY_ID User-specified ID of the key to create. + --service-account=SERVICE_ACCOUNT + The email of the service account the key is bound to. If this field is + specified, the key is a service account bound key and auth enabled. + --api-target=service=SERVICE,[...] Repeatable. Specify service and optionally one or multiple specific methods. Both fields are case insensitive. If you need to specify diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index 98a50febe..5762c0be9 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -503,7 +503,7 @@ FLAGS --storage-type=STORAGE_TYPE The storage type for the instance. The default is SSD. STORAGE_TYPE - must be one of: SSD, HDD. + must be one of: SSD, HDD, HYPERDISK_BALANCED. --threads-per-core=THREADS_PER_CORE The number of threads per core. The value of this flag can be 1 or 2. diff --git a/gcloud/alpha/sql/operations/list b/gcloud/alpha/sql/operations/list index e88f20ce6..2265584a7 100644 --- a/gcloud/alpha/sql/operations/list +++ b/gcloud/alpha/sql/operations/list @@ -3,7 +3,7 @@ NAME given Cloud SQL instance SYNOPSIS - gcloud alpha sql operations list [--instance=INSTANCE, -i INSTANCE] + gcloud alpha sql operations list --instance=INSTANCE, -i INSTANCE [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -27,7 +27,7 @@ EXAMPLES $ gcloud alpha sql operations list --instance=prod-instance \ --page-size=10 -FLAGS +REQUIRED FLAGS --instance=INSTANCE, -i INSTANCE Cloud SQL instance ID. diff --git a/gcloud/alpha/storage/buckets/create b/gcloud/alpha/storage/buckets/create index 08449b0f5..0b61c5ccc 100644 --- a/gcloud/alpha/storage/buckets/create +++ b/gcloud/alpha/storage/buckets/create @@ -9,7 +9,8 @@ SYNOPSIS [--default-storage-class=DEFAULT_STORAGE_CLASS, -c DEFAULT_STORAGE_CLASS, -s DEFAULT_STORAGE_CLASS] [--enable-hierarchical-namespace] [--enable-per-object-retention] - [--ip-filter-file=IP_FILTER_FILE] [--location=LOCATION, -l LOCATION] + [--ip-filter-file=IP_FILTER_FILE] [--lifecycle-file=LIFECYCLE_FILE] + [--location=LOCATION, -l LOCATION] [--[no-]pap, --[no-]public-access-prevention] [--placement=[REGION,...]] [--recovery-point-objective=SETTING, --rpo=SETTING] @@ -83,6 +84,22 @@ FLAGS ] } + --lifecycle-file=LIFECYCLE_FILE + Sets the lifecycle management configuration on a bucket. For example, + The following lifecycle management configuration JSON document + specifies that all objects in this bucket that are more than 365 days + old are deleted automatically: + + { + "rule": + [ + { + "action": {"type": "Delete"}, + "condition": {"age": 365} + } + ] + } + --location=LOCATION, -l LOCATION Location (https://cloud.google.com/storage/docs/locations) for the bucket. If not specified, the location used by Cloud Storage is us. A diff --git a/gcloud/alpha/workstations/ssh b/gcloud/alpha/workstations/ssh index d5c65078e..4fa07bf45 100644 --- a/gcloud/alpha/workstations/ssh +++ b/gcloud/alpha/workstations/ssh @@ -6,8 +6,8 @@ SYNOPSIS (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) [--command=COMMAND] [--local-host-port=LOCAL_HOST_PORT; default="localhost:0"] - [--port=PORT; default=22] [--user=USER; default="user"] - [GCLOUD_WIDE_FLAG ...] [-- SSH_ARGS ...] + [--port=PORT; default=22] [--ssh-flag=SSH_FLAG] + [--user=USER; default="user"] [GCLOUD_WIDE_FLAG ...] [-- SSH_ARGS ...] DESCRIPTION (ALPHA) SSH into a running workstation. @@ -104,6 +104,13 @@ FLAGS --port=PORT; default=22 The port on the workstation to which traffic should be sent. + --ssh-flag=SSH_FLAG + Additional flags to be passed to ssh(1). It is recommended that flags + be passed using an assignment operator and quotes. Example: + + $ gcloud alpha workstations ssh --ssh-flag="-vvv" \ + --ssh-flag="-L 80:localhost:80" + --user=USER; default="user" The username with which to SSH. diff --git a/gcloud/backup-dr/backups/restore/compute b/gcloud/backup-dr/backups/restore/compute index ccad36909..8592757c1 100644 --- a/gcloud/backup-dr/backups/restore/compute +++ b/gcloud/backup-dr/backups/restore/compute @@ -249,8 +249,7 @@ OPTIONAL FLAGS startup-script Specifies a script that will be executed by the instances once they - start running. For convenience, --metadata-from-file can be used to - pull the value from a file. + start running. startup-script-url Same as startup-script except that the script contents are pulled diff --git a/gcloud/beta/compute/future-reservations/create b/gcloud/beta/compute/future-reservations/create index 490b50a51..7bb3e4d1a 100644 --- a/gcloud/beta/compute/future-reservations/create +++ b/gcloud/beta/compute/future-reservations/create @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud beta compute future-reservations create FUTURE_RESERVATION - --[no-]auto-delete-auto-created-reservations --total-count=TOTAL_COUNT + --[no-]auto-delete-auto-created-reservations (--source-instance-template=SOURCE_INSTANCE_TEMPLATE | [--machine-type=MACHINE_TYPE : --accelerator=[count=COUNT],[type=TYPE] @@ -15,8 +15,11 @@ SYNOPSIS [--name-prefix=NAME_PREFIX] [--planning-status=PLANNING_STATUS] [--[no-]require-specific-reservation] [--reservation-name=RESERVATION_NAME] - [--scheduling-type=SCHEDULING_TYPE] [--zone=ZONE] + [--scheduling-type=SCHEDULING_TYPE] [--total-count=TOTAL_COUNT] + [--zone=ZONE] [--auto-created-reservations-delete-time=AUTO_CREATED_RESERVATIONS_DELETE_TIME | --auto-created-reservations-duration=AUTO_CREATED_RESERVATIONS_DURATION] + [--commitment-name=COMMITMENT_NAME --commitment-plan=COMMITMENT_PLAN + --previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS] [--share-setting=SHARE_SETTING --share-with=PROJECT,[PROJECT,...]] [GCLOUD_WIDE_FLAG ...] @@ -56,13 +59,10 @@ REQUIRED FLAGS Use --auto-delete-auto-created-reservations to enable and --no-auto-delete-auto-created-reservations to disable. - --total-count=TOTAL_COUNT - The total number of instances for which capacity assurance is requested - at a future time period. - - Manage the instance properties for the auto-created reservations. You must - either provide a source instance template or define the instance - properties. + To create a future reservation request, specify the properties of the + resources that you want to reserve and when you want to start using them. + After the request is approved, Compute Engine automatically creates + reservations for your requested resources at your specified start time. Exactly one of these must be specified: @@ -197,6 +197,10 @@ OPTIONAL FLAGS In INDEPENDENT mode, maintenance is not synchronized for this reservation, and each instance has its own maintenance window. + --total-count=TOTAL_COUNT + The total number of instances for which capacity assurance is requested + at a future time period. + --zone=ZONE Zone of the future reservation to create. If not specified and the compute/zone property isn't set, you might be prompted to select a zone @@ -236,6 +240,28 @@ OPTIONAL FLAGS for 30 minutes, or 1d2h3m4s for 1 day, 2 hours, 3 minutes, and 4 seconds. For more information, see $ gcloud topic datetimes. + Manage the commitment info properties + + --commitment-name=COMMITMENT_NAME + Name of commitment covering the delivered reservation at the time of + delivery of future reservations. If not specified, it takes the name + of the future reservation. + + --commitment-plan=COMMITMENT_PLAN + The plan for this commitment to be created, which determines duration + and discount rate. The currently supported plans are TWELVE_MONTH (1 + year), and THIRTY_SIX_MONTH (3 years). COMMITMENT_PLAN must be one + of: TWELVE_MONTH, THIRTY_SIX_MONTH. + + --previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS + Applicable only if future reservation will deliver to an existing + reservation with a ramp plan. When set to EXTEND, all associated + parent Committed Used Discount's end-date/term will be extended to + the end-time of this future reservation. Default is to extend + previous commitment's time to the end_time of the reservation. + PREVIOUS_COMMITMENT_TERMS must be (only one value is supported): + EXTEND. + Manage the properties of a shared reservation. --share-setting=SHARE_SETTING diff --git a/gcloud/beta/compute/future-reservations/update b/gcloud/beta/compute/future-reservations/update index 876c45e19..075d0181c 100644 --- a/gcloud/beta/compute/future-reservations/update +++ b/gcloud/beta/compute/future-reservations/update @@ -15,6 +15,8 @@ SYNOPSIS [--clear-name-prefix | --name-prefix=NAME_PREFIX] [--clear-share-settings | --share-setting=SHARE_SETTING --share-with=PROJECT,[PROJECT,...]] + [--commitment-name=COMMITMENT_NAME --commitment-plan=COMMITMENT_PLAN + --previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS] [--machine-type=MACHINE_TYPE --min-cpu-platform=MIN_CPU_PLATFORM --accelerator=[count=COUNT],[type=TYPE] | --clear-accelerator --clear-local-ssd @@ -172,6 +174,28 @@ FLAGS list of projects that this future reservation is shared with. The list must contain project IDs or project numbers. + Manage the commitment info properties + + --commitment-name=COMMITMENT_NAME + Name of commitment covering the delivered reservation at the time of + delivery of future reservations. If not specified, it takes the name + of the future reservation. + + --commitment-plan=COMMITMENT_PLAN + The plan for this commitment to be created, which determines duration + and discount rate. The currently supported plans are TWELVE_MONTH (1 + year), and THIRTY_SIX_MONTH (3 years). COMMITMENT_PLAN must be one + of: TWELVE_MONTH, THIRTY_SIX_MONTH. + + --previous-commitment-terms=PREVIOUS_COMMITMENT_TERMS + Applicable only if future reservation will deliver to an existing + reservation with a ramp plan. When set to EXTEND, all associated + parent Committed Used Discount's end-date/term will be extended to + the end-time of this future reservation. Default is to extend + previous commitment's time to the end_time of the reservation. + PREVIOUS_COMMITMENT_TERMS must be (only one value is supported): + EXTEND. + Manage the specific SKU reservation properties. --machine-type=MACHINE_TYPE diff --git a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create index ed9ed4208..294653872 100644 --- a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create +++ b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create @@ -9,7 +9,8 @@ SYNOPSIS [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] [--security-profile-group=SECURITY_PROFILE_GROUP] - [--src-ip-ranges=[SRC_IP_RANGE,...]] [GCLOUD_WIDE_FLAG ...] + [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute network-firewall-policies mirroring-rules create @@ -72,6 +73,10 @@ OPTIONAL FLAGS --src-secure-tags.Multiple IP address blocks can be specified if they are separated by commas. + --target-secure-tags=[TARGET_SECURE_TAGS,...] + An optional, list of target secure tags with a name of the format + tagValues/ or full namespaced name + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/update b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/update index f78990b1f..a2aaccab7 100644 --- a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/update +++ b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/update @@ -10,7 +10,8 @@ SYNOPSIS [--[no-]disabled] [--layer4-configs=[LAYER4_CONFIG,...]] [--new-priority=NEW_PRIORITY] [--security-profile-group=SECURITY_PROFILE_GROUP] - [--src-ip-ranges=[SRC_IP_RANGE,...]] [GCLOUD_WIDE_FLAG ...] + [--src-ip-ranges=[SRC_IP_RANGE,...]] + [--target-secure-tags=[TARGET_SECURE_TAGS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute network-firewall-policies mirroring-rules update @@ -77,6 +78,10 @@ OPTIONAL FLAGS --src-secure-tags.Multiple IP address blocks can be specified if they are separated by commas. + --target-secure-tags=[TARGET_SECURE_TAGS,...] + An optional, list of target secure tags with a name of the format + tagValues/ or full namespaced name + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/compute/reservations/blocks/help b/gcloud/beta/compute/reservations/blocks/help index ab9b7585e..497585b57 100644 --- a/gcloud/beta/compute/reservations/blocks/help +++ b/gcloud/beta/compute/reservations/blocks/help @@ -21,6 +21,9 @@ COMMANDS list (BETA) List Compute Engine reservation blocks. + perform-maintenance + (BETA) Perform maintenance on a reservation block within a reservation. + NOTES This command is currently in beta and might change without notice. This variant is also available: diff --git a/gcloud/beta/compute/reservations/blocks/perform-maintenance b/gcloud/beta/compute/reservations/blocks/perform-maintenance new file mode 100644 index 000000000..b9f25ec22 --- /dev/null +++ b/gcloud/beta/compute/reservations/blocks/perform-maintenance @@ -0,0 +1,76 @@ +NAME + gcloud beta compute reservations blocks perform-maintenance - perform + maintenance on a reservation block within a reservation + +SYNOPSIS + gcloud beta compute reservations blocks perform-maintenance RESERVATION + --block-name=BLOCK_NAME [--scope=SCOPE] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Perform maintenance on a reservation block within a reservation. + +EXAMPLES + To perform maintenance on a reservation block in reservation exr1 in + my-zone with block name block1 with scope all, run: + + $ gcloud beta compute reservations blocks perform-maintenance exr1 \ + --zone=my-zone --block-name=block1 --scope=all + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to perform-maintenance. + +REQUIRED FLAGS + --block-name=BLOCK_NAME + The name of the reservation block. + +OPTIONAL FLAGS + --scope=SCOPE + The maintenance scope to set for the reservation block. SCOPE must be + one of: + + all + Perform maintenance on all hosts in the reservation block. + running + Perform maintenance only on the hosts in the reservation block that + have running VMs. + unused + Perform maintenance only on the hosts in the reservation block that + don't have running VMs. + + --zone=ZONE + Zone of the reservation to perform-maintenance. If not specified and + the compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +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 compute reservations blocks perform-maintenance + diff --git a/gcloud/beta/compute/reservations/help b/gcloud/beta/compute/reservations/help index 03928c424..ad61228db 100644 --- a/gcloud/beta/compute/reservations/help +++ b/gcloud/beta/compute/reservations/help @@ -45,6 +45,10 @@ COMMANDS list (BETA) List Compute Engine reservations. + perform-maintenance + (BETA) Perform maintenance on a reservation, only applicable to + reservations with reservation blocks. + remove-iam-policy-binding (BETA) Remove IAM policy binding from a Compute Engine reservation. diff --git a/gcloud/beta/compute/reservations/perform-maintenance b/gcloud/beta/compute/reservations/perform-maintenance new file mode 100644 index 000000000..1f3d9e334 --- /dev/null +++ b/gcloud/beta/compute/reservations/perform-maintenance @@ -0,0 +1,71 @@ +NAME + gcloud beta compute reservations perform-maintenance - perform maintenance + on a reservation, only applicable to reservations with reservation + blocks + +SYNOPSIS + gcloud beta compute reservations perform-maintenance RESERVATION + [--scope=SCOPE] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Perform maintenance on a reservation, only applicable to + reservations with reservation blocks. + +EXAMPLES + To perform maintenance on reservation exr1 in my-zone with scope all, run: + + $ gcloud beta compute reservations perform-maintenance exr1 \ + --zone=my-zone --scope=all + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to perform-maintenance. + +FLAGS + --scope=SCOPE + The maintenance scope to set for the reservation. SCOPE must be one of: + + all + Perform maintenance on all hosts in the reservation. + running + Perform maintenance only on the hosts in the reservation that have + running VMs. + unused + Perform maintenance only on the hosts in the reservation that don't + have running VMs. + + --zone=ZONE + Zone of the reservation to perform-maintenance. If not specified and + the compute/zone property isn't set, you might be prompted to select a + zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +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 compute reservations perform-maintenance + diff --git a/gcloud/beta/dataproc/clusters/create b/gcloud/beta/dataproc/clusters/create index 3d8627f32..0def91c50 100644 --- a/gcloud/beta/dataproc/clusters/create +++ b/gcloud/beta/dataproc/clusters/create @@ -4,7 +4,6 @@ NAME SYNOPSIS gcloud beta dataproc clusters create (CLUSTER : --region=REGION) [--async] [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] - [--dataproc-metastore=DATAPROC_METASTORE] [--driver-pool-accelerator=[type=TYPE,[count=COUNT],...]] [--driver-pool-boot-disk-size=DRIVER_POOL_BOOT_DISK_SIZE] [--driver-pool-boot-disk-type=DRIVER_POOL_BOOT_DISK_TYPE] @@ -51,6 +50,8 @@ SYNOPSIS [--worker-boot-disk-type=WORKER_BOOT_DISK_TYPE] [--worker-local-ssd-interface=WORKER_LOCAL_SSD_INTERFACE] [--worker-min-cpu-platform=PLATFORM] [--zone=ZONE, -z ZONE] + [--dataproc-metastore=DATAPROC_METASTORE | --bigquery-metastore + --bigquery-metastore-database-location=BIGQUERY_METASTORE_DATABASE_LOCATION --bigquery-metastore-project-id=BIGQUERY_METASTORE_PROJECT_ID] [--expiration-time=EXPIRATION_TIME | --max-age=MAX_AGE] [--gce-pd-kms-key=GCE_PD_KMS_KEY : --gce-pd-kms-key-keyring=GCE_PD_KMS_KEY_KEYRING @@ -136,11 +137,6 @@ FLAGS dependencies, miscellaneous config files, and job driver console output when using this cluster. - --dataproc-metastore=DATAPROC_METASTORE - Specify the name of a Dataproc Metastore service to be used as an - external metastore in the format: - "projects/{project-id}/locations/{region}/services/{service-name}". - --driver-pool-accelerator=[type=TYPE,[count=COUNT],...] Attaches accelerators, such as GPUs, to the driver-pool instance(s). @@ -482,6 +478,26 @@ FLAGS zone in the region. Overrides the default compute/zone property value for this command invocation. + At most one of these can be specified: + + --dataproc-metastore=DATAPROC_METASTORE + Specify the name of a Dataproc Metastore service to be used as an + external metastore in the format: + "projects/{project-id}/locations/{region}/services/{service-name}". + + BQMS flags + + --bigquery-metastore + Indicates that BigQuery metastore is to be used. + + --bigquery-metastore-database-location=BIGQUERY_METASTORE_DATABASE_LOCATION + Location of the BigQuery metastore database to be used as an + external metastore. + + --bigquery-metastore-project-id=BIGQUERY_METASTORE_PROJECT_ID + The project ID of the BigQuery metastore database to be used as an + external metastore. + At most one of these can be specified: --expiration-time=EXPIRATION_TIME diff --git a/gcloud/beta/dataproc/workflow-templates/set-managed-cluster b/gcloud/beta/dataproc/workflow-templates/set-managed-cluster index b079e4762..a95aa8728 100644 --- a/gcloud/beta/dataproc/workflow-templates/set-managed-cluster +++ b/gcloud/beta/dataproc/workflow-templates/set-managed-cluster @@ -6,7 +6,7 @@ SYNOPSIS gcloud beta dataproc workflow-templates set-managed-cluster (TEMPLATE : --region=REGION) [--autoscaling-policy=AUTOSCALING_POLICY] [--bucket=BUCKET] [--cluster-name=CLUSTER_NAME] - [--dataproc-metastore=DATAPROC_METASTORE] [--enable-component-gateway] + [--enable-component-gateway] [--initialization-action-timeout=TIMEOUT; default="10m"] [--initialization-actions=CLOUD_STORAGE_URI,[...]] [--labels=[KEY=VALUE,...]] @@ -44,6 +44,8 @@ SYNOPSIS [--worker-boot-disk-type=WORKER_BOOT_DISK_TYPE] [--worker-local-ssd-interface=WORKER_LOCAL_SSD_INTERFACE] [--worker-min-cpu-platform=PLATFORM] [--zone=ZONE, -z ZONE] + [--dataproc-metastore=DATAPROC_METASTORE | --bigquery-metastore + --bigquery-metastore-database-location=BIGQUERY_METASTORE_DATABASE_LOCATION --bigquery-metastore-project-id=BIGQUERY_METASTORE_PROJECT_ID] [--image=IMAGE | --image-version=VERSION] [--kerberos-config-file=KERBEROS_CONFIG_FILE | --enable-kerberos --kerberos-root-principal-password-uri=KERBEROS_ROOT_PRINCIPAL_PASSWORD_URI [--kerberos-kms-key=KERBEROS_KMS_KEY : --kerberos-kms-key-keyring=KERBEROS_KMS_KEY_KEYRING --kerberos-kms-key-location=KERBEROS_KMS_KEY_LOCATION --kerberos-kms-key-project=KERBEROS_KMS_KEY_PROJECT]] @@ -125,11 +127,6 @@ FLAGS The name of the managed dataproc cluster. If unspecified, the workflow template ID will be used. - --dataproc-metastore=DATAPROC_METASTORE - Specify the name of a Dataproc Metastore service to be used as an - external metastore in the format: - "projects/{project-id}/locations/{region}/services/{service-name}". - --enable-component-gateway Enable access to the web UIs of selected components on the cluster through the component gateway. @@ -414,6 +411,26 @@ FLAGS zone in the region. Overrides the default compute/zone property value for this command invocation. + At most one of these can be specified: + + --dataproc-metastore=DATAPROC_METASTORE + Specify the name of a Dataproc Metastore service to be used as an + external metastore in the format: + "projects/{project-id}/locations/{region}/services/{service-name}". + + BQMS flags + + --bigquery-metastore + Indicates that BigQuery metastore is to be used. + + --bigquery-metastore-database-location=BIGQUERY_METASTORE_DATABASE_LOCATION + Location of the BigQuery metastore database to be used as an + external metastore. + + --bigquery-metastore-project-id=BIGQUERY_METASTORE_PROJECT_ID + The project ID of the BigQuery metastore database to be used as an + external metastore. + At most one of these can be specified: --image=IMAGE diff --git a/gcloud/beta/developer-connect/connections/create b/gcloud/beta/developer-connect/connections/create index 7b6f70e2a..641dce5b9 100644 --- a/gcloud/beta/developer-connect/connections/create +++ b/gcloud/beta/developer-connect/connections/create @@ -7,8 +7,7 @@ SYNOPSIS [--annotations=[ANNOTATIONS,...]] [--async] [--disabled] [--etag=ETAG] [--labels=[LABELS,...]] [--location=LOCATION] [--namespace=NAMESPACE] [--request-id=REQUEST_ID] [--secret=SECRET] [--validate-only] - [[--github-config-app=GITHUB_CONFIG_APP - : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] | [--github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI : --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION] | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION | [--gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-webhook-secret-version=GITLAB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION : --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE]] + [--bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-webhook-secret-version=BITBUCKET_CLOUD_CONFIG_WEBHOOK_SECRET_VERSION --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE | [--bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-webhook-secret-version=BITBUCKET_DATA_CENTER_CONFIG_WEBHOOK_SECRET_VERSION : --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE] | [--github-config-app=GITHUB_CONFIG_APP : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] | [--github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI : --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION] | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION | [--gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-webhook-secret-version=GITLAB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION : --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE]] [(--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE : --key-ring=KEY_RING)] [GCLOUD_WIDE_FLAG ...] @@ -147,6 +146,259 @@ FLAGS At most one of these can be specified: + Configuration for connections to an instance of Bitbucket Cloud. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line. + + SecretVersion resource - SecretManager resource containing the webhook + secret used to verify webhook events, formatted as + projects/*/secrets/*/versions/*. This is used to validate and create + webhooks. 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 + --bitbucket-cloud-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument + --bitbucket-cloud-config-webhook-secret-version on the command line + with a fully specified name; + ▫ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-cloud-config-webhook-secret-version=BITBUCKET_CLOUD_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --bitbucket-cloud-config-webhook-secret-version on the command + line. + + --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE + The Bitbucket Cloud Workspace ID to be connected to Google Cloud + Platform. + + Configuration for connections to an instance of Bitbucket Data Center. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line. + + --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI + The URI of the Bitbucket Data Center host this connection is for. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line. + + SecretVersion resource - SecretManager resource containing the webhook + secret used to verify webhook events, formatted as + projects/*/secrets/*/versions/*. This is used to validate webhooks. + 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 + --bitbucket-data-center-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument + --bitbucket-data-center-config-webhook-secret-version on the + command line with a fully specified name; + ▫ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-data-center-config-webhook-secret-version=BITBUCKET_DATA_CENTER_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --bitbucket-data-center-config-webhook-secret-version on the + command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + Service resource - The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + 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 + --bitbucket-data-center-config-service-directory 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 + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --location on the command line. + + To set the namespace attribute: + ◇ provide the argument + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --namespace on the command line. + + This must be specified. + + --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY + ID of the service or fully qualified identifier for the + service. + + To set the service attribute: + ▹ provide the argument + --bitbucket-data-center-config-service-directory on the + command line. + + --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE + SSL certificate authority to trust when making requests to + Bitbucket Data Center. + Configuration for connections to github.com. --github-config-app=GITHUB_CONFIG_APP diff --git a/gcloud/beta/developer-connect/connections/update b/gcloud/beta/developer-connect/connections/update index d0c6fabdc..7d44bdd17 100644 --- a/gcloud/beta/developer-connect/connections/update +++ b/gcloud/beta/developer-connect/connections/update @@ -10,8 +10,7 @@ SYNOPSIS [--annotations=[ANNOTATIONS,...] | --update-annotations=[UPDATE_ANNOTATIONS,...] --clear-annotations | --remove-annotations=[__REMOVE_ANNOTATIONS,...]] - [--github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID - --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION | --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --clear-github-enterprise-config-private-key-secret-version | --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --clear-github-enterprise-config-webhook-secret-version | --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION | --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE] + [--bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE | --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE | --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION | --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --clear-github-enterprise-config-private-key-secret-version | --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --clear-github-enterprise-config-webhook-secret-version | --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION | --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE] [--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE : --key-ring=KEY_RING] [--labels=[LABELS,...] @@ -173,6 +172,181 @@ FLAGS At most one of these can be specified: + Configuration for connections to an instance of Bitbucket Cloud. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line. + + --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE + The Bitbucket Cloud Workspace ID to be connected to Google Cloud + Platform. + + Configuration for connections to an instance of Bitbucket Data Center. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line. + + --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI + The URI of the Bitbucket Data Center host this connection is for. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + Service resource - The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + 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 + --bitbucket-data-center-config-service-directory 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 + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --location on the command line. + + To set the namespace attribute: + ◇ provide the argument + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --namespace on the command line. + + --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY + ID of the service or fully qualified identifier for the + service. + + To set the service attribute: + ▹ provide the argument + --bitbucket-data-center-config-service-directory on the + command line. + + --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE + SSL certificate authority to trust when making requests to + Bitbucket Data Center. + Configuration for connections to github.com. --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID diff --git a/gcloud/beta/functions/detach b/gcloud/beta/functions/detach new file mode 100644 index 000000000..27e73170b --- /dev/null +++ b/gcloud/beta/functions/detach @@ -0,0 +1,59 @@ +NAME + gcloud beta functions detach - detach a GCF 2nd gen function from GCF and + make it a native Cloud Run function + +SYNOPSIS + gcloud beta functions detach (NAME : --region=REGION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Detach a GCF 2nd gen function from GCF and make it a native Cloud + Run function. + +POSITIONAL ARGUMENTS + Function resource - The Cloud Function name to detach. 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 NAME 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. + + NAME + ID of the function or fully qualified identifier for the function. + + To set the function attribute: + ▸ provide the argument NAME on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The Cloud region for the function. Overrides the default + functions/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument NAME on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property functions/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 functions detach + diff --git a/gcloud/beta/functions/help b/gcloud/beta/functions/help index fbfd3552a..c652200d3 100644 --- a/gcloud/beta/functions/help +++ b/gcloud/beta/functions/help @@ -50,6 +50,10 @@ COMMANDS describe (BETA) Display details of a Google Cloud Function. + detach + (BETA) Detach a GCF 2nd gen function from GCF and make it a native + Cloud Run function. + get-iam-policy (BETA) Gets IAM policy for a Google Cloud Function. diff --git a/gcloud/beta/netapp/volumes/help b/gcloud/beta/netapp/volumes/help index d35e156c1..02064c54e 100644 --- a/gcloud/beta/netapp/volumes/help +++ b/gcloud/beta/netapp/volumes/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + quota-rules + (BETA) Create and manage Cloud NetApp Volume QuotaRules. + replications (BETA) Create and manage Cloud NetApp Volume Replications. diff --git a/gcloud/beta/netapp/volumes/quota-rules/create b/gcloud/beta/netapp/volumes/quota-rules/create new file mode 100644 index 000000000..a08c3f146 --- /dev/null +++ b/gcloud/beta/netapp/volumes/quota-rules/create @@ -0,0 +1,145 @@ +NAME + gcloud beta netapp volumes quota-rules create - create a Cloud NetApp + Volume Quota Rule + +SYNOPSIS + gcloud beta netapp volumes quota-rules create + (QUOTA_RULE : --location=LOCATION) --disk-limit-mib=DISK_LIMIT_MIB + --type=TYPE [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [--target=TARGET] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a Cloud NetApp Volume Quota Rule. + +EXAMPLES + The following command creates a default user Quota Rule named NAME using + the required arguments: + + $ gcloud beta netapp volumes quota-rules create NAME \ + --location=us-central1 --volume=vol1 --type=DEFAULT_USER_QUOTA \ + --disk-limit-mib=200 + + The following command creates a default group Quota Rule named NAME using + the required arguments: + + $ gcloud beta netapp volumes quota-rules create NAME \ + --location=us-central1 --volume=vol1 \ + --type=DEFAULT_GROUP_QUOTA --disk-limit-mib=200 + + The following command creates an individual user Quota Rule named NAME for + user with UID '100' using the required arguments: + + $ gcloud beta netapp volumes quota-rules create NAME \ + --location=us-central1 --volume=vol1 \ + --type=INDIVIDUAL_USER_QUOTA --target=100 --disk-limit-mib=200 + + The following command creates an individual group Quota Rule named NAME for + group with GID '1001' using the required arguments: + + $ gcloud beta netapp volumes quota-rules create NAME \ + --location=us-central1 --volume=vol1 \ + --type=INDIVIDUAL_GROUP_QUOTA --target=1001 --disk-limit-mib=200 + +POSITIONAL ARGUMENTS + Quota rule resource - The Quota rule 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 quota_rule 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 volume attribute: + ◆ provide the argument quota_rule on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + QUOTA_RULE + ID of the quota_rule or fully qualified identifier for the + quota_rule. + + To set the quota_rule attribute: + ▸ provide the argument quota_rule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the quota_rule. + + To set the location attribute: + ▸ provide the argument quota_rule on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +REQUIRED FLAGS + --disk-limit-mib=DISK_LIMIT_MIB + The disk limit in MiB for the quota rule. + + --type=TYPE + String indicating the type of quota rule. The supported values are: + 'DEFAULT_USER_QUOTA','DEFAULT_GROUP_QUOTA','INDIVIDUAL_USER_QUOTA','INDIVIDUAL_GROUP_QUOTA' + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Quota rule + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --target=TARGET + The target of the quota rule. Identified by a Unix UID/GID, Windows + SID, or null for default. + + Volume resource - The volume for which quota rule applies. 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +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 netapp volumes quota-rules create + diff --git a/gcloud/beta/netapp/volumes/quota-rules/delete b/gcloud/beta/netapp/volumes/quota-rules/delete new file mode 100644 index 000000000..ce5ff3735 --- /dev/null +++ b/gcloud/beta/netapp/volumes/quota-rules/delete @@ -0,0 +1,103 @@ +NAME + gcloud beta netapp volumes quota-rules delete - delete a Cloud NetApp + Volume Quota Rule + +SYNOPSIS + gcloud beta netapp volumes quota-rules delete + (QUOTA_RULE : --location=LOCATION) [--async] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a Cloud NetApp Volume QuotaRule. + +EXAMPLES + The following command deletes a QuotaRule named NAME using the required + arguments: + + $ gcloud beta netapp volumes quota-rules delete NAME \ + --location=us-central1 --volume=vol1 + + To delete a QuotaRule named NAME asynchronously, run the following command: + + $ gcloud beta netapp volumes quota-rules delete NAME \ + --location=us-central1 --volume=vol1 --async + +POSITIONAL ARGUMENTS + Quota rule resource - The Quota Rule 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 quota_rule 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 volume attribute: + ◆ provide the argument quota_rule on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + QUOTA_RULE + ID of the quota_rule or fully qualified identifier for the + quota_rule. + + To set the quota_rule attribute: + ▸ provide the argument quota_rule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the quota_rule. + + To set the location attribute: + ▸ provide the argument quota_rule on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Volume resource - The volume for which quota rule applies. 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +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 netapp volumes quota-rules delete + diff --git a/gcloud/beta/netapp/volumes/quota-rules/describe b/gcloud/beta/netapp/volumes/quota-rules/describe new file mode 100644 index 000000000..076b7ba73 --- /dev/null +++ b/gcloud/beta/netapp/volumes/quota-rules/describe @@ -0,0 +1,94 @@ +NAME + gcloud beta netapp volumes quota-rules describe - describe a Cloud NetApp + Volume Quota Rule + +SYNOPSIS + gcloud beta netapp volumes quota-rules describe + (QUOTA_RULE : --location=LOCATION) [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a Cloud NetApp Volume Quota Rule. + +EXAMPLES + The following command describes a Quota Rule named NAME in the given + location and volume: + + $ gcloud beta netapp volumes quota-rules describe NAME \ + --location=us-central1 --volume=vol1 + +POSITIONAL ARGUMENTS + Quota rule resource - The Quota Rule 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 quota_rule 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 volume attribute: + ◆ provide the argument quota_rule on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + QUOTA_RULE + ID of the quota_rule or fully qualified identifier for the + quota_rule. + + To set the quota_rule attribute: + ▸ provide the argument quota_rule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the quota_rule. + + To set the location attribute: + ▸ provide the argument quota_rule on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + Volume resource - The volume for which quota rule applies. 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +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 netapp volumes quota-rules describe + diff --git a/gcloud/beta/netapp/volumes/quota-rules/help b/gcloud/beta/netapp/volumes/quota-rules/help new file mode 100644 index 000000000..1cc69b86f --- /dev/null +++ b/gcloud/beta/netapp/volumes/quota-rules/help @@ -0,0 +1,39 @@ +NAME + gcloud beta netapp volumes quota-rules - create and manage Cloud NetApp + Volume QuotaRules + +SYNOPSIS + gcloud beta netapp volumes quota-rules COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create and manage Cloud NetApp Volume QuotaRules. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Cloud NetApp Volume Quota Rule. + + delete + (BETA) Delete a Cloud NetApp Volume Quota Rule. + + describe + (BETA) Describe a Cloud NetApp Volume Quota Rule. + + list + (BETA) List Cloud NetApp Volume QuotaRules. + + update + (BETA) Update a Cloud NetApp Volume Quota Rule. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud netapp volumes quota-rules + diff --git a/gcloud/beta/netapp/volumes/quota-rules/list b/gcloud/beta/netapp/volumes/quota-rules/list new file mode 100644 index 000000000..6994f32e7 --- /dev/null +++ b/gcloud/beta/netapp/volumes/quota-rules/list @@ -0,0 +1,109 @@ +NAME + gcloud beta netapp volumes quota-rules list - list Cloud NetApp Volume + QuotaRules + +SYNOPSIS + gcloud beta netapp volumes quota-rules list [--location=LOCATION] + [--volume=VOLUME] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Lists Cloud NetApp Volume QuotaRules. + +EXAMPLES + The following command lists all QuotaRules in the given location and + volume: + + $ gcloud beta netapp volumes quota-rules list \ + --location=us-central1 --volume=vol1 + +FLAGS + Location resource - The location in which to list Volume QuotaRules. 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; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location 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; + ▸ uses all locations by default.; + ▸ set the property netapp/location. + + Volume resource - The volume for which quota rule applies. 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +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 netapp volumes quota-rules list + diff --git a/gcloud/beta/netapp/volumes/quota-rules/update b/gcloud/beta/netapp/volumes/quota-rules/update new file mode 100644 index 000000000..e7a106289 --- /dev/null +++ b/gcloud/beta/netapp/volumes/quota-rules/update @@ -0,0 +1,136 @@ +NAME + gcloud beta netapp volumes quota-rules update - update a Cloud NetApp + Volume Quota Rule + +SYNOPSIS + gcloud beta netapp volumes quota-rules update + (QUOTA_RULE : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--disk-limit-mib=DISK_LIMIT_MIB] + [--update-labels=[KEY=VALUE,...]] [--volume=VOLUME] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Cloud NetApp Volume QuotaRule and its specified parameters. + +EXAMPLES + The following command updates a QuotaRule named NAME and its specified + parameters: + + $ gcloud beta netapp volumes quota-rules update NAME \ + --location=us-central1 --description="new" \ + --disk-limit-mib=100 --update-labels=key2=val2 --volume=vol1 + +POSITIONAL ARGUMENTS + Quota rule resource - The Quota rule to update. 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 quota_rule 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 volume attribute: + ◆ provide the argument quota_rule on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + QUOTA_RULE + ID of the quota_rule or fully qualified identifier for the + quota_rule. + + To set the quota_rule attribute: + ▸ provide the argument quota_rule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the quota_rule. + + To set the location attribute: + ▸ provide the argument quota_rule on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Quota rule + + --disk-limit-mib=DISK_LIMIT_MIB + The disk limit in MiB for the quota rule. + + --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. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + Volume resource - The volume for which quota rule applies. 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + + 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 netapp volumes quota-rules update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta netapp volumes quota-rules 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. + +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 netapp volumes quota-rules update + diff --git a/gcloud/beta/network-connectivity/hubs/groups/list b/gcloud/beta/network-connectivity/hubs/groups/list index 4ed62e903..f9d1dd981 100644 --- a/gcloud/beta/network-connectivity/hubs/groups/list +++ b/gcloud/beta/network-connectivity/hubs/groups/list @@ -2,7 +2,7 @@ NAME gcloud beta network-connectivity hubs groups list - list groups SYNOPSIS - gcloud beta network-connectivity hubs groups list --hub=HUB + gcloud beta network-connectivity hubs groups list [--hub=HUB] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -18,7 +18,7 @@ EXAMPLES $ gcloud beta network-connectivity hubs groups list --hub=my-hub -REQUIRED FLAGS +FLAGS Hub resource - Parent hub of the groups to display. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. @@ -26,16 +26,17 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --hub on the command line with a fully specified name; + ◆ if hub is empty, will use the wildcard '-' to indicate all hubs with + a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --hub=HUB ID of the hub or fully qualified identifier for the hub. To set the hub attribute: - ▸ provide the argument --hub on the command line. + ▸ provide the argument --hub on the command line; + ▸ if hub is empty, will use the wildcard '-' to indicate all hubs. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/network-connectivity/hubs/route-tables/list b/gcloud/beta/network-connectivity/hubs/route-tables/list index f29837926..90d93d766 100644 --- a/gcloud/beta/network-connectivity/hubs/route-tables/list +++ b/gcloud/beta/network-connectivity/hubs/route-tables/list @@ -2,7 +2,7 @@ NAME gcloud beta network-connectivity hubs route-tables list - list route tables SYNOPSIS - gcloud beta network-connectivity hubs route-tables list --hub=HUB + gcloud beta network-connectivity hubs route-tables list [--hub=HUB] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -20,7 +20,7 @@ EXAMPLES $ gcloud beta network-connectivity hubs route-tables list \ --hub=my-hub -REQUIRED FLAGS +FLAGS Hub resource - Parent hub of the route tables to display. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. @@ -28,16 +28,17 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --hub on the command line with a fully specified name; + ◆ if hub is empty, will use the wildcard '-' to indicate all hubs with + a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --hub=HUB ID of the hub or fully qualified identifier for the hub. To set the hub attribute: - ▸ provide the argument --hub on the command line. + ▸ provide the argument --hub on the command line; + ▸ if hub is empty, will use the wildcard '-' to indicate all hubs. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/network-connectivity/hubs/route-tables/routes/list b/gcloud/beta/network-connectivity/hubs/route-tables/routes/list index dd069b5a5..f47d24f13 100644 --- a/gcloud/beta/network-connectivity/hubs/route-tables/routes/list +++ b/gcloud/beta/network-connectivity/hubs/route-tables/routes/list @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud beta network-connectivity hubs route-tables routes list - (--route_table=ROUTE_TABLE : --hub=HUB) - [--effective-location=EFFECTIVE_LOCATION] [--filter=EXPRESSION] + [--effective-location=EFFECTIVE_LOCATION] + [--hub=HUB --route_table=ROUTE_TABLE] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -31,7 +31,12 @@ EXAMPLES --hub=my-hub --route_table=my-route-table \ --effective-location=location -REQUIRED FLAGS +FLAGS + --effective-location=EFFECTIVE_LOCATION + The effective location/region to limit the list of routes. The + effective location must be a valid region name. To list valid region + names, use 'gcloud compute regions list'. + Route table resource - Parent route table of the routes to display. 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 @@ -40,34 +45,30 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --route_table on the command line with a fully specified name; + ◆ if route table is empty, will use wildcard '-' to list all route + tables with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --route_table=ROUTE_TABLE - ID of the route table or fully qualified identifier for the route - table. - - To set the route_table attribute: - ▸ provide the argument --route_table on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --hub=HUB Id of the hub. To set the hub attribute: ▸ provide the argument --route_table on the command line with a fully specified name; - ▸ provide the argument --hub on the command line. + ▸ if route table is empty, will use wildcard '-' to list all route + tables with a fully specified name; + ▸ provide the argument --hub on the command line; + ▸ if hub is empty, will use the wildcard '-' to indicate all hubs. -FLAGS - --effective-location=EFFECTIVE_LOCATION - The effective location/region to limit the list of routes. The - effective location must be a valid region name. To list valid region - names, use 'gcloud compute regions list'. + --route_table=ROUTE_TABLE + ID of the route table or fully qualified identifier for the route + table. + + To set the route_table attribute: + ▸ provide the argument --route_table on the command line; + ▸ if route table is empty, will use wildcard '-' to list all route + tables . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/network-services/multicast-group-ranges/create b/gcloud/beta/network-services/multicast-group-ranges/create index 42ae48dd7..d80158f57 100644 --- a/gcloud/beta/network-services/multicast-group-ranges/create +++ b/gcloud/beta/network-services/multicast-group-ranges/create @@ -9,7 +9,7 @@ SYNOPSIS --reserved-internal-range=RESERVED_INTERNAL_RANGE [--async] [--consumer-accept-list=[CONSUMER_ACCEPT_LIST,...]] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] - [GCLOUD_WIDE_FLAG ...] + [--require-explicit-accept] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a multicast group range in the specified location of the @@ -83,6 +83,10 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + --require-explicit-accept + Whether an empty consumer accept list will reject all consumer + projects. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/run/deploy b/gcloud/beta/run/deploy index 49604de9f..2b74cf20c 100644 --- a/gcloud/beta/run/deploy +++ b/gcloud/beta/run/deploy @@ -13,10 +13,10 @@ SYNOPSIS [--max-instances=MAX_INSTANCES] [--mesh=MESH] [--min=MIN] [--min-instances=MIN_INSTANCES] [--region=REGION] [--remove-containers=[CONTAINER,...]] - [--revision-suffix=REVISION_SUFFIX] [--service-account=SERVICE_ACCOUNT] - [--[no-]session-affinity] [--tag=TAG] [--timeout=TIMEOUT] - [--no-traffic] [--vpc-connector=VPC_CONNECTOR] - [--vpc-egress=VPC_EGRESS] + [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] + [--service-account=SERVICE_ACCOUNT] [--[no-]session-affinity] + [--tag=TAG] [--timeout=TIMEOUT] [--no-traffic] + [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] [--add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --clear-cloudsql-instances | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] @@ -247,6 +247,11 @@ FLAGS a revision named 'helloworld-v1'. Set empty string to clear the suffix and resume server-assigned naming. + --scaling=SCALING + The scaling mode to use for this resource. Flag value could be either + "auto" for automatic scaling, or a positive integer to configure manual + scaling with the given integer as a fixed instance count. + --service-account=SERVICE_ACCOUNT the email address of an IAM service account associated with the revision of the service. The service account represents the identity of @@ -622,7 +627,9 @@ FLAGS us-docker.pkg.dev/cloudrun/container/hello:latest). When used with --source, the image must be the URI of an Artifact Registry Docker repository in the Docker format - ($REGION-docker.pkg.dev/$PROJECT/$REPOSITORY"). + ($REGION-docker.pkg.dev/$PROJECT/$REPOSITORY") or + ($REGION-docker.pkg.dev/$PROJECT/$REPOSITORY/$IMAGE_NAME"). The + image name must be the same as the name of the service. --source=SOURCE The location of the source to build. If a Dockerfile is present in diff --git a/gcloud/beta/run/multi-region-services/update b/gcloud/beta/run/multi-region-services/update index 031469db8..2bd4d12b2 100644 --- a/gcloud/beta/run/multi-region-services/update +++ b/gcloud/beta/run/multi-region-services/update @@ -15,10 +15,10 @@ SYNOPSIS [--max-instances=MAX_INSTANCES] [--mesh=MESH] [--min=MIN] [--min-instances=MIN_INSTANCES] [--region=REGION] [--remove-containers=[CONTAINER,...]] - [--revision-suffix=REVISION_SUFFIX] [--service-account=SERVICE_ACCOUNT] - [--[no-]session-affinity] [--tag=TAG] [--timeout=TIMEOUT] - [--no-traffic] [--vpc-connector=VPC_CONNECTOR] - [--vpc-egress=VPC_EGRESS] + [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] + [--service-account=SERVICE_ACCOUNT] [--[no-]session-affinity] + [--tag=TAG] [--timeout=TIMEOUT] [--no-traffic] + [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] [--add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --clear-cloudsql-instances | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] @@ -215,6 +215,11 @@ FLAGS a revision named 'helloworld-v1'. Set empty string to clear the suffix and resume server-assigned naming. + --scaling=SCALING + The scaling mode to use for this resource. Flag value could be either + "auto" for automatic scaling, or a positive integer to configure manual + scaling with the given integer as a fixed instance count. + --service-account=SERVICE_ACCOUNT the email address of an IAM service account associated with the revision of the service. The service account represents the identity of diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index 4cf68e7f9..05809682e 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -13,10 +13,10 @@ SYNOPSIS [--max-instances=MAX_INSTANCES] [--mesh=MESH] [--min=MIN] [--min-instances=MIN_INSTANCES] [--region=REGION] [--remove-containers=[CONTAINER,...]] - [--revision-suffix=REVISION_SUFFIX] [--service-account=SERVICE_ACCOUNT] - [--[no-]session-affinity] [--tag=TAG] [--timeout=TIMEOUT] - [--no-traffic] [--vpc-connector=VPC_CONNECTOR] - [--vpc-egress=VPC_EGRESS] + [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] + [--service-account=SERVICE_ACCOUNT] [--[no-]session-affinity] + [--tag=TAG] [--timeout=TIMEOUT] [--no-traffic] + [--vpc-connector=VPC_CONNECTOR] [--vpc-egress=VPC_EGRESS] [--add-cloudsql-instances=[CLOUDSQL-INSTANCES,...] | --clear-cloudsql-instances | --remove-cloudsql-instances=[CLOUDSQL-INSTANCES,...] @@ -215,6 +215,11 @@ FLAGS a revision named 'helloworld-v1'. Set empty string to clear the suffix and resume server-assigned naming. + --scaling=SCALING + The scaling mode to use for this resource. Flag value could be either + "auto" for automatic scaling, or a positive integer to configure manual + scaling with the given integer as a fixed instance count. + --service-account=SERVICE_ACCOUNT the email address of an IAM service account associated with the revision of the service. The service account represents the identity of diff --git a/gcloud/beta/services/api-keys/create b/gcloud/beta/services/api-keys/create index 42a427b68..83dfc22fc 100644 --- a/gcloud/beta/services/api-keys/create +++ b/gcloud/beta/services/api-keys/create @@ -15,7 +15,7 @@ DESCRIPTION (BETA) Create an API key. EXAMPLES - To create a key with display name and allowed ips specified: + To create a key with display name and allowed IPs specified: $ gcloud beta services api-keys create --display-name="test name" \ --allowed-ips=2620:15c:2c4:203:2776:1f90:6b3b:217,104.133.8.78 @@ -24,7 +24,7 @@ EXAMPLES $ gcloud beta services api-keys create --annotations=foo=bar,abc=def - To create a key with user-specified key id: + To create a key with user-specified key ID: $ gcloud beta services api-keys create --key-id="my-key-id" @@ -34,29 +34,29 @@ EXAMPLES --allowed-referrers="https://www.example.com/*,http://sub.exampl\ e.com/*" - To create a key with allowed ios app bundle ids: + To create a key with allowed IOS app bundle IDs: $ gcloud beta services api-keys create --allowed-bundle-ids=my.app - To create a key with allowed android application: + To create a key with allowed Android application: $ gcloud beta services api-keys create \ --allowed-application=sha1_fingerprint=foo1,\ package_name=bar.foo \ --allowed-application=sha1_fingerprint=foo2,package_name=foo.bar - To create a key with allowed api targets (service name only): + To create a key with allowed API targets (service name only): $ gcloud beta services api-keys create \ --api-target=service=bar.service.com \ --api-target=service=foo.service.com - To create a keys with allowed api targets (service and methods are + To create a key with allowed API targets (service and methods are specified): $ gcloud beta services api-keys create --flags-file=my-flags.yaml - The content of 'my-flags.yaml' is as following: + The content of 'my-flags.yaml' is as follows: - --api-target: service: "foo.service.com" diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index fa7f6d972..d545db468 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -503,7 +503,7 @@ FLAGS --storage-type=STORAGE_TYPE The storage type for the instance. The default is SSD. STORAGE_TYPE - must be one of: SSD, HDD. + must be one of: SSD, HDD, HYPERDISK_BALANCED. --threads-per-core=THREADS_PER_CORE The number of threads per core. The value of this flag can be 1 or 2. diff --git a/gcloud/beta/sql/operations/list b/gcloud/beta/sql/operations/list index 30763c115..91d231399 100644 --- a/gcloud/beta/sql/operations/list +++ b/gcloud/beta/sql/operations/list @@ -3,7 +3,7 @@ NAME given Cloud SQL instance SYNOPSIS - gcloud beta sql operations list [--instance=INSTANCE, -i INSTANCE] + gcloud beta sql operations list --instance=INSTANCE, -i INSTANCE [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -26,7 +26,7 @@ EXAMPLES $ gcloud beta sql operations list --instance=prod-instance \ --page-size=10 -FLAGS +REQUIRED FLAGS --instance=INSTANCE, -i INSTANCE Cloud SQL instance ID. diff --git a/gcloud/beta/workstations/ssh b/gcloud/beta/workstations/ssh index 93ad9893f..075714d44 100644 --- a/gcloud/beta/workstations/ssh +++ b/gcloud/beta/workstations/ssh @@ -6,8 +6,8 @@ SYNOPSIS (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) [--command=COMMAND] [--local-host-port=LOCAL_HOST_PORT; default="localhost:0"] - [--port=PORT; default=22] [--user=USER; default="user"] - [GCLOUD_WIDE_FLAG ...] [-- SSH_ARGS ...] + [--port=PORT; default=22] [--ssh-flag=SSH_FLAG] + [--user=USER; default="user"] [GCLOUD_WIDE_FLAG ...] [-- SSH_ARGS ...] DESCRIPTION (BETA) SSH into a running workstation. @@ -104,6 +104,13 @@ FLAGS --port=PORT; default=22 The port on the workstation to which traffic should be sent. + --ssh-flag=SSH_FLAG + Additional flags to be passed to ssh(1). It is recommended that flags + be passed using an assignment operator and quotes. Example: + + $ gcloud beta workstations ssh --ssh-flag="-vvv" \ + --ssh-flag="-L 80:localhost:80" + --user=USER; default="user" The username with which to SSH. diff --git a/gcloud/compute/commitments/create b/gcloud/compute/commitments/create index 6aac066d4..bad6b47dc 100644 --- a/gcloud/compute/commitments/create +++ b/gcloud/compute/commitments/create @@ -103,14 +103,14 @@ OPTIONAL FLAGS Type of commitment. memory-optimized indicates that the commitment is for memory-optimized VMs. TYPE must be one of: accelerator-optimized, accelerator-optimized-a3, accelerator-optimized-a3-mega, - compute-optimized, compute-optimized-c2d, compute-optimized-c3, - compute-optimized-c3d, compute-optimized-h3, general-purpose, - general-purpose-c4, general-purpose-c4a, general-purpose-e2, - general-purpose-n2, general-purpose-n2d, general-purpose-n4, - general-purpose-t2d, graphics-optimized, memory-optimized, - memory-optimized-m3, memory-optimized-x4-16tb, - memory-optimized-x4-24tb, memory-optimized-x4-32tb, - storage-optimized-z3. + accelerator-optimized-a3-ultra, compute-optimized, + compute-optimized-c2d, compute-optimized-c3, compute-optimized-c3d, + compute-optimized-h3, general-purpose, general-purpose-c4, + general-purpose-c4a, general-purpose-e2, general-purpose-n2, + general-purpose-n2d, general-purpose-n4, general-purpose-t2d, + graphics-optimized, memory-optimized, memory-optimized-m3, + memory-optimized-x4-16tb, memory-optimized-x4-24tb, + memory-optimized-x4-32tb, storage-optimized-z3. Manage the reservations to be created with the commitment. diff --git a/gcloud/database-migration/migration-jobs/create b/gcloud/database-migration/migration-jobs/create index 61c84848c..d429b2958 100644 --- a/gcloud/database-migration/migration-jobs/create +++ b/gcloud/database-migration/migration-jobs/create @@ -7,9 +7,10 @@ SYNOPSIS (MIGRATION_JOB : --region=REGION) --destination=DESTINATION --source=SOURCE --type=TYPE [--no-async] [--commit-id=COMMIT_ID] [--conversion-workspace=CONVERSION_WORKSPACE] - [--databases-filter=databaseName,[...]] [--display-name=DISPLAY_NAME] + [--display-name=DISPLAY_NAME] [--dump-parallel-level=DUMP_PARALLEL_LEVEL] [--dump-path=DUMP_PATH] [--dump-type=DUMP_TYPE] [--filter=FILTER] [--labels=[KEY=VALUE,...]] + [--all-databases | --databases-filter=databaseName,[...]] [--cmek-key=CMEK_KEY : --cmek-keyring=CMEK_KEYRING --cmek-project=CMEK_PROJECT] [--peer-vpc=PEER_VPC | --static-ip @@ -187,14 +188,6 @@ OPTIONAL FLAGS To set the conversion_workspace attribute: ▸ provide the argument --conversion-workspace on the command line. - The migration job objects config. - - --databases-filter=databaseName,[...] - A list of databases to be migrated to the destination instance. - Provide databases as a comma separated list. This flag is used only - for Postgres to AlloyDB and SQL Server to Cloud SQL SQL Server - migrations. - --display-name=DISPLAY_NAME A user-friendly name for the migration job. The display name can include letters, numbers, spaces, and hyphens, and must start with a @@ -227,6 +220,21 @@ OPTIONAL FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + The migration job objects config. + + The migration job objects config for databases. + + At most one of these can be specified: + + --all-databases + Migrate all databases for the migration job. This flag is used only + for Postgres to AlloyDB migrations. + + --databases-filter=databaseName,[...] + A list of databases to be migrated to the destination instance. + Provide databases as a comma separated list. This flag is used only + for Postgres to AlloyDB migrations. + Cmek key resource - Name of the CMEK (customer-managed encryption key) used for the migration job The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not diff --git a/gcloud/database-migration/migration-jobs/update b/gcloud/database-migration/migration-jobs/update index 322c2f23e..737c91612 100644 --- a/gcloud/database-migration/migration-jobs/update +++ b/gcloud/database-migration/migration-jobs/update @@ -5,11 +5,11 @@ NAME SYNOPSIS gcloud database-migration migration-jobs update (MIGRATION_JOB : --region=REGION) [--no-async] [--commit-id=COMMIT_ID] - [--databases-filter=databaseName,[...]] [--destination=DESTINATION] - [--display-name=DISPLAY_NAME] + [--destination=DESTINATION] [--display-name=DISPLAY_NAME] [--dump-parallel-level=DUMP_PARALLEL_LEVEL] [--dump-path=DUMP_PATH] [--dump-type=DUMP_TYPE] [--filter=FILTER] [--source=SOURCE] [--type=TYPE] [--update-labels=[KEY=VALUE,...]] + [--all-databases | --databases-filter=databaseName,[...]] [--clear-labels | --remove-labels=[KEY,...]] [--peer-vpc=PEER_VPC | --static-ip | --vm=VM --vm-ip=VM_IP --vm-port=VM_PORT --vpc=VPC] @@ -76,14 +76,6 @@ FLAGS migration job. If not specified, the latest commit id will be used by default. - The migration job objects config. - - --databases-filter=databaseName,[...] - A list of databases to be migrated to the destination instance. - Provide databases as a comma separated list. This flag is used only - for Postgres to AlloyDB and SQL Server to Cloud SQL SQL Server - migrations. - Connection profile resource - ID of the destination connection profile, representing the destination database. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be @@ -166,6 +158,21 @@ FLAGS contain only hyphens (-), underscores (_), lowercase characters, and numbers. + The migration job objects config. + + The migration job objects config for databases. + + At most one of these can be specified: + + --all-databases + Migrate all databases for the migration job. This flag is used only + for Postgres to AlloyDB migrations. + + --databases-filter=databaseName,[...] + A list of databases to be migrated to the destination instance. + Provide databases as a comma separated list. This flag is used only + for Postgres to AlloyDB migrations. + At most one of these can be specified: --clear-labels diff --git a/gcloud/developer-connect/connections/create b/gcloud/developer-connect/connections/create index 0deb220a7..1c2438454 100644 --- a/gcloud/developer-connect/connections/create +++ b/gcloud/developer-connect/connections/create @@ -6,8 +6,7 @@ SYNOPSIS [--annotations=[ANNOTATIONS,...]] [--async] [--disabled] [--etag=ETAG] [--labels=[LABELS,...]] [--location=LOCATION] [--namespace=NAMESPACE] [--request-id=REQUEST_ID] [--secret=SECRET] [--validate-only] - [[--github-config-app=GITHUB_CONFIG_APP - : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] | [--github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI : --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION] | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION | [--gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-webhook-secret-version=GITLAB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION : --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE]] + [--bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-webhook-secret-version=BITBUCKET_CLOUD_CONFIG_WEBHOOK_SECRET_VERSION --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE | [--bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-webhook-secret-version=BITBUCKET_DATA_CENTER_CONFIG_WEBHOOK_SECRET_VERSION : --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE] | [--github-config-app=GITHUB_CONFIG_APP : --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION] | [--github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI : --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION] | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-webhook-secret-version=GITLAB_CONFIG_WEBHOOK_SECRET_VERSION | [--gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-webhook-secret-version=GITLAB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION : --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE]] [(--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE : --key-ring=KEY_RING)] [GCLOUD_WIDE_FLAG ...] @@ -146,6 +145,259 @@ FLAGS At most one of these can be specified: + Configuration for connections to an instance of Bitbucket Cloud. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line. + + SecretVersion resource - SecretManager resource containing the webhook + secret used to verify webhook events, formatted as + projects/*/secrets/*/versions/*. This is used to validate and create + webhooks. 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 + --bitbucket-cloud-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument + --bitbucket-cloud-config-webhook-secret-version on the command line + with a fully specified name; + ▫ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-cloud-config-webhook-secret-version=BITBUCKET_CLOUD_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --bitbucket-cloud-config-webhook-secret-version on the command + line. + + --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE + The Bitbucket Cloud Workspace ID to be connected to Google Cloud + Platform. + + Configuration for connections to an instance of Bitbucket Data Center. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line. + + --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI + The URI of the Bitbucket Data Center host this connection is for. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + This must be specified. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line. + + SecretVersion resource - SecretManager resource containing the webhook + secret used to verify webhook events, formatted as + projects/*/secrets/*/versions/*. This is used to validate webhooks. + 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 + --bitbucket-data-center-config-webhook-secret-version 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 secret attribute: + ▫ provide the argument + --bitbucket-data-center-config-webhook-secret-version on the + command line with a fully specified name; + ▫ provide the argument --secret on the command line. + + This must be specified. + + --bitbucket-data-center-config-webhook-secret-version=BITBUCKET_DATA_CENTER_CONFIG_WEBHOOK_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ◇ provide the argument + --bitbucket-data-center-config-webhook-secret-version on the + command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + Service resource - The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + 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 + --bitbucket-data-center-config-service-directory 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 + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --location on the command line. + + To set the namespace attribute: + ◇ provide the argument + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --namespace on the command line. + + This must be specified. + + --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY + ID of the service or fully qualified identifier for the + service. + + To set the service attribute: + ▹ provide the argument + --bitbucket-data-center-config-service-directory on the + command line. + + --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE + SSL certificate authority to trust when making requests to + Bitbucket Data Center. + Configuration for connections to github.com. --github-config-app=GITHUB_CONFIG_APP diff --git a/gcloud/developer-connect/connections/update b/gcloud/developer-connect/connections/update index 5cd00ccf5..aab84d1ae 100644 --- a/gcloud/developer-connect/connections/update +++ b/gcloud/developer-connect/connections/update @@ -10,8 +10,7 @@ SYNOPSIS [--annotations=[ANNOTATIONS,...] | --update-annotations=[UPDATE_ANNOTATIONS,...] --clear-annotations | --remove-annotations=[__REMOVE_ANNOTATIONS,...]] - [--github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID - --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION | --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --clear-github-enterprise-config-private-key-secret-version | --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --clear-github-enterprise-config-webhook-secret-version | --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION | --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE] + [--bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE | --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE | --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID --github-config-authorizer-credential-oauth-token-secret-version=GITHUB_CONFIG_AUTHORIZER_CREDENTIAL_OAUTH_TOKEN_SECRET_VERSION | --github-enterprise-config-app-id=GITHUB_ENTERPRISE_CONFIG_APP_ID --github-enterprise-config-app-installation-id=GITHUB_ENTERPRISE_CONFIG_APP_INSTALLATION_ID --github-enterprise-config-host-uri=GITHUB_ENTERPRISE_CONFIG_HOST_URI --github-enterprise-config-service-directory=GITHUB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --github-enterprise-config-ssl-ca-certificate=GITHUB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE --clear-github-enterprise-config-private-key-secret-version | --github-enterprise-config-private-key-secret-version=GITHUB_ENTERPRISE_CONFIG_PRIVATE_KEY_SECRET_VERSION --clear-github-enterprise-config-webhook-secret-version | --github-enterprise-config-webhook-secret-version=GITHUB_ENTERPRISE_CONFIG_WEBHOOK_SECRET_VERSION | --gitlab-config-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-config-read-authorizer-credential-user-token-secret-version=GITLAB_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION | --gitlab-enterprise-config-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-host-uri=GITLAB_ENTERPRISE_CONFIG_HOST_URI --gitlab-enterprise-config-read-authorizer-credential-user-token-secret-version=GITLAB_ENTERPRISE_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION --gitlab-enterprise-config-service-directory=GITLAB_ENTERPRISE_CONFIG_SERVICE_DIRECTORY --gitlab-enterprise-config-ssl-ca-certificate=GITLAB_ENTERPRISE_CONFIG_SSL_CA_CERTIFICATE] [--crypto-key-config-reference=CRYPTO_KEY_CONFIG_REFERENCE : --key-ring=KEY_RING] [--labels=[LABELS,...] @@ -173,6 +172,181 @@ FLAGS At most one of these can be specified: + Configuration for connections to an instance of Bitbucket Cloud. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-authorizer-credential-user-token-secret-version + on the command line. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_CLOUD_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-cloud-config-read-authorizer-credential-user-token-secret-version + on the command line. + + --bitbucket-cloud-config-workspace=BITBUCKET_CLOUD_CONFIG_WORKSPACE + The Bitbucket Cloud Workspace ID to be connected to Google Cloud + Platform. + + Configuration for connections to an instance of Bitbucket Data Center. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-authorizer-credential-user-token-secret-version + on the command line. + + --bitbucket-data-center-config-host-uri=BITBUCKET_DATA_CENTER_CONFIG_HOST_URI + The URI of the Bitbucket Data Center host this connection is for. + + Represents a personal access token that authorized the Connection, and + associated metadata. + + SecretVersion resource - A SecretManager resource containing the + user token that authorizes the Developer Connect connection. Format: + projects/*/secrets/*/versions/*. 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 + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + 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 secret attribute: + ◇ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line with a fully specified name; + ◇ provide the argument --secret on the command line. + + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version=BITBUCKET_DATA_CENTER_CONFIG_READ_AUTHORIZER_CREDENTIAL_USER_TOKEN_SECRET_VERSION + ID of the secretVersion or fully qualified identifier for the + secretVersion. + + To set the secret-version attribute: + ▹ provide the argument + --bitbucket-data-center-config-read-authorizer-credential-user-token-secret-version + on the command line. + + ServiceDirectoryConfig represents Service Directory configuration for + a connection. + + Service resource - The Service Directory service name. Format: + projects/{project}/locations/{location}/namespaces/{namespace}/services/{service}. + 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 + --bitbucket-data-center-config-service-directory 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 + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --location on the command line. + + To set the namespace attribute: + ◇ provide the argument + --bitbucket-data-center-config-service-directory on the command + line with a fully specified name; + ◇ provide the argument --namespace on the command line. + + --bitbucket-data-center-config-service-directory=BITBUCKET_DATA_CENTER_CONFIG_SERVICE_DIRECTORY + ID of the service or fully qualified identifier for the + service. + + To set the service attribute: + ▹ provide the argument + --bitbucket-data-center-config-service-directory on the + command line. + + --bitbucket-data-center-config-ssl-ca-certificate=BITBUCKET_DATA_CENTER_CONFIG_SSL_CA_CERTIFICATE + SSL certificate authority to trust when making requests to + Bitbucket Data Center. + Configuration for connections to github.com. --github-config-app-installation-id=GITHUB_CONFIG_APP_INSTALLATION_ID diff --git a/gcloud/netapp/volumes/help b/gcloud/netapp/volumes/help index 6584e340d..7e366dae6 100644 --- a/gcloud/netapp/volumes/help +++ b/gcloud/netapp/volumes/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + quota-rules + Create and manage Cloud NetApp Volume QuotaRules. + replications Create and manage Cloud NetApp Volume Replications. diff --git a/gcloud/netapp/volumes/quota-rules/create b/gcloud/netapp/volumes/quota-rules/create new file mode 100644 index 000000000..19d9f0ca2 --- /dev/null +++ b/gcloud/netapp/volumes/quota-rules/create @@ -0,0 +1,143 @@ +NAME + gcloud netapp volumes quota-rules create - create a Cloud NetApp Volume + Quota Rule + +SYNOPSIS + gcloud netapp volumes quota-rules create (QUOTA_RULE : --location=LOCATION) + --disk-limit-mib=DISK_LIMIT_MIB --type=TYPE [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--target=TARGET] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a Cloud NetApp Volume Quota Rule. + +EXAMPLES + The following command creates a default user Quota Rule named NAME using + the required arguments: + + $ gcloud netapp volumes quota-rules create NAME \ + --location=us-central1 --volume=vol1 --type=DEFAULT_USER_QUOTA \ + --disk-limit-mib=200 + + The following command creates a default group Quota Rule named NAME using + the required arguments: + + $ gcloud netapp volumes quota-rules create NAME \ + --location=us-central1 --volume=vol1 \ + --type=DEFAULT_GROUP_QUOTA --disk-limit-mib=200 + + The following command creates an individual user Quota Rule named NAME for + user with UID '100' using the required arguments: + + $ gcloud netapp volumes quota-rules create NAME \ + --location=us-central1 --volume=vol1 \ + --type=INDIVIDUAL_USER_QUOTA --target=100 --disk-limit-mib=200 + + The following command creates an individual group Quota Rule named NAME for + group with GID '1001' using the required arguments: + + $ gcloud netapp volumes quota-rules create NAME \ + --location=us-central1 --volume=vol1 \ + --type=INDIVIDUAL_GROUP_QUOTA --target=1001 --disk-limit-mib=200 + +POSITIONAL ARGUMENTS + Quota rule resource - The Quota rule 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 quota_rule 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 volume attribute: + ◆ provide the argument quota_rule on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + QUOTA_RULE + ID of the quota_rule or fully qualified identifier for the + quota_rule. + + To set the quota_rule attribute: + ▸ provide the argument quota_rule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the quota_rule. + + To set the location attribute: + ▸ provide the argument quota_rule on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +REQUIRED FLAGS + --disk-limit-mib=DISK_LIMIT_MIB + The disk limit in MiB for the quota rule. + + --type=TYPE + String indicating the type of quota rule. The supported values are: + 'DEFAULT_USER_QUOTA','DEFAULT_GROUP_QUOTA','INDIVIDUAL_USER_QUOTA','INDIVIDUAL_GROUP_QUOTA' + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Quota rule + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --target=TARGET + The target of the quota rule. Identified by a Unix UID/GID, Windows + SID, or null for default. + + Volume resource - The volume for which quota rule applies. 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp volumes quota-rules create + diff --git a/gcloud/netapp/volumes/quota-rules/delete b/gcloud/netapp/volumes/quota-rules/delete new file mode 100644 index 000000000..1bb51908a --- /dev/null +++ b/gcloud/netapp/volumes/quota-rules/delete @@ -0,0 +1,101 @@ +NAME + gcloud netapp volumes quota-rules delete - delete a Cloud NetApp Volume + QuotaRule + +SYNOPSIS + gcloud netapp volumes quota-rules delete (QUOTA_RULE : --location=LOCATION) + [--async] [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a Cloud NetApp Volume QuotaRule. + +EXAMPLES + The following command deletes a QuotaRule named NAME using the required + arguments: + + $ gcloud netapp volumes quota-rules delete NAME \ + --location=us-central1 --volume=vol1 + + To delete a QuotaRule named NAME asynchronously, run the following command: + + $ gcloud netapp volumes quota-rules delete NAME \ + --location=us-central1 --volume=vol1 --async + +POSITIONAL ARGUMENTS + Quota rule resource - The Quota Rule 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 quota_rule 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 volume attribute: + ◆ provide the argument quota_rule on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + QUOTA_RULE + ID of the quota_rule or fully qualified identifier for the + quota_rule. + + To set the quota_rule attribute: + ▸ provide the argument quota_rule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the quota_rule. + + To set the location attribute: + ▸ provide the argument quota_rule on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + Volume resource - The volume for which quota rule applies. 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp volumes quota-rules delete + diff --git a/gcloud/netapp/volumes/quota-rules/describe b/gcloud/netapp/volumes/quota-rules/describe new file mode 100644 index 000000000..60f171f19 --- /dev/null +++ b/gcloud/netapp/volumes/quota-rules/describe @@ -0,0 +1,93 @@ +NAME + gcloud netapp volumes quota-rules describe - describe a Cloud NetApp Volume + Quota Rule + +SYNOPSIS + gcloud netapp volumes quota-rules describe + (QUOTA_RULE : --location=LOCATION) [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a Cloud NetApp Volume Quota Rule. + +EXAMPLES + The following command describes a Quota Rule named NAME in the given + location and volume: + + $ gcloud netapp volumes quota-rules describe NAME \ + --location=us-central1 --volume=vol1 + +POSITIONAL ARGUMENTS + Quota rule resource - The Quota Rule 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 quota_rule 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 volume attribute: + ◆ provide the argument quota_rule on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + QUOTA_RULE + ID of the quota_rule or fully qualified identifier for the + quota_rule. + + To set the quota_rule attribute: + ▸ provide the argument quota_rule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the quota_rule. + + To set the location attribute: + ▸ provide the argument quota_rule on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + Volume resource - The volume for which quota rule applies. 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp volumes quota-rules describe + diff --git a/gcloud/netapp/volumes/quota-rules/help b/gcloud/netapp/volumes/quota-rules/help new file mode 100644 index 000000000..4d2a0fdd5 --- /dev/null +++ b/gcloud/netapp/volumes/quota-rules/help @@ -0,0 +1,38 @@ +NAME + gcloud netapp volumes quota-rules - create and manage Cloud NetApp Volume + QuotaRules + +SYNOPSIS + gcloud netapp volumes quota-rules COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create and manage Cloud NetApp Volume QuotaRules. + +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 Cloud NetApp Volume Quota Rule. + + delete + Delete a Cloud NetApp Volume QuotaRule. + + describe + Describe a Cloud NetApp Volume Quota Rule. + + list + List Cloud NetApp Volume QuotaRules. + + update + Update a Cloud NetApp Volume QuotaRule. + +NOTES + This variant is also available: + + $ gcloud beta netapp volumes quota-rules + diff --git a/gcloud/netapp/volumes/quota-rules/list b/gcloud/netapp/volumes/quota-rules/list new file mode 100644 index 000000000..9ecc994e6 --- /dev/null +++ b/gcloud/netapp/volumes/quota-rules/list @@ -0,0 +1,108 @@ +NAME + gcloud netapp volumes quota-rules list - list Cloud NetApp Volume + QuotaRules + +SYNOPSIS + gcloud netapp volumes quota-rules list [--location=LOCATION] + [--volume=VOLUME] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Lists Cloud NetApp Volume QuotaRules. + +EXAMPLES + The following command lists all QuotaRules in the given location and + volume: + + $ gcloud netapp volumes quota-rules list --location=us-central1 \ + --volume=vol1 + +FLAGS + Location resource - The location in which to list Volume QuotaRules. 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; + ◆ uses all locations by default. with a fully specified name; + ◆ set the property netapp/location 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; + ▸ uses all locations by default.; + ▸ set the property netapp/location. + + Volume resource - The volume for which quota rule applies. 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + +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 variant is also available: + + $ gcloud beta netapp volumes quota-rules list + diff --git a/gcloud/netapp/volumes/quota-rules/update b/gcloud/netapp/volumes/quota-rules/update new file mode 100644 index 000000000..2e5855208 --- /dev/null +++ b/gcloud/netapp/volumes/quota-rules/update @@ -0,0 +1,134 @@ +NAME + gcloud netapp volumes quota-rules update - update a Cloud NetApp Volume + QuotaRule + +SYNOPSIS + gcloud netapp volumes quota-rules update (QUOTA_RULE : --location=LOCATION) + [--async] [--description=DESCRIPTION] [--disk-limit-mib=DISK_LIMIT_MIB] + [--update-labels=[KEY=VALUE,...]] [--volume=VOLUME] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Cloud NetApp Volume QuotaRule and its specified parameters. + +EXAMPLES + The following command updates a QuotaRule named NAME and its specified + parameters: + + $ gcloud netapp volumes quota-rules update NAME \ + --location=us-central1 --description="new" \ + --disk-limit-mib=100 --update-labels=key2=val2 --volume=vol1 + +POSITIONAL ARGUMENTS + Quota rule resource - The Quota rule to update. 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 quota_rule 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 volume attribute: + ◆ provide the argument quota_rule on the command line with a fully + specified name; + ◆ provide the argument --volume on the command line. + + This must be specified. + + QUOTA_RULE + ID of the quota_rule or fully qualified identifier for the + quota_rule. + + To set the quota_rule attribute: + ▸ provide the argument quota_rule on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location of the quota_rule. + + To set the location attribute: + ▸ provide the argument quota_rule on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property netapp/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of the Cloud NetApp Quota rule + + --disk-limit-mib=DISK_LIMIT_MIB + The disk limit in MiB for the quota rule. + + --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. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + Volume resource - The volume for which quota rule applies. 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 --volume 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 --volume on the command line with a fully + specified name; + ◆ provide the argument --location on the command line; + ◆ set the property netapp/location. + + --volume=VOLUME + ID of the volume or fully qualified identifier for the volume. + + To set the volume attribute: + ▸ provide the argument --volume on the command line. + + 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 netapp volumes quota-rules update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud netapp volumes quota-rules 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. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This variant is also available: + + $ gcloud beta netapp volumes quota-rules update + diff --git a/gcloud/network-connectivity/hubs/groups/list b/gcloud/network-connectivity/hubs/groups/list index a16a7ebec..c286d0de8 100644 --- a/gcloud/network-connectivity/hubs/groups/list +++ b/gcloud/network-connectivity/hubs/groups/list @@ -2,7 +2,7 @@ NAME gcloud network-connectivity hubs groups list - list groups SYNOPSIS - gcloud network-connectivity hubs groups list --hub=HUB + gcloud network-connectivity hubs groups list [--hub=HUB] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -18,7 +18,7 @@ EXAMPLES $ gcloud network-connectivity hubs groups list --hub=my-hub -REQUIRED FLAGS +FLAGS Hub resource - Parent hub of the groups to display. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. @@ -26,16 +26,17 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --hub on the command line with a fully specified name; + ◆ if hub is empty, will use the wildcard '-' to indicate all hubs with + a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --hub=HUB ID of the hub or fully qualified identifier for the hub. To set the hub attribute: - ▸ provide the argument --hub on the command line. + ▸ provide the argument --hub on the command line; + ▸ if hub is empty, will use the wildcard '-' to indicate all hubs. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/network-connectivity/hubs/route-tables/list b/gcloud/network-connectivity/hubs/route-tables/list index 408b1506a..40e94884b 100644 --- a/gcloud/network-connectivity/hubs/route-tables/list +++ b/gcloud/network-connectivity/hubs/route-tables/list @@ -2,7 +2,7 @@ NAME gcloud network-connectivity hubs route-tables list - list route tables SYNOPSIS - gcloud network-connectivity hubs route-tables list --hub=HUB + gcloud network-connectivity hubs route-tables list [--hub=HUB] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -18,7 +18,7 @@ EXAMPLES $ gcloud network-connectivity hubs route-tables list --hub=my-hub -REQUIRED FLAGS +FLAGS Hub resource - Parent hub of the route tables to display. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. @@ -26,16 +26,17 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --hub on the command line with a fully specified name; + ◆ if hub is empty, will use the wildcard '-' to indicate all hubs with + a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - --hub=HUB ID of the hub or fully qualified identifier for the hub. To set the hub attribute: - ▸ provide the argument --hub on the command line. + ▸ provide the argument --hub on the command line; + ▸ if hub is empty, will use the wildcard '-' to indicate all hubs. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/network-connectivity/hubs/route-tables/routes/list b/gcloud/network-connectivity/hubs/route-tables/routes/list index 89fd187f0..9a82f8687 100644 --- a/gcloud/network-connectivity/hubs/route-tables/routes/list +++ b/gcloud/network-connectivity/hubs/route-tables/routes/list @@ -3,8 +3,8 @@ NAME SYNOPSIS gcloud network-connectivity hubs route-tables routes list - (--route_table=ROUTE_TABLE : --hub=HUB) - [--effective-location=EFFECTIVE_LOCATION] [--filter=EXPRESSION] + [--effective-location=EFFECTIVE_LOCATION] + [--hub=HUB --route_table=ROUTE_TABLE] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -29,7 +29,12 @@ EXAMPLES --hub=my-hub --route_table=my-route-table \ --effective-location=location -REQUIRED FLAGS +FLAGS + --effective-location=EFFECTIVE_LOCATION + The effective location/region to limit the list of routes. The + effective location must be a valid region name. To list valid region + names, use 'gcloud compute regions list'. + Route table resource - Parent route table of the routes to display. 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 @@ -38,34 +43,30 @@ REQUIRED FLAGS To set the project attribute: ◆ provide the argument --route_table on the command line with a fully specified name; + ◆ if route table is empty, will use wildcard '-' to list all route + tables with a fully specified name; ◆ provide the argument --project on the command line; ◆ set the property core/project. - This must be specified. - - --route_table=ROUTE_TABLE - ID of the route table or fully qualified identifier for the route - table. - - To set the route_table attribute: - ▸ provide the argument --route_table on the command line. - - This flag argument must be specified if any of the other arguments in - this group are specified. - --hub=HUB Id of the hub. To set the hub attribute: ▸ provide the argument --route_table on the command line with a fully specified name; - ▸ provide the argument --hub on the command line. + ▸ if route table is empty, will use wildcard '-' to list all route + tables with a fully specified name; + ▸ provide the argument --hub on the command line; + ▸ if hub is empty, will use the wildcard '-' to indicate all hubs. -FLAGS - --effective-location=EFFECTIVE_LOCATION - The effective location/region to limit the list of routes. The - effective location must be a valid region name. To list valid region - names, use 'gcloud compute regions list'. + --route_table=ROUTE_TABLE + ID of the route table or fully qualified identifier for the route + table. + + To set the route_table attribute: + ▸ provide the argument --route_table on the command line; + ▸ if route table is empty, will use wildcard '-' to list all route + tables . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/services/api-keys/create b/gcloud/services/api-keys/create index 105e5d652..e134efd9e 100644 --- a/gcloud/services/api-keys/create +++ b/gcloud/services/api-keys/create @@ -15,7 +15,7 @@ DESCRIPTION Create an API key. EXAMPLES - To create a key with display name and allowed ips specified: + To create a key with display name and allowed IPs specified: $ gcloud services api-keys create --display-name="test name" \ --allowed-ips=2620:15c:2c4:203:2776:1f90:6b3b:217,104.133.8.78 @@ -24,7 +24,7 @@ EXAMPLES $ gcloud services api-keys create --annotations=foo=bar,abc=def - To create a key with user-specified key id: + To create a key with user-specified key ID: $ gcloud services api-keys create --key-id="my-key-id" @@ -34,29 +34,29 @@ EXAMPLES --allowed-referrers="https://www.example.com/*,http://sub.exampl\ e.com/*" - To create a key with allowed ios app bundle ids: + To create a key with allowed IOS app bundle IDs: $ gcloud services api-keys create --allowed-bundle-ids=my.app - To create a key with allowed android application: + To create a key with allowed Android application: $ gcloud services api-keys create \ --allowed-application=sha1_fingerprint=foo1,\ package_name=bar.foo \ --allowed-application=sha1_fingerprint=foo2,package_name=foo.bar - To create a key with allowed api targets (service name only): + To create a key with allowed API targets (service name only): $ gcloud services api-keys create \ --api-target=service=bar.service.com \ --api-target=service=foo.service.com - To create a keys with allowed api targets (service and methods are + To create a key with allowed API targets (service and methods are specified): $ gcloud services api-keys create --flags-file=my-flags.yaml - The content of 'my-flags.yaml' is as following: + The content of 'my-flags.yaml' is as follows: - --api-target: service: "foo.service.com" diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index 3dfa4ea4d..be37ee85b 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -471,7 +471,7 @@ FLAGS --storage-type=STORAGE_TYPE The storage type for the instance. The default is SSD. STORAGE_TYPE - must be one of: SSD, HDD. + must be one of: SSD, HDD, HYPERDISK_BALANCED. --threads-per-core=THREADS_PER_CORE The number of threads per core. The value of this flag can be 1 or 2. diff --git a/gcloud/sql/operations/list b/gcloud/sql/operations/list index d31dab7b0..26c5fd28a 100644 --- a/gcloud/sql/operations/list +++ b/gcloud/sql/operations/list @@ -3,7 +3,7 @@ NAME Cloud SQL instance SYNOPSIS - gcloud sql operations list [--instance=INSTANCE, -i INSTANCE] + gcloud sql operations list --instance=INSTANCE, -i INSTANCE [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -25,7 +25,7 @@ EXAMPLES $ gcloud sql operations list --instance=prod-instance --page-size=10 -FLAGS +REQUIRED FLAGS --instance=INSTANCE, -i INSTANCE Cloud SQL instance ID. diff --git a/gcloud/storage/buckets/create b/gcloud/storage/buckets/create index 4ed6ebc81..8a8248133 100644 --- a/gcloud/storage/buckets/create +++ b/gcloud/storage/buckets/create @@ -9,7 +9,7 @@ SYNOPSIS [--default-storage-class=DEFAULT_STORAGE_CLASS, -c DEFAULT_STORAGE_CLASS, -s DEFAULT_STORAGE_CLASS] [--enable-hierarchical-namespace] [--enable-per-object-retention] - [--location=LOCATION, -l LOCATION] + [--lifecycle-file=LIFECYCLE_FILE] [--location=LOCATION, -l LOCATION] [--[no-]pap, --[no-]public-access-prevention] [--placement=[REGION,...]] [--recovery-point-objective=SETTING, --rpo=SETTING] @@ -65,6 +65,22 @@ FLAGS Enables each object in the bucket to have its own retention settings, which prevents deletion until stored for a specific length of time. + --lifecycle-file=LIFECYCLE_FILE + Sets the lifecycle management configuration on a bucket. For example, + The following lifecycle management configuration JSON document + specifies that all objects in this bucket that are more than 365 days + old are deleted automatically: + + { + "rule": + [ + { + "action": {"type": "Delete"}, + "condition": {"age": 365} + } + ] + } + --location=LOCATION, -l LOCATION Location (https://cloud.google.com/storage/docs/locations) for the bucket. If not specified, the location used by Cloud Storage is us. A diff --git a/gcloud/workstations/ssh b/gcloud/workstations/ssh index aeaca69a8..dc69db164 100644 --- a/gcloud/workstations/ssh +++ b/gcloud/workstations/ssh @@ -6,8 +6,8 @@ SYNOPSIS (WORKSTATION : --cluster=CLUSTER --config=CONFIG --region=REGION) [--command=COMMAND] [--local-host-port=LOCAL_HOST_PORT; default="localhost:0"] - [--port=PORT; default=22] [--user=USER; default="user"] - [GCLOUD_WIDE_FLAG ...] [-- SSH_ARGS ...] + [--port=PORT; default=22] [--ssh-flag=SSH_FLAG] + [--user=USER; default="user"] [GCLOUD_WIDE_FLAG ...] [-- SSH_ARGS ...] DESCRIPTION SSH into a running workstation. @@ -104,6 +104,13 @@ FLAGS --port=PORT; default=22 The port on the workstation to which traffic should be sent. + --ssh-flag=SSH_FLAG + Additional flags to be passed to ssh(1). It is recommended that flags + be passed using an assignment operator and quotes. Example: + + $ gcloud workstations ssh --ssh-flag="-vvv" \ + --ssh-flag="-L 80:localhost:80" + --user=USER; default="user" The username with which to SSH.