diff --git a/gcloud/_version b/gcloud/_version index d7bb8576f..c4f773474 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,6 +1,6 @@ -Google Cloud SDK 378.0.0 -alpha 2022.03.18 -beta 2022.03.18 +Google Cloud SDK 379.0.0 +alpha 2022.03.25 +beta 2022.03.25 bq 2.0.74 -core 2022.03.18 +core 2022.03.25 gsutil 5.8 diff --git a/gcloud/alpha/artifacts/apt/help b/gcloud/alpha/artifacts/apt/help index 598e10d52..48462d787 100644 --- a/gcloud/alpha/artifacts/apt/help +++ b/gcloud/alpha/artifacts/apt/help @@ -25,7 +25,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud artifacts apt $ gcloud beta artifacts apt diff --git a/gcloud/alpha/artifacts/apt/import b/gcloud/alpha/artifacts/apt/import index 91f94d21d..52299db90 100644 --- a/gcloud/alpha/artifacts/apt/import +++ b/gcloud/alpha/artifacts/apt/import @@ -64,8 +64,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --gcs-source=[GCS_SOURCE,...] - The Google Cloud Storage location of a package to import. Wildcards may - be added at the end to import multiple packages. + The Google Cloud Storage location of a package to import. To import + multiple packages, use wildcards at the end of the path. OPTIONAL FLAGS --async @@ -84,7 +84,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud artifacts apt import $ gcloud beta artifacts apt import diff --git a/gcloud/alpha/artifacts/apt/upload b/gcloud/alpha/artifacts/apt/upload index 1a4ba52bc..78f534a18 100644 --- a/gcloud/alpha/artifacts/apt/upload +++ b/gcloud/alpha/artifacts/apt/upload @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud artifacts apt upload $ gcloud beta artifacts apt upload diff --git a/gcloud/alpha/artifacts/yum/help b/gcloud/alpha/artifacts/yum/help index 14ae0366c..083e361be 100644 --- a/gcloud/alpha/artifacts/yum/help +++ b/gcloud/alpha/artifacts/yum/help @@ -25,7 +25,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud artifacts yum $ gcloud beta artifacts yum diff --git a/gcloud/alpha/artifacts/yum/import b/gcloud/alpha/artifacts/yum/import index d7c33da4e..34f082c8e 100644 --- a/gcloud/alpha/artifacts/yum/import +++ b/gcloud/alpha/artifacts/yum/import @@ -64,8 +64,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --gcs-source=[GCS_SOURCE,...] - The Google Cloud Storage location of a package to import. Wildcards may - be added at the end to import multiple packages. + The Google Cloud Storage location of a package to import. To import + multiple packages, use wildcards at the end of the path. OPTIONAL FLAGS --async @@ -84,7 +84,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud artifacts yum import $ gcloud beta artifacts yum import diff --git a/gcloud/alpha/artifacts/yum/upload b/gcloud/alpha/artifacts/yum/upload index 82d7525cc..1415422b8 100644 --- a/gcloud/alpha/artifacts/yum/upload +++ b/gcloud/alpha/artifacts/yum/upload @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud artifacts yum upload $ gcloud beta artifacts yum upload diff --git a/gcloud/alpha/compute/firewall-rules/help b/gcloud/alpha/compute/firewall-rules/help index 654bf08b3..bae2ea843 100644 --- a/gcloud/alpha/compute/firewall-rules/help +++ b/gcloud/alpha/compute/firewall-rules/help @@ -40,6 +40,10 @@ COMMANDS list (ALPHA) List Compute Engine firewall rules. + migrate + (ALPHA) Create a new Network Firewall Policy and move all customer + defined firewall rules there. + update (ALPHA) Update a firewall rule. diff --git a/gcloud/alpha/compute/firewall-rules/migrate b/gcloud/alpha/compute/firewall-rules/migrate new file mode 100644 index 000000000..2ae28ee27 --- /dev/null +++ b/gcloud/alpha/compute/firewall-rules/migrate @@ -0,0 +1,44 @@ +NAME + gcloud alpha compute firewall-rules migrate - create a new Network Firewall + Policy and move all customer defined firewall rules there + +SYNOPSIS + gcloud alpha compute firewall-rules migrate FIREWALL_POLICY + --network=NETWORK [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute firewall-rules migrate is used to create a new + Network Firewall Policy that contain all rules defined in already existing + Network Firewall Policy associated with the given VPC Network and all + customer defined VPC Firewall Rules attached to that VPC Network. + +EXAMPLES + To execute the migration for VPC Network 'my-network' which stores the + result in 'my-policy' Network Firewall Policy, run: + + $ gcloud alpha compute firewall-rules migrate my-policy \ + --network=my-network + +POSITIONAL ARGUMENTS + FIREWALL_POLICY + Name of the new Network Firewall Policy used to store the migration + result. + +REQUIRED FLAGS + --network=NETWORK + The VPC Network for which the migration should be performed. + +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/instance-templates/create b/gcloud/alpha/compute/instance-templates/create index 93d22f38c..8bafb2c4d 100644 --- a/gcloud/alpha/compute/instance-templates/create +++ b/gcloud/alpha/compute/instance-templates/create @@ -441,8 +441,8 @@ FLAGS --max-run-duration=MAX_RUN_DURATION Limits how long this VM instance can run, specified as a duration relative to the VM instance's most-recent start time. Format the - duration, MAX_RUN_DURATION, similar to "T1h2m3s" where you can specify - the number of hours, minutes, and seconds using "h", "m", and "s" + duration, MAX_RUN_DURATION, similar to T1h2m3s where you can specify + the number of hours, minutes, and seconds using h, m, and s respectively. Alternatively, to specify a timestamp, use --termination-time instead. @@ -775,7 +775,7 @@ FLAGS specify a duration, use --max-run-duration instead. If neither --termination-time nor --max-run-duration is specified - (default) the VM instance runs until prompted by a user action or + (default), the VM instance runs until prompted by a user action or system event. If either is specified, the VM instance will be terminated using the action specified by --instance-termination-action. For --termination-time, the VM instance is terminated only during the diff --git a/gcloud/alpha/compute/instances/bulk/create b/gcloud/alpha/compute/instances/bulk/create index e2f515e24..4cac7d6d1 100644 --- a/gcloud/alpha/compute/instances/bulk/create +++ b/gcloud/alpha/compute/instances/bulk/create @@ -462,8 +462,8 @@ OPTIONAL FLAGS --max-run-duration=MAX_RUN_DURATION Limits how long this VM instance can run, specified as a duration relative to the VM instance's most-recent start time. Format the - duration, MAX_RUN_DURATION, similar to "T1h2m3s" where you can specify - the number of hours, minutes, and seconds using "h", "m", and "s" + duration, MAX_RUN_DURATION, similar to T1h2m3s where you can specify + the number of hours, minutes, and seconds using h, m, and s respectively. Alternatively, to specify a timestamp, use --termination-time instead. @@ -562,6 +562,10 @@ OPTIONAL FLAGS key is also specified this must be a subnetwork of the specified network. + nic-type + Specifies the Network Interface Controller (NIC) type for the + interface. NIC_TYPE must be one of: GVNIC, VIRTIO_NET. + --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The @@ -680,7 +684,7 @@ OPTIONAL FLAGS specify a duration, use --max-run-duration instead. If neither --termination-time nor --max-run-duration is specified - (default) the VM instance runs until prompted by a user action or + (default), the VM instance runs until prompted by a user action or system event. If either is specified, the VM instance will be terminated using the action specified by --instance-termination-action. For --termination-time, the VM instance is terminated only during the diff --git a/gcloud/alpha/compute/instances/create b/gcloud/alpha/compute/instances/create index 04333171d..5cbf2ac31 100644 --- a/gcloud/alpha/compute/instances/create +++ b/gcloud/alpha/compute/instances/create @@ -568,8 +568,8 @@ FLAGS --max-run-duration=MAX_RUN_DURATION Limits how long this VM instance can run, specified as a duration relative to the VM instance's most-recent start time. Format the - duration, MAX_RUN_DURATION, similar to "T1h2m3s" where you can specify - the number of hours, minutes, and seconds using "h", "m", and "s" + duration, MAX_RUN_DURATION, similar to T1h2m3s where you can specify + the number of hours, minutes, and seconds using h, m, and s respectively. Alternatively, to specify a timestamp, use --termination-time instead. @@ -817,7 +817,7 @@ FLAGS specify a duration, use --max-run-duration instead. If neither --termination-time nor --max-run-duration is specified - (default) the VM instance runs until prompted by a user action or + (default), the VM instance runs until prompted by a user action or system event. If either is specified, the VM instance will be terminated using the action specified by --instance-termination-action. For --termination-time, the VM instance is terminated only during the diff --git a/gcloud/alpha/compute/networks/update b/gcloud/alpha/compute/networks/update index 241fda484..3c7739500 100644 --- a/gcloud/alpha/compute/networks/update +++ b/gcloud/alpha/compute/networks/update @@ -2,7 +2,9 @@ NAME gcloud alpha compute networks update - update a Compute Engine network SYNOPSIS - gcloud alpha compute networks update NAME [--async] [--mtu=MTU] + gcloud alpha compute networks update NAME [--async] + [--[no-]enable-ula-internal-ipv6] + [--internal-ipv6-range=INTERNAL_IPV6_RANGE] [--mtu=MTU] [--bgp-routing-mode=MODE | --switch-to-custom-subnet-mode] [GCLOUD_WIDE_FLAG ...] @@ -19,6 +21,21 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --[no-]enable-ula-internal-ipv6 + Enable/disable ULA internal IPv6 on this network. Enabling this feature + will assign a /48 from google defined ULA prefix fd20::/20. + + Use --enable-ula-internal-ipv6 to enable and + --no-enable-ula-internal-ipv6 to disable. + + --internal-ipv6-range=INTERNAL_IPV6_RANGE + When enabling ULA internal IPv6, caller can optionally specify the /48 + range they want from the google defined ULA prefix fd20::/20. + ULA_IPV6_RANGE must be a valid /48 ULA IPv6 address and within the + fd20::/20. Operation will fail if the speficied /48 is already in used + by another resource. If the field is not speficied, then a /48 range + will be randomly allocated from fd20::/20 and returned via this field. + --mtu=MTU Maximum transmission unit (MTU) is the size of the largest IP packet that can be transmitted on this network. Default value is 1460 bytes, diff --git a/gcloud/alpha/container/aws/clusters/create b/gcloud/alpha/container/aws/clusters/create index c4dd628b0..9bd62bc3b 100644 --- a/gcloud/alpha/container/aws/clusters/create +++ b/gcloud/alpha/container/aws/clusters/create @@ -13,7 +13,9 @@ SYNOPSIS --service-address-cidr-blocks=SERVICE_ADDRESS_CIDR_BLOCKS --subnet-ids=[SUBNET_ID,...] --vpc-id=VPC_ID [--admin-users=USER,[USER,...]] [--async] - [--instance-type=INSTANCE_TYPE] [--main-volume-iops=MAIN_VOLUME_IOPS] + [--instance-placement=INSTANCE_PLACEMENT] + [--instance-type=INSTANCE_TYPE] [--logging=COMPONENT,[COMPONENT,...]] + [--main-volume-iops=MAIN_VOLUME_IOPS] [--main-volume-kms-key-arn=MAIN_VOLUME_KMS_KEY_ARN] [--main-volume-size=MAIN_VOLUME_SIZE] [--main-volume-type=MAIN_VOLUME_TYPE] @@ -120,9 +122,24 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --instance-placement=INSTANCE_PLACEMENT + Type of the tenancy. INSTANCE_PLACEMENT must be one of: dedicated, + default, host. + --instance-type=INSTANCE_TYPE AWS EC2 instance type. + --logging=COMPONENT,[COMPONENT,...] + Set the components that have logging enabled. + + Examples: + + $ gcloud alpha container aws clusters create --logging=SYSTEM + $ gcloud alpha container aws clusters create \ + --logging=SYSTEM,WORKLOAD + + COMPONENT must be one of: SYSTEM, WORKLOAD. + --main-volume-iops=MAIN_VOLUME_IOPS Number of I/O operations per second (IOPS) to provision for the main volume. diff --git a/gcloud/alpha/container/aws/node-pools/create b/gcloud/alpha/container/aws/node-pools/create index 6325eed50..91fe40070 100644 --- a/gcloud/alpha/container/aws/node-pools/create +++ b/gcloud/alpha/container/aws/node-pools/create @@ -7,8 +7,9 @@ SYNOPSIS (NODE_POOL : --cluster=CLUSTER --location=LOCATION) --config-encryption-kms-key-arn=CONFIG_ENCRYPTION_KMS_KEY_ARN --iam-instance-profile=IAM_INSTANCE_PROFILE --node-version=NODE_VERSION - --subnet-id=SUBNET_ID [--async] [--instance-type=INSTANCE_TYPE] - [--max-pods-per-node=MAX_PODS_PER_NODE] + --subnet-id=SUBNET_ID [--async] [--image-type=IMAGE_TYPE] + [--instance-placement=INSTANCE_PLACEMENT] + [--instance-type=INSTANCE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] [--node-labels=NODE_LABEL,[NODE_LABEL,...]] [--node-taints=NODE_TAINT,[NODE_TAINT,...]] [--root-volume-iops=ROOT_VOLUME_IOPS] @@ -87,6 +88,18 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. + --image-type=IMAGE_TYPE + Set the OS image type to use on node pool instances. + + Examples: + + $ gcloud alpha container aws node-pools create --image-type=windows + $ gcloud alpha container aws node-pools create --image-type=ubuntu + + --instance-placement=INSTANCE_PLACEMENT + Type of the tenancy. INSTANCE_PLACEMENT must be one of: dedicated, + default, host. + --instance-type=INSTANCE_TYPE AWS EC2 instance type. diff --git a/gcloud/alpha/container/azure/clusters/create b/gcloud/alpha/container/azure/clusters/create index f64b07571..419fa9a7a 100644 --- a/gcloud/alpha/container/azure/clusters/create +++ b/gcloud/alpha/container/azure/clusters/create @@ -16,6 +16,7 @@ SYNOPSIS [--config-encryption-public-key=CONFIG_ENCRYPTION_PUBLIC_KEY] [--database-encryption-key-id=DATABASE_ENCRYPTION_KEY_ID] [--endpoint-subnet-id=ENDPOINT_SUBNET_ID] + [--logging=COMPONENT,[COMPONENT,...]] [--main-volume-size=MAIN_VOLUME_SIZE] [--replica-placements=[REPLICA_PLACEMENT,...]] [--root-volume-size=ROOT_VOLUME_SIZE] @@ -141,6 +142,17 @@ OPTIONAL FLAGS ARM ID of the subnet where the control plane load balancer is deployed. When unspecified, it defaults to the control plane subnet ID. + --logging=COMPONENT,[COMPONENT,...] + Set the components that have logging enabled. + + Examples: + + $ gcloud alpha container azure clusters create --logging=SYSTEM + $ gcloud alpha container azure clusters create \ + --logging=SYSTEM,WORKLOAD + + COMPONENT must be one of: SYSTEM, WORKLOAD. + --main-volume-size=MAIN_VOLUME_SIZE Size of the main volume. The value must be a whole number followed by a size unit of GB for gigabyte, or TB for terabyte. If no size unit is diff --git a/gcloud/alpha/container/azure/node-pools/create b/gcloud/alpha/container/azure/node-pools/create index 6c846e6e7..69749ed5a 100644 --- a/gcloud/alpha/container/azure/node-pools/create +++ b/gcloud/alpha/container/azure/node-pools/create @@ -10,7 +10,7 @@ SYNOPSIS [--azure-availability-zone=AZURE_AVAILABILITY_ZONE] [--config-encryption-key-id=CONFIG_ENCRYPTION_KEY_ID] [--config-encryption-public-key=CONFIG_ENCRYPTION_PUBLIC_KEY] - [--max-pods-per-node=MAX_PODS_PER_NODE] + [--image-type=IMAGE_TYPE] [--max-pods-per-node=MAX_PODS_PER_NODE] [--node-labels=NODE_LABEL,[NODE_LABEL,...]] [--node-taints=NODE_TAINT,[NODE_TAINT,...]] [--root-volume-size=ROOT_VOLUME_SIZE] [--tags=TAG,[TAG,...]] @@ -92,6 +92,14 @@ OPTIONAL FLAGS RSA key of the Azure Key Vault public key to use for encrypting config data. + --image-type=IMAGE_TYPE + Set the OS image type to use on node pool instances. + + Examples: + + $ gcloud alpha container azure node-pools create --image-type=windows + $ gcloud alpha container azure node-pools create --image-type=ubuntu + --max-pods-per-node=MAX_PODS_PER_NODE Maximum number of pods per node. diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index f3d961171..14e0290fb 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -1166,9 +1166,10 @@ FLAGS enableAutoRepair: A boolean field that indicates if node autorepair is enabled for autoprovisioned node pools. - minCpuPlatform: If specified, new autoprovisioned nodes will be - scheduled on host with specified CPU architecture or a newer one. - Note: Min CPU platform can only be specified in Beta and Alpha. + minCpuPlatform (deprecated): If specified, new autoprovisioned + nodes will be scheduled on host with specified CPU architecture or + a newer one. Note: Min CPU platform can only be specified in Beta + and Alpha. Autoprovisioned node image is specified under the 'imageType' field. If not specified the default value will be applied. @@ -1224,8 +1225,12 @@ FLAGS separated by commas. --autoprovisioning-min-cpu-platform=PLATFORM - If specified, new autoprovisioned nodes will be scheduled on host - with specified CPU architecture or a newer one. + (DEPRECATED) If specified, new autoprovisioned nodes will be + scheduled on host with specified CPU architecture or a newer one. + + The --autoprovisioning-min-cpu-platform flag is deprecated and + will be removed in an upcoming release. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#March_08_2022 --min-cpu=MIN_CPU Minimum number of cores in the cluster. diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index 5ec24b366..7d7e858c6 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -773,9 +773,10 @@ REQUIRED FLAGS enableAutoRepair: A boolean field that indicates if node autorepair is enabled for autoprovisioned node pools. - minCpuPlatform: If specified, new autoprovisioned nodes will be - scheduled on host with specified CPU architecture or a newer one. - Note: Min CPU platform can only be specified in Beta and Alpha. + minCpuPlatform (deprecated): If specified, new autoprovisioned + nodes will be scheduled on host with specified CPU architecture + or a newer one. Note: Min CPU platform can only be specified in + Beta and Alpha. Autoprovisioned node image is specified under the 'imageType' field. If not specified the default value will be applied. @@ -814,8 +815,13 @@ REQUIRED FLAGS separated by commas. --autoprovisioning-min-cpu-platform=PLATFORM - If specified, new autoprovisioned nodes will be scheduled on - host with specified CPU architecture or a newer one. + (DEPRECATED) If specified, new autoprovisioned nodes will be + scheduled on host with specified CPU architecture or a newer + one. + + The --autoprovisioning-min-cpu-platform flag is deprecated and + will be removed in an upcoming release. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#March_08_2022 --max-cpu=MAX_CPU Maximum number of cores in the cluster. diff --git a/gcloud/alpha/functions/deploy b/gcloud/alpha/functions/deploy index 84dc885c0..d870e49bc 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud alpha functions deploy (NAME : --region=REGION) - [--allow-unauthenticated] [--egress-settings=EGRESS_SETTINGS] - [--entry-point=ENTRY_POINT] [--gen2] [--ignore-file=IGNORE_FILE] + [--allow-unauthenticated] [--docker-registry=DOCKER_REGISTRY] + [--egress-settings=EGRESS_SETTINGS] [--entry-point=ENTRY_POINT] + [--gen2] [--ignore-file=IGNORE_FILE] [--ingress-settings=INGRESS_SETTINGS] [--memory=MEMORY] [--retry] [--run-service-account=RUN_SERVICE_ACCOUNT] [--runtime=RUNTIME] [--security-level=SECURITY_LEVEL; default="secure-always"] @@ -93,6 +94,16 @@ FLAGS If set, makes this a public function. This will allow all callers, without checking authentication. + --docker-registry=DOCKER_REGISTRY + Docker Registry to use for storing the function's Docker images. The + option container-registry is used by default. + + Warning: Artifact Registry and Container Registry have different image + storage costs. For more details, please see + https://cloud.google.com/functions/pricing#deployment_costs. + + DOCKER_REGISTRY must be one of: artifact-registry, container-registry. + --egress-settings=EGRESS_SETTINGS Egress settings controls what traffic is diverted through the VPC Access Connector resource. By default private-ranges-only will be used. diff --git a/gcloud/alpha/monitoring/help b/gcloud/alpha/monitoring/help index 3718a7889..57e0617c2 100644 --- a/gcloud/alpha/monitoring/help +++ b/gcloud/alpha/monitoring/help @@ -32,6 +32,9 @@ GROUPS dashboards (ALPHA) Manage Cloud Monitoring dashboards. + metrics-scopes + (ALPHA) Manage Cloud Monitoring Metrics Scopes. + policies (ALPHA) Manage Cloud Monitoring alerting policies. diff --git a/gcloud/alpha/monitoring/metrics-scopes/create b/gcloud/alpha/monitoring/metrics-scopes/create new file mode 100644 index 000000000..279b54b07 --- /dev/null +++ b/gcloud/alpha/monitoring/metrics-scopes/create @@ -0,0 +1,52 @@ +NAME + gcloud alpha monitoring metrics-scopes create - create a monitored project + in a metrics scope + +SYNOPSIS + gcloud alpha monitoring metrics-scopes create + MONITORED_PROJECT_ID_OR_NUMBER [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The projects specified do not exist. + ▪ The active account does not have permission to access one of the + given project. + ▪ The monitored project already exists in the metrics scope. + + More details can be found at + https://cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes.projects/create + +EXAMPLES + The following command adds a monitored project with the ID + monitored-project-1 to a metrics scope with project id metrics-scope-1 + assuming the metrics-scope-1 is the default project: + + $ gcloud alpha monitoring metrics-scopes create monitored-project-1 + + The following command adds a monitored project with the ID + monitored-project-1 to a metrics scope with project id metrics-scope-1: + + $ gcloud alpha monitoring metrics-scopes create \ + monitored-project-1 --project=metrics-scope-1 + $ gcloud alpha monitoring metrics-scopes create \ + locations/global/metricsScopes/metrics-scope-1/projects/\ + monitored-project-1 + +POSITIONAL ARGUMENTS + MONITORED_PROJECT_ID_OR_NUMBER + Monitored project ID or number for the project you want to create. + +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/monitoring/metrics-scopes/delete b/gcloud/alpha/monitoring/metrics-scopes/delete new file mode 100644 index 000000000..674be8ed4 --- /dev/null +++ b/gcloud/alpha/monitoring/metrics-scopes/delete @@ -0,0 +1,51 @@ +NAME + gcloud alpha monitoring metrics-scopes delete - delete a monitored project + in a metrics scope + +SYNOPSIS + gcloud alpha monitoring metrics-scopes delete + MONITORED_PROJECT_ID_OR_NUMBER [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The projects specified do not exist. + ▪ The active account does not have permission to access one of the + given project. + + More details can be found at + https://cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes.projects/delete + +EXAMPLES + The following command adds a monitored project with the ID + monitored-project-1 to a metrics scope with project id metrics-scope-1 + assuming the metrics-scope-1 is the default project: + + $ gcloud alpha monitoring metrics-scopes delete monitored-project-1 + + The following command adds a monitored project with the ID + monitored-project-1 to a metrics scope with project id metrics-scope-1: + + $ gcloud alpha monitoring metrics-scopes delete \ + monitored-project-1 --project=metrics-scope-1 + $ gcloud alpha monitoring metrics-scopes delete \ + locations/global/metricsScopes/metrics-scope-1/projects/\ + monitored-project-1 + +POSITIONAL ARGUMENTS + MONITORED_PROJECT_ID_OR_NUMBER + Monitored project ID or number for the project you want to delete. + +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/monitoring/metrics-scopes/describe b/gcloud/alpha/monitoring/metrics-scopes/describe new file mode 100644 index 000000000..9bd749431 --- /dev/null +++ b/gcloud/alpha/monitoring/metrics-scopes/describe @@ -0,0 +1,60 @@ +NAME + gcloud alpha monitoring metrics-scopes describe - describe a Cloud + Monitoring metrics scope + +SYNOPSIS + gcloud alpha monitoring metrics-scopes describe METRICS_SCOPE + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Cloud Monitoring metrics scope along with the list of + projects it is monitoring. + + More details can be found at + https://cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes/get + +EXAMPLES + To describe a metrics scope contained within a specific project, run: + + $ gcloud alpha monitoring metrics-scopes describe \ + MY-METRICS-SCOPE-PROJECT-ID + + To describe a metrics scope in JSON, run: + + $ gcloud alpha monitoring metrics-scopes describe \ + MY-METRICS-SCOPE-PROJECT-ID --format=json + + To describe a metrics scope with a fully qualified metrics scope ID, run: + + $ gcloud alpha monitoring metrics-scopes describe \ + locations/global/metricsScopes/MY-METRICS-SCOPE-PROJECT-ID + +POSITIONAL ARGUMENTS + Metrics scope resource - The metrics scope to describe. This represents a + Cloud resource. + + This must be specified. + + METRICS_SCOPE + ID of the metrics_scope or fully qualified identifier for the + metrics_scope. To set the metrics_scope attribute: + ▸ provide the argument metrics_scope on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the monitoring/v1 API. The full documentation for this + API can be found at: https://cloud.google.com/monitoring/api/ + +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/monitoring/metrics-scopes/help b/gcloud/alpha/monitoring/metrics-scopes/help new file mode 100644 index 000000000..4e003c8c3 --- /dev/null +++ b/gcloud/alpha/monitoring/metrics-scopes/help @@ -0,0 +1,40 @@ +NAME + gcloud alpha monitoring metrics-scopes - manage Cloud Monitoring Metrics + Scopes + +SYNOPSIS + gcloud alpha monitoring metrics-scopes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) The gcloud alpha monitoring metrics-scopes group lets you manage + Monitoring metrics scopes. + + More information on managing metrics scopes can be found here: + https://cloud.google.com/monitoring/settings/manage-api + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a monitored project in a metrics scope. + + delete + (ALPHA) Delete a monitored project in a metrics scope. + + describe + (ALPHA) Describe a Cloud Monitoring metrics scope. + + list + (ALPHA) List the metrics scopes monitoring the specified project. + +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/monitoring/metrics-scopes/list b/gcloud/alpha/monitoring/metrics-scopes/list new file mode 100644 index 000000000..a0c32f819 --- /dev/null +++ b/gcloud/alpha/monitoring/metrics-scopes/list @@ -0,0 +1,73 @@ +NAME + gcloud alpha monitoring metrics-scopes list - list the metrics scopes + monitoring the specified project + +SYNOPSIS + gcloud alpha monitoring metrics-scopes list PROJECT_ID_OR_NUMBER + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command can fail for the following reasons: + ▪ The projects specified do not exist. + ▪ The active account does not have permission to access one of the + given project. + + More details can be found at + https://cloud.google.com/monitoring/api/ref_v3/rest/v1/locations.global.metricsScopes/listMetricsScopesByMonitoredProject + +EXAMPLES + To list the metrics scopes monitoring MY-PROJECT-ID + + $ gcloud alpha monitoring metrics-scopes list MY-PROJECT-ID + +POSITIONAL ARGUMENTS + PROJECT_ID_OR_NUMBER + ID or number for the project you want to list. + +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/network-connectivity/internal-ranges/create b/gcloud/alpha/network-connectivity/internal-ranges/create index f27a8ce84..1c6580e4c 100644 --- a/gcloud/alpha/network-connectivity/internal-ranges/create +++ b/gcloud/alpha/network-connectivity/internal-ranges/create @@ -17,21 +17,19 @@ DESCRIPTION EXAMPLES Create an internal range with name my-range and ip-cidr-range 192.168.0.0/25 in network - https://www.googleapis.com/compute/v1/projects/my-project/locations/global/networks/my-network - and region global: + https://www.googleapis.com/compute/v1/projects/my-project/locations/global/networks/my-network: $ gcloud alpha network-connectivity internal-ranges create \ my-range --ip-cidr-range="192.168.0.0/25" \ --network="https://www.googleapis.com/compute/v1/projects/my-pro\ - ject/locations/global/networks/my-network" --project=my-project \ - --region=global + ject/locations/global/networks/my-network" --project=my-project Create an internal range with name my-range and auto-allocated /25 block - (prefix-length 25) in network my-network and region global: + (prefix-length 25) in network my-network: $ gcloud alpha network-connectivity internal-ranges create \ my-range --prefix-length=25 --network="my-network" \ - --project=my-project --region=global + --project=my-project POSITIONAL ARGUMENTS Internal range resource - Name of the internal range to be created. The @@ -59,7 +57,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument internal_range on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ use default global location . REQUIRED FLAGS --network=NETWORK diff --git a/gcloud/alpha/network-connectivity/internal-ranges/delete b/gcloud/alpha/network-connectivity/internal-ranges/delete index e5c817ef8..de21b6062 100644 --- a/gcloud/alpha/network-connectivity/internal-ranges/delete +++ b/gcloud/alpha/network-connectivity/internal-ranges/delete @@ -10,11 +10,9 @@ DESCRIPTION (ALPHA) Delete the specified internal range. EXAMPLES - Delete an internal range named my-hub in project my-project and region - global, run: + Delete an internal range named my-range: - $ gcloud alpha network-connectivity internal-ranges delete \ - my-range --project=my-project --region=global + $ gcloud alpha network-connectivity internal-ranges delete my-range POSITIONAL ARGUMENTS Internal range resource - Name of the internal range to be deleted. The @@ -42,7 +40,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument internal_range on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ use default global location . FLAGS --async diff --git a/gcloud/alpha/network-connectivity/internal-ranges/describe b/gcloud/alpha/network-connectivity/internal-ranges/describe index 8dc0ef4f0..981183548 100644 --- a/gcloud/alpha/network-connectivity/internal-ranges/describe +++ b/gcloud/alpha/network-connectivity/internal-ranges/describe @@ -10,11 +10,9 @@ DESCRIPTION (ALPHA) Retrieve and display details about an internal range. EXAMPLES - Display details about an internal range named my-range in project - my-project and region global, run: + Display details about an internal range named my-range: - $ gcloud alpha network-connectivity internal-ranges describe \ - my-range --project=my-project --region=global + $ gcloud alpha network-connectivity internal-ranges describe my-range POSITIONAL ARGUMENTS Internal range resource - Name of the internal range to be described. The @@ -42,7 +40,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument internal_range on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ use default global location . GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/network-connectivity/internal-ranges/list b/gcloud/alpha/network-connectivity/internal-ranges/list index 1b33b4504..dd9eddcfc 100644 --- a/gcloud/alpha/network-connectivity/internal-ranges/list +++ b/gcloud/alpha/network-connectivity/internal-ranges/list @@ -3,7 +3,7 @@ NAME ranges SYNOPSIS - gcloud alpha network-connectivity internal-ranges list --region=REGION + gcloud alpha network-connectivity internal-ranges list [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] @@ -12,27 +12,26 @@ DESCRIPTION project. EXAMPLES - List all internal ranges in project my-project and region global, run: + List all internal ranges: - $ gcloud alpha network-connectivity internal-ranges list \ - --project=my-project --region=global + $ gcloud alpha network-connectivity internal-ranges list -REQUIRED FLAGS - Region resource - Project of the internal ranges to display. This +FLAGS + Region resource - Location of the internal ranges to display. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument --region on the command line with a fully specified name; + ◆ use default global location with a fully specified name; ◆ set the property core/project; ◆ provide the argument --project on the command line. - This must be specified. - --region=REGION ID of the region or fully qualified identifier for the region. To set the region attribute: - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ use default global location . LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/network-connectivity/internal-ranges/update b/gcloud/alpha/network-connectivity/internal-ranges/update index 6741dc809..c38559d77 100644 --- a/gcloud/alpha/network-connectivity/internal-ranges/update +++ b/gcloud/alpha/network-connectivity/internal-ranges/update @@ -12,18 +12,15 @@ DESCRIPTION (ALPHA) Update the detail of an internal range. EXAMPLES - Update ip-cidr-range of an internal range named my-range in project - my-project and region global: + Update ip-cidr-range of an internal range named my-range: $ gcloud alpha network-connectivity internal-ranges update \ - my-range --ip-cidr-range="192.168.0.0/24" --project=my-project \ - --region=global + my-range --ip-cidr-range="192.168.0.0/24" - Extend an internal range named my-range in project my-project and region - global to an address block of /24: + Extend an internal range named my-range to an address block of /24: $ gcloud alpha network-connectivity internal-ranges update \ - my-range --prefix-length=24 --project=my-project --region=global + my-range --prefix-length=24 POSITIONAL ARGUMENTS Internal range resource - Name of the internal range to be created. The @@ -51,7 +48,8 @@ POSITIONAL ARGUMENTS To set the region attribute: ▸ provide the argument internal_range on the command line with a fully specified name; - ▸ provide the argument --region on the command line. + ▸ provide the argument --region on the command line; + ▸ use default global location . REQUIRED FLAGS Exactly one of these must be specified: diff --git a/gcloud/alpha/run/help b/gcloud/alpha/run/help index 56d47ee9c..75bce08c5 100644 --- a/gcloud/alpha/run/help +++ b/gcloud/alpha/run/help @@ -26,9 +26,6 @@ GROUPS domain-mappings (ALPHA) View and manage your Cloud Run domain mappings. - executions - (ALPHA) View and manage your Cloud Run jobs executions. - jobs (ALPHA) View and manage your Cloud Run jobs. diff --git a/gcloud/alpha/run/jobs/run b/gcloud/alpha/run/jobs/execute similarity index 79% rename from gcloud/alpha/run/jobs/run rename to gcloud/alpha/run/jobs/execute index 69bc17d03..b9f62d043 100644 --- a/gcloud/alpha/run/jobs/run +++ b/gcloud/alpha/run/jobs/execute @@ -1,22 +1,22 @@ NAME - gcloud alpha run jobs run - run a job + gcloud alpha run jobs execute - execute a job SYNOPSIS - gcloud alpha run jobs run [JOB] [--region=REGION] [--async | --wait] + gcloud alpha run jobs execute [JOB] [--region=REGION] [--async | --wait] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Run a job. + (ALPHA) Execute a job. EXAMPLES - To run a job: + To execute a job: - $ gcloud alpha run jobs run my-job + $ gcloud alpha run jobs execute my-job POSITIONAL ARGUMENTS - Job resource - Job to run. 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: + Job resource - Job to execute. This represents a Cloud resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. To set the project attribute: ◆ provide the argument JOB on the command line with a fully specified name; ◆ specify the job name from an interactive prompt with a fully diff --git a/gcloud/alpha/run/executions/delete b/gcloud/alpha/run/jobs/executions/delete similarity index 88% rename from gcloud/alpha/run/executions/delete rename to gcloud/alpha/run/jobs/executions/delete index ffeb4f003..4e7494f07 100644 --- a/gcloud/alpha/run/executions/delete +++ b/gcloud/alpha/run/jobs/executions/delete @@ -1,8 +1,8 @@ NAME - gcloud alpha run executions delete - delete an execution + gcloud alpha run jobs executions delete - delete an execution SYNOPSIS - gcloud alpha run executions delete EXECUTION [--region=REGION] + gcloud alpha run jobs executions delete EXECUTION [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -11,7 +11,7 @@ DESCRIPTION EXAMPLES To delete an execution: - $ gcloud alpha run executions delete my-execution + $ gcloud alpha run jobs executions delete my-execution POSITIONAL ARGUMENTS Execution resource - Execution to delete. This represents a Cloud diff --git a/gcloud/alpha/run/executions/describe b/gcloud/alpha/run/jobs/executions/describe similarity index 87% rename from gcloud/alpha/run/executions/describe rename to gcloud/alpha/run/jobs/executions/describe index 2cf9ab007..1f8f414ba 100644 --- a/gcloud/alpha/run/executions/describe +++ b/gcloud/alpha/run/jobs/executions/describe @@ -1,8 +1,8 @@ NAME - gcloud alpha run executions describe - obtain details about executions + gcloud alpha run jobs executions describe - obtain details about executions SYNOPSIS - gcloud alpha run executions describe EXECUTION [--region=REGION] + gcloud alpha run jobs executions describe EXECUTION [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -11,7 +11,7 @@ DESCRIPTION EXAMPLES To describe an execution: - $ gcloud alpha run executions describe my-execution + $ gcloud alpha run jobs executions describe my-execution POSITIONAL ARGUMENTS Execution resource - Execution to describe. This represents a Cloud diff --git a/gcloud/alpha/run/executions/help b/gcloud/alpha/run/jobs/executions/help similarity index 83% rename from gcloud/alpha/run/executions/help rename to gcloud/alpha/run/jobs/executions/help index 8ee4efc11..456d38950 100644 --- a/gcloud/alpha/run/executions/help +++ b/gcloud/alpha/run/jobs/executions/help @@ -1,9 +1,9 @@ NAME - gcloud alpha run executions - view and manage your Cloud Run jobs + gcloud alpha run jobs executions - view and manage your Cloud Run jobs executions SYNOPSIS - gcloud alpha run executions GROUP | COMMAND [--region=REGION] + gcloud alpha run jobs executions GROUP | COMMAND [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -13,7 +13,7 @@ DESCRIPTION EXAMPLES To list your executions for a job, run: - $ gcloud alpha run executions list --job=my-job + $ gcloud alpha run jobs executions list --job=my-job FLAGS --region=REGION diff --git a/gcloud/alpha/run/executions/list b/gcloud/alpha/run/jobs/executions/list similarity index 94% rename from gcloud/alpha/run/executions/list rename to gcloud/alpha/run/jobs/executions/list index bb7d95ea8..bfbaee561 100644 --- a/gcloud/alpha/run/executions/list +++ b/gcloud/alpha/run/jobs/executions/list @@ -1,8 +1,8 @@ NAME - gcloud alpha run executions list - list executions + gcloud alpha run jobs executions list - list executions SYNOPSIS - gcloud alpha run executions list [--job=JOB] [--namespace=NAMESPACE] + gcloud alpha run jobs executions list [--job=JOB] [--namespace=NAMESPACE] [--region=REGION] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -13,7 +13,7 @@ DESCRIPTION EXAMPLES To list all executions in all regions: - $ gcloud alpha run executions list + $ gcloud alpha run jobs executions list FLAGS --job=JOB diff --git a/gcloud/alpha/run/executions/tasks/describe b/gcloud/alpha/run/jobs/executions/tasks/describe similarity index 86% rename from gcloud/alpha/run/executions/tasks/describe rename to gcloud/alpha/run/jobs/executions/tasks/describe index a6bbeb836..4c5b740ed 100644 --- a/gcloud/alpha/run/executions/tasks/describe +++ b/gcloud/alpha/run/jobs/executions/tasks/describe @@ -1,8 +1,9 @@ NAME - gcloud alpha run executions tasks describe - obtain details about tasks + gcloud alpha run jobs executions tasks describe - obtain details about + tasks SYNOPSIS - gcloud alpha run executions tasks describe TASK [--region=REGION] + gcloud alpha run jobs executions tasks describe TASK [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -11,7 +12,7 @@ DESCRIPTION EXAMPLES To describe a task: - $ gcloud alpha run executions tasks describe my-task + $ gcloud alpha run jobs executions tasks describe my-task POSITIONAL ARGUMENTS Task resource - Task to describe. This represents a Cloud resource. (NOTE) diff --git a/gcloud/alpha/run/executions/tasks/help b/gcloud/alpha/run/jobs/executions/tasks/help similarity index 77% rename from gcloud/alpha/run/executions/tasks/help rename to gcloud/alpha/run/jobs/executions/tasks/help index add135b04..2cfaef8fb 100644 --- a/gcloud/alpha/run/executions/tasks/help +++ b/gcloud/alpha/run/jobs/executions/tasks/help @@ -1,9 +1,9 @@ NAME - gcloud alpha run executions tasks - view and manage your Cloud Run jobs - tasks + gcloud alpha run jobs executions tasks - view and manage your Cloud Run + jobs tasks SYNOPSIS - gcloud alpha run executions tasks COMMAND [--region=REGION] + gcloud alpha run jobs executions tasks COMMAND [--region=REGION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -13,7 +13,8 @@ DESCRIPTION EXAMPLES To list your existing tasks for an execution, run: - $ gcloud alpha run executions tasks list --execution my_execution + $ gcloud alpha run jobs executions tasks list \ + --execution my_execution FLAGS --region=REGION diff --git a/gcloud/alpha/run/executions/tasks/list b/gcloud/alpha/run/jobs/executions/tasks/list similarity index 93% rename from gcloud/alpha/run/executions/tasks/list rename to gcloud/alpha/run/jobs/executions/tasks/list index f39234f3a..3424182d0 100644 --- a/gcloud/alpha/run/executions/tasks/list +++ b/gcloud/alpha/run/jobs/executions/tasks/list @@ -1,8 +1,8 @@ NAME - gcloud alpha run executions tasks list - list tasks + gcloud alpha run jobs executions tasks list - list tasks SYNOPSIS - gcloud alpha run executions tasks list --execution=EXECUTION + gcloud alpha run jobs executions tasks list --execution=EXECUTION [--region=REGION] [--succeeded] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -13,7 +13,8 @@ DESCRIPTION EXAMPLES To list all tasks for an execution: - $ gcloud alpha run executions tasks list --execution=my-execution + $ gcloud alpha run jobs executions tasks list \ + --execution=my-execution REQUIRED FLAGS Execution resource - Execution for which to list tasks. This represents a diff --git a/gcloud/alpha/run/jobs/help b/gcloud/alpha/run/jobs/help index 4fe499eb8..f36a05914 100644 --- a/gcloud/alpha/run/jobs/help +++ b/gcloud/alpha/run/jobs/help @@ -2,7 +2,8 @@ NAME gcloud alpha run jobs - view and manage your Cloud Run jobs SYNOPSIS - gcloud alpha run jobs COMMAND [--region=REGION] [GCLOUD_WIDE_FLAG ...] + gcloud alpha run jobs GROUP | COMMAND [--region=REGION] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) This set of commands can be used to view and manage your Cloud Run @@ -23,6 +24,12 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. +GROUPS + GROUP is one of the following: + + executions + (ALPHA) View and manage your Cloud Run jobs executions. + COMMANDS COMMAND is one of the following: @@ -38,6 +45,9 @@ COMMANDS describe (ALPHA) Obtain details about jobs. + execute + (ALPHA) Execute a job. + get-iam-policy (ALPHA) Get the IAM policy for a Cloud Run job. @@ -47,9 +57,6 @@ COMMANDS remove-iam-policy-binding (ALPHA) Remove IAM policy binding of a Cloud Run job. - run - (ALPHA) Run a job. - set-iam-policy (ALPHA) Set the IAM policy for a job. diff --git a/gcloud/alpha/run/services/proxy b/gcloud/alpha/run/services/proxy index f41cebd2a..14d71257e 100644 --- a/gcloud/alpha/run/services/proxy +++ b/gcloud/alpha/run/services/proxy @@ -154,5 +154,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta run services proxy diff --git a/gcloud/alpha/services/api-keys/clone b/gcloud/alpha/services/api-keys/clone deleted file mode 100644 index 023ec9b4b..000000000 --- a/gcloud/alpha/services/api-keys/clone +++ /dev/null @@ -1,57 +0,0 @@ -NAME - gcloud alpha services api-keys clone - create a new API key with the same - metadata as input key - -SYNOPSIS - gcloud alpha services api-keys clone (KEY : --location=LOCATION) [--async] - [GCLOUD_WIDE_FLAG ...] - -DESCRIPTION - (ALPHA) Create a new API key with the same metadata as input key. - -POSITIONAL ARGUMENTS - Key resource - The name of the key to clone. 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 key 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. - - KEY - ID of the key or fully qualified identifier for the key. To set the - key attribute: - ▸ provide the argument key on the command line. - - This positional must be specified if any of the other arguments in - this group are specified. - - --location=LOCATION - Location of the key. To set the location attribute: - ▸ provide the argument key on the command line with a fully - specified name; - ▸ provide the argument --location on the command line; - ▸ location will default to global. - -FLAGS - --async - Return immediately, without waiting for the operation in progress to - complete. - -GCLOUD WIDE FLAGS - These flags are available to all commands: --access-token-file, --account, - --billing-project, --configuration, --flags-file, --flatten, --format, - --help, --impersonate-service-account, --log-http, --project, --quiet, - --trace-token, --user-output-enabled, --verbosity. - - Run $ gcloud help for details. - -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/help b/gcloud/alpha/services/api-keys/help index a207fb6fb..49058b1f7 100644 --- a/gcloud/alpha/services/api-keys/help +++ b/gcloud/alpha/services/api-keys/help @@ -15,9 +15,6 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: - clone - (ALPHA) Create a new API key with the same metadata as input key. - create (ALPHA) Create an API key. diff --git a/gcloud/alpha/services/api-keys/list b/gcloud/alpha/services/api-keys/list index fd9a2c54d..32f85eacc 100644 --- a/gcloud/alpha/services/api-keys/list +++ b/gcloud/alpha/services/api-keys/list @@ -2,27 +2,27 @@ NAME gcloud alpha services api-keys list - lists API keys SYNOPSIS - gcloud alpha services api-keys list [--deleted] [--filter=EXPRESSION] + gcloud alpha services api-keys list [--show-deleted] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Lists all of the API keys that are active in a given project. You - can add the state filter state:DELETED to list API keys that were deleted - within past 30 days. + (ALPHA) Lists the API keys of a given project. EXAMPLES - List active keys: + List keys of a given project: $ gcloud alpha services api-keys list - List keys that were deleted in the past 30 days of a given project.: + List keys of a given project, including keys that were soft-deleted in the + past 30 days.: - $ gcloud alpha services api-keys list --deleted --project=my_project + $ gcloud alpha services api-keys list --show-deleted \ + --project=my_project FLAGS - --deleted - Return the keys that were deleted in past 30 days + --show-deleted + Show soft-deleted keys by specifying this flag. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/sql/export/bak b/gcloud/alpha/sql/export/bak index 886248e6a..a24b265e6 100644 --- a/gcloud/alpha/sql/export/bak +++ b/gcloud/alpha/sql/export/bak @@ -9,7 +9,7 @@ SYNOPSIS DESCRIPTION (ALPHA) Export data from a Cloud SQL instance to a Google Cloud Storage - bucket as a BAK backup file. + bucket as a BAK backup file. This is only supported for SQL Server. EXAMPLES To export data from the database my-database in the Cloud SQL instance diff --git a/gcloud/alpha/sql/operations/describe b/gcloud/alpha/sql/operations/describe index 40aee5e4b..b15058fc3 100644 --- a/gcloud/alpha/sql/operations/describe +++ b/gcloud/alpha/sql/operations/describe @@ -8,6 +8,11 @@ SYNOPSIS DESCRIPTION (ALPHA) Retrieves information about a Cloud SQL instance operation. +EXAMPLES + To describe an operation with the name "prod-operation-id", run: + + $ gcloud alpha sql operations describe prod-operation-id + POSITIONAL ARGUMENTS OPERATION Name that uniquely identifies the operation. diff --git a/gcloud/alpha/storage/cp b/gcloud/alpha/storage/cp index 739dbaec7..9b2f43441 100644 --- a/gcloud/alpha/storage/cp +++ b/gcloud/alpha/storage/cp @@ -3,7 +3,7 @@ NAME SYNOPSIS gcloud alpha storage cp SOURCE [SOURCE ...] DESTINATION - [--cache-control=CACHE_CONTROL] + [--all-versions, -A] [--cache-control=CACHE_CONTROL] [--content-disposition=CONTENT_DISPOSITION] [--content-encoding=CONTENT_ENCODING] [--content-language=CONTENT_LANGUAGE] [--content-md5=MD5_DIGEST] @@ -11,8 +11,11 @@ SYNOPSIS [--custom-metadata=[CUSTOM_METADATA,...]] [--custom-time=CUSTOM_TIME] [--do-not-decompress] [--if-generation-match=GENERATION] [--if-metageneration-match=METAGENERATION] [--ignore-symlinks] - [--recursive, -R, -r] [--storage-class=STORAGE_CLASS, -s STORAGE_CLASS] - [GCLOUD_WIDE_FLAG ...] + [--recursive, -R, -r] [--skip-unsupported, -U] + [--storage-class=STORAGE_CLASS, -s STORAGE_CLASS] + [--gzip-in-flight-all, -J + | --gzip-in-flight-extensions=[FILE_EXTENSIONS,...], + -j [FILE_EXTENSIONS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Copy data between your local file system and the cloud, within the @@ -47,6 +50,15 @@ POSITIONAL ARGUMENTS The destination path. FLAGS + --all-versions, -A + Copy all source versions from a source bucket or folder. If not set, + only the live version of each source object is copied. + + Note: This option is only useful when the destination bucket has Object + Versioning enabled. Additionally, the generation numbers of copied + versions do not necessarily match the order of the original generation + numbers. + --cache-control=CACHE_CONTROL How caches should handle requests and responses. @@ -98,11 +110,38 @@ FLAGS Recursively copy the contents of any directories that match the source path expression. + --skip-unsupported, -U + Skip objects with unsupported object types.Currently, the only + unsupported category is Amazon S3 objects with the GLACIER storage + class. + --storage-class=STORAGE_CLASS, -s STORAGE_CLASS Specifies the storage class of the destination object. If not specified, the default storage class of the destination bucket is used. This option is not valid for copying to non-cloud destinations. + At most one of these can be specified: + + --gzip-in-flight-all, -J + Applies gzip transport encoding to file uploads. This option works + like the --gzip-transfer option described above, but it applies to + all uploaded files, regardless of extension. + + CAUTION: If some of the source files don't compress well, such as + binary data, using this option may result in longer uploads. + + --gzip-in-flight-extensions=[FILE_EXTENSIONS,...], -j [FILE_EXTENSIONS,...] + Applies gzip transport encoding to any file upload whose extension + matches the input extension list. This is useful when uploading files + with compressible content such as .js, .css, or .html files. This + also saves network bandwidth while leaving the data uncompressed in + Cloud Storage. + + When you specify the --gzip-in-flight option, files being uploaded + are compressed in-memory and on-the-wire only. Both the local files + and Cloud Storage objects remain uncompressed. The uploaded objects + retain the Content-Type and name of the original files. + 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/artifacts/apt/help b/gcloud/artifacts/apt/help new file mode 100644 index 000000000..fdea67184 --- /dev/null +++ b/gcloud/artifacts/apt/help @@ -0,0 +1,30 @@ +NAME + gcloud artifacts apt - manage Artifact Registry Debian packages + +SYNOPSIS + gcloud artifacts apt COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Artifact Registry Debian packages. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + import + Import one or more Debian packages into an artifact repository. + + upload + Upload a Debian package to an artifact repository. + +NOTES + These variants are also available: + + $ gcloud alpha artifacts apt + + $ gcloud beta artifacts apt + diff --git a/gcloud/artifacts/apt/import b/gcloud/artifacts/apt/import new file mode 100644 index 000000000..e9ed5ce72 --- /dev/null +++ b/gcloud/artifacts/apt/import @@ -0,0 +1,89 @@ +NAME + gcloud artifacts apt import - import one or more Debian packages into an + artifact repository + +SYNOPSIS + gcloud artifacts apt import (REPOSITORY : --location=LOCATION) + --gcs-source=[GCS_SOURCE,...] [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud artifacts apt import imports Debian packages from Google Cloud + Storage into the specified artifact repository. + +EXAMPLES + To import the package my-package.deb from Google Cloud Storage into + my-repo, run: + + $ gcloud artifacts apt import my-repo --location=us-central1 \ + --gcs-source=gs://my-bucket/path/to/my-package.deb + + To import the packages my-package.deb and other-package.deb into my-repo, + run: + + $ gcloud artifacts apt import my-repo --location=us-central1 \ + --gcs-source=gs://my-bucket/path/to/my-package.deb,gs://\ + my-bucket/path/to/other-package.deb + + To import all packages from my-directory into my-repo, run: + + $ gcloud artifacts apt import my-repo --location=us-central1 \ + --gcs-source=gs://my-bucket/my-directory/* + + To import all packages in all subdirectories from a Google Cloud Storage + bucket into my-repo, run: + + $ gcloud artifacts apt import my-repo --location=us-central1 \ + --gcs-source=gs://my-bucket/** + +POSITIONAL ARGUMENTS + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. 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 repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Location of the repository. To set the location attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --gcs-source=[GCS_SOURCE,...] + The Google Cloud Storage location of a package to import. To import + multiple packages, use wildcards at the end of the path. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha artifacts apt import + + $ gcloud beta artifacts apt import + diff --git a/gcloud/artifacts/apt/upload b/gcloud/artifacts/apt/upload new file mode 100644 index 000000000..fa32f54f6 --- /dev/null +++ b/gcloud/artifacts/apt/upload @@ -0,0 +1,69 @@ +NAME + gcloud artifacts apt upload - upload a Debian package to an artifact + repository + +SYNOPSIS + gcloud artifacts apt upload (REPOSITORY : --location=LOCATION) + --source=SOURCE [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud artifacts apt upload uploads a Debian package to the specified + artifact repository. + +EXAMPLES + To upload the package my-package.deb to my-repo, run: + + $ gcloud artifacts apt upload my-repo --location=us-central1 \ + --source=my-package.deb + +POSITIONAL ARGUMENTS + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. 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 repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Location of the repository. To set the location attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --source=SOURCE + The path of a package to upload. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha artifacts apt upload + + $ gcloud beta artifacts apt upload + diff --git a/gcloud/artifacts/help b/gcloud/artifacts/help index ed6277c08..cda4e6812 100644 --- a/gcloud/artifacts/help +++ b/gcloud/artifacts/help @@ -15,6 +15,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + apt + Manage Artifact Registry Debian packages. + docker Manage Artifact Registry container images and tags. @@ -39,6 +42,9 @@ GROUPS versions Manage Artifact Registry package versions. + yum + Manage Artifact Registry RPM packages. + NOTES These variants are also available: diff --git a/gcloud/artifacts/yum/help b/gcloud/artifacts/yum/help new file mode 100644 index 000000000..24417f55b --- /dev/null +++ b/gcloud/artifacts/yum/help @@ -0,0 +1,30 @@ +NAME + gcloud artifacts yum - manage Artifact Registry RPM packages + +SYNOPSIS + gcloud artifacts yum COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Artifact Registry RPM packages. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + import + Import one or more RPM packages into an artifact repository. + + upload + Upload an RPM package to an artifact repository. + +NOTES + These variants are also available: + + $ gcloud alpha artifacts yum + + $ gcloud beta artifacts yum + diff --git a/gcloud/artifacts/yum/import b/gcloud/artifacts/yum/import new file mode 100644 index 000000000..211e8560a --- /dev/null +++ b/gcloud/artifacts/yum/import @@ -0,0 +1,89 @@ +NAME + gcloud artifacts yum import - import one or more RPM packages into an + artifact repository + +SYNOPSIS + gcloud artifacts yum import (REPOSITORY : --location=LOCATION) + --gcs-source=[GCS_SOURCE,...] [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud artifacts yum import imports RPM packages from Google Cloud Storage + into the specified artifact repository. + +EXAMPLES + To import the package my-package.rpm from Google Cloud Storage into + my-repo, run: + + $ gcloud artifacts yum import my-repo --location=us-central1 \ + --gcs-source=gs://my-bucket/path/to/my-package.rpm + + To import the packages my-package.rpm and other-package.rpm into my-repo, + run: + + $ gcloud artifacts yum import my-repo --location=us-central1 \ + --gcs-source=gs://my-bucket/path/to/my-package.rpm,gs://\ + my-bucket/path/to/other-package.rpm + + To import all packages from my-directory into my-repo, run: + + $ gcloud artifacts yum import my-repo --location=us-central1 \ + --gcs-source=gs://my-bucket/my-directory/* + + To import all packages in all subdirectories from a Google Cloud Storage + bucket into my-repo, run: + + $ gcloud artifacts yum import my-repo --location=us-central1 \ + --gcs-source=gs://my-bucket/** + +POSITIONAL ARGUMENTS + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. 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 repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Location of the repository. To set the location attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --gcs-source=[GCS_SOURCE,...] + The Google Cloud Storage location of a package to import. To import + multiple packages, use wildcards at the end of the path. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha artifacts yum import + + $ gcloud beta artifacts yum import + diff --git a/gcloud/artifacts/yum/upload b/gcloud/artifacts/yum/upload new file mode 100644 index 000000000..a43d0ef79 --- /dev/null +++ b/gcloud/artifacts/yum/upload @@ -0,0 +1,69 @@ +NAME + gcloud artifacts yum upload - upload an RPM package to an artifact + repository + +SYNOPSIS + gcloud artifacts yum upload (REPOSITORY : --location=LOCATION) + --source=SOURCE [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud artifacts yum upload uploads an RPM package to the specified + artifact repository. + +EXAMPLES + To upload the package my-package.rpm to my-repo, run: + + $ gcloud artifacts yum upload my-repo --location=us-central1 \ + --source=my-package.rpm + +POSITIONAL ARGUMENTS + Repository resource - The Artifact Registry repository. If not specified, + the current artifacts/repository is used. 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 repository 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. + + REPOSITORY + ID of the repository or fully qualified identifier for the + repository. To set the repository attribute: + ▸ provide the argument repository on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + Location of the repository. To set the location attribute: + ▸ provide the argument repository on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --source=SOURCE + The path of a package to upload. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha artifacts yum upload + + $ gcloud beta artifacts yum upload + diff --git a/gcloud/auth/application-default/print-access-token b/gcloud/auth/application-default/print-access-token index 58e432a64..46f27cc5c 100644 --- a/gcloud/auth/application-default/print-access-token +++ b/gcloud/auth/application-default/print-access-token @@ -47,9 +47,9 @@ FLAGS and service accounts only. The list of possible scopes can be found at: https://developers.google.com/identity/protocols/googlescopes. - For end-user accounts, the provided scopes must be from ['openid', - 'https://www.googleapis.com/auth/userinfo.email', - 'https://www.googleapis.com/auth/cloud-platform'], or the scopes + For end-user accounts, the provided scopes must be from [openid, + https://www.googleapis.com/auth/userinfo.email, + https://www.googleapis.com/auth/cloud-platform], or the scopes previously specified through gcloud auth application-default login --scopes. diff --git a/gcloud/auth/application-default/set-quota-project b/gcloud/auth/application-default/set-quota-project index a923e34d0..7e8c13c51 100644 --- a/gcloud/auth/application-default/set-quota-project +++ b/gcloud/auth/application-default/set-quota-project @@ -7,11 +7,11 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Before running this command, an ADC must already be generated using $gcloud - auth application-default login. The quota project can be used by client - libraries for the billing purpose. The existing application default - credentials must have the "serviceusage.services.use" permission on the - given project. + Before running this command, an ADC must already be generated using $ + gcloud auth application-default login. The quota project can be used by + client libraries for the billing purpose. The existing application default + credentials must have the serviceusage.services.use permission on the given + project. EXAMPLES To update the quota project in application default credentials to diff --git a/gcloud/beta/artifacts/apt/help b/gcloud/beta/artifacts/apt/help index 3d4fbe276..dba944d0e 100644 --- a/gcloud/beta/artifacts/apt/help +++ b/gcloud/beta/artifacts/apt/help @@ -22,8 +22,10 @@ COMMANDS (BETA) Upload a Debian package to an artifact repository. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud artifacts apt $ gcloud alpha artifacts apt diff --git a/gcloud/beta/artifacts/apt/import b/gcloud/beta/artifacts/apt/import index 8332f62fa..dfd9d0f40 100644 --- a/gcloud/beta/artifacts/apt/import +++ b/gcloud/beta/artifacts/apt/import @@ -64,8 +64,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --gcs-source=[GCS_SOURCE,...] - The Google Cloud Storage location of a package to import. Wildcards may - be added at the end to import multiple packages. + The Google Cloud Storage location of a package to import. To import + multiple packages, use wildcards at the end of the path. OPTIONAL FLAGS --async @@ -81,8 +81,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud artifacts apt import $ gcloud alpha artifacts apt import diff --git a/gcloud/beta/artifacts/apt/upload b/gcloud/beta/artifacts/apt/upload index 002978031..872246b63 100644 --- a/gcloud/beta/artifacts/apt/upload +++ b/gcloud/beta/artifacts/apt/upload @@ -61,8 +61,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud artifacts apt upload $ gcloud alpha artifacts apt upload diff --git a/gcloud/beta/artifacts/yum/help b/gcloud/beta/artifacts/yum/help index 3064d061b..7698ceab7 100644 --- a/gcloud/beta/artifacts/yum/help +++ b/gcloud/beta/artifacts/yum/help @@ -22,8 +22,10 @@ COMMANDS (BETA) Upload an RPM package to an artifact repository. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud artifacts yum $ gcloud alpha artifacts yum diff --git a/gcloud/beta/artifacts/yum/import b/gcloud/beta/artifacts/yum/import index d235d4312..695657874 100644 --- a/gcloud/beta/artifacts/yum/import +++ b/gcloud/beta/artifacts/yum/import @@ -64,8 +64,8 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --gcs-source=[GCS_SOURCE,...] - The Google Cloud Storage location of a package to import. Wildcards may - be added at the end to import multiple packages. + The Google Cloud Storage location of a package to import. To import + multiple packages, use wildcards at the end of the path. OPTIONAL FLAGS --async @@ -81,8 +81,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud artifacts yum import $ gcloud alpha artifacts yum import diff --git a/gcloud/beta/artifacts/yum/upload b/gcloud/beta/artifacts/yum/upload index 7b9049239..4e001542a 100644 --- a/gcloud/beta/artifacts/yum/upload +++ b/gcloud/beta/artifacts/yum/upload @@ -61,8 +61,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud artifacts yum upload $ gcloud alpha artifacts yum upload diff --git a/gcloud/beta/auth/application-default/print-access-token b/gcloud/beta/auth/application-default/print-access-token index 1c34188f7..106cdb853 100644 --- a/gcloud/beta/auth/application-default/print-access-token +++ b/gcloud/beta/auth/application-default/print-access-token @@ -47,9 +47,9 @@ FLAGS and service accounts only. The list of possible scopes can be found at: https://developers.google.com/identity/protocols/googlescopes. - For end-user accounts, the provided scopes must be from ['openid', - 'https://www.googleapis.com/auth/userinfo.email', - 'https://www.googleapis.com/auth/cloud-platform'], or the scopes + For end-user accounts, the provided scopes must be from [openid, + https://www.googleapis.com/auth/userinfo.email, + https://www.googleapis.com/auth/cloud-platform], or the scopes previously specified through gcloud auth application-default login --scopes. diff --git a/gcloud/beta/auth/application-default/set-quota-project b/gcloud/beta/auth/application-default/set-quota-project index bc2664d24..10a2aa897 100644 --- a/gcloud/beta/auth/application-default/set-quota-project +++ b/gcloud/beta/auth/application-default/set-quota-project @@ -8,10 +8,10 @@ SYNOPSIS DESCRIPTION (BETA) Before running this command, an ADC must already be generated using - $gcloud auth application-default login. The quota project can be used by + $ gcloud auth application-default login. The quota project can be used by client libraries for the billing purpose. The existing application default - credentials must have the "serviceusage.services.use" permission on the - given project. + credentials must have the serviceusage.services.use permission on the given + project. EXAMPLES To update the quota project in application default credentials to diff --git a/gcloud/beta/compute/backend-services/create b/gcloud/beta/compute/backend-services/create index 5d4e0e1a3..9c4659761 100644 --- a/gcloud/beta/compute/backend-services/create +++ b/gcloud/beta/compute/backend-services/create @@ -257,8 +257,9 @@ FLAGS --[no-]enable-logging The logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Cloud - Logging. Disabled by default. Use --enable-logging to enable and - --no-enable-logging to disable. + Logging. This can only be specified if the protocol is HTTP, HTTPS, + HTTP2, TCP, or SSL. Disabled by default. Use --enable-logging to enable + and --no-enable-logging to disable. --[no-]enable-strong-affinity Enable or disable strong session affinity. This is only available for @@ -333,7 +334,8 @@ FLAGS service. The value of the field must be a float in the range [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no - logged requests are reported. The default value is 1.0. + logged requests are reported. This can only be specified if the + protocol is HTTP, HTTPS, HTTP2, TCP, or SSL. The default value is 1.0. --max-ttl=MAX_TTL Specifies the maximum allowed TTL for cached content served by this diff --git a/gcloud/beta/compute/backend-services/update b/gcloud/beta/compute/backend-services/update index 5e3f1b2ef..5be022a0e 100644 --- a/gcloud/beta/compute/backend-services/update +++ b/gcloud/beta/compute/backend-services/update @@ -170,8 +170,9 @@ FLAGS --[no-]enable-logging The logging options for the load balancer traffic served by this backend service. If logging is enabled, logs will be exported to Cloud - Logging. Disabled by default. Use --enable-logging to enable and - --no-enable-logging to disable. + Logging. This can only be specified if the protocol is HTTP, HTTPS, + HTTP2, TCP, or SSL. Disabled by default. Use --enable-logging to enable + and --no-enable-logging to disable. --[no-]enable-strong-affinity Enable or disable strong session affinity. This is only available for @@ -240,7 +241,8 @@ FLAGS service. The value of the field must be a float in the range [0, 1]. This configures the sampling rate of requests to the load balancer where 1.0 means all logged requests are reported and 0.0 means no - logged requests are reported. The default value is 1.0. + logged requests are reported. This can only be specified if the + protocol is HTTP, HTTPS, HTTP2, TCP, or SSL. The default value is 1.0. --port-name=PORT_NAME Backend services for external HTTP(S) load balancing, internal HTTP(S) diff --git a/gcloud/beta/compute/instances/bulk/create b/gcloud/beta/compute/instances/bulk/create index 0744ff407..ef3f425f9 100644 --- a/gcloud/beta/compute/instances/bulk/create +++ b/gcloud/beta/compute/instances/bulk/create @@ -532,6 +532,10 @@ OPTIONAL FLAGS key is also specified this must be a subnetwork of the specified network. + nic-type + Specifies the Network Interface Controller (NIC) type for the + interface. NIC_TYPE must be one of: GVNIC, VIRTIO_NET. + --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The diff --git a/gcloud/beta/compute/networks/create b/gcloud/beta/compute/networks/create index e5d0a1465..00ee22fbb 100644 --- a/gcloud/beta/compute/networks/create +++ b/gcloud/beta/compute/networks/create @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud beta compute networks create NAME [--bgp-routing-mode=MODE; default="regional"] - [--description=DESCRIPTION] [--mtu=MTU] [--range=RANGE] + [--description=DESCRIPTION] [--[no-]enable-ula-internal-ipv6] + [--internal-ipv6-range=INTERNAL_IPV6_RANGE] [--mtu=MTU] [--range=RANGE] [--subnet-mode=MODE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -49,6 +50,21 @@ FLAGS --description=DESCRIPTION An optional, textual description for the network. + --[no-]enable-ula-internal-ipv6 + Enable/disable ULA internal IPv6 on this network. Enabling this feature + will assign a /48 from google defined ULA prefix fd20::/20. + + Use --enable-ula-internal-ipv6 to enable and + --no-enable-ula-internal-ipv6 to disable. + + --internal-ipv6-range=INTERNAL_IPV6_RANGE + When enabling ULA internal IPv6, caller can optionally specify the /48 + range they want from the google defined ULA prefix fd20::/20. + ULA_IPV6_RANGE must be a valid /48 ULA IPv6 address and within the + fd20::/20. Operation will fail if the speficied /48 is already in used + by another resource. If the field is not speficied, then a /48 range + will be randomly allocated from fd20::/20 and returned via this field. + --mtu=MTU Maximum transmission unit (MTU) is the size of the largest IP packet that can be transmitted on this network. Default value is 1460 bytes, diff --git a/gcloud/beta/compute/networks/update b/gcloud/beta/compute/networks/update index de05e4f81..d66198c20 100644 --- a/gcloud/beta/compute/networks/update +++ b/gcloud/beta/compute/networks/update @@ -2,7 +2,9 @@ NAME gcloud beta compute networks update - update a Compute Engine network SYNOPSIS - gcloud beta compute networks update NAME [--async] [--mtu=MTU] + gcloud beta compute networks update NAME [--async] + [--[no-]enable-ula-internal-ipv6] + [--internal-ipv6-range=INTERNAL_IPV6_RANGE] [--mtu=MTU] [--bgp-routing-mode=MODE | --switch-to-custom-subnet-mode] [GCLOUD_WIDE_FLAG ...] @@ -31,6 +33,21 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --[no-]enable-ula-internal-ipv6 + Enable/disable ULA internal IPv6 on this network. Enabling this feature + will assign a /48 from google defined ULA prefix fd20::/20. + + Use --enable-ula-internal-ipv6 to enable and + --no-enable-ula-internal-ipv6 to disable. + + --internal-ipv6-range=INTERNAL_IPV6_RANGE + When enabling ULA internal IPv6, caller can optionally specify the /48 + range they want from the google defined ULA prefix fd20::/20. + ULA_IPV6_RANGE must be a valid /48 ULA IPv6 address and within the + fd20::/20. Operation will fail if the speficied /48 is already in used + by another resource. If the field is not speficied, then a /48 range + will be randomly allocated from fd20::/20 and returned via this field. + --mtu=MTU Maximum transmission unit (MTU) is the size of the largest IP packet that can be transmitted on this network. Default value is 1460 bytes, diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index 3b405a053..7c512e42f 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -1129,9 +1129,10 @@ FLAGS enableAutoRepair: A boolean field that indicates if node autorepair is enabled for autoprovisioned node pools. - minCpuPlatform: If specified, new autoprovisioned nodes will be - scheduled on host with specified CPU architecture or a newer one. - Note: Min CPU platform can only be specified in Beta and Alpha. + minCpuPlatform (deprecated): If specified, new autoprovisioned + nodes will be scheduled on host with specified CPU architecture or + a newer one. Note: Min CPU platform can only be specified in Beta + and Alpha. Autoprovisioned node image is specified under the 'imageType' field. If not specified the default value will be applied. @@ -1187,8 +1188,12 @@ FLAGS separated by commas. --autoprovisioning-min-cpu-platform=PLATFORM - If specified, new autoprovisioned nodes will be scheduled on host - with specified CPU architecture or a newer one. + (DEPRECATED) If specified, new autoprovisioned nodes will be + scheduled on host with specified CPU architecture or a newer one. + + The --autoprovisioning-min-cpu-platform flag is deprecated and + will be removed in an upcoming release. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#March_08_2022 --min-cpu=MIN_CPU Minimum number of cores in the cluster. diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 55706c8a8..b67d96b0a 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -750,9 +750,10 @@ REQUIRED FLAGS enableAutoRepair: A boolean field that indicates if node autorepair is enabled for autoprovisioned node pools. - minCpuPlatform: If specified, new autoprovisioned nodes will be - scheduled on host with specified CPU architecture or a newer one. - Note: Min CPU platform can only be specified in Beta and Alpha. + minCpuPlatform (deprecated): If specified, new autoprovisioned + nodes will be scheduled on host with specified CPU architecture + or a newer one. Note: Min CPU platform can only be specified in + Beta and Alpha. Autoprovisioned node image is specified under the 'imageType' field. If not specified the default value will be applied. @@ -791,8 +792,13 @@ REQUIRED FLAGS separated by commas. --autoprovisioning-min-cpu-platform=PLATFORM - If specified, new autoprovisioned nodes will be scheduled on - host with specified CPU architecture or a newer one. + (DEPRECATED) If specified, new autoprovisioned nodes will be + scheduled on host with specified CPU architecture or a newer + one. + + The --autoprovisioning-min-cpu-platform flag is deprecated and + will be removed in an upcoming release. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#March_08_2022 --max-cpu=MAX_CPU Maximum number of cores in the cluster. diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index cfc95cbc1..2f6d2fba2 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -3,8 +3,9 @@ NAME SYNOPSIS gcloud beta functions deploy (NAME : --region=REGION) - [--allow-unauthenticated] [--egress-settings=EGRESS_SETTINGS] - [--entry-point=ENTRY_POINT] [--gen2] [--ignore-file=IGNORE_FILE] + [--allow-unauthenticated] [--docker-registry=DOCKER_REGISTRY] + [--egress-settings=EGRESS_SETTINGS] [--entry-point=ENTRY_POINT] + [--gen2] [--ignore-file=IGNORE_FILE] [--ingress-settings=INGRESS_SETTINGS] [--memory=MEMORY] [--retry] [--run-service-account=RUN_SERVICE_ACCOUNT] [--runtime=RUNTIME] [--security-level=SECURITY_LEVEL; default="secure-always"] @@ -93,6 +94,16 @@ FLAGS If set, makes this a public function. This will allow all callers, without checking authentication. + --docker-registry=DOCKER_REGISTRY + Docker Registry to use for storing the function's Docker images. The + option container-registry is used by default. + + Warning: Artifact Registry and Container Registry have different image + storage costs. For more details, please see + https://cloud.google.com/functions/pricing#deployment_costs. + + DOCKER_REGISTRY must be one of: artifact-registry, container-registry. + --egress-settings=EGRESS_SETTINGS Egress settings controls what traffic is diverted through the VPC Access Connector resource. By default private-ranges-only will be used. diff --git a/gcloud/beta/run/services/help b/gcloud/beta/run/services/help index 67ec515e2..36c926f1f 100644 --- a/gcloud/beta/run/services/help +++ b/gcloud/beta/run/services/help @@ -117,6 +117,10 @@ COMMANDS list (BETA) List available services. + proxy + (BETA) Proxy a service to localhost authenticating as the active + account or with the specified token. + remove-iam-policy-binding (BETA) Remove IAM policy binding of a Cloud Run service. diff --git a/gcloud/beta/run/services/proxy b/gcloud/beta/run/services/proxy new file mode 100644 index 000000000..89d26e795 --- /dev/null +++ b/gcloud/beta/run/services/proxy @@ -0,0 +1,158 @@ +NAME + gcloud beta run services proxy - proxy a service to localhost + authenticating as the active account or with the specified token + +SYNOPSIS + gcloud beta run services proxy (SERVICE : --namespace=NAMESPACE) + [--platform=PLATFORM; default="managed"] [--port=PORT] [--tag=TAG] + [--token=TOKEN] + [--region=REGION + | --cluster=CLUSTER --cluster-location=CLUSTER_LOCATION + | --context=CONTEXT --kubeconfig=KUBECONFIG] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Proxy a service to localhost authenticating as the active account or + with the specified token. + +EXAMPLES + To proxy the service 'my-service' at localhost port 8080: + + $ gcloud beta run services proxy my-service --port=8080 + + To proxy the existing traffic tag 'my-tag' on the service 'my-service: + + $ gcloud beta run services proxy my-service --tag=my-tag + +POSITIONAL ARGUMENTS + Service resource - Service to proxy locally. The arguments in this group + can be used to specify the attributes of this resource. + + This must be specified. + + SERVICE + ID of the service or fully qualified identifier for the service. To + set the service attribute: + ▸ provide the argument SERVICE on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --namespace=NAMESPACE + Specific to Cloud Run for Anthos: Kubernetes namespace for the + service. To set the namespace attribute: + ▸ provide the argument SERVICE on the command line with a fully + specified name; + ▸ provide the argument --namespace on the command line; + ▸ set the property run/namespace; + ▸ For Cloud Run on Kubernetes Engine, defaults to "default". + Otherwise, defaults to project ID.; + ▸ provide the argument project on the command line; + ▸ set the property core/project. + +FLAGS + --platform=PLATFORM; default="managed" + Target platform for running commands. Alternatively, set the property + [run/platform]. PLATFORM must be one of: + + managed + Fully managed version of Cloud Run. Use with the --region flag or + set the [run/region] property to specify a Cloud Run region. + gke + Cloud Run for Anthos on Google Cloud. Use with the --cluster and + --cluster-location flags or set the [run/cluster] and + [run/cluster_location] properties to specify a cluster in a given + zone. + kubernetes + Use a Knative-compatible kubernetes cluster. Use with the + --kubeconfig and --context flags to specify a kubeconfig file and + the context for connecting. + + --port=PORT + Local port number to expose the proxied service. If not specified, it + will be set to 8080. + + --tag=TAG + Traffic tag of the service to expose via the proxy. If not specified, + the default service URL will be proxied which may serve different + revisions based on traffic-splits. Custom tags can be used to proxy + specific revisions. Please see + https://cloud.google.com/run/docs/rollouts-rollbacks-traffic-migration#tags. + + --token=TOKEN + The specific identity token to add to all requests of the proxied + service. If not specified, the identity token of the currently active + authenticated account will be used (e.g. gcloud auth + print-identity-token). + + Arguments to locate resources, depending on the platform used. + + At most one of these can be specified: + + Only applicable if connecting to Cloud Run (fully managed). Specify + --platform=managed to use: + + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + + Only applicable if connecting to Cloud Run for Anthos deployed on Google + Cloud. Specify --platform=gke to use: + + Cluster resource - Kubernetes Engine cluster to connect to. 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 --cluster on the command line with a fully + specified name; + ▫ set the property run/cluster with a fully specified name; + ▫ specify the cluster from a list of available clusters with a + fully specified name; + ▫ provide the argument --project on the command line; + ▫ set the property core/project. + + --cluster=CLUSTER + ID of the cluster or fully qualified identifier for the cluster. + To set the cluster attribute: + ◇ provide the argument --cluster on the command line; + ◇ set the property run/cluster; + ◇ specify the cluster from a list of available clusters. + + --cluster-location=CLUSTER_LOCATION + Zone in which the cluster is located. Alternatively, set the + property [run/cluster_location]. To set the location attribute: + ◇ provide the argument --cluster on the command line with a + fully specified name; + ◇ set the property run/cluster with a fully specified name; + ◇ specify the cluster from a list of available clusters with a + fully specified name; + ◇ provide the argument --cluster-location on the command line; + ◇ set the property run/cluster_location; + ◇ specify the cluster location from a list of available zones. + + Only applicable if connecting to Cloud Run for Anthos deployed on + VMware. Specify --platform=kubernetes to use: + + --context=CONTEXT + The name of the context in your kubectl config file to use for + connecting. + + --kubeconfig=KUBECONFIG + The absolute path to your kubectl config file. If not specified, + the colon- or semicolon-delimited list of paths specified by + $KUBECONFIG will be used. If $KUBECONFIG is unset, this defaults to + ~/.kube/config. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha run services proxy + diff --git a/gcloud/beta/sql/export/bak b/gcloud/beta/sql/export/bak index 3ccb755d5..a36ad9c3b 100644 --- a/gcloud/beta/sql/export/bak +++ b/gcloud/beta/sql/export/bak @@ -8,7 +8,7 @@ SYNOPSIS DESCRIPTION (BETA) Export data from a Cloud SQL instance to a Google Cloud Storage - bucket as a BAK backup file. + bucket as a BAK backup file. This is only supported for SQL Server. EXAMPLES To export data from the database my-database in the Cloud SQL instance diff --git a/gcloud/beta/sql/operations/describe b/gcloud/beta/sql/operations/describe index 301d532dc..bc61beba2 100644 --- a/gcloud/beta/sql/operations/describe +++ b/gcloud/beta/sql/operations/describe @@ -8,6 +8,11 @@ SYNOPSIS DESCRIPTION (BETA) Retrieves information about a Cloud SQL instance operation. +EXAMPLES + To describe an operation with the name "prod-operation-id", run: + + $ gcloud beta sql operations describe prod-operation-id + POSITIONAL ARGUMENTS OPERATION Name that uniquely identifies the operation. diff --git a/gcloud/compute/instances/bulk/create b/gcloud/compute/instances/bulk/create index b341eeea6..96faa8991 100644 --- a/gcloud/compute/instances/bulk/create +++ b/gcloud/compute/instances/bulk/create @@ -522,6 +522,10 @@ OPTIONAL FLAGS key is also specified this must be a subnetwork of the specified network. + nic-type + Specifies the Network Interface Controller (NIC) type for the + interface. NIC_TYPE must be one of: GVNIC, VIRTIO_NET. + --network-tier=NETWORK_TIER Specifies the network tier that will be used to configure the instance. NETWORK_TIER must be one of: PREMIUM, STANDARD, FIXED_STANDARD. The diff --git a/gcloud/compute/networks/create b/gcloud/compute/networks/create index 795f01b7c..b59b76143 100644 --- a/gcloud/compute/networks/create +++ b/gcloud/compute/networks/create @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud compute networks create NAME [--bgp-routing-mode=MODE; default="regional"] - [--description=DESCRIPTION] [--mtu=MTU] [--range=RANGE] + [--description=DESCRIPTION] [--[no-]enable-ula-internal-ipv6] + [--internal-ipv6-range=INTERNAL_IPV6_RANGE] [--mtu=MTU] [--range=RANGE] [--subnet-mode=MODE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -49,6 +50,21 @@ FLAGS --description=DESCRIPTION An optional, textual description for the network. + --[no-]enable-ula-internal-ipv6 + Enable/disable ULA internal IPv6 on this network. Enabling this feature + will assign a /48 from google defined ULA prefix fd20::/20. + + Use --enable-ula-internal-ipv6 to enable and + --no-enable-ula-internal-ipv6 to disable. + + --internal-ipv6-range=INTERNAL_IPV6_RANGE + When enabling ULA internal IPv6, caller can optionally specify the /48 + range they want from the google defined ULA prefix fd20::/20. + ULA_IPV6_RANGE must be a valid /48 ULA IPv6 address and within the + fd20::/20. Operation will fail if the speficied /48 is already in used + by another resource. If the field is not speficied, then a /48 range + will be randomly allocated from fd20::/20 and returned via this field. + --mtu=MTU Maximum transmission unit (MTU) is the size of the largest IP packet that can be transmitted on this network. Default value is 1460 bytes, diff --git a/gcloud/compute/networks/update b/gcloud/compute/networks/update index 782d6e7f3..d5a9fbb61 100644 --- a/gcloud/compute/networks/update +++ b/gcloud/compute/networks/update @@ -2,7 +2,9 @@ NAME gcloud compute networks update - update a Compute Engine network SYNOPSIS - gcloud compute networks update NAME [--async] [--mtu=MTU] + gcloud compute networks update NAME [--async] + [--[no-]enable-ula-internal-ipv6] + [--internal-ipv6-range=INTERNAL_IPV6_RANGE] [--mtu=MTU] [--bgp-routing-mode=MODE | --switch-to-custom-subnet-mode] [GCLOUD_WIDE_FLAG ...] @@ -30,6 +32,21 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --[no-]enable-ula-internal-ipv6 + Enable/disable ULA internal IPv6 on this network. Enabling this feature + will assign a /48 from google defined ULA prefix fd20::/20. + + Use --enable-ula-internal-ipv6 to enable and + --no-enable-ula-internal-ipv6 to disable. + + --internal-ipv6-range=INTERNAL_IPV6_RANGE + When enabling ULA internal IPv6, caller can optionally specify the /48 + range they want from the google defined ULA prefix fd20::/20. + ULA_IPV6_RANGE must be a valid /48 ULA IPv6 address and within the + fd20::/20. Operation will fail if the speficied /48 is already in used + by another resource. If the field is not speficied, then a /48 range + will be randomly allocated from fd20::/20 and returned via this field. + --mtu=MTU Maximum transmission unit (MTU) is the size of the largest IP packet that can be transmitted on this network. Default value is 1460 bytes, diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index 397be29e9..e5dae3824 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -1015,9 +1015,10 @@ FLAGS enableAutoRepair: A boolean field that indicates if node autorepair is enabled for autoprovisioned node pools. - minCpuPlatform: If specified, new autoprovisioned nodes will be - scheduled on host with specified CPU architecture or a newer one. - Note: Min CPU platform can only be specified in Beta and Alpha. + minCpuPlatform (deprecated): If specified, new autoprovisioned + nodes will be scheduled on host with specified CPU architecture or + a newer one. Note: Min CPU platform can only be specified in Beta + and Alpha. Autoprovisioned node image is specified under the 'imageType' field. If not specified the default value will be applied. @@ -1073,8 +1074,12 @@ FLAGS separated by commas. --autoprovisioning-min-cpu-platform=PLATFORM - If specified, new autoprovisioned nodes will be scheduled on host - with specified CPU architecture or a newer one. + (DEPRECATED) If specified, new autoprovisioned nodes will be + scheduled on host with specified CPU architecture or a newer one. + + The --autoprovisioning-min-cpu-platform flag is deprecated and + will be removed in an upcoming release. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#March_08_2022 --min-cpu=MIN_CPU Minimum number of cores in the cluster. diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 344e16213..9ff529223 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -672,9 +672,10 @@ REQUIRED FLAGS enableAutoRepair: A boolean field that indicates if node autorepair is enabled for autoprovisioned node pools. - minCpuPlatform: If specified, new autoprovisioned nodes will be - scheduled on host with specified CPU architecture or a newer one. - Note: Min CPU platform can only be specified in Beta and Alpha. + minCpuPlatform (deprecated): If specified, new autoprovisioned + nodes will be scheduled on host with specified CPU architecture + or a newer one. Note: Min CPU platform can only be specified in + Beta and Alpha. Autoprovisioned node image is specified under the 'imageType' field. If not specified the default value will be applied. @@ -713,8 +714,13 @@ REQUIRED FLAGS separated by commas. --autoprovisioning-min-cpu-platform=PLATFORM - If specified, new autoprovisioned nodes will be scheduled on - host with specified CPU architecture or a newer one. + (DEPRECATED) If specified, new autoprovisioned nodes will be + scheduled on host with specified CPU architecture or a newer + one. + + The --autoprovisioning-min-cpu-platform flag is deprecated and + will be removed in an upcoming release. More info: + https://cloud.google.com/kubernetes-engine/docs/release-notes#March_08_2022 --max-cpu=MAX_CPU Maximum number of cores in the cluster. diff --git a/gcloud/eventarc/help b/gcloud/eventarc/help index 17ddc8525..47eb88026 100644 --- a/gcloud/eventarc/help +++ b/gcloud/eventarc/help @@ -18,6 +18,9 @@ GROUPS locations Explore locations available for Eventarc. + providers + Explore event providers available in Eventarc. + triggers Manage Eventarc triggers. diff --git a/gcloud/eventarc/providers/describe b/gcloud/eventarc/providers/describe new file mode 100644 index 000000000..0ad5e7d0e --- /dev/null +++ b/gcloud/eventarc/providers/describe @@ -0,0 +1,51 @@ +NAME + gcloud eventarc providers describe - describe an Eventarc event provider + +SYNOPSIS + gcloud eventarc providers describe (PROVIDER : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe an Eventarc event provider. + +EXAMPLES + To describe the provider my-provider, run: + + $ gcloud eventarc providers describe my-provider + +POSITIONAL ARGUMENTS + Provider resource - The event provider 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 provider 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. + + PROVIDER + ID of the provider or fully qualified identifier for the provider. To + set the provider attribute: + ▸ provide the argument provider on the command line. + + This positional must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location for the Eventarc provider, which should be either global + or one of the supported regions. Alternatively, set the + [eventarc/location] property. To set the location attribute: + ▸ provide the argument provider on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. diff --git a/gcloud/eventarc/providers/help b/gcloud/eventarc/providers/help new file mode 100644 index 000000000..34a6c8bea --- /dev/null +++ b/gcloud/eventarc/providers/help @@ -0,0 +1,22 @@ +NAME + gcloud eventarc providers - explore event providers available in Eventarc + +SYNOPSIS + gcloud eventarc providers COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Explore event providers available in Eventarc. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe an Eventarc event provider. + + list + List event providers available in Eventarc. diff --git a/gcloud/eventarc/providers/list b/gcloud/eventarc/providers/list new file mode 100644 index 000000000..9cadc0365 --- /dev/null +++ b/gcloud/eventarc/providers/list @@ -0,0 +1,88 @@ +NAME + gcloud eventarc providers list - list event providers available in Eventarc + +SYNOPSIS + gcloud eventarc providers list [--location=LOCATION] [--name=NAME] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List event providers available in Eventarc. + +EXAMPLES + To list all providers in location us-central1, run: + + $ gcloud eventarc providers list --location=us-central1 + + To list all providers in all locations, run: + + $ gcloud eventarc providers list --location=- + + or + + $ gcloud eventarc providers list + +FLAGS + Location resource - The location in which to list event providers. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property eventarc/location with a fully specified name; + ◆ use '-' location to aggregate results for all Eventarc locations with + a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument --location on the command line; + ▸ set the property eventarc/location; + ▸ use '-' location to aggregate results for all Eventarc locations. + + --name=NAME + A provider name (e.g. storage.googleapis.com) List results will be + filtered on this provider. Only exact match of the provider name is + supported. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index 5a63596b3..f92fcf676 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -15,9 +15,11 @@ SYNOPSIS | --remove-build-env-vars=[KEY,...] --update-build-env-vars=[KEY=VALUE,...]] [--build-worker-pool=BUILD_WORKER_POOL | --clear-build-worker-pool] + [--clear-docker-repository | --docker-repository=DOCKER_REPOSITORY] [--clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...]] + [--clear-kms-key | --kms-key=KMS_KEY] [--clear-labels | --remove-labels=[KEY,...]] [--clear-max-instances | --max-instances=MAX_INSTANCES] [--clear-min-instances | --min-instances=MIN_INSTANCES] @@ -290,6 +292,22 @@ FLAGS --clear-build-worker-pool Clears the Cloud Build Custom Worker Pool field. + At most one of these can be specified: + + --clear-docker-repository + Clears the Docker repository configuration of the function. + + --docker-repository=DOCKER_REPOSITORY + Sets the Docker repository to be used for storing the Cloud + Function's Docker images while the function is being deployed. + DOCKER_REPOSITORY must be an Artifact Registry Docker repository + present in the same project and location as the Cloud Function. + + The repository name should match the pattern + projects/${PROJECT}/locations/${LOCATION}/repositories/${REPOSITORY} + where ${PROJECT} is the project, ${LOCATION} is the location of the + repository and ${REPOSITORY} is a valid repository ID. + At most one of these can be specified: --clear-env-vars @@ -313,6 +331,25 @@ FLAGS --update-env-vars=[KEY=VALUE,...] List of key-value pairs to set as environment variables. + At most one of these can be specified: + + --clear-kms-key + Clears the KMS crypto key used to encrypt the function. + + --kms-key=KMS_KEY + Sets the user managed KMS crypto key used to encrypt the Cloud + Function and its resources. + + The KMS crypto key name should match the pattern + projects/${PROJECT}/locations/${LOCATION}/keyRings/${KEYRING}/cryptoKeys/${CRYPTOKEY} + where ${PROJECT} is the project, ${LOCATION} is the location of the + key ring, and ${KEYRING} is the key ring that contains the + ${CRYPTOKEY} crypto key. + + If this flag is set, then a Docker repository created in Artifact + Registry must be specified using the --docker-repository flag and the + repository must be encrypted using the same KMS key. + At most one of these can be specified: --clear-labels diff --git a/gcloud/services/api-keys/list b/gcloud/services/api-keys/list index 663b074d5..26335bf85 100644 --- a/gcloud/services/api-keys/list +++ b/gcloud/services/api-keys/list @@ -2,27 +2,26 @@ NAME gcloud services api-keys list - lists API keys SYNOPSIS - gcloud services api-keys list [--deleted] [--filter=EXPRESSION] + gcloud services api-keys list [--show-deleted] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Lists all of the API keys that are active in a given project. You can add - the state filter state:DELETED to list API keys that were deleted within - past 30 days. + Lists the API keys of a given project. EXAMPLES - List active keys: + List keys of a given project: $ gcloud services api-keys list - List keys that were deleted in the past 30 days of a given project.: + List keys of a given project, including keys that were soft-deleted in the + past 30 days.: - $ gcloud services api-keys list --deleted --project=my_project + $ gcloud services api-keys list --show-deleted --project=my_project FLAGS - --deleted - Return the keys that were deleted in past 30 days + --show-deleted + Show soft-deleted keys by specifying this flag. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/sql/export/bak b/gcloud/sql/export/bak index ade3dbd18..cef032de9 100644 --- a/gcloud/sql/export/bak +++ b/gcloud/sql/export/bak @@ -7,7 +7,7 @@ SYNOPSIS DESCRIPTION Export data from a Cloud SQL instance to a Google Cloud Storage bucket as a - BAK backup file. + BAK backup file. This is only supported for SQL Server. EXAMPLES To export data from the database my-database in the Cloud SQL instance diff --git a/gcloud/sql/operations/describe b/gcloud/sql/operations/describe index 8cfe517c4..20c5313b7 100644 --- a/gcloud/sql/operations/describe +++ b/gcloud/sql/operations/describe @@ -8,6 +8,11 @@ SYNOPSIS DESCRIPTION Retrieves information about a Cloud SQL instance operation. +EXAMPLES + To describe an operation with the name "prod-operation-id", run: + + $ gcloud sql operations describe prod-operation-id + POSITIONAL ARGUMENTS OPERATION Name that uniquely identifies the operation.