From d35819d273bf02a4eee651977327a96f91293ed5 Mon Sep 17 00:00:00 2001 From: Automated Date: Wed, 14 Aug 2024 09:38:18 +0000 Subject: [PATCH] gcloud: Wed Aug 14 09:38:18 UTC 2024 --- gcloud/_version | 10 +- .../certificate-manager/issuance-configs/help | 3 + .../issuance-configs/update | 115 +++++++++++ .../compute/instances/perform-maintenance | 10 +- gcloud/alpha/compute/networks/create | 29 +-- gcloud/alpha/compute/networks/update | 23 +-- gcloud/alpha/firestore/databases/create | 34 ++-- gcloud/alpha/firestore/databases/restore | 29 +-- .../iam/workforce-pools/providers/create-oidc | 3 +- .../iam/workforce-pools/providers/update-oidc | 3 +- .../create-cred-config | 33 +++- gcloud/alpha/ml/speech/recognizers/run-batch | 12 +- gcloud/alpha/ml/speech/recognizers/run-short | 15 +- gcloud/alpha/network-security/help | 9 + .../mirroring-deployment-groups/create | 125 ++++++++++++ .../mirroring-deployment-groups/delete | 90 +++++++++ .../mirroring-deployment-groups/describe | 76 +++++++ .../mirroring-deployment-groups/help | 46 +++++ .../mirroring-deployment-groups/list | 94 +++++++++ .../mirroring-deployment-groups/update | 127 ++++++++++++ .../mirroring-deployments/create | 187 ++++++++++++++++++ .../mirroring-deployments/delete | 82 ++++++++ .../mirroring-deployments/describe | 74 +++++++ .../mirroring-deployments/help | 45 +++++ .../mirroring-deployments/list | 95 +++++++++ .../mirroring-deployments/update | 125 ++++++++++++ .../mirroring-endpoint-groups/create | 147 ++++++++++++++ .../mirroring-endpoint-groups/delete | 88 +++++++++ .../mirroring-endpoint-groups/describe | 73 +++++++ .../mirroring-endpoint-groups/help | 46 +++++ .../mirroring-endpoint-groups/list | 102 ++++++++++ .../mirroring-endpoint-groups/update | 127 ++++++++++++ gcloud/alpha/redis/clusters/create | 12 +- gcloud/alpha/redis/clusters/detach | 83 ++++++++ .../alpha/redis/clusters/detach-secondaries | 96 +++++++++ gcloud/alpha/redis/clusters/help | 9 + gcloud/alpha/redis/clusters/switchover | 84 ++++++++ gcloud/alpha/run/deploy | 8 +- gcloud/alpha/run/services/update | 8 +- .../certificate-manager/issuance-configs/help | 3 + .../issuance-configs/update | 113 +++++++++++ .../compute/instances/perform-maintenance | 10 +- gcloud/beta/compute/networks/create | 47 ++++- gcloud/beta/compute/networks/update | 44 +++++ .../beta/container/fleet/memberships/delete | 2 +- .../beta/container/fleet/memberships/describe | 2 +- gcloud/beta/container/fleet/memberships/list | 2 +- gcloud/beta/container/hub/memberships/delete | 2 +- .../beta/container/hub/memberships/describe | 2 +- gcloud/beta/container/hub/memberships/list | 2 +- gcloud/beta/filestore/instances/create | 37 ++-- gcloud/beta/filestore/instances/update | 107 +++++----- gcloud/beta/firestore/databases/create | 34 ++-- .../iam/workforce-pools/providers/create-oidc | 3 +- .../iam/workforce-pools/providers/update-oidc | 3 +- .../create-cred-config | 33 +++- gcloud/beta/network-security/help | 9 + .../mirroring-deployment-groups/create | 123 ++++++++++++ .../mirroring-deployment-groups/delete | 88 +++++++++ .../mirroring-deployment-groups/describe | 74 +++++++ .../mirroring-deployment-groups/help | 44 +++++ .../mirroring-deployment-groups/list | 92 +++++++++ .../mirroring-deployment-groups/update | 125 ++++++++++++ .../mirroring-deployments/create | 185 +++++++++++++++++ .../mirroring-deployments/delete | 80 ++++++++ .../mirroring-deployments/describe | 72 +++++++ .../mirroring-deployments/help | 43 ++++ .../mirroring-deployments/list | 93 +++++++++ .../mirroring-deployments/update | 123 ++++++++++++ .../mirroring-endpoint-groups/create | 145 ++++++++++++++ .../mirroring-endpoint-groups/delete | 86 ++++++++ .../mirroring-endpoint-groups/describe | 71 +++++++ .../mirroring-endpoint-groups/help | 43 ++++ .../mirroring-endpoint-groups/list | 100 ++++++++++ .../mirroring-endpoint-groups/update | 125 ++++++++++++ gcloud/beta/redis/clusters/create | 12 +- gcloud/beta/redis/clusters/detach | 81 ++++++++ gcloud/beta/redis/clusters/detach-secondaries | 94 +++++++++ gcloud/beta/redis/clusters/help | 9 + gcloud/beta/redis/clusters/switchover | 82 ++++++++ gcloud/beta/run/deploy | 13 +- gcloud/beta/run/services/update | 13 +- .../certificate-manager/issuance-configs/help | 3 + .../issuance-configs/update | 111 +++++++++++ gcloud/compute/instances/perform-maintenance | 10 +- .../connection-profiles/create/cloudsql | 6 +- .../database-migration/migration-jobs/create | 14 +- .../database-migration/migration-jobs/update | 13 +- gcloud/filestore/instances/create | 37 ++-- gcloud/filestore/instances/update | 107 +++++----- gcloud/firestore/databases/create | 34 ++-- .../iam/workforce-pools/providers/create-oidc | 3 +- .../iam/workforce-pools/providers/create-saml | 3 +- .../iam/workforce-pools/providers/update-oidc | 3 +- .../iam/workforce-pools/providers/update-saml | 3 +- .../create-cred-config | 33 +++- gcloud/network-security/address-groups/create | 7 +- gcloud/network-security/address-groups/update | 6 +- gcloud/redis/clusters/create | 13 +- gcloud/redis/clusters/detach | 80 ++++++++ gcloud/redis/clusters/detach-secondaries | 93 +++++++++ gcloud/redis/clusters/help | 9 + gcloud/redis/clusters/switchover | 81 ++++++++ gcloud/workstations/configs/create | 35 +++- gcloud/workstations/configs/update | 35 +++- 105 files changed, 5241 insertions(+), 346 deletions(-) create mode 100644 gcloud/alpha/certificate-manager/issuance-configs/update create mode 100644 gcloud/alpha/network-security/mirroring-deployment-groups/create create mode 100644 gcloud/alpha/network-security/mirroring-deployment-groups/delete create mode 100644 gcloud/alpha/network-security/mirroring-deployment-groups/describe create mode 100644 gcloud/alpha/network-security/mirroring-deployment-groups/help create mode 100644 gcloud/alpha/network-security/mirroring-deployment-groups/list create mode 100644 gcloud/alpha/network-security/mirroring-deployment-groups/update create mode 100644 gcloud/alpha/network-security/mirroring-deployments/create create mode 100644 gcloud/alpha/network-security/mirroring-deployments/delete create mode 100644 gcloud/alpha/network-security/mirroring-deployments/describe create mode 100644 gcloud/alpha/network-security/mirroring-deployments/help create mode 100644 gcloud/alpha/network-security/mirroring-deployments/list create mode 100644 gcloud/alpha/network-security/mirroring-deployments/update create mode 100644 gcloud/alpha/network-security/mirroring-endpoint-groups/create create mode 100644 gcloud/alpha/network-security/mirroring-endpoint-groups/delete create mode 100644 gcloud/alpha/network-security/mirroring-endpoint-groups/describe create mode 100644 gcloud/alpha/network-security/mirroring-endpoint-groups/help create mode 100644 gcloud/alpha/network-security/mirroring-endpoint-groups/list create mode 100644 gcloud/alpha/network-security/mirroring-endpoint-groups/update create mode 100644 gcloud/alpha/redis/clusters/detach create mode 100644 gcloud/alpha/redis/clusters/detach-secondaries create mode 100644 gcloud/alpha/redis/clusters/switchover create mode 100644 gcloud/beta/certificate-manager/issuance-configs/update create mode 100644 gcloud/beta/network-security/mirroring-deployment-groups/create create mode 100644 gcloud/beta/network-security/mirroring-deployment-groups/delete create mode 100644 gcloud/beta/network-security/mirroring-deployment-groups/describe create mode 100644 gcloud/beta/network-security/mirroring-deployment-groups/help create mode 100644 gcloud/beta/network-security/mirroring-deployment-groups/list create mode 100644 gcloud/beta/network-security/mirroring-deployment-groups/update create mode 100644 gcloud/beta/network-security/mirroring-deployments/create create mode 100644 gcloud/beta/network-security/mirroring-deployments/delete create mode 100644 gcloud/beta/network-security/mirroring-deployments/describe create mode 100644 gcloud/beta/network-security/mirroring-deployments/help create mode 100644 gcloud/beta/network-security/mirroring-deployments/list create mode 100644 gcloud/beta/network-security/mirroring-deployments/update create mode 100644 gcloud/beta/network-security/mirroring-endpoint-groups/create create mode 100644 gcloud/beta/network-security/mirroring-endpoint-groups/delete create mode 100644 gcloud/beta/network-security/mirroring-endpoint-groups/describe create mode 100644 gcloud/beta/network-security/mirroring-endpoint-groups/help create mode 100644 gcloud/beta/network-security/mirroring-endpoint-groups/list create mode 100644 gcloud/beta/network-security/mirroring-endpoint-groups/update create mode 100644 gcloud/beta/redis/clusters/detach create mode 100644 gcloud/beta/redis/clusters/detach-secondaries create mode 100644 gcloud/beta/redis/clusters/switchover create mode 100644 gcloud/certificate-manager/issuance-configs/update create mode 100644 gcloud/redis/clusters/detach create mode 100644 gcloud/redis/clusters/detach-secondaries create mode 100644 gcloud/redis/clusters/switchover diff --git a/gcloud/_version b/gcloud/_version index f28bd1253..47e351f87 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 487.0.0 -alpha 2024.08.06 -beta 2024.08.06 -bq 2.1.7 +Google Cloud SDK 488.0.0 +alpha 2024.08.09 +beta 2024.08.09 +bq 2.1.8 bundled-python3-unix 3.11.9 -core 2024.08.06 +core 2024.08.09 gcloud-crc32c 1.0.0 gsutil 5.30 diff --git a/gcloud/alpha/certificate-manager/issuance-configs/help b/gcloud/alpha/certificate-manager/issuance-configs/help index e738417d1..caac8b936 100644 --- a/gcloud/alpha/certificate-manager/issuance-configs/help +++ b/gcloud/alpha/certificate-manager/issuance-configs/help @@ -29,6 +29,9 @@ COMMANDS list (ALPHA) List all Certificate Issuance Configs in a project. + update + (ALPHA) Update a Certificate Issuance Config. + NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct diff --git a/gcloud/alpha/certificate-manager/issuance-configs/update b/gcloud/alpha/certificate-manager/issuance-configs/update new file mode 100644 index 000000000..7ddc4aff9 --- /dev/null +++ b/gcloud/alpha/certificate-manager/issuance-configs/update @@ -0,0 +1,115 @@ +NAME + gcloud alpha certificate-manager issuance-configs update - update a + Certificate Issuance Config + +SYNOPSIS + gcloud alpha certificate-manager issuance-configs update + (CERTIFICATE_ISSUANCE_CONFIG : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a Certificate Issuance Config. + +EXAMPLES + To update a Certificate Issuance Config called my-cic, run: + + $ gcloud alpha certificate-manager issuance-configs update my-cic \ + --description="updated description" \ + --update-labels=my-key1=my-updated-value1 \ + --remove-labels=my-key2 + +POSITIONAL ARGUMENTS + CertificateIssuanceConfig resource - Name of the Certificate Issuance + Config to update. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument certificate_issuance_config 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. + + CERTIFICATE_ISSUANCE_CONFIG + ID of the certificateIssuanceConfig or fully qualified identifier for + the certificateIssuanceConfig. + + To set the certificate_issuance_config attribute: + ▸ provide the argument certificate_issuance_config on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Certificate Manager location. + + To set the location attribute: + ▸ provide the argument certificate_issuance_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Human-readable description of the resource. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud alpha certificate-manager issuance-configs update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud alpha certificate-manager issuance-configs update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud certificate-manager issuance-configs update + + $ gcloud beta certificate-manager issuance-configs update + diff --git a/gcloud/alpha/compute/instances/perform-maintenance b/gcloud/alpha/compute/instances/perform-maintenance index a75d8a8a8..b322818b7 100644 --- a/gcloud/alpha/compute/instances/perform-maintenance +++ b/gcloud/alpha/compute/instances/perform-maintenance @@ -3,8 +3,8 @@ NAME Google Compute Engine instance SYNOPSIS - gcloud alpha compute instances perform-maintenance INSTANCE_NAME - [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + gcloud alpha compute instances perform-maintenance INSTANCE_NAMES + [INSTANCE_NAMES ...] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Perform maintenance of Google Compute Engine instance. @@ -17,14 +17,14 @@ EXAMPLES --zone=us-east1-d POSITIONAL ARGUMENTS - INSTANCE_NAME - Name of the instance to operate on. For details on valid instance + INSTANCE_NAMES [INSTANCE_NAMES ...] + Names of the instances to operate on. For details on valid instance names, refer to the criteria documented under the field 'name' at: https://cloud.google.com/compute/docs/reference/rest/v1/instances FLAGS --zone=ZONE - Zone of the instance to operate on. If not specified, you might be + Zone of the instances to operate on. If not specified, you might be prompted to select a zone (interactive mode only). gcloud attempts to identify the appropriate zone by searching for resources in your currently active project. If the zone cannot be determined, gcloud diff --git a/gcloud/alpha/compute/networks/create b/gcloud/alpha/compute/networks/create index acc392b3d..c187155c4 100644 --- a/gcloud/alpha/compute/networks/create +++ b/gcloud/alpha/compute/networks/create @@ -7,7 +7,8 @@ SYNOPSIS [--description=DESCRIPTION] [--[no-]enable-ula-internal-ipv6] [--internal-ipv6-range=INTERNAL_IPV6_RANGE] [--mtu=MTU] [--network-firewall-policy-enforcement-order=NETWORK_FIREWALL_POLICY_ENFORCEMENT_ORDER] - [--range=RANGE] [--subnet-mode=MODE] + [--network-profile=NETWORK_PROFILE] [--range=RANGE] + [--subnet-mode=MODE] [--bgp-best-path-selection-mode=BGP_BEST_PATH_SELECTION_MODE --[no-]bgp-bps-always-compare-med --bgp-bps-inter-region-cost=BGP_BPS_INTER_REGION_COST] @@ -75,6 +76,9 @@ FLAGS BEFORE_CLASSIC_FIREWALL Network Firewall Policy is enforced before classic firewall. + --network-profile=NETWORK_PROFILE + The network profile to apply to this network. + --range=RANGE Specifies the IPv4 address range of legacy mode networks. The range must be specified in CIDR format: @@ -104,13 +108,14 @@ FLAGS BGP Best Path Selection flags --bgp-best-path-selection-mode=BGP_BEST_PATH_SELECTION_MODE - The BGP best selection algorithm to be employed. MODE can be LEGACY - or STANDARD. BGP_BEST_PATH_SELECTION_MODE must be one of: + The BGP best path selection algorithm to be employed. MODE can be + LEGACY or STANDARD. BGP_BEST_PATH_SELECTION_MODE must be one of: LEGACY - Dynamic routes are ranked based on MED BGP attribute. When global - routing is enabled, MED of the routes received from other regions - is original MED plus region-to-region cost. + Dynamic routes are ranked based on the multiple + exit-discriminator (MED) BGP attribute. When global routing is + enabled, the MED of the routes received from other regions is the + original MED plus the region-to-region cost. STANDARD Dynamic routes are ranked based on AS Path, Origin, Neighbor ASN and MED BGP attributes. When global routing is enabled, @@ -121,25 +126,25 @@ FLAGS --[no-]bgp-bps-always-compare-med Enables/disables the comparison of MED across routes with different - NeighborAsn. This value can only be set if the + Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD. Use --bgp-bps-always-compare-med to enable and --no-bgp-bps-always-compare-med to disable. --bgp-bps-inter-region-cost=BGP_BPS_INTER_REGION_COST - Allows to define preferred approach for handling inter-region cost in - the selection process. This value can only be set if the + Defines the preferred approach for handling inter-region cost in the + selection process. This value can only be set if the --bgp-best-path-selection-mode is STANDARD. BGP_BPS_INTER_REGION_COST must be one of: ADD_COST_TO_MED - Adds inter-region cost to the MED before comparing MED value. + Adds inter-region cost to the MED before comparing the MED value. When multiple routes have the same value after the Add-cost-to-med comparison, the route selection continues and prefers the route with lowest cost. DEFAULT - MED is compared as originally received from peers. Cost is - evaluated as a next step when MED is the same. + MED is compared as originally received from peers. When multiple + routes have the same MED, cost is evaluated as the next step. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/compute/networks/update b/gcloud/alpha/compute/networks/update index 896059dd4..b67fe72f1 100644 --- a/gcloud/alpha/compute/networks/update +++ b/gcloud/alpha/compute/networks/update @@ -60,13 +60,14 @@ FLAGS BGP Best Path Selection flags --bgp-best-path-selection-mode=BGP_BEST_PATH_SELECTION_MODE - The BGP best selection algorithm to be employed. MODE can be LEGACY - or STANDARD. BGP_BEST_PATH_SELECTION_MODE must be one of: + The BGP best path selection algorithm to be employed. MODE can be + LEGACY or STANDARD. BGP_BEST_PATH_SELECTION_MODE must be one of: LEGACY - Dynamic routes are ranked based on MED BGP attribute. When global - routing is enabled, MED of the routes received from other regions - is original MED plus region-to-region cost. + Dynamic routes are ranked based on the multiple + exit-discriminator (MED) BGP attribute. When global routing is + enabled, the MED of the routes received from other regions is the + original MED plus the region-to-region cost. STANDARD Dynamic routes are ranked based on AS Path, Origin, Neighbor ASN and MED BGP attributes. When global routing is enabled, @@ -77,25 +78,25 @@ FLAGS --[no-]bgp-bps-always-compare-med Enables/disables the comparison of MED across routes with different - NeighborAsn. This value can only be set if the + Neighbor ASNs. This value can only be set if the --bgp-best-path-selection-mode is STANDARD. Use --bgp-bps-always-compare-med to enable and --no-bgp-bps-always-compare-med to disable. --bgp-bps-inter-region-cost=BGP_BPS_INTER_REGION_COST - Allows to define preferred approach for handling inter-region cost in - the selection process. This value can only be set if the + Defines the preferred approach for handling inter-region cost in the + selection process. This value can only be set if the --bgp-best-path-selection-mode is STANDARD. BGP_BPS_INTER_REGION_COST must be one of: ADD_COST_TO_MED - Adds inter-region cost to the MED before comparing MED value. + Adds inter-region cost to the MED before comparing the MED value. When multiple routes have the same value after the Add-cost-to-med comparison, the route selection continues and prefers the route with lowest cost. DEFAULT - MED is compared as originally received from peers. Cost is - evaluated as a next step when MED is the same. + MED is compared as originally received from peers. When multiple + routes have the same MED, cost is evaluated as the next step. At most one of these can be specified: diff --git a/gcloud/alpha/firestore/databases/create b/gcloud/alpha/firestore/databases/create index b9f7d6a3e..196a46010 100644 --- a/gcloud/alpha/firestore/databases/create +++ b/gcloud/alpha/firestore/databases/create @@ -57,39 +57,43 @@ OPTIONAL FLAGS of the database's resource name. If database ID is not provided, (default) will be used as database ID. - This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/ - with first character a letter and the last a letter or a number. Must - not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. + This value should be 4-63 characters. Valid characters are + /[a-z][0-9]-/ with first character a letter and the last a letter or a + number. Must not be UUID-like + /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. - Using "(default)" database ID is also allowed. + Using "(default)" database ID is also allowed. --delete-protection Whether to enable delete protection on the created database. - If set to true, delete protection of the new database will be enabled - and delete operations will fail unless delete protection is disabled. + If set to true, delete protection of the new database will be enabled + and delete operations will fail unless delete protection is disabled. - Default to false. + Default to false. --enable-pitr Whether to enable Point In Time Recovery (PITR) on the created database. - If set to true, PITR on the new database will be enabled. By default, - this feature is not enabled. + If set to true, PITR on the new database will be enabled. By default, + this feature is not enabled. --kms-key-name=KMS_KEY_NAME The resource ID of a Cloud KMS key. If set, the database created will be a Customer-Managed Encryption Key (CMEK) database encrypted with this key. This feature is allowlist only in initial launch. - Only a key in the same location as this database is allowed to be used for encryption. - For Firestore's nam5 multi-region, this corresponds to Cloud KMS location us. - For Firestore's eur3 multi-region, this corresponds to Cloud KMS location europe. - See https://cloud.google.com/kms/docs/locations. + Only a key in the same location as this database is allowed to be used + for encryption. For Firestore's nam5 multi-region, this corresponds to + Cloud KMS location us. For Firestore's eur3 multi-region, this + corresponds to Cloud KMS location europe. See + https://cloud.google.com/kms/docs/locations. - This value should be the KMS key resource ID in the format of `projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`. - How to retrieve this resource ID is listed at https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. + This value should be the KMS key resource ID in the format of + projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}. + How to retrieve this resource ID is listed at + https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. --type=TYPE; default="firestore-native" The type of the database. TYPE must be one of: firestore-native, diff --git a/gcloud/alpha/firestore/databases/restore b/gcloud/alpha/firestore/databases/restore index 56854974a..ba71eec22 100644 --- a/gcloud/alpha/firestore/databases/restore +++ b/gcloud/alpha/firestore/databases/restore @@ -56,22 +56,22 @@ OPTIONAL FLAGS The encryption configuration of the restored database. If not specified, the same encryption settings as the backup will be used. - To restore to a CMEK-enabled database: + To restore to a CMEK-enabled database: $ gcloud alpha firestore databases restore \ - --encryption-type=customer-managed-encryption \ - --kms-key-name=projects/PROJECT_ID/locations/LOCATION_ID/\ + --encryption-type=customer-managed-encryption \ + --kms-key-name=projects/PROJECT_ID/locations/LOCATION_ID/\ keyRings/KEY_RING_ID/cryptoKeys/CRYPTO_KEY_ID - To restore to a Google-default-encrypted database: + To restore to a Google-default-encrypted database: $ gcloud alpha firestore databases restore \ - --encryption-type=google-default-encryption + --encryption-type=google-default-encryption - To restore to a database using the same encryption settings as the backup: + To restore to a database using the same encryption settings as the backup: $ gcloud alpha firestore databases restore \ - --encryption-type=backup-encryption + --encryption-type=backup-encryption --encryption-type=ENCRYPTION_TYPE The encryption type of the destination database. ENCRYPTION_TYPE must @@ -86,13 +86,16 @@ OPTIONAL FLAGS be a Customer-Managed Encryption Key (CMEK) database encrypted with this key. This feature is allowlist only in initial launch. - Only a key in the same location as this database is allowed to be used for encryption. - For Firestore's nam5 multi-region, this corresponds to Cloud KMS location us. - For Firestore's eur3 multi-region, this corresponds to Cloud KMS location europe. - See https://cloud.google.com/kms/docs/locations. + Only a key in the same location as this database is allowed to be + used for encryption. For Firestore's nam5 multi-region, this + corresponds to Cloud KMS location us. For Firestore's eur3 + multi-region, this corresponds to Cloud KMS location europe. See + https://cloud.google.com/kms/docs/locations. - This value should be the KMS key resource ID in the format of `projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`. - How to retrieve this resource ID is listed at https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. + This value should be the KMS key resource ID in the format of + projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}. + How to retrieve this resource ID is listed at + https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. This flag must only be specified when encryption-type is customer-managed-encryption. diff --git a/gcloud/alpha/iam/workforce-pools/providers/create-oidc b/gcloud/alpha/iam/workforce-pools/providers/create-oidc index f21a95392..8d8a23303 100644 --- a/gcloud/alpha/iam/workforce-pools/providers/create-oidc +++ b/gcloud/alpha/iam/workforce-pools/providers/create-oidc @@ -31,7 +31,8 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --attribute-mapping="google.subject=assertion.sub" \ + --disabled --detailed_audit_logging \ + --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ --issuer-uri="https://test-idp.com" \ diff --git a/gcloud/alpha/iam/workforce-pools/providers/update-oidc b/gcloud/alpha/iam/workforce-pools/providers/update-oidc index 252ed508e..821be1509 100644 --- a/gcloud/alpha/iam/workforce-pools/providers/update-oidc +++ b/gcloud/alpha/iam/workforce-pools/providers/update-oidc @@ -31,7 +31,8 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --attribute-mapping="google.subject=assertion.sub" \ + --disabled --detailed_audit_logging \ + --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ --issuer-uri="https://test-idp.com" \ diff --git a/gcloud/alpha/iam/workload-identity-pools/create-cred-config b/gcloud/alpha/iam/workload-identity-pools/create-cred-config index 9645b32e6..ab574d251 100644 --- a/gcloud/alpha/iam/workload-identity-pools/create-cred-config +++ b/gcloud/alpha/iam/workload-identity-pools/create-cred-config @@ -5,13 +5,16 @@ NAME SYNOPSIS gcloud alpha iam workload-identity-pools create-cred-config AUDIENCE --output-file=OUTPUT_FILE - (--aws | --azure | --credential-source-file=CREDENTIAL_SOURCE_FILE + (--aws | --azure | --credential-cert-path=CREDENTIAL_CERT_PATH + | --credential-source-file=CREDENTIAL_SOURCE_FILE | --credential-source-url=CREDENTIAL_SOURCE_URL | --executable-command=EXECUTABLE_COMMAND) [--app-id-uri=APP_ID_URI] [--credential-source-field-name=CREDENTIAL_SOURCE_FIELD_NAME] [--credential-source-headers=[key=value,...]] [--credential-source-type=CREDENTIAL_SOURCE_TYPE] [--enable-imdsv2] [--subject-token-type=SUBJECT_TOKEN_TYPE] + [--credential-cert-private-key-path=CREDENTIAL_CERT_PRIVATE_KEY_PATH + : --credential-cert-configuration-output-file=CREDENTIAL_CERT_CONFIGURATION_OUTPUT_FILE] [--executable-output-file=EXECUTABLE_OUTPUT_FILE --executable-timeout-millis=EXECUTABLE_TIMEOUT_MILLIS] [--service-account=SERVICE_ACCOUNT @@ -69,6 +72,17 @@ EXAMPLES --app-id-uri=$URI_FOR_AZURE_APP_ID \ --output-file=credentials.json + To create an X.509 certificate-based credential configuration for your + project, run: + + $ gcloud alpha iam workload-identity-pools create-cred-config \ + projects/$PROJECT_NUMBER/locations/$REGION/\ + workloadIdentityPools/$WORKLOAD_POOL_ID/providers/$PROVIDER_ID \ + --service-account=$EMAIL \ + --credential-cert-path=$PATH_TO_CERTIFICATE_FILE \ + --credential-cert-private-key-path=$PATH_TO_PRIVATE_KEY_FILE \ + --output-file=credentials.json + To use the resulting file for any of these commands, set the GOOGLE_APPLICATION_CREDENTIALS environment variable to point to the generated file @@ -91,6 +105,9 @@ REQUIRED FLAGS --azure Use Azure. + --credential-cert-path=CREDENTIAL_CERT_PATH + Path of the X.509 certificate file. + --credential-source-file=CREDENTIAL_SOURCE_FILE Location of the credential source file. @@ -122,6 +139,20 @@ OPTIONAL FLAGS The type of token being used for authorization. This defaults to urn:ietf:params:oauth:token-type:jwt. + Arguments for an X.509 certificate type credential source. + + --credential-cert-private-key-path=CREDENTIAL_CERT_PRIVATE_KEY_PATH + Path of the X.509 private key file. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --credential-cert-configuration-output-file=CREDENTIAL_CERT_CONFIGURATION_OUTPUT_FILE + Path for the certificate configuration file. If specified, a + certificate configuration file will be created at the specified path. + If not specified, the certificate configuration will be created at + the default gcloud location. + Arguments for an executable type credential source. --executable-output-file=EXECUTABLE_OUTPUT_FILE diff --git a/gcloud/alpha/ml/speech/recognizers/run-batch b/gcloud/alpha/ml/speech/recognizers/run-batch index c0653288b..e92b0c70a 100644 --- a/gcloud/alpha/ml/speech/recognizers/run-batch +++ b/gcloud/alpha/ml/speech/recognizers/run-batch @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud alpha ml speech recognizers run-batch (RECOGNIZER : --location=LOCATION) --audio=AUDIO [--async] - [--hints=[HINTS,...]] [--language-codes=[LANGUAGE_CODE,...]] + [--hint-boost=HINT_BOOST] [--hint-phrase-sets=[PHRASE_SET,...]] + [--hint-phrases=[PHRASE,...]] [--language-codes=[LANGUAGE_CODE,...]] [--model=MODEL] [--audio-channel-count=AUDIO_CHANNEL_COUNT --encoding=ENCODING --sample-rate=SAMPLE_RATE] @@ -62,7 +63,14 @@ OPTIONAL FLAGS Return immediately, without waiting for the operation in progress to complete. The default is False. - --hints=[HINTS,...] + --hint-boost=HINT_BOOST + Boost value for the phrases passed to --phrases. Can have a value + between 1 and 20. + + --hint-phrase-sets=[PHRASE_SET,...] + A list of phrase set resource names to use for speech recognition. + + --hint-phrases=[PHRASE,...] A list of strings containing word and phrase "hints" so that the ' 'speech recognition is more likely to recognize them. This can be ' 'used to improve the accuracy for specific words and phrases, ' 'for diff --git a/gcloud/alpha/ml/speech/recognizers/run-short b/gcloud/alpha/ml/speech/recognizers/run-short index 7e573d154..0fdafa51f 100644 --- a/gcloud/alpha/ml/speech/recognizers/run-short +++ b/gcloud/alpha/ml/speech/recognizers/run-short @@ -4,8 +4,10 @@ NAME SYNOPSIS gcloud alpha ml speech recognizers run-short - (RECOGNIZER : --location=LOCATION) --audio=AUDIO [--hints=[HINTS,...]] - [--language-codes=[LANGUAGE_CODE,...]] [--model=MODEL] + (RECOGNIZER : --location=LOCATION) --audio=AUDIO + [--hint-boost=HINT_BOOST] [--hint-phrase-sets=[PHRASE_SET,...]] + [--hint-phrases=[PHRASE,...]] [--language-codes=[LANGUAGE_CODE,...]] + [--model=MODEL] [--audio-channel-count=AUDIO_CHANNEL_COUNT --encoding=ENCODING --sample-rate=SAMPLE_RATE] [--[no-]enable-automatic-punctuation --[no-]enable-spoken-emojis @@ -57,7 +59,14 @@ REQUIRED FLAGS gs://bucket/object). OPTIONAL FLAGS - --hints=[HINTS,...] + --hint-boost=HINT_BOOST + Boost value for the phrases passed to --phrases. Can have a value + between 1 and 20. + + --hint-phrase-sets=[PHRASE_SET,...] + A list of phrase set resource names to use for speech recognition. + + --hint-phrases=[PHRASE,...] A list of strings containing word and phrase "hints" so that the ' 'speech recognition is more likely to recognize them. This can be ' 'used to improve the accuracy for specific words and phrases, ' 'for diff --git a/gcloud/alpha/network-security/help b/gcloud/alpha/network-security/help index 8ac8c8dad..6b3878e7f 100644 --- a/gcloud/alpha/network-security/help +++ b/gcloud/alpha/network-security/help @@ -33,6 +33,15 @@ GROUPS gateway-security-policies (ALPHA) Manage Network Security Gateway Security Policies. + mirroring-deployment-groups + (ALPHA) Manage Mirroring Deployment Group resources. + + mirroring-deployments + (ALPHA) Manage Mirroing Deployment resources. + + mirroring-endpoint-groups + (ALPHA) Manage Mirroring Endpoint Group resources. + org-address-groups (ALPHA) Manage Network Security AddressGroups. diff --git a/gcloud/alpha/network-security/mirroring-deployment-groups/create b/gcloud/alpha/network-security/mirroring-deployment-groups/create new file mode 100644 index 000000000..8b5f4bb9c --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployment-groups/create @@ -0,0 +1,125 @@ +NAME + gcloud alpha network-security mirroring-deployment-groups create - create a + Mirroring Deployment Group + +SYNOPSIS + gcloud alpha network-security mirroring-deployment-groups create + (MIRRORING_DEPLOYMENT_GROUP : --location=LOCATION) --network=NETWORK + [--async] [--labels=[KEY=VALUE,...]] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a mirroring deployment group. Successful creation of a + deployment group results in a deployment group in ACTIVE state. Check the + progress of deployment group creation by using gcloud network-security + mirroring-deployment-groups list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To create a mirroring deployment group called my-deployment-group, in + project ID my-project, run: $ gcloud alpha network-security mirroring-deployment-groups create \ + my-deployment-group --project=my-project --location=global \ + --network=my-network + + OR + + $ gcloud alpha network-security mirroring-deployment-groups create \ + my-deployment-group --project=my-project --location=global \ + --network=projects/my-project/global/networks/my-network + + OR + + $ gcloud alpha network-security mirroring-deployment-groups create \ + projects/my-project/locations/global/mirroringDeploymentGroups/\ + my-deployment-group \ + --network=projects/my-project/global/networks/my-network + +POSITIONAL ARGUMENTS + Mirroring deployment group resource - Mirroring Deployment Group. 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 MIRRORING_DEPLOYMENT_GROUP 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. + + MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the deployment-group-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + Network resource - Mirroring Deployment Group. 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 --network 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. + + --network=NETWORK + ID of the network or fully qualified identifier for the network. + + To set the network-name attribute: + ▸ provide the argument --network on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployment-groups create + diff --git a/gcloud/alpha/network-security/mirroring-deployment-groups/delete b/gcloud/alpha/network-security/mirroring-deployment-groups/delete new file mode 100644 index 000000000..ebe3176d8 --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployment-groups/delete @@ -0,0 +1,90 @@ +NAME + gcloud alpha network-security mirroring-deployment-groups delete - delete a + Mirroring Deployment Group + +SYNOPSIS + gcloud alpha network-security mirroring-deployment-groups delete + (MIRRORING_DEPLOYMENT_GROUP : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a mirroring deployment group. Check the progress of + deployment group deletion by using gcloud network-security + mirroring-deployment-groups list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To delete a mirroring deployment group called my-deployment-group, in + project ID my-project, run: + + $ gcloud alpha network-security mirroring-deployment-groups delete \ + my-deployment-group --project=my-project --location=global + + OR + + $ gcloud alpha network-security mirroring-deployment-groups delete \ + projects/my-project/locations/global/mirroringDeploymentGroups/\ + my-deployment-group + +POSITIONAL ARGUMENTS + Mirroring deployment group resource - Mirroring Deployment Group. 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 MIRRORING_DEPLOYMENT_GROUP 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. + + MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the deployment-group-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployment-groups delete + diff --git a/gcloud/alpha/network-security/mirroring-deployment-groups/describe b/gcloud/alpha/network-security/mirroring-deployment-groups/describe new file mode 100644 index 000000000..4b6e01dc6 --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployment-groups/describe @@ -0,0 +1,76 @@ +NAME + gcloud alpha network-security mirroring-deployment-groups describe - + describe a Mirroring Deployment Group + +SYNOPSIS + gcloud alpha network-security mirroring-deployment-groups describe + (MIRRORING_DEPLOYMENT_GROUP : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a mirroring deployment group. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To get a description of a mirroring deployment group called + my-deployment-group in project ID my-project, run: + + $ gcloud alpha network-security mirroring-deployment-groups \ describe my-deployment-group --project=my-project \ + --location=global + + OR + + $ gcloud alpha network-security mirroring-deployment-groups \ describe \ + projects/my-project/locations/global/mirroringDeploymentGroups/\ + my-deployment-group + +POSITIONAL ARGUMENTS + Mirroring deployment group resource - Mirroring Deployment Group. 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 MIRRORING_DEPLOYMENT_GROUP 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. + + MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the deployment-group-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployment-groups describe + diff --git a/gcloud/alpha/network-security/mirroring-deployment-groups/help b/gcloud/alpha/network-security/mirroring-deployment-groups/help new file mode 100644 index 000000000..93866d81e --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployment-groups/help @@ -0,0 +1,46 @@ +NAME + gcloud alpha network-security mirroring-deployment-groups - manage + Mirroring Deployment Group resources + +SYNOPSIS + gcloud alpha network-security mirroring-deployment-groups COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This class provides commands for managing Mirroring Deployment + Groups. + + Attributes: category (str): The category under which this command group + falls. + +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 Mirroring Deployment Group. + + delete + (ALPHA) Delete a Mirroring Deployment Group. + + describe + (ALPHA) Describe a Mirroring Deployment Group. + + list + (ALPHA) List Mirroring Deployment Groups. + + update + (ALPHA) Update a Mirroring Deployment Group. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployment-groups + diff --git a/gcloud/alpha/network-security/mirroring-deployment-groups/list b/gcloud/alpha/network-security/mirroring-deployment-groups/list new file mode 100644 index 000000000..1788d936d --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployment-groups/list @@ -0,0 +1,94 @@ +NAME + gcloud alpha network-security mirroring-deployment-groups list - list + Mirroring Deployment Groups + +SYNOPSIS + gcloud alpha network-security mirroring-deployment-groups list + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List mirroring deployment groups. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list mirroring deployment groups in project ID my-project, run: + + $ gcloud alpha network-security mirroring-deployment-groups list \ + --location=global --project=my-project + + OR + + $ gcloud alpha network-security mirroring-deployment-groups list \ + --location=global + +FLAGS + Location resource - The location for a list operation This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ Location of the Mirroring Deployment Group. Defaults to global with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ Location of the Mirroring Deployment Group. Defaults to global. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployment-groups list + diff --git a/gcloud/alpha/network-security/mirroring-deployment-groups/update b/gcloud/alpha/network-security/mirroring-deployment-groups/update new file mode 100644 index 000000000..fe6d0a617 --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployment-groups/update @@ -0,0 +1,127 @@ +NAME + gcloud alpha network-security mirroring-deployment-groups update - update a + Mirroring Deployment Group + +SYNOPSIS + gcloud alpha network-security mirroring-deployment-groups update + (MIRRORING_DEPLOYMENT_GROUP : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a mirroring deployment group. Check the progress of + deployment group update by using gcloud network-security + mirroring-deployment-groups list. + + For examples refer to the EXAMPLES section below. + +EXAMPLES + To update labels k1 and k2, run: + + $ gcloud alpha network-security mirroring-deployment-groups update \ + my-deployment-group --project=my-project --location=global \ + --update-labels=k1=v1,k2=v2 + + To remove labels k3 and k4, run: + + $ gcloud alpha network-security mirroring-deployment-groups update \ + my-deployment-group --project=my-project --location=global \ + --remove-labels=k3,k4 + + To clear all labels from the mirroring deployment group, run: + + $ gcloud alpha network-security mirroring-deployment-groups update \ + my-deployment-group --project=my-project --location=global \ + --clear-labels + +POSITIONAL ARGUMENTS + Mirroring deployment group resource - Mirroring Deployment Group. 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 MIRRORING_DEPLOYMENT_GROUP 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. + + MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the deployment-group-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud alpha network-security mirroring-deployment-groups update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud alpha network-security mirroring-deployment-groups update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployment-groups update + diff --git a/gcloud/alpha/network-security/mirroring-deployments/create b/gcloud/alpha/network-security/mirroring-deployments/create new file mode 100644 index 000000000..5b3902de4 --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployments/create @@ -0,0 +1,187 @@ +NAME + gcloud alpha network-security mirroring-deployments create - create a + Mirroring Deployment + +SYNOPSIS + gcloud alpha network-security mirroring-deployments create + (MIRRORING_DEPLOYMENT : --location=LOCATION) + (--forwarding-rule=FORWARDING_RULE + : --forwarding-rule-location=FORWARDING_RULE_LOCATION) + (--mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP + : --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION) + [--async] [--labels=[KEY=VALUE,...]] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a mirroring deployment. Successful creation of a deployment + results in a deployment in ACTIVE state. Check the progress of deployment + creation by using gcloud network-security mirroring-deployments list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To create a mirroring deployment called my-deployment, in project ID + my-project and zone us-central1-a, run: $ gcloud alpha network-security mirroring-deployments create \ + my-deployment --project=my-project --location=us-central1-a \ + --deployment-group-location=global \ + --forwarding-rule=my-forwarding-rule \ + --forwarding-rule-location=us-central1 \ + --mirroring-deployment-group=my-deployment-group + + OR + + $ gcloud alpha network-security mirroring-deployments create \ + my-deployment --project=my-project --location=us-central1-a \ + --forwarding-rule=projects/my-project/regions/us-central1/\ + forwardingRules/my-forwarding-rule \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/mirroringDeploymentGroups/my-deployment-group + + OR + + $ gcloud alpha network-security mirroring-deployments create \ + projects/my-project/locations/us-central1/mirroringDeployments/\ + my-deployment \ + --forwarding-rule=projects/my-project/regions/us-central1/\ + forwardingRules/my-forwarding-rule \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/mirroringDeploymentGroups/my-deployment-group + +POSITIONAL ARGUMENTS + Mirroring deployment resource - Mirroring Deployment. 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 MIRRORING_DEPLOYMENT 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. + + MIRRORING_DEPLOYMENT + ID of the mirroring deployment or fully qualified identifier for the + mirroring deployment. + + To set the deployment-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + ForwardingRule resource - Mirroring Deployment Forwarding Rule. 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 --forwarding-rule 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. + + --forwarding-rule=FORWARDING_RULE + ID of the forwardingRule or fully qualified identifier for the + forwardingRule. + + To set the forwarding-rule-id attribute: + ▸ provide the argument --forwarding-rule on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --forwarding-rule-location=FORWARDING_RULE_LOCATION + The Cloud region for the forwardingRule. + + To set the forwarding-rule-location attribute: + ▸ provide the argument --forwarding-rule on the command line with a + fully specified name; + ▸ provide the argument --forwarding-rule-location on the command + line. + + Mirroring deployment group resource - Mirroring Deployment Group. 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 --mirroring-deployment-group 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. + + --mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the id attribute: + ▸ provide the argument --mirroring-deployment-group on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument --mirroring-deployment-group on the command + line with a fully specified name; + ▸ provide the argument --mirroring-deployment-group-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.projects.locations.mirroringDeployments on the + command line with a fully specified name. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployments create + diff --git a/gcloud/alpha/network-security/mirroring-deployments/delete b/gcloud/alpha/network-security/mirroring-deployments/delete new file mode 100644 index 000000000..7c583ebaa --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployments/delete @@ -0,0 +1,82 @@ +NAME + gcloud alpha network-security mirroring-deployments delete - delete a + Mirroring Deployment + +SYNOPSIS + gcloud alpha network-security mirroring-deployments delete + (MIRRORING_DEPLOYMENT : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a mirroring deployment. Check the progress of deployment + deletion by using gcloud network-security mirroring-deployments list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To delete a mirroring deployment called my-deployment in location + us-central1, run: + + $ gcloud alpha network-security mirroring-deployments delete \ + my-deployment --location=us-central1-a --project=my-project + +POSITIONAL ARGUMENTS + Mirroring deployment resource - Mirroring Deployment. 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 MIRRORING_DEPLOYMENT 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. + + MIRRORING_DEPLOYMENT + ID of the mirroring deployment or fully qualified identifier for the + mirroring deployment. + + To set the deployment-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployments delete + diff --git a/gcloud/alpha/network-security/mirroring-deployments/describe b/gcloud/alpha/network-security/mirroring-deployments/describe new file mode 100644 index 000000000..ede19502f --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployments/describe @@ -0,0 +1,74 @@ +NAME + gcloud alpha network-security mirroring-deployments describe - describe a + Mirroring Deployment + +SYNOPSIS + gcloud alpha network-security mirroring-deployments describe + (MIRRORING_DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a mirroring deployment. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To get a description of a mirroring deployment called my-deployment in zone + us-central1-a, run: + + $ gcloud alpha network-security mirroring-deployments describe \ + my-deployment --location=us-central1-a --project=my-project + + OR + + $ gcloud alpha network-security mirroring-deployments describe \ + projects/my-project/locations/us-central1-a/\ + mirroringDeployments/my-deployment + +POSITIONAL ARGUMENTS + Mirroring deployment resource - Mirroring Deployment. 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 MIRRORING_DEPLOYMENT 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. + + MIRRORING_DEPLOYMENT + ID of the mirroring deployment or fully qualified identifier for the + mirroring deployment. + + To set the deployment-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployments describe + diff --git a/gcloud/alpha/network-security/mirroring-deployments/help b/gcloud/alpha/network-security/mirroring-deployments/help new file mode 100644 index 000000000..dac750d0a --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployments/help @@ -0,0 +1,45 @@ +NAME + gcloud alpha network-security mirroring-deployments - manage Mirroing + Deployment resources + +SYNOPSIS + gcloud alpha network-security mirroring-deployments COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This class provides commands for managing Mirroring Deployments. + + Attributes: category (str): The category under which this command group + falls. + +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 Mirroring Deployment. + + delete + (ALPHA) Delete a Mirroring Deployment. + + describe + (ALPHA) Describe a Mirroring Deployment. + + list + (ALPHA) List Mirroring Deployments. + + update + (ALPHA) Update a Mirroring Deployment. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployments + diff --git a/gcloud/alpha/network-security/mirroring-deployments/list b/gcloud/alpha/network-security/mirroring-deployments/list new file mode 100644 index 000000000..a405512c1 --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployments/list @@ -0,0 +1,95 @@ +NAME + gcloud alpha network-security mirroring-deployments list - list Mirroring + Deployments + +SYNOPSIS + gcloud alpha network-security mirroring-deployments list + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List mirroring deployments. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list mirroring deployments in project my-project and zone us-central1-a, + run: + + $ gcloud alpha network-security mirroring-deployments list \ + --project=my-project --location=us-central1-a + + To list mirroring deployments from all zones, run: + + $ gcloud alpha network-security mirroring-deployments list \ + --project=my-project --location=- + +FLAGS + Location resource - Zone of the deployment This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ Location of the Mirroring Deployment. Defaults to a wildcard with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ Location of the Mirroring Deployment. Defaults to a wildcard. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployments list + diff --git a/gcloud/alpha/network-security/mirroring-deployments/update b/gcloud/alpha/network-security/mirroring-deployments/update new file mode 100644 index 000000000..73f13dffd --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-deployments/update @@ -0,0 +1,125 @@ +NAME + gcloud alpha network-security mirroring-deployments update - update a + Mirroring Deployment + +SYNOPSIS + gcloud alpha network-security mirroring-deployments update + (MIRRORING_DEPLOYMENT : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a mirroring deployment. Check the progress of deployment + update by using gcloud network-security mirroring-deployments list. + + For examples refer to the EXAMPLES section below. + +EXAMPLES + To update labels k1 and k2, run: + + $ gcloud alpha network-security mirroring-deployments update \ + my-deployment --project=my-project --location=us-central1-a \ + --update-labels=k1=v1,k2=v2 + + To remove labels k3 and k4, run: + + $ gcloud alpha network-security mirroring-deployments update \ + my-deployment --project=my-project --location=us-central1-a \ + --remove-labels=k3,k4 + + To clear all labels from the mirroring deployment, run: + + $ gcloud alpha network-security mirroring-deployments update \ + my-deploymen --project=my-project --location=us-central1-a \ + --clear-labels + +POSITIONAL ARGUMENTS + Mirroring deployment resource - Mirroring Deployment. 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 MIRRORING_DEPLOYMENT 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. + + MIRRORING_DEPLOYMENT + ID of the mirroring deployment or fully qualified identifier for the + mirroring deployment. + + To set the deployment-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud alpha network-security mirroring-deployments update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud alpha network-security mirroring-deployments update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-deployments update + diff --git a/gcloud/alpha/network-security/mirroring-endpoint-groups/create b/gcloud/alpha/network-security/mirroring-endpoint-groups/create new file mode 100644 index 000000000..a78cc19e2 --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-endpoint-groups/create @@ -0,0 +1,147 @@ +NAME + gcloud alpha network-security mirroring-endpoint-groups create - create a + Mirroring Endpoint Group + +SYNOPSIS + gcloud alpha network-security mirroring-endpoint-groups create + (MIRRORING_ENDPOINT_GROUP : --location=LOCATION) + (--mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP + : --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION) + [--async] [--labels=[KEY=VALUE,...]] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a mirroring endpoint group. Successful creation of an + endpoint group results in an endpoint group in ACTIVE state. Check the + progress of endpoint group creation by using gcloud network-security + mirroring-endpoint-groups list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To create a mirroring endpoint group called my-endpoint-group, in project + ID my-project, run: $ gcloud alpha network-security mirroring-endpoint-groups create \ + my-endpoint-group --project=my-project --location=global \ + --mirroring-deployment-group=my-deployment-group + + OR + + $ gcloud alpha network-security mirroring-endpoint-groups create \ + my-endpoint-group --project=my-project --location=global \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/mirroringDeploymentGroups/my-deployment-group + + OR + + $ gcloud alpha network-security mirroring-endpoint-groups create \ + projects/my-project/locations/global/mirroringEndpointGroups/\ + my-endpoint-group \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/mirroringDeploymentGroups/my-deployment-group + +POSITIONAL ARGUMENTS + Mirroring endpoint group resource - Mirroring Endpoint Group. 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 MIRRORING_ENDPOINT_GROUP 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. + + MIRRORING_ENDPOINT_GROUP + ID of the mirroring endpoint group or fully qualified identifier for + the mirroring endpoint group. + + To set the endpoint-group-id attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring endpoint group. + + To set the location attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + Mirroring deployment group resource - Mirroring Deployment Group. 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 --mirroring-deployment-group 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. + + --mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the id attribute: + ▸ provide the argument --mirroring-deployment-group on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument --mirroring-deployment-group on the command + line with a fully specified name; + ▸ provide the argument --mirroring-deployment-group-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command line + with a fully specified name. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-endpoint-groups create + diff --git a/gcloud/alpha/network-security/mirroring-endpoint-groups/delete b/gcloud/alpha/network-security/mirroring-endpoint-groups/delete new file mode 100644 index 000000000..8771c8d6d --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-endpoint-groups/delete @@ -0,0 +1,88 @@ +NAME + gcloud alpha network-security mirroring-endpoint-groups delete - delete a + Mirroring Endpoint Group + +SYNOPSIS + gcloud alpha network-security mirroring-endpoint-groups delete + (MIRRORING_ENDPOINT_GROUP : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a mirroring endpoint group. Check the progress of endpoint + group deletion by using gcloud network-security mirroring-endpoint-groups + list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To delete a mirroring endpoint group called my-endpoint-group, in project + ID my-project, run: $ gcloud alpha network-security mirroring-endpoint-groups delete \ + my-endpoint-group --project=my-project --location=global + + OR + + $ gcloud alpha network-security mirroring-endpoint-groups delete \ + projects/my-project/locations/global/mirroringEndpointGroups/\ + my-endpoint-group + +POSITIONAL ARGUMENTS + Mirroring endpoint group resource - Mirroring Endpoint Group. 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 MIRRORING_ENDPOINT_GROUP 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. + + MIRRORING_ENDPOINT_GROUP + ID of the mirroring endpoint group or fully qualified identifier for + the mirroring endpoint group. + + To set the endpoint-group-id attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring endpoint group. + + To set the location attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-endpoint-groups delete + diff --git a/gcloud/alpha/network-security/mirroring-endpoint-groups/describe b/gcloud/alpha/network-security/mirroring-endpoint-groups/describe new file mode 100644 index 000000000..b6e112916 --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-endpoint-groups/describe @@ -0,0 +1,73 @@ +NAME + gcloud alpha network-security mirroring-endpoint-groups describe - describe + a Mirroring Endpoint Group + +SYNOPSIS + gcloud alpha network-security mirroring-endpoint-groups describe + (MIRRORING_ENDPOINT_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a mirroring endpoint group. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To get a description of a mirroring endpoint group called my-endpoint-group + in project ID my-project, run: $ gcloud alpha network-security mirroring-endpoint-groups describe \ + my-endpoint-group --project=my-project --location=global + + OR + + $ gcloud alpha network-security mirroring-endpoint-groups describe \ + projects/my-project/locations/global/mirroringEndpointGroups/\ + my-endpoint-group + +POSITIONAL ARGUMENTS + Mirroring endpoint group resource - Mirroring Endpoint Group. 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 MIRRORING_ENDPOINT_GROUP 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. + + MIRRORING_ENDPOINT_GROUP + ID of the mirroring endpoint group or fully qualified identifier for + the mirroring endpoint group. + + To set the endpoint-group-id attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring endpoint group. + + To set the location attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-endpoint-groups describe + diff --git a/gcloud/alpha/network-security/mirroring-endpoint-groups/help b/gcloud/alpha/network-security/mirroring-endpoint-groups/help new file mode 100644 index 000000000..191c865b0 --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-endpoint-groups/help @@ -0,0 +1,46 @@ +NAME + gcloud alpha network-security mirroring-endpoint-groups - manage Mirroring + Endpoint Group resources + +SYNOPSIS + gcloud alpha network-security mirroring-endpoint-groups COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This class provides commands for managing Mirroring Endpoint + Groups. + + Attributes: category (str): The category under which this command group + falls. + +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 Mirroring Endpoint Group. + + delete + (ALPHA) Delete a Mirroring Endpoint Group. + + describe + (ALPHA) Describe a Mirroring Endpoint Group. + + list + (ALPHA) List Mirroring Endpoint Groups. + + update + (ALPHA) Update a Mirroring Endpoint Group. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-endpoint-groups + diff --git a/gcloud/alpha/network-security/mirroring-endpoint-groups/list b/gcloud/alpha/network-security/mirroring-endpoint-groups/list new file mode 100644 index 000000000..04977e90e --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-endpoint-groups/list @@ -0,0 +1,102 @@ +NAME + gcloud alpha network-security mirroring-endpoint-groups list - list + Mirroring Endpoint Groups + +SYNOPSIS + gcloud alpha network-security mirroring-endpoint-groups list + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List mirroring endpoint groups. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list mirroring endpoint groups in project ID my-project, run: $ gcloud alpha network-security mirroring-endpoint-groups list \ + --project=my-project --location=global + + OR + + $ gcloud alpha network-security mirroring-endpoint-groups list \ + --location=global + + OR + + $ gcloud alpha network-security mirroring-endpoint-groups list \ + --location=projects/my-project/locations/global + + OR + + $ gcloud alpha network-security mirroring-endpoint-groups list \ + projects/my-project/locations/global/mirroringEndpointGroups + +FLAGS + Location resource - The location for a list operation This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ Location of the Mirroring Endpoint Group. Defaults to global with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ Location of the Mirroring Endpoint Group. Defaults to global. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-endpoint-groups list + diff --git a/gcloud/alpha/network-security/mirroring-endpoint-groups/update b/gcloud/alpha/network-security/mirroring-endpoint-groups/update new file mode 100644 index 000000000..8a077e1a0 --- /dev/null +++ b/gcloud/alpha/network-security/mirroring-endpoint-groups/update @@ -0,0 +1,127 @@ +NAME + gcloud alpha network-security mirroring-endpoint-groups update - update a + Mirroring Endpoint Group + +SYNOPSIS + gcloud alpha network-security mirroring-endpoint-groups update + (MIRRORING_ENDPOINT_GROUP : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Update a mirroring endpoint groups. Check the progress of endpoint + group update by using gcloud network-security mirroring-endpoint-groups + list. + + For examples refer to the EXAMPLES section below. + +EXAMPLES + To update labels k1 and k2, run: + + $ gcloud alpha network-security mirroring-endpoint-groups update \ + my-endpoint-group --project=my-project \ + --location=us-central1-a --update-labels=k1=v1,k2=v2 + + To remove labels k3 and k4, run: + + $ gcloud alpha network-security mirroring-endpoint-groups update \ + my-endpoint-group --project=my-project \ + --location=us-central1-a --remove-labels=k3,k4 + + To clear all labels from the mirroring endpoint group, run: + + $ gcloud alpha network-security mirroring-endpoint-groups update \ + my-endpoint-group --project=my-project \ + --location=us-central1-a --clear-labels + +POSITIONAL ARGUMENTS + Mirroring endpoint group resource - Mirroring Endpoint Group. 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 MIRRORING_ENDPOINT_GROUP 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. + + MIRRORING_ENDPOINT_GROUP + ID of the mirroring endpoint group or fully qualified identifier for + the mirroring endpoint group. + + To set the endpoint-group-id attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring endpoint group. + + To set the location attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud alpha network-security mirroring-endpoint-groups update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud alpha network-security mirroring-endpoint-groups update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security mirroring-endpoint-groups update + diff --git a/gcloud/alpha/redis/clusters/create b/gcloud/alpha/redis/clusters/create index 8b89373a2..cf913b0be 100644 --- a/gcloud/alpha/redis/clusters/create +++ b/gcloud/alpha/redis/clusters/create @@ -4,13 +4,13 @@ NAME SYNOPSIS gcloud alpha redis clusters create (CLUSTER : --region=REGION) - --network=NETWORK --shard-count=SHARD_COUNT - [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] [--auth-mode=AUTH_MODE] - [--deletion-protection] [--node-type=NODE_TYPE] + --network=NETWORK [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] + [--auth-mode=AUTH_MODE] [--deletion-protection] [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,...]] [--replica-count=REPLICA_COUNT] + [--shard-count=SHARD_COUNT] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--zone=ZONE] [--zone-distribution-mode=ZONE_DISTRIBUTION_MODE] [GCLOUD_WIDE_FLAG ...] @@ -85,9 +85,6 @@ REQUIRED FLAGS used here must match the network ID used by the service connection policy. Otherwise, the create operation fails - --shard-count=SHARD_COUNT - The shard count of the cluster. - OPTIONAL FLAGS --aof-append-fsync=AOF_APPEND_FSYNC Fsync configuration. AOF_APPEND_FSYNC must be one of: @@ -163,6 +160,9 @@ OPTIONAL FLAGS --replica-count=REPLICA_COUNT The replica count of each shard. + --shard-count=SHARD_COUNT + The shard count of the cluster. + --transit-encryption-mode=TRANSIT_ENCRYPTION_MODE Transit encryption mode used for the Redis cluster. If not provided, encryption is disabled for the cluster. TRANSIT_ENCRYPTION_MODE must be diff --git a/gcloud/alpha/redis/clusters/detach b/gcloud/alpha/redis/clusters/detach new file mode 100644 index 000000000..60d9854e2 --- /dev/null +++ b/gcloud/alpha/redis/clusters/detach @@ -0,0 +1,83 @@ +NAME + gcloud alpha redis clusters detach - detach a secondary cluster + +SYNOPSIS + gcloud alpha redis clusters detach (CLUSTER : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Detach a secondary cluster from the primary cluster. + + After detachment, the secondary cluster becomes an independent cluster, + i.e. it stops replicating from the primary cluster and it now accepts both + read and write requests. + + This command is only supported on secondary clusters. + +EXAMPLES + To detach a secondary cluster with name my-secondary-cluster in region + us-central1, run: + + $ gcloud alpha redis clusters detach my-secondary-cluster \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Cluster resource - Arguments and flags that specify the Memorystore Redis + cluster you want to update. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the Redis region of the cluster. Overrides the default + redis/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property redis/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the redis/v1alpha1 API. The full documentation for this + API can be found at: https://cloud.google.com/memorystore/docs/redis/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud redis clusters detach + + $ gcloud beta redis clusters detach + diff --git a/gcloud/alpha/redis/clusters/detach-secondaries b/gcloud/alpha/redis/clusters/detach-secondaries new file mode 100644 index 000000000..87c3b6e7a --- /dev/null +++ b/gcloud/alpha/redis/clusters/detach-secondaries @@ -0,0 +1,96 @@ +NAME + gcloud alpha redis clusters detach-secondaries - detach one or more + secondary clusters from the primary cluster + +SYNOPSIS + gcloud alpha redis clusters detach-secondaries (CLUSTER : --region=REGION) + --clusters-to-detach=CLUSTERS_TO_DETACH [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Detach one or more secondary clusters from the primary cluster. + + After detachment, the secondary clusters become independent clusters, i.e. + they stop replicating from the primary cluster and will now accept both + read and write requests. + + This command is only supported on primary clusters. + +EXAMPLES + To detach the secondary clusters my-secondary-cluster1 and + my-secondary-cluster2 from the primary cluster my-primary-cluster, run: + + $ gcloud alpha redis clusters detach-secondaries \ + my-primary-cluster --region=us-central1 \ + --clusters-to-detach=projects/my-project/locations/us-east1/\ + clusters/my-secondary-cluster1,projects/my-project/locations/\ + asia-east1/clusters/my-secondary-cluster2 + +POSITIONAL ARGUMENTS + Cluster resource - Arguments and flags that specify the Memorystore Redis + cluster you want to update. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the Redis region of the cluster. Overrides the default + redis/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property redis/region. + +REQUIRED FLAGS + --clusters-to-detach=CLUSTERS_TO_DETACH + Comma separated list of secondary clusters to detach from the primary + cluster. + + Each element in the list should be in the format: + projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the redis/v1alpha1 API. The full documentation for this + API can be found at: https://cloud.google.com/memorystore/docs/redis/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud redis clusters detach-secondaries + + $ gcloud beta redis clusters detach-secondaries + diff --git a/gcloud/alpha/redis/clusters/help b/gcloud/alpha/redis/clusters/help index 2c59a1c04..4c6035a04 100644 --- a/gcloud/alpha/redis/clusters/help +++ b/gcloud/alpha/redis/clusters/help @@ -25,6 +25,12 @@ COMMANDS describe (ALPHA) Show metadata for a Memorystore for Redis Cluster instance. + detach + (ALPHA) Detach a secondary cluster. + + detach-secondaries + (ALPHA) Detach one or more secondary clusters from the primary cluster. + get-cluster-certificate-authority (ALPHA) Get the certificate authority information for a Memorystore for Redis Cluster instance. @@ -32,6 +38,9 @@ COMMANDS list (ALPHA) List Memorystore for Redis Cluster instances. + switchover + (ALPHA) Switchover to a secondary cluster. + update (ALPHA) Update Memorystore Cluster for Redis instance. diff --git a/gcloud/alpha/redis/clusters/switchover b/gcloud/alpha/redis/clusters/switchover new file mode 100644 index 000000000..8ca9fe928 --- /dev/null +++ b/gcloud/alpha/redis/clusters/switchover @@ -0,0 +1,84 @@ +NAME + gcloud alpha redis clusters switchover - switchover to a secondary cluster + +SYNOPSIS + gcloud alpha redis clusters switchover (CLUSTER : --region=REGION) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command promotes the secondary cluster to become the new + primary cluster. The old primary and other secondary clusters will + automatically become the secondary clusters of this cluster. + + After the successful completion of this operation, the new primary cluster + will accept both read and write requests. + + This command is only supported on secondary clusters. + +EXAMPLES + To switchover to a secondary cluster with name my-secondary-cluster in + region us-central1, run: + + $ gcloud alpha redis clusters switchover my-secondary-cluster \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Cluster resource - Arguments and flags that specify the Memorystore Redis + cluster you want to update. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the Redis region of the cluster. Overrides the default + redis/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property redis/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the redis/v1alpha1 API. The full documentation for this + API can be found at: https://cloud.google.com/memorystore/docs/redis/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud redis clusters switchover + + $ gcloud beta redis clusters switchover + diff --git a/gcloud/alpha/run/deploy b/gcloud/alpha/run/deploy index 8a41ed314..6c4414bf3 100644 --- a/gcloud/alpha/run/deploy +++ b/gcloud/alpha/run/deploy @@ -11,8 +11,8 @@ SYNOPSIS [--no-traffic] [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] - --cpu=CPU --depends-on=[CONTAINER,...] --memory=MEMORY --port=PORT - --remove-volume-mount=[MOUNT_PATH,...] + --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --memory=MEMORY + --port=PORT --remove-volume-mount=[MOUNT_PATH,...] --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -231,6 +231,10 @@ FLAGS --depends-on=[CONTAINER,...] List of container dependencies to add to the current container. + --gpu=GPU + Cloud Run supports values 0 or 1. 1 gpu also requires a minimum 4 + --cpu value 1 gpu also requires a minimum 8Gi --memory value. + --memory=MEMORY Set a memory limit. Ex: 1024Mi, 4Gi. diff --git a/gcloud/alpha/run/services/update b/gcloud/alpha/run/services/update index fc2c43b55..1b83a7213 100644 --- a/gcloud/alpha/run/services/update +++ b/gcloud/alpha/run/services/update @@ -12,8 +12,8 @@ SYNOPSIS [--no-traffic] [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] - --cpu=CPU --depends-on=[CONTAINER,...] --image=IMAGE --memory=MEMORY - --port=PORT --remove-volume-mount=[MOUNT_PATH,...] + --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE + --memory=MEMORY --port=PORT --remove-volume-mount=[MOUNT_PATH,...] --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -222,6 +222,10 @@ FLAGS --depends-on=[CONTAINER,...] List of container dependencies to add to the current container. + --gpu=GPU + Cloud Run supports values 0 or 1. 1 gpu also requires a minimum 4 + --cpu value 1 gpu also requires a minimum 8Gi --memory value. + --image=IMAGE Name of the container image to deploy (e.g. gcr.io/cloudrun/hello:latest). diff --git a/gcloud/beta/certificate-manager/issuance-configs/help b/gcloud/beta/certificate-manager/issuance-configs/help index 45712d71d..5dc67247b 100644 --- a/gcloud/beta/certificate-manager/issuance-configs/help +++ b/gcloud/beta/certificate-manager/issuance-configs/help @@ -29,6 +29,9 @@ COMMANDS list (BETA) List all Certificate Issuance Configs in a project. + update + (BETA) Update a Certificate Issuance Config. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/certificate-manager/issuance-configs/update b/gcloud/beta/certificate-manager/issuance-configs/update new file mode 100644 index 000000000..bbb3dab02 --- /dev/null +++ b/gcloud/beta/certificate-manager/issuance-configs/update @@ -0,0 +1,113 @@ +NAME + gcloud beta certificate-manager issuance-configs update - update a + Certificate Issuance Config + +SYNOPSIS + gcloud beta certificate-manager issuance-configs update + (CERTIFICATE_ISSUANCE_CONFIG : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a Certificate Issuance Config. + +EXAMPLES + To update a Certificate Issuance Config called my-cic, run: + + $ gcloud beta certificate-manager issuance-configs update my-cic \ + --description="updated description" \ + --update-labels=my-key1=my-updated-value1 \ + --remove-labels=my-key2 + +POSITIONAL ARGUMENTS + CertificateIssuanceConfig resource - Name of the Certificate Issuance + Config to update. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument certificate_issuance_config 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. + + CERTIFICATE_ISSUANCE_CONFIG + ID of the certificateIssuanceConfig or fully qualified identifier for + the certificateIssuanceConfig. + + To set the certificate_issuance_config attribute: + ▸ provide the argument certificate_issuance_config on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Certificate Manager location. + + To set the location attribute: + ▸ provide the argument certificate_issuance_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Human-readable description of the resource. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta certificate-manager issuance-configs update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta certificate-manager issuance-configs update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud certificate-manager issuance-configs update + + $ gcloud alpha certificate-manager issuance-configs update + diff --git a/gcloud/beta/compute/instances/perform-maintenance b/gcloud/beta/compute/instances/perform-maintenance index 3dc4fabc9..557f48d0d 100644 --- a/gcloud/beta/compute/instances/perform-maintenance +++ b/gcloud/beta/compute/instances/perform-maintenance @@ -3,8 +3,8 @@ NAME Google Compute Engine instance SYNOPSIS - gcloud beta compute instances perform-maintenance INSTANCE_NAME - [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + gcloud beta compute instances perform-maintenance INSTANCE_NAMES + [INSTANCE_NAMES ...] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Perform maintenance of Google Compute Engine instance. @@ -17,14 +17,14 @@ EXAMPLES --zone=us-east1-d POSITIONAL ARGUMENTS - INSTANCE_NAME - Name of the instance to operate on. For details on valid instance + INSTANCE_NAMES [INSTANCE_NAMES ...] + Names of the instances to operate on. For details on valid instance names, refer to the criteria documented under the field 'name' at: https://cloud.google.com/compute/docs/reference/rest/v1/instances FLAGS --zone=ZONE - Zone of the instance to operate on. If not specified, you might be + Zone of the instances to operate on. If not specified, you might be prompted to select a zone (interactive mode only). gcloud attempts to identify the appropriate zone by searching for resources in your currently active project. If the zone cannot be determined, gcloud diff --git a/gcloud/beta/compute/networks/create b/gcloud/beta/compute/networks/create index b2cfb8162..8b7bd149e 100644 --- a/gcloud/beta/compute/networks/create +++ b/gcloud/beta/compute/networks/create @@ -7,7 +7,11 @@ SYNOPSIS [--description=DESCRIPTION] [--[no-]enable-ula-internal-ipv6] [--internal-ipv6-range=INTERNAL_IPV6_RANGE] [--mtu=MTU] [--network-firewall-policy-enforcement-order=NETWORK_FIREWALL_POLICY_ENFORCEMENT_ORDER] - [--range=RANGE] [--subnet-mode=MODE] [GCLOUD_WIDE_FLAG ...] + [--range=RANGE] [--subnet-mode=MODE] + [--bgp-best-path-selection-mode=BGP_BEST_PATH_SELECTION_MODE + --[no-]bgp-bps-always-compare-med + --bgp-bps-inter-region-cost=BGP_BPS_INTER_REGION_COST] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) gcloud beta compute networks create is used to create virtual @@ -109,6 +113,47 @@ FLAGS [Deprecated] Create an old style network that has a range and cannot have subnets. This is not recommended for new networks. + BGP Best Path Selection flags + + --bgp-best-path-selection-mode=BGP_BEST_PATH_SELECTION_MODE + The BGP best path selection algorithm to be employed. MODE can be + LEGACY or STANDARD. BGP_BEST_PATH_SELECTION_MODE must be one of: + + LEGACY + Dynamic routes are ranked based on the multiple + exit-discriminator (MED) BGP attribute. When global routing is + enabled, the MED of the routes received from other regions is the + original MED plus the region-to-region cost. + STANDARD + Dynamic routes are ranked based on AS Path, Origin, Neighbor ASN + and MED BGP attributes. When global routing is enabled, + region-to-region cost is used as a tiebreaker. This mode offers + customizations to fine-tune BGP best path routing with additional + knobs like --bgp-bps-always-compare-med and + --bgp-bps-inter-region-cost + + --[no-]bgp-bps-always-compare-med + Enables/disables the comparison of MED across routes with different + Neighbor ASNs. This value can only be set if the + --bgp-best-path-selection-mode is STANDARD. Use + --bgp-bps-always-compare-med to enable and + --no-bgp-bps-always-compare-med to disable. + + --bgp-bps-inter-region-cost=BGP_BPS_INTER_REGION_COST + Defines the preferred approach for handling inter-region cost in the + selection process. This value can only be set if the + --bgp-best-path-selection-mode is STANDARD. BGP_BPS_INTER_REGION_COST + must be one of: + + ADD_COST_TO_MED + Adds inter-region cost to the MED before comparing the MED value. + When multiple routes have the same value after the + Add-cost-to-med comparison, the route selection continues and + prefers the route with lowest cost. + DEFAULT + MED is compared as originally received from peers. When multiple + routes have the same MED, cost is evaluated as the next step. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/beta/compute/networks/update b/gcloud/beta/compute/networks/update index f65d3d479..87d9e2111 100644 --- a/gcloud/beta/compute/networks/update +++ b/gcloud/beta/compute/networks/update @@ -6,6 +6,9 @@ SYNOPSIS [--[no-]enable-ula-internal-ipv6] [--internal-ipv6-range=INTERNAL_IPV6_RANGE] [--mtu=MTU] [--network-firewall-policy-enforcement-order=NETWORK_FIREWALL_POLICY_ENFORCEMENT_ORDER] + [--bgp-best-path-selection-mode=BGP_BEST_PATH_SELECTION_MODE + --[no-]bgp-bps-always-compare-med + --bgp-bps-inter-region-cost=BGP_BPS_INTER_REGION_COST] [--bgp-routing-mode=MODE | --switch-to-custom-subnet-mode] [GCLOUD_WIDE_FLAG ...] @@ -66,6 +69,47 @@ FLAGS BEFORE_CLASSIC_FIREWALL Network Firewall Policy is enforced before classic firewall. + BGP Best Path Selection flags + + --bgp-best-path-selection-mode=BGP_BEST_PATH_SELECTION_MODE + The BGP best path selection algorithm to be employed. MODE can be + LEGACY or STANDARD. BGP_BEST_PATH_SELECTION_MODE must be one of: + + LEGACY + Dynamic routes are ranked based on the multiple + exit-discriminator (MED) BGP attribute. When global routing is + enabled, the MED of the routes received from other regions is the + original MED plus the region-to-region cost. + STANDARD + Dynamic routes are ranked based on AS Path, Origin, Neighbor ASN + and MED BGP attributes. When global routing is enabled, + region-to-region cost is used as a tiebreaker. This mode offers + customizations to fine-tune BGP best path routing with additional + knobs like --bgp-bps-always-compare-med and + --bgp-bps-inter-region-cost + + --[no-]bgp-bps-always-compare-med + Enables/disables the comparison of MED across routes with different + Neighbor ASNs. This value can only be set if the + --bgp-best-path-selection-mode is STANDARD. Use + --bgp-bps-always-compare-med to enable and + --no-bgp-bps-always-compare-med to disable. + + --bgp-bps-inter-region-cost=BGP_BPS_INTER_REGION_COST + Defines the preferred approach for handling inter-region cost in the + selection process. This value can only be set if the + --bgp-best-path-selection-mode is STANDARD. BGP_BPS_INTER_REGION_COST + must be one of: + + ADD_COST_TO_MED + Adds inter-region cost to the MED before comparing the MED value. + When multiple routes have the same value after the + Add-cost-to-med comparison, the route selection continues and + prefers the route with lowest cost. + DEFAULT + MED is compared as originally received from peers. When multiple + routes have the same MED, cost is evaluated as the next step. + At most one of these can be specified: --bgp-routing-mode=MODE diff --git a/gcloud/beta/container/fleet/memberships/delete b/gcloud/beta/container/fleet/memberships/delete index 48bb514e5..0f4def12b 100644 --- a/gcloud/beta/container/fleet/memberships/delete +++ b/gcloud/beta/container/fleet/memberships/delete @@ -73,7 +73,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1beta1 API. The full documentation for this + This command uses the gkehub/v1beta API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/beta/container/fleet/memberships/describe b/gcloud/beta/container/fleet/memberships/describe index 377c87e35..1a5eb5911 100644 --- a/gcloud/beta/container/fleet/memberships/describe +++ b/gcloud/beta/container/fleet/memberships/describe @@ -61,7 +61,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1beta1 API. The full documentation for this + This command uses the gkehub/v1beta API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/beta/container/fleet/memberships/list b/gcloud/beta/container/fleet/memberships/list index e6e6c5479..2557409e3 100644 --- a/gcloud/beta/container/fleet/memberships/list +++ b/gcloud/beta/container/fleet/memberships/list @@ -55,7 +55,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1beta1 API. The full documentation for this + This command uses the gkehub/v1beta API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/beta/container/hub/memberships/delete b/gcloud/beta/container/hub/memberships/delete index 2f97efd8b..c8a6d2181 100644 --- a/gcloud/beta/container/hub/memberships/delete +++ b/gcloud/beta/container/hub/memberships/delete @@ -73,7 +73,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1beta1 API. The full documentation for this + This command uses the gkehub/v1beta API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/beta/container/hub/memberships/describe b/gcloud/beta/container/hub/memberships/describe index 73d8c711a..523eb24a5 100644 --- a/gcloud/beta/container/hub/memberships/describe +++ b/gcloud/beta/container/hub/memberships/describe @@ -61,7 +61,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1beta1 API. The full documentation for this + This command uses the gkehub/v1beta API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/beta/container/hub/memberships/list b/gcloud/beta/container/hub/memberships/list index dee87f6d9..661d0fce1 100644 --- a/gcloud/beta/container/hub/memberships/list +++ b/gcloud/beta/container/hub/memberships/list @@ -55,7 +55,7 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. API REFERENCE - This command uses the gkehub/v1beta1 API. The full documentation for this + This command uses the gkehub/v1beta API. The full documentation for this API can be found at: https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster diff --git a/gcloud/beta/filestore/instances/create b/gcloud/beta/filestore/instances/create index 1921ff14b..c1b756a71 100644 --- a/gcloud/beta/filestore/instances/create +++ b/gcloud/beta/filestore/instances/create @@ -11,8 +11,8 @@ SYNOPSIS [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--location=LOCATION] [--managed-ad=[computer=COMPUTER],[domain=DOMAIN]] - [--performance=[iops-by-capacity],[max-read-iops=MAX-READ-IOPS], - [max-read-iops-per-gb=MAX-READ-IOPS-PER-GB]] + [--performance=[max-read-iops=MAX-READ-IOPS], + [max-read-iops-per-tb=MAX-READ-IOPS-PER-TB]] [--protocol=PROTOCOL; default="NFS_V3"] [--region=REGION] [--source-instance=SOURCE_INSTANCE] [--tier=TIER; default="BASIC_HDD"] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING @@ -244,57 +244,42 @@ OPTIONAL FLAGS The desired active directory computer name to be created by the filestore instance when connecting to the domain. - --performance=[iops-by-capacity],[max-read-iops=MAX-READ-IOPS],[max-read-iops-per-gb=MAX-READ-IOPS-PER-GB] + --performance=[max-read-iops=MAX-READ-IOPS],[max-read-iops-per-tb=MAX-READ-IOPS-PER-TB] Performance configuration for the instance. This flag is used to configure the read IOPS provisioned for the instance. The instance's write IOPS and read/write throughputs will be derived from the configured read IOPS. For more information about the derived - performance limits see + performance limits and default performance see: https://cloud.google.com/filestore/docs/performance. Must be one of: - iops-by-capacity - Default configuration. Automatically provisions the instance IOPS - based on its capacity. If the user changes the instance capacity, - IOPS will be automatically adjusted accordingly. The available IOPS - for a given capacity can be found here: https://cloud.google.com/filestore/docs/performance. - max-read-iops The number of IOPS to provision for the instance. MAX-READ-IOPS must be in multiple of 1000 and in the supported IOPS range for the current capacity of the instance. For more details, see: https://cloud.google.com/filestore/docs/performance. - max-read-iops-per-gb + max-read-iops-per-tb Is used for setting the max IOPS of the instance by - specifying the IOPS per GB. When this parameter is used, the + specifying the IOPS per TB. When this parameter is used, the max IOPS are derived from the instance capacity: The instance max IOPS will be calculated by multiplying the - capacity of the instance (GB) by MAX-READ-IOPS-PER-GB, and rounding + capacity of the instance (TB) by MAX-READ-IOPS-PER-TB, and rounding to the nearest 1000. The max IOPS will be changed dynamically based on the instance capacity. - MAX-READ-IOPS-PER-GB must be in the supported range of the instance. + MAX-READ-IOPS-PER-TB must be in the supported range of the instance. For more details, see: https://cloud.google.com/filestore/docs/performance. Examples: - Configure an instance implicitly with iops_by_capacity performance: - - $ gcloud beta filestore instances create example-cluster - - Configure an instance explicitly with iops_by_capacity performance: - - $ gcloud beta filestore instances create example-cluster \ - --performance=iops_by_capacity - Configure an instance with max-read-iops performance: $ gcloud beta filestore instances create example-cluster \ - --performance=max-read-iops=1000 + --performance=max-read-iops=17000 - Configure an instance with max-read-iops-per-gb performance: + Configure an instance with max-read-iops-per-tb performance: $ gcloud beta filestore instances create example-cluster \ - --performance=max-read-iops-per-gb=5 + --performance=max-read-iops-per-tb=17000 --protocol=PROTOCOL; default="NFS_V3" The service protocol for the Cloud Filestore instance. PROTOCOL must be diff --git a/gcloud/beta/filestore/instances/update b/gcloud/beta/filestore/instances/update index deb8ba0b3..2e555a52a 100644 --- a/gcloud/beta/filestore/instances/update +++ b/gcloud/beta/filestore/instances/update @@ -3,11 +3,12 @@ NAME SYNOPSIS gcloud beta filestore instances update (INSTANCE : --zone=ZONE) [--async] - [--description=DESCRIPTION] [--location=LOCATION] - [--performance=[iops-by-capacity],[max-read-iops=MAX-READ-IOPS], - [max-read-iops-per-gb=MAX-READ-IOPS-PER-GB]] [--region=REGION] + [--description=DESCRIPTION] [--location=LOCATION] [--region=REGION] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] + [--clear-performance + | --performance=[max-read-iops=MAX-READ-IOPS], + [max-read-iops-per-tb=MAX-READ-IOPS-PER-TB]] [--disconnect-managed-ad | --managed-ad=[computer=COMPUTER],[domain=DOMAIN]] [[--file-share=[capacity=CAPACITY], @@ -106,58 +107,6 @@ FLAGS --location=LOCATION Location of the Cloud Filestore instance/operation. - --performance=[iops-by-capacity],[max-read-iops=MAX-READ-IOPS],[max-read-iops-per-gb=MAX-READ-IOPS-PER-GB] - Performance configuration for the instance. This flag is used to - configure the read IOPS provisioned for the instance. The instance's - write IOPS and read/write throughputs will be derived from the - configured read IOPS. For more information about the derived - performance limits see - https://cloud.google.com/filestore/docs/performance. Must be one of: - - iops-by-capacity - Default configuration. Automatically provisions the instance IOPS - based on its capacity. If the user changes the instance capacity, - IOPS will be automatically adjusted accordingly. The available IOPS - for a given capacity can be found here: https://cloud.google.com/filestore/docs/performance. - - max-read-iops - The number of IOPS to provision for the instance. - MAX-READ-IOPS must be in multiple of 1000 and in the supported IOPS - range for the current capacity of the instance. - For more details, see: https://cloud.google.com/filestore/docs/performance. - - max-read-iops-per-gb - Is used for setting the max IOPS of the instance by - specifying the IOPS per GB. When this parameter is used, the - max IOPS are derived from the instance capacity: - The instance max IOPS will be calculated by multiplying the - capacity of the instance (GB) by MAX-READ-IOPS-PER-GB, and rounding - to the nearest 1000. The max IOPS will be changed - dynamically based on the instance capacity. - MAX-READ-IOPS-PER-GB must be in the supported range of the instance. - For more details, see: https://cloud.google.com/filestore/docs/performance. - - Examples: - - Configure an instance implicitly with iops_by_capacity performance: - - $ gcloud beta filestore instances update example-cluster - - Configure an instance explicitly with iops_by_capacity performance: - - $ gcloud beta filestore instances update example-cluster \ - --performance=iops_by_capacity - - Configure an instance with max-read-iops performance: - - $ gcloud beta filestore instances update example-cluster \ - --performance=max-read-iops=1000 - - Configure an instance with max-read-iops-per-gb performance: - - $ gcloud beta filestore instances update example-cluster \ - --performance=max-read-iops-per-gb=5 - --region=REGION Region of the Cloud Filestore instance. @@ -190,6 +139,54 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + At most one of these can be specified: + + --clear-performance + Clear the performance configuration of the instance and set it to the + default performance mode. In the default performance mode, the + instance performance will be automatically adjusted based on its + capacity (changes in the instance's capacity will automatically + adjust the instance's performance accordingly). For more information + about the default performance mode see: + https://cloud.google.com/filestore/docs/performance. + + --performance=[max-read-iops=MAX-READ-IOPS],[max-read-iops-per-tb=MAX-READ-IOPS-PER-TB] + Performance configuration for the instance. This flag is used to + configure the read IOPS provisioned for the instance. The instance's + write IOPS and read/write throughputs will be derived from the + configured read IOPS. For more information about the derived + performance limits and default performance see: + https://cloud.google.com/filestore/docs/performance. Must be one of: + + max-read-iops + The number of IOPS to provision for the instance. + MAX-READ-IOPS must be in multiple of 1000 and in the supported IOPS + range for the current capacity of the instance. + For more details, see: https://cloud.google.com/filestore/docs/performance. + + max-read-iops-per-tb + Is used for setting the max IOPS of the instance by + specifying the IOPS per TB. When this parameter is used, the + max IOPS are derived from the instance capacity: + The instance max IOPS will be calculated by multiplying the + capacity of the instance (TB) by MAX-READ-IOPS-PER-TB, and rounding + to the nearest 1000. The max IOPS will be changed + dynamically based on the instance capacity. + MAX-READ-IOPS-PER-TB must be in the supported range of the instance. + For more details, see: https://cloud.google.com/filestore/docs/performance. + + Examples: + + Configure an instance with max-read-iops performance: + + $ gcloud beta filestore instances update example-cluster \ + --performance=max-read-iops=17000 + + Configure an instance with max-read-iops-per-tb performance: + + $ gcloud beta filestore instances update example-cluster \ + --performance=max-read-iops-per-tb=17000 + At most one of these can be specified: --disconnect-managed-ad diff --git a/gcloud/beta/firestore/databases/create b/gcloud/beta/firestore/databases/create index bda723b65..ac3b36982 100644 --- a/gcloud/beta/firestore/databases/create +++ b/gcloud/beta/firestore/databases/create @@ -57,39 +57,43 @@ OPTIONAL FLAGS of the database's resource name. If database ID is not provided, (default) will be used as database ID. - This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/ - with first character a letter and the last a letter or a number. Must - not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. + This value should be 4-63 characters. Valid characters are + /[a-z][0-9]-/ with first character a letter and the last a letter or a + number. Must not be UUID-like + /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. - Using "(default)" database ID is also allowed. + Using "(default)" database ID is also allowed. --delete-protection Whether to enable delete protection on the created database. - If set to true, delete protection of the new database will be enabled - and delete operations will fail unless delete protection is disabled. + If set to true, delete protection of the new database will be enabled + and delete operations will fail unless delete protection is disabled. - Default to false. + Default to false. --enable-pitr Whether to enable Point In Time Recovery (PITR) on the created database. - If set to true, PITR on the new database will be enabled. By default, - this feature is not enabled. + If set to true, PITR on the new database will be enabled. By default, + this feature is not enabled. --kms-key-name=KMS_KEY_NAME The resource ID of a Cloud KMS key. If set, the database created will be a Customer-Managed Encryption Key (CMEK) database encrypted with this key. This feature is allowlist only in initial launch. - Only a key in the same location as this database is allowed to be used for encryption. - For Firestore's nam5 multi-region, this corresponds to Cloud KMS location us. - For Firestore's eur3 multi-region, this corresponds to Cloud KMS location europe. - See https://cloud.google.com/kms/docs/locations. + Only a key in the same location as this database is allowed to be used + for encryption. For Firestore's nam5 multi-region, this corresponds to + Cloud KMS location us. For Firestore's eur3 multi-region, this + corresponds to Cloud KMS location europe. See + https://cloud.google.com/kms/docs/locations. - This value should be the KMS key resource ID in the format of `projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`. - How to retrieve this resource ID is listed at https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. + This value should be the KMS key resource ID in the format of + projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}. + How to retrieve this resource ID is listed at + https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. --type=TYPE; default="firestore-native" The type of the database. TYPE must be one of: firestore-native, diff --git a/gcloud/beta/iam/workforce-pools/providers/create-oidc b/gcloud/beta/iam/workforce-pools/providers/create-oidc index 5d1d4eb6f..2cd54cae2 100644 --- a/gcloud/beta/iam/workforce-pools/providers/create-oidc +++ b/gcloud/beta/iam/workforce-pools/providers/create-oidc @@ -31,7 +31,8 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --attribute-mapping="google.subject=assertion.sub" \ + --disabled --detailed_audit_logging \ + --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ --issuer-uri="https://test-idp.com" \ diff --git a/gcloud/beta/iam/workforce-pools/providers/update-oidc b/gcloud/beta/iam/workforce-pools/providers/update-oidc index 83dab8aa0..d025da88b 100644 --- a/gcloud/beta/iam/workforce-pools/providers/update-oidc +++ b/gcloud/beta/iam/workforce-pools/providers/update-oidc @@ -31,7 +31,8 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --attribute-mapping="google.subject=assertion.sub" \ + --disabled --detailed_audit_logging \ + --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ --issuer-uri="https://test-idp.com" \ diff --git a/gcloud/beta/iam/workload-identity-pools/create-cred-config b/gcloud/beta/iam/workload-identity-pools/create-cred-config index ba567061b..d5eb79283 100644 --- a/gcloud/beta/iam/workload-identity-pools/create-cred-config +++ b/gcloud/beta/iam/workload-identity-pools/create-cred-config @@ -5,13 +5,16 @@ NAME SYNOPSIS gcloud beta iam workload-identity-pools create-cred-config AUDIENCE --output-file=OUTPUT_FILE - (--aws | --azure | --credential-source-file=CREDENTIAL_SOURCE_FILE + (--aws | --azure | --credential-cert-path=CREDENTIAL_CERT_PATH + | --credential-source-file=CREDENTIAL_SOURCE_FILE | --credential-source-url=CREDENTIAL_SOURCE_URL | --executable-command=EXECUTABLE_COMMAND) [--app-id-uri=APP_ID_URI] [--credential-source-field-name=CREDENTIAL_SOURCE_FIELD_NAME] [--credential-source-headers=[key=value,...]] [--credential-source-type=CREDENTIAL_SOURCE_TYPE] [--enable-imdsv2] [--subject-token-type=SUBJECT_TOKEN_TYPE] + [--credential-cert-private-key-path=CREDENTIAL_CERT_PRIVATE_KEY_PATH + : --credential-cert-configuration-output-file=CREDENTIAL_CERT_CONFIGURATION_OUTPUT_FILE] [--executable-output-file=EXECUTABLE_OUTPUT_FILE --executable-timeout-millis=EXECUTABLE_TIMEOUT_MILLIS] [--service-account=SERVICE_ACCOUNT @@ -69,6 +72,17 @@ EXAMPLES --app-id-uri=$URI_FOR_AZURE_APP_ID \ --output-file=credentials.json + To create an X.509 certificate-based credential configuration for your + project, run: + + $ gcloud beta iam workload-identity-pools create-cred-config \ + projects/$PROJECT_NUMBER/locations/$REGION/\ + workloadIdentityPools/$WORKLOAD_POOL_ID/providers/$PROVIDER_ID \ + --service-account=$EMAIL \ + --credential-cert-path=$PATH_TO_CERTIFICATE_FILE \ + --credential-cert-private-key-path=$PATH_TO_PRIVATE_KEY_FILE \ + --output-file=credentials.json + To use the resulting file for any of these commands, set the GOOGLE_APPLICATION_CREDENTIALS environment variable to point to the generated file @@ -91,6 +105,9 @@ REQUIRED FLAGS --azure Use Azure. + --credential-cert-path=CREDENTIAL_CERT_PATH + Path of the X.509 certificate file. + --credential-source-file=CREDENTIAL_SOURCE_FILE Location of the credential source file. @@ -122,6 +139,20 @@ OPTIONAL FLAGS The type of token being used for authorization. This defaults to urn:ietf:params:oauth:token-type:jwt. + Arguments for an X.509 certificate type credential source. + + --credential-cert-private-key-path=CREDENTIAL_CERT_PRIVATE_KEY_PATH + Path of the X.509 private key file. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --credential-cert-configuration-output-file=CREDENTIAL_CERT_CONFIGURATION_OUTPUT_FILE + Path for the certificate configuration file. If specified, a + certificate configuration file will be created at the specified path. + If not specified, the certificate configuration will be created at + the default gcloud location. + Arguments for an executable type credential source. --executable-output-file=EXECUTABLE_OUTPUT_FILE diff --git a/gcloud/beta/network-security/help b/gcloud/beta/network-security/help index 26585d454..0c76dd4d8 100644 --- a/gcloud/beta/network-security/help +++ b/gcloud/beta/network-security/help @@ -33,6 +33,15 @@ GROUPS gateway-security-policies (BETA) Manage Network Security Gateway Security Policies. + mirroring-deployment-groups + (BETA) Manage Mirroring Deployment Group resources. + + mirroring-deployments + (BETA) Manage Mirroing Deployment resources. + + mirroring-endpoint-groups + (BETA) Manage Mirroring Endpoint Group resources. + org-address-groups (BETA) Manage Network Security AddressGroups. diff --git a/gcloud/beta/network-security/mirroring-deployment-groups/create b/gcloud/beta/network-security/mirroring-deployment-groups/create new file mode 100644 index 000000000..5e1aabf55 --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployment-groups/create @@ -0,0 +1,123 @@ +NAME + gcloud beta network-security mirroring-deployment-groups create - create a + Mirroring Deployment Group + +SYNOPSIS + gcloud beta network-security mirroring-deployment-groups create + (MIRRORING_DEPLOYMENT_GROUP : --location=LOCATION) --network=NETWORK + [--async] [--labels=[KEY=VALUE,...]] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a mirroring deployment group. Successful creation of a + deployment group results in a deployment group in ACTIVE state. Check the + progress of deployment group creation by using gcloud network-security + mirroring-deployment-groups list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To create a mirroring deployment group called my-deployment-group, in + project ID my-project, run: $ gcloud beta network-security mirroring-deployment-groups create \ + my-deployment-group --project=my-project --location=global \ + --network=my-network + + OR + + $ gcloud beta network-security mirroring-deployment-groups create \ + my-deployment-group --project=my-project --location=global \ + --network=projects/my-project/global/networks/my-network + + OR + + $ gcloud beta network-security mirroring-deployment-groups create \ + projects/my-project/locations/global/mirroringDeploymentGroups/\ + my-deployment-group \ + --network=projects/my-project/global/networks/my-network + +POSITIONAL ARGUMENTS + Mirroring deployment group resource - Mirroring Deployment Group. 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 MIRRORING_DEPLOYMENT_GROUP 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. + + MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the deployment-group-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + Network resource - Mirroring Deployment Group. 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 --network 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. + + --network=NETWORK + ID of the network or fully qualified identifier for the network. + + To set the network-name attribute: + ▸ provide the argument --network on the command line. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployment-groups create + diff --git a/gcloud/beta/network-security/mirroring-deployment-groups/delete b/gcloud/beta/network-security/mirroring-deployment-groups/delete new file mode 100644 index 000000000..db08c35e4 --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployment-groups/delete @@ -0,0 +1,88 @@ +NAME + gcloud beta network-security mirroring-deployment-groups delete - delete a + Mirroring Deployment Group + +SYNOPSIS + gcloud beta network-security mirroring-deployment-groups delete + (MIRRORING_DEPLOYMENT_GROUP : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a mirroring deployment group. Check the progress of + deployment group deletion by using gcloud network-security + mirroring-deployment-groups list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To delete a mirroring deployment group called my-deployment-group, in + project ID my-project, run: + + $ gcloud beta network-security mirroring-deployment-groups delete \ + my-deployment-group --project=my-project --location=global + + OR + + $ gcloud beta network-security mirroring-deployment-groups delete \ + projects/my-project/locations/global/mirroringDeploymentGroups/\ + my-deployment-group + +POSITIONAL ARGUMENTS + Mirroring deployment group resource - Mirroring Deployment Group. 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 MIRRORING_DEPLOYMENT_GROUP 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. + + MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the deployment-group-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployment-groups delete + diff --git a/gcloud/beta/network-security/mirroring-deployment-groups/describe b/gcloud/beta/network-security/mirroring-deployment-groups/describe new file mode 100644 index 000000000..1612a0b85 --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployment-groups/describe @@ -0,0 +1,74 @@ +NAME + gcloud beta network-security mirroring-deployment-groups describe - + describe a Mirroring Deployment Group + +SYNOPSIS + gcloud beta network-security mirroring-deployment-groups describe + (MIRRORING_DEPLOYMENT_GROUP : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a mirroring deployment group. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To get a description of a mirroring deployment group called + my-deployment-group in project ID my-project, run: + + $ gcloud beta network-security mirroring-deployment-groups \ describe my-deployment-group --project=my-project \ + --location=global + + OR + + $ gcloud beta network-security mirroring-deployment-groups \ describe \ + projects/my-project/locations/global/mirroringDeploymentGroups/\ + my-deployment-group + +POSITIONAL ARGUMENTS + Mirroring deployment group resource - Mirroring Deployment Group. 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 MIRRORING_DEPLOYMENT_GROUP 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. + + MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the deployment-group-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployment-groups describe + diff --git a/gcloud/beta/network-security/mirroring-deployment-groups/help b/gcloud/beta/network-security/mirroring-deployment-groups/help new file mode 100644 index 000000000..a5422028a --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployment-groups/help @@ -0,0 +1,44 @@ +NAME + gcloud beta network-security mirroring-deployment-groups - manage Mirroring + Deployment Group resources + +SYNOPSIS + gcloud beta network-security mirroring-deployment-groups COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This class provides commands for managing Mirroring Deployment + Groups. + + Attributes: category (str): The category under which this command group + falls. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Mirroring Deployment Group. + + delete + (BETA) Delete a Mirroring Deployment Group. + + describe + (BETA) Describe a Mirroring Deployment Group. + + list + (BETA) List Mirroring Deployment Groups. + + update + (BETA) Update a Mirroring Deployment Group. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployment-groups + diff --git a/gcloud/beta/network-security/mirroring-deployment-groups/list b/gcloud/beta/network-security/mirroring-deployment-groups/list new file mode 100644 index 000000000..1b88092f5 --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployment-groups/list @@ -0,0 +1,92 @@ +NAME + gcloud beta network-security mirroring-deployment-groups list - list + Mirroring Deployment Groups + +SYNOPSIS + gcloud beta network-security mirroring-deployment-groups list + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List mirroring deployment groups. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list mirroring deployment groups in project ID my-project, run: + + $ gcloud beta network-security mirroring-deployment-groups list \ + --location=global --project=my-project + + OR + + $ gcloud beta network-security mirroring-deployment-groups list \ + --location=global + +FLAGS + Location resource - The location for a list operation This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ Location of the Mirroring Deployment Group. Defaults to global with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ Location of the Mirroring Deployment Group. Defaults to global. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployment-groups list + diff --git a/gcloud/beta/network-security/mirroring-deployment-groups/update b/gcloud/beta/network-security/mirroring-deployment-groups/update new file mode 100644 index 000000000..f42a43ecf --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployment-groups/update @@ -0,0 +1,125 @@ +NAME + gcloud beta network-security mirroring-deployment-groups update - update a + Mirroring Deployment Group + +SYNOPSIS + gcloud beta network-security mirroring-deployment-groups update + (MIRRORING_DEPLOYMENT_GROUP : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a mirroring deployment group. Check the progress of + deployment group update by using gcloud network-security + mirroring-deployment-groups list. + + For examples refer to the EXAMPLES section below. + +EXAMPLES + To update labels k1 and k2, run: + + $ gcloud beta network-security mirroring-deployment-groups update \ + my-deployment-group --project=my-project --location=global \ + --update-labels=k1=v1,k2=v2 + + To remove labels k3 and k4, run: + + $ gcloud beta network-security mirroring-deployment-groups update \ + my-deployment-group --project=my-project --location=global \ + --remove-labels=k3,k4 + + To clear all labels from the mirroring deployment group, run: + + $ gcloud beta network-security mirroring-deployment-groups update \ + my-deployment-group --project=my-project --location=global \ + --clear-labels + +POSITIONAL ARGUMENTS + Mirroring deployment group resource - Mirroring Deployment Group. 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 MIRRORING_DEPLOYMENT_GROUP 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. + + MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the deployment-group-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT_GROUP on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta network-security mirroring-deployment-groups update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta network-security mirroring-deployment-groups update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployment-groups update + diff --git a/gcloud/beta/network-security/mirroring-deployments/create b/gcloud/beta/network-security/mirroring-deployments/create new file mode 100644 index 000000000..e22b53b8d --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployments/create @@ -0,0 +1,185 @@ +NAME + gcloud beta network-security mirroring-deployments create - create a + Mirroring Deployment + +SYNOPSIS + gcloud beta network-security mirroring-deployments create + (MIRRORING_DEPLOYMENT : --location=LOCATION) + (--forwarding-rule=FORWARDING_RULE + : --forwarding-rule-location=FORWARDING_RULE_LOCATION) + (--mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP + : --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION) + [--async] [--labels=[KEY=VALUE,...]] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a mirroring deployment. Successful creation of a deployment + results in a deployment in ACTIVE state. Check the progress of deployment + creation by using gcloud network-security mirroring-deployments list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To create a mirroring deployment called my-deployment, in project ID + my-project and zone us-central1-a, run: $ gcloud beta network-security mirroring-deployments create \ + my-deployment --project=my-project --location=us-central1-a \ + --deployment-group-location=global \ + --forwarding-rule=my-forwarding-rule \ + --forwarding-rule-location=us-central1 \ + --mirroring-deployment-group=my-deployment-group + + OR + + $ gcloud beta network-security mirroring-deployments create \ + my-deployment --project=my-project --location=us-central1-a \ + --forwarding-rule=projects/my-project/regions/us-central1/\ + forwardingRules/my-forwarding-rule \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/mirroringDeploymentGroups/my-deployment-group + + OR + + $ gcloud beta network-security mirroring-deployments create \ + projects/my-project/locations/us-central1/mirroringDeployments/\ + my-deployment \ + --forwarding-rule=projects/my-project/regions/us-central1/\ + forwardingRules/my-forwarding-rule \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/mirroringDeploymentGroups/my-deployment-group + +POSITIONAL ARGUMENTS + Mirroring deployment resource - Mirroring Deployment. 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 MIRRORING_DEPLOYMENT 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. + + MIRRORING_DEPLOYMENT + ID of the mirroring deployment or fully qualified identifier for the + mirroring deployment. + + To set the deployment-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + ForwardingRule resource - Mirroring Deployment Forwarding Rule. 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 --forwarding-rule 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. + + --forwarding-rule=FORWARDING_RULE + ID of the forwardingRule or fully qualified identifier for the + forwardingRule. + + To set the forwarding-rule-id attribute: + ▸ provide the argument --forwarding-rule on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --forwarding-rule-location=FORWARDING_RULE_LOCATION + The Cloud region for the forwardingRule. + + To set the forwarding-rule-location attribute: + ▸ provide the argument --forwarding-rule on the command line with a + fully specified name; + ▸ provide the argument --forwarding-rule-location on the command + line. + + Mirroring deployment group resource - Mirroring Deployment Group. 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 --mirroring-deployment-group 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. + + --mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the id attribute: + ▸ provide the argument --mirroring-deployment-group on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument --mirroring-deployment-group on the command + line with a fully specified name; + ▸ provide the argument --mirroring-deployment-group-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument + networksecurity.projects.locations.mirroringDeployments on the + command line with a fully specified name. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployments create + diff --git a/gcloud/beta/network-security/mirroring-deployments/delete b/gcloud/beta/network-security/mirroring-deployments/delete new file mode 100644 index 000000000..906eddfe2 --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployments/delete @@ -0,0 +1,80 @@ +NAME + gcloud beta network-security mirroring-deployments delete - delete a + Mirroring Deployment + +SYNOPSIS + gcloud beta network-security mirroring-deployments delete + (MIRRORING_DEPLOYMENT : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a mirroring deployment. Check the progress of deployment + deletion by using gcloud network-security mirroring-deployments list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To delete a mirroring deployment called my-deployment in location + us-central1, run: + + $ gcloud beta network-security mirroring-deployments delete \ + my-deployment --location=us-central1-a --project=my-project + +POSITIONAL ARGUMENTS + Mirroring deployment resource - Mirroring Deployment. 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 MIRRORING_DEPLOYMENT 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. + + MIRRORING_DEPLOYMENT + ID of the mirroring deployment or fully qualified identifier for the + mirroring deployment. + + To set the deployment-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployments delete + diff --git a/gcloud/beta/network-security/mirroring-deployments/describe b/gcloud/beta/network-security/mirroring-deployments/describe new file mode 100644 index 000000000..f5b3011ec --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployments/describe @@ -0,0 +1,72 @@ +NAME + gcloud beta network-security mirroring-deployments describe - describe a + Mirroring Deployment + +SYNOPSIS + gcloud beta network-security mirroring-deployments describe + (MIRRORING_DEPLOYMENT : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a mirroring deployment. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To get a description of a mirroring deployment called my-deployment in zone + us-central1-a, run: + + $ gcloud beta network-security mirroring-deployments describe \ + my-deployment --location=us-central1-a --project=my-project + + OR + + $ gcloud beta network-security mirroring-deployments describe \ + projects/my-project/locations/us-central1-a/\ + mirroringDeployments/my-deployment + +POSITIONAL ARGUMENTS + Mirroring deployment resource - Mirroring Deployment. 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 MIRRORING_DEPLOYMENT 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. + + MIRRORING_DEPLOYMENT + ID of the mirroring deployment or fully qualified identifier for the + mirroring deployment. + + To set the deployment-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployments describe + diff --git a/gcloud/beta/network-security/mirroring-deployments/help b/gcloud/beta/network-security/mirroring-deployments/help new file mode 100644 index 000000000..584d59a75 --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployments/help @@ -0,0 +1,43 @@ +NAME + gcloud beta network-security mirroring-deployments - manage Mirroing + Deployment resources + +SYNOPSIS + gcloud beta network-security mirroring-deployments COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This class provides commands for managing Mirroring Deployments. + + Attributes: category (str): The category under which this command group + falls. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Mirroring Deployment. + + delete + (BETA) Delete a Mirroring Deployment. + + describe + (BETA) Describe a Mirroring Deployment. + + list + (BETA) List Mirroring Deployments. + + update + (BETA) Update a Mirroring Deployment. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployments + diff --git a/gcloud/beta/network-security/mirroring-deployments/list b/gcloud/beta/network-security/mirroring-deployments/list new file mode 100644 index 000000000..851ba10ab --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployments/list @@ -0,0 +1,93 @@ +NAME + gcloud beta network-security mirroring-deployments list - list Mirroring + Deployments + +SYNOPSIS + gcloud beta network-security mirroring-deployments list + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List mirroring deployments. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list mirroring deployments in project my-project and zone us-central1-a, + run: + + $ gcloud beta network-security mirroring-deployments list \ + --project=my-project --location=us-central1-a + + To list mirroring deployments from all zones, run: + + $ gcloud beta network-security mirroring-deployments list \ + --project=my-project --location=- + +FLAGS + Location resource - Zone of the deployment This represents a Cloud + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ Location of the Mirroring Deployment. Defaults to a wildcard with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ Location of the Mirroring Deployment. Defaults to a wildcard. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployments list + diff --git a/gcloud/beta/network-security/mirroring-deployments/update b/gcloud/beta/network-security/mirroring-deployments/update new file mode 100644 index 000000000..92fdf574b --- /dev/null +++ b/gcloud/beta/network-security/mirroring-deployments/update @@ -0,0 +1,123 @@ +NAME + gcloud beta network-security mirroring-deployments update - update a + Mirroring Deployment + +SYNOPSIS + gcloud beta network-security mirroring-deployments update + (MIRRORING_DEPLOYMENT : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a mirroring deployment. Check the progress of deployment + update by using gcloud network-security mirroring-deployments list. + + For examples refer to the EXAMPLES section below. + +EXAMPLES + To update labels k1 and k2, run: + + $ gcloud beta network-security mirroring-deployments update \ + my-deployment --project=my-project --location=us-central1-a \ + --update-labels=k1=v1,k2=v2 + + To remove labels k3 and k4, run: + + $ gcloud beta network-security mirroring-deployments update \ + my-deployment --project=my-project --location=us-central1-a \ + --remove-labels=k3,k4 + + To clear all labels from the mirroring deployment, run: + + $ gcloud beta network-security mirroring-deployments update \ + my-deploymen --project=my-project --location=us-central1-a \ + --clear-labels + +POSITIONAL ARGUMENTS + Mirroring deployment resource - Mirroring Deployment. 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 MIRRORING_DEPLOYMENT 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. + + MIRRORING_DEPLOYMENT + ID of the mirroring deployment or fully qualified identifier for the + mirroring deployment. + + To set the deployment-id attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring deployment. + + To set the location attribute: + ▸ provide the argument MIRRORING_DEPLOYMENT on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta network-security mirroring-deployments update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta network-security mirroring-deployments update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-deployments update + diff --git a/gcloud/beta/network-security/mirroring-endpoint-groups/create b/gcloud/beta/network-security/mirroring-endpoint-groups/create new file mode 100644 index 000000000..b4bc9fa92 --- /dev/null +++ b/gcloud/beta/network-security/mirroring-endpoint-groups/create @@ -0,0 +1,145 @@ +NAME + gcloud beta network-security mirroring-endpoint-groups create - create a + Mirroring Endpoint Group + +SYNOPSIS + gcloud beta network-security mirroring-endpoint-groups create + (MIRRORING_ENDPOINT_GROUP : --location=LOCATION) + (--mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP + : --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION) + [--async] [--labels=[KEY=VALUE,...]] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a mirroring endpoint group. Successful creation of an + endpoint group results in an endpoint group in ACTIVE state. Check the + progress of endpoint group creation by using gcloud network-security + mirroring-endpoint-groups list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To create a mirroring endpoint group called my-endpoint-group, in project + ID my-project, run: $ gcloud beta network-security mirroring-endpoint-groups create \ + my-endpoint-group --project=my-project --location=global \ + --mirroring-deployment-group=my-deployment-group + + OR + + $ gcloud beta network-security mirroring-endpoint-groups create \ + my-endpoint-group --project=my-project --location=global \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/mirroringDeploymentGroups/my-deployment-group + + OR + + $ gcloud beta network-security mirroring-endpoint-groups create \ + projects/my-project/locations/global/mirroringEndpointGroups/\ + my-endpoint-group \ + --mirroring-deployment-group=projects/my-project/locations/\ + global/mirroringDeploymentGroups/my-deployment-group + +POSITIONAL ARGUMENTS + Mirroring endpoint group resource - Mirroring Endpoint Group. 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 MIRRORING_ENDPOINT_GROUP 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. + + MIRRORING_ENDPOINT_GROUP + ID of the mirroring endpoint group or fully qualified identifier for + the mirroring endpoint group. + + To set the endpoint-group-id attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring endpoint group. + + To set the location attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + Mirroring deployment group resource - Mirroring Deployment Group. 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 --mirroring-deployment-group 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. + + --mirroring-deployment-group=MIRRORING_DEPLOYMENT_GROUP + ID of the mirroring deployment group or fully qualified identifier + for the mirroring deployment group. + + To set the id attribute: + ▸ provide the argument --mirroring-deployment-group on the command + line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --mirroring-deployment-group-location=MIRRORING_DEPLOYMENT_GROUP_LOCATION + Location of the mirroring deployment group. + + To set the location attribute: + ▸ provide the argument --mirroring-deployment-group on the command + line with a fully specified name; + ▸ provide the argument --mirroring-deployment-group-location on the + command line; + ▸ provide the argument --location on the command line; + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command line + with a fully specified name. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-endpoint-groups create + diff --git a/gcloud/beta/network-security/mirroring-endpoint-groups/delete b/gcloud/beta/network-security/mirroring-endpoint-groups/delete new file mode 100644 index 000000000..32292fda1 --- /dev/null +++ b/gcloud/beta/network-security/mirroring-endpoint-groups/delete @@ -0,0 +1,86 @@ +NAME + gcloud beta network-security mirroring-endpoint-groups delete - delete a + Mirroring Endpoint Group + +SYNOPSIS + gcloud beta network-security mirroring-endpoint-groups delete + (MIRRORING_ENDPOINT_GROUP : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a mirroring endpoint group. Check the progress of endpoint + group deletion by using gcloud network-security mirroring-endpoint-groups + list. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To delete a mirroring endpoint group called my-endpoint-group, in project + ID my-project, run: $ gcloud beta network-security mirroring-endpoint-groups delete \ + my-endpoint-group --project=my-project --location=global + + OR + + $ gcloud beta network-security mirroring-endpoint-groups delete \ + projects/my-project/locations/global/mirroringEndpointGroups/\ + my-endpoint-group + +POSITIONAL ARGUMENTS + Mirroring endpoint group resource - Mirroring Endpoint Group. 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 MIRRORING_ENDPOINT_GROUP 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. + + MIRRORING_ENDPOINT_GROUP + ID of the mirroring endpoint group or fully qualified identifier for + the mirroring endpoint group. + + To set the endpoint-group-id attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring endpoint group. + + To set the location attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-endpoint-groups delete + diff --git a/gcloud/beta/network-security/mirroring-endpoint-groups/describe b/gcloud/beta/network-security/mirroring-endpoint-groups/describe new file mode 100644 index 000000000..030ce59cf --- /dev/null +++ b/gcloud/beta/network-security/mirroring-endpoint-groups/describe @@ -0,0 +1,71 @@ +NAME + gcloud beta network-security mirroring-endpoint-groups describe - describe + a Mirroring Endpoint Group + +SYNOPSIS + gcloud beta network-security mirroring-endpoint-groups describe + (MIRRORING_ENDPOINT_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a mirroring endpoint group. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To get a description of a mirroring endpoint group called my-endpoint-group + in project ID my-project, run: $ gcloud beta network-security mirroring-endpoint-groups describe \ + my-endpoint-group --project=my-project --location=global + + OR + + $ gcloud beta network-security mirroring-endpoint-groups describe \ + projects/my-project/locations/global/mirroringEndpointGroups/\ + my-endpoint-group + +POSITIONAL ARGUMENTS + Mirroring endpoint group resource - Mirroring Endpoint Group. 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 MIRRORING_ENDPOINT_GROUP 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. + + MIRRORING_ENDPOINT_GROUP + ID of the mirroring endpoint group or fully qualified identifier for + the mirroring endpoint group. + + To set the endpoint-group-id attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring endpoint group. + + To set the location attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-endpoint-groups describe + diff --git a/gcloud/beta/network-security/mirroring-endpoint-groups/help b/gcloud/beta/network-security/mirroring-endpoint-groups/help new file mode 100644 index 000000000..1db441739 --- /dev/null +++ b/gcloud/beta/network-security/mirroring-endpoint-groups/help @@ -0,0 +1,43 @@ +NAME + gcloud beta network-security mirroring-endpoint-groups - manage Mirroring + Endpoint Group resources + +SYNOPSIS + gcloud beta network-security mirroring-endpoint-groups COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This class provides commands for managing Mirroring Endpoint Groups. + + Attributes: category (str): The category under which this command group + falls. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a Mirroring Endpoint Group. + + delete + (BETA) Delete a Mirroring Endpoint Group. + + describe + (BETA) Describe a Mirroring Endpoint Group. + + list + (BETA) List Mirroring Endpoint Groups. + + update + (BETA) Update a Mirroring Endpoint Group. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-endpoint-groups + diff --git a/gcloud/beta/network-security/mirroring-endpoint-groups/list b/gcloud/beta/network-security/mirroring-endpoint-groups/list new file mode 100644 index 000000000..d55aef4fd --- /dev/null +++ b/gcloud/beta/network-security/mirroring-endpoint-groups/list @@ -0,0 +1,100 @@ +NAME + gcloud beta network-security mirroring-endpoint-groups list - list + Mirroring Endpoint Groups + +SYNOPSIS + gcloud beta network-security mirroring-endpoint-groups list + [--location=LOCATION] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List mirroring endpoint groups. + + For more examples, refer to the EXAMPLES section below. + +EXAMPLES + To list mirroring endpoint groups in project ID my-project, run: $ gcloud beta network-security mirroring-endpoint-groups list \ + --project=my-project --location=global + + OR + + $ gcloud beta network-security mirroring-endpoint-groups list \ + --location=global + + OR + + $ gcloud beta network-security mirroring-endpoint-groups list \ + --location=projects/my-project/locations/global + + OR + + $ gcloud beta network-security mirroring-endpoint-groups list \ + projects/my-project/locations/global/mirroringEndpointGroups + +FLAGS + Location resource - The location for a list operation This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ Location of the Mirroring Endpoint Group. Defaults to global with a + fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line; + ▸ Location of the Mirroring Endpoint Group. Defaults to global. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-endpoint-groups list + diff --git a/gcloud/beta/network-security/mirroring-endpoint-groups/update b/gcloud/beta/network-security/mirroring-endpoint-groups/update new file mode 100644 index 000000000..96d9930ce --- /dev/null +++ b/gcloud/beta/network-security/mirroring-endpoint-groups/update @@ -0,0 +1,125 @@ +NAME + gcloud beta network-security mirroring-endpoint-groups update - update a + Mirroring Endpoint Group + +SYNOPSIS + gcloud beta network-security mirroring-endpoint-groups update + (MIRRORING_ENDPOINT_GROUP : --location=LOCATION) [--async] + [--max-wait=MAX_WAIT; default="20m"] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a mirroring endpoint groups. Check the progress of endpoint + group update by using gcloud network-security mirroring-endpoint-groups + list. + + For examples refer to the EXAMPLES section below. + +EXAMPLES + To update labels k1 and k2, run: + + $ gcloud beta network-security mirroring-endpoint-groups update \ + my-endpoint-group --project=my-project \ + --location=us-central1-a --update-labels=k1=v1,k2=v2 + + To remove labels k3 and k4, run: + + $ gcloud beta network-security mirroring-endpoint-groups update \ + my-endpoint-group --project=my-project \ + --location=us-central1-a --remove-labels=k3,k4 + + To clear all labels from the mirroring endpoint group, run: + + $ gcloud beta network-security mirroring-endpoint-groups update \ + my-endpoint-group --project=my-project \ + --location=us-central1-a --clear-labels + +POSITIONAL ARGUMENTS + Mirroring endpoint group resource - Mirroring Endpoint Group. 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 MIRRORING_ENDPOINT_GROUP 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. + + MIRRORING_ENDPOINT_GROUP + ID of the mirroring endpoint group or fully qualified identifier for + the mirroring endpoint group. + + To set the endpoint-group-id attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Location of the mirroring endpoint group. + + To set the location attribute: + ▸ provide the argument MIRRORING_ENDPOINT_GROUP on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. The default is True. Enabled by default, use --no-async to + disable. + + --max-wait=MAX_WAIT; default="20m" + Time to synchronously wait for the operation to complete, after which + the operation continues asynchronously. Ignored if --no-async isn't + specified. See $ gcloud topic datetimes for information on time + formats. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud beta network-security mirroring-endpoint-groups update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud beta network-security mirroring-endpoint-groups update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security mirroring-endpoint-groups update + diff --git a/gcloud/beta/redis/clusters/create b/gcloud/beta/redis/clusters/create index a7cd90764..f7f9ae94a 100644 --- a/gcloud/beta/redis/clusters/create +++ b/gcloud/beta/redis/clusters/create @@ -4,13 +4,13 @@ NAME SYNOPSIS gcloud beta redis clusters create (CLUSTER : --region=REGION) - --network=NETWORK --shard-count=SHARD_COUNT - [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] [--auth-mode=AUTH_MODE] - [--deletion-protection] [--node-type=NODE_TYPE] + --network=NETWORK [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] + [--auth-mode=AUTH_MODE] [--deletion-protection] [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,...]] [--replica-count=REPLICA_COUNT] + [--shard-count=SHARD_COUNT] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--zone=ZONE] [--zone-distribution-mode=ZONE_DISTRIBUTION_MODE] [GCLOUD_WIDE_FLAG ...] @@ -85,9 +85,6 @@ REQUIRED FLAGS used here must match the network ID used by the service connection policy. Otherwise, the create operation fails - --shard-count=SHARD_COUNT - The shard count of the cluster. - OPTIONAL FLAGS --aof-append-fsync=AOF_APPEND_FSYNC Fsync configuration. AOF_APPEND_FSYNC must be one of: @@ -163,6 +160,9 @@ OPTIONAL FLAGS --replica-count=REPLICA_COUNT The replica count of each shard. + --shard-count=SHARD_COUNT + The shard count of the cluster. + --transit-encryption-mode=TRANSIT_ENCRYPTION_MODE Transit encryption mode used for the Redis cluster. If not provided, encryption is disabled for the cluster. TRANSIT_ENCRYPTION_MODE must be diff --git a/gcloud/beta/redis/clusters/detach b/gcloud/beta/redis/clusters/detach new file mode 100644 index 000000000..717158c80 --- /dev/null +++ b/gcloud/beta/redis/clusters/detach @@ -0,0 +1,81 @@ +NAME + gcloud beta redis clusters detach - detach a secondary cluster + +SYNOPSIS + gcloud beta redis clusters detach (CLUSTER : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Detach a secondary cluster from the primary cluster. + + After detachment, the secondary cluster becomes an independent cluster, + i.e. it stops replicating from the primary cluster and it now accepts both + read and write requests. + + This command is only supported on secondary clusters. + +EXAMPLES + To detach a secondary cluster with name my-secondary-cluster in region + us-central1, run: + + $ gcloud beta redis clusters detach my-secondary-cluster \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Cluster resource - Arguments and flags that specify the Memorystore Redis + cluster you want to update. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the Redis region of the cluster. Overrides the default + redis/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property redis/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the redis/v1beta1 API. The full documentation for this + API can be found at: https://cloud.google.com/memorystore/docs/redis/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud redis clusters detach + + $ gcloud alpha redis clusters detach + diff --git a/gcloud/beta/redis/clusters/detach-secondaries b/gcloud/beta/redis/clusters/detach-secondaries new file mode 100644 index 000000000..90007ee27 --- /dev/null +++ b/gcloud/beta/redis/clusters/detach-secondaries @@ -0,0 +1,94 @@ +NAME + gcloud beta redis clusters detach-secondaries - detach one or more + secondary clusters from the primary cluster + +SYNOPSIS + gcloud beta redis clusters detach-secondaries (CLUSTER : --region=REGION) + --clusters-to-detach=CLUSTERS_TO_DETACH [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Detach one or more secondary clusters from the primary cluster. + + After detachment, the secondary clusters become independent clusters, i.e. + they stop replicating from the primary cluster and will now accept both + read and write requests. + + This command is only supported on primary clusters. + +EXAMPLES + To detach the secondary clusters my-secondary-cluster1 and + my-secondary-cluster2 from the primary cluster my-primary-cluster, run: + + $ gcloud beta redis clusters detach-secondaries my-primary-cluster \ + --region=us-central1 \ + --clusters-to-detach=projects/my-project/locations/us-east1/\ + clusters/my-secondary-cluster1,projects/my-project/locations/\ + asia-east1/clusters/my-secondary-cluster2 + +POSITIONAL ARGUMENTS + Cluster resource - Arguments and flags that specify the Memorystore Redis + cluster you want to update. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the Redis region of the cluster. Overrides the default + redis/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property redis/region. + +REQUIRED FLAGS + --clusters-to-detach=CLUSTERS_TO_DETACH + Comma separated list of secondary clusters to detach from the primary + cluster. + + Each element in the list should be in the format: + projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the redis/v1beta1 API. The full documentation for this + API can be found at: https://cloud.google.com/memorystore/docs/redis/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud redis clusters detach-secondaries + + $ gcloud alpha redis clusters detach-secondaries + diff --git a/gcloud/beta/redis/clusters/help b/gcloud/beta/redis/clusters/help index 575bef057..10333b1e7 100644 --- a/gcloud/beta/redis/clusters/help +++ b/gcloud/beta/redis/clusters/help @@ -24,6 +24,12 @@ COMMANDS describe (BETA) Show metadata for a Memorystore for Redis Cluster instance. + detach + (BETA) Detach a secondary cluster. + + detach-secondaries + (BETA) Detach one or more secondary clusters from the primary cluster. + get-cluster-certificate-authority (BETA) Get the certificate authority information for a Memorystore for Redis Cluster instance. @@ -31,6 +37,9 @@ COMMANDS list (BETA) List Memorystore for Redis Cluster instances. + switchover + (BETA) Switchover to a secondary cluster. + update (BETA) Update Memorystore Cluster for Redis instance. diff --git a/gcloud/beta/redis/clusters/switchover b/gcloud/beta/redis/clusters/switchover new file mode 100644 index 000000000..f3ae81e2f --- /dev/null +++ b/gcloud/beta/redis/clusters/switchover @@ -0,0 +1,82 @@ +NAME + gcloud beta redis clusters switchover - switchover to a secondary cluster + +SYNOPSIS + gcloud beta redis clusters switchover (CLUSTER : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) This command promotes the secondary cluster to become the new + primary cluster. The old primary and other secondary clusters will + automatically become the secondary clusters of this cluster. + + After the successful completion of this operation, the new primary cluster + will accept both read and write requests. + + This command is only supported on secondary clusters. + +EXAMPLES + To switchover to a secondary cluster with name my-secondary-cluster in + region us-central1, run: + + $ gcloud beta redis clusters switchover my-secondary-cluster \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Cluster resource - Arguments and flags that specify the Memorystore Redis + cluster you want to update. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the Redis region of the cluster. Overrides the default + redis/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property redis/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the redis/v1beta1 API. The full documentation for this + API can be found at: https://cloud.google.com/memorystore/docs/redis/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud redis clusters switchover + + $ gcloud alpha redis clusters switchover + diff --git a/gcloud/beta/run/deploy b/gcloud/beta/run/deploy index d1041f913..b0397444b 100644 --- a/gcloud/beta/run/deploy +++ b/gcloud/beta/run/deploy @@ -11,8 +11,8 @@ SYNOPSIS [--no-traffic] [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] - --cpu=CPU --depends-on=[CONTAINER,...] --memory=MEMORY --port=PORT - --remove-volume-mount=[MOUNT_PATH,...] + --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --memory=MEMORY + --port=PORT --remove-volume-mount=[MOUNT_PATH,...] --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -27,7 +27,7 @@ SYNOPSIS --clear-vpc-connector --[no-]cpu-boost --[no-]cpu-throttling --[no-]default-url --[no-]deploy-health-check --description=DESCRIPTION - --execution-environment=EXECUTION_ENVIRONMENT + --execution-environment=EXECUTION_ENVIRONMENT --gpu-type=GPU_TYPE --remove-containers=[CONTAINER,...] --revision-suffix=REVISION_SUFFIX --service-min-instances=SERVICE_MIN_INSTANCES --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS @@ -229,6 +229,10 @@ FLAGS --depends-on=[CONTAINER,...] List of container dependencies to add to the current container. + --gpu=GPU + Cloud Run supports values 0 or 1. 1 gpu also requires a minimum 4 + --cpu value 1 gpu also requires a minimum 8Gi --memory value. + --memory=MEMORY Set a memory limit. Ex: 1024Mi, 4Gi. @@ -460,6 +464,9 @@ FLAGS gen2 Run the application in a second generation execution environment. + --gpu-type=GPU_TYPE + The GPU type to use. + --remove-containers=[CONTAINER,...] List of containers to remove. diff --git a/gcloud/beta/run/services/update b/gcloud/beta/run/services/update index a18c6f5dd..130be2502 100644 --- a/gcloud/beta/run/services/update +++ b/gcloud/beta/run/services/update @@ -12,8 +12,8 @@ SYNOPSIS [--no-traffic] [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] - --cpu=CPU --depends-on=[CONTAINER,...] --image=IMAGE --memory=MEMORY - --port=PORT --remove-volume-mount=[MOUNT_PATH,...] + --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE + --memory=MEMORY --port=PORT --remove-volume-mount=[MOUNT_PATH,...] --[no-]use-http2 --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] --update-env-vars=[KEY=VALUE,...] --clear-secrets @@ -21,7 +21,7 @@ SYNOPSIS | --remove-secrets=[KEY,...] --update-secrets=[KEY=VALUE,...]] [--breakglass=JUSTIFICATION --clear-vpc-connector --[no-]cpu-boost --[no-]cpu-throttling --[no-]default-url --[no-]deploy-health-check - --execution-environment=EXECUTION_ENVIRONMENT + --execution-environment=EXECUTION_ENVIRONMENT --gpu-type=GPU_TYPE --remove-containers=[CONTAINER,...] --revision-suffix=REVISION_SUFFIX --service-min-instances=SERVICE_MIN_INSTANCES --[no-]session-affinity --vpc-connector=VPC_CONNECTOR --vpc-egress=VPC_EGRESS @@ -219,6 +219,10 @@ FLAGS --depends-on=[CONTAINER,...] List of container dependencies to add to the current container. + --gpu=GPU + Cloud Run supports values 0 or 1. 1 gpu also requires a minimum 4 + --cpu value 1 gpu also requires a minimum 8Gi --memory value. + --image=IMAGE Name of the container image to deploy (e.g. gcr.io/cloudrun/hello:latest). @@ -342,6 +346,9 @@ FLAGS gen2 Run the application in a second generation execution environment. + --gpu-type=GPU_TYPE + The GPU type to use. + --remove-containers=[CONTAINER,...] List of containers to remove. diff --git a/gcloud/certificate-manager/issuance-configs/help b/gcloud/certificate-manager/issuance-configs/help index 491943228..8decc5b66 100644 --- a/gcloud/certificate-manager/issuance-configs/help +++ b/gcloud/certificate-manager/issuance-configs/help @@ -28,6 +28,9 @@ COMMANDS list List all Certificate Issuance Configs in a project. + update + Update a Certificate Issuance Config. + NOTES These variants are also available: diff --git a/gcloud/certificate-manager/issuance-configs/update b/gcloud/certificate-manager/issuance-configs/update new file mode 100644 index 000000000..fb1e6ef20 --- /dev/null +++ b/gcloud/certificate-manager/issuance-configs/update @@ -0,0 +1,111 @@ +NAME + gcloud certificate-manager issuance-configs update - update a Certificate + Issuance Config + +SYNOPSIS + gcloud certificate-manager issuance-configs update + (CERTIFICATE_ISSUANCE_CONFIG : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a Certificate Issuance Config. + +EXAMPLES + To update a Certificate Issuance Config called my-cic, run: + + $ gcloud certificate-manager issuance-configs update my-cic \ + --description="updated description" \ + --update-labels=my-key1=my-updated-value1 \ + --remove-labels=my-key2 + +POSITIONAL ARGUMENTS + CertificateIssuanceConfig resource - Name of the Certificate Issuance + Config to update. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument certificate_issuance_config 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. + + CERTIFICATE_ISSUANCE_CONFIG + ID of the certificateIssuanceConfig or fully qualified identifier for + the certificateIssuanceConfig. + + To set the certificate_issuance_config attribute: + ▸ provide the argument certificate_issuance_config on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Certificate Manager location. + + To set the location attribute: + ▸ provide the argument certificate_issuance_config on the command + line with a fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + Human-readable description of the resource. + + --update-labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to update. If a label exists, its value + is modified. Otherwise, a new label is created. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + + At most one of these can be specified: + + --clear-labels + Remove all labels. If --update-labels is also specified then + --clear-labels is applied first. + + For example, to remove all labels: + + $ gcloud certificate-manager issuance-configs update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud certificate-manager issuance-configs update \ + --clear-labels --update-labels foo=bar,baz=qux + + --remove-labels=[KEY,...] + List of label keys to remove. If a label does not exist it is + silently ignored. If --update-labels is also specified then + --update-labels is applied first. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + These variants are also available: + + $ gcloud alpha certificate-manager issuance-configs update + + $ gcloud beta certificate-manager issuance-configs update + diff --git a/gcloud/compute/instances/perform-maintenance b/gcloud/compute/instances/perform-maintenance index 8c779c1c4..ea490c47d 100644 --- a/gcloud/compute/instances/perform-maintenance +++ b/gcloud/compute/instances/perform-maintenance @@ -3,8 +3,8 @@ NAME Google Compute Engine instance SYNOPSIS - gcloud compute instances perform-maintenance INSTANCE_NAME [--zone=ZONE] - [GCLOUD_WIDE_FLAG ...] + gcloud compute instances perform-maintenance INSTANCE_NAMES + [INSTANCE_NAMES ...] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Perform maintenance of Google Compute Engine instance. @@ -17,14 +17,14 @@ EXAMPLES --zone=us-east1-d POSITIONAL ARGUMENTS - INSTANCE_NAME - Name of the instance to operate on. For details on valid instance + INSTANCE_NAMES [INSTANCE_NAMES ...] + Names of the instances to operate on. For details on valid instance names, refer to the criteria documented under the field 'name' at: https://cloud.google.com/compute/docs/reference/rest/v1/instances FLAGS --zone=ZONE - Zone of the instance to operate on. If not specified, you might be + Zone of the instances to operate on. If not specified, you might be prompted to select a zone (interactive mode only). gcloud attempts to identify the appropriate zone by searching for resources in your currently active project. If the zone cannot be determined, gcloud diff --git a/gcloud/database-migration/connection-profiles/create/cloudsql b/gcloud/database-migration/connection-profiles/create/cloudsql index 11945399f..6405ed6cb 100644 --- a/gcloud/database-migration/connection-profiles/create/cloudsql +++ b/gcloud/database-migration/connection-profiles/create/cloudsql @@ -79,9 +79,9 @@ REQUIRED FLAGS Database engine type and version. DATABASE_VERSION must be one of: MYSQL_5_7, MYSQL_5_6, MYSQL_8_0, MYSQL_8_0_18, MYSQL_8_0_26, MYSQL_8_0_27, MYSQL_8_0_28, MYSQL_8_0_30, MYSQL_8_0_31, MYSQL_8_0_32, - MYSQL_8_0_33, MYSQL_8_0_34, MYSQL_8_0_35, MYSQL_8_0_36, POSTGRES_9_6, - POSTGRES_10, POSTGRES_11, POSTGRES_12, POSTGRES_13, POSTGRES_14, - POSTGRES_15, POSTGRES_16. + MYSQL_8_0_33, MYSQL_8_0_34, MYSQL_8_0_35, MYSQL_8_0_36, MYSQL_8_0_37, + POSTGRES_9_6, POSTGRES_10, POSTGRES_11, POSTGRES_12, POSTGRES_13, + POSTGRES_14, POSTGRES_15, POSTGRES_16. Connection profile resource - Database Migration Service source connection profile ID. This represents a Cloud resource. (NOTE) Some attributes are diff --git a/gcloud/database-migration/migration-jobs/create b/gcloud/database-migration/migration-jobs/create index 6bb0a27eb..465157926 100644 --- a/gcloud/database-migration/migration-jobs/create +++ b/gcloud/database-migration/migration-jobs/create @@ -15,9 +15,7 @@ SYNOPSIS [--peer-vpc=PEER_VPC | --static-ip | [--vm-ip=VM_IP --vm-port=VM_PORT --vpc=VPC : --vm=VM]] [--sqlserver-databases=databaseName,[...] - : --sqlserver-backup-file-pattern=SQLSERVER_BACKUP_FILE_PATTERN; - default=".(\\.|)(\\d)\\.(trn|bak|trn\\.final)" - --sqlserver-encrypted-databases=SQLSERVER_ENCRYPTED_DATABASES] + : --sqlserver-encrypted-databases=SQLSERVER_ENCRYPTED_DATABASES] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -305,16 +303,6 @@ OPTIONAL FLAGS This flag argument must be specified if any of the other arguments in this group are specified. - --sqlserver-backup-file-pattern=SQLSERVER_BACKUP_FILE_PATTERN; default=".(\\.|)(\\d)\\.(trn|bak|trn\\.final)" - Pattern that describes the default backup naming strategy. The - specified pattern should ensure lexicographical order of backups. The - pattern should define the following capture group set epoch - unix - timestamp Example: For backup files TestDB.1691448240.bak, - TestDB.1691448254.trn, TestDB.1691448284.trn.final use pattern: - .\.(\d)\.(trn|bak|trn\.final) or - .\.(\d)\.(trn|bak|trn\.final) This flag is used only for - SQL Server to Cloud SQL migrations. - --sqlserver-encrypted-databases=SQLSERVER_ENCRYPTED_DATABASES A JSON/YAML file describing the encryption settings per database for all encrytped databases. An example of a JSON request: [{ "database": diff --git a/gcloud/database-migration/migration-jobs/update b/gcloud/database-migration/migration-jobs/update index b677be140..e951e61c1 100644 --- a/gcloud/database-migration/migration-jobs/update +++ b/gcloud/database-migration/migration-jobs/update @@ -12,8 +12,7 @@ SYNOPSIS [--clear-labels | --remove-labels=[KEY,...]] [--peer-vpc=PEER_VPC | --static-ip | --vm=VM --vm-ip=VM_IP --vm-port=VM_PORT --vpc=VPC] - [--sqlserver-backup-file-pattern=SQLSERVER_BACKUP_FILE_PATTERN - --sqlserver-databases=databaseName,[...] + [--sqlserver-databases=databaseName,[...] --sqlserver-encrypted-databases=SQLSERVER_ENCRYPTED_DATABASES] [GCLOUD_WIDE_FLAG ...] @@ -209,16 +208,6 @@ FLAGS The SQL Server homogeneous migration config. This is used only for SQL Server to CloudSQL SQL Server migrations. - --sqlserver-backup-file-pattern=SQLSERVER_BACKUP_FILE_PATTERN - Pattern that describes the default backup naming strategy. The - specified pattern should ensure lexicographical order of backups. The - pattern should define the following capture group set epoch - unix - timestamp Example: For backup files TestDB.1691448240.bak, - TestDB.1691448254.trn, TestDB.1691448284.trn.final use pattern: - .\.(\d)\.(trn|bak|trn\.final) or - .\.(\d)\.(trn|bak|trn\.final) This flag is used only for - SQL Server to Cloud SQL migrations. - --sqlserver-databases=databaseName,[...] A list of databases to be migrated to the destination Cloud SQL instance. Provide databases as a comma separated list. This list diff --git a/gcloud/filestore/instances/create b/gcloud/filestore/instances/create index 4aa714d97..cf941fe9e 100644 --- a/gcloud/filestore/instances/create +++ b/gcloud/filestore/instances/create @@ -10,8 +10,8 @@ SYNOPSIS [name=NAME],[reserved-ip-range=RESERVED-IP-RANGE] [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] [--location=LOCATION] - [--performance=[iops-by-capacity],[max-read-iops=MAX-READ-IOPS], - [max-read-iops-per-gb=MAX-READ-IOPS-PER-GB]] [--region=REGION] + [--performance=[max-read-iops=MAX-READ-IOPS], + [max-read-iops-per-tb=MAX-READ-IOPS-PER-TB]] [--region=REGION] [--source-instance=SOURCE_INSTANCE] [--tier=TIER; default="BASIC_HDD"] [--kms-key=KMS_KEY : --kms-keyring=KMS_KEYRING --kms-location=KMS_LOCATION --kms-project=KMS_PROJECT] @@ -209,57 +209,42 @@ OPTIONAL FLAGS --location=LOCATION Location of the Cloud Filestore instance/operation. - --performance=[iops-by-capacity],[max-read-iops=MAX-READ-IOPS],[max-read-iops-per-gb=MAX-READ-IOPS-PER-GB] + --performance=[max-read-iops=MAX-READ-IOPS],[max-read-iops-per-tb=MAX-READ-IOPS-PER-TB] Performance configuration for the instance. This flag is used to configure the read IOPS provisioned for the instance. The instance's write IOPS and read/write throughputs will be derived from the configured read IOPS. For more information about the derived - performance limits see + performance limits and default performance see: https://cloud.google.com/filestore/docs/performance. Must be one of: - iops-by-capacity - Default configuration. Automatically provisions the instance IOPS - based on its capacity. If the user changes the instance capacity, - IOPS will be automatically adjusted accordingly. The available IOPS - for a given capacity can be found here: https://cloud.google.com/filestore/docs/performance. - max-read-iops The number of IOPS to provision for the instance. MAX-READ-IOPS must be in multiple of 1000 and in the supported IOPS range for the current capacity of the instance. For more details, see: https://cloud.google.com/filestore/docs/performance. - max-read-iops-per-gb + max-read-iops-per-tb Is used for setting the max IOPS of the instance by - specifying the IOPS per GB. When this parameter is used, the + specifying the IOPS per TB. When this parameter is used, the max IOPS are derived from the instance capacity: The instance max IOPS will be calculated by multiplying the - capacity of the instance (GB) by MAX-READ-IOPS-PER-GB, and rounding + capacity of the instance (TB) by MAX-READ-IOPS-PER-TB, and rounding to the nearest 1000. The max IOPS will be changed dynamically based on the instance capacity. - MAX-READ-IOPS-PER-GB must be in the supported range of the instance. + MAX-READ-IOPS-PER-TB must be in the supported range of the instance. For more details, see: https://cloud.google.com/filestore/docs/performance. Examples: - Configure an instance implicitly with iops_by_capacity performance: - - $ gcloud filestore instances create example-cluster - - Configure an instance explicitly with iops_by_capacity performance: - - $ gcloud filestore instances create example-cluster \ - --performance=iops_by_capacity - Configure an instance with max-read-iops performance: $ gcloud filestore instances create example-cluster \ - --performance=max-read-iops=1000 + --performance=max-read-iops=17000 - Configure an instance with max-read-iops-per-gb performance: + Configure an instance with max-read-iops-per-tb performance: $ gcloud filestore instances create example-cluster \ - --performance=max-read-iops-per-gb=5 + --performance=max-read-iops-per-tb=17000 --region=REGION Region of the Cloud Filestore instance. diff --git a/gcloud/filestore/instances/update b/gcloud/filestore/instances/update index 194feb47f..f9f81b056 100644 --- a/gcloud/filestore/instances/update +++ b/gcloud/filestore/instances/update @@ -3,11 +3,12 @@ NAME SYNOPSIS gcloud filestore instances update (INSTANCE : --zone=ZONE) [--async] - [--description=DESCRIPTION] [--location=LOCATION] - [--performance=[iops-by-capacity],[max-read-iops=MAX-READ-IOPS], - [max-read-iops-per-gb=MAX-READ-IOPS-PER-GB]] [--region=REGION] + [--description=DESCRIPTION] [--location=LOCATION] [--region=REGION] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] + [--clear-performance + | --performance=[max-read-iops=MAX-READ-IOPS], + [max-read-iops-per-tb=MAX-READ-IOPS-PER-TB]] [[--file-share=[capacity=CAPACITY], [name=NAME],[nfs-export-options=NFS-EXPORT-OPTIONS] : --clear-nfs-export-options]] [GCLOUD_WIDE_FLAG ...] @@ -104,58 +105,6 @@ FLAGS --location=LOCATION Location of the Cloud Filestore instance/operation. - --performance=[iops-by-capacity],[max-read-iops=MAX-READ-IOPS],[max-read-iops-per-gb=MAX-READ-IOPS-PER-GB] - Performance configuration for the instance. This flag is used to - configure the read IOPS provisioned for the instance. The instance's - write IOPS and read/write throughputs will be derived from the - configured read IOPS. For more information about the derived - performance limits see - https://cloud.google.com/filestore/docs/performance. Must be one of: - - iops-by-capacity - Default configuration. Automatically provisions the instance IOPS - based on its capacity. If the user changes the instance capacity, - IOPS will be automatically adjusted accordingly. The available IOPS - for a given capacity can be found here: https://cloud.google.com/filestore/docs/performance. - - max-read-iops - The number of IOPS to provision for the instance. - MAX-READ-IOPS must be in multiple of 1000 and in the supported IOPS - range for the current capacity of the instance. - For more details, see: https://cloud.google.com/filestore/docs/performance. - - max-read-iops-per-gb - Is used for setting the max IOPS of the instance by - specifying the IOPS per GB. When this parameter is used, the - max IOPS are derived from the instance capacity: - The instance max IOPS will be calculated by multiplying the - capacity of the instance (GB) by MAX-READ-IOPS-PER-GB, and rounding - to the nearest 1000. The max IOPS will be changed - dynamically based on the instance capacity. - MAX-READ-IOPS-PER-GB must be in the supported range of the instance. - For more details, see: https://cloud.google.com/filestore/docs/performance. - - Examples: - - Configure an instance implicitly with iops_by_capacity performance: - - $ gcloud filestore instances update example-cluster - - Configure an instance explicitly with iops_by_capacity performance: - - $ gcloud filestore instances update example-cluster \ - --performance=iops_by_capacity - - Configure an instance with max-read-iops performance: - - $ gcloud filestore instances update example-cluster \ - --performance=max-read-iops=1000 - - Configure an instance with max-read-iops-per-gb performance: - - $ gcloud filestore instances update example-cluster \ - --performance=max-read-iops-per-gb=5 - --region=REGION Region of the Cloud Filestore instance. @@ -188,6 +137,54 @@ FLAGS silently ignored. If --update-labels is also specified then --update-labels is applied first. + At most one of these can be specified: + + --clear-performance + Clear the performance configuration of the instance and set it to the + default performance mode. In the default performance mode, the + instance performance will be automatically adjusted based on its + capacity (changes in the instance's capacity will automatically + adjust the instance's performance accordingly). For more information + about the default performance mode see: + https://cloud.google.com/filestore/docs/performance. + + --performance=[max-read-iops=MAX-READ-IOPS],[max-read-iops-per-tb=MAX-READ-IOPS-PER-TB] + Performance configuration for the instance. This flag is used to + configure the read IOPS provisioned for the instance. The instance's + write IOPS and read/write throughputs will be derived from the + configured read IOPS. For more information about the derived + performance limits and default performance see: + https://cloud.google.com/filestore/docs/performance. Must be one of: + + max-read-iops + The number of IOPS to provision for the instance. + MAX-READ-IOPS must be in multiple of 1000 and in the supported IOPS + range for the current capacity of the instance. + For more details, see: https://cloud.google.com/filestore/docs/performance. + + max-read-iops-per-tb + Is used for setting the max IOPS of the instance by + specifying the IOPS per TB. When this parameter is used, the + max IOPS are derived from the instance capacity: + The instance max IOPS will be calculated by multiplying the + capacity of the instance (TB) by MAX-READ-IOPS-PER-TB, and rounding + to the nearest 1000. The max IOPS will be changed + dynamically based on the instance capacity. + MAX-READ-IOPS-PER-TB must be in the supported range of the instance. + For more details, see: https://cloud.google.com/filestore/docs/performance. + + Examples: + + Configure an instance with max-read-iops performance: + + $ gcloud filestore instances update example-cluster \ + --performance=max-read-iops=17000 + + Configure an instance with max-read-iops-per-tb performance: + + $ gcloud filestore instances update example-cluster \ + --performance=max-read-iops-per-tb=17000 + Parameters for file-share. --file-share=[capacity=CAPACITY],[name=NAME],[nfs-export-options=NFS-EXPORT-OPTIONS] diff --git a/gcloud/firestore/databases/create b/gcloud/firestore/databases/create index b7ebe9ffe..31637d806 100644 --- a/gcloud/firestore/databases/create +++ b/gcloud/firestore/databases/create @@ -56,39 +56,43 @@ OPTIONAL FLAGS of the database's resource name. If database ID is not provided, (default) will be used as database ID. - This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/ - with first character a letter and the last a letter or a number. Must - not be UUID-like /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. + This value should be 4-63 characters. Valid characters are + /[a-z][0-9]-/ with first character a letter and the last a letter or a + number. Must not be UUID-like + /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/. - Using "(default)" database ID is also allowed. + Using "(default)" database ID is also allowed. --delete-protection Whether to enable delete protection on the created database. - If set to true, delete protection of the new database will be enabled - and delete operations will fail unless delete protection is disabled. + If set to true, delete protection of the new database will be enabled + and delete operations will fail unless delete protection is disabled. - Default to false. + Default to false. --enable-pitr Whether to enable Point In Time Recovery (PITR) on the created database. - If set to true, PITR on the new database will be enabled. By default, - this feature is not enabled. + If set to true, PITR on the new database will be enabled. By default, + this feature is not enabled. --kms-key-name=KMS_KEY_NAME The resource ID of a Cloud KMS key. If set, the database created will be a Customer-Managed Encryption Key (CMEK) database encrypted with this key. This feature is allowlist only in initial launch. - Only a key in the same location as this database is allowed to be used for encryption. - For Firestore's nam5 multi-region, this corresponds to Cloud KMS location us. - For Firestore's eur3 multi-region, this corresponds to Cloud KMS location europe. - See https://cloud.google.com/kms/docs/locations. + Only a key in the same location as this database is allowed to be used + for encryption. For Firestore's nam5 multi-region, this corresponds to + Cloud KMS location us. For Firestore's eur3 multi-region, this + corresponds to Cloud KMS location europe. See + https://cloud.google.com/kms/docs/locations. - This value should be the KMS key resource ID in the format of `projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}`. - How to retrieve this resource ID is listed at https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. + This value should be the KMS key resource ID in the format of + projects/{project_id}/locations/{kms_location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}. + How to retrieve this resource ID is listed at + https://cloud.google.com/kms/docs/getting-resource-ids#getting_the_id_for_a_key_and_version. --type=TYPE; default="firestore-native" The type of the database. TYPE must be one of: firestore-native, diff --git a/gcloud/iam/workforce-pools/providers/create-oidc b/gcloud/iam/workforce-pools/providers/create-oidc index b28279d0a..9293a2ea5 100644 --- a/gcloud/iam/workforce-pools/providers/create-oidc +++ b/gcloud/iam/workforce-pools/providers/create-oidc @@ -31,7 +31,8 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --attribute-mapping="google.subject=assertion.sub" \ + --disabled --detailed_audit_logging \ + --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ --issuer-uri="https://test-idp.com" \ diff --git a/gcloud/iam/workforce-pools/providers/create-saml b/gcloud/iam/workforce-pools/providers/create-saml index da979ac51..871abc138 100644 --- a/gcloud/iam/workforce-pools/providers/create-saml +++ b/gcloud/iam/workforce-pools/providers/create-saml @@ -23,7 +23,8 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --attribute-mapping="google.subject=assertion.sub" \ + --disabled --detailed_audit_logging \ + --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" \ --idp-metadata-path="path/to/metdata/file.xml" diff --git a/gcloud/iam/workforce-pools/providers/update-oidc b/gcloud/iam/workforce-pools/providers/update-oidc index b8f852ab7..ba1f25dc9 100644 --- a/gcloud/iam/workforce-pools/providers/update-oidc +++ b/gcloud/iam/workforce-pools/providers/update-oidc @@ -31,7 +31,8 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --attribute-mapping="google.subject=assertion.sub" \ + --disabled --detailed_audit_logging \ + --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" --client-id="client-id" \ --client-secret-value="client-secret" \ --issuer-uri="https://test-idp.com" \ diff --git a/gcloud/iam/workforce-pools/providers/update-saml b/gcloud/iam/workforce-pools/providers/update-saml index 4af3baa2c..708307558 100644 --- a/gcloud/iam/workforce-pools/providers/update-saml +++ b/gcloud/iam/workforce-pools/providers/update-saml @@ -23,7 +23,8 @@ EXAMPLES --workforce-pool="my-workforce-pool" --location="global" \ --display-name="My Workforce Pool Provider" \ --description="My workforce pool provider description." \ - --disabled --attribute-mapping="google.subject=assertion.sub" \ + --disabled --detailed_audit_logging \ + --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="true" \ --idp-metadata-path="path/to/metdata/file.xml" diff --git a/gcloud/iam/workload-identity-pools/create-cred-config b/gcloud/iam/workload-identity-pools/create-cred-config index f85201b36..9f7c6fce8 100644 --- a/gcloud/iam/workload-identity-pools/create-cred-config +++ b/gcloud/iam/workload-identity-pools/create-cred-config @@ -5,13 +5,16 @@ NAME SYNOPSIS gcloud iam workload-identity-pools create-cred-config AUDIENCE --output-file=OUTPUT_FILE - (--aws | --azure | --credential-source-file=CREDENTIAL_SOURCE_FILE + (--aws | --azure | --credential-cert-path=CREDENTIAL_CERT_PATH + | --credential-source-file=CREDENTIAL_SOURCE_FILE | --credential-source-url=CREDENTIAL_SOURCE_URL | --executable-command=EXECUTABLE_COMMAND) [--app-id-uri=APP_ID_URI] [--credential-source-field-name=CREDENTIAL_SOURCE_FIELD_NAME] [--credential-source-headers=[key=value,...]] [--credential-source-type=CREDENTIAL_SOURCE_TYPE] [--enable-imdsv2] [--subject-token-type=SUBJECT_TOKEN_TYPE] + [--credential-cert-private-key-path=CREDENTIAL_CERT_PRIVATE_KEY_PATH + : --credential-cert-configuration-output-file=CREDENTIAL_CERT_CONFIGURATION_OUTPUT_FILE] [--executable-output-file=EXECUTABLE_OUTPUT_FILE --executable-timeout-millis=EXECUTABLE_TIMEOUT_MILLIS] [--service-account=SERVICE_ACCOUNT @@ -69,6 +72,17 @@ EXAMPLES --app-id-uri=$URI_FOR_AZURE_APP_ID \ --output-file=credentials.json + To create an X.509 certificate-based credential configuration for your + project, run: + + $ gcloud iam workload-identity-pools create-cred-config \ + projects/$PROJECT_NUMBER/locations/$REGION/\ + workloadIdentityPools/$WORKLOAD_POOL_ID/providers/$PROVIDER_ID \ + --service-account=$EMAIL \ + --credential-cert-path=$PATH_TO_CERTIFICATE_FILE \ + --credential-cert-private-key-path=$PATH_TO_PRIVATE_KEY_FILE \ + --output-file=credentials.json + To use the resulting file for any of these commands, set the GOOGLE_APPLICATION_CREDENTIALS environment variable to point to the generated file @@ -91,6 +105,9 @@ REQUIRED FLAGS --azure Use Azure. + --credential-cert-path=CREDENTIAL_CERT_PATH + Path of the X.509 certificate file. + --credential-source-file=CREDENTIAL_SOURCE_FILE Location of the credential source file. @@ -122,6 +139,20 @@ OPTIONAL FLAGS The type of token being used for authorization. This defaults to urn:ietf:params:oauth:token-type:jwt. + Arguments for an X.509 certificate type credential source. + + --credential-cert-private-key-path=CREDENTIAL_CERT_PRIVATE_KEY_PATH + Path of the X.509 private key file. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --credential-cert-configuration-output-file=CREDENTIAL_CERT_CONFIGURATION_OUTPUT_FILE + Path for the certificate configuration file. If specified, a + certificate configuration file will be created at the specified path. + If not specified, the certificate configuration will be created at + the default gcloud location. + Arguments for an executable type credential source. --executable-output-file=EXECUTABLE_OUTPUT_FILE diff --git a/gcloud/network-security/address-groups/create b/gcloud/network-security/address-groups/create index dbd657433..0ccdc50fe 100644 --- a/gcloud/network-security/address-groups/create +++ b/gcloud/network-security/address-groups/create @@ -5,7 +5,8 @@ SYNOPSIS gcloud network-security address-groups create (ADDRESS_GROUP : --location=LOCATION) --capacity=CAPACITY --type=TYPE [--async] [--description=DESCRIPTION] [--items=[ITEMS,...]] - [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + [--labels=[KEY=VALUE,...]] [--purpose=[PURPOSE,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new address group with the given name. @@ -70,6 +71,10 @@ OPTIONAL FLAGS --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. + --purpose=[PURPOSE,...] + List of Address Group purposes. PURPOSE must be one of: cloud-armor, + default. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/network-security/address-groups/update b/gcloud/network-security/address-groups/update index 6eb0ca7b2..6bb77182a 100644 --- a/gcloud/network-security/address-groups/update +++ b/gcloud/network-security/address-groups/update @@ -5,7 +5,7 @@ SYNOPSIS gcloud network-security address-groups update (ADDRESS_GROUP : --location=LOCATION) [--async] [--description=DESCRIPTION] [--items=[ITEMS,...]] - [--update-labels=[KEY=VALUE,...]] + [--purpose=[PURPOSE,...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -60,6 +60,10 @@ FLAGS --items=[ITEMS,...] Items of the address group. + --purpose=[PURPOSE,...] + List of Address Group purposes. PURPOSE must be one of: cloud-armor, + default. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/redis/clusters/create b/gcloud/redis/clusters/create index 89e39f773..c983e0275 100644 --- a/gcloud/redis/clusters/create +++ b/gcloud/redis/clusters/create @@ -4,12 +4,13 @@ NAME SYNOPSIS gcloud redis clusters create (CLUSTER : --region=REGION) --network=NETWORK - --shard-count=SHARD_COUNT [--aof-append-fsync=AOF_APPEND_FSYNC] - [--async] [--auth-mode=AUTH_MODE] [--deletion-protection] - [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] + [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] [--auth-mode=AUTH_MODE] + [--deletion-protection] [--node-type=NODE_TYPE] + [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,...]] [--replica-count=REPLICA_COUNT] + [--shard-count=SHARD_COUNT] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--zone=ZONE] [--zone-distribution-mode=ZONE_DISTRIBUTION_MODE] [GCLOUD_WIDE_FLAG ...] @@ -84,9 +85,6 @@ REQUIRED FLAGS used here must match the network ID used by the service connection policy. Otherwise, the create operation fails - --shard-count=SHARD_COUNT - The shard count of the cluster. - OPTIONAL FLAGS --aof-append-fsync=AOF_APPEND_FSYNC Fsync configuration. AOF_APPEND_FSYNC must be one of: @@ -162,6 +160,9 @@ OPTIONAL FLAGS --replica-count=REPLICA_COUNT The replica count of each shard. + --shard-count=SHARD_COUNT + The shard count of the cluster. + --transit-encryption-mode=TRANSIT_ENCRYPTION_MODE Transit encryption mode used for the Redis cluster. If not provided, encryption is disabled for the cluster. TRANSIT_ENCRYPTION_MODE must be diff --git a/gcloud/redis/clusters/detach b/gcloud/redis/clusters/detach new file mode 100644 index 000000000..77bb1dcc4 --- /dev/null +++ b/gcloud/redis/clusters/detach @@ -0,0 +1,80 @@ +NAME + gcloud redis clusters detach - detach a secondary cluster + +SYNOPSIS + gcloud redis clusters detach (CLUSTER : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Detach a secondary cluster from the primary cluster. + + After detachment, the secondary cluster becomes an independent cluster, + i.e. it stops replicating from the primary cluster and it now accepts both + read and write requests. + + This command is only supported on secondary clusters. + +EXAMPLES + To detach a secondary cluster with name my-secondary-cluster in region + us-central1, run: + + $ gcloud redis clusters detach my-secondary-cluster \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Cluster resource - Arguments and flags that specify the Memorystore Redis + cluster you want to update. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the Redis region of the cluster. Overrides the default + redis/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property redis/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the redis/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/memorystore/docs/redis/ + +NOTES + These variants are also available: + + $ gcloud alpha redis clusters detach + + $ gcloud beta redis clusters detach + diff --git a/gcloud/redis/clusters/detach-secondaries b/gcloud/redis/clusters/detach-secondaries new file mode 100644 index 000000000..d6c88421f --- /dev/null +++ b/gcloud/redis/clusters/detach-secondaries @@ -0,0 +1,93 @@ +NAME + gcloud redis clusters detach-secondaries - detach one or more secondary + clusters from the primary cluster + +SYNOPSIS + gcloud redis clusters detach-secondaries (CLUSTER : --region=REGION) + --clusters-to-detach=CLUSTERS_TO_DETACH [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Detach one or more secondary clusters from the primary cluster. + + After detachment, the secondary clusters become independent clusters, i.e. + they stop replicating from the primary cluster and will now accept both + read and write requests. + + This command is only supported on primary clusters. + +EXAMPLES + To detach the secondary clusters my-secondary-cluster1 and + my-secondary-cluster2 from the primary cluster my-primary-cluster, run: + + $ gcloud redis clusters detach-secondaries my-primary-cluster \ + --region=us-central1 \ + --clusters-to-detach=projects/my-project/locations/us-east1/\ + clusters/my-secondary-cluster1,projects/my-project/locations/\ + asia-east1/clusters/my-secondary-cluster2 + +POSITIONAL ARGUMENTS + Cluster resource - Arguments and flags that specify the Memorystore Redis + cluster you want to update. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the Redis region of the cluster. Overrides the default + redis/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property redis/region. + +REQUIRED FLAGS + --clusters-to-detach=CLUSTERS_TO_DETACH + Comma separated list of secondary clusters to detach from the primary + cluster. + + Each element in the list should be in the format: + projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the redis/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/memorystore/docs/redis/ + +NOTES + These variants are also available: + + $ gcloud alpha redis clusters detach-secondaries + + $ gcloud beta redis clusters detach-secondaries + diff --git a/gcloud/redis/clusters/help b/gcloud/redis/clusters/help index e22ec655a..9f9888d6f 100644 --- a/gcloud/redis/clusters/help +++ b/gcloud/redis/clusters/help @@ -24,6 +24,12 @@ COMMANDS describe Show metadata for a Memorystore for Redis Cluster instance. + detach + Detach a secondary cluster. + + detach-secondaries + Detach one or more secondary clusters from the primary cluster. + get-cluster-certificate-authority Get the certificate authority information for a Memorystore for Redis Cluster instance. @@ -31,6 +37,9 @@ COMMANDS list List Memorystore for Redis Cluster instances. + switchover + Switchover to a secondary cluster. + update Update Memorystore Cluster for Redis instance. diff --git a/gcloud/redis/clusters/switchover b/gcloud/redis/clusters/switchover new file mode 100644 index 000000000..b910dc76f --- /dev/null +++ b/gcloud/redis/clusters/switchover @@ -0,0 +1,81 @@ +NAME + gcloud redis clusters switchover - switchover to a secondary cluster + +SYNOPSIS + gcloud redis clusters switchover (CLUSTER : --region=REGION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + This command promotes the secondary cluster to become the new primary + cluster. The old primary and other secondary clusters will automatically + become the secondary clusters of this cluster. + + After the successful completion of this operation, the new primary cluster + will accept both read and write requests. + + This command is only supported on secondary clusters. + +EXAMPLES + To switchover to a secondary cluster with name my-secondary-cluster in + region us-central1, run: + + $ gcloud redis clusters switchover my-secondary-cluster \ + --region=us-central1 + +POSITIONAL ARGUMENTS + Cluster resource - Arguments and flags that specify the Memorystore Redis + cluster you want to update. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument cluster 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. + + 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. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --region=REGION + The name of the Redis region of the cluster. Overrides the default + redis/region property value for this command invocation. + + To set the region attribute: + ▸ provide the argument cluster on the command line with a fully + specified name; + ▸ provide the argument --region on the command line; + ▸ set the property redis/region. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the redis/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/memorystore/docs/redis/ + +NOTES + These variants are also available: + + $ gcloud alpha redis clusters switchover + + $ gcloud beta redis clusters switchover + diff --git a/gcloud/workstations/configs/create b/gcloud/workstations/configs/create index 511179fd5..f9e187e89 100644 --- a/gcloud/workstations/configs/create +++ b/gcloud/workstations/configs/create @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud workstations configs create - (CONFIG : --cluster=CLUSTER --region=REGION) [--async] + (CONFIG : --cluster=CLUSTER --region=REGION) + [--allowed-ports=[ALLOWED_PORTS,...]] [--async] [--boot-disk-size=BOOT_DISK_SIZE; default=50] [--container-args=[CONTAINER_ARGS,...]] [--container-command=[CONTAINER_COMMAND,...]] @@ -99,6 +100,38 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/region. FLAGS + --allowed-ports=[ALLOWED_PORTS,...] + A Single or Range of ports externally accessible in the workstation. If + not specified defaults to ports 22, 80 and ports 1024-65535. + + To specify a single port, both first and last should be same. + + Example: + + $ gcloud workstations configs create \ + --allowed-ports=first=9000,last=9090 + $ gcloud workstations configs create --allowed-ports=first=80,last=80 + + Sets allowed_ports value. + + first + Required, Sets first value. + + last + Required, Sets last value. + + Shorthand Example: + + --allowed-ports=first=int,last=int + + JSON Example: + + --allowed-ports='{"first": int, "last": int}' + + File Example: + + --allowed-ports=path_to_file.(yaml|json) + --async Return immediately, without waiting for the operation in progress to complete. diff --git a/gcloud/workstations/configs/update b/gcloud/workstations/configs/update index 81868e712..874fd7bb9 100644 --- a/gcloud/workstations/configs/update +++ b/gcloud/workstations/configs/update @@ -3,7 +3,8 @@ NAME SYNOPSIS gcloud workstations configs update - (CONFIG : --cluster=CLUSTER --region=REGION) [--async] + (CONFIG : --cluster=CLUSTER --region=REGION) + [--allowed-ports=[ALLOWED_PORTS,...]] [--async] [--boot-disk-size=BOOT_DISK_SIZE] [--container-args=[CONTAINER_ARGS,...]] [--container-command=[CONTAINER_COMMAND,...]] @@ -87,6 +88,38 @@ POSITIONAL ARGUMENTS ▸ set the property workstations/region. FLAGS + --allowed-ports=[ALLOWED_PORTS,...] + A Single or Range of ports externally accessible in the workstation. If + not specified defaults to ports 22, 80 and ports 1024-65535. + + To specify a single port, both first and last should be same. + + Example: + + $ gcloud workstations configs update \ + --allowed-ports=first=9000,last=9090 + $ gcloud workstations configs update --allowed-ports=first=80,last=80 + + Sets allowed_ports value. + + first + Required, Sets first value. + + last + Required, Sets last value. + + Shorthand Example: + + --allowed-ports=first=int,last=int + + JSON Example: + + --allowed-ports='{"first": int, "last": int}' + + File Example: + + --allowed-ports=path_to_file.(yaml|json) + --async Return immediately, without waiting for the operation in progress to complete.