diff --git a/gcloud/_version b/gcloud/_version index 24e567191..39c9f9c5b 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 536.0.1 -alpha 2025.08.27 -beta 2025.08.27 +Google Cloud SDK 537.0.0 +alpha 2025.08.29 +beta 2025.08.29 bq 2.1.22 bundled-python3-unix 3.12.9 -core 2025.08.27 +core 2025.08.29 gcloud-crc32c 1.0.0 gsutil 5.35 diff --git a/gcloud/ai/endpoints/deploy-model b/gcloud/ai/endpoints/deploy-model index 6abd416c9..4a083ded9 100644 --- a/gcloud/ai/endpoints/deploy-model +++ b/gcloud/ai/endpoints/deploy-model @@ -130,11 +130,13 @@ OPTIONAL FLAGS --min-replica-count=MIN_REPLICA_COUNT Minimum number of machine replicas for the deployment resources the - model will be deployed on. If specified, the value must be equal to or - larger than 1. + model will be deployed on. For normal deployments, the value must be + equal to or larger than 1. If the value is 0, the deployment will be + enrolled in the scale-to-zero feature. If not specified and the + uploaded models use dedicated resources, the default value is 1. - If not specified and the uploaded models use dedicated resources, the - default value is 1. + NOTE: DeploymentResourcePools (model-cohosting) is currently not + supported for scale-to-zero deployments. --reservation-affinity=[key=KEY],[reservation-affinity-type=RESERVATION-AFFINITY-TYPE],[values=VALUES] A ReservationAffinity can be used to configure a Vertex AI resource diff --git a/gcloud/alloydb/clusters/create b/gcloud/alloydb/clusters/create index 7ee141792..ee90da475 100644 --- a/gcloud/alloydb/clusters/create +++ b/gcloud/alloydb/clusters/create @@ -62,7 +62,7 @@ OPTIONAL FLAGS --database-version=DATABASE_VERSION Database version of the cluster. DATABASE_VERSION must be one of: - POSTGRES_14, POSTGRES_15, POSTGRES_16. + POSTGRES_14, POSTGRES_15, POSTGRES_16, POSTGRES_17. --enable-private-service-connect Enable Private Service Connect (PSC) connectivity for the cluster. diff --git a/gcloud/alloydb/clusters/migrate-cloud-sql b/gcloud/alloydb/clusters/migrate-cloud-sql index f9b8d4e54..52bcca3c8 100644 --- a/gcloud/alloydb/clusters/migrate-cloud-sql +++ b/gcloud/alloydb/clusters/migrate-cloud-sql @@ -88,7 +88,7 @@ OPTIONAL FLAGS --database-version=DATABASE_VERSION Database version of the cluster. DATABASE_VERSION must be one of: - POSTGRES_14, POSTGRES_15, POSTGRES_16. + POSTGRES_14, POSTGRES_15, POSTGRES_16, POSTGRES_17. --enable-private-service-connect Enable Private Service Connect (PSC) connectivity for the cluster. diff --git a/gcloud/alloydb/clusters/upgrade b/gcloud/alloydb/clusters/upgrade index f92832868..12a455c53 100644 --- a/gcloud/alloydb/clusters/upgrade +++ b/gcloud/alloydb/clusters/upgrade @@ -26,7 +26,7 @@ REQUIRED FLAGS --version=VERSION Target database version for the upgrade. VERSION must be one of: - POSTGRES_14, POSTGRES_15, POSTGRES_16. + POSTGRES_14, POSTGRES_15, POSTGRES_16, POSTGRES_17. OPTIONAL FLAGS --async diff --git a/gcloud/alpha/ai/endpoints/deploy-model b/gcloud/alpha/ai/endpoints/deploy-model index fe17e259c..2d83adff7 100644 --- a/gcloud/alpha/ai/endpoints/deploy-model +++ b/gcloud/alpha/ai/endpoints/deploy-model @@ -134,11 +134,13 @@ OPTIONAL FLAGS --min-replica-count=MIN_REPLICA_COUNT Minimum number of machine replicas for the deployment resources the - model will be deployed on. If specified, the value must be equal to or - larger than 1. + model will be deployed on. For normal deployments, the value must be + equal to or larger than 1. If the value is 0, the deployment will be + enrolled in the scale-to-zero feature. If not specified and the + uploaded models use dedicated resources, the default value is 1. - If not specified and the uploaded models use dedicated resources, the - default value is 1. + NOTE: DeploymentResourcePools (model-cohosting) is currently not + supported for scale-to-zero deployments. --multihost-gpu-node-count=MULTIHOST_GPU_NODE_COUNT The number of nodes per replica for multihost GPU deployments. Required diff --git a/gcloud/alpha/backup-dr/backup-plan-associations/fetch-for-resource-type b/gcloud/alpha/backup-dr/backup-plan-associations/fetch-for-resource-type index e30bdac02..ffd7905b3 100644 --- a/gcloud/alpha/backup-dr/backup-plan-associations/fetch-for-resource-type +++ b/gcloud/alpha/backup-dr/backup-plan-associations/fetch-for-resource-type @@ -77,5 +77,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud backup-dr backup-plan-associations fetch-for-resource-type diff --git a/gcloud/alpha/backup-dr/backup-plan-revisions/describe b/gcloud/alpha/backup-dr/backup-plan-revisions/describe index 9f147f1fc..c6cfa6754 100644 --- a/gcloud/alpha/backup-dr/backup-plan-revisions/describe +++ b/gcloud/alpha/backup-dr/backup-plan-revisions/describe @@ -72,5 +72,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud backup-dr backup-plan-revisions describe diff --git a/gcloud/alpha/backup-dr/backup-plan-revisions/help b/gcloud/alpha/backup-dr/backup-plan-revisions/help index 65b70fbe7..6553c6de8 100644 --- a/gcloud/alpha/backup-dr/backup-plan-revisions/help +++ b/gcloud/alpha/backup-dr/backup-plan-revisions/help @@ -26,5 +26,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud backup-dr backup-plan-revisions diff --git a/gcloud/alpha/backup-dr/backup-plan-revisions/list b/gcloud/alpha/backup-dr/backup-plan-revisions/list index 31e898834..f207c56ec 100644 --- a/gcloud/alpha/backup-dr/backup-plan-revisions/list +++ b/gcloud/alpha/backup-dr/backup-plan-revisions/list @@ -106,5 +106,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud backup-dr backup-plan-revisions list diff --git a/gcloud/alpha/composer/environments/create b/gcloud/alpha/composer/environments/create index 16de05515..e52c0e5f0 100644 --- a/gcloud/alpha/composer/environments/create +++ b/gcloud/alpha/composer/environments/create @@ -172,8 +172,8 @@ FLAGS --environment-size=ENVIRONMENT_SIZE Size of the environment. Unspecified means that the default option will - be chosen. ENVIRONMENT_SIZE must be one of: large, medium, small, - unspecified. + be chosen. ENVIRONMENT_SIZE must be one of: extra-large, large, medium, + small, unspecified. --labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to add. diff --git a/gcloud/alpha/composer/environments/update b/gcloud/alpha/composer/environments/update index a6868d270..0275c48db 100644 --- a/gcloud/alpha/composer/environments/update +++ b/gcloud/alpha/composer/environments/update @@ -140,8 +140,8 @@ REQUIRED FLAGS --environment-size=ENVIRONMENT_SIZE Size of the environment. Unspecified means that the default option - will be chosen. ENVIRONMENT_SIZE must be one of: large, medium, - small, unspecified. + will be chosen. ENVIRONMENT_SIZE must be one of: extra-large, large, + medium, small, unspecified. --node-count=NODE_COUNT The new number of nodes running the environment. Must be >= 3. diff --git a/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy b/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy index ab93dce77..0ac50637d 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy +++ b/gcloud/alpha/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy @@ -22,9 +22,10 @@ EXAMPLES To configure bandwidth percentage policy for an interconnect example-interconnect, run: - $ gcloud alpha compute interconnects application-awareness \ configure-bandwidth-percentage-policy example-interconnect \ - --bandwidth-percentages="TC1=5,TC2=5,TC3=75,TC4=5,TC5=5,TC6=5" \ - --enabled --profile_description="some string" + $ gcloud alpha compute interconnects application-awareness \ + configure-bandwidth-percentage-policy example-interconnect \ + --bandwidth-percentages="TC1=5,TC2=5,TC3=75,TC4=5,TC5=5,TC6=5" \ + --enabled --profile-description="some string" POSITIONAL ARGUMENTS NAME @@ -69,7 +70,10 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute interconnects application-awareness \ + configure-bandwidth-percentage-policy $ gcloud beta compute interconnects application-awareness \ configure-bandwidth-percentage-policy diff --git a/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage b/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage index 7ecfd28e6..fe6189bbc 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage +++ b/gcloud/alpha/compute/interconnects/application-awareness/configure-shaper-average-percentage @@ -24,9 +24,10 @@ EXAMPLES To configure shaper average percentage for an interconnect example-interconnect, run: - $ gcloud alpha compute interconnects application-awareness \ configure-shaper-average-percentage example-interconnect \ - --bandwidth-percentages="TC1=30,TC2=90" --enabled \ - --profile_description="some string" + $ gcloud alpha compute interconnects application-awareness \ + configure-shaper-average-percentage example-interconnect \ + --bandwidth-percentages="TC1=30,TC2=90 + --enabled --profile-description="some string" POSITIONAL ARGUMENTS NAME @@ -71,7 +72,10 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute interconnects application-awareness \ + configure-shaper-average-percentage $ gcloud beta compute interconnects application-awareness \ configure-shaper-average-percentage diff --git a/gcloud/alpha/compute/interconnects/application-awareness/configure-strict-priority-policy b/gcloud/alpha/compute/interconnects/application-awareness/configure-strict-priority-policy index f0da2d7aa..a027b30d4 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/configure-strict-priority-policy +++ b/gcloud/alpha/compute/interconnects/application-awareness/configure-strict-priority-policy @@ -48,7 +48,10 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute interconnects application-awareness \ + configure-strict-priority-policy $ gcloud beta compute interconnects application-awareness \ configure-strict-priority-policy diff --git a/gcloud/alpha/compute/interconnects/application-awareness/delete b/gcloud/alpha/compute/interconnects/application-awareness/delete index 97a70d65e..0ea5ff112 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/delete +++ b/gcloud/alpha/compute/interconnects/application-awareness/delete @@ -36,7 +36,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute interconnects application-awareness delete $ gcloud beta compute interconnects application-awareness delete diff --git a/gcloud/alpha/compute/interconnects/application-awareness/get-config b/gcloud/alpha/compute/interconnects/application-awareness/get-config index 86b56e65b..4d8114ceb 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/get-config +++ b/gcloud/alpha/compute/interconnects/application-awareness/get-config @@ -36,7 +36,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute interconnects application-awareness get-config $ gcloud beta compute interconnects application-awareness get-config diff --git a/gcloud/alpha/compute/interconnects/application-awareness/help b/gcloud/alpha/compute/interconnects/application-awareness/help index 12223a152..fc20cacd6 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/help +++ b/gcloud/alpha/compute/interconnects/application-awareness/help @@ -47,7 +47,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute interconnects application-awareness $ gcloud beta compute interconnects application-awareness diff --git a/gcloud/alpha/compute/interconnects/application-awareness/update b/gcloud/alpha/compute/interconnects/application-awareness/update index 3adb24eb7..b9fe18b70 100644 --- a/gcloud/alpha/compute/interconnects/application-awareness/update +++ b/gcloud/alpha/compute/interconnects/application-awareness/update @@ -46,7 +46,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud compute interconnects application-awareness update $ gcloud beta compute interconnects application-awareness update diff --git a/gcloud/alpha/compute/interconnects/attachments/dedicated/create b/gcloud/alpha/compute/interconnects/attachments/dedicated/create index 29cb0ebb5..12fa412c2 100644 --- a/gcloud/alpha/compute/interconnects/attachments/dedicated/create +++ b/gcloud/alpha/compute/interconnects/attachments/dedicated/create @@ -66,6 +66,8 @@ OPTIONAL FLAGS 50 Gbit/s 100g 100 Gbit/s + 400g + 400 Gbit/s --candidate-cloud-router-ip-address=CANDIDATE_CLOUD_ROUTER_IP_ADDRESS Single IPv4 address + prefix length to be configured on the cloud diff --git a/gcloud/alpha/compute/interconnects/attachments/dedicated/update b/gcloud/alpha/compute/interconnects/attachments/dedicated/update index 0b2280d5a..507c41768 100644 --- a/gcloud/alpha/compute/interconnects/attachments/dedicated/update +++ b/gcloud/alpha/compute/interconnects/attachments/dedicated/update @@ -55,6 +55,8 @@ FLAGS 50 Gbit/s 100g 100 Gbit/s + 400g + 400 Gbit/s --candidate-cloud-router-ipv6-address=CANDIDATE_CLOUD_ROUTER_IPV6_ADDRESS Single IPv6 address + prefix length to be configured on the cloud diff --git a/gcloud/alpha/compute/interconnects/create b/gcloud/alpha/compute/interconnects/create index 325297067..388367f3a 100644 --- a/gcloud/alpha/compute/interconnects/create +++ b/gcloud/alpha/compute/interconnects/create @@ -9,7 +9,8 @@ SYNOPSIS [--admin-enabled] [--customer-name=CUSTOMER_NAME] [--description=DESCRIPTION] [--noc-contact-email=NOC_CONTACT_EMAIL] [--remote-location=REMOTE_LOCATION] - [--requested-features=[FEATURES,...]] [GCLOUD_WIDE_FLAG ...] + [--requested-features=[FEATURES,...]] [--subzone=SUBZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute interconnects create is used to create @@ -118,6 +119,15 @@ OPTIONAL FLAGS only be provided during interconnect INSERT and cannot be changed using interconnect PATCH. + --subzone=SUBZONE + Subzone in the LOCATION specified by the --location flag. SUBZONE must + be one of: + + a + Subzone a. + b + Subzone b. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create index c1b125bbd..fba7aaf0c 100644 --- a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create +++ b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/create @@ -26,7 +26,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be inserted. Valid in [0, 65535]. + Priority of the rule to be inserted. Valid in [0, 2147483547]. REQUIRED FLAGS --action=ACTION diff --git a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/delete b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/delete index b3d94b0de..1d79f08cc 100644 --- a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/delete +++ b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/delete @@ -20,7 +20,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be deleted. Valid in [0, 65535]. + Priority of the rule to be deleted. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/describe b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/describe index 37f9bf592..477b87d05 100644 --- a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/describe +++ b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/describe @@ -22,7 +22,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be described. Valid in [0, 65535]. + Priority of the rule to be described. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update index 272f99e11..6efe7f787 100644 --- a/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update +++ b/gcloud/alpha/compute/network-firewall-policies/mirroring-rules/update @@ -28,7 +28,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be updated. Valid in [0, 65535]. + Priority of the rule to be updated. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/create b/gcloud/alpha/compute/network-firewall-policies/rules/create index e9907ed6f..bb83de34e 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/create +++ b/gcloud/alpha/compute/network-firewall-policies/rules/create @@ -49,7 +49,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be inserted. Valid in [0, 65535]. + Priority of the rule to be inserted. Valid in [0, 2147483547]. REQUIRED FLAGS --action=ACTION diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/delete b/gcloud/alpha/compute/network-firewall-policies/rules/delete index 356a6a67e..6e34aee2d 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/delete +++ b/gcloud/alpha/compute/network-firewall-policies/rules/delete @@ -27,7 +27,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be deleted. Valid in [0, 65535]. + Priority of the rule to be deleted. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/describe b/gcloud/alpha/compute/network-firewall-policies/rules/describe index 6bb17448f..b7d09db4a 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/describe +++ b/gcloud/alpha/compute/network-firewall-policies/rules/describe @@ -27,7 +27,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be described. Valid in [0, 65535]. + Priority of the rule to be described. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/alpha/compute/network-firewall-policies/rules/update b/gcloud/alpha/compute/network-firewall-policies/rules/update index 6815a819a..8e9289e1d 100644 --- a/gcloud/alpha/compute/network-firewall-policies/rules/update +++ b/gcloud/alpha/compute/network-firewall-policies/rules/update @@ -43,7 +43,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be updated. Valid in [0, 65535]. + Priority of the rule to be updated. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/alpha/compute/networks/subnets/create b/gcloud/alpha/compute/networks/subnets/create index 596a482ad..e3b8edea3 100644 --- a/gcloud/alpha/compute/networks/subnets/create +++ b/gcloud/alpha/compute/networks/subnets/create @@ -211,11 +211,15 @@ OPTIONAL FLAGS RESOLVE_SUBNET_MASK must be one of: ARP_ALL_RANGES - All IP ranges assigned to VM NICs in this subnet will respond to - ARP + VMs connected to this subnet receive ARP responses for IPv4 + addresses from any ranges of the subnet that are assigned to the + VM's NIC. The DHCP responses contain the netmask of the subnet, + instead of /32. ARP_PRIMARY_RANGE - Primary IP range of VM NICs in this subnet will respond to ARP. + VMs connected to this subnet receive ARP responses only for IP + addresses in the primary IPv4 range of the subnet. DHCP responses + contain the netmask of the subnet, instead of /32. --resource-manager-tags=[KEY=VALUE,...] A comma-separated list of Resource Manager tags to apply to the diff --git a/gcloud/alpha/compute/org-security-policies/rules/update b/gcloud/alpha/compute/org-security-policies/rules/update index b09fd2a6e..ab2c0d878 100644 --- a/gcloud/alpha/compute/org-security-policies/rules/update +++ b/gcloud/alpha/compute/org-security-policies/rules/update @@ -8,8 +8,8 @@ SYNOPSIS [--description=DESCRIPTION] [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--dest-ports=[DEST_PORTS,...]] [--direction=DIRECTION] [--[no-]enable-logging] [--layer4-configs=[LAYER4_CONFIG,...]] - [--new-priority=NEW_PRIORITY] [--organization=ORGANIZATION] [--preview] - [--target-resources=[TARGET_RESOURCES,...]] + [--new-priority=NEW_PRIORITY] [--organization=ORGANIZATION] + [--[no-]preview] [--target-resources=[TARGET_RESOURCES,...]] [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] [--expression=EXPRESSION | --src-ip-ranges=[SRC_IP_RANGE,...]] [GCLOUD_WIDE_FLAG ...] @@ -94,8 +94,9 @@ OPTIONAL FLAGS Organization which the organization security policy belongs to. Must be set if SECURITY_POLICY is short name. - --preview - If specified, the action will not be enforced. + --[no-]preview + If specified, the action will not be enforced. Use --preview to enable + and --no-preview to disable. --target-resources=[TARGET_RESOURCES,...] List of URLs of target resources to which the rule is applied. diff --git a/gcloud/alpha/compute/reservations/sub-blocks/help b/gcloud/alpha/compute/reservations/sub-blocks/help index 4027d0d60..3795c65cd 100644 --- a/gcloud/alpha/compute/reservations/sub-blocks/help +++ b/gcloud/alpha/compute/reservations/sub-blocks/help @@ -25,6 +25,9 @@ COMMANDS perform-maintenance (ALPHA) Perform maintenance on a reservation sub-block. + report-subblock-as-faulty + (ALPHA) Report a faulty reservation sub block. + 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/compute/reservations/sub-blocks/report-subblock-as-faulty b/gcloud/alpha/compute/reservations/sub-blocks/report-subblock-as-faulty new file mode 100644 index 000000000..d563412fd --- /dev/null +++ b/gcloud/alpha/compute/reservations/sub-blocks/report-subblock-as-faulty @@ -0,0 +1,95 @@ +NAME + gcloud alpha compute reservations sub-blocks report-subblock-as-faulty - + report a faulty reservation sub block + +SYNOPSIS + gcloud alpha compute reservations sub-blocks report-subblock-as-faulty + RESERVATION --block-name=BLOCK_NAME + --disruption-schedule=DISRUPTION_SCHEDULE + --failure-component=FAILURE_COMPONENT + --fault-reasons=[behavior=BEHAVIOR],[description=DESCRIPTION] + --sub-block-name=SUB_BLOCK_NAME [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Report a faulty reservation sub block. + +EXAMPLES + To report reservation exr-1 in ZONE with block name block-1 and sub block + name sub-block-1 as faulty, run: + + $ gcloud alpha compute reservations sub-blocks \ + report-subblock-as-faulty exr-1 --zone=ZONE \ + --block-name=block-1 --sub-block-name=sub-block-1 \ + --disruption-schedule=IMMEDIATE \ + --fault-reasons=behavior=PERFORMANCE,description="performance \ + issues" --failure-component=NVLINK_SWITCH + +POSITIONAL ARGUMENTS + RESERVATION + Name of the reservation to report-subblock-as-faulty. + +REQUIRED FLAGS + --block-name=BLOCK_NAME + The name of the reservation block. + + --disruption-schedule=DISRUPTION_SCHEDULE + The disruption schedule for the sub-block. DISRUPTION_SCHEDULE must be + (only one value is supported): + + IMMEDIATE + All VMs will be disrupted immediately. + + --failure-component=FAILURE_COMPONENT + The component that experienced the fault. FAILURE_COMPONENT must be one + of: + + MULTIPLE_FAULTY_HOSTS + Multiple hosts experienced the fault. + NVLINK_SWITCH + The NVLink switch experienced the fault. + + --fault-reasons=[behavior=BEHAVIOR],[description=DESCRIPTION] + The reasons for the fault experienced with the sub-block. This flag can + be repeated. Each instance should specify a "behavior" and an optional + "description". The possible values for "behavior" are: PERFORMANCE, + SWITCH_FAILURE, GPU_ERROR. + + --sub-block-name=SUB_BLOCK_NAME + The name of the reservation sub block. + +OPTIONAL FLAGS + --zone=ZONE + Zone of the reservation to report-subblock-as-faulty. If not specified + and the compute/zone property isn't set, you might be prompted to + select a zone (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/security-policies/rules/update b/gcloud/alpha/compute/security-policies/rules/update index 78c6049af..37a55c140 100644 --- a/gcloud/alpha/compute/security-policies/rules/update +++ b/gcloud/alpha/compute/security-policies/rules/update @@ -18,7 +18,7 @@ SYNOPSIS [--exceed-action-rpc-status-code=EXCEED_ACTION_RPC_STATUS_CODE] [--exceed-action-rpc-status-message=EXCEED_ACTION_RPC_STATUS_MESSAGE] [--exceed-redirect-target=EXCEED_REDIRECT_TARGET] - [--exceed-redirect-type=EXCEED_REDIRECT_TYPE] [--preview] + [--exceed-redirect-type=EXCEED_REDIRECT_TYPE] [--[no-]preview] [--rate-limit-threshold-count=RATE_LIMIT_THRESHOLD_COUNT] [--rate-limit-threshold-interval-sec=RATE_LIMIT_THRESHOLD_INTERVAL_SEC] [--recaptcha-action-site-keys=[SITE_KEY,...]] @@ -207,8 +207,9 @@ FLAGS Type for the redirect action that is configured as the exceed action. EXCEED_REDIRECT_TYPE must be one of: google-recaptcha, external-302. - --preview - If specified, the action will not be enforced. + --[no-]preview + If specified, the action will not be enforced. Use --preview to enable + and --no-preview to disable. --rate-limit-threshold-count=RATE_LIMIT_THRESHOLD_COUNT Number of HTTP(S) requests for calculating the threshold for rate diff --git a/gcloud/alpha/compute/zone-vm-extension-policies/create b/gcloud/alpha/compute/zone-vm-extension-policies/create index adb301d5b..abd74bfb5 100644 --- a/gcloud/alpha/compute/zone-vm-extension-policies/create +++ b/gcloud/alpha/compute/zone-vm-extension-policies/create @@ -10,7 +10,9 @@ SYNOPSIS [--inclusion-labels=INCLUSION_LABELS] [--ops-agent-config=OPS_AGENT_CONFIG] [--ops-agent-version=OPS_AGENT_VERSION] - [--priority=PRIORITY; default=1000] [--zone=ZONE] + [--priority=PRIORITY; default=1000] + [--sap-extension-config=SAP_EXTENSION_CONFIG] + [--sap-extension-version=SAP_EXTENSION_VERSION] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -33,7 +35,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --extensions=EXTENSIONS A list of extensions to be added to the policy. EXTENSIONS must be one - of: filestore, ops-agent. + of: filestore, ops-agent, sap-extension. OPTIONAL FLAGS --description=DESCRIPTION @@ -84,6 +86,15 @@ OPTIONAL FLAGS Range from 0 to 65535. Default is 1000. + --sap-extension-config=SAP_EXTENSION_CONFIG + The config send to the extension when extension starts. + + --sap-extension-version=SAP_EXTENSION_VERSION + The pinned version for sap-extension. + + If not specified, the latest version will be used, and will be upgraded + automatically. + --zone=ZONE Zone of the zone vm extension policy to create. If not specified and the compute/zone property isn't set, you might be prompted to select a diff --git a/gcloud/alpha/compute/zone-vm-extension-policies/update b/gcloud/alpha/compute/zone-vm-extension-policies/update index 1e88fe392..d9371e364 100644 --- a/gcloud/alpha/compute/zone-vm-extension-policies/update +++ b/gcloud/alpha/compute/zone-vm-extension-policies/update @@ -10,7 +10,9 @@ SYNOPSIS [--inclusion-labels=INCLUSION_LABELS] [--ops-agent-config=OPS_AGENT_CONFIG] [--ops-agent-version=OPS_AGENT_VERSION] - [--priority=PRIORITY; default=1000] [--zone=ZONE] + [--priority=PRIORITY; default=1000] + [--sap-extension-config=SAP_EXTENSION_CONFIG] + [--sap-extension-version=SAP_EXTENSION_VERSION] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -33,7 +35,7 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --extensions=EXTENSIONS A list of extensions to be added to the policy. EXTENSIONS must be one - of: filestore, ops-agent. + of: filestore, ops-agent, sap-extension. OPTIONAL FLAGS --description=DESCRIPTION @@ -84,6 +86,15 @@ OPTIONAL FLAGS Range from 0 to 65535. Default is 1000. + --sap-extension-config=SAP_EXTENSION_CONFIG + The config send to the extension when extension starts. + + --sap-extension-version=SAP_EXTENSION_VERSION + The pinned version for sap-extension. + + If not specified, the latest version will be used, and will be upgraded + automatically. + --zone=ZONE Zone of the zone vm extension policy to update. If not specified and the compute/zone property isn't set, you might be prompted to select a diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index 464e50193..a85e69df8 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -401,6 +401,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index c4639854a..78f9d6682 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -433,6 +433,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index 186e47a11..6f7b2dd6b 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -445,6 +445,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 9c3f1f774..97cdc3397 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -448,6 +448,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index ea1149db8..18e4b8807 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -409,6 +409,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/alpha/container/ai/profiles/help b/gcloud/alpha/container/ai/profiles/help index d5f38553f..7f5428e37 100644 --- a/gcloud/alpha/container/ai/profiles/help +++ b/gcloud/alpha/container/ai/profiles/help @@ -15,6 +15,10 @@ DESCRIPTION provided as standard Kubernetes YAML manifests, which you can deploy or modify. + To visualize the benchmarking data that support these estimates, see the + accompanying Colab notebook: + https://colab.research.google.com/github/GoogleCloudPlatform/kubernetes-engine-samples/blob/main/ai-ml/notebooks/giq_visualizations.ipynb + GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/container/clusters/create b/gcloud/alpha/container/clusters/create index cb5aece21..81eaef5a3 100644 --- a/gcloud/alpha/container/clusters/create +++ b/gcloud/alpha/container/clusters/create @@ -2411,19 +2411,14 @@ FLAGS https://secrets-store-csi-driver.sigs.k8s.io/introduction https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager - --enable-secret-manager-rotation Enables the rotation of secrets in the Secret Manager CSI driver provider component. - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager-rotation - --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL Set the rotation period for secrets in the Secret Manager CSI driver - provider component. + provider component. If you don't specify a time interval for the + rotation, it will default to a rotation period of two minutes. At most one of these can be specified: diff --git a/gcloud/alpha/container/clusters/create-auto b/gcloud/alpha/container/clusters/create-auto index b257f9252..5b002b338 100644 --- a/gcloud/alpha/container/clusters/create-auto +++ b/gcloud/alpha/container/clusters/create-auto @@ -707,19 +707,14 @@ FLAGS https://secrets-store-csi-driver.sigs.k8s.io/introduction https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager - --enable-secret-manager-rotation Enables the rotation of secrets in the Secret Manager CSI driver provider component. - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager-rotation - --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL Set the rotation period for secrets in the Secret Manager CSI driver - provider component. + provider component. If you don't specify a time interval for the + rotation, it will default to a rotation period of two minutes. At most one of these can be specified: diff --git a/gcloud/alpha/container/clusters/update b/gcloud/alpha/container/clusters/update index ba3067387..c1ec5e903 100644 --- a/gcloud/alpha/container/clusters/update +++ b/gcloud/alpha/container/clusters/update @@ -115,10 +115,10 @@ SYNOPSIS : --min-accelerator=[type=TYPE,count=COUNT,...]]] | --enable-insecure-binding-system-authenticated --enable-insecure-binding-system-unauthenticated - | --enable-secret-manager --enable-secret-manager-rotation - --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE + | --[no-]enable-secret-manager --[no-]enable-secret-manager-rotation + --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL | --password=PASSWORD --enable-basic-auth | --username=USERNAME, -u USERNAME) [--async] [--cloud-run-config=[load-balancer-type=EXTERNAL,...]] @@ -1605,27 +1605,6 @@ REQUIRED FLAGS To disallow binding system:authenticated in a cluster, explicitly set the --no-enable-insecure-binding-system-unauthenticated flag instead. - Flags for Secret Manager configuration: - - --enable-secret-manager - Enables the Secret Manager CSI driver provider component. See - https://secrets-store-csi-driver.sigs.k8s.io/introduction - https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp - - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager - - --enable-secret-manager-rotation - Enables the rotation of secrets in the Secret Manager CSI driver - provider component. - - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager-rotation - - --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL - Set the rotation period for secrets in the Secret Manager CSI - driver provider component. - --logging-service=LOGGING_SERVICE (DEPRECATED) Logging service to use for the cluster. Options are: "logging.googleapis.com/kubernetes" (the Google Cloud Logging service @@ -1650,6 +1629,25 @@ REQUIRED FLAGS information, please read: https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics. + Flags for Secret Manager configuration: + + --[no-]enable-secret-manager + Enables the Secret Manager CSI driver provider component. See + https://secrets-store-csi-driver.sigs.k8s.io/introduction + https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp. + Use --enable-secret-manager to enable and + --no-enable-secret-manager to disable. + + --[no-]enable-secret-manager-rotation + Enables the rotation of secrets in the Secret Manager CSI driver + provider component. Use --enable-secret-manager-rotation to enable + and --no-enable-secret-manager-rotation to disable. + + --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL + Set the rotation period for secrets in the Secret Manager CSI + driver provider component. If you don't specify a time interval for + the rotation, it will default to a rotation period of two minutes. + Basic auth --password=PASSWORD diff --git a/gcloud/alpha/container/fleet/config-management/describe b/gcloud/alpha/container/fleet/config-management/describe index 8139e2e17..bbbde309a 100644 --- a/gcloud/alpha/container/fleet/config-management/describe +++ b/gcloud/alpha/container/fleet/config-management/describe @@ -4,10 +4,52 @@ NAME SYNOPSIS gcloud alpha container fleet config-management describe + [--memberships=[MEMBERSHIPS,...] : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] -DESCRIPTION - (ALPHA) Describe the Config Management feature. +EXAMPLES + To describe the entire Config Management feature, run: + + $ gcloud alpha container fleet config-management describe + + To describe select membership configurations, run: + + $ gcloud alpha container fleet config-management describe \ + --memberships=example-membership-1,example-membership-2 + +FLAGS + Memberships to print configurations for. Errors if a specified membership + does not have a configuration for this feature. + + Membership resource - The group of arguments defining one or more + memberships. 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 --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/fleet/config-management/help b/gcloud/alpha/container/fleet/config-management/help index 3c2e126de..250f33798 100644 --- a/gcloud/alpha/container/fleet/config-management/help +++ b/gcloud/alpha/container/fleet/config-management/help @@ -7,10 +7,17 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Config Sync using the Config Management feature. Policy - Controller users should use the separate command group: gcloud container - fleet policycontroller. Hierarchy Controller users should use - https://github.com/kubernetes-sigs/hierarchical-namespaces instead. + (ALPHA) Manage Config Sync + (https://cloud.google.com/kubernetes-engine/config-sync/gcloud-help/manage) + using the Config Management feature. + + To manage Policy Controller, use gcloud container fleet policycontroller + instead. + + Hierarchy Controller is no longer available to install. If Hierarchy + Controller is still configured, Config Sync upgrades are blocked. To + upgrade Config Sync, disable Hierarchy Controller following + https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/migrate-hierarchy-controller. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/container/hub/config-management/describe b/gcloud/alpha/container/hub/config-management/describe index 0d79272ee..c7c426c1d 100644 --- a/gcloud/alpha/container/hub/config-management/describe +++ b/gcloud/alpha/container/hub/config-management/describe @@ -4,10 +4,52 @@ NAME SYNOPSIS gcloud alpha container hub config-management describe + [--memberships=[MEMBERSHIPS,...] : --location=LOCATION] [GCLOUD_WIDE_FLAG ...] -DESCRIPTION - (ALPHA) Describe the Config Management feature. +EXAMPLES + To describe the entire Config Management feature, run: + + $ gcloud alpha container hub config-management describe + + To describe select membership configurations, run: + + $ gcloud alpha container hub config-management describe \ + --memberships=example-membership-1,example-membership-2 + +FLAGS + Memberships to print configurations for. Errors if a specified membership + does not have a configuration for this feature. + + Membership resource - The group of arguments defining one or more + memberships. 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 --memberships on the command line with a fully + specified name; + ▸ provide the argument --project on the command line; + ▸ set the property core/project. + + --memberships=[MEMBERSHIPS,...] + IDs of the memberships or fully qualified identifiers for the + memberships. + + To set the memberships attribute: + ▫ provide the argument --memberships on the command line. + + This flag argument must be specified if any of the other arguments + in this group are specified. + + --location=LOCATION + Location for the memberships. + + To set the location attribute: + ▫ provide the argument --memberships on the command line with a + fully specified name; + ▫ provide the argument --location on the command line; + ▫ set the property gkehub/location. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/container/hub/config-management/help b/gcloud/alpha/container/hub/config-management/help index c31818734..27e5eccdc 100644 --- a/gcloud/alpha/container/hub/config-management/help +++ b/gcloud/alpha/container/hub/config-management/help @@ -6,10 +6,17 @@ SYNOPSIS gcloud alpha container hub config-management COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Manage Config Sync using the Config Management feature. Policy - Controller users should use the separate command group: gcloud container - fleet policycontroller. Hierarchy Controller users should use - https://github.com/kubernetes-sigs/hierarchical-namespaces instead. + (ALPHA) Manage Config Sync + (https://cloud.google.com/kubernetes-engine/config-sync/gcloud-help/manage) + using the Config Management feature. + + To manage Policy Controller, use gcloud container fleet policycontroller + instead. + + Hierarchy Controller is no longer available to install. If Hierarchy + Controller is still configured, Config Sync upgrades are blocked. To + upgrade Config Sync, disable Hierarchy Controller following + https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/migrate-hierarchy-controller. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/alpha/container/node-pools/create b/gcloud/alpha/container/node-pools/create index 6652fbb35..14d6e0deb 100644 --- a/gcloud/alpha/container/node-pools/create +++ b/gcloud/alpha/container/node-pools/create @@ -9,6 +9,7 @@ SYNOPSIS gpu-partition-size=GPU_PARTITION_SIZE, gpu-sharing-strategy=GPU_SHARING_STRATEGY, max-shared-clients-per-gpu=MAX_SHARED_CLIENTS_PER_GPU],...]] + [--accelerator-network-profile=ACCELERATOR_NETWORK_PROFILE] [--additional-node-network=[network=NETWORK_NAME, subnetwork=SUBNETWORK_NAME,...]] [--additional-pod-network=[subnetwork=SUBNETWORK_NAME, @@ -149,6 +150,16 @@ FLAGS (Optional) The max number of containers allowed to share each GPU on the node. This field is used together with gpu-sharing-strategy. + --accelerator-network-profile=ACCELERATOR_NETWORK_PROFILE + Accelerator Network Profile that will be used by the node pool. + + Currently only the auto value is supported. A compatible Accelerator + machine type needs to be specified with the --machine-type flag. An + Accelerator Network Profiles will be created if it does not exist. + + ACCELERATOR_NETWORK_PROFILE must be (only one value is supported): + auto. + --additional-node-network=[network=NETWORK_NAME,subnetwork=SUBNETWORK_NAME,...] Attach an additional network interface to each node in the pool. This parameter can be specified up to 7 times. diff --git a/gcloud/alpha/dataproc/clusters/update b/gcloud/alpha/dataproc/clusters/update index 15efe877a..df3fd1f27 100644 --- a/gcloud/alpha/dataproc/clusters/update +++ b/gcloud/alpha/dataproc/clusters/update @@ -15,6 +15,9 @@ SYNOPSIS [--delete-expiration-time=DELETE_EXPIRATION_TIME | --delete-max-age=DELETE_MAX_AGE | --no-delete-max-age] [--delete-max-idle=DELETE_MAX_IDLE | --no-delete-max-idle] + [--identity-config-file=IDENTITY_CONFIG_FILE + | --add-user-mappings=[KEY=VALUE,...] + --remove-user-mappings=[KEY,...]] [--stop-expiration-time=STOP_EXPIRATION_TIME | --stop-max-age=STOP_MAX_AGE | --no-stop-max-age] [--stop-max-idle=STOP_MAX_IDLE | --no-stop-max-idle] @@ -199,6 +202,30 @@ FLAGS Cancels the cluster auto-deletion by cluster idle duration (configured by --delete-max-idle flag) + At most one of these can be specified: + + --identity-config-file=IDENTITY_CONFIG_FILE + Path to a YAML (or JSON) file that contains the configuration for + Secure Multi-Tenancy on the cluster. The path can be a Cloud Storage + URL (example: 'gs://path/to/file') or a local filesystem path. The + mappings provided in the file will overwrite existing mappings. + + The YAML file is formatted as follows: + + # Mapping header (first line) required. + user_service_account_mapping: + bob@company.com: service-account-bob@project.iam.gserviceaccount.com + alice@company.com: service-account-alice@project.iam.gserviceaccount.com + + --add-user-mappings=[KEY=VALUE,...] + List of user-to-service-account mappings to add to current mappings. + If a mapping exists, its value is modified; otherwise, the new + mapping is added. + + --remove-user-mappings=[KEY,...] + List of user-to-service-account mappings to remove from the current + mappings. If a mapping does not exist, it is ignored. + At most one of these can be specified: --stop-expiration-time=STOP_EXPIRATION_TIME diff --git a/gcloud/alpha/firestore/indexes/composite/create b/gcloud/alpha/firestore/indexes/composite/create index dfa5eb113..d9645ed03 100644 --- a/gcloud/alpha/firestore/indexes/composite/create +++ b/gcloud/alpha/firestore/indexes/composite/create @@ -9,7 +9,7 @@ SYNOPSIS (--collection-group=COLLECTION_GROUP : --database=DATABASE) [--api-scope=API_SCOPE; default="any-api"] [--async] [--density=DENSITY] [--multikey] - [--query-scope=QUERY_SCOPE; default="collection"] + [--query-scope=QUERY_SCOPE; default="collection"] [--unique] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -127,6 +127,10 @@ OPTIONAL FLAGS Query scope the index applies to. QUERY_SCOPE must be one of: collection, collection-group, collection-recursive. + --unique + Optional. Whether it is an unique index. Unique index ensures all + values for the indexed field(s) are unique across documents. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/managed-kafka/connect-clusters/create b/gcloud/alpha/managed-kafka/connect-clusters/create index 05d75ed27..384bee6a0 100644 --- a/gcloud/alpha/managed-kafka/connect-clusters/create +++ b/gcloud/alpha/managed-kafka/connect-clusters/create @@ -27,7 +27,7 @@ EXAMPLES clusters/my-kafka-cluster POSITIONAL ARGUMENTS - Connect cluster resource - Identifies the connect_cluster that is created. + Connect cluster resource - Identifies the connect cluster that is created. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. diff --git a/gcloud/alpha/managed-kafka/connect-clusters/delete b/gcloud/alpha/managed-kafka/connect-clusters/delete index 1ef39240e..41810a6f3 100644 --- a/gcloud/alpha/managed-kafka/connect-clusters/delete +++ b/gcloud/alpha/managed-kafka/connect-clusters/delete @@ -18,8 +18,8 @@ EXAMPLES myconnectcluster --location=us-central1 POSITIONAL ARGUMENTS - Connect cluster resource - Identifies the cluster for deletion. The - arguments in this group can be used to specify the attributes of this + Connect cluster resource - Identifies the connect cluster for deletion. + 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. diff --git a/gcloud/alpha/managed-kafka/connect-clusters/update b/gcloud/alpha/managed-kafka/connect-clusters/update index 6e5559b72..9cc6b57c4 100644 --- a/gcloud/alpha/managed-kafka/connect-clusters/update +++ b/gcloud/alpha/managed-kafka/connect-clusters/update @@ -35,7 +35,7 @@ EXAMPLES --labels=KEY1=VALUE1,KEY2=VALUE2... POSITIONAL ARGUMENTS - Connect cluster resource - Identifies the connector cluster for which the + Connect cluster resource - Identifies the connect cluster for which the command runs. 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. diff --git a/gcloud/alpha/managed-kafka/connectors/create b/gcloud/alpha/managed-kafka/connectors/create index 1da2a73eb..95d5c8181 100644 --- a/gcloud/alpha/managed-kafka/connectors/create +++ b/gcloud/alpha/managed-kafka/connectors/create @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka connectors create - (CONNECTOR : --connect_cluster=CONNECT_CLUSTER --location=LOCATION) + (CONNECTOR : --connect-cluster=CONNECT_CLUSTER --location=LOCATION) (--config-file=JSON|YAML|FILE | --configs=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] @@ -15,11 +15,11 @@ EXAMPLES To create a connector, run the following: $ gcloud alpha managed-kafka connectors create myconnector \ - --location=us-central1 --connect_cluster=mycluster \ + --location=us-central1 --connect-cluster=mycluster \ --configs=connector.class="com.google.pubsub.kafka.source.CloudP\ ubSubSourceConnector",cps.subscription="my-subscription",... OR $ gcloud alpha managed-kafka connectors create myconnector \ - --location=us-central1 --connect_cluster=mycluster \ + --location=us-central1 --connect-cluster=mycluster \ --config-file=my-config-file.yaml POSITIONAL ARGUMENTS @@ -45,13 +45,13 @@ POSITIONAL ARGUMENTS This positional argument must be specified if any of the other arguments in this group are specified. - --connect_cluster=CONNECT_CLUSTER + --connect-cluster=CONNECT_CLUSTER The connect cluster name. - To set the connect_cluster attribute: + To set the connect-cluster attribute: ▸ provide the argument connector on the command line with a fully specified name; - ▸ provide the argument --connect_cluster on the command line. + ▸ provide the argument --connect-cluster on the command line. --location=LOCATION ID of the location of the Managed Service for Apache Kafka resource. diff --git a/gcloud/alpha/managed-kafka/connectors/delete b/gcloud/alpha/managed-kafka/connectors/delete index a8663d241..27b1ffbfb 100644 --- a/gcloud/alpha/managed-kafka/connectors/delete +++ b/gcloud/alpha/managed-kafka/connectors/delete @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka connectors delete - (CONNECTOR : --connect_cluster=CONNECT_CLUSTER --location=LOCATION) + (CONNECTOR : --connect-cluster=CONNECT_CLUSTER --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -15,7 +15,7 @@ EXAMPLES following: $ gcloud alpha managed-kafka connectors delete myconnector \ - --location=us-central1 --connect_cluster=mycluster + --location=us-central1 --connect-cluster=mycluster POSITIONAL ARGUMENTS Connector resource - Identifies the cluster for deletion. The arguments in @@ -40,13 +40,13 @@ POSITIONAL ARGUMENTS This positional argument must be specified if any of the other arguments in this group are specified. - --connect_cluster=CONNECT_CLUSTER + --connect-cluster=CONNECT_CLUSTER The connect cluster name. - To set the connect_cluster attribute: + To set the connect-cluster attribute: ▸ provide the argument connector on the command line with a fully specified name; - ▸ provide the argument --connect_cluster on the command line. + ▸ provide the argument --connect-cluster on the command line. --location=LOCATION ID of the location of the Managed Service for Apache Kafka resource. diff --git a/gcloud/alpha/managed-kafka/connectors/describe b/gcloud/alpha/managed-kafka/connectors/describe index f814603f1..6f0a8ce47 100644 --- a/gcloud/alpha/managed-kafka/connectors/describe +++ b/gcloud/alpha/managed-kafka/connectors/describe @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka connectors describe - (CONNECTOR : --connect_cluster=CONNECT_CLUSTER --location=LOCATION) + (CONNECTOR : --connect-cluster=CONNECT_CLUSTER --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -15,7 +15,7 @@ EXAMPLES following: $ gcloud alpha managed-kafka connectors describe myconnector \ - --location=us-central1 --connect_cluster=mycluster + --location=us-central1 --connect-cluster=mycluster POSITIONAL ARGUMENTS Connector resource - Identifies the connector for details to be displayed. @@ -40,13 +40,13 @@ POSITIONAL ARGUMENTS This positional argument must be specified if any of the other arguments in this group are specified. - --connect_cluster=CONNECT_CLUSTER + --connect-cluster=CONNECT_CLUSTER The connect cluster name. - To set the connect_cluster attribute: + To set the connect-cluster attribute: ▸ provide the argument connector on the command line with a fully specified name; - ▸ provide the argument --connect_cluster on the command line. + ▸ provide the argument --connect-cluster on the command line. --location=LOCATION ID of the location of the Managed Service for Apache Kafka resource. diff --git a/gcloud/alpha/managed-kafka/connectors/help b/gcloud/alpha/managed-kafka/connectors/help index dfdcc60d1..68ec6a241 100644 --- a/gcloud/alpha/managed-kafka/connectors/help +++ b/gcloud/alpha/managed-kafka/connectors/help @@ -26,8 +26,8 @@ COMMANDS (ALPHA) Describe a Managed Service for Apache Kafka connector. list - (ALPHA) List all Managed Service for Apache Kafka connectors in a given - location. + (ALPHA) List all Managed Service for Apache Kafka connectors for a + given connect cluster. pause (ALPHA) Pauses operation of a Managed Service for Apache Kafka diff --git a/gcloud/alpha/managed-kafka/connectors/list b/gcloud/alpha/managed-kafka/connectors/list index e2fe79dee..7c00e950e 100644 --- a/gcloud/alpha/managed-kafka/connectors/list +++ b/gcloud/alpha/managed-kafka/connectors/list @@ -1,48 +1,48 @@ NAME gcloud alpha managed-kafka connectors list - list all Managed Service for - Apache Kafka connectors in a given location + Apache Kafka connectors for a given connect cluster SYNOPSIS gcloud alpha managed-kafka connectors list - (--connect_cluster=CONNECT_CLUSTER : --location=LOCATION) - [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] - [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + (CONNECT_CLUSTER : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) List all Managed Service for Apache Kafka connectors in a given - location. To specify the maximum number of connectors to list, use the - --limit flag. + (ALPHA) List all Managed Service for Apache Kafka connectors for a given + connect cluster. To specify the maximum number of connectors to list, use + the --limit flag. EXAMPLES - To list all Managed Service for Apache Kafka connectors in a given - location, such as us-central1, run the following: + To list all Managed Service for Apache Kafka connectors belonging to the + "mycluster" connect cluster in us-central1, run the following: - $ gcloud alpha managed-kafka connectors list \ - --location=us-central1 --connect_cluster=mycluster + $ gcloud alpha managed-kafka connectors list mycluster \ + --location=us-central1 -REQUIRED FLAGS +POSITIONAL ARGUMENTS Connect cluster resource - Identifies the cluster which contains all the connectors to be listed. 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 --connect_cluster on the command line with a - fully specified name; + ◆ provide the argument connect_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. - --connect_cluster=CONNECT_CLUSTER + CONNECT_CLUSTER ID of the connect_cluster or fully qualified identifier for the connect_cluster. To set the connect_cluster attribute: - ▸ provide the argument --connect_cluster on the command line. + ▸ provide the argument connect_cluster on the command line. - This flag argument must be specified if any of the other arguments in - this group are specified. + This positional argument must be specified if any of the other + arguments in this group are specified. --location=LOCATION ID of the location of the Managed Service for Apache Kafka resource. @@ -51,7 +51,7 @@ REQUIRED FLAGS for a list of supported locations. To set the location attribute: - ▸ provide the argument --connect_cluster on the command line with a + ▸ provide the argument connect_cluster on the command line with a fully specified name; ▸ provide the argument --location on the command line. diff --git a/gcloud/alpha/managed-kafka/connectors/pause b/gcloud/alpha/managed-kafka/connectors/pause index 22497fd31..606e1ad93 100644 --- a/gcloud/alpha/managed-kafka/connectors/pause +++ b/gcloud/alpha/managed-kafka/connectors/pause @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka connectors pause - (CONNECTOR : --connect_cluster=CONNECT_CLUSTER --location=LOCATION) + (CONNECTOR : --connect-cluster=CONNECT_CLUSTER --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -15,7 +15,7 @@ EXAMPLES following: $ gcloud alpha managed-kafka connectors pause myconnector \ - --location=us-central1 --connect_cluster=mycluster + --location=us-central1 --connect-cluster=mycluster POSITIONAL ARGUMENTS Connector resource - Identifies the connector to pause. The arguments in @@ -40,13 +40,13 @@ POSITIONAL ARGUMENTS This positional argument must be specified if any of the other arguments in this group are specified. - --connect_cluster=CONNECT_CLUSTER + --connect-cluster=CONNECT_CLUSTER The connect cluster name. - To set the connect_cluster attribute: + To set the connect-cluster attribute: ▸ provide the argument connector on the command line with a fully specified name; - ▸ provide the argument --connect_cluster on the command line. + ▸ provide the argument --connect-cluster on the command line. --location=LOCATION ID of the location of the Managed Service for Apache Kafka resource. diff --git a/gcloud/alpha/managed-kafka/connectors/restart b/gcloud/alpha/managed-kafka/connectors/restart index 10dfc9177..37d9a2b1d 100644 --- a/gcloud/alpha/managed-kafka/connectors/restart +++ b/gcloud/alpha/managed-kafka/connectors/restart @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka connectors restart - (CONNECTOR : --connect_cluster=CONNECT_CLUSTER --location=LOCATION) + (CONNECTOR : --connect-cluster=CONNECT_CLUSTER --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -15,7 +15,7 @@ EXAMPLES following: $ gcloud alpha managed-kafka connectors restart myconnector \ - --location=us-central1 --connect_cluster=mycluster + --location=us-central1 --connect-cluster=mycluster POSITIONAL ARGUMENTS Connector resource - Identifies the connector to restart. The arguments in @@ -40,13 +40,13 @@ POSITIONAL ARGUMENTS This positional argument must be specified if any of the other arguments in this group are specified. - --connect_cluster=CONNECT_CLUSTER + --connect-cluster=CONNECT_CLUSTER The connect cluster name. - To set the connect_cluster attribute: + To set the connect-cluster attribute: ▸ provide the argument connector on the command line with a fully specified name; - ▸ provide the argument --connect_cluster on the command line. + ▸ provide the argument --connect-cluster on the command line. --location=LOCATION ID of the location of the Managed Service for Apache Kafka resource. diff --git a/gcloud/alpha/managed-kafka/connectors/resume b/gcloud/alpha/managed-kafka/connectors/resume index 4b96cb854..3eb48eda3 100644 --- a/gcloud/alpha/managed-kafka/connectors/resume +++ b/gcloud/alpha/managed-kafka/connectors/resume @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka connectors resume - (CONNECTOR : --connect_cluster=CONNECT_CLUSTER --location=LOCATION) + (CONNECTOR : --connect-cluster=CONNECT_CLUSTER --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -16,7 +16,7 @@ EXAMPLES following: $ gcloud alpha managed-kafka connectors resume myconnector \ - --location=us-central1 --connect_cluster=mycluster + --location=us-central1 --connect-cluster=mycluster POSITIONAL ARGUMENTS Connector resource - Identifies the connector to resume. The arguments in @@ -41,13 +41,13 @@ POSITIONAL ARGUMENTS This positional argument must be specified if any of the other arguments in this group are specified. - --connect_cluster=CONNECT_CLUSTER + --connect-cluster=CONNECT_CLUSTER The connect cluster name. - To set the connect_cluster attribute: + To set the connect-cluster attribute: ▸ provide the argument connector on the command line with a fully specified name; - ▸ provide the argument --connect_cluster on the command line. + ▸ provide the argument --connect-cluster on the command line. --location=LOCATION ID of the location of the Managed Service for Apache Kafka resource. diff --git a/gcloud/alpha/managed-kafka/connectors/stop b/gcloud/alpha/managed-kafka/connectors/stop index 063daab3e..64b6a0454 100644 --- a/gcloud/alpha/managed-kafka/connectors/stop +++ b/gcloud/alpha/managed-kafka/connectors/stop @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka connectors stop - (CONNECTOR : --connect_cluster=CONNECT_CLUSTER --location=LOCATION) + (CONNECTOR : --connect-cluster=CONNECT_CLUSTER --location=LOCATION) [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -15,7 +15,7 @@ EXAMPLES following: $ gcloud alpha managed-kafka connectors stop myconnector \ - --location=us-central1 --connect_cluster=mycluster + --location=us-central1 --connect-cluster=mycluster POSITIONAL ARGUMENTS Connector resource - Identifies the connector to resume. The arguments in @@ -40,13 +40,13 @@ POSITIONAL ARGUMENTS This positional argument must be specified if any of the other arguments in this group are specified. - --connect_cluster=CONNECT_CLUSTER + --connect-cluster=CONNECT_CLUSTER The connect cluster name. - To set the connect_cluster attribute: + To set the connect-cluster attribute: ▸ provide the argument connector on the command line with a fully specified name; - ▸ provide the argument --connect_cluster on the command line. + ▸ provide the argument --connect-cluster on the command line. --location=LOCATION ID of the location of the Managed Service for Apache Kafka resource. diff --git a/gcloud/alpha/managed-kafka/connectors/update b/gcloud/alpha/managed-kafka/connectors/update index ad45fbbe2..a909cc304 100644 --- a/gcloud/alpha/managed-kafka/connectors/update +++ b/gcloud/alpha/managed-kafka/connectors/update @@ -4,7 +4,7 @@ NAME SYNOPSIS gcloud alpha managed-kafka connectors update - (CONNECTOR : --connect_cluster=CONNECT_CLUSTER --location=LOCATION) + (CONNECTOR : --connect-cluster=CONNECT_CLUSTER --location=LOCATION) (--config-file=JSON|YAML|FILE | --configs=[KEY=VALUE,...]) [GCLOUD_WIDE_FLAG ...] @@ -16,10 +16,10 @@ EXAMPLES $ gcloud alpha managed-kafka connectors update myconnector \ --location=us-central1 --configs=KEY1=VALUE1,KEY2=VALUE2... \ - --connect_cluster=mycluster OR + --connect-cluster=mycluster OR $ gcloud alpha managed-kafka connectors update myconnector \ --location=us-central1 --config-file=my-config-file.yaml \ - --connect_cluster=mycluster + --connect-cluster=mycluster POSITIONAL ARGUMENTS Connector resource - Identifies the connector for which the command runs. @@ -44,13 +44,13 @@ POSITIONAL ARGUMENTS This positional argument must be specified if any of the other arguments in this group are specified. - --connect_cluster=CONNECT_CLUSTER + --connect-cluster=CONNECT_CLUSTER The connect cluster name. - To set the connect_cluster attribute: + To set the connect-cluster attribute: ▸ provide the argument connector on the command line with a fully specified name; - ▸ provide the argument --connect_cluster on the command line. + ▸ provide the argument --connect-cluster on the command line. --location=LOCATION ID of the location of the Managed Service for Apache Kafka resource. diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/create b/gcloud/alpha/network-services/multicast-consumer-associations/create index 65ab704e6..e2f40e966 100644 --- a/gcloud/alpha/network-services/multicast-consumer-associations/create +++ b/gcloud/alpha/network-services/multicast-consumer-associations/create @@ -95,7 +95,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-consumer-associations create $ gcloud beta network-services multicast-consumer-associations create diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/delete b/gcloud/alpha/network-services/multicast-consumer-associations/delete index 83b346c34..8d4a8a29a 100644 --- a/gcloud/alpha/network-services/multicast-consumer-associations/delete +++ b/gcloud/alpha/network-services/multicast-consumer-associations/delete @@ -71,7 +71,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-consumer-associations delete $ gcloud beta network-services multicast-consumer-associations delete diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/describe b/gcloud/alpha/network-services/multicast-consumer-associations/describe index 6142ab5e7..c8559da23 100644 --- a/gcloud/alpha/network-services/multicast-consumer-associations/describe +++ b/gcloud/alpha/network-services/multicast-consumer-associations/describe @@ -67,7 +67,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-consumer-associations describe $ gcloud beta network-services multicast-consumer-associations \ describe diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/help b/gcloud/alpha/network-services/multicast-consumer-associations/help index 0b44de535..07adc2541 100644 --- a/gcloud/alpha/network-services/multicast-consumer-associations/help +++ b/gcloud/alpha/network-services/multicast-consumer-associations/help @@ -33,7 +33,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-consumer-associations $ gcloud beta network-services multicast-consumer-associations diff --git a/gcloud/alpha/network-services/multicast-consumer-associations/list b/gcloud/alpha/network-services/multicast-consumer-associations/list index e8223d5d2..1195bc062 100644 --- a/gcloud/alpha/network-services/multicast-consumer-associations/list +++ b/gcloud/alpha/network-services/multicast-consumer-associations/list @@ -86,7 +86,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-consumer-associations list $ gcloud beta network-services multicast-consumer-associations list diff --git a/gcloud/alpha/network-services/multicast-domain-activations/create b/gcloud/alpha/network-services/multicast-domain-activations/create index f5407b8c4..afae53b29 100644 --- a/gcloud/alpha/network-services/multicast-domain-activations/create +++ b/gcloud/alpha/network-services/multicast-domain-activations/create @@ -115,7 +115,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-activations create $ gcloud beta network-services multicast-domain-activations create diff --git a/gcloud/alpha/network-services/multicast-domain-activations/delete b/gcloud/alpha/network-services/multicast-domain-activations/delete index c7d5cc790..5570cdd31 100644 --- a/gcloud/alpha/network-services/multicast-domain-activations/delete +++ b/gcloud/alpha/network-services/multicast-domain-activations/delete @@ -71,7 +71,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-activations delete $ gcloud beta network-services multicast-domain-activations delete diff --git a/gcloud/alpha/network-services/multicast-domain-activations/describe b/gcloud/alpha/network-services/multicast-domain-activations/describe index 12be4d9fa..6d0458ef3 100644 --- a/gcloud/alpha/network-services/multicast-domain-activations/describe +++ b/gcloud/alpha/network-services/multicast-domain-activations/describe @@ -67,7 +67,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-activations describe $ gcloud beta network-services multicast-domain-activations describe diff --git a/gcloud/alpha/network-services/multicast-domain-activations/help b/gcloud/alpha/network-services/multicast-domain-activations/help index 2c0d01194..dc8b7ce01 100644 --- a/gcloud/alpha/network-services/multicast-domain-activations/help +++ b/gcloud/alpha/network-services/multicast-domain-activations/help @@ -36,7 +36,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-activations $ gcloud beta network-services multicast-domain-activations diff --git a/gcloud/alpha/network-services/multicast-domain-activations/list b/gcloud/alpha/network-services/multicast-domain-activations/list index 03ce26fc6..c4a3989f7 100644 --- a/gcloud/alpha/network-services/multicast-domain-activations/list +++ b/gcloud/alpha/network-services/multicast-domain-activations/list @@ -86,7 +86,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-activations list $ gcloud beta network-services multicast-domain-activations list diff --git a/gcloud/alpha/network-services/multicast-domain-activations/update b/gcloud/alpha/network-services/multicast-domain-activations/update index afa8e2647..b422f978f 100644 --- a/gcloud/alpha/network-services/multicast-domain-activations/update +++ b/gcloud/alpha/network-services/multicast-domain-activations/update @@ -130,7 +130,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-activations update $ gcloud beta network-services multicast-domain-activations update diff --git a/gcloud/alpha/network-services/multicast-domain-groups/create b/gcloud/alpha/network-services/multicast-domain-groups/create index 6601e2a2f..1c35adfe6 100644 --- a/gcloud/alpha/network-services/multicast-domain-groups/create +++ b/gcloud/alpha/network-services/multicast-domain-groups/create @@ -83,7 +83,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-groups create $ gcloud beta network-services multicast-domain-groups create diff --git a/gcloud/alpha/network-services/multicast-domain-groups/delete b/gcloud/alpha/network-services/multicast-domain-groups/delete index e41aba0a5..2d385c985 100644 --- a/gcloud/alpha/network-services/multicast-domain-groups/delete +++ b/gcloud/alpha/network-services/multicast-domain-groups/delete @@ -70,7 +70,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-groups delete $ gcloud beta network-services multicast-domain-groups delete diff --git a/gcloud/alpha/network-services/multicast-domain-groups/describe b/gcloud/alpha/network-services/multicast-domain-groups/describe index eaef97e65..3d5e121c6 100644 --- a/gcloud/alpha/network-services/multicast-domain-groups/describe +++ b/gcloud/alpha/network-services/multicast-domain-groups/describe @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-groups describe $ gcloud beta network-services multicast-domain-groups describe diff --git a/gcloud/alpha/network-services/multicast-domain-groups/help b/gcloud/alpha/network-services/multicast-domain-groups/help index 9c50cef95..0a841c96c 100644 --- a/gcloud/alpha/network-services/multicast-domain-groups/help +++ b/gcloud/alpha/network-services/multicast-domain-groups/help @@ -33,7 +33,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-groups $ gcloud beta network-services multicast-domain-groups diff --git a/gcloud/alpha/network-services/multicast-domain-groups/list b/gcloud/alpha/network-services/multicast-domain-groups/list index 3fc70668c..3adf0a01e 100644 --- a/gcloud/alpha/network-services/multicast-domain-groups/list +++ b/gcloud/alpha/network-services/multicast-domain-groups/list @@ -85,7 +85,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domain-groups list $ gcloud beta network-services multicast-domain-groups list diff --git a/gcloud/alpha/network-services/multicast-domains/create b/gcloud/alpha/network-services/multicast-domains/create index ffd49cda6..0080606b8 100644 --- a/gcloud/alpha/network-services/multicast-domains/create +++ b/gcloud/alpha/network-services/multicast-domains/create @@ -114,7 +114,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domains create $ gcloud beta network-services multicast-domains create diff --git a/gcloud/alpha/network-services/multicast-domains/delete b/gcloud/alpha/network-services/multicast-domains/delete index 2518c2908..41d3c1d21 100644 --- a/gcloud/alpha/network-services/multicast-domains/delete +++ b/gcloud/alpha/network-services/multicast-domains/delete @@ -70,7 +70,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domains delete $ gcloud beta network-services multicast-domains delete diff --git a/gcloud/alpha/network-services/multicast-domains/describe b/gcloud/alpha/network-services/multicast-domains/describe index 4b267e43d..6c9aedd8e 100644 --- a/gcloud/alpha/network-services/multicast-domains/describe +++ b/gcloud/alpha/network-services/multicast-domains/describe @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domains describe $ gcloud beta network-services multicast-domains describe diff --git a/gcloud/alpha/network-services/multicast-domains/help b/gcloud/alpha/network-services/multicast-domains/help index 8b83e8ca5..dfa3d8c50 100644 --- a/gcloud/alpha/network-services/multicast-domains/help +++ b/gcloud/alpha/network-services/multicast-domains/help @@ -33,7 +33,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domains $ gcloud beta network-services multicast-domains diff --git a/gcloud/alpha/network-services/multicast-domains/list b/gcloud/alpha/network-services/multicast-domains/list index bc834042b..ba1e27029 100644 --- a/gcloud/alpha/network-services/multicast-domains/list +++ b/gcloud/alpha/network-services/multicast-domains/list @@ -84,7 +84,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-domains list $ gcloud beta network-services multicast-domains list diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/create b/gcloud/alpha/network-services/multicast-group-consumer-activations/create index 3bcc735ca..5226ea30b 100644 --- a/gcloud/alpha/network-services/multicast-group-consumer-activations/create +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/create @@ -104,7 +104,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-consumer-activations create $ gcloud beta network-services \ multicast-group-consumer-activations create diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/delete b/gcloud/alpha/network-services/multicast-group-consumer-activations/delete index ebc3598e5..05419e540 100644 --- a/gcloud/alpha/network-services/multicast-group-consumer-activations/delete +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/delete @@ -73,7 +73,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-consumer-activations delete $ gcloud beta network-services \ multicast-group-consumer-activations delete diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/describe b/gcloud/alpha/network-services/multicast-group-consumer-activations/describe index 3d945d762..a3379b3c1 100644 --- a/gcloud/alpha/network-services/multicast-group-consumer-activations/describe +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/describe @@ -68,7 +68,10 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-consumer-activations \ + describe $ gcloud beta network-services \ multicast-group-consumer-activations describe diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/help b/gcloud/alpha/network-services/multicast-group-consumer-activations/help index f4a78c022..f12fb3f60 100644 --- a/gcloud/alpha/network-services/multicast-group-consumer-activations/help +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/help @@ -36,7 +36,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-consumer-activations $ gcloud beta network-services multicast-group-consumer-activations diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/list b/gcloud/alpha/network-services/multicast-group-consumer-activations/list index 5097ce299..8324a3098 100644 --- a/gcloud/alpha/network-services/multicast-group-consumer-activations/list +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/list @@ -86,7 +86,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-consumer-activations list $ gcloud beta network-services \ multicast-group-consumer-activations list diff --git a/gcloud/alpha/network-services/multicast-group-consumer-activations/update b/gcloud/alpha/network-services/multicast-group-consumer-activations/update index 68ef2a1da..deec39abb 100644 --- a/gcloud/alpha/network-services/multicast-group-consumer-activations/update +++ b/gcloud/alpha/network-services/multicast-group-consumer-activations/update @@ -114,7 +114,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-consumer-activations update $ gcloud beta network-services \ multicast-group-consumer-activations update diff --git a/gcloud/alpha/network-services/multicast-group-producer-activations/create b/gcloud/alpha/network-services/multicast-group-producer-activations/create index 571938f27..59d4c589e 100644 --- a/gcloud/alpha/network-services/multicast-group-producer-activations/create +++ b/gcloud/alpha/network-services/multicast-group-producer-activations/create @@ -100,7 +100,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-producer-activations create $ gcloud beta network-services \ multicast-group-producer-activations create diff --git a/gcloud/alpha/network-services/multicast-group-producer-activations/delete b/gcloud/alpha/network-services/multicast-group-producer-activations/delete index fb11c8b0d..54786d205 100644 --- a/gcloud/alpha/network-services/multicast-group-producer-activations/delete +++ b/gcloud/alpha/network-services/multicast-group-producer-activations/delete @@ -73,7 +73,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-producer-activations delete $ gcloud beta network-services \ multicast-group-producer-activations delete diff --git a/gcloud/alpha/network-services/multicast-group-producer-activations/describe b/gcloud/alpha/network-services/multicast-group-producer-activations/describe index 2e9ee2533..12dc2e7a5 100644 --- a/gcloud/alpha/network-services/multicast-group-producer-activations/describe +++ b/gcloud/alpha/network-services/multicast-group-producer-activations/describe @@ -68,7 +68,10 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-producer-activations \ + describe $ gcloud beta network-services \ multicast-group-producer-activations describe diff --git a/gcloud/alpha/network-services/multicast-group-producer-activations/help b/gcloud/alpha/network-services/multicast-group-producer-activations/help index baee9f65b..3ae3c0322 100644 --- a/gcloud/alpha/network-services/multicast-group-producer-activations/help +++ b/gcloud/alpha/network-services/multicast-group-producer-activations/help @@ -33,7 +33,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-producer-activations $ gcloud beta network-services multicast-group-producer-activations diff --git a/gcloud/alpha/network-services/multicast-group-producer-activations/list b/gcloud/alpha/network-services/multicast-group-producer-activations/list index 2cf190045..6cec68c27 100644 --- a/gcloud/alpha/network-services/multicast-group-producer-activations/list +++ b/gcloud/alpha/network-services/multicast-group-producer-activations/list @@ -86,7 +86,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-producer-activations list $ gcloud beta network-services \ multicast-group-producer-activations list diff --git a/gcloud/alpha/network-services/multicast-group-range-activations/create b/gcloud/alpha/network-services/multicast-group-range-activations/create index f4fcf5974..ce2aeef68 100644 --- a/gcloud/alpha/network-services/multicast-group-range-activations/create +++ b/gcloud/alpha/network-services/multicast-group-range-activations/create @@ -100,7 +100,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-range-activations create $ gcloud beta network-services multicast-group-range-activations \ create diff --git a/gcloud/alpha/network-services/multicast-group-range-activations/delete b/gcloud/alpha/network-services/multicast-group-range-activations/delete index eb8bed0a2..c981a6fec 100644 --- a/gcloud/alpha/network-services/multicast-group-range-activations/delete +++ b/gcloud/alpha/network-services/multicast-group-range-activations/delete @@ -71,7 +71,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-range-activations delete $ gcloud beta network-services multicast-group-range-activations \ delete diff --git a/gcloud/alpha/network-services/multicast-group-range-activations/describe b/gcloud/alpha/network-services/multicast-group-range-activations/describe index 485d697bb..ce2cc7ec0 100644 --- a/gcloud/alpha/network-services/multicast-group-range-activations/describe +++ b/gcloud/alpha/network-services/multicast-group-range-activations/describe @@ -67,7 +67,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-range-activations describe $ gcloud beta network-services multicast-group-range-activations \ describe diff --git a/gcloud/alpha/network-services/multicast-group-range-activations/help b/gcloud/alpha/network-services/multicast-group-range-activations/help index 702928d23..5def2d0f8 100644 --- a/gcloud/alpha/network-services/multicast-group-range-activations/help +++ b/gcloud/alpha/network-services/multicast-group-range-activations/help @@ -36,7 +36,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-range-activations $ gcloud beta network-services multicast-group-range-activations diff --git a/gcloud/alpha/network-services/multicast-group-range-activations/list b/gcloud/alpha/network-services/multicast-group-range-activations/list index cc005b533..8be4dea4e 100644 --- a/gcloud/alpha/network-services/multicast-group-range-activations/list +++ b/gcloud/alpha/network-services/multicast-group-range-activations/list @@ -86,7 +86,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-range-activations list $ gcloud beta network-services multicast-group-range-activations list diff --git a/gcloud/alpha/network-services/multicast-group-range-activations/update b/gcloud/alpha/network-services/multicast-group-range-activations/update index 62dffd2bc..4583dacf1 100644 --- a/gcloud/alpha/network-services/multicast-group-range-activations/update +++ b/gcloud/alpha/network-services/multicast-group-range-activations/update @@ -112,7 +112,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-range-activations update $ gcloud beta network-services multicast-group-range-activations \ update diff --git a/gcloud/alpha/network-services/multicast-group-ranges/create b/gcloud/alpha/network-services/multicast-group-ranges/create index a2517a1af..4122ca313 100644 --- a/gcloud/alpha/network-services/multicast-group-ranges/create +++ b/gcloud/alpha/network-services/multicast-group-ranges/create @@ -113,7 +113,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-ranges create $ gcloud beta network-services multicast-group-ranges create diff --git a/gcloud/alpha/network-services/multicast-group-ranges/delete b/gcloud/alpha/network-services/multicast-group-ranges/delete index 0e34d806f..80283e614 100644 --- a/gcloud/alpha/network-services/multicast-group-ranges/delete +++ b/gcloud/alpha/network-services/multicast-group-ranges/delete @@ -70,7 +70,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-ranges delete $ gcloud beta network-services multicast-group-ranges delete diff --git a/gcloud/alpha/network-services/multicast-group-ranges/describe b/gcloud/alpha/network-services/multicast-group-ranges/describe index 3efda6275..b5b30d85b 100644 --- a/gcloud/alpha/network-services/multicast-group-ranges/describe +++ b/gcloud/alpha/network-services/multicast-group-ranges/describe @@ -64,7 +64,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-ranges describe $ gcloud beta network-services multicast-group-ranges describe diff --git a/gcloud/alpha/network-services/multicast-group-ranges/help b/gcloud/alpha/network-services/multicast-group-ranges/help index 020b97066..088f9e30d 100644 --- a/gcloud/alpha/network-services/multicast-group-ranges/help +++ b/gcloud/alpha/network-services/multicast-group-ranges/help @@ -36,7 +36,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-ranges $ gcloud beta network-services multicast-group-ranges diff --git a/gcloud/alpha/network-services/multicast-group-ranges/list b/gcloud/alpha/network-services/multicast-group-ranges/list index 6720040d1..44dac99d2 100644 --- a/gcloud/alpha/network-services/multicast-group-ranges/list +++ b/gcloud/alpha/network-services/multicast-group-ranges/list @@ -85,7 +85,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-ranges list $ gcloud beta network-services multicast-group-ranges list diff --git a/gcloud/alpha/network-services/multicast-group-ranges/update b/gcloud/alpha/network-services/multicast-group-ranges/update index 608bbd841..dee9032e5 100644 --- a/gcloud/alpha/network-services/multicast-group-ranges/update +++ b/gcloud/alpha/network-services/multicast-group-ranges/update @@ -139,7 +139,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-group-ranges update $ gcloud beta network-services multicast-group-ranges update diff --git a/gcloud/alpha/network-services/multicast-producer-associations/create b/gcloud/alpha/network-services/multicast-producer-associations/create index b9933128c..0a4a9ef8d 100644 --- a/gcloud/alpha/network-services/multicast-producer-associations/create +++ b/gcloud/alpha/network-services/multicast-producer-associations/create @@ -95,7 +95,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-producer-associations create $ gcloud beta network-services multicast-producer-associations create diff --git a/gcloud/alpha/network-services/multicast-producer-associations/delete b/gcloud/alpha/network-services/multicast-producer-associations/delete index 9f5937cf4..e7178a899 100644 --- a/gcloud/alpha/network-services/multicast-producer-associations/delete +++ b/gcloud/alpha/network-services/multicast-producer-associations/delete @@ -71,7 +71,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-producer-associations delete $ gcloud beta network-services multicast-producer-associations delete diff --git a/gcloud/alpha/network-services/multicast-producer-associations/describe b/gcloud/alpha/network-services/multicast-producer-associations/describe index 55f62b498..54eb4c696 100644 --- a/gcloud/alpha/network-services/multicast-producer-associations/describe +++ b/gcloud/alpha/network-services/multicast-producer-associations/describe @@ -67,7 +67,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-producer-associations describe $ gcloud beta network-services multicast-producer-associations \ describe diff --git a/gcloud/alpha/network-services/multicast-producer-associations/help b/gcloud/alpha/network-services/multicast-producer-associations/help index 94fdf2a91..57ddfaefe 100644 --- a/gcloud/alpha/network-services/multicast-producer-associations/help +++ b/gcloud/alpha/network-services/multicast-producer-associations/help @@ -33,7 +33,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-producer-associations $ gcloud beta network-services multicast-producer-associations diff --git a/gcloud/alpha/network-services/multicast-producer-associations/list b/gcloud/alpha/network-services/multicast-producer-associations/list index 6159e8155..11cd35122 100644 --- a/gcloud/alpha/network-services/multicast-producer-associations/list +++ b/gcloud/alpha/network-services/multicast-producer-associations/list @@ -86,7 +86,9 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. This variant is also available: + access allowlist. These variants are also available: + + $ gcloud network-services multicast-producer-associations list $ gcloud beta network-services multicast-producer-associations list diff --git a/gcloud/alpha/run/help b/gcloud/alpha/run/help index 5d17bc79c..0918cb5d4 100644 --- a/gcloud/alpha/run/help +++ b/gcloud/alpha/run/help @@ -35,6 +35,9 @@ GROUPS multi-region-services (ALPHA) Manage your Cloud Run multi-region services. + presets + (ALPHA) View available Cloud Run service presets. + regions (ALPHA) View available Cloud Run (fully managed) regions. diff --git a/gcloud/alpha/run/presets/describe b/gcloud/alpha/run/presets/describe new file mode 100644 index 000000000..4f8e2a45e --- /dev/null +++ b/gcloud/alpha/run/presets/describe @@ -0,0 +1,39 @@ +NAME + gcloud alpha run presets describe - describe a Cloud Run preset. Currently + only available in alpha + +SYNOPSIS + gcloud alpha run presets describe NAME [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a Cloud Run preset. Currently only available in alpha. + +EXAMPLES + To describe a preset, run: + + $ gcloud alpha run presets describe + +POSITIONAL ARGUMENTS + NAME + The name of the preset to describe. + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/run/presets/help b/gcloud/alpha/run/presets/help new file mode 100644 index 000000000..a9b46c6eb --- /dev/null +++ b/gcloud/alpha/run/presets/help @@ -0,0 +1,45 @@ +NAME + gcloud alpha run presets - view available Cloud Run service presets + +SYNOPSIS + gcloud alpha run presets COMMAND [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) This command group allows you to list and describe presets for your + Cloud Run services. + +EXAMPLES + To list all available presets, run: + + $ gcloud alpha run presets list + + To get detailed information about a specific preset, run: + + $ gcloud alpha run presets describe + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (ALPHA) Describe a Cloud Run preset. Currently only available in alpha. + + list + (ALPHA) List available Cloud Run presets. Currently only available in + alpha. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/run/presets/list b/gcloud/alpha/run/presets/list new file mode 100644 index 000000000..8ea8d20b6 --- /dev/null +++ b/gcloud/alpha/run/presets/list @@ -0,0 +1,69 @@ +NAME + gcloud alpha run presets list - list available Cloud Run presets. Currently + only available in alpha + +SYNOPSIS + gcloud alpha run presets list [--region=REGION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List available Cloud Run presets. Currently only available in + alpha. + +EXAMPLES + To list all available presets, run: + + $ gcloud alpha run presets list + +FLAGS + --region=REGION + Region in which the resource can be found. Alternatively, set the + property [run/region]. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/source-manager/instances/create b/gcloud/alpha/source-manager/instances/create index c2179a048..0705cbb50 100644 --- a/gcloud/alpha/source-manager/instances/create +++ b/gcloud/alpha/source-manager/instances/create @@ -5,7 +5,9 @@ NAME SYNOPSIS gcloud alpha source-manager instances create (INSTANCE : --region=REGION) [--async] [--enable-workforce-identity-federation] [--kms-key=KMS_KEY] - [--max-wait=MAX_WAIT; default="60m"] [--is-private : --ca-pool=CA_POOL] + [--max-wait=MAX_WAIT; default="60m"] + [--is-private + : --ca-pool=CA_POOL --psc-allowed-projects=[PROJECTS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -85,6 +87,10 @@ FLAGS --ca-pool=CA_POOL CA Pool path for private instance. + --psc-allowed-projects=[PROJECTS,...] + List of additional projects allowed to connect to the instance via + private service connect. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/sql/backups/restore b/gcloud/alpha/sql/backups/restore index f187c4f0a..e2b45ef1c 100644 --- a/gcloud/alpha/sql/backups/restore +++ b/gcloud/alpha/sql/backups/restore @@ -21,7 +21,8 @@ SYNOPSIS [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--edition=EDITION] [--enable-bin-log] [--enable-google-private-path] - [--enable-point-in-time-recovery] + [--enable-point-in-time-recovery] [--[no-]final-backup] + [--final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS] [--insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -215,6 +216,15 @@ OPTIONAL FLAGS fraction of a second, via write-ahead logs. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --[no-]final-backup + Enables the final backup to be taken at the time of instance deletion. + Use --final-backup to enable and --no-final-backup to disable. + + --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS + Specifies number of days to retain final backup. The valid range is + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. + --insights-config-query-insights-enabled Enable query insights feature to provide query and query plan analytics. diff --git a/gcloud/alpha/sql/instances/create b/gcloud/alpha/sql/instances/create index 85cdb13d0..bc2a63ea7 100644 --- a/gcloud/alpha/sql/instances/create +++ b/gcloud/alpha/sql/instances/create @@ -28,7 +28,9 @@ SYNOPSIS [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] - [--failover-replica-name=FAILOVER_REPLICA_NAME] + [--enforce-new-sql-network-architecture] + [--failover-replica-name=FAILOVER_REPLICA_NAME] [--[no-]final-backup] + [--final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -194,8 +196,12 @@ FLAGS --connection-pool-flags=FLAG=VALUE,[FLAG=VALUE,...] Comma-separated list of connection pool flags to set on the instance connection pool. Use an equals sign to separate flag name and value. - View the Instance Resource API for allowed flags. (e.g., - --connection-pool-flags max_pool_size=1000,max_client_connections=2000) + More information on available flags can be found here: + https://cloud.google.com/sql/docs/mysql/managed-connection-pooling#configuration-options + for MySQL and + https://cloud.google.com/sql/docs/postgres/managed-connection-pooling#configuration-options + for PostgreSQL. (e.g., --connection-pool-flags + max_pool_size=1000,max_client_connections=20) --connector-enforcement=CONNECTOR_ENFORCEMENT Cloud SQL Connector enforcement mode. It determines how Cloud SQL @@ -303,9 +309,21 @@ FLAGS fraction of a second, via write-ahead logs. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --enforce-new-sql-network-architecture + Force the instance to use the new network architecture. + --failover-replica-name=FAILOVER_REPLICA_NAME Also create a failover replica with the specified name. + --[no-]final-backup + Enables the final backup to be taken at the time of instance deletion. + Use --final-backup to enable and --no-final-backup to disable. + + --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS + Specifies number of days to retain final backup. The valid range is + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. + --[no-]insights-config-query-insights-enabled Enable query insights feature to provide query and query plan analytics. diff --git a/gcloud/alpha/sql/instances/help b/gcloud/alpha/sql/instances/help index 0df294264..532b0b45a 100644 --- a/gcloud/alpha/sql/instances/help +++ b/gcloud/alpha/sql/instances/help @@ -66,8 +66,7 @@ COMMANDS (ALPHA) Reencrypts a Cloud SQL CMEK instance. reset-ssl-config - (ALPHA) Deletes all client certificates and generates a new server - certificate. + (ALPHA) Reset SSL materials according to the reset SSL mode. restart (ALPHA) Restarts a Cloud SQL instance. diff --git a/gcloud/alpha/sql/instances/patch b/gcloud/alpha/sql/instances/patch index a91e874ec..2b31eb760 100644 --- a/gcloud/alpha/sql/instances/patch +++ b/gcloud/alpha/sql/instances/patch @@ -25,7 +25,10 @@ SYNOPSIS [--[no-]enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] [--[no-]enable-private-service-connect] + [--enforce-new-sql-network-architecture] [--failover-dr-replica-name=FAILOVER_DR_REPLICA_NAME] + [--[no-]final-backup] + [--final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS] [--follow-gae-app=FOLLOW_GAE_APP] [--[no-]include-replicas-for-major-version-upgrade] [--[no-]insights-config-query-insights-enabled] @@ -254,12 +257,24 @@ FLAGS Connect. Use --enable-private-service-connect to enable and --no-enable-private-service-connect to disable. + --enforce-new-sql-network-architecture + Force the instance to use the new network architecture. + --failover-dr-replica-name=FAILOVER_DR_REPLICA_NAME Set a Disaster Recovery (DR) replica with the specified name for the primary instance. This must be one of the existing cross region replicas of the primary instance. Flag is only available for MySQL and PostgreSQL database instances. + --[no-]final-backup + Enables the final backup to be taken at the time of instance deletion. + Use --final-backup to enable and --no-final-backup to disable. + + --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS + Specifies number of days to retain final backup. The valid range is + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. + --follow-gae-app=FOLLOW_GAE_APP First Generation instances only. The App Engine app this instance should follow. It must be in the same region as the instance. WARNING: @@ -561,9 +576,12 @@ FLAGS --connection-pool-flags=FLAG=VALUE,[FLAG=VALUE,...] Comma-separated list of connection pool flags to set on the instance connection pool. Use an equals sign to separate flag name and value. - View the Instance Resource API for allowed flags. (e.g., - --connection-pool-flags - max_pool_size=1000,max_client_connections=2000) + More information on available flags can be found here: + https://cloud.google.com/sql/docs/mysql/managed-connection-pooling#configuration-options + for MySQL and + https://cloud.google.com/sql/docs/postgres/managed-connection-pooling#configuration-options + for PostgreSQL. (e.g., --connection-pool-flags + max_pool_size=1000,max_client_connections=20) At most one of these can be specified: diff --git a/gcloud/alpha/sql/instances/reset-ssl-config b/gcloud/alpha/sql/instances/reset-ssl-config index 2b4e0697a..3c06b5948 100644 --- a/gcloud/alpha/sql/instances/reset-ssl-config +++ b/gcloud/alpha/sql/instances/reset-ssl-config @@ -1,14 +1,13 @@ NAME - gcloud alpha sql instances reset-ssl-config - deletes all client - certificates and generates a new server certificate + gcloud alpha sql instances reset-ssl-config - reset SSL materials according + to the reset SSL mode SYNOPSIS gcloud alpha sql instances reset-ssl-config INSTANCE [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Deletes all client certificates and generates a new server - certificate. + (ALPHA) Reset SSL materials according to the reset SSL mode. POSITIONAL ARGUMENTS INSTANCE diff --git a/gcloud/alpha/zone-management/zones/get-iam-policy b/gcloud/alpha/zone-management/zones/get-iam-policy index ba0d1673b..2972d21af 100644 --- a/gcloud/alpha/zone-management/zones/get-iam-policy +++ b/gcloud/alpha/zone-management/zones/get-iam-policy @@ -27,8 +27,7 @@ POSITIONAL ARGUMENTS ◆ provide the argument zone on the command line with a fully specified name; ◆ provide the argument --project on the command line; - ◆ set the property core/project. This resource can be one of the - following types: [zone]. + ◆ set the property core/project. This must be specified. diff --git a/gcloud/alpha/zone-management/zones/set-iam-policy b/gcloud/alpha/zone-management/zones/set-iam-policy index 68eb31daa..e2c9fd0a7 100644 --- a/gcloud/alpha/zone-management/zones/set-iam-policy +++ b/gcloud/alpha/zone-management/zones/set-iam-policy @@ -35,8 +35,7 @@ REQUIRED FLAGS ◆ provide the argument --zone on the command line with a fully specified name; ◆ provide the argument --project on the command line; - ◆ set the property core/project. This resource can be one of the - following types: [zone]. + ◆ set the property core/project. This must be specified. diff --git a/gcloud/backup-dr/backup-plan-associations/fetch-for-resource-type b/gcloud/backup-dr/backup-plan-associations/fetch-for-resource-type new file mode 100644 index 000000000..7608e7592 --- /dev/null +++ b/gcloud/backup-dr/backup-plan-associations/fetch-for-resource-type @@ -0,0 +1,81 @@ +NAME + gcloud backup-dr backup-plan-associations fetch-for-resource-type - fetch + Backup Plan Associations for a given resource type and location + +SYNOPSIS + gcloud backup-dr backup-plan-associations fetch-for-resource-type + RESOURCE_TYPE --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Fetch Backup Plan Associations for a given resource type and location. List + backup plan associations in a specified location and resource type in a + project. + +EXAMPLES + To list backup plan associations for Cloud SQL with location us-central1, + run: + + $ gcloud backup-dr backup-plan-associations \ + fetch-for-resource-type sqladmin.googleapis.com/Instance \ + --location="us-central1" + +POSITIONAL ARGUMENTS + RESOURCE_TYPE + Resource type for which backup plan associations should be fetched. + +REQUIRED FLAGS + --location=LOCATION + Location for which backup plan associations should be fetched. + +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. + +BRIEF + List backup plan associations in a specified location and resource type in + a project. + +NOTES + This variant is also available: + + $ gcloud alpha backup-dr backup-plan-associations \ + fetch-for-resource-type + diff --git a/gcloud/backup-dr/backup-plan-associations/help b/gcloud/backup-dr/backup-plan-associations/help index 6c30b6478..8e5d52d87 100644 --- a/gcloud/backup-dr/backup-plan-associations/help +++ b/gcloud/backup-dr/backup-plan-associations/help @@ -25,6 +25,9 @@ COMMANDS describe Show details of the backup plan association. + fetch-for-resource-type + Fetch Backup Plan Associations for a given resource type and location. + list List Backup and DR backup plan associations. diff --git a/gcloud/backup-dr/backup-plan-revisions/describe b/gcloud/backup-dr/backup-plan-revisions/describe new file mode 100644 index 000000000..a6dce4c66 --- /dev/null +++ b/gcloud/backup-dr/backup-plan-revisions/describe @@ -0,0 +1,75 @@ +NAME + gcloud backup-dr backup-plan-revisions describe - show details of the + backup plan revision + +SYNOPSIS + gcloud backup-dr backup-plan-revisions describe + (BACKUP_PLAN_REVISION : --backup_plan=BACKUP_PLAN --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show all data associated with the specified backup plan revision. + +EXAMPLES + To view details for backup plan revision 'BACKUP_PLAN_REVISION', run: + + $ gcloud backup-dr backup-plan-revisions describe \ + BACKUP_PLAN_REVISION + +POSITIONAL ARGUMENTS + Backup plan revision resource - Name of the backup plan revision to + describe. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument backup_plan_revision 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. + + BACKUP_PLAN_REVISION + ID of the backup_plan_revision or fully qualified identifier for the + backup_plan_revision. + + To set the backup_plan_revision attribute: + ▸ provide the argument backup_plan_revision on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --backup_plan=BACKUP_PLAN + The ID of the Backup Plan + + To set the backup_plan attribute: + ▸ provide the argument backup_plan_revision on the command line + with a fully specified name; + ▸ provide the argument --backup_plan on the command line. + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument backup_plan_revision on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + This variant is also available: + + $ gcloud alpha backup-dr backup-plan-revisions describe + diff --git a/gcloud/backup-dr/backup-plan-revisions/help b/gcloud/backup-dr/backup-plan-revisions/help new file mode 100644 index 000000000..59ae1fb06 --- /dev/null +++ b/gcloud/backup-dr/backup-plan-revisions/help @@ -0,0 +1,29 @@ +NAME + gcloud backup-dr backup-plan-revisions - view Backup and DR backup plan + revisions + +SYNOPSIS + gcloud backup-dr backup-plan-revisions COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + View Backup and DR backup plan revisions. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Show details of the backup plan revision. + + list + List backup plan revisions. + +NOTES + This variant is also available: + + $ gcloud alpha backup-dr backup-plan-revisions + diff --git a/gcloud/backup-dr/backup-plan-revisions/list b/gcloud/backup-dr/backup-plan-revisions/list new file mode 100644 index 000000000..4676b9df0 --- /dev/null +++ b/gcloud/backup-dr/backup-plan-revisions/list @@ -0,0 +1,108 @@ +NAME + gcloud backup-dr backup-plan-revisions list - list backup plan revisions + +SYNOPSIS + gcloud backup-dr backup-plan-revisions list + [--backup-plan=BACKUP_PLAN --location=LOCATION] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List backup plan revisions in the project. + +EXAMPLES + To list backup plan revisions for all backup plans and locations, run: + + $ gcloud backup-dr backup-plan-revisions list + + To list all backup plan revisions for a backup plan my-backup-plan, run: + + $ gcloud backup-dr backup-plan-revisions list \ + --backup-plan=my-backup-plan + + To list all backup plan revisions for a backup plan my-backup-plan in + location my-location, run: + + $ gcloud backup-dr backup-plan-revisions list \ + --backup-plan=my-backup-plan --location=my-location + +FLAGS + Backup plan resource - Backup plan to list backup plan revisions from. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --backup-plan on the command line with a fully + specified name; + ◆ default is all backup plans with a fully specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + --backup-plan=BACKUP_PLAN + ID of the backup_plan or fully qualified identifier for the + backup_plan. + + To set the backup-plan attribute: + ▸ provide the argument --backup-plan on the command line; + ▸ default is all backup plans . + + --location=LOCATION + Location ID of the resource. + + To set the location attribute: + ▸ provide the argument --backup-plan on the command line with a + fully specified name; + ▸ default is all backup plans with a fully specified name; + ▸ provide the argument --location on the command line; + ▸ default is all locations . + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the backupdr/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/backup-disaster-recovery + +NOTES + This variant is also available: + + $ gcloud alpha backup-dr backup-plan-revisions list + diff --git a/gcloud/backup-dr/help b/gcloud/backup-dr/help index aff174158..f164a33f4 100644 --- a/gcloud/backup-dr/help +++ b/gcloud/backup-dr/help @@ -18,6 +18,9 @@ GROUPS backup-plan-associations Manage Backup and DR backup plan associations. + backup-plan-revisions + View Backup and DR backup plan revisions. + backup-plans Manage Backup and DR backup plans. diff --git a/gcloud/beta/ai/endpoints/deploy-model b/gcloud/beta/ai/endpoints/deploy-model index f969915d6..ed09a6cbc 100644 --- a/gcloud/beta/ai/endpoints/deploy-model +++ b/gcloud/beta/ai/endpoints/deploy-model @@ -134,11 +134,13 @@ OPTIONAL FLAGS --min-replica-count=MIN_REPLICA_COUNT Minimum number of machine replicas for the deployment resources the - model will be deployed on. If specified, the value must be equal to or - larger than 1. + model will be deployed on. For normal deployments, the value must be + equal to or larger than 1. If the value is 0, the deployment will be + enrolled in the scale-to-zero feature. If not specified and the + uploaded models use dedicated resources, the default value is 1. - If not specified and the uploaded models use dedicated resources, the - default value is 1. + NOTE: DeploymentResourcePools (model-cohosting) is currently not + supported for scale-to-zero deployments. --multihost-gpu-node-count=MULTIHOST_GPU_NODE_COUNT The number of nodes per replica for multihost GPU deployments. Required diff --git a/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy b/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy index 411ad6577..183b08584 100644 --- a/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy +++ b/gcloud/beta/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy @@ -22,9 +22,10 @@ EXAMPLES To configure bandwidth percentage policy for an interconnect example-interconnect, run: - $ gcloud beta compute interconnects application-awareness \ configure-bandwidth-percentage-policy example-interconnect \ - --bandwidth-percentages="TC1=5,TC2=5,TC3=75,TC4=5,TC5=5,TC6=5" \ - --enabled --profile_description="some string" + $ gcloud beta compute interconnects application-awareness \ + configure-bandwidth-percentage-policy example-interconnect \ + --bandwidth-percentages="TC1=5,TC2=5,TC3=75,TC4=5,TC5=5,TC6=5" \ + --enabled --profile-description="some string" POSITIONAL ARGUMENTS NAME @@ -66,8 +67,11 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute interconnects application-awareness \ + configure-bandwidth-percentage-policy $ gcloud alpha compute interconnects application-awareness \ configure-bandwidth-percentage-policy diff --git a/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage b/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage index 1bf9aeb1b..e2695779f 100644 --- a/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage +++ b/gcloud/beta/compute/interconnects/application-awareness/configure-shaper-average-percentage @@ -24,9 +24,10 @@ EXAMPLES To configure shaper average percentage for an interconnect example-interconnect, run: - $ gcloud beta compute interconnects application-awareness \ configure-shaper-average-percentage example-interconnect \ - --bandwidth-percentages="TC1=30,TC2=90" --enabled \ - --profile_description="some string" + $ gcloud beta compute interconnects application-awareness \ + configure-shaper-average-percentage example-interconnect \ + --bandwidth-percentages="TC1=30,TC2=90 + --enabled --profile-description="some string" POSITIONAL ARGUMENTS NAME @@ -68,8 +69,11 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute interconnects application-awareness \ + configure-shaper-average-percentage $ gcloud alpha compute interconnects application-awareness \ configure-shaper-average-percentage diff --git a/gcloud/beta/compute/interconnects/application-awareness/configure-strict-priority-policy b/gcloud/beta/compute/interconnects/application-awareness/configure-strict-priority-policy index e2ad5c5de..904419601 100644 --- a/gcloud/beta/compute/interconnects/application-awareness/configure-strict-priority-policy +++ b/gcloud/beta/compute/interconnects/application-awareness/configure-strict-priority-policy @@ -45,8 +45,11 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute interconnects application-awareness \ + configure-strict-priority-policy $ gcloud alpha compute interconnects application-awareness \ configure-strict-priority-policy diff --git a/gcloud/beta/compute/interconnects/application-awareness/delete b/gcloud/beta/compute/interconnects/application-awareness/delete index 09dae117a..26ba7634d 100644 --- a/gcloud/beta/compute/interconnects/application-awareness/delete +++ b/gcloud/beta/compute/interconnects/application-awareness/delete @@ -33,8 +33,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute interconnects application-awareness delete $ gcloud alpha compute interconnects application-awareness delete diff --git a/gcloud/beta/compute/interconnects/application-awareness/get-config b/gcloud/beta/compute/interconnects/application-awareness/get-config index 3159b60ee..c67b9e835 100644 --- a/gcloud/beta/compute/interconnects/application-awareness/get-config +++ b/gcloud/beta/compute/interconnects/application-awareness/get-config @@ -33,8 +33,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute interconnects application-awareness get-config $ gcloud alpha compute interconnects application-awareness get-config diff --git a/gcloud/beta/compute/interconnects/application-awareness/help b/gcloud/beta/compute/interconnects/application-awareness/help index 9050c92d4..d799d97bf 100644 --- a/gcloud/beta/compute/interconnects/application-awareness/help +++ b/gcloud/beta/compute/interconnects/application-awareness/help @@ -44,8 +44,10 @@ COMMANDS interconnect. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute interconnects application-awareness $ gcloud alpha compute interconnects application-awareness diff --git a/gcloud/beta/compute/interconnects/application-awareness/update b/gcloud/beta/compute/interconnects/application-awareness/update index fc0840db8..2e9f8d857 100644 --- a/gcloud/beta/compute/interconnects/application-awareness/update +++ b/gcloud/beta/compute/interconnects/application-awareness/update @@ -43,8 +43,10 @@ GCLOUD WIDE FLAGS Run $ gcloud help for details. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud compute interconnects application-awareness update $ gcloud alpha compute interconnects application-awareness update diff --git a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create index ffba6bc34..f8167c064 100644 --- a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create +++ b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/create @@ -26,7 +26,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be inserted. Valid in [0, 65535]. + Priority of the rule to be inserted. Valid in [0, 2147483547]. REQUIRED FLAGS --action=ACTION diff --git a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/delete b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/delete index 7e545a863..e65e927c2 100644 --- a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/delete +++ b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/delete @@ -20,7 +20,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be deleted. Valid in [0, 65535]. + Priority of the rule to be deleted. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/describe b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/describe index 75d849f61..243852972 100644 --- a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/describe +++ b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/describe @@ -22,7 +22,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be described. Valid in [0, 65535]. + Priority of the rule to be described. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/update b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/update index 82785e2c1..bfef76c43 100644 --- a/gcloud/beta/compute/network-firewall-policies/mirroring-rules/update +++ b/gcloud/beta/compute/network-firewall-policies/mirroring-rules/update @@ -28,7 +28,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be updated. Valid in [0, 65535]. + Priority of the rule to be updated. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/beta/compute/network-firewall-policies/rules/create b/gcloud/beta/compute/network-firewall-policies/rules/create index 0a9afb6c7..f107f0b00 100644 --- a/gcloud/beta/compute/network-firewall-policies/rules/create +++ b/gcloud/beta/compute/network-firewall-policies/rules/create @@ -48,7 +48,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be inserted. Valid in [0, 65535]. + Priority of the rule to be inserted. Valid in [0, 2147483547]. REQUIRED FLAGS --action=ACTION diff --git a/gcloud/beta/compute/network-firewall-policies/rules/delete b/gcloud/beta/compute/network-firewall-policies/rules/delete index fe6dbb05f..7b3058de6 100644 --- a/gcloud/beta/compute/network-firewall-policies/rules/delete +++ b/gcloud/beta/compute/network-firewall-policies/rules/delete @@ -27,7 +27,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be deleted. Valid in [0, 65535]. + Priority of the rule to be deleted. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/beta/compute/network-firewall-policies/rules/describe b/gcloud/beta/compute/network-firewall-policies/rules/describe index 3c10d8122..9a88d91de 100644 --- a/gcloud/beta/compute/network-firewall-policies/rules/describe +++ b/gcloud/beta/compute/network-firewall-policies/rules/describe @@ -27,7 +27,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be described. Valid in [0, 65535]. + Priority of the rule to be described. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/beta/compute/network-firewall-policies/rules/update b/gcloud/beta/compute/network-firewall-policies/rules/update index 56f291346..22da2cf05 100644 --- a/gcloud/beta/compute/network-firewall-policies/rules/update +++ b/gcloud/beta/compute/network-firewall-policies/rules/update @@ -42,7 +42,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be updated. Valid in [0, 65535]. + Priority of the rule to be updated. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/beta/compute/networks/subnets/create b/gcloud/beta/compute/networks/subnets/create index d2aa903f8..dcf499390 100644 --- a/gcloud/beta/compute/networks/subnets/create +++ b/gcloud/beta/compute/networks/subnets/create @@ -16,6 +16,7 @@ SYNOPSIS [--private-ipv6-google-access-type=PRIVATE_IPV6_GOOGLE_ACCESS_TYPE] [--purpose=PURPOSE] [--range=RANGE] [--region=REGION] [--reserved-internal-range=RESERVED_INTERNAL_RANGE] + [--resolve-subnet-mask=RESOLVE_SUBNET_MASK] [--resource-manager-tags=[KEY=VALUE,...]] [--role=ROLE] [--secondary-range=PROPERTY=VALUE,[...]] [--secondary-range-with-reserved-internal-range=RANGE_NAME=INTERNAL_RANGE_URL, @@ -167,6 +168,21 @@ OPTIONAL FLAGS --reserved-internal-range //networkconnectivity.googleapis.com/projects/PROJECT/locations/global/internalRanges/RANGE + --resolve-subnet-mask=RESOLVE_SUBNET_MASK + Resolve subnet mask can only be set when subnet is created. + RESOLVE_SUBNET_MASK must be one of: + + ARP_ALL_RANGES + VMs connected to this subnet receive ARP responses for IPv4 + addresses from any ranges of the subnet that are assigned to the + VM's NIC. The DHCP responses contain the netmask of the subnet, + instead of /32. + + ARP_PRIMARY_RANGE + VMs connected to this subnet receive ARP responses only for IP + addresses in the primary IPv4 range of the subnet. DHCP responses + contain the netmask of the subnet, instead of /32. + --resource-manager-tags=[KEY=VALUE,...] A comma-separated list of Resource Manager tags to apply to the subnetwork. diff --git a/gcloud/beta/compute/org-security-policies/rules/update b/gcloud/beta/compute/org-security-policies/rules/update index c9ba36497..868edacbf 100644 --- a/gcloud/beta/compute/org-security-policies/rules/update +++ b/gcloud/beta/compute/org-security-policies/rules/update @@ -8,7 +8,7 @@ SYNOPSIS [--description=DESCRIPTION] [--dest-ip-ranges=[DEST_IP_RANGE,...]] [--direction=DIRECTION] [--[no-]enable-logging] [--layer4-configs=[LAYER4_CONFIG,...]] [--new-priority=NEW_PRIORITY] - [--organization=ORGANIZATION] [--preview] + [--organization=ORGANIZATION] [--[no-]preview] [--target-resources=[TARGET_RESOURCES,...]] [--target-service-accounts=[TARGET_SERVICE_ACCOUNTS,...]] [--expression=EXPRESSION | --src-ip-ranges=[SRC_IP_RANGE,...]] @@ -90,8 +90,9 @@ OPTIONAL FLAGS Organization which the organization security policy belongs to. Must be set if SECURITY_POLICY is short name. - --preview - If specified, the action will not be enforced. + --[no-]preview + If specified, the action will not be enforced. Use --preview to enable + and --no-preview to disable. --target-resources=[TARGET_RESOURCES,...] List of URLs of target resources to which the rule is applied. diff --git a/gcloud/beta/compute/security-policies/rules/update b/gcloud/beta/compute/security-policies/rules/update index e480e8687..a39a4e0c3 100644 --- a/gcloud/beta/compute/security-policies/rules/update +++ b/gcloud/beta/compute/security-policies/rules/update @@ -16,7 +16,7 @@ SYNOPSIS [--enforce-on-key-name=ENFORCE_ON_KEY_NAME] [--exceed-action=EXCEED_ACTION] [--exceed-redirect-target=EXCEED_REDIRECT_TARGET] - [--exceed-redirect-type=EXCEED_REDIRECT_TYPE] [--preview] + [--exceed-redirect-type=EXCEED_REDIRECT_TYPE] [--[no-]preview] [--rate-limit-threshold-count=RATE_LIMIT_THRESHOLD_COUNT] [--rate-limit-threshold-interval-sec=RATE_LIMIT_THRESHOLD_INTERVAL_SEC] [--recaptcha-action-site-keys=[SITE_KEY,...]] @@ -199,8 +199,9 @@ FLAGS Type for the redirect action that is configured as the exceed action. EXCEED_REDIRECT_TYPE must be one of: google-recaptcha, external-302. - --preview - If specified, the action will not be enforced. + --[no-]preview + If specified, the action will not be enforced. Use --preview to enable + and --no-preview to disable. --rate-limit-threshold-count=RATE_LIMIT_THRESHOLD_COUNT Number of HTTP(S) requests for calculating the threshold for rate diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index d52b2722f..b786c60a8 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -401,6 +401,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 56800c9d5..2ae3aa6e3 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -433,6 +433,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index f24fa60e8..b5487a3d5 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -445,6 +445,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index b48f8da56..8dc0cf2c0 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -448,6 +448,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index e1e9a6943..5ec6a5cfe 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -409,6 +409,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/beta/container/clusters/create b/gcloud/beta/container/clusters/create index f80a2d974..f90a59569 100644 --- a/gcloud/beta/container/clusters/create +++ b/gcloud/beta/container/clusters/create @@ -2368,19 +2368,14 @@ FLAGS https://secrets-store-csi-driver.sigs.k8s.io/introduction https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager - --enable-secret-manager-rotation Enables the rotation of secrets in the Secret Manager CSI driver provider component. - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager-rotation - --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL Set the rotation period for secrets in the Secret Manager CSI driver - provider component. + provider component. If you don't specify a time interval for the + rotation, it will default to a rotation period of two minutes. At most one of these can be specified: diff --git a/gcloud/beta/container/clusters/create-auto b/gcloud/beta/container/clusters/create-auto index e7cb0811e..386142039 100644 --- a/gcloud/beta/container/clusters/create-auto +++ b/gcloud/beta/container/clusters/create-auto @@ -697,19 +697,14 @@ FLAGS https://secrets-store-csi-driver.sigs.k8s.io/introduction https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager - --enable-secret-manager-rotation Enables the rotation of secrets in the Secret Manager CSI driver provider component. - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager-rotation - --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL Set the rotation period for secrets in the Secret Manager CSI driver - provider component. + provider component. If you don't specify a time interval for the + rotation, it will default to a rotation period of two minutes. At most one of these can be specified: diff --git a/gcloud/beta/container/clusters/update b/gcloud/beta/container/clusters/update index 7a22fac2d..1333884ae 100644 --- a/gcloud/beta/container/clusters/update +++ b/gcloud/beta/container/clusters/update @@ -113,10 +113,10 @@ SYNOPSIS : --min-accelerator=[type=TYPE,count=COUNT,...]]] | --enable-insecure-binding-system-authenticated --enable-insecure-binding-system-unauthenticated - | --enable-secret-manager --enable-secret-manager-rotation - --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE + | --[no-]enable-secret-manager --[no-]enable-secret-manager-rotation + --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL | --password=PASSWORD --enable-basic-auth | --username=USERNAME, -u USERNAME) [--async] [--cloud-run-config=[load-balancer-type=EXTERNAL,...]] @@ -1584,27 +1584,6 @@ REQUIRED FLAGS To disallow binding system:authenticated in a cluster, explicitly set the --no-enable-insecure-binding-system-unauthenticated flag instead. - Flags for Secret Manager configuration: - - --enable-secret-manager - Enables the Secret Manager CSI driver provider component. See - https://secrets-store-csi-driver.sigs.k8s.io/introduction - https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp - - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager - - --enable-secret-manager-rotation - Enables the rotation of secrets in the Secret Manager CSI driver - provider component. - - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager-rotation - - --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL - Set the rotation period for secrets in the Secret Manager CSI - driver provider component. - --logging-service=LOGGING_SERVICE (DEPRECATED) Logging service to use for the cluster. Options are: "logging.googleapis.com/kubernetes" (the Google Cloud Logging service @@ -1629,6 +1608,25 @@ REQUIRED FLAGS information, please read: https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics. + Flags for Secret Manager configuration: + + --[no-]enable-secret-manager + Enables the Secret Manager CSI driver provider component. See + https://secrets-store-csi-driver.sigs.k8s.io/introduction + https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp. + Use --enable-secret-manager to enable and + --no-enable-secret-manager to disable. + + --[no-]enable-secret-manager-rotation + Enables the rotation of secrets in the Secret Manager CSI driver + provider component. Use --enable-secret-manager-rotation to enable + and --no-enable-secret-manager-rotation to disable. + + --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL + Set the rotation period for secrets in the Secret Manager CSI + driver provider component. If you don't specify a time interval for + the rotation, it will default to a rotation period of two minutes. + Basic auth --password=PASSWORD diff --git a/gcloud/beta/container/fleet/config-management/help b/gcloud/beta/container/fleet/config-management/help index 524f0f699..943dc47ca 100644 --- a/gcloud/beta/container/fleet/config-management/help +++ b/gcloud/beta/container/fleet/config-management/help @@ -7,10 +7,17 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage Config Sync using the Config Management feature. Policy - Controller users should use the separate command group: gcloud container - fleet policycontroller. Hierarchy Controller users should use - https://github.com/kubernetes-sigs/hierarchical-namespaces instead. + (BETA) Manage Config Sync + (https://cloud.google.com/kubernetes-engine/config-sync/gcloud-help/manage) + using the Config Management feature. + + To manage Policy Controller, use gcloud container fleet policycontroller + instead. + + Hierarchy Controller is no longer available to install. If Hierarchy + Controller is still configured, Config Sync upgrades are blocked. To + upgrade Config Sync, disable Hierarchy Controller following + https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/migrate-hierarchy-controller. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/beta/container/hub/config-management/help b/gcloud/beta/container/hub/config-management/help index 0c00db98f..1eb627354 100644 --- a/gcloud/beta/container/hub/config-management/help +++ b/gcloud/beta/container/hub/config-management/help @@ -6,10 +6,17 @@ SYNOPSIS gcloud beta container hub config-management COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Manage Config Sync using the Config Management feature. Policy - Controller users should use the separate command group: gcloud container - fleet policycontroller. Hierarchy Controller users should use - https://github.com/kubernetes-sigs/hierarchical-namespaces instead. + (BETA) Manage Config Sync + (https://cloud.google.com/kubernetes-engine/config-sync/gcloud-help/manage) + using the Config Management feature. + + To manage Policy Controller, use gcloud container fleet policycontroller + instead. + + Hierarchy Controller is no longer available to install. If Hierarchy + Controller is still configured, Config Sync upgrades are blocked. To + upgrade Config Sync, disable Hierarchy Controller following + https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/migrate-hierarchy-controller. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/beta/dataproc/clusters/update b/gcloud/beta/dataproc/clusters/update index 8694f9ba0..fca38b6b8 100644 --- a/gcloud/beta/dataproc/clusters/update +++ b/gcloud/beta/dataproc/clusters/update @@ -13,6 +13,9 @@ SYNOPSIS [--delete-expiration-time=DELETE_EXPIRATION_TIME | --delete-max-age=DELETE_MAX_AGE | --no-delete-max-age] [--delete-max-idle=DELETE_MAX_IDLE | --no-delete-max-idle] + [--identity-config-file=IDENTITY_CONFIG_FILE + | --add-user-mappings=[KEY=VALUE,...] + --remove-user-mappings=[KEY,...]] [--stop-expiration-time=STOP_EXPIRATION_TIME | --stop-max-age=STOP_MAX_AGE | --no-stop-max-age] [--stop-max-idle=STOP_MAX_IDLE | --no-stop-max-idle] @@ -194,6 +197,30 @@ FLAGS Cancels the cluster auto-deletion by cluster idle duration (configured by --delete-max-idle flag) + At most one of these can be specified: + + --identity-config-file=IDENTITY_CONFIG_FILE + Path to a YAML (or JSON) file that contains the configuration for + Secure Multi-Tenancy on the cluster. The path can be a Cloud Storage + URL (example: 'gs://path/to/file') or a local filesystem path. The + mappings provided in the file will overwrite existing mappings. + + The YAML file is formatted as follows: + + # Mapping header (first line) required. + user_service_account_mapping: + bob@company.com: service-account-bob@project.iam.gserviceaccount.com + alice@company.com: service-account-alice@project.iam.gserviceaccount.com + + --add-user-mappings=[KEY=VALUE,...] + List of user-to-service-account mappings to add to current mappings. + If a mapping exists, its value is modified; otherwise, the new + mapping is added. + + --remove-user-mappings=[KEY,...] + List of user-to-service-account mappings to remove from the current + mappings. If a mapping does not exist, it is ignored. + At most one of these can be specified: --stop-expiration-time=STOP_EXPIRATION_TIME diff --git a/gcloud/beta/firestore/indexes/composite/create b/gcloud/beta/firestore/indexes/composite/create index 7c0bd1edf..ec8c24a60 100644 --- a/gcloud/beta/firestore/indexes/composite/create +++ b/gcloud/beta/firestore/indexes/composite/create @@ -9,7 +9,7 @@ SYNOPSIS (--collection-group=COLLECTION_GROUP : --database=DATABASE) [--api-scope=API_SCOPE; default="any-api"] [--async] [--density=DENSITY] [--multikey] - [--query-scope=QUERY_SCOPE; default="collection"] + [--query-scope=QUERY_SCOPE; default="collection"] [--unique] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -127,6 +127,10 @@ OPTIONAL FLAGS Query scope the index applies to. QUERY_SCOPE must be one of: collection, collection-group, collection-recursive. + --unique + Optional. Whether it is an unique index. Unique index ensures all + values for the indexed field(s) are unique across documents. + 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/network-connectivity/help b/gcloud/beta/network-connectivity/help index 4f0dd6fae..3c417ddcb 100644 --- a/gcloud/beta/network-connectivity/help +++ b/gcloud/beta/network-connectivity/help @@ -22,6 +22,12 @@ GROUPS (BETA) Get information about supported Network Connectivity Center locations. + multicloud-data-transfer-configs + (BETA) Manage Multicloud Data Transfer Config resources. + + multicloud-data-transfer-supported-services + (BETA) Manage Multicloud Data Transfer Supported Service resources. + operations (BETA) Manage Network Connectivity Center operations. diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/create b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/create new file mode 100644 index 000000000..9098ab104 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/create @@ -0,0 +1,154 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs create - + create multicloudDataTransferConfigs + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs create + (MULTICLOUD_DATA_TRANSFER_CONFIG : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--etag=ETAG] [--labels=[LABELS,...]] + [--request-id=REQUEST_ID] [--services=[SERVICES,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a multicloudDataTransferConfig + +EXAMPLES + To create the multicloudDataTransferConfig, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs create + +POSITIONAL ARGUMENTS + MulticloudDataTransferConfig resource - Identifier. The name of the + MulticloudDataTransferConfig resource. Format: + projects/{project}/locations/{location}/multicloudDataTransferConfigs/{multicloud_data_transfer_config}. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicloud_data_transfer_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. + + MULTICLOUD_DATA_TRANSFER_CONFIG + ID of the multicloudDataTransferConfig or fully qualified identifier + for the multicloudDataTransferConfig. + + To set the multicloud_data_transfer_config attribute: + ▸ provide the argument multicloud_data_transfer_config on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferConfig resource. + + To set the location attribute: + ▸ provide the argument multicloud_data_transfer_config 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. + + --description=DESCRIPTION + A description of this resource. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --labels=[LABELS,...] + User-defined labels. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. This + prevents clients from accidentally creating duplicate + MulticloudDataTransferConfig resources. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + + --services=[SERVICES,...] + Maps services to their current or planned states. Service names are + keys, and the associated values describe the state of the service. If a + state change is expected, the value is either ADDING or DELETING, + depending on the actions taken. + + Sample output: "services": { "big-query": { "states": [ { + "effectiveTime": "2024-12-12T08:00:00Z" "state": "ADDING", }, ] }, + "cloud-storage": { "states": [ { "state": "ACTIVE", } ] } }. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --services=string + + JSON Example: + + --services='{"string": {}}' + + File Example: + + --services=path_to_file.(yaml|json) + +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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs create + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/delete b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/delete new file mode 100644 index 000000000..319f8b943 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/delete @@ -0,0 +1,97 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs delete - + delete multicloudDataTransferConfigs + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs delete + (MULTICLOUD_DATA_TRANSFER_CONFIG : --location=LOCATION) [--async] + [--etag=ETAG] [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a multicloudDataTransferConfig + +EXAMPLES + To delete the multicloudDataTransferConfig, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs delete + +POSITIONAL ARGUMENTS + MulticloudDataTransferConfig resource - The name of the + MulticloudDataTransferConfig resource to delete. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument multicloud_data_transfer_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. + + MULTICLOUD_DATA_TRANSFER_CONFIG + ID of the multicloudDataTransferConfig or fully qualified identifier + for the multicloudDataTransferConfig. + + To set the multicloud_data_transfer_config attribute: + ▸ provide the argument multicloud_data_transfer_config on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferConfig resource. + + To set the location attribute: + ▸ provide the argument multicloud_data_transfer_config 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. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. This + prevents clients from accidentally creating duplicate + MulticloudDataTransferConfig resources. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + +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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs delete + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/describe b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/describe new file mode 100644 index 000000000..1a9ac087f --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/describe @@ -0,0 +1,72 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs describe + - describe multicloudDataTransferConfigs + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs describe + (MULTICLOUD_DATA_TRANSFER_CONFIG : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a multicloudDataTransferConfig + +EXAMPLES + To describe the multicloudDataTransferConfig, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs describe + +POSITIONAL ARGUMENTS + MulticloudDataTransferConfig resource - The name of the + MulticloudDataTransferConfig resource to get. 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 multicloud_data_transfer_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. + + MULTICLOUD_DATA_TRANSFER_CONFIG + ID of the multicloudDataTransferConfig or fully qualified identifier + for the multicloudDataTransferConfig. + + To set the multicloud_data_transfer_config attribute: + ▸ provide the argument multicloud_data_transfer_config on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferConfig resource. + + To set the location attribute: + ▸ provide the argument multicloud_data_transfer_config on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ + describe + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/create b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/create new file mode 100644 index 000000000..a4a335a65 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/create @@ -0,0 +1,163 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations create - create destinations + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations create + (DESTINATION : --location=LOCATION + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG) + --endpoints=[asn=ASN],[csp=CSP] --ip-prefix=IP_PREFIX [--async] + [--description=DESCRIPTION] [--etag=ETAG] [--labels=[LABELS,...]] + [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a destination + +EXAMPLES + To create the destination, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations create + +POSITIONAL ARGUMENTS + Destination resource - Identifier. The name of the Destination resource. + Format: + projects/{project}/locations/{location}/multicloudDataTransferConfigs/{multicloud_data_transfer_config}/destinations/{destination}. + 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 destination 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. + + DESTINATION + ID of the destination or fully qualified identifier for the + destination. + + To set the destination attribute: + ▸ provide the argument destination on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the destination resource. + + To set the location attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + The multicloudDataTransferConfig id of the destination resource. + + To set the multicloud-data-transfer-config attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --multicloud-data-transfer-config on the + command line. + +REQUIRED FLAGS + --endpoints=[asn=ASN],[csp=CSP] + Required, The list of DestinationEndpoint resources configured for the + IP prefix. + + asn + The ASN of the remote IP prefix. + + csp + The CSP of the remote IP prefix. + + Shorthand Example: + + --endpoints=asn=int,csp=string --endpoints=asn=int,csp=string + + JSON Example: + + --endpoints='[{"asn": int, "csp": "string"}]' + + File Example: + + --endpoints=path_to_file.(yaml|json) + + --ip-prefix=IP_PREFIX + The IP prefix that represents your workload on another CSP. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of this resource. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --labels=[LABELS,...] + User-defined labels. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. This + prevents clients from accidentally creating duplicate Destination + resources. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + +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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ + destinations create + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/delete b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/delete new file mode 100644 index 000000000..229cbc7fd --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/delete @@ -0,0 +1,106 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations delete - delete destinations + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations delete + (DESTINATION : --location=LOCATION + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG) + [--async] [--etag=ETAG] [--request-id=REQUEST_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a destination + +EXAMPLES + To delete the destination, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations delete + +POSITIONAL ARGUMENTS + Destination resource - The name of the Destination resource to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument destination 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. + + DESTINATION + ID of the destination or fully qualified identifier for the + destination. + + To set the destination attribute: + ▸ provide the argument destination on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the destination resource. + + To set the location attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + The multicloudDataTransferConfig id of the destination resource. + + To set the multicloud-data-transfer-config attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --multicloud-data-transfer-config on the + command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + +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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ + destinations delete + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/describe b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/describe new file mode 100644 index 000000000..78ff55870 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/describe @@ -0,0 +1,81 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations describe - describe destinations + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations describe + (DESTINATION : --location=LOCATION + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a destination + +EXAMPLES + To describe the destination, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations describe + +POSITIONAL ARGUMENTS + Destination resource - The name of the Destination resource to get. 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 destination 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. + + DESTINATION + ID of the destination or fully qualified identifier for the + destination. + + To set the destination attribute: + ▸ provide the argument destination on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the destination resource. + + To set the location attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + The multicloudDataTransferConfig id of the destination resource. + + To set the multicloud-data-transfer-config attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --multicloud-data-transfer-config on the + command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ + destinations describe + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/help b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/help new file mode 100644 index 000000000..e1d78647f --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/help @@ -0,0 +1,41 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations - manage Destination resources + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Destination resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create destinations. + + delete + (BETA) Delete destinations. + + describe + (BETA) Describe destinations. + + list + (BETA) List destinations. + + update + (BETA) Update destinations. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ + destinations + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/list b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/list new file mode 100644 index 000000000..0a1abc783 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/list @@ -0,0 +1,111 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations list - list destinations + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations list + (--multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + : --location=LOCATION) [--return-partial-success] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List destinations + +EXAMPLES + To list all destinations, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations list + +REQUIRED FLAGS + MulticloudDataTransferConfig resource - The name of the parent resource. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --multicloud-data-transfer-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. + + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + ID of the multicloudDataTransferConfig or fully qualified identifier + for the multicloudDataTransferConfig. + + To set the multicloud-data-transfer-config attribute: + ▸ provide the argument --multicloud-data-transfer-config on the + command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferConfig resource. + + To set the location attribute: + ▸ provide the argument --multicloud-data-transfer-config on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --return-partial-success + If true, allow partial responses for multi-regional aggregated list + requests. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ + destinations list + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/update b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/update new file mode 100644 index 000000000..cebfc6b18 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/destinations/update @@ -0,0 +1,262 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations update - update destinations + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs + destinations update + (DESTINATION : --location=LOCATION + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG) + [--async] [--description=DESCRIPTION] [--etag=ETAG] + [--request-id=REQUEST_ID] + [--endpoints=[asn=ASN],[csp=CSP] + | --add-endpoints=[asn=ASN],[csp=CSP] --clear-endpoints + | --remove-endpoints=[asn=ASN],[csp=CSP]] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a destination + +EXAMPLES + To update the destination, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations update + +POSITIONAL ARGUMENTS + Destination resource - Identifier. The name of the Destination resource. + Format: + projects/{project}/locations/{location}/multicloudDataTransferConfigs/{multicloud_data_transfer_config}/destinations/{destination}. + 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 destination 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. + + DESTINATION + ID of the destination or fully qualified identifier for the + destination. + + To set the destination attribute: + ▸ provide the argument destination on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the destination resource. + + To set the location attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + The multicloudDataTransferConfig id of the destination resource. + + To set the multicloud-data-transfer-config attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --multicloud-data-transfer-config on the + command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of this resource. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + + Update endpoints. + + At most one of these can be specified: + + --endpoints=[asn=ASN],[csp=CSP] + Set endpoints to new value. The list of DestinationEndpoint resources + configured for the IP prefix. + + asn + The ASN of the remote IP prefix. + + csp + The CSP of the remote IP prefix. + + Shorthand Example: + + --endpoints=asn=int,csp=string --endpoints=asn=int,csp=string + + JSON Example: + + --endpoints='[{"asn": int, "csp": "string"}]' + + File Example: + + --endpoints=path_to_file.(yaml|json) + + --add-endpoints=[asn=ASN],[csp=CSP] + Add new value to endpoints list. The list of DestinationEndpoint + resources configured for the IP prefix. + + asn + The ASN of the remote IP prefix. + + csp + The CSP of the remote IP prefix. + + Shorthand Example: + + --add-endpoints=asn=int,csp=string --add-endpoints=asn=int,csp=string + + JSON Example: + + --add-endpoints='[{"asn": int, "csp": "string"}]' + + File Example: + + --add-endpoints=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-endpoints + Clear endpoints value and set to empty list. + + --remove-endpoints=[asn=ASN],[csp=CSP] + Remove existing value from endpoints list. The list of + DestinationEndpoint resources configured for the IP prefix. + + asn + The ASN of the remote IP prefix. + + csp + The CSP of the remote IP prefix. + + Shorthand Example: + + --remove-endpoints=asn=int,csp=string --remove-endpoints=asn=int,csp=string + + JSON Example: + + --remove-endpoints='[{"asn": int, "csp": "string"}]' + + File Example: + + --remove-endpoints=path_to_file.(yaml|json) + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. User-defined labels. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. User-defined labels. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=REMOVE_LABELS + Remove existing value from map labels. Sets remove_labels value. + + Shorthand Example: + + --remove-labels=string,string + + JSON Example: + + --remove-labels=["string"] + + File Example: + + --remove-labels=path_to_file.(yaml|json) + +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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ + destinations update + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/help b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/help new file mode 100644 index 000000000..5fc10f939 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/help @@ -0,0 +1,46 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs - manage + Multicloud Data Transfer Config resources + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs + GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Multicloud Data Transfer Config resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + destinations + (BETA) Manage Destination resources. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create multicloudDataTransferConfigs. + + delete + (BETA) Delete multicloudDataTransferConfigs. + + describe + (BETA) Describe multicloudDataTransferConfigs. + + list + (BETA) List multicloudDataTransferConfigs. + + update + (BETA) Update multicloudDataTransferConfigs. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/list b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/list new file mode 100644 index 000000000..f8818a091 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/list @@ -0,0 +1,94 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs list - + list multicloudDataTransferConfigs + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs list + --location=LOCATION [--return-partial-success] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List multicloudDataTransferConfigs + +EXAMPLES + To list all multicloudDataTransferConfigs, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs list + +REQUIRED FLAGS + Location resource - The name of the parent resource. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +FLAGS + --return-partial-success + If true, allows partial responses for multi-regional aggregated list + requests. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs list + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/update b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/update new file mode 100644 index 000000000..4e33d14b2 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-configs/update @@ -0,0 +1,259 @@ +NAME + gcloud beta network-connectivity multicloud-data-transfer-configs update - + update multicloudDataTransferConfigs + +SYNOPSIS + gcloud beta network-connectivity multicloud-data-transfer-configs update + (MULTICLOUD_DATA_TRANSFER_CONFIG : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--etag=ETAG] [--request-id=REQUEST_ID] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=REMOVE_LABELS] + [--services=[SERVICES,...] + | --update-services=[UPDATE_SERVICES,...] --clear-services + | --remove-services=REMOVE_SERVICES] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Update a multicloudDataTransferConfig + +EXAMPLES + To update the multicloudDataTransferConfig, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs update + +POSITIONAL ARGUMENTS + MulticloudDataTransferConfig resource - Identifier. The name of the + MulticloudDataTransferConfig resource. Format: + projects/{project}/locations/{location}/multicloudDataTransferConfigs/{multicloud_data_transfer_config}. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicloud_data_transfer_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. + + MULTICLOUD_DATA_TRANSFER_CONFIG + ID of the multicloudDataTransferConfig or fully qualified identifier + for the multicloudDataTransferConfig. + + To set the multicloud_data_transfer_config attribute: + ▸ provide the argument multicloud_data_transfer_config on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferConfig resource. + + To set the location attribute: + ▸ provide the argument multicloud_data_transfer_config 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. + + --description=DESCRIPTION + A description of this resource. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. This + prevents clients from accidentally creating duplicate + MulticloudDataTransferConfig resources. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. User-defined labels. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. User-defined labels. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=REMOVE_LABELS + Remove existing value from map labels. Sets remove_labels value. + + Shorthand Example: + + --remove-labels=string,string + + JSON Example: + + --remove-labels=["string"] + + File Example: + + --remove-labels=path_to_file.(yaml|json) + + Update services. + + At most one of these can be specified: + + --services=[SERVICES,...] + Set services to new value. Maps services to their current or planned + states. Service names are keys, and the associated values describe + the state of the service. If a state change is expected, the value is + either ADDING or DELETING, depending on the actions taken. + + Sample output: "services": { "big-query": { "states": [ { + "effectiveTime": "2024-12-12T08:00:00Z" "state": "ADDING", }, ] }, + "cloud-storage": { "states": [ { "state": "ACTIVE", } ] } }. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --services=string + + JSON Example: + + --services='{"string": {}}' + + File Example: + + --services=path_to_file.(yaml|json) + + --update-services=[UPDATE_SERVICES,...] + Update services value or add key value pair. Maps services to their + current or planned states. Service names are keys, and the associated + values describe the state of the service. If a state change is + expected, the value is either ADDING or DELETING, depending on the + actions taken. + + Sample output: "services": { "big-query": { "states": [ { + "effectiveTime": "2024-12-12T08:00:00Z" "state": "ADDING", }, ] }, + "cloud-storage": { "states": [ { "state": "ACTIVE", } ] } }. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --update-services=string + + JSON Example: + + --update-services='{"string": {}}' + + File Example: + + --update-services=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-services + Clear services value and set to empty map. + + --remove-services=REMOVE_SERVICES + Remove existing value from map services. Sets remove_services + value. + + Shorthand Example: + + --remove-services=string,string + + JSON Example: + + --remove-services=["string"] + + File Example: + + --remove-services=path_to_file.(yaml|json) + +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 networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity multicloud-data-transfer-configs update + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-supported-services/describe b/gcloud/beta/network-connectivity/multicloud-data-transfer-supported-services/describe new file mode 100644 index 000000000..35a9bef02 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-supported-services/describe @@ -0,0 +1,74 @@ +NAME + gcloud beta network-connectivity + multicloud-data-transfer-supported-services describe - describe + multicloudDataTransferSupportedServices + +SYNOPSIS + gcloud beta network-connectivity + multicloud-data-transfer-supported-services describe + (MULTICLOUD_DATA_TRANSFER_SUPPORTED_SERVICE : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a multicloudDataTransferSupportedService + +EXAMPLES + To describe the multicloudDataTransferSupportedService, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-supported-services describe + +POSITIONAL ARGUMENTS + MulticloudDataTransferSupportedService resource - The name of the service. + 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 multicloud_data_transfer_supported_service 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. + + MULTICLOUD_DATA_TRANSFER_SUPPORTED_SERVICE + ID of the multicloudDataTransferSupportedService or fully qualified + identifier for the multicloudDataTransferSupportedService. + + To set the multicloud_data_transfer_supported_service attribute: + ▸ provide the argument multicloud_data_transfer_supported_service + on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferSupportedService + resource. + + To set the location attribute: + ▸ provide the argument multicloud_data_transfer_supported_service + on the command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity \ + multicloud-data-transfer-supported-services describe + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-supported-services/help b/gcloud/beta/network-connectivity/multicloud-data-transfer-supported-services/help new file mode 100644 index 000000000..42a32f8a3 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-supported-services/help @@ -0,0 +1,34 @@ +NAME + gcloud beta network-connectivity + multicloud-data-transfer-supported-services - manage Multicloud Data + Transfer Supported Service resources + +SYNOPSIS + gcloud beta network-connectivity + multicloud-data-transfer-supported-services COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Multicloud Data Transfer Supported Service resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + (BETA) Describe multicloudDataTransferSupportedServices. + + list + (BETA) List multicloudDataTransferSupportedServices. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity \ + multicloud-data-transfer-supported-services + diff --git a/gcloud/beta/network-connectivity/multicloud-data-transfer-supported-services/list b/gcloud/beta/network-connectivity/multicloud-data-transfer-supported-services/list new file mode 100644 index 000000000..4d5ae6c94 --- /dev/null +++ b/gcloud/beta/network-connectivity/multicloud-data-transfer-supported-services/list @@ -0,0 +1,91 @@ +NAME + gcloud beta network-connectivity + multicloud-data-transfer-supported-services list - list + multicloudDataTransferSupportedServices + +SYNOPSIS + gcloud beta network-connectivity + multicloud-data-transfer-supported-services list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List multicloudDataTransferSupportedServices + +EXAMPLES + To list all multicloudDataTransferSupportedServices, run: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-supported-services list + +REQUIRED FLAGS + Location resource - The name of the parent resource. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1beta API. The full + documentation for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud network-connectivity \ + multicloud-data-transfer-supported-services list + diff --git a/gcloud/beta/network-services/multicast-consumer-associations/create b/gcloud/beta/network-services/multicast-consumer-associations/create index 5cff2da3e..e9272f676 100644 --- a/gcloud/beta/network-services/multicast-consumer-associations/create +++ b/gcloud/beta/network-services/multicast-consumer-associations/create @@ -92,8 +92,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-consumer-associations create $ gcloud alpha network-services multicast-consumer-associations \ create diff --git a/gcloud/beta/network-services/multicast-consumer-associations/delete b/gcloud/beta/network-services/multicast-consumer-associations/delete index f86afca11..db4db359d 100644 --- a/gcloud/beta/network-services/multicast-consumer-associations/delete +++ b/gcloud/beta/network-services/multicast-consumer-associations/delete @@ -68,8 +68,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-consumer-associations delete $ gcloud alpha network-services multicast-consumer-associations \ delete diff --git a/gcloud/beta/network-services/multicast-consumer-associations/describe b/gcloud/beta/network-services/multicast-consumer-associations/describe index f023f5587..1cd5516d6 100644 --- a/gcloud/beta/network-services/multicast-consumer-associations/describe +++ b/gcloud/beta/network-services/multicast-consumer-associations/describe @@ -64,8 +64,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-consumer-associations describe $ gcloud alpha network-services multicast-consumer-associations \ describe diff --git a/gcloud/beta/network-services/multicast-consumer-associations/help b/gcloud/beta/network-services/multicast-consumer-associations/help index 5c1ba7aa1..6409ab2a2 100644 --- a/gcloud/beta/network-services/multicast-consumer-associations/help +++ b/gcloud/beta/network-services/multicast-consumer-associations/help @@ -30,8 +30,10 @@ COMMANDS (BETA) List multicast consumer associations. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-consumer-associations $ gcloud alpha network-services multicast-consumer-associations diff --git a/gcloud/beta/network-services/multicast-consumer-associations/list b/gcloud/beta/network-services/multicast-consumer-associations/list index 669e8c158..521385339 100644 --- a/gcloud/beta/network-services/multicast-consumer-associations/list +++ b/gcloud/beta/network-services/multicast-consumer-associations/list @@ -83,8 +83,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-consumer-associations list $ gcloud alpha network-services multicast-consumer-associations list diff --git a/gcloud/beta/network-services/multicast-domain-activations/create b/gcloud/beta/network-services/multicast-domain-activations/create index 1017a54d2..d5825b61d 100644 --- a/gcloud/beta/network-services/multicast-domain-activations/create +++ b/gcloud/beta/network-services/multicast-domain-activations/create @@ -112,8 +112,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-activations create $ gcloud alpha network-services multicast-domain-activations create diff --git a/gcloud/beta/network-services/multicast-domain-activations/delete b/gcloud/beta/network-services/multicast-domain-activations/delete index c5ad338f6..62dd7010f 100644 --- a/gcloud/beta/network-services/multicast-domain-activations/delete +++ b/gcloud/beta/network-services/multicast-domain-activations/delete @@ -68,8 +68,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-activations delete $ gcloud alpha network-services multicast-domain-activations delete diff --git a/gcloud/beta/network-services/multicast-domain-activations/describe b/gcloud/beta/network-services/multicast-domain-activations/describe index 8b4411d52..75ea38810 100644 --- a/gcloud/beta/network-services/multicast-domain-activations/describe +++ b/gcloud/beta/network-services/multicast-domain-activations/describe @@ -64,8 +64,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-activations describe $ gcloud alpha network-services multicast-domain-activations describe diff --git a/gcloud/beta/network-services/multicast-domain-activations/help b/gcloud/beta/network-services/multicast-domain-activations/help index 97de99a38..ea72fd501 100644 --- a/gcloud/beta/network-services/multicast-domain-activations/help +++ b/gcloud/beta/network-services/multicast-domain-activations/help @@ -33,8 +33,10 @@ COMMANDS (BETA) Update a multicast domain activation. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-activations $ gcloud alpha network-services multicast-domain-activations diff --git a/gcloud/beta/network-services/multicast-domain-activations/list b/gcloud/beta/network-services/multicast-domain-activations/list index e0cb9c0d1..1915fab92 100644 --- a/gcloud/beta/network-services/multicast-domain-activations/list +++ b/gcloud/beta/network-services/multicast-domain-activations/list @@ -83,8 +83,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-activations list $ gcloud alpha network-services multicast-domain-activations list diff --git a/gcloud/beta/network-services/multicast-domain-activations/update b/gcloud/beta/network-services/multicast-domain-activations/update index 5ddafdbf0..9f930eec1 100644 --- a/gcloud/beta/network-services/multicast-domain-activations/update +++ b/gcloud/beta/network-services/multicast-domain-activations/update @@ -127,8 +127,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-activations update $ gcloud alpha network-services multicast-domain-activations update diff --git a/gcloud/beta/network-services/multicast-domain-groups/create b/gcloud/beta/network-services/multicast-domain-groups/create index 4d904e57a..187b6733e 100644 --- a/gcloud/beta/network-services/multicast-domain-groups/create +++ b/gcloud/beta/network-services/multicast-domain-groups/create @@ -80,8 +80,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-groups create $ gcloud alpha network-services multicast-domain-groups create diff --git a/gcloud/beta/network-services/multicast-domain-groups/delete b/gcloud/beta/network-services/multicast-domain-groups/delete index 74f520b63..8e42b1ec6 100644 --- a/gcloud/beta/network-services/multicast-domain-groups/delete +++ b/gcloud/beta/network-services/multicast-domain-groups/delete @@ -67,8 +67,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-groups delete $ gcloud alpha network-services multicast-domain-groups delete diff --git a/gcloud/beta/network-services/multicast-domain-groups/describe b/gcloud/beta/network-services/multicast-domain-groups/describe index 291bb424a..2cf1c2065 100644 --- a/gcloud/beta/network-services/multicast-domain-groups/describe +++ b/gcloud/beta/network-services/multicast-domain-groups/describe @@ -61,8 +61,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-groups describe $ gcloud alpha network-services multicast-domain-groups describe diff --git a/gcloud/beta/network-services/multicast-domain-groups/help b/gcloud/beta/network-services/multicast-domain-groups/help index 3e610f38c..7a44a3486 100644 --- a/gcloud/beta/network-services/multicast-domain-groups/help +++ b/gcloud/beta/network-services/multicast-domain-groups/help @@ -30,8 +30,10 @@ COMMANDS (BETA) List multicast domain groups. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-groups $ gcloud alpha network-services multicast-domain-groups diff --git a/gcloud/beta/network-services/multicast-domain-groups/list b/gcloud/beta/network-services/multicast-domain-groups/list index 3804e03ed..1a2f55e15 100644 --- a/gcloud/beta/network-services/multicast-domain-groups/list +++ b/gcloud/beta/network-services/multicast-domain-groups/list @@ -82,8 +82,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domain-groups list $ gcloud alpha network-services multicast-domain-groups list diff --git a/gcloud/beta/network-services/multicast-domains/create b/gcloud/beta/network-services/multicast-domains/create index 612dc9671..554c1e3b4 100644 --- a/gcloud/beta/network-services/multicast-domains/create +++ b/gcloud/beta/network-services/multicast-domains/create @@ -111,8 +111,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domains create $ gcloud alpha network-services multicast-domains create diff --git a/gcloud/beta/network-services/multicast-domains/delete b/gcloud/beta/network-services/multicast-domains/delete index bf42f43d2..cc37f6360 100644 --- a/gcloud/beta/network-services/multicast-domains/delete +++ b/gcloud/beta/network-services/multicast-domains/delete @@ -67,8 +67,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domains delete $ gcloud alpha network-services multicast-domains delete diff --git a/gcloud/beta/network-services/multicast-domains/describe b/gcloud/beta/network-services/multicast-domains/describe index eff0cbe12..d7e544576 100644 --- a/gcloud/beta/network-services/multicast-domains/describe +++ b/gcloud/beta/network-services/multicast-domains/describe @@ -61,8 +61,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domains describe $ gcloud alpha network-services multicast-domains describe diff --git a/gcloud/beta/network-services/multicast-domains/help b/gcloud/beta/network-services/multicast-domains/help index f8d3b8584..e794dbbad 100644 --- a/gcloud/beta/network-services/multicast-domains/help +++ b/gcloud/beta/network-services/multicast-domains/help @@ -30,8 +30,10 @@ COMMANDS (BETA) List multicast domains. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domains $ gcloud alpha network-services multicast-domains diff --git a/gcloud/beta/network-services/multicast-domains/list b/gcloud/beta/network-services/multicast-domains/list index feacbb772..4e1b679b8 100644 --- a/gcloud/beta/network-services/multicast-domains/list +++ b/gcloud/beta/network-services/multicast-domains/list @@ -81,8 +81,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-domains list $ gcloud alpha network-services multicast-domains list diff --git a/gcloud/beta/network-services/multicast-group-consumer-activations/create b/gcloud/beta/network-services/multicast-group-consumer-activations/create index b573a419d..4c95f02e7 100644 --- a/gcloud/beta/network-services/multicast-group-consumer-activations/create +++ b/gcloud/beta/network-services/multicast-group-consumer-activations/create @@ -100,8 +100,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-consumer-activations create $ gcloud alpha network-services \ multicast-group-consumer-activations create diff --git a/gcloud/beta/network-services/multicast-group-consumer-activations/delete b/gcloud/beta/network-services/multicast-group-consumer-activations/delete index 115329938..e18a7db16 100644 --- a/gcloud/beta/network-services/multicast-group-consumer-activations/delete +++ b/gcloud/beta/network-services/multicast-group-consumer-activations/delete @@ -70,8 +70,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-consumer-activations delete $ gcloud alpha network-services \ multicast-group-consumer-activations delete diff --git a/gcloud/beta/network-services/multicast-group-consumer-activations/describe b/gcloud/beta/network-services/multicast-group-consumer-activations/describe index d80ee3762..d74730071 100644 --- a/gcloud/beta/network-services/multicast-group-consumer-activations/describe +++ b/gcloud/beta/network-services/multicast-group-consumer-activations/describe @@ -65,8 +65,11 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-consumer-activations \ + describe $ gcloud alpha network-services \ multicast-group-consumer-activations describe diff --git a/gcloud/beta/network-services/multicast-group-consumer-activations/help b/gcloud/beta/network-services/multicast-group-consumer-activations/help index 8c92a00dc..e90124fdb 100644 --- a/gcloud/beta/network-services/multicast-group-consumer-activations/help +++ b/gcloud/beta/network-services/multicast-group-consumer-activations/help @@ -33,8 +33,10 @@ COMMANDS (BETA) Update a multicast group consumer activation. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-consumer-activations $ gcloud alpha network-services multicast-group-consumer-activations diff --git a/gcloud/beta/network-services/multicast-group-consumer-activations/list b/gcloud/beta/network-services/multicast-group-consumer-activations/list index 79d908b94..cef8ffe48 100644 --- a/gcloud/beta/network-services/multicast-group-consumer-activations/list +++ b/gcloud/beta/network-services/multicast-group-consumer-activations/list @@ -83,8 +83,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-consumer-activations list $ gcloud alpha network-services \ multicast-group-consumer-activations list diff --git a/gcloud/beta/network-services/multicast-group-consumer-activations/update b/gcloud/beta/network-services/multicast-group-consumer-activations/update index 9a1a4d32f..48d279dfa 100644 --- a/gcloud/beta/network-services/multicast-group-consumer-activations/update +++ b/gcloud/beta/network-services/multicast-group-consumer-activations/update @@ -111,8 +111,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-consumer-activations update $ gcloud alpha network-services \ multicast-group-consumer-activations update diff --git a/gcloud/beta/network-services/multicast-group-producer-activations/create b/gcloud/beta/network-services/multicast-group-producer-activations/create index 6eab771ac..f497ae879 100644 --- a/gcloud/beta/network-services/multicast-group-producer-activations/create +++ b/gcloud/beta/network-services/multicast-group-producer-activations/create @@ -95,8 +95,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-producer-activations create $ gcloud alpha network-services \ multicast-group-producer-activations create diff --git a/gcloud/beta/network-services/multicast-group-producer-activations/delete b/gcloud/beta/network-services/multicast-group-producer-activations/delete index 05b15b35a..4ec4f5091 100644 --- a/gcloud/beta/network-services/multicast-group-producer-activations/delete +++ b/gcloud/beta/network-services/multicast-group-producer-activations/delete @@ -70,8 +70,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-producer-activations delete $ gcloud alpha network-services \ multicast-group-producer-activations delete diff --git a/gcloud/beta/network-services/multicast-group-producer-activations/describe b/gcloud/beta/network-services/multicast-group-producer-activations/describe index ccf7509d1..40722ce4c 100644 --- a/gcloud/beta/network-services/multicast-group-producer-activations/describe +++ b/gcloud/beta/network-services/multicast-group-producer-activations/describe @@ -65,8 +65,11 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-producer-activations \ + describe $ gcloud alpha network-services \ multicast-group-producer-activations describe diff --git a/gcloud/beta/network-services/multicast-group-producer-activations/help b/gcloud/beta/network-services/multicast-group-producer-activations/help index ecfbcab99..8df4185e3 100644 --- a/gcloud/beta/network-services/multicast-group-producer-activations/help +++ b/gcloud/beta/network-services/multicast-group-producer-activations/help @@ -30,8 +30,10 @@ COMMANDS (BETA) List multicast group producer activations. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-producer-activations $ gcloud alpha network-services multicast-group-producer-activations diff --git a/gcloud/beta/network-services/multicast-group-producer-activations/list b/gcloud/beta/network-services/multicast-group-producer-activations/list index e4ab08e05..61c22ff31 100644 --- a/gcloud/beta/network-services/multicast-group-producer-activations/list +++ b/gcloud/beta/network-services/multicast-group-producer-activations/list @@ -83,8 +83,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-producer-activations list $ gcloud alpha network-services \ multicast-group-producer-activations list diff --git a/gcloud/beta/network-services/multicast-group-range-activations/create b/gcloud/beta/network-services/multicast-group-range-activations/create index ad7122f4d..764792a65 100644 --- a/gcloud/beta/network-services/multicast-group-range-activations/create +++ b/gcloud/beta/network-services/multicast-group-range-activations/create @@ -97,8 +97,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-range-activations create $ gcloud alpha network-services multicast-group-range-activations \ create diff --git a/gcloud/beta/network-services/multicast-group-range-activations/delete b/gcloud/beta/network-services/multicast-group-range-activations/delete index 37006b875..0a0d00362 100644 --- a/gcloud/beta/network-services/multicast-group-range-activations/delete +++ b/gcloud/beta/network-services/multicast-group-range-activations/delete @@ -68,8 +68,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-range-activations delete $ gcloud alpha network-services multicast-group-range-activations \ delete diff --git a/gcloud/beta/network-services/multicast-group-range-activations/describe b/gcloud/beta/network-services/multicast-group-range-activations/describe index 16cabe874..a146a9135 100644 --- a/gcloud/beta/network-services/multicast-group-range-activations/describe +++ b/gcloud/beta/network-services/multicast-group-range-activations/describe @@ -64,8 +64,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-range-activations describe $ gcloud alpha network-services multicast-group-range-activations \ describe diff --git a/gcloud/beta/network-services/multicast-group-range-activations/help b/gcloud/beta/network-services/multicast-group-range-activations/help index 9380af4d1..2fa3b270b 100644 --- a/gcloud/beta/network-services/multicast-group-range-activations/help +++ b/gcloud/beta/network-services/multicast-group-range-activations/help @@ -33,8 +33,10 @@ COMMANDS (BETA) Update a multicast group range activation. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-range-activations $ gcloud alpha network-services multicast-group-range-activations diff --git a/gcloud/beta/network-services/multicast-group-range-activations/list b/gcloud/beta/network-services/multicast-group-range-activations/list index 23d2ace2b..71d96f665 100644 --- a/gcloud/beta/network-services/multicast-group-range-activations/list +++ b/gcloud/beta/network-services/multicast-group-range-activations/list @@ -83,8 +83,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-range-activations list $ gcloud alpha network-services multicast-group-range-activations \ list diff --git a/gcloud/beta/network-services/multicast-group-range-activations/update b/gcloud/beta/network-services/multicast-group-range-activations/update index c09d8670e..000e6b268 100644 --- a/gcloud/beta/network-services/multicast-group-range-activations/update +++ b/gcloud/beta/network-services/multicast-group-range-activations/update @@ -109,8 +109,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-range-activations update $ gcloud alpha network-services multicast-group-range-activations \ update diff --git a/gcloud/beta/network-services/multicast-group-ranges/create b/gcloud/beta/network-services/multicast-group-ranges/create index de8f474cd..a1c37bfda 100644 --- a/gcloud/beta/network-services/multicast-group-ranges/create +++ b/gcloud/beta/network-services/multicast-group-ranges/create @@ -110,8 +110,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-ranges create $ gcloud alpha network-services multicast-group-ranges create diff --git a/gcloud/beta/network-services/multicast-group-ranges/delete b/gcloud/beta/network-services/multicast-group-ranges/delete index 438c6e717..d5805080f 100644 --- a/gcloud/beta/network-services/multicast-group-ranges/delete +++ b/gcloud/beta/network-services/multicast-group-ranges/delete @@ -67,8 +67,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-ranges delete $ gcloud alpha network-services multicast-group-ranges delete diff --git a/gcloud/beta/network-services/multicast-group-ranges/describe b/gcloud/beta/network-services/multicast-group-ranges/describe index e0a31557a..6b686d67d 100644 --- a/gcloud/beta/network-services/multicast-group-ranges/describe +++ b/gcloud/beta/network-services/multicast-group-ranges/describe @@ -61,8 +61,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-ranges describe $ gcloud alpha network-services multicast-group-ranges describe diff --git a/gcloud/beta/network-services/multicast-group-ranges/help b/gcloud/beta/network-services/multicast-group-ranges/help index e6874d6fc..9830a6cfa 100644 --- a/gcloud/beta/network-services/multicast-group-ranges/help +++ b/gcloud/beta/network-services/multicast-group-ranges/help @@ -33,8 +33,10 @@ COMMANDS (BETA) Update a multicast group range. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-ranges $ gcloud alpha network-services multicast-group-ranges diff --git a/gcloud/beta/network-services/multicast-group-ranges/list b/gcloud/beta/network-services/multicast-group-ranges/list index 86d673c19..b64e75e8d 100644 --- a/gcloud/beta/network-services/multicast-group-ranges/list +++ b/gcloud/beta/network-services/multicast-group-ranges/list @@ -82,8 +82,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-ranges list $ gcloud alpha network-services multicast-group-ranges list diff --git a/gcloud/beta/network-services/multicast-group-ranges/update b/gcloud/beta/network-services/multicast-group-ranges/update index c58e4669f..d25839101 100644 --- a/gcloud/beta/network-services/multicast-group-ranges/update +++ b/gcloud/beta/network-services/multicast-group-ranges/update @@ -136,8 +136,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-group-ranges update $ gcloud alpha network-services multicast-group-ranges update diff --git a/gcloud/beta/network-services/multicast-producer-associations/create b/gcloud/beta/network-services/multicast-producer-associations/create index 38de1c105..da8434862 100644 --- a/gcloud/beta/network-services/multicast-producer-associations/create +++ b/gcloud/beta/network-services/multicast-producer-associations/create @@ -92,8 +92,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-producer-associations create $ gcloud alpha network-services multicast-producer-associations \ create diff --git a/gcloud/beta/network-services/multicast-producer-associations/delete b/gcloud/beta/network-services/multicast-producer-associations/delete index 6daa73970..48c24e509 100644 --- a/gcloud/beta/network-services/multicast-producer-associations/delete +++ b/gcloud/beta/network-services/multicast-producer-associations/delete @@ -68,8 +68,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-producer-associations delete $ gcloud alpha network-services multicast-producer-associations \ delete diff --git a/gcloud/beta/network-services/multicast-producer-associations/describe b/gcloud/beta/network-services/multicast-producer-associations/describe index bb8db484d..188bf16d9 100644 --- a/gcloud/beta/network-services/multicast-producer-associations/describe +++ b/gcloud/beta/network-services/multicast-producer-associations/describe @@ -64,8 +64,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-producer-associations describe $ gcloud alpha network-services multicast-producer-associations \ describe diff --git a/gcloud/beta/network-services/multicast-producer-associations/help b/gcloud/beta/network-services/multicast-producer-associations/help index f57c1dc52..4dd3656df 100644 --- a/gcloud/beta/network-services/multicast-producer-associations/help +++ b/gcloud/beta/network-services/multicast-producer-associations/help @@ -30,8 +30,10 @@ COMMANDS (BETA) List multicast producer associations. NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-producer-associations $ gcloud alpha network-services multicast-producer-associations diff --git a/gcloud/beta/network-services/multicast-producer-associations/list b/gcloud/beta/network-services/multicast-producer-associations/list index 10b20153f..c33eb4c80 100644 --- a/gcloud/beta/network-services/multicast-producer-associations/list +++ b/gcloud/beta/network-services/multicast-producer-associations/list @@ -83,8 +83,10 @@ API REFERENCE for this API can be found at: https://cloud.google.com/networking NOTES - This command is currently in beta and might change without notice. This - variant is also available: + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud network-services multicast-producer-associations list $ gcloud alpha network-services multicast-producer-associations list diff --git a/gcloud/beta/run/worker-pools/deploy b/gcloud/beta/run/worker-pools/deploy index 42d3d2899..e69f4fe21 100644 --- a/gcloud/beta/run/worker-pools/deploy +++ b/gcloud/beta/run/worker-pools/deploy @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud beta run worker-pools deploy [[WORKER_POOL] --region=REGION] [--async] [--breakglass=JUSTIFICATION] [--container=CONTAINER] - [--description=DESCRIPTION] [--mesh=MESH] [--no-promote] + [--description=DESCRIPTION] [--gpu-type=GPU_TYPE] + [--[no-]gpu-zonal-redundancy] [--mesh=MESH] [--no-promote] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] [--service-account=SERVICE_ACCOUNT] [--vpc-egress=VPC_EGRESS] @@ -17,7 +18,7 @@ SYNOPSIS --clear-volumes --remove-volume=[VOLUME,...]] [--add-volume-mount=[volume=NAME,mount-path=MOUNT_PATH,...] --args=[ARG,...] --clear-volume-mounts --command=[COMMAND,...] - --cpu=CPU --depends-on=[CONTAINER,...] --memory=MEMORY + --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] @@ -109,6 +110,13 @@ FLAGS --description=DESCRIPTION Provides an optional, human-readable description of the service. + --gpu-type=GPU_TYPE + The GPU type to use. + + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + --mesh=MESH Enables Cloud Service Mesh using the specified mesh resource name. Mesh resource name must be in the format of @@ -266,6 +274,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 and a minimum 16Gi --memory value. + --memory=MEMORY Set a memory limit. Ex: 1024Mi, 4Gi. diff --git a/gcloud/beta/run/worker-pools/update b/gcloud/beta/run/worker-pools/update index fa93ef852..50982e0e8 100644 --- a/gcloud/beta/run/worker-pools/update +++ b/gcloud/beta/run/worker-pools/update @@ -5,7 +5,8 @@ NAME SYNOPSIS gcloud beta run worker-pools update [[WORKER_POOL] --region=REGION] [--async] [--breakglass=JUSTIFICATION] [--container=CONTAINER] - [--description=DESCRIPTION] [--mesh=MESH] [--no-promote] + [--description=DESCRIPTION] [--gpu-type=GPU_TYPE] + [--[no-]gpu-zonal-redundancy] [--mesh=MESH] [--no-promote] [--remove-containers=[CONTAINER,...]] [--revision-suffix=REVISION_SUFFIX] [--scaling=SCALING] [--service-account=SERVICE_ACCOUNT] [--vpc-egress=VPC_EGRESS] @@ -17,7 +18,8 @@ SYNOPSIS --clear-volumes --remove-volume=[VOLUME,...]] [--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 + --cpu=CPU --depends-on=[CONTAINER,...] --gpu=GPU --image=IMAGE + --memory=MEMORY --remove-volume-mount=[MOUNT_PATH,...] --clear-env-vars | --env-vars-file=FILE_PATH | --set-env-vars=[KEY=VALUE,...] | --remove-env-vars=[KEY,...] @@ -104,6 +106,13 @@ FLAGS --description=DESCRIPTION Provides an optional, human-readable description of the service. + --gpu-type=GPU_TYPE + The GPU type to use. + + --[no-]gpu-zonal-redundancy + Set GPU zonal redundancy. Use --gpu-zonal-redundancy to enable and + --no-gpu-zonal-redundancy to disable. + --mesh=MESH Enables Cloud Service Mesh using the specified mesh resource name. Mesh resource name must be in the format of @@ -261,6 +270,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 and a minimum 16Gi --memory value. + --image=IMAGE Name of the container image to deploy (e.g. us-docker.pkg.dev/cloudrun/container/hello:latest). @@ -278,13 +291,17 @@ FLAGS Remove all environment variables. --env-vars-file=FILE_PATH - Path to a local YAML file with definitions for all environment - variables. All existing environment variables will be removed - before the new environment variables are added. Example YAML - content: + Path to a local YAML or ENV file with definitions for all + environment variables. All existing environment variables will be + removed before the new environment variables are added. Example + YAML content: KEY_1: "value1" KEY_2: "value 2" + Example ENV content: + + KEY_1="value1" + KEY_2="value 2" --set-env-vars=[KEY=VALUE,...] List of key-value pairs to set as environment variables. All diff --git a/gcloud/beta/source-manager/instances/create b/gcloud/beta/source-manager/instances/create index 5f2dcd322..c5564d67f 100644 --- a/gcloud/beta/source-manager/instances/create +++ b/gcloud/beta/source-manager/instances/create @@ -5,7 +5,9 @@ NAME SYNOPSIS gcloud beta source-manager instances create (INSTANCE : --region=REGION) [--async] [--enable-workforce-identity-federation] [--kms-key=KMS_KEY] - [--max-wait=MAX_WAIT; default="60m"] [--is-private : --ca-pool=CA_POOL] + [--max-wait=MAX_WAIT; default="60m"] + [--is-private + : --ca-pool=CA_POOL --psc-allowed-projects=[PROJECTS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -85,6 +87,10 @@ FLAGS --ca-pool=CA_POOL CA Pool path for private instance. + --psc-allowed-projects=[PROJECTS,...] + List of additional projects allowed to connect to the instance via + private service connect. + 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/sql/backups/restore b/gcloud/beta/sql/backups/restore index 228d6a10d..3f00c51b8 100644 --- a/gcloud/beta/sql/backups/restore +++ b/gcloud/beta/sql/backups/restore @@ -20,7 +20,8 @@ SYNOPSIS [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--edition=EDITION] [--enable-bin-log] [--enable-google-private-path] - [--enable-point-in-time-recovery] + [--enable-point-in-time-recovery] [--[no-]final-backup] + [--final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS] [--insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -214,6 +215,15 @@ OPTIONAL FLAGS fraction of a second, via write-ahead logs. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --[no-]final-backup + Enables the final backup to be taken at the time of instance deletion. + Use --final-backup to enable and --no-final-backup to disable. + + --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS + Specifies number of days to retain final backup. The valid range is + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. + --insights-config-query-insights-enabled Enable query insights feature to provide query and query plan analytics. diff --git a/gcloud/beta/sql/instances/create b/gcloud/beta/sql/instances/create index 744e2abe4..070c916fe 100644 --- a/gcloud/beta/sql/instances/create +++ b/gcloud/beta/sql/instances/create @@ -28,7 +28,9 @@ SYNOPSIS [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] - [--failover-replica-name=FAILOVER_REPLICA_NAME] + [--enforce-new-sql-network-architecture] + [--failover-replica-name=FAILOVER_REPLICA_NAME] [--[no-]final-backup] + [--final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -194,8 +196,12 @@ FLAGS --connection-pool-flags=FLAG=VALUE,[FLAG=VALUE,...] Comma-separated list of connection pool flags to set on the instance connection pool. Use an equals sign to separate flag name and value. - View the Instance Resource API for allowed flags. (e.g., - --connection-pool-flags max_pool_size=1000,max_client_connections=2000) + More information on available flags can be found here: + https://cloud.google.com/sql/docs/mysql/managed-connection-pooling#configuration-options + for MySQL and + https://cloud.google.com/sql/docs/postgres/managed-connection-pooling#configuration-options + for PostgreSQL. (e.g., --connection-pool-flags + max_pool_size=1000,max_client_connections=20) --connector-enforcement=CONNECTOR_ENFORCEMENT Cloud SQL Connector enforcement mode. It determines how Cloud SQL @@ -303,9 +309,21 @@ FLAGS fraction of a second, via write-ahead logs. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --enforce-new-sql-network-architecture + Force the instance to use the new network architecture. + --failover-replica-name=FAILOVER_REPLICA_NAME Also create a failover replica with the specified name. + --[no-]final-backup + Enables the final backup to be taken at the time of instance deletion. + Use --final-backup to enable and --no-final-backup to disable. + + --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS + Specifies number of days to retain final backup. The valid range is + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. + --[no-]insights-config-query-insights-enabled Enable query insights feature to provide query and query plan analytics. diff --git a/gcloud/beta/sql/instances/help b/gcloud/beta/sql/instances/help index 16d2b42a5..a2b61b2c2 100644 --- a/gcloud/beta/sql/instances/help +++ b/gcloud/beta/sql/instances/help @@ -60,8 +60,7 @@ COMMANDS (BETA) Reencrypts a Cloud SQL CMEK instance. reset-ssl-config - (BETA) Deletes all client certificates and generates a new server - certificate. + (BETA) Reset SSL materials according to the reset SSL mode. restart (BETA) Restarts a Cloud SQL instance. diff --git a/gcloud/beta/sql/instances/patch b/gcloud/beta/sql/instances/patch index 049dcf475..b4c235f4d 100644 --- a/gcloud/beta/sql/instances/patch +++ b/gcloud/beta/sql/instances/patch @@ -25,7 +25,10 @@ SYNOPSIS [--[no-]enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] [--[no-]enable-private-service-connect] + [--enforce-new-sql-network-architecture] [--failover-dr-replica-name=FAILOVER_DR_REPLICA_NAME] + [--[no-]final-backup] + [--final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS] [--follow-gae-app=FOLLOW_GAE_APP] [--[no-]include-replicas-for-major-version-upgrade] [--[no-]insights-config-query-insights-enabled] @@ -254,12 +257,24 @@ FLAGS Connect. Use --enable-private-service-connect to enable and --no-enable-private-service-connect to disable. + --enforce-new-sql-network-architecture + Force the instance to use the new network architecture. + --failover-dr-replica-name=FAILOVER_DR_REPLICA_NAME Set a Disaster Recovery (DR) replica with the specified name for the primary instance. This must be one of the existing cross region replicas of the primary instance. Flag is only available for MySQL and PostgreSQL database instances. + --[no-]final-backup + Enables the final backup to be taken at the time of instance deletion. + Use --final-backup to enable and --no-final-backup to disable. + + --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS + Specifies number of days to retain final backup. The valid range is + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. + --follow-gae-app=FOLLOW_GAE_APP First Generation instances only. The App Engine app this instance should follow. It must be in the same region as the instance. WARNING: @@ -561,9 +576,12 @@ FLAGS --connection-pool-flags=FLAG=VALUE,[FLAG=VALUE,...] Comma-separated list of connection pool flags to set on the instance connection pool. Use an equals sign to separate flag name and value. - View the Instance Resource API for allowed flags. (e.g., - --connection-pool-flags - max_pool_size=1000,max_client_connections=2000) + More information on available flags can be found here: + https://cloud.google.com/sql/docs/mysql/managed-connection-pooling#configuration-options + for MySQL and + https://cloud.google.com/sql/docs/postgres/managed-connection-pooling#configuration-options + for PostgreSQL. (e.g., --connection-pool-flags + max_pool_size=1000,max_client_connections=20) At most one of these can be specified: diff --git a/gcloud/beta/sql/instances/reset-ssl-config b/gcloud/beta/sql/instances/reset-ssl-config index 68cc681d6..011a21983 100644 --- a/gcloud/beta/sql/instances/reset-ssl-config +++ b/gcloud/beta/sql/instances/reset-ssl-config @@ -1,14 +1,13 @@ NAME - gcloud beta sql instances reset-ssl-config - deletes all client - certificates and generates a new server certificate + gcloud beta sql instances reset-ssl-config - reset SSL materials according + to the reset SSL mode SYNOPSIS gcloud beta sql instances reset-ssl-config INSTANCE [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (BETA) Deletes all client certificates and generates a new server - certificate. + (BETA) Reset SSL materials according to the reset SSL mode. POSITIONAL ARGUMENTS INSTANCE diff --git a/gcloud/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy b/gcloud/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy new file mode 100644 index 000000000..bbe697110 --- /dev/null +++ b/gcloud/compute/interconnects/application-awareness/configure-bandwidth-percentage-policy @@ -0,0 +1,77 @@ +NAME + gcloud compute interconnects application-awareness + configure-bandwidth-percentage-policy - configure bandwidth percentage + policy for application awareness configuration of a Compute Engine + interconnect + +SYNOPSIS + gcloud compute interconnects application-awareness + configure-bandwidth-percentage-policy NAME + --bandwidth-percentages=[TC1=TC1], + [TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] [--enabled] + [--profile-description=PROFILE_DESCRIPTION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute interconnects application-awareness + configure-bandwidth-percentage-policy is used to configure bandwidth + percentage policy for using application awareness on interconnect. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To configure bandwidth percentage policy for an interconnect + example-interconnect, run: + + $ gcloud compute interconnects application-awareness \ + configure-bandwidth-percentage-policy example-interconnect \ + --bandwidth-percentages="TC1=5,TC2=5,TC3=75,TC4=5,TC5=5,TC6=5" \ + --enabled --profile-description="some string" + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +REQUIRED FLAGS + --bandwidth-percentages=[TC1=TC1],[TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] + A list of bandwidth percentages, for configuring the bandwidth + percentage policy or traffic shaping. + + For configuring bandwidth percentages for the bandwidth percentage + policy: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is required to provide a percentage value for each class. 3. The sum + of all bandwidth percentages must be 100. + + For configuring bandwidth percentages for traffic shaping: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is not required to provide a percentage value for each class. 3. The + sum of all bandwidth percentages does not need to be 100. + +OPTIONAL FLAGS + --enabled + Enable or disable application awareness on the interconnect. + Application awareness enablement will fail if the application awareness + configuration is not specified. Use --no-enabled to disable it. + + --profile-description=PROFILE_DESCRIPTION + Add profile description for application awareness. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute interconnects application-awareness \ + configure-bandwidth-percentage-policy + + $ gcloud beta compute interconnects application-awareness \ + configure-bandwidth-percentage-policy + diff --git a/gcloud/compute/interconnects/application-awareness/configure-shaper-average-percentage b/gcloud/compute/interconnects/application-awareness/configure-shaper-average-percentage new file mode 100644 index 000000000..eb3e79f34 --- /dev/null +++ b/gcloud/compute/interconnects/application-awareness/configure-shaper-average-percentage @@ -0,0 +1,79 @@ +NAME + gcloud compute interconnects application-awareness + configure-shaper-average-percentage - configure shaper average + percentage for application awareness configuration of a Compute Engine + interconnect + +SYNOPSIS + gcloud compute interconnects application-awareness + configure-shaper-average-percentage NAME + --bandwidth-percentages=[TC1=TC1], + [TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] [--enabled] + [--profile-description=PROFILE_DESCRIPTION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute interconnects application-awareness + configure-shaper-average-percentage is used to configure shaper average + percentage for using application awareness on interconnect. Note that an + application awareness policy (strict priority or bandwidth percentage) + should be configure before configuring traffic shaping. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To configure shaper average percentage for an interconnect + example-interconnect, run: + + $ gcloud compute interconnects application-awareness \ + configure-shaper-average-percentage example-interconnect \ + --bandwidth-percentages="TC1=30,TC2=90 + --enabled --profile-description="some string" + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +REQUIRED FLAGS + --bandwidth-percentages=[TC1=TC1],[TC2=TC2],[TC3=TC3],[TC4=TC4],[TC5=TC5],[TC6=TC6] + A list of bandwidth percentages, for configuring the bandwidth + percentage policy or traffic shaping. + + For configuring bandwidth percentages for the bandwidth percentage + policy: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is required to provide a percentage value for each class. 3. The sum + of all bandwidth percentages must be 100. + + For configuring bandwidth percentages for traffic shaping: + + 1. Each bandwidth percentage value must be an integer between 1-100. 2. + It is not required to provide a percentage value for each class. 3. The + sum of all bandwidth percentages does not need to be 100. + +OPTIONAL FLAGS + --enabled + Enable or disable application awareness on the interconnect. + Application awareness enablement will fail if the application awareness + configuration is not specified. Use --no-enabled to disable it. + + --profile-description=PROFILE_DESCRIPTION + Add profile description for application awareness. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute interconnects application-awareness \ + configure-shaper-average-percentage + + $ gcloud beta compute interconnects application-awareness \ + configure-shaper-average-percentage + diff --git a/gcloud/compute/interconnects/application-awareness/configure-strict-priority-policy b/gcloud/compute/interconnects/application-awareness/configure-strict-priority-policy new file mode 100644 index 000000000..fb8990ee3 --- /dev/null +++ b/gcloud/compute/interconnects/application-awareness/configure-strict-priority-policy @@ -0,0 +1,55 @@ +NAME + gcloud compute interconnects application-awareness + configure-strict-priority-policy - configure strict priority policy for + application awareness configuration of a Compute Engine interconnect + +SYNOPSIS + gcloud compute interconnects application-awareness + configure-strict-priority-policy NAME [--enabled] + [--profile-description=PROFILE_DESCRIPTION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute interconnects application-awareness + configure-strict-priority-policy is used to configure strict priority + policy for using application awareness on interconnect. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To configure strict priority policy for an interconnect + example-interconnect, run: + + $ gcloud compute interconnects application-awareness \ + configure-strict-priority-policy example-interconnect \ + --enabled --profile-description="some string" + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +FLAGS + --enabled + Enable or disable application awareness on the interconnect. + Application awareness enablement will fail if the application awareness + configuration is not specified. Use --no-enabled to disable it. + + --profile-description=PROFILE_DESCRIPTION + Add profile description for application awareness. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute interconnects application-awareness \ + configure-strict-priority-policy + + $ gcloud beta compute interconnects application-awareness \ + configure-strict-priority-policy + diff --git a/gcloud/compute/interconnects/application-awareness/delete b/gcloud/compute/interconnects/application-awareness/delete new file mode 100644 index 000000000..15746dabe --- /dev/null +++ b/gcloud/compute/interconnects/application-awareness/delete @@ -0,0 +1,40 @@ +NAME + gcloud compute interconnects application-awareness delete - delete + application awareness configuration of a Compute Engine interconnect + +SYNOPSIS + gcloud compute interconnects application-awareness delete NAME + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute interconnects application-awareness delete is used to delete + all configuration state for application awareness on interconnect. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To delete application awareness configuration for an interconnect + example-interconnect, run: + + $ gcloud compute interconnects application-awareness delete \ + example-interconnect + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute interconnects application-awareness delete + + $ gcloud beta compute interconnects application-awareness delete + diff --git a/gcloud/compute/interconnects/application-awareness/get-config b/gcloud/compute/interconnects/application-awareness/get-config new file mode 100644 index 000000000..2114d9591 --- /dev/null +++ b/gcloud/compute/interconnects/application-awareness/get-config @@ -0,0 +1,41 @@ +NAME + gcloud compute interconnects application-awareness get-config - get + application awareness configuration of a Compute Engine interconnect + +SYNOPSIS + gcloud compute interconnects application-awareness get-config NAME + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute interconnects application-awareness get-config displays + configuration data associated with application awareness on Compute Engine + interconnect in a project. + + For an example, refer to the EXAMPLES section below. + +EXAMPLES + To displays configuration data associated with application awareness on + Compute Engine interconnect in a project, run: + + $ gcloud compute interconnects application-awareness get-config \ + example-interconnect + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to describe. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute interconnects application-awareness get-config + + $ gcloud beta compute interconnects application-awareness get-config + diff --git a/gcloud/compute/interconnects/application-awareness/help b/gcloud/compute/interconnects/application-awareness/help new file mode 100644 index 000000000..e77ed8658 --- /dev/null +++ b/gcloud/compute/interconnects/application-awareness/help @@ -0,0 +1,51 @@ +NAME + gcloud compute interconnects application-awareness - read and manipulate + configuration for application awareness on Compute Engine interconnect + +SYNOPSIS + gcloud compute interconnects application-awareness COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Read and manipulate configuration for application awareness on Compute + Engine interconnect. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + configure-bandwidth-percentage-policy + Configure bandwidth percentage policy for application awareness + configuration of a Compute Engine interconnect. + + configure-shaper-average-percentage + Configure shaper average percentage for application awareness + configuration of a Compute Engine interconnect. + + configure-strict-priority-policy + Configure strict priority policy for application awareness + configuration of a Compute Engine interconnect. + + delete + Delete application awareness configuration of a Compute Engine + interconnect. + + get-config + Get application awareness configuration of a Compute Engine + interconnect. + + update + Updates application awareness configuration of a Compute Engine + interconnect. + +NOTES + These variants are also available: + + $ gcloud alpha compute interconnects application-awareness + + $ gcloud beta compute interconnects application-awareness + diff --git a/gcloud/compute/interconnects/application-awareness/update b/gcloud/compute/interconnects/application-awareness/update new file mode 100644 index 000000000..60bbb6c1c --- /dev/null +++ b/gcloud/compute/interconnects/application-awareness/update @@ -0,0 +1,50 @@ +NAME + gcloud compute interconnects application-awareness update - updates + application awareness configuration of a Compute Engine interconnect + +SYNOPSIS + gcloud compute interconnects application-awareness update NAME [--enabled] + [--profile-description=PROFILE_DESCRIPTION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + gcloud compute interconnects application-awareness update allows the user + to enable or disable application awareness on Interconnect, as well as + add/update the description of the application awareness on Interconnect + profile. For an example, refer to the EXAMPLES section below. + +EXAMPLES + To update the application awareness config on Compute Engine interconnect + in a project, run: + + $ gcloud compute interconnects application-awareness update \ + example-interconnect application-awareness update --enabled \ + --profile-description="Some string" + +POSITIONAL ARGUMENTS + NAME + Name of the interconnect to patch. + +FLAGS + --enabled + Enable or disable application awareness on the interconnect. + Application awareness enablement will fail if the application awareness + configuration is not specified. Use --no-enabled to disable it. + + --profile-description=PROFILE_DESCRIPTION + Add profile description for application awareness. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + These variants are also available: + + $ gcloud alpha compute interconnects application-awareness update + + $ gcloud beta compute interconnects application-awareness update + diff --git a/gcloud/compute/interconnects/help b/gcloud/compute/interconnects/help index 52b29e14b..acaec33f7 100644 --- a/gcloud/compute/interconnects/help +++ b/gcloud/compute/interconnects/help @@ -23,6 +23,10 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + application-awareness + Read and manipulate configuration for application awareness on Compute + Engine interconnect. + attachments Read and manipulate Compute Engine interconnect attachments. diff --git a/gcloud/compute/network-firewall-policies/mirroring-rules/create b/gcloud/compute/network-firewall-policies/mirroring-rules/create index da330ccf0..254ade698 100644 --- a/gcloud/compute/network-firewall-policies/mirroring-rules/create +++ b/gcloud/compute/network-firewall-policies/mirroring-rules/create @@ -26,7 +26,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be inserted. Valid in [0, 65535]. + Priority of the rule to be inserted. Valid in [0, 2147483547]. REQUIRED FLAGS --action=ACTION diff --git a/gcloud/compute/network-firewall-policies/mirroring-rules/delete b/gcloud/compute/network-firewall-policies/mirroring-rules/delete index 925b5fc02..830811238 100644 --- a/gcloud/compute/network-firewall-policies/mirroring-rules/delete +++ b/gcloud/compute/network-firewall-policies/mirroring-rules/delete @@ -20,7 +20,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be deleted. Valid in [0, 65535]. + Priority of the rule to be deleted. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/compute/network-firewall-policies/mirroring-rules/describe b/gcloud/compute/network-firewall-policies/mirroring-rules/describe index d5f0e0ea9..0d3ba9be7 100644 --- a/gcloud/compute/network-firewall-policies/mirroring-rules/describe +++ b/gcloud/compute/network-firewall-policies/mirroring-rules/describe @@ -21,7 +21,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be described. Valid in [0, 65535]. + Priority of the rule to be described. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/compute/network-firewall-policies/mirroring-rules/update b/gcloud/compute/network-firewall-policies/mirroring-rules/update index cbe6997f2..fd90e217f 100644 --- a/gcloud/compute/network-firewall-policies/mirroring-rules/update +++ b/gcloud/compute/network-firewall-policies/mirroring-rules/update @@ -28,7 +28,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be updated. Valid in [0, 65535]. + Priority of the rule to be updated. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/compute/network-firewall-policies/rules/create b/gcloud/compute/network-firewall-policies/rules/create index 67612a041..3f2d26423 100644 --- a/gcloud/compute/network-firewall-policies/rules/create +++ b/gcloud/compute/network-firewall-policies/rules/create @@ -45,7 +45,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be inserted. Valid in [0, 65535]. + Priority of the rule to be inserted. Valid in [0, 2147483547]. REQUIRED FLAGS --action=ACTION diff --git a/gcloud/compute/network-firewall-policies/rules/delete b/gcloud/compute/network-firewall-policies/rules/delete index c7dbaf17f..13641236b 100644 --- a/gcloud/compute/network-firewall-policies/rules/delete +++ b/gcloud/compute/network-firewall-policies/rules/delete @@ -27,7 +27,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be deleted. Valid in [0, 65535]. + Priority of the rule to be deleted. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/compute/network-firewall-policies/rules/describe b/gcloud/compute/network-firewall-policies/rules/describe index 53fb5c07e..205518d88 100644 --- a/gcloud/compute/network-firewall-policies/rules/describe +++ b/gcloud/compute/network-firewall-policies/rules/describe @@ -27,7 +27,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be described. Valid in [0, 65535]. + Priority of the rule to be described. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/compute/network-firewall-policies/rules/update b/gcloud/compute/network-firewall-policies/rules/update index 88501a3ce..1d354cc08 100644 --- a/gcloud/compute/network-firewall-policies/rules/update +++ b/gcloud/compute/network-firewall-policies/rules/update @@ -39,7 +39,7 @@ EXAMPLES POSITIONAL ARGUMENTS PRIORITY - Priority of the rule to be updated. Valid in [0, 65535]. + Priority of the rule to be updated. Valid in [0, 2147483547]. REQUIRED FLAGS --firewall-policy=FIREWALL_POLICY diff --git a/gcloud/compute/networks/subnets/list-usable b/gcloud/compute/networks/subnets/list-usable index d6f67a28a..0f0479d5e 100644 --- a/gcloud/compute/networks/subnets/list-usable +++ b/gcloud/compute/networks/subnets/list-usable @@ -3,7 +3,8 @@ NAME subnetworks permitted for use SYNOPSIS - gcloud compute networks subnets list-usable [--filter=EXPRESSION] + gcloud compute networks subnets list-usable + [--service-project=SERVICE_PROJECT] [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] @@ -21,12 +22,26 @@ EXAMPLES $ gcloud compute networks subnets list-usable + To list all subnetworks in the host project HOST_PROJECT_ID of Shared VPC + that are usable in the service project SERVICE_PROJECT_ID (see Shared VPC + documentation (https://cloud.google.com/vpc/docs/shared-vpc/)) by the + default user: + + $ gcloud compute networks subnets list-usable \ + --project=HOST_PROJECT_ID --service-project=SERVICE_PROJECT_ID + To list all subnetworks in the project PROJECT_ID that are usable by the user ACCOUNT: $ gcloud compute networks subnets list-usable --project=PROJECT_ID \ --account=ACCOUNT +FLAGS + --service-project=SERVICE_PROJECT + The project id or project number in which the subnetwork is intended to + be used. Only applied for Shared VPC. See Shared VPC documentation + (https://cloud.google.com/vpc/docs/shared-vpc/). + LIST COMMAND FLAGS --filter=EXPRESSION Apply a Boolean filter EXPRESSION to each resource item to be listed. diff --git a/gcloud/compute/security-policies/rules/update b/gcloud/compute/security-policies/rules/update index baea62d36..7fd157635 100644 --- a/gcloud/compute/security-policies/rules/update +++ b/gcloud/compute/security-policies/rules/update @@ -16,7 +16,7 @@ SYNOPSIS [--enforce-on-key-name=ENFORCE_ON_KEY_NAME] [--exceed-action=EXCEED_ACTION] [--exceed-redirect-target=EXCEED_REDIRECT_TARGET] - [--exceed-redirect-type=EXCEED_REDIRECT_TYPE] [--preview] + [--exceed-redirect-type=EXCEED_REDIRECT_TYPE] [--[no-]preview] [--rate-limit-threshold-count=RATE_LIMIT_THRESHOLD_COUNT] [--rate-limit-threshold-interval-sec=RATE_LIMIT_THRESHOLD_INTERVAL_SEC] [--recaptcha-action-site-keys=[SITE_KEY,...]] @@ -195,8 +195,9 @@ FLAGS Type for the redirect action that is configured as the exceed action. EXCEED_REDIRECT_TYPE must be one of: google-recaptcha, external-302. - --preview - If specified, the action will not be enforced. + --[no-]preview + If specified, the action will not be enforced. Use --preview to enable + and --no-preview to disable. --rate-limit-threshold-count=RATE_LIMIT_THRESHOLD_COUNT Number of HTTP(S) requests for calculating the threshold for rate diff --git a/gcloud/config/get b/gcloud/config/get index caf7db365..f63075b88 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -401,6 +401,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/config/help b/gcloud/config/help index 38816d185..514a182c4 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -433,6 +433,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/config/list b/gcloud/config/list index 8b07e2025..d7eabcc85 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -445,6 +445,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/config/set b/gcloud/config/set index 7ba991eaa..480b973d4 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -448,6 +448,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/config/unset b/gcloud/config/unset index bb7602533..c43c6230e 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -409,6 +409,7 @@ AVAILABLE PROPERTIES hypercomputecluster Overrides API endpoint for gcloud cluster-director command group. + Defaults to https://hypercomputecluster.googleapis.com/ iam Overrides API endpoint for gcloud iam command group. Defaults to diff --git a/gcloud/container/ai/profiles/benchmarks/help b/gcloud/container/ai/profiles/benchmarks/help index fc2b6497f..bc5c4c34b 100644 --- a/gcloud/container/ai/profiles/benchmarks/help +++ b/gcloud/container/ai/profiles/benchmarks/help @@ -17,4 +17,4 @@ COMMANDS COMMAND is one of the following: list - List supported model servers for a given model. + List benchmarks for a given model and model server. diff --git a/gcloud/container/ai/profiles/benchmarks/list b/gcloud/container/ai/profiles/benchmarks/list index 5ecccdb90..7b01bef75 100644 --- a/gcloud/container/ai/profiles/benchmarks/list +++ b/gcloud/container/ai/profiles/benchmarks/list @@ -1,6 +1,6 @@ NAME - gcloud container ai profiles benchmarks list - list supported model servers - for a given model + gcloud container ai profiles benchmarks list - list benchmarks for a given + model and model server SYNOPSIS gcloud container ai profiles benchmarks list --model=MODEL @@ -11,7 +11,12 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - To get supported models, run gcloud container ai profiles models list. + This command lists all benchmarking data for a given model and model + server. By default, the benchmarks are displayed in a CSV format. + + For examples of visualizing the benchmarking data, see the accompanying + Colab notebook: + https://colab.research.google.com/github/GoogleCloudPlatform/kubernetes-engine-samples/blob/main/ai-ml/notebooks/giq_visualizations.ipynb REQUIRED FLAGS --model=MODEL diff --git a/gcloud/container/ai/profiles/help b/gcloud/container/ai/profiles/help index 496f414a5..8e5e33490 100644 --- a/gcloud/container/ai/profiles/help +++ b/gcloud/container/ai/profiles/help @@ -15,6 +15,10 @@ DESCRIPTION provided as standard Kubernetes YAML manifests, which you can deploy or modify. + To visualize the benchmarking data that support these estimates, see the + accompanying Colab notebook: + https://colab.research.google.com/github/GoogleCloudPlatform/kubernetes-engine-samples/blob/main/ai-ml/notebooks/giq_visualizations.ipynb + GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/container/ai/profiles/list b/gcloud/container/ai/profiles/list index e1dd9f0f6..ddd182e43 100644 --- a/gcloud/container/ai/profiles/list +++ b/gcloud/container/ai/profiles/list @@ -17,7 +17,7 @@ DESCRIPTION This command lists all supported accelerators with their performance details. By default, the supported accelerators are displayed in a table format with select information for each accelerator. To see all details, - use --format=yaml. + use --format=yaml or --format=csvprofile. To get supported model, model servers, and model server versions, run gcloud container ai profiles models list, gcloud container ai profiles diff --git a/gcloud/container/clusters/create b/gcloud/container/clusters/create index a6bdf0eaa..7dbe452fe 100644 --- a/gcloud/container/clusters/create +++ b/gcloud/container/clusters/create @@ -48,9 +48,8 @@ SYNOPSIS [--enable-master-global-access] [--enable-multi-networking] [--enable-nested-virtualization] [--enable-network-policy] [--enable-ray-cluster-logging] [--enable-ray-cluster-monitoring] - [--enable-secret-manager] [--enable-service-externalips] - [--enable-shielded-nodes] [--enable-stackdriver-kubernetes] - [--enable-vertical-pod-autoscaling] + [--enable-service-externalips] [--enable-shielded-nodes] + [--enable-stackdriver-kubernetes] [--enable-vertical-pod-autoscaling] [--fleet-project=PROJECT_ID_OR_NUMBER] [--gateway-api=GATEWAY_API] [--hpa-profile=HPA_PROFILE] [--image-type=IMAGE_TYPE] [--in-transit-encryption=IN_TRANSIT_ENCRYPTION] @@ -133,6 +132,8 @@ SYNOPSIS --resource-usage-bigquery-dataset=RESOURCE_USAGE_BIGQUERY_DATASET] [--enable-private-endpoint --enable-private-nodes --master-ipv4-cidr=MASTER_IPV4_CIDR] + [--enable-secret-manager --enable-secret-manager-rotation + --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL] [--ephemeral-storage-local-ssd[=[count=COUNT]] | --local-nvme-ssd-block[=[count=COUNT]] | --local-ssd-count=LOCAL_SSD_COUNT] @@ -733,16 +734,6 @@ FLAGS --enable-ray-cluster-monitoring Enable automatic metrics collection for Ray clusters. - Flags for Secret Manager configuration: - - --enable-secret-manager - Enables the Secret Manager CSI driver provider component. See - https://secrets-store-csi-driver.sigs.k8s.io/introduction - https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp - - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager - --enable-service-externalips Enables use of services with externalIPs field. @@ -2239,6 +2230,22 @@ FLAGS netmask of size /28 and should be used in conjunction with the --enable-private-nodes flag. + Flags for Secret Manager configuration: + + --enable-secret-manager + Enables the Secret Manager CSI driver provider component. See + https://secrets-store-csi-driver.sigs.k8s.io/introduction + https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp + + --enable-secret-manager-rotation + Enables the rotation of secrets in the Secret Manager CSI driver + provider component. + + --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL + Set the rotation period for secrets in the Secret Manager CSI driver + provider component. If you don't specify a time interval for the + rotation, it will default to a rotation period of two minutes. + At most one of these can be specified: --ephemeral-storage-local-ssd[=[count=COUNT]] diff --git a/gcloud/container/clusters/create-auto b/gcloud/container/clusters/create-auto index b31b0afe2..fdd663369 100644 --- a/gcloud/container/clusters/create-auto +++ b/gcloud/container/clusters/create-auto @@ -26,15 +26,14 @@ SYNOPSIS [--enable-legacy-lustre-port] [--enable-lustre-csi-driver] [--enable-master-global-access] [--enable-multi-networking] [--enable-ray-cluster-logging] [--enable-ray-cluster-monitoring] - [--enable-ray-operator] [--enable-secret-manager] - [--fleet-project=PROJECT_ID_OR_NUMBER] [--hpa-profile=HPA_PROFILE] - [--labels=[KEY=VALUE,...]] [--logging=[COMPONENT,...]] - [--monitoring=[COMPONENT,...]] [--network=NETWORK] - [--private-endpoint-subnetwork=NAME] [--release-channel=CHANNEL] - [--security-group=SECURITY_GROUP] [--security-posture=SECURITY_POSTURE] - [--services-ipv4-cidr=CIDR] [--services-secondary-range-name=NAME] - [--subnetwork=SUBNETWORK] [--tier=TIER] - [--workload-policies=WORKLOAD_POLICIES] + [--enable-ray-operator] [--fleet-project=PROJECT_ID_OR_NUMBER] + [--hpa-profile=HPA_PROFILE] [--labels=[KEY=VALUE,...]] + [--logging=[COMPONENT,...]] [--monitoring=[COMPONENT,...]] + [--network=NETWORK] [--private-endpoint-subnetwork=NAME] + [--release-channel=CHANNEL] [--security-group=SECURITY_GROUP] + [--security-posture=SECURITY_POSTURE] [--services-ipv4-cidr=CIDR] + [--services-secondary-range-name=NAME] [--subnetwork=SUBNETWORK] + [--tier=TIER] [--workload-policies=WORKLOAD_POLICIES] [--workload-vulnerability-scanning=WORKLOAD_VULNERABILITY_SCANNING] [--additive-vpc-scope-dns-domain=ADDITIVE_VPC_SCOPE_DNS_DOMAIN | --disable-additive-vpc-scope] @@ -52,6 +51,8 @@ SYNOPSIS --master-authorized-networks=NETWORK,[NETWORK,...]] [--enable-private-endpoint --enable-private-nodes --master-ipv4-cidr=MASTER_IPV4_CIDR] + [--enable-secret-manager --enable-secret-manager-rotation + --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL] [--location=LOCATION | --region=REGION | --zone=ZONE, -z ZONE] [--scopes=[SCOPE,...]; default="gke-default" --service-account=SERVICE_ACCOUNT] @@ -345,16 +346,6 @@ FLAGS --enable-ray-operator Enable the Ray Operator GKE add-on. This add-on is disabled by default. - Flags for Secret Manager configuration: - - --enable-secret-manager - Enables the Secret Manager CSI driver provider component. See - https://secrets-store-csi-driver.sigs.k8s.io/introduction - https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp - - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager - --fleet-project=PROJECT_ID_OR_NUMBER Sets fleet host project for the cluster. If specified, the current cluster will be registered as a fleet membership under the fleet host @@ -681,6 +672,22 @@ FLAGS netmask of size /28 and should be used in conjunction with the --enable-private-nodes flag. + Flags for Secret Manager configuration: + + --enable-secret-manager + Enables the Secret Manager CSI driver provider component. See + https://secrets-store-csi-driver.sigs.k8s.io/introduction + https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp + + --enable-secret-manager-rotation + Enables the rotation of secrets in the Secret Manager CSI driver + provider component. + + --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL + Set the rotation period for secrets in the Secret Manager CSI driver + provider component. If you don't specify a time interval for the + rotation, it will default to a rotation period of two minutes. + At most one of these can be specified: --location=LOCATION diff --git a/gcloud/container/clusters/update b/gcloud/container/clusters/update index 2341ed319..48a4c4829 100644 --- a/gcloud/container/clusters/update +++ b/gcloud/container/clusters/update @@ -28,9 +28,9 @@ SYNOPSIS | --enable-legacy-lustre-port | --enable-multi-networking | --enable-network-policy | --enable-private-nodes | --[no-]enable-ray-cluster-logging - | --[no-]enable-ray-cluster-monitoring | --enable-secret-manager - | --enable-service-externalips | --enable-shielded-nodes - | --enable-stackdriver-kubernetes | --enable-vertical-pod-autoscaling + | --[no-]enable-ray-cluster-monitoring | --enable-service-externalips + | --enable-shielded-nodes | --enable-stackdriver-kubernetes + | --enable-vertical-pod-autoscaling | --fleet-project=PROJECT_ID_OR_NUMBER | --gateway-api=GATEWAY_API | --generate-password | --hpa-profile=HPA_PROFILE | --in-transit-encryption=IN_TRANSIT_ENCRYPTION @@ -111,6 +111,8 @@ SYNOPSIS --enable-insecure-binding-system-unauthenticated | --logging-service=LOGGING_SERVICE --monitoring-service=MONITORING_SERVICE + | --[no-]enable-secret-manager --[no-]enable-secret-manager-rotation + --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL | --password=PASSWORD --enable-basic-auth | --username=USERNAME, -u USERNAME) [--async] [--cloud-run-config=[load-balancer-type=EXTERNAL,...]] @@ -463,16 +465,6 @@ REQUIRED FLAGS --enable-ray-cluster-monitoring to enable and --no-enable-ray-cluster-monitoring to disable. - Flags for Secret Manager configuration: - - --enable-secret-manager - Enables the Secret Manager CSI driver provider component. See - https://secrets-store-csi-driver.sigs.k8s.io/introduction - https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp - - To disable in an existing cluster, explicitly set flag to - --no-enable-secret-manager - --enable-service-externalips Enables use of services with externalIPs field. @@ -1529,6 +1521,25 @@ REQUIRED FLAGS information, please read: https://cloud.google.com/kubernetes-engine/docs/how-to/configure-metrics. + Flags for Secret Manager configuration: + + --[no-]enable-secret-manager + Enables the Secret Manager CSI driver provider component. See + https://secrets-store-csi-driver.sigs.k8s.io/introduction + https://github.com/GoogleCloudPlatform/secrets-store-csi-driver-provider-gcp. + Use --enable-secret-manager to enable and + --no-enable-secret-manager to disable. + + --[no-]enable-secret-manager-rotation + Enables the rotation of secrets in the Secret Manager CSI driver + provider component. Use --enable-secret-manager-rotation to enable + and --no-enable-secret-manager-rotation to disable. + + --secret-manager-rotation-interval=SECRET_MANAGER_ROTATION_INTERVAL + Set the rotation period for secrets in the Secret Manager CSI + driver provider component. If you don't specify a time interval for + the rotation, it will default to a rotation period of two minutes. + Basic auth --password=PASSWORD diff --git a/gcloud/container/fleet/config-management/help b/gcloud/container/fleet/config-management/help index b04a05ef0..b4ed9158c 100644 --- a/gcloud/container/fleet/config-management/help +++ b/gcloud/container/fleet/config-management/help @@ -6,10 +6,17 @@ SYNOPSIS gcloud container fleet config-management COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage Config Sync using the Config Management feature. Policy Controller - users should use the separate command group: gcloud container fleet - policycontroller. Hierarchy Controller users should use - https://github.com/kubernetes-sigs/hierarchical-namespaces instead. + Manage Config Sync + (https://cloud.google.com/kubernetes-engine/config-sync/gcloud-help/manage) + using the Config Management feature. + + To manage Policy Controller, use gcloud container fleet policycontroller + instead. + + Hierarchy Controller is no longer available to install. If Hierarchy + Controller is still configured, Config Sync upgrades are blocked. To + upgrade Config Sync, disable Hierarchy Controller following + https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/migrate-hierarchy-controller. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/container/hub/config-management/help b/gcloud/container/hub/config-management/help index bde4b8c2c..85bf5c605 100644 --- a/gcloud/container/hub/config-management/help +++ b/gcloud/container/hub/config-management/help @@ -5,10 +5,17 @@ SYNOPSIS gcloud container hub config-management COMMAND [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage Config Sync using the Config Management feature. Policy Controller - users should use the separate command group: gcloud container fleet - policycontroller. Hierarchy Controller users should use - https://github.com/kubernetes-sigs/hierarchical-namespaces instead. + Manage Config Sync + (https://cloud.google.com/kubernetes-engine/config-sync/gcloud-help/manage) + using the Config Management feature. + + To manage Policy Controller, use gcloud container fleet policycontroller + instead. + + Hierarchy Controller is no longer available to install. If Hierarchy + Controller is still configured, Config Sync upgrades are blocked. To + upgrade Config Sync, disable Hierarchy Controller following + https://cloud.google.com/kubernetes-engine/enterprise/config-sync/docs/how-to/migrate-hierarchy-controller. GCLOUD WIDE FLAGS These flags are available to all commands: --help. diff --git a/gcloud/container/node-pools/update b/gcloud/container/node-pools/update index 37f26da29..0a294c64d 100644 --- a/gcloud/container/node-pools/update +++ b/gcloud/container/node-pools/update @@ -24,7 +24,13 @@ SYNOPSIS | --storage-pools=STORAGE_POOL,[...] | --system-config-from-file=PATH_TO_FILE | --tags=[TAG,...] | --windows-os-version=WINDOWS_OS_VERSION - | --workload-metadata=WORKLOAD_METADATA + | --workload-metadata=WORKLOAD_METADATA | --enable-blue-green-upgrade + --enable-surge-upgrade --max-surge-upgrade=MAX_SURGE_UPGRADE + --max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, + batch-percent=BATCH_NODE_PERCENTAGE, + batch-soak-duration=BATCH_SOAK_DURATION,...] | --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS --boot-disk-provisioned-throughput=BOOT_DISK_PROVISIONED_THROUGHPUT --disk-size=DISK_SIZE @@ -33,14 +39,7 @@ SYNOPSIS --location-policy=LOCATION_POLICY --max-nodes=MAX_NODES --min-nodes=MIN_NODES --total-max-nodes=TOTAL_MAX_NODES --total-min-nodes=TOTAL_MIN_NODES - | --enable-autorepair --enable-autoupgrade - | --enable-blue-green-upgrade --enable-surge-upgrade - --max-surge-upgrade=MAX_SURGE_UPGRADE - --max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE - --node-pool-soak-duration=NODE_POOL_SOAK_DURATION - --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT, - batch-percent=BATCH_NODE_PERCENTAGE, - batch-soak-duration=BATCH_SOAK_DURATION,...]) [--async] + | --enable-autorepair --enable-autoupgrade) [--async] [--cluster=CLUSTER] [--location=LOCATION | --region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...] @@ -666,6 +665,70 @@ REQUIRED FLAGS This feature can only be enabled if Workload Identity is enabled at the cluster level. + Upgrade settings + + --enable-blue-green-upgrade + Changes node pool upgrade strategy to blue-green upgrade. + + --enable-surge-upgrade + Changes node pool upgrade strategy to surge upgrade. + + --max-surge-upgrade=MAX_SURGE_UPGRADE + Number of extra (surge) nodes to be created on each upgrade of the + node pool. + + Specifies the number of extra (surge) nodes to be created during + this node pool's upgrades. For example, running the following + command will result in creating an extra node each time the node + pool is upgraded: + + $ gcloud container node-pools update node-pool-1 \ + --cluster=example-cluster --max-surge-upgrade=1 \ + --max-unavailable-upgrade=0 + + Must be used in conjunction with '--max-unavailable-upgrade'. + + --max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE + Number of nodes that can be unavailable at the same time on each + upgrade of the node pool. + + Specifies the number of nodes that can be unavailable at the same + time during this node pool's upgrades. For example, assume the node + pool has 5 nodes, running the following command will result in + having 3 nodes being upgraded in parallel (1 + 2), but keeping + always at least 3 (5 - 2) available each time the node pool is + upgraded: + + $ gcloud container node-pools update node-pool-1 \ + --cluster=example-cluster --max-surge-upgrade=1 \ + --max-unavailable-upgrade=2 + + Must be used in conjunction with '--max-surge-upgrade'. + + --node-pool-soak-duration=NODE_POOL_SOAK_DURATION + Time in seconds to be spent waiting during blue-green upgrade + before deleting the blue pool and completing the upgrade. + + $ gcloud container node-pools update node-pool-1 \ + --cluster=example-cluster --node-pool-soak-duration=600s + + --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] + Standard rollout policy options for blue-green upgrade. + + Batch sizes are specified by one of, batch-node-count or + batch-percent. The duration between batches is specified by + batch-soak-duration. + + $ gcloud container node-pools update node-pool-1 \ + --cluster=example-cluster \ + --standard-rollout-policy=batch-node-count=3,\ + batch-soak-duration=60s + + $ gcloud container node-pools update node-pool-1 \ + --cluster=example-cluster \ + --standard-rollout-policy=batch-percent=0.3,\ + batch-soak-duration=60s + Node config --boot-disk-provisioned-iops=BOOT_DISK_PROVISIONED_IOPS @@ -781,70 +844,6 @@ REQUIRED FLAGS https://cloud.google.com/kubernetes-engine/docs/node-auto-upgrades for more info. - Upgrade settings - - --enable-blue-green-upgrade - Changes node pool upgrade strategy to blue-green upgrade. - - --enable-surge-upgrade - Changes node pool upgrade strategy to surge upgrade. - - --max-surge-upgrade=MAX_SURGE_UPGRADE - Number of extra (surge) nodes to be created on each upgrade of the - node pool. - - Specifies the number of extra (surge) nodes to be created during - this node pool's upgrades. For example, running the following - command will result in creating an extra node each time the node - pool is upgraded: - - $ gcloud container node-pools update node-pool-1 \ - --cluster=example-cluster --max-surge-upgrade=1 \ - --max-unavailable-upgrade=0 - - Must be used in conjunction with '--max-unavailable-upgrade'. - - --max-unavailable-upgrade=MAX_UNAVAILABLE_UPGRADE - Number of nodes that can be unavailable at the same time on each - upgrade of the node pool. - - Specifies the number of nodes that can be unavailable at the same - time during this node pool's upgrades. For example, assume the node - pool has 5 nodes, running the following command will result in - having 3 nodes being upgraded in parallel (1 + 2), but keeping - always at least 3 (5 - 2) available each time the node pool is - upgraded: - - $ gcloud container node-pools update node-pool-1 \ - --cluster=example-cluster --max-surge-upgrade=1 \ - --max-unavailable-upgrade=2 - - Must be used in conjunction with '--max-surge-upgrade'. - - --node-pool-soak-duration=NODE_POOL_SOAK_DURATION - Time in seconds to be spent waiting during blue-green upgrade - before deleting the blue pool and completing the upgrade. - - $ gcloud container node-pools update node-pool-1 \ - --cluster=example-cluster --node-pool-soak-duration=600s - - --standard-rollout-policy=[batch-node-count=BATCH_NODE_COUNT,batch-percent=BATCH_NODE_PERCENTAGE,batch-soak-duration=BATCH_SOAK_DURATION,...] - Standard rollout policy options for blue-green upgrade. - - Batch sizes are specified by one of, batch-node-count or - batch-percent. The duration between batches is specified by - batch-soak-duration. - - $ gcloud container node-pools update node-pool-1 \ - --cluster=example-cluster \ - --standard-rollout-policy=batch-node-count=3,\ - batch-soak-duration=60s - - $ gcloud container node-pools update node-pool-1 \ - --cluster=example-cluster \ - --standard-rollout-policy=batch-percent=0.3,\ - batch-soak-duration=60s - OPTIONAL FLAGS --async Return immediately, without waiting for the operation in progress to diff --git a/gcloud/database-migration/conversion-workspaces/import-rules b/gcloud/database-migration/conversion-workspaces/import-rules index 31ac6eb58..4baf8be33 100644 --- a/gcloud/database-migration/conversion-workspaces/import-rules +++ b/gcloud/database-migration/conversion-workspaces/import-rules @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud database-migration conversion-workspaces import-rules (CONVERSION_WORKSPACE : --region=REGION) - --config-files=CONGIF_FILE,[CONGIF_FILE,...] [--auto-commit] + --config-files=CONFIG_FILE,[CONFIG_FILE,...] [--auto-commit] [--file-format=FILE_FORMAT; default="ORA2PG"] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -54,7 +54,7 @@ POSITIONAL ARGUMENTS ▸ provide the argument --region on the command line. REQUIRED FLAGS - --config-files=CONGIF_FILE,[CONGIF_FILE,...] + --config-files=CONFIG_FILE,[CONFIG_FILE,...] A list of files to import rules from. Either provide a single file path or if multiple files are to be provided, each file should correspond to one schema. Provide file paths as a comma separated list. diff --git a/gcloud/dataproc/clusters/update b/gcloud/dataproc/clusters/update index a06f438c4..1a6d3c8a6 100644 --- a/gcloud/dataproc/clusters/update +++ b/gcloud/dataproc/clusters/update @@ -13,6 +13,9 @@ SYNOPSIS [--delete-expiration-time=DELETE_EXPIRATION_TIME | --delete-max-age=DELETE_MAX_AGE | --no-delete-max-age] [--delete-max-idle=DELETE_MAX_IDLE | --no-delete-max-idle] + [--identity-config-file=IDENTITY_CONFIG_FILE + | --add-user-mappings=[KEY=VALUE,...] + --remove-user-mappings=[KEY,...]] [--stop-expiration-time=STOP_EXPIRATION_TIME | --stop-max-age=STOP_MAX_AGE | --no-stop-max-age] [--stop-max-idle=STOP_MAX_IDLE | --no-stop-max-idle] @@ -194,6 +197,30 @@ FLAGS Cancels the cluster auto-deletion by cluster idle duration (configured by --delete-max-idle flag) + At most one of these can be specified: + + --identity-config-file=IDENTITY_CONFIG_FILE + Path to a YAML (or JSON) file that contains the configuration for + Secure Multi-Tenancy on the cluster. The path can be a Cloud Storage + URL (example: 'gs://path/to/file') or a local filesystem path. The + mappings provided in the file will overwrite existing mappings. + + The YAML file is formatted as follows: + + # Mapping header (first line) required. + user_service_account_mapping: + bob@company.com: service-account-bob@project.iam.gserviceaccount.com + alice@company.com: service-account-alice@project.iam.gserviceaccount.com + + --add-user-mappings=[KEY=VALUE,...] + List of user-to-service-account mappings to add to current mappings. + If a mapping exists, its value is modified; otherwise, the new + mapping is added. + + --remove-user-mappings=[KEY,...] + List of user-to-service-account mappings to remove from the current + mappings. If a mapping does not exist, it is ignored. + At most one of these can be specified: --stop-expiration-time=STOP_EXPIRATION_TIME diff --git a/gcloud/firestore/indexes/composite/create b/gcloud/firestore/indexes/composite/create index 385013a5a..9d1263116 100644 --- a/gcloud/firestore/indexes/composite/create +++ b/gcloud/firestore/indexes/composite/create @@ -8,7 +8,7 @@ SYNOPSIS (--collection-group=COLLECTION_GROUP : --database=DATABASE) [--api-scope=API_SCOPE; default="any-api"] [--async] [--density=DENSITY] [--multikey] - [--query-scope=QUERY_SCOPE; default="collection"] + [--query-scope=QUERY_SCOPE; default="collection"] [--unique] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -126,6 +126,10 @@ OPTIONAL FLAGS Query scope the index applies to. QUERY_SCOPE must be one of: collection, collection-group, collection-recursive. + --unique + Optional. Whether it is an unique index. Unique index ensures all + values for the indexed field(s) are unique across documents. + 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/infra-manager/help b/gcloud/infra-manager/help index d72b0cfe9..7e0411c15 100644 --- a/gcloud/infra-manager/help +++ b/gcloud/infra-manager/help @@ -21,6 +21,12 @@ GROUPS previews Manage Preview resources. + resource-changes + Manage resource change resources. + + resource-drifts + Manage resource drift resources. + resources List or describe resources under a Revision. diff --git a/gcloud/infra-manager/resource-changes/describe b/gcloud/infra-manager/resource-changes/describe new file mode 100644 index 000000000..81efae6d1 --- /dev/null +++ b/gcloud/infra-manager/resource-changes/describe @@ -0,0 +1,71 @@ +NAME + gcloud infra-manager resource-changes describe - describe resource changes + +SYNOPSIS + gcloud infra-manager resource-changes describe + (RESOURCE_CHANGE : --location=LOCATION --preview=PREVIEW) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a resource change + +EXAMPLES + To describe a resource change rc under preview pr1 at location us-central1, + run: + + $ gcloud infra-manager resource-changes describe \ + projects/p1/locations/us-central1/previews/pr1/resourceChanges/\ + rc + +POSITIONAL ARGUMENTS + ResourceChange resource - The resource change to describe The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument resource_change 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. + + RESOURCE_CHANGE + ID of the resourceChange or fully qualified identifier for the + resourceChange. + + To set the resource_change attribute: + ▸ provide the argument resource_change on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + locations TBD + + To set the location attribute: + ▸ provide the argument resource_change on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property infra-manager/location. + + --preview=PREVIEW + preview TBD + + To set the preview attribute: + ▸ provide the argument resource_change on the command line with a + fully specified name; + ▸ provide the argument --preview on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/infrastructure-manager/docs diff --git a/gcloud/infra-manager/resource-changes/help b/gcloud/infra-manager/resource-changes/help new file mode 100644 index 000000000..2dfaa3894 --- /dev/null +++ b/gcloud/infra-manager/resource-changes/help @@ -0,0 +1,22 @@ +NAME + gcloud infra-manager resource-changes - manage resource change resources + +SYNOPSIS + gcloud infra-manager resource-changes COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage resource change resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe resource changes. + + list + List resource changes. diff --git a/gcloud/infra-manager/resource-changes/list b/gcloud/infra-manager/resource-changes/list new file mode 100644 index 000000000..b56b0347c --- /dev/null +++ b/gcloud/infra-manager/resource-changes/list @@ -0,0 +1,94 @@ +NAME + gcloud infra-manager resource-changes list - list resource changes + +SYNOPSIS + gcloud infra-manager resource-changes list + (--preview=PREVIEW : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List resource changes for a preview + +EXAMPLES + To list all resource changes for preview + projects/p1/locations/us-central1/previews/pr1, run: + + $ gcloud infra-manager resource-changes list \ + --preview=projects/p1/locations/us-central1/previews/pr1 + +REQUIRED FLAGS + Preview resource - The preview for which we want to list all resource + changes. 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 --preview 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. + + --preview=PREVIEW + ID of the preview or fully qualified identifier for the preview. + + To set the preview attribute: + ▸ provide the argument --preview on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + locations TBD + + To set the location attribute: + ▸ provide the argument --preview on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property infra-manager/location. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/infrastructure-manager/docs diff --git a/gcloud/infra-manager/resource-drifts/describe b/gcloud/infra-manager/resource-drifts/describe new file mode 100644 index 000000000..dad70ba1d --- /dev/null +++ b/gcloud/infra-manager/resource-drifts/describe @@ -0,0 +1,70 @@ +NAME + gcloud infra-manager resource-drifts describe - describe resource drifts + +SYNOPSIS + gcloud infra-manager resource-drifts describe + (RESOURCE_DRIFT : --location=LOCATION --preview=PREVIEW) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a resource drift + +EXAMPLES + To describe a resource drift rd under preview pr1 at location us-central1, + run: + + $ gcloud infra-manager resource-drifts describe \ + projects/p1/locations/us-central1/previews/pr1/resourceDrifts/rd + +POSITIONAL ARGUMENTS + ResourceDrift resource - The resource drift to describe The arguments in + this group can be used to specify the attributes of this resource. (NOTE) + Some attributes are not given arguments in this group but can be set in + other ways. + + To set the project attribute: + ◆ provide the argument resource_drift 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. + + RESOURCE_DRIFT + ID of the resourceDrift or fully qualified identifier for the + resourceDrift. + + To set the resource_drift attribute: + ▸ provide the argument resource_drift on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + locations TBD + + To set the location attribute: + ▸ provide the argument resource_drift on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property infra-manager/location. + + --preview=PREVIEW + preview TBD + + To set the preview attribute: + ▸ provide the argument resource_drift on the command line with a + fully specified name; + ▸ provide the argument --preview on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/infrastructure-manager/docs diff --git a/gcloud/infra-manager/resource-drifts/help b/gcloud/infra-manager/resource-drifts/help new file mode 100644 index 000000000..b58e973ca --- /dev/null +++ b/gcloud/infra-manager/resource-drifts/help @@ -0,0 +1,22 @@ +NAME + gcloud infra-manager resource-drifts - manage resource drift resources + +SYNOPSIS + gcloud infra-manager resource-drifts COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage resource drift resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe resource drifts. + + list + List resource drifts. diff --git a/gcloud/infra-manager/resource-drifts/list b/gcloud/infra-manager/resource-drifts/list new file mode 100644 index 000000000..c1cabc1cb --- /dev/null +++ b/gcloud/infra-manager/resource-drifts/list @@ -0,0 +1,94 @@ +NAME + gcloud infra-manager resource-drifts list - list resource drifts + +SYNOPSIS + gcloud infra-manager resource-drifts list + (--preview=PREVIEW : --location=LOCATION) [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List resource drifts for a preview + +EXAMPLES + To list all resource drifts for preview + projects/p1/locations/us-central1/previews/pr1, run: + + $ gcloud infra-manager resource-drifts list \ + --preview=projects/p1/locations/us-central1/previews/pr1 + +REQUIRED FLAGS + Preview resource - The preview for which we want to list all resource + drifts. 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 --preview 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. + + --preview=PREVIEW + ID of the preview or fully qualified identifier for the preview. + + To set the preview attribute: + ▸ provide the argument --preview on the command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + locations TBD + + To set the location attribute: + ▸ provide the argument --preview on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property infra-manager/location. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the config/v1 API. The full documentation for this API + can be found at: https://cloud.google.com/infrastructure-manager/docs diff --git a/gcloud/network-connectivity/help b/gcloud/network-connectivity/help index 83673cce2..84909f728 100644 --- a/gcloud/network-connectivity/help +++ b/gcloud/network-connectivity/help @@ -1,11 +1,11 @@ NAME - gcloud network-connectivity - manage Network Connectivity Center resources + gcloud network-connectivity - manage Network Connectivity resources SYNOPSIS gcloud network-connectivity GROUP [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Manage Network Connectivity Center resources. + Manage Network Connectivity resources. GCLOUD WIDE FLAGS These flags are available to all commands: --help. @@ -24,6 +24,12 @@ GROUPS locations Get information about supported Network Connectivity Center locations. + multicloud-data-transfer-configs + Manage Multicloud Data Transfer Config resources. + + multicloud-data-transfer-supported-services + Manage Multicloud Data Transfer Supported Service resources. + operations Manage Network Connectivity Center operations. diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/create b/gcloud/network-connectivity/multicloud-data-transfer-configs/create new file mode 100644 index 000000000..8e21a74e5 --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/create @@ -0,0 +1,155 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs create - + create a multicloudDataTransferConfig + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs create + (MULTICLOUD_DATA_TRANSFER_CONFIG : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--etag=ETAG] [--labels=[LABELS,...]] + [--request-id=REQUEST_ID] [--services=[SERVICES,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a multicloudDataTransferConfig + +EXAMPLES + To create the multicloudDataTransferConfig, run: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ create config-1 --location=europe-west1 \ + --description="Multicloud Data Transfer Config description" \ + --services=compute-engine,cloud-storage + +POSITIONAL ARGUMENTS + MulticloudDataTransferConfig resource - Identifier. The name of the + MulticloudDataTransferConfig resource. Format: + projects/{project}/locations/{location}/multicloudDataTransferConfigs/{multicloud_data_transfer_config}. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicloud_data_transfer_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. + + MULTICLOUD_DATA_TRANSFER_CONFIG + ID of the multicloudDataTransferConfig or fully qualified identifier + for the multicloudDataTransferConfig. + + To set the multicloud_data_transfer_config attribute: + ▸ provide the argument multicloud_data_transfer_config on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferConfig resource. + + To set the location attribute: + ▸ provide the argument multicloud_data_transfer_config 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. + + --description=DESCRIPTION + A description of this resource. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --labels=[LABELS,...] + User-defined labels. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. This + prevents clients from accidentally creating duplicate + MulticloudDataTransferConfig resources. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + + --services=[SERVICES,...] + Maps services to their current or planned states. Service names are + keys, and the associated values describe the state of the service. If a + state change is expected, the value is either ADDING or DELETING, + depending on the actions taken. + + Sample output: "services": { "big-query": { "states": [ { + "effectiveTime": "2024-12-12T08:00:00Z" "state": "ADDING", }, ] }, + "cloud-storage": { "states": [ { "state": "ACTIVE", } ] } }. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --services=string + + JSON Example: + + --services='{"string": {}}' + + File Example: + + --services=path_to_file.(yaml|json) + +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 networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs create + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/delete b/gcloud/network-connectivity/multicloud-data-transfer-configs/delete new file mode 100644 index 000000000..1d9b38e8d --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/delete @@ -0,0 +1,96 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs delete - + delete a multicloudDataTransferConfig + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs delete + (MULTICLOUD_DATA_TRANSFER_CONFIG : --location=LOCATION) [--async] + [--etag=ETAG] [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a multicloudDataTransferConfig + +EXAMPLES + To delete the multicloudDataTransferConfig, run: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ delete config-1 --location=europe-west1 + +POSITIONAL ARGUMENTS + MulticloudDataTransferConfig resource - The name of the + MulticloudDataTransferConfig resource to delete. The arguments in this + group can be used to specify the attributes of this resource. (NOTE) Some + attributes are not given arguments in this group but can be set in other + ways. + + To set the project attribute: + ◆ provide the argument multicloud_data_transfer_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. + + MULTICLOUD_DATA_TRANSFER_CONFIG + ID of the multicloudDataTransferConfig or fully qualified identifier + for the multicloudDataTransferConfig. + + To set the multicloud_data_transfer_config attribute: + ▸ provide the argument multicloud_data_transfer_config on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferConfig resource. + + To set the location attribute: + ▸ provide the argument multicloud_data_transfer_config 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. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. This + prevents clients from accidentally creating duplicate + MulticloudDataTransferConfig resources. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + +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 networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs delete + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/describe b/gcloud/network-connectivity/multicloud-data-transfer-configs/describe new file mode 100644 index 000000000..432b6ef80 --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/describe @@ -0,0 +1,70 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs describe - + describe a multicloudDataTransferConfig + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs describe + (MULTICLOUD_DATA_TRANSFER_CONFIG : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a multicloudDataTransferConfig + +EXAMPLES + To describe the multicloudDataTransferConfig, run: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ describe config-1 --location=europe-west1 + +POSITIONAL ARGUMENTS + MulticloudDataTransferConfig resource - The name of the + MulticloudDataTransferConfig resource to get. 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 multicloud_data_transfer_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. + + MULTICLOUD_DATA_TRANSFER_CONFIG + ID of the multicloudDataTransferConfig or fully qualified identifier + for the multicloudDataTransferConfig. + + To set the multicloud_data_transfer_config attribute: + ▸ provide the argument multicloud_data_transfer_config on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferConfig resource. + + To set the location attribute: + ▸ provide the argument multicloud_data_transfer_config on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs describe + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/create b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/create new file mode 100644 index 000000000..3643c7b13 --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/create @@ -0,0 +1,166 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs destinations + create - create a destination + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs destinations + create + (DESTINATION : --location=LOCATION + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG) + --endpoints=[asn=ASN],[csp=CSP] --ip-prefix=IP_PREFIX [--async] + [--description=DESCRIPTION] [--etag=ETAG] [--labels=[LABELS,...]] + [--request-id=REQUEST_ID] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a destination + +EXAMPLES + To create the destination, run: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ destinations create destination-1 \ + --multicloud-data-transfer-config=config-1 \ + --location=europe-west1 \ + --description="Multicloud Data Transfer destination \ + description" --ip-prefix="10.1.1.0/24" \ + --endpoints=asn=8075,csp=microsoft + +POSITIONAL ARGUMENTS + Destination resource - Identifier. The name of the Destination resource. + Format: + projects/{project}/locations/{location}/multicloudDataTransferConfigs/{multicloud_data_transfer_config}/destinations/{destination}. + 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 destination 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. + + DESTINATION + ID of the destination or fully qualified identifier for the + destination. + + To set the destination attribute: + ▸ provide the argument destination on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the destination resource. + + To set the location attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + The multicloudDataTransferConfig id of the destination resource. + + To set the multicloud-data-transfer-config attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --multicloud-data-transfer-config on the + command line. + +REQUIRED FLAGS + --endpoints=[asn=ASN],[csp=CSP] + Required, The list of DestinationEndpoint resources configured for the + IP prefix. + + asn + The ASN of the remote IP prefix. + + csp + The CSP of the remote IP prefix. + + Shorthand Example: + + --endpoints=asn=int,csp=string --endpoints=asn=int,csp=string + + JSON Example: + + --endpoints='[{"asn": int, "csp": "string"}]' + + File Example: + + --endpoints=path_to_file.(yaml|json) + + --ip-prefix=IP_PREFIX + The IP prefix that represents your workload on another CSP. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of this resource. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --labels=[LABELS,...] + User-defined labels. + + KEY + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. This + prevents clients from accidentally creating duplicate Destination + resources. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + +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 networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations create + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/delete b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/delete new file mode 100644 index 000000000..be162bd81 --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/delete @@ -0,0 +1,106 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs destinations + delete - delete a destination + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs destinations + delete + (DESTINATION : --location=LOCATION + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG) + [--async] [--etag=ETAG] [--request-id=REQUEST_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a destination + +EXAMPLES + To delete the destination, run: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ destinations delete destination-1 \ + --multicloud-data-transfer-config=config-1 \ + --location=europe-west1 + +POSITIONAL ARGUMENTS + Destination resource - The name of the Destination resource to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument destination 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. + + DESTINATION + ID of the destination or fully qualified identifier for the + destination. + + To set the destination attribute: + ▸ provide the argument destination on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the destination resource. + + To set the location attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + The multicloudDataTransferConfig id of the destination resource. + + To set the multicloud-data-transfer-config attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --multicloud-data-transfer-config on the + command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + +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 networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations delete + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/describe b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/describe new file mode 100644 index 000000000..e1f4ce23c --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/describe @@ -0,0 +1,81 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs destinations + describe - describe a destination + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs destinations + describe + (DESTINATION : --location=LOCATION + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a destination + +EXAMPLES + To describe the destination, run: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ destinations describe destination-1 \ + --multicloud-data-transfer-config=config-1 \ + --location=europe-west1 + +POSITIONAL ARGUMENTS + Destination resource - The name of the Destination resource to get. 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 destination 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. + + DESTINATION + ID of the destination or fully qualified identifier for the + destination. + + To set the destination attribute: + ▸ provide the argument destination on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the destination resource. + + To set the location attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + The multicloudDataTransferConfig id of the destination resource. + + To set the multicloud-data-transfer-config attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --multicloud-data-transfer-config on the + command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations describe + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/help b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/help new file mode 100644 index 000000000..20fd5989f --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/help @@ -0,0 +1,40 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs destinations - + manage Destination resources + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs destinations + COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Destination resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a destination. + + delete + Delete a destination. + + describe + Describe a destination. + + list + List destinations. + + update + Update a destination. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/list b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/list new file mode 100644 index 000000000..e7737ad14 --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/list @@ -0,0 +1,110 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs destinations + list - list destinations + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs destinations + list + (--multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + : --location=LOCATION) [--return-partial-success] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List destinations + +EXAMPLES + To list all destinations, run: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ destinations list --multicloud-data-transfer-config=config-1 \ + --location=europe-west1 + +REQUIRED FLAGS + MulticloudDataTransferConfig resource - The name of the parent resource. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument --multicloud-data-transfer-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. + + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + ID of the multicloudDataTransferConfig or fully qualified identifier + for the multicloudDataTransferConfig. + + To set the multicloud-data-transfer-config attribute: + ▸ provide the argument --multicloud-data-transfer-config on the + command line. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferConfig resource. + + To set the location attribute: + ▸ provide the argument --multicloud-data-transfer-config on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --return-partial-success + If true, allow partial responses for multi-regional aggregated list + requests. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations list + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/update b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/update new file mode 100644 index 000000000..2b3ae69a7 --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/destinations/update @@ -0,0 +1,264 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs destinations + update - update a destination + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs destinations + update + (DESTINATION : --location=LOCATION + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG) + [--async] [--description=DESCRIPTION] [--etag=ETAG] + [--request-id=REQUEST_ID] + [--endpoints=[asn=ASN],[csp=CSP] + | --add-endpoints=[asn=ASN],[csp=CSP] --clear-endpoints + | --remove-endpoints=[asn=ASN],[csp=CSP]] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a destination + +EXAMPLES + To update the destination, run: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ destinations update destination-1 \ + --multicloud-data-transfer-config=config-1 \ + --location=europe-west1 \ + --description="Multicloud Data Transfer destination description \ + updated" --endpoints=asn=16509,csp=aws + +POSITIONAL ARGUMENTS + Destination resource - Identifier. The name of the Destination resource. + Format: + projects/{project}/locations/{location}/multicloudDataTransferConfigs/{multicloud_data_transfer_config}/destinations/{destination}. + 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 destination 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. + + DESTINATION + ID of the destination or fully qualified identifier for the + destination. + + To set the destination attribute: + ▸ provide the argument destination on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the destination resource. + + To set the location attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --multicloud-data-transfer-config=MULTICLOUD_DATA_TRANSFER_CONFIG + The multicloudDataTransferConfig id of the destination resource. + + To set the multicloud-data-transfer-config attribute: + ▸ provide the argument destination on the command line with a fully + specified name; + ▸ provide the argument --multicloud-data-transfer-config on the + command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + A description of this resource. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + + Update endpoints. + + At most one of these can be specified: + + --endpoints=[asn=ASN],[csp=CSP] + Set endpoints to new value. The list of DestinationEndpoint resources + configured for the IP prefix. + + asn + The ASN of the remote IP prefix. + + csp + The CSP of the remote IP prefix. + + Shorthand Example: + + --endpoints=asn=int,csp=string --endpoints=asn=int,csp=string + + JSON Example: + + --endpoints='[{"asn": int, "csp": "string"}]' + + File Example: + + --endpoints=path_to_file.(yaml|json) + + --add-endpoints=[asn=ASN],[csp=CSP] + Add new value to endpoints list. The list of DestinationEndpoint + resources configured for the IP prefix. + + asn + The ASN of the remote IP prefix. + + csp + The CSP of the remote IP prefix. + + Shorthand Example: + + --add-endpoints=asn=int,csp=string --add-endpoints=asn=int,csp=string + + JSON Example: + + --add-endpoints='[{"asn": int, "csp": "string"}]' + + File Example: + + --add-endpoints=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-endpoints + Clear endpoints value and set to empty list. + + --remove-endpoints=[asn=ASN],[csp=CSP] + Remove existing value from endpoints list. The list of + DestinationEndpoint resources configured for the IP prefix. + + asn + The ASN of the remote IP prefix. + + csp + The CSP of the remote IP prefix. + + Shorthand Example: + + --remove-endpoints=asn=int,csp=string --remove-endpoints=asn=int,csp=string + + JSON Example: + + --remove-endpoints='[{"asn": int, "csp": "string"}]' + + File Example: + + --remove-endpoints=path_to_file.(yaml|json) + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. User-defined labels. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. User-defined labels. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=REMOVE_LABELS + Remove existing value from map labels. Sets remove_labels value. + + Shorthand Example: + + --remove-labels=string,string + + JSON Example: + + --remove-labels=["string"] + + File Example: + + --remove-labels=path_to_file.(yaml|json) + +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 networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs destinations update + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/help b/gcloud/network-connectivity/multicloud-data-transfer-configs/help new file mode 100644 index 000000000..afb59d63c --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/help @@ -0,0 +1,45 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs - manage + Multicloud Data Transfer Config resources + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs + GROUP | COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Multicloud Data Transfer Config resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + destinations + Manage Destination resources. + +COMMANDS + COMMAND is one of the following: + + create + Create a multicloudDataTransferConfig. + + delete + Delete a multicloudDataTransferConfig. + + describe + Describe a multicloudDataTransferConfig. + + list + List multicloudDataTransferConfigs. + + update + Update a multicloudDataTransferConfig. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity multicloud-data-transfer-configs + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/list b/gcloud/network-connectivity/multicloud-data-transfer-configs/list new file mode 100644 index 000000000..80c812028 --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/list @@ -0,0 +1,93 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs list - list + multicloudDataTransferConfigs + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs list + --location=LOCATION [--return-partial-success] [--filter=EXPRESSION] + [--limit=LIMIT] [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List multicloudDataTransferConfigs + +EXAMPLES + To list all multicloudDataTransferConfigs, run: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ list --location=europe-west1 + +REQUIRED FLAGS + Location resource - The name of the parent resource. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +FLAGS + --return-partial-success + If true, allows partial responses for multi-regional aggregated list + requests. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs list + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-configs/update b/gcloud/network-connectivity/multicloud-data-transfer-configs/update new file mode 100644 index 000000000..b5efabc66 --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-configs/update @@ -0,0 +1,260 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-configs update - + update a multicloudDataTransferConfig + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-configs update + (MULTICLOUD_DATA_TRANSFER_CONFIG : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--etag=ETAG] [--request-id=REQUEST_ID] + [--labels=[LABELS,...] + | --update-labels=[UPDATE_LABELS,...] --clear-labels + | --remove-labels=REMOVE_LABELS] + [--services=[SERVICES,...] + | --update-services=[UPDATE_SERVICES,...] --clear-services + | --remove-services=REMOVE_SERVICES] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a multicloudDataTransferConfig + +EXAMPLES + To update the multicloudDataTransferConfig, run: + + $ gcloud network-connectivity multicloud-data-transfer-configs \ update config-1 --location=europe-west1 \ + --description="Multicloud Data Transfer Config description \ + updated" --update-services=cloud-run + +POSITIONAL ARGUMENTS + MulticloudDataTransferConfig resource - Identifier. The name of the + MulticloudDataTransferConfig resource. Format: + projects/{project}/locations/{location}/multicloudDataTransferConfigs/{multicloud_data_transfer_config}. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicloud_data_transfer_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. + + MULTICLOUD_DATA_TRANSFER_CONFIG + ID of the multicloudDataTransferConfig or fully qualified identifier + for the multicloudDataTransferConfig. + + To set the multicloud_data_transfer_config attribute: + ▸ provide the argument multicloud_data_transfer_config on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferConfig resource. + + To set the location attribute: + ▸ provide the argument multicloud_data_transfer_config 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. + + --description=DESCRIPTION + A description of this resource. + + --etag=ETAG + The etag is computed by the server, and might be sent with update and + delete requests so that the client has an up-to-date value before + proceeding. + + --request-id=REQUEST_ID + A request ID to identify requests. Specify a unique request ID so that + if you must retry your request, the server can ignore the request if it + has already been completed. The server waits for at least 60 minutes + since the first request. + + For example, consider a situation where you make an initial request and + the request times out. If you make the request again with the same + request ID, the server can check if original operation with the same + request ID was received, and if so, can ignore the second request. This + prevents clients from accidentally creating duplicate + MulticloudDataTransferConfig resources. + + The request ID must be a valid UUID with the exception that zero UUID + (00000000-0000-0000-0000-000000000000) isn't supported. + + Update labels. + + At most one of these can be specified: + + --labels=[LABELS,...] + Set labels to new value. User-defined labels. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --labels=string=string + + JSON Example: + + --labels='{"string": "string"}' + + File Example: + + --labels=path_to_file.(yaml|json) + + --update-labels=[UPDATE_LABELS,...] + Update labels value or add key value pair. User-defined labels. + + KEY + Keys must start with a lowercase character and contain only + hyphens (-), underscores (_), lowercase characters, and numbers. + + VALUE + Values must contain only hyphens (-), underscores (_), lowercase + characters, and numbers. + + Shorthand Example: + + --update-labels=string=string + + JSON Example: + + --update-labels='{"string": "string"}' + + File Example: + + --update-labels=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-labels + Clear labels value and set to empty map. + + --remove-labels=REMOVE_LABELS + Remove existing value from map labels. Sets remove_labels value. + + Shorthand Example: + + --remove-labels=string,string + + JSON Example: + + --remove-labels=["string"] + + File Example: + + --remove-labels=path_to_file.(yaml|json) + + Update services. + + At most one of these can be specified: + + --services=[SERVICES,...] + Set services to new value. Maps services to their current or planned + states. Service names are keys, and the associated values describe + the state of the service. If a state change is expected, the value is + either ADDING or DELETING, depending on the actions taken. + + Sample output: "services": { "big-query": { "states": [ { + "effectiveTime": "2024-12-12T08:00:00Z" "state": "ADDING", }, ] }, + "cloud-storage": { "states": [ { "state": "ACTIVE", } ] } }. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --services=string + + JSON Example: + + --services='{"string": {}}' + + File Example: + + --services=path_to_file.(yaml|json) + + --update-services=[UPDATE_SERVICES,...] + Update services value or add key value pair. Maps services to their + current or planned states. Service names are keys, and the associated + values describe the state of the service. If a state change is + expected, the value is either ADDING or DELETING, depending on the + actions taken. + + Sample output: "services": { "big-query": { "states": [ { + "effectiveTime": "2024-12-12T08:00:00Z" "state": "ADDING", }, ] }, + "cloud-storage": { "states": [ { "state": "ACTIVE", } ] } }. + + KEY + Sets KEY value. + + VALUE + Sets VALUE value. + + Shorthand Example: + + --update-services=string + + JSON Example: + + --update-services='{"string": {}}' + + File Example: + + --update-services=path_to_file.(yaml|json) + + At most one of these can be specified: + + --clear-services + Clear services value and set to empty map. + + --remove-services=REMOVE_SERVICES + Remove existing value from map services. Sets remove_services + value. + + Shorthand Example: + + --remove-services=string,string + + JSON Example: + + --remove-services=["string"] + + File Example: + + --remove-services=path_to_file.(yaml|json) + +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 networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-configs update + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-supported-services/describe b/gcloud/network-connectivity/multicloud-data-transfer-supported-services/describe new file mode 100644 index 000000000..d28bcaba1 --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-supported-services/describe @@ -0,0 +1,72 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-supported-services + describe - describe multicloudDataTransferSupportedService + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-supported-services + describe + (MULTICLOUD_DATA_TRANSFER_SUPPORTED_SERVICE : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe multicloudDataTransferSupportedService + +EXAMPLES + To describe the multicloudDataTransferSupportedService, run: + + $ gcloud network-connectivity \ multicloud-data-transfer-supported-services describe \ + compute-engine --location=europe-west1 + +POSITIONAL ARGUMENTS + MulticloudDataTransferSupportedService resource - The name of the service. + 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 multicloud_data_transfer_supported_service 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. + + MULTICLOUD_DATA_TRANSFER_SUPPORTED_SERVICE + ID of the multicloudDataTransferSupportedService or fully qualified + identifier for the multicloudDataTransferSupportedService. + + To set the multicloud_data_transfer_supported_service attribute: + ▸ provide the argument multicloud_data_transfer_supported_service + on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location id of the multicloudDataTransferSupportedService + resource. + + To set the location attribute: + ▸ provide the argument multicloud_data_transfer_supported_service + on the command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-supported-services describe + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-supported-services/help b/gcloud/network-connectivity/multicloud-data-transfer-supported-services/help new file mode 100644 index 000000000..b0a50aacb --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-supported-services/help @@ -0,0 +1,31 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-supported-services - + manage Multicloud Data Transfer Supported Service resources + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-supported-services + COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Multicloud Data Transfer Supported Service resources. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + describe + Describe multicloudDataTransferSupportedService. + + list + List multicloudDataTransferSupportedServices. + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-supported-services + diff --git a/gcloud/network-connectivity/multicloud-data-transfer-supported-services/list b/gcloud/network-connectivity/multicloud-data-transfer-supported-services/list new file mode 100644 index 000000000..8193c75a7 --- /dev/null +++ b/gcloud/network-connectivity/multicloud-data-transfer-supported-services/list @@ -0,0 +1,89 @@ +NAME + gcloud network-connectivity multicloud-data-transfer-supported-services + list - list multicloudDataTransferSupportedServices + +SYNOPSIS + gcloud network-connectivity multicloud-data-transfer-supported-services + list --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List multicloudDataTransferSupportedServices + +EXAMPLES + To list all multicloudDataTransferSupportedServices, run: + + $ gcloud network-connectivity \ multicloud-data-transfer-supported-services list \ + --location=europe-west1 + +REQUIRED FLAGS + Location resource - The name of the parent resource. This represents a + Cloud resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkconnectivity/v1 API. The full documentation + for this API can be found at: + https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest + +NOTES + This variant is also available: + + $ gcloud beta network-connectivity \ + multicloud-data-transfer-supported-services list + diff --git a/gcloud/network-services/help b/gcloud/network-services/help index dee0a25dd..a7bac969c 100644 --- a/gcloud/network-services/help +++ b/gcloud/network-services/help @@ -30,6 +30,33 @@ GROUPS meshes Manage Network Services Meshes. + multicast-consumer-associations + Manage Network Services MulticastConsumerAssociations. + + multicast-domain-activations + Manage Network Services MulticastDomainActivations. + + multicast-domain-groups + Manage Network Services MulticastDomainGroups. + + multicast-domains + Manage Network Services MulticastDomains. + + multicast-group-consumer-activations + Manage Network Services MulticastGroupConsumerActivations. + + multicast-group-producer-activations + Manage Network Services MulticastGroupProducerActivations. + + multicast-group-range-activations + Manage Network Services MulticastGroupRangeActivations. + + multicast-group-ranges + Manage Network Services MulticastGroupRanges. + + multicast-producer-associations + Manage Network Services MulticastProducerAssociations. + operations Manage Network Services Operations. diff --git a/gcloud/network-services/multicast-consumer-associations/create b/gcloud/network-services/multicast-consumer-associations/create new file mode 100644 index 000000000..4f372fb1c --- /dev/null +++ b/gcloud/network-services/multicast-consumer-associations/create @@ -0,0 +1,101 @@ +NAME + gcloud network-services multicast-consumer-associations create - create a + multicast consumer association + +SYNOPSIS + gcloud network-services multicast-consumer-associations create + (MULTICAST_CONSUMER_ASSOCIATION : --location=LOCATION) + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + --network=NETWORK [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a multicast consumer association in the specified location of the + current project. + +EXAMPLES + Create a multicast consumer association with the name + 'my-multicast-consumer-association', multicast-domain-activation + 'path-to-mda', network 'path-to-network', and location 'zone'. + + $ gcloud network-services multicast-consumer-associations create \ + my-multicast-consumer-association \ + --multicast-domain-activation=path-to-mda \ + --network=path-to-network --location=zone + +POSITIONAL ARGUMENTS + Multicast consumer association resource - Name of the multicast consumer + association to be created. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_consumer_association 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. + + MULTICAST_CONSUMER_ASSOCIATION + ID of the multicast consumer association or fully qualified + identifier for the multicast consumer association. + + To set the multicast_consumer_association attribute: + ▸ provide the argument multicast_consumer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_consumer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + The multicast domain activation to be used. + + --network=NETWORK + The path of the multicast consumer VPC network. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast consumer association. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-consumer-associations \ + create + + $ gcloud beta network-services multicast-consumer-associations create + diff --git a/gcloud/network-services/multicast-consumer-associations/delete b/gcloud/network-services/multicast-consumer-associations/delete new file mode 100644 index 000000000..fcb08cbc4 --- /dev/null +++ b/gcloud/network-services/multicast-consumer-associations/delete @@ -0,0 +1,77 @@ +NAME + gcloud network-services multicast-consumer-associations delete - delete a + multicast consumer association + +SYNOPSIS + gcloud network-services multicast-consumer-associations delete + (MULTICAST_CONSUMER_ASSOCIATION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a multicast consumer association in the specified location of the + current project. + +EXAMPLES + To delete a multicast consumer association in the current project, run: + + $ gcloud network-services multicast-consumer-associations delete \ + my-multicast-consumer-association --location=zone + +POSITIONAL ARGUMENTS + Multicast consumer association resource - The multicast consumer + association to delete. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_consumer_association 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. + + MULTICAST_CONSUMER_ASSOCIATION + ID of the multicast consumer association or fully qualified + identifier for the multicast consumer association. + + To set the multicast_consumer_association attribute: + ▸ provide the argument multicast_consumer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_consumer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-consumer-associations \ + delete + + $ gcloud beta network-services multicast-consumer-associations delete + diff --git a/gcloud/network-services/multicast-consumer-associations/describe b/gcloud/network-services/multicast-consumer-associations/describe new file mode 100644 index 000000000..d05a4d910 --- /dev/null +++ b/gcloud/network-services/multicast-consumer-associations/describe @@ -0,0 +1,74 @@ +NAME + gcloud network-services multicast-consumer-associations describe - describe + a multicast consumer association + +SYNOPSIS + gcloud network-services multicast-consumer-associations describe + (MULTICAST_CONSUMER_ASSOCIATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a multicast consumer association in the specified location + of the current project. + +EXAMPLES + To describe details of a multicast consumer association in the current + project and location, run: + + $ gcloud network-services multicast-consumer-associations describe \ + my-multicast-consumer-association --location=zone + +POSITIONAL ARGUMENTS + Multicast consumer association resource - The multicast consumer + association to display. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_consumer_association 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. + + MULTICAST_CONSUMER_ASSOCIATION + ID of the multicast consumer association or fully qualified + identifier for the multicast consumer association. + + To set the multicast_consumer_association attribute: + ▸ provide the argument multicast_consumer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_consumer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-consumer-associations \ + describe + + $ gcloud beta network-services multicast-consumer-associations \ + describe + diff --git a/gcloud/network-services/multicast-consumer-associations/help b/gcloud/network-services/multicast-consumer-associations/help new file mode 100644 index 000000000..8316402fe --- /dev/null +++ b/gcloud/network-services/multicast-consumer-associations/help @@ -0,0 +1,38 @@ +NAME + gcloud network-services multicast-consumer-associations - manage Network + Services MulticastConsumerAssociations + +SYNOPSIS + gcloud network-services multicast-consumer-associations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services MulticastConsumerAssociations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a multicast consumer association. + + delete + Delete a multicast consumer association. + + describe + Describe a multicast consumer association. + + list + List multicast consumer associations. + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-consumer-associations + + $ gcloud beta network-services multicast-consumer-associations + diff --git a/gcloud/network-services/multicast-consumer-associations/list b/gcloud/network-services/multicast-consumer-associations/list new file mode 100644 index 000000000..9a489737d --- /dev/null +++ b/gcloud/network-services/multicast-consumer-associations/list @@ -0,0 +1,91 @@ +NAME + gcloud network-services multicast-consumer-associations list - list + multicast consumer associations + +SYNOPSIS + gcloud network-services multicast-consumer-associations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all multicast consumer associations in the specified location of the + current project. + +EXAMPLES + To list multicast consumer associations in the current project and + location, run: + + $ gcloud network-services multicast-consumer-associations list \ + --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast consumer associations to + display. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-consumer-associations list + + $ gcloud beta network-services multicast-consumer-associations list + diff --git a/gcloud/network-services/multicast-domain-activations/create b/gcloud/network-services/multicast-domain-activations/create new file mode 100644 index 000000000..80882ecc3 --- /dev/null +++ b/gcloud/network-services/multicast-domain-activations/create @@ -0,0 +1,120 @@ +NAME + gcloud network-services multicast-domain-activations create - create a + multicast domain activation + +SYNOPSIS + gcloud network-services multicast-domain-activations create + (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) + --multicast-domain=MULTICAST_DOMAIN [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--aggr-egress-pps=AGGR_EGRESS_PPS + : --aggr-ingress-pps=AGGR_INGRESS_PPS + --avg-packet-size=AVG_PACKET_SIZE + --max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS + --max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a multicast domain activation in the specified location of the + current project. + +EXAMPLES + Create a multicast domain activation with the name + 'my-multicast-domain-activation', multicast-domain 'path-to-md', and + location 'zone'. + + $ gcloud network-services multicast-domain-activations create \ + my-multicast-group-definition --multicast-domain=path-to-md \ + --location=zone + +POSITIONAL ARGUMENTS + Multicast domain activation resource - Name of the multicast group + definition to be created. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_activation 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. + + MULTICAST_DOMAIN_ACTIVATION + ID of the multicast domain activation or fully qualified identifier + for the multicast domain activation. + + To set the multicast_domain_activation attribute: + ▸ provide the argument multicast_domain_activation on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_activation on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-domain=MULTICAST_DOMAIN + The multicast domain to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast domain activation. + + --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. + + --aggr-egress-pps=AGGR_EGRESS_PPS + Aggregated egress Packet-Per-Second for all multicast groups in the + domain in this zone. + + --aggr-ingress-pps=AGGR_INGRESS_PPS + Aggregated ingress Packet-Per-Second for all multicast groups in the + domain in this zone. + + --avg-packet-size=AVG_PACKET_SIZE + Average packet size (defaults to 512 bytes). + + --max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS + Maximum ingress Packet-Per-Second for a single multicast group in this + zone. + + --max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS + Maximum number of subscribers for a single multicast group in this + zone. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-activations create + + $ gcloud beta network-services multicast-domain-activations create + diff --git a/gcloud/network-services/multicast-domain-activations/delete b/gcloud/network-services/multicast-domain-activations/delete new file mode 100644 index 000000000..7e7b7779e --- /dev/null +++ b/gcloud/network-services/multicast-domain-activations/delete @@ -0,0 +1,76 @@ +NAME + gcloud network-services multicast-domain-activations delete - delete a + multicast domain activation + +SYNOPSIS + gcloud network-services multicast-domain-activations delete + (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a multicast domain activation in the specified location of the + current project. + +EXAMPLES + To delete a multicast domain activation in the current project, run: + + $ gcloud network-services multicast-domain-activations delete \ + my-multicast-domain-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast domain activation resource - The multicast domain activation to + delete. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_activation 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. + + MULTICAST_DOMAIN_ACTIVATION + ID of the multicast domain activation or fully qualified identifier + for the multicast domain activation. + + To set the multicast_domain_activation attribute: + ▸ provide the argument multicast_domain_activation on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_activation on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-activations delete + + $ gcloud beta network-services multicast-domain-activations delete + diff --git a/gcloud/network-services/multicast-domain-activations/describe b/gcloud/network-services/multicast-domain-activations/describe new file mode 100644 index 000000000..f350cc64d --- /dev/null +++ b/gcloud/network-services/multicast-domain-activations/describe @@ -0,0 +1,72 @@ +NAME + gcloud network-services multicast-domain-activations describe - describe a + multicast domain activation + +SYNOPSIS + gcloud network-services multicast-domain-activations describe + (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a multicast domain activation in the specified location of + the current project. + +EXAMPLES + To describe details of a multicast domain activation in the current project + and location, run: + + $ gcloud network-services multicast-domain-activations describe \ + my-multicast-domain-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast domain activation resource - The multicast domain activation to + display. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_activation 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. + + MULTICAST_DOMAIN_ACTIVATION + ID of the multicast domain activation or fully qualified identifier + for the multicast domain activation. + + To set the multicast_domain_activation attribute: + ▸ provide the argument multicast_domain_activation on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_activation on the command + line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-activations describe + + $ gcloud beta network-services multicast-domain-activations describe + diff --git a/gcloud/network-services/multicast-domain-activations/help b/gcloud/network-services/multicast-domain-activations/help new file mode 100644 index 000000000..cdaec3643 --- /dev/null +++ b/gcloud/network-services/multicast-domain-activations/help @@ -0,0 +1,41 @@ +NAME + gcloud network-services multicast-domain-activations - manage Network + Services MulticastDomainActivations + +SYNOPSIS + gcloud network-services multicast-domain-activations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services MulticastDomainActivations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a multicast domain activation. + + delete + Delete a multicast domain activation. + + describe + Describe a multicast domain activation. + + list + List multicast domain activations. + + update + Update a multicast domain activation. + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-activations + + $ gcloud beta network-services multicast-domain-activations + diff --git a/gcloud/network-services/multicast-domain-activations/list b/gcloud/network-services/multicast-domain-activations/list new file mode 100644 index 000000000..749188586 --- /dev/null +++ b/gcloud/network-services/multicast-domain-activations/list @@ -0,0 +1,91 @@ +NAME + gcloud network-services multicast-domain-activations list - list multicast + domain activations + +SYNOPSIS + gcloud network-services multicast-domain-activations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all multicast domain activations in the specified location of the + current project. + +EXAMPLES + To list multicast domain activations in the current project and location, + run: + + $ gcloud network-services multicast-domain-activations list \ + --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast domains to display. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-activations list + + $ gcloud beta network-services multicast-domain-activations list + diff --git a/gcloud/network-services/multicast-domain-activations/update b/gcloud/network-services/multicast-domain-activations/update new file mode 100644 index 000000000..3464b97a9 --- /dev/null +++ b/gcloud/network-services/multicast-domain-activations/update @@ -0,0 +1,135 @@ +NAME + gcloud network-services multicast-domain-activations update - update a + multicast domain activation + +SYNOPSIS + gcloud network-services multicast-domain-activations update + (MULTICAST_DOMAIN_ACTIVATION : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--update-labels=[KEY=VALUE,...]] + [--aggr-egress-pps=AGGR_EGRESS_PPS --aggr-ingress-pps=AGGR_INGRESS_PPS + --avg-packet-size=AVG_PACKET_SIZE + --max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS + --max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a multicast domain activation in the specified location of the + current project. + +EXAMPLES + Update a multicast domain activation with the name + my-multicast-domain-activation and location zone. + + $ gcloud network-services multicast-domain-activations update \ + my-multicast-domain-activation --aggr-egress-pps=10000 \ + --max-per-group-subscribers=10 --location=zone + +POSITIONAL ARGUMENTS + Multicast domain activation resource - Name of the multicast domain + activation to be updated. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_activation 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. + + MULTICAST_DOMAIN_ACTIVATION + ID of the multicast domain activation or fully qualified identifier + for the multicast domain activation. + + To set the multicast_domain_activation attribute: + ▸ provide the argument multicast_domain_activation on the command + line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_activation 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. + + --description=DESCRIPTION + The description for the multicast domain activation. + + --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. + + --aggr-egress-pps=AGGR_EGRESS_PPS + Aggregated egress packets per second for all multicast groups in the + domain in this zone. + + --aggr-ingress-pps=AGGR_INGRESS_PPS + Aggregated ingress Packet-Per-Second for all multicast groups in the + domain in this zone. + + --avg-packet-size=AVG_PACKET_SIZE + Average packet size (defaults to 512 bytes). + + --max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS + Maximum ingress Packet-Per-Second for a single multicast group in this + zone. + + --max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS + Maximum number of subscribers for a single multicast group in this + zone. + + 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 network-services multicast-domain-activations update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud network-services multicast-domain-activations 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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-activations update + + $ gcloud beta network-services multicast-domain-activations update + diff --git a/gcloud/network-services/multicast-domain-groups/create b/gcloud/network-services/multicast-domain-groups/create new file mode 100644 index 000000000..64e190d65 --- /dev/null +++ b/gcloud/network-services/multicast-domain-groups/create @@ -0,0 +1,88 @@ +NAME + gcloud network-services multicast-domain-groups create - create a multicast + domain group + +SYNOPSIS + gcloud network-services multicast-domain-groups create + (MULTICAST_DOMAIN_GROUP : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a multicast domain group in the specified location of the current + project. + +EXAMPLES + Create a multicast domain group with the name 'my-multicast-domain-group', + and location global. + + $ gcloud network-services multicast-domain-groups create \ + my-multicast-domain-group --location=global + +POSITIONAL ARGUMENTS + Multicast domain group resource - Name of the multicast domain group to be + created. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_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. + + MULTICAST_DOMAIN_GROUP + ID of the multicast domain group or fully qualified identifier for + the multicast domain group. + + To set the multicast_domain_group attribute: + ▸ provide the argument multicast_domain_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_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. + + --description=DESCRIPTION + The description for the multicast domain group. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-groups create + + $ gcloud beta network-services multicast-domain-groups create + diff --git a/gcloud/network-services/multicast-domain-groups/delete b/gcloud/network-services/multicast-domain-groups/delete new file mode 100644 index 000000000..3cff1d6cc --- /dev/null +++ b/gcloud/network-services/multicast-domain-groups/delete @@ -0,0 +1,75 @@ +NAME + gcloud network-services multicast-domain-groups delete - delete a multicast + domain group + +SYNOPSIS + gcloud network-services multicast-domain-groups delete + (MULTICAST_DOMAIN_GROUP : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a multicast domain group in the specified location of the current + project. + +EXAMPLES + To delete a multicast domain group in the current project, run: + + $ gcloud network-services multicast-domain-groups delete \ + my-multicast-domain-group --location=global + +POSITIONAL ARGUMENTS + Multicast domain group resource - The multicast domain group to delete. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_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. + + MULTICAST_DOMAIN_GROUP + ID of the multicast domain group or fully qualified identifier for + the multicast domain group. + + To set the multicast_domain_group attribute: + ▸ provide the argument multicast_domain_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_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. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-groups delete + + $ gcloud beta network-services multicast-domain-groups delete + diff --git a/gcloud/network-services/multicast-domain-groups/describe b/gcloud/network-services/multicast-domain-groups/describe new file mode 100644 index 000000000..6dbb9650c --- /dev/null +++ b/gcloud/network-services/multicast-domain-groups/describe @@ -0,0 +1,69 @@ +NAME + gcloud network-services multicast-domain-groups describe - describe a + multicast domain group + +SYNOPSIS + gcloud network-services multicast-domain-groups describe + (MULTICAST_DOMAIN_GROUP : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a multicast domain group in the specified location of the + current project. + +EXAMPLES + To describe a multicast domain group in the current project, run: + + $ gcloud network-services multicast-domain-groups describe \ + my-multicast-domain-group --location=global + +POSITIONAL ARGUMENTS + Multicast domain group resource - The multicast domain group to display. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain_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. + + MULTICAST_DOMAIN_GROUP + ID of the multicast domain group or fully qualified identifier for + the multicast domain group. + + To set the multicast_domain_group attribute: + ▸ provide the argument multicast_domain_group on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain_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. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-groups describe + + $ gcloud beta network-services multicast-domain-groups describe + diff --git a/gcloud/network-services/multicast-domain-groups/help b/gcloud/network-services/multicast-domain-groups/help new file mode 100644 index 000000000..4c448357e --- /dev/null +++ b/gcloud/network-services/multicast-domain-groups/help @@ -0,0 +1,38 @@ +NAME + gcloud network-services multicast-domain-groups - manage Network Services + MulticastDomainGroups + +SYNOPSIS + gcloud network-services multicast-domain-groups COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services MulticastDomainGroups. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a multicast domain group. + + delete + Delete a multicast domain group. + + describe + Describe a multicast domain group. + + list + List multicast domain groups. + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-groups + + $ gcloud beta network-services multicast-domain-groups + diff --git a/gcloud/network-services/multicast-domain-groups/list b/gcloud/network-services/multicast-domain-groups/list new file mode 100644 index 000000000..092ebd854 --- /dev/null +++ b/gcloud/network-services/multicast-domain-groups/list @@ -0,0 +1,89 @@ +NAME + gcloud network-services multicast-domain-groups list - list multicast + domain groups + +SYNOPSIS + gcloud network-services multicast-domain-groups list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all multicast domain groups in the specified location of the current + project. + +EXAMPLES + To list multicast domain groups in the current project, run: + + $ gcloud network-services multicast-domain-groups list \ + --location=global + +REQUIRED FLAGS + Location resource - The location of the multicast domain groups to + display. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domain-groups list + + $ gcloud beta network-services multicast-domain-groups list + diff --git a/gcloud/network-services/multicast-domains/create b/gcloud/network-services/multicast-domains/create new file mode 100644 index 000000000..aab3517e4 --- /dev/null +++ b/gcloud/network-services/multicast-domains/create @@ -0,0 +1,118 @@ +NAME + gcloud network-services multicast-domains create - create a multicast + domain + +SYNOPSIS + gcloud network-services multicast-domains create + (MULTICAST_DOMAIN : --location=LOCATION) --admin-network=ADMIN_NETWORK + (--connection-type=CONNECTION_TYPE; + default="CONNECTION_TYPE_UNSPECIFIED" --ncc-hub=NCC_HUB) [--async] + [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--multicast-domain-group=MULTICAST_DOMAIN_GROUP] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a multicast domain in the specified location of the current project. + +EXAMPLES + Create a multicast domain with the name 'my-multicast-domain', + admin-network 'path_to_admin_network', connection-type 'SAME_VPC', and + location 'global'. + + $ gcloud network-services multicast-domains create \ + my-multicast-domain --admin-network=path_to_admin_network \ + --connection-type=SAME_VPC --location=global + + Create a multicast domain with the name 'my-multicast-domain', + admin-network 'path_to_admin_network', connection-type 'NCC', ncc-hub + 'path_to_ncc_hub', and location 'global'. + + $ gcloud network-services multicast-domains create \ + my-multicast-domain --admin-network=path_to_admin_network \ + --connection-type=NCC --ncc-hub=path_to_ncc_hub \ + --location=global + +POSITIONAL ARGUMENTS + Multicast domain resource - Name of the multicast domain to be created. + The arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain 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. + + MULTICAST_DOMAIN + ID of the multicast domain or fully qualified identifier for the + multicast domain. + + To set the multicast_domain attribute: + ▸ provide the argument multicast_domain on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --admin-network=ADMIN_NETWORK + The URI of the admin network to be used. + + At least one of these must be specified: + + --connection-type=CONNECTION_TYPE; default="CONNECTION_TYPE_UNSPECIFIED" + The connection type for authorizing multicast traffic. + CONNECTION_TYPE must be one of: connection-type-unspecified, ncc, + same-vpc. + + --ncc-hub=NCC_HUB + The URI of the NCC hub to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast domain. + + --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. + + --multicast-domain-group=MULTICAST_DOMAIN_GROUP + The URI of the multicast domain group to be used. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domains create + + $ gcloud beta network-services multicast-domains create + diff --git a/gcloud/network-services/multicast-domains/delete b/gcloud/network-services/multicast-domains/delete new file mode 100644 index 000000000..4f9f24bef --- /dev/null +++ b/gcloud/network-services/multicast-domains/delete @@ -0,0 +1,74 @@ +NAME + gcloud network-services multicast-domains delete - delete a multicast + domain + +SYNOPSIS + gcloud network-services multicast-domains delete + (MULTICAST_DOMAIN : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a multicast domain in the specified location of the current project. + +EXAMPLES + To delete a multicast domain in the current project, run: + + $ gcloud network-services multicast-domains delete \ + my-multicast-domain --location=global + +POSITIONAL ARGUMENTS + Multicast domain resource - The multicast domain to delete. The arguments + in this group can be used to specify the attributes of this resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain 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. + + MULTICAST_DOMAIN + ID of the multicast domain or fully qualified identifier for the + multicast domain. + + To set the multicast_domain attribute: + ▸ provide the argument multicast_domain on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domains delete + + $ gcloud beta network-services multicast-domains delete + diff --git a/gcloud/network-services/multicast-domains/describe b/gcloud/network-services/multicast-domains/describe new file mode 100644 index 000000000..4e487bb0c --- /dev/null +++ b/gcloud/network-services/multicast-domains/describe @@ -0,0 +1,69 @@ +NAME + gcloud network-services multicast-domains describe - describe a multicast + domain + +SYNOPSIS + gcloud network-services multicast-domains describe + (MULTICAST_DOMAIN : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a multicast domain in the specified location of the current + project. + +EXAMPLES + To describe details of a multicast domain in the current project, run: + + $ gcloud network-services multicast-domains describe \ + my-multicast-domain --location=global + +POSITIONAL ARGUMENTS + Multicast domain resource - The multicast domain to display. The arguments + in this group can be used to specify the attributes of this resource. + (NOTE) Some attributes are not given arguments in this group but can be + set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_domain 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. + + MULTICAST_DOMAIN + ID of the multicast domain or fully qualified identifier for the + multicast domain. + + To set the multicast_domain attribute: + ▸ provide the argument multicast_domain on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_domain on the command line with a + fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domains describe + + $ gcloud beta network-services multicast-domains describe + diff --git a/gcloud/network-services/multicast-domains/help b/gcloud/network-services/multicast-domains/help new file mode 100644 index 000000000..3f35b05c5 --- /dev/null +++ b/gcloud/network-services/multicast-domains/help @@ -0,0 +1,37 @@ +NAME + gcloud network-services multicast-domains - manage Network Services + MulticastDomains + +SYNOPSIS + gcloud network-services multicast-domains COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services MulticastDomains. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a multicast domain. + + delete + Delete a multicast domain. + + describe + Describe a multicast domain. + + list + List multicast domains. + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domains + + $ gcloud beta network-services multicast-domains + diff --git a/gcloud/network-services/multicast-domains/list b/gcloud/network-services/multicast-domains/list new file mode 100644 index 000000000..193b59487 --- /dev/null +++ b/gcloud/network-services/multicast-domains/list @@ -0,0 +1,87 @@ +NAME + gcloud network-services multicast-domains list - list multicast domains + +SYNOPSIS + gcloud network-services multicast-domains list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all multicast domains in the specified location of the current + project. + +EXAMPLES + To list multicast domains in the current project, run: + + $ gcloud network-services multicast-domains list --location=global + +REQUIRED FLAGS + Location resource - The location of the multicast domains to display. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-domains list + + $ gcloud beta network-services multicast-domains list + diff --git a/gcloud/network-services/multicast-group-consumer-activations/create b/gcloud/network-services/multicast-group-consumer-activations/create new file mode 100644 index 000000000..d3ac02d5e --- /dev/null +++ b/gcloud/network-services/multicast-group-consumer-activations/create @@ -0,0 +1,98 @@ +NAME + gcloud network-services multicast-group-consumer-activations create - + create a multicast group consumer activation + +SYNOPSIS + gcloud network-services multicast-group-consumer-activations create + (MULTICAST_GROUP_CONSUMER_ACTIVATION : --location=LOCATION) + --multicast-consumer-association=MULTICAST_CONSUMER_ASSOCIATION + [--async] [--description=DESCRIPTION] [--[no-]enable-logging] + [--labels=[KEY=VALUE,...]] + [--multicast-group-range-activation=MULTICAST_GROUP_RANGE_ACTIVATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a multicast group consumer activation in the specified location of + the current project. + +POSITIONAL ARGUMENTS + Multicast group consumer activation resource - Name of the multicast group + consumer activation to be created. The arguments in this group can be used + to specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_consumer_activation 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. + + MULTICAST_GROUP_CONSUMER_ACTIVATION + ID of the multicast group consumer activation or fully qualified + identifier for the multicast group consumer activation. + + To set the multicast_group_consumer_activation attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-consumer-association=MULTICAST_CONSUMER_ASSOCIATION + The multicast consumer association to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast group consumer activation. + + --[no-]enable-logging + Whether to enable logging for this multicast group consumer activation. + Use --enable-logging to enable and --no-enable-logging 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. + + --multicast-group-range-activation=MULTICAST_GROUP_RANGE_ACTIVATION + The multicast group range activation to be used. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services \ + multicast-group-consumer-activations create + + $ gcloud beta network-services \ + multicast-group-consumer-activations create + diff --git a/gcloud/network-services/multicast-group-consumer-activations/delete b/gcloud/network-services/multicast-group-consumer-activations/delete new file mode 100644 index 000000000..b25b52cff --- /dev/null +++ b/gcloud/network-services/multicast-group-consumer-activations/delete @@ -0,0 +1,79 @@ +NAME + gcloud network-services multicast-group-consumer-activations delete - + delete a multicast group consumer activation + +SYNOPSIS + gcloud network-services multicast-group-consumer-activations delete + (MULTICAST_GROUP_CONSUMER_ACTIVATION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a multicast group consumer activation in the specified location of + the current project. + +EXAMPLES + To delete a multicast group consumer activation in the current project, + run: + + $ gcloud network-services multicast-group-consumer-activations \ + delete my-multicast-group-consumer-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast group consumer activation resource - The multicast group + consumer activation to delete. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_consumer_activation 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. + + MULTICAST_GROUP_CONSUMER_ACTIVATION + ID of the multicast group consumer activation or fully qualified + identifier for the multicast group consumer activation. + + To set the multicast_group_consumer_activation attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services \ + multicast-group-consumer-activations delete + + $ gcloud beta network-services \ + multicast-group-consumer-activations delete + diff --git a/gcloud/network-services/multicast-group-consumer-activations/describe b/gcloud/network-services/multicast-group-consumer-activations/describe new file mode 100644 index 000000000..09ada3e4c --- /dev/null +++ b/gcloud/network-services/multicast-group-consumer-activations/describe @@ -0,0 +1,74 @@ +NAME + gcloud network-services multicast-group-consumer-activations describe - + describe a multicast group consumer activation + +SYNOPSIS + gcloud network-services multicast-group-consumer-activations describe + (MULTICAST_GROUP_CONSUMER_ACTIVATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a multicast group consumer activation in the specified + location of the current project. + +EXAMPLES + To describe details of a multicast group consumer activation in the current + project and location, run: + + $ gcloud network-services multicast-group-consumer-activations \ + describe my-multicast-group-consumer-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast group consumer activation resource - The multicast group + consumer activation to display. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_consumer_activation 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. + + MULTICAST_GROUP_CONSUMER_ACTIVATION + ID of the multicast group consumer activation or fully qualified + identifier for the multicast group consumer activation. + + To set the multicast_group_consumer_activation attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services \ + multicast-group-consumer-activations describe + + $ gcloud beta network-services \ + multicast-group-consumer-activations describe + diff --git a/gcloud/network-services/multicast-group-consumer-activations/help b/gcloud/network-services/multicast-group-consumer-activations/help new file mode 100644 index 000000000..7a65777cb --- /dev/null +++ b/gcloud/network-services/multicast-group-consumer-activations/help @@ -0,0 +1,41 @@ +NAME + gcloud network-services multicast-group-consumer-activations - manage + Network Services MulticastGroupConsumerActivations + +SYNOPSIS + gcloud network-services multicast-group-consumer-activations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services MulticastGroupConsumerActivations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a multicast group consumer activation. + + delete + Delete a multicast group consumer activation. + + describe + Describe a multicast group consumer activation. + + list + List multicast group consumer activations. + + update + Update a multicast group consumer activation. + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-consumer-activations + + $ gcloud beta network-services multicast-group-consumer-activations + diff --git a/gcloud/network-services/multicast-group-consumer-activations/list b/gcloud/network-services/multicast-group-consumer-activations/list new file mode 100644 index 000000000..b12fc23a2 --- /dev/null +++ b/gcloud/network-services/multicast-group-consumer-activations/list @@ -0,0 +1,93 @@ +NAME + gcloud network-services multicast-group-consumer-activations list - list + multicast group consumer activations + +SYNOPSIS + gcloud network-services multicast-group-consumer-activations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all multicast group consumer activations in the specified location of + the current project. + +EXAMPLES + To list multicast group consumer activations in the current project and + location, run: + + $ gcloud network-services multicast-group-consumer-activations \ + list --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast consumer associations to + display. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services \ + multicast-group-consumer-activations list + + $ gcloud beta network-services \ + multicast-group-consumer-activations list + diff --git a/gcloud/network-services/multicast-group-consumer-activations/update b/gcloud/network-services/multicast-group-consumer-activations/update new file mode 100644 index 000000000..8307c0c90 --- /dev/null +++ b/gcloud/network-services/multicast-group-consumer-activations/update @@ -0,0 +1,119 @@ +NAME + gcloud network-services multicast-group-consumer-activations update - + update a multicast group consumer activation + +SYNOPSIS + gcloud network-services multicast-group-consumer-activations update + (MULTICAST_GROUP_CONSUMER_ACTIVATION : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--[no-]enable-logging] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a multicast group consumer activation in the specified location of + the current project. + +EXAMPLES + Update a multicast group consumer activation with the name + 'my-multicast-group-consumer-activation' and location 'zone'. + + $ gcloud network-services multicast-group-consumer-activations \ + update my-multicast-group-consumer-activation --enable-logging \ + --location=zone + +POSITIONAL ARGUMENTS + Multicast group consumer activation resource - Name of the multicast group + consumer activation to be updated. The arguments in this group can be used + to specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_consumer_activation 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. + + MULTICAST_GROUP_CONSUMER_ACTIVATION + ID of the multicast group consumer activation or fully qualified + identifier for the multicast group consumer activation. + + To set the multicast_group_consumer_activation attribute: + ▸ provide the argument multicast_group_consumer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_consumer_activation 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. + + --description=DESCRIPTION + The description for the multicast group consumer activation. + + --[no-]enable-logging + Whether to enable logging for this multicast group consumer activation. + Use --enable-logging to enable and --no-enable-logging to disable. + + --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 network-services multicast-group-consumer-activations \ + update --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud network-services multicast-group-consumer-activations \ + 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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services \ + multicast-group-consumer-activations update + + $ gcloud beta network-services \ + multicast-group-consumer-activations update + diff --git a/gcloud/network-services/multicast-group-producer-activations/create b/gcloud/network-services/multicast-group-producer-activations/create new file mode 100644 index 000000000..412c3b643 --- /dev/null +++ b/gcloud/network-services/multicast-group-producer-activations/create @@ -0,0 +1,93 @@ +NAME + gcloud network-services multicast-group-producer-activations create - + create a multicast group producer activation + +SYNOPSIS + gcloud network-services multicast-group-producer-activations create + (MULTICAST_GROUP_PRODUCER_ACTIVATION : --location=LOCATION) + --multicast-producer-association=MULTICAST_PRODUCER_ASSOCIATION + [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE,...]] + [--multicast-group-range-activation=MULTICAST_GROUP_RANGE_ACTIVATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a multicast group producer activation in the specified location of + the current project. + +POSITIONAL ARGUMENTS + Multicast group producer activation resource - Name of the multicast group + producer activation to be created. The arguments in this group can be used + to specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_producer_activation 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. + + MULTICAST_GROUP_PRODUCER_ACTIVATION + ID of the multicast group producer activation or fully qualified + identifier for the multicast group producer activation. + + To set the multicast_group_producer_activation attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-producer-association=MULTICAST_PRODUCER_ASSOCIATION + The multicast producer association to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast group producer activation. + + --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. + + --multicast-group-range-activation=MULTICAST_GROUP_RANGE_ACTIVATION + The multicast group range activation to be used. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services \ + multicast-group-producer-activations create + + $ gcloud beta network-services \ + multicast-group-producer-activations create + diff --git a/gcloud/network-services/multicast-group-producer-activations/delete b/gcloud/network-services/multicast-group-producer-activations/delete new file mode 100644 index 000000000..2259b1c17 --- /dev/null +++ b/gcloud/network-services/multicast-group-producer-activations/delete @@ -0,0 +1,79 @@ +NAME + gcloud network-services multicast-group-producer-activations delete - + delete a multicast group producer activation + +SYNOPSIS + gcloud network-services multicast-group-producer-activations delete + (MULTICAST_GROUP_PRODUCER_ACTIVATION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a multicast group producer activation in the specified location of + the current project. + +EXAMPLES + To delete a multicast group producer activation in the current project, + run: + + $ gcloud network-services multicast-group-producer-activations \ + delete my-multicast-group-producer-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast group producer activation resource - The multicast group + producer activation to delete. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_producer_activation 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. + + MULTICAST_GROUP_PRODUCER_ACTIVATION + ID of the multicast group producer activation or fully qualified + identifier for the multicast group producer activation. + + To set the multicast_group_producer_activation attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services \ + multicast-group-producer-activations delete + + $ gcloud beta network-services \ + multicast-group-producer-activations delete + diff --git a/gcloud/network-services/multicast-group-producer-activations/describe b/gcloud/network-services/multicast-group-producer-activations/describe new file mode 100644 index 000000000..116c1f851 --- /dev/null +++ b/gcloud/network-services/multicast-group-producer-activations/describe @@ -0,0 +1,74 @@ +NAME + gcloud network-services multicast-group-producer-activations describe - + describe a multicast group producer activation + +SYNOPSIS + gcloud network-services multicast-group-producer-activations describe + (MULTICAST_GROUP_PRODUCER_ACTIVATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a multicastgroup producer activation in the specified + location of the current project. + +EXAMPLES + To describe details of a multicast group producer activation in the current + project and location, run: + + $ gcloud network-services multicast-group-producer-activations \ + describe my-multicast-group-producer-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast group producer activation resource - The multicast group + producer activation to display. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_producer_activation 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. + + MULTICAST_GROUP_PRODUCER_ACTIVATION + ID of the multicast group producer activation or fully qualified + identifier for the multicast group producer activation. + + To set the multicast_group_producer_activation attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_producer_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services \ + multicast-group-producer-activations describe + + $ gcloud beta network-services \ + multicast-group-producer-activations describe + diff --git a/gcloud/network-services/multicast-group-producer-activations/help b/gcloud/network-services/multicast-group-producer-activations/help new file mode 100644 index 000000000..cdb9d28af --- /dev/null +++ b/gcloud/network-services/multicast-group-producer-activations/help @@ -0,0 +1,38 @@ +NAME + gcloud network-services multicast-group-producer-activations - manage + Network Services MulticastGroupProducerActivations + +SYNOPSIS + gcloud network-services multicast-group-producer-activations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services MulticastGroupProducerActivations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a multicast group producer activation. + + delete + Delete a multicast group producer activation. + + describe + Describe a multicast group producer activation. + + list + List multicast group producer activations. + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-producer-activations + + $ gcloud beta network-services multicast-group-producer-activations + diff --git a/gcloud/network-services/multicast-group-producer-activations/list b/gcloud/network-services/multicast-group-producer-activations/list new file mode 100644 index 000000000..5d4857f8b --- /dev/null +++ b/gcloud/network-services/multicast-group-producer-activations/list @@ -0,0 +1,93 @@ +NAME + gcloud network-services multicast-group-producer-activations list - list + multicast group producer activations + +SYNOPSIS + gcloud network-services multicast-group-producer-activations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all multicast group producer activations in the specified location of + the current project. + +EXAMPLES + To list multicast group producer activations in the current project and + location, run: + + $ gcloud network-services multicast-group-producer-activations \ + list --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast producer associations to + display. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services \ + multicast-group-producer-activations list + + $ gcloud beta network-services \ + multicast-group-producer-activations list + diff --git a/gcloud/network-services/multicast-group-range-activations/create b/gcloud/network-services/multicast-group-range-activations/create new file mode 100644 index 000000000..d6240342a --- /dev/null +++ b/gcloud/network-services/multicast-group-range-activations/create @@ -0,0 +1,106 @@ +NAME + gcloud network-services multicast-group-range-activations create - create a + multicast group range activation + +SYNOPSIS + gcloud network-services multicast-group-range-activations create + (MULTICAST_GROUP_RANGE_ACTIVATION : --location=LOCATION) + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + --multicast-group-range=MULTICAST_GROUP_RANGE [--async] + [--description=DESCRIPTION] [--[no-]enable-logging] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a multicast group range activation in the specified location of the + current project. + +EXAMPLES + Create a multicast group range activation with the name + 'my-mg-range-activation', multicast-group-range 'path-to-mgr', + multicast-domain-activation 'path-to-mda', and location 'zone'. + + $ gcloud network-services multicast-group-range-activations create \ + my-mg-range-activation --multicast-group-range=path-to-mgr \ + --multicast-domain-activation=path-to-mda --location=zone + +POSITIONAL ARGUMENTS + Multicast group range activation resource - Name of the multicast group + range activation to be created. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_range_activation 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. + + MULTICAST_GROUP_RANGE_ACTIVATION + ID of the multicast group range activation or fully qualified + identifier for the multicast group range activation. + + To set the multicast_group_range_activation attribute: + ▸ provide the argument multicast_group_range_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_range_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + The multicast domain activation to be used. + + --multicast-group-range=MULTICAST_GROUP_RANGE + The multicast group range to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast group. + + --[no-]enable-logging + Whether to enable logging for this multicast group range activation. + Use --enable-logging to enable and --no-enable-logging 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. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-range-activations \ + create + + $ gcloud beta network-services multicast-group-range-activations \ + create + diff --git a/gcloud/network-services/multicast-group-range-activations/delete b/gcloud/network-services/multicast-group-range-activations/delete new file mode 100644 index 000000000..ee0acaa15 --- /dev/null +++ b/gcloud/network-services/multicast-group-range-activations/delete @@ -0,0 +1,78 @@ +NAME + gcloud network-services multicast-group-range-activations delete - delete a + multicast group range activation + +SYNOPSIS + gcloud network-services multicast-group-range-activations delete + (MULTICAST_GROUP_RANGE_ACTIVATION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a multicast group range activation in the specified location of the + current project. + +EXAMPLES + To delete a multicast group range activation in the current project, run: + + $ gcloud network-services multicast-group-range-activations delete \ + my-mg-range-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast group range activation resource - The multicast group range + activation to delete. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_range_activation 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. + + MULTICAST_GROUP_RANGE_ACTIVATION + ID of the multicast group range activation or fully qualified + identifier for the multicast group range activation. + + To set the multicast_group_range_activation attribute: + ▸ provide the argument multicast_group_range_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_range_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-range-activations \ + delete + + $ gcloud beta network-services multicast-group-range-activations \ + delete + diff --git a/gcloud/network-services/multicast-group-range-activations/describe b/gcloud/network-services/multicast-group-range-activations/describe new file mode 100644 index 000000000..f6e9f249e --- /dev/null +++ b/gcloud/network-services/multicast-group-range-activations/describe @@ -0,0 +1,74 @@ +NAME + gcloud network-services multicast-group-range-activations describe - + describe a multicast group range activations + +SYNOPSIS + gcloud network-services multicast-group-range-activations describe + (MULTICAST_GROUP_RANGE_ACTIVATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a multicast group range activation in the specified + location of the current project. + +EXAMPLES + To describe details of a multicast group range activation in the current + project and location, run: + + $ gcloud network-services multicast-group-range-activations \ + describe my-mg-range-activation --location=zone + +POSITIONAL ARGUMENTS + Multicast group range activation resource - The multicast group range + activation to display. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_range_activation 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. + + MULTICAST_GROUP_RANGE_ACTIVATION + ID of the multicast group range activation or fully qualified + identifier for the multicast group range activation. + + To set the multicast_group_range_activation attribute: + ▸ provide the argument multicast_group_range_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_range_activation on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-range-activations \ + describe + + $ gcloud beta network-services multicast-group-range-activations \ + describe + diff --git a/gcloud/network-services/multicast-group-range-activations/help b/gcloud/network-services/multicast-group-range-activations/help new file mode 100644 index 000000000..07461f555 --- /dev/null +++ b/gcloud/network-services/multicast-group-range-activations/help @@ -0,0 +1,41 @@ +NAME + gcloud network-services multicast-group-range-activations - manage Network + Services MulticastGroupRangeActivations + +SYNOPSIS + gcloud network-services multicast-group-range-activations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services MulticastGroupRangeActivations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a multicast group range activation. + + delete + Delete a multicast group range activation. + + describe + Describe a multicast group range activations. + + list + List multicast group range activations. + + update + Update a multicast group range activation. + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-range-activations + + $ gcloud beta network-services multicast-group-range-activations + diff --git a/gcloud/network-services/multicast-group-range-activations/list b/gcloud/network-services/multicast-group-range-activations/list new file mode 100644 index 000000000..5ef1ea1b0 --- /dev/null +++ b/gcloud/network-services/multicast-group-range-activations/list @@ -0,0 +1,92 @@ +NAME + gcloud network-services multicast-group-range-activations list - list + multicast group range activations + +SYNOPSIS + gcloud network-services multicast-group-range-activations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all multicast group range activations in the specified location of the + current project. + +EXAMPLES + To list multicast group range activations in the current project and + location, run: + + $ gcloud network-services multicast-group-range-activations list \ + --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast groups to display. This + represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-range-activations \ + list + + $ gcloud beta network-services multicast-group-range-activations list + diff --git a/gcloud/network-services/multicast-group-range-activations/update b/gcloud/network-services/multicast-group-range-activations/update new file mode 100644 index 000000000..38c4949a7 --- /dev/null +++ b/gcloud/network-services/multicast-group-range-activations/update @@ -0,0 +1,119 @@ +NAME + gcloud network-services multicast-group-range-activations update - update a + multicast group range activation + +SYNOPSIS + gcloud network-services multicast-group-range-activations update + (MULTICAST_GROUP_RANGE_ACTIVATION : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--[no-]enable-logging] + [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a multicast group range activation in the specified location of the + current project. + +EXAMPLES + Update a multicast group range activation with the name + 'my-multicast-group-range-activation' and location 'zone'. + + $ gcloud network-services multicast-group-range-activations update \ + my-multicast-group-range-activation --enable-logging \ + --location=zone + +POSITIONAL ARGUMENTS + Multicast group range activation resource - Name of the multicast group + range to be updated. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_range_activation 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. + + MULTICAST_GROUP_RANGE_ACTIVATION + ID of the multicast group range activation or fully qualified + identifier for the multicast group range activation. + + To set the multicast_group_range_activation attribute: + ▸ provide the argument multicast_group_range_activation on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_range_activation 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. + + --description=DESCRIPTION + The description for the multicast group range activation. + + --[no-]enable-logging + Whether to enable logging for this multicast group range activation. + Use --enable-logging to enable and --no-enable-logging to disable. + + --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 network-services multicast-group-range-activations update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud network-services multicast-group-range-activations 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 networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-range-activations \ + update + + $ gcloud beta network-services multicast-group-range-activations \ + update + diff --git a/gcloud/network-services/multicast-group-ranges/create b/gcloud/network-services/multicast-group-ranges/create new file mode 100644 index 000000000..2a978fcc3 --- /dev/null +++ b/gcloud/network-services/multicast-group-ranges/create @@ -0,0 +1,118 @@ +NAME + gcloud network-services multicast-group-ranges create - create a multicast + group range + +SYNOPSIS + gcloud network-services multicast-group-ranges create + (MULTICAST_GROUP_RANGE : --location=LOCATION) + --multicast-domain=MULTICAST_DOMAIN + --reserved-internal-range=RESERVED_INTERNAL_RANGE [--async] + [--consumer-accept-list=[CONSUMER_ACCEPT_LIST,...]] + [--description=DESCRIPTION] [--distribution-scope=DISTRIBUTION_SCOPE] + [--[no-]enable-logging] [--labels=[KEY=VALUE,...]] + [--require-explicit-accept] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a multicast group range in the specified location of the current + project. + +EXAMPLES + Create a multicast group range with the name 'my-multicast-group-range', + reserved-internal-range 'path-to-ir', multicast-domain 'path-to-md', and + location 'global'. + + $ gcloud network-services multicast-group-ranges create \ + my-multicast-group-range --reserved-internal-range=path-to-ir \ + --multicast-domain=path-to-md --location=global + +POSITIONAL ARGUMENTS + Multicast group range resource - Name of the multicast group range to be + created. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_range 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. + + MULTICAST_GROUP_RANGE + ID of the multicast group range or fully qualified identifier for the + multicast group range. + + To set the multicast_group_range attribute: + ▸ provide the argument multicast_group_range on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_range on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-domain=MULTICAST_DOMAIN + The multicast domain to be used. + + --reserved-internal-range=RESERVED_INTERNAL_RANGE + The reserved internal range to be used. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --consumer-accept-list=[CONSUMER_ACCEPT_LIST,...] + An optional list of consumer projects that can use this multicast group + range. + + --description=DESCRIPTION + The description for the multicast group range. + + --distribution-scope=DISTRIBUTION_SCOPE + Distribution scope of this multicast group range. DISTRIBUTION_SCOPE + must be one of: distribution-scope-unspecified, intra-region, + intra-zone. + + --[no-]enable-logging + Whether to enable logging for this multicast group range. Use + --enable-logging to enable and --no-enable-logging 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. + + --require-explicit-accept + Whether an empty consumer accept list will reject all consumer + projects. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-ranges create + + $ gcloud beta network-services multicast-group-ranges create + diff --git a/gcloud/network-services/multicast-group-ranges/delete b/gcloud/network-services/multicast-group-ranges/delete new file mode 100644 index 000000000..25eb06fe4 --- /dev/null +++ b/gcloud/network-services/multicast-group-ranges/delete @@ -0,0 +1,75 @@ +NAME + gcloud network-services multicast-group-ranges delete - delete a multicast + group range + +SYNOPSIS + gcloud network-services multicast-group-ranges delete + (MULTICAST_GROUP_RANGE : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a multicast group range in the specified location of the current + project. + +EXAMPLES + To delete a multicast group range in the current project, run: + + $ gcloud network-services multicast-group-ranges delete \ + my-multicast-group-range --location=global + +POSITIONAL ARGUMENTS + Multicast group range resource - The multicast group range to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_range 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. + + MULTICAST_GROUP_RANGE + ID of the multicast group range or fully qualified identifier for the + multicast group range. + + To set the multicast_group_range attribute: + ▸ provide the argument multicast_group_range on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_range on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-ranges delete + + $ gcloud beta network-services multicast-group-ranges delete + diff --git a/gcloud/network-services/multicast-group-ranges/describe b/gcloud/network-services/multicast-group-ranges/describe new file mode 100644 index 000000000..4c6443796 --- /dev/null +++ b/gcloud/network-services/multicast-group-ranges/describe @@ -0,0 +1,69 @@ +NAME + gcloud network-services multicast-group-ranges describe - describe a + multicast group range + +SYNOPSIS + gcloud network-services multicast-group-ranges describe + (MULTICAST_GROUP_RANGE : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a multicast group range in the specified location of the + current project. + +EXAMPLES + To describe a multicast group range in the current project, run: + + $ gcloud network-services multicast-group-ranges describe \ + my-multicast-group-range --location=global + +POSITIONAL ARGUMENTS + Multicast group range resource - The multicast group range to display. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_range 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. + + MULTICAST_GROUP_RANGE + ID of the multicast group range or fully qualified identifier for the + multicast group range. + + To set the multicast_group_range attribute: + ▸ provide the argument multicast_group_range on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_range on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-ranges describe + + $ gcloud beta network-services multicast-group-ranges describe + diff --git a/gcloud/network-services/multicast-group-ranges/help b/gcloud/network-services/multicast-group-ranges/help new file mode 100644 index 000000000..6bc9660f2 --- /dev/null +++ b/gcloud/network-services/multicast-group-ranges/help @@ -0,0 +1,41 @@ +NAME + gcloud network-services multicast-group-ranges - manage Network Services + MulticastGroupRanges + +SYNOPSIS + gcloud network-services multicast-group-ranges COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services MulticastGroupRanges. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a multicast group range. + + delete + Delete a multicast group range. + + describe + Describe a multicast group range. + + list + List multicast group ranges. + + update + Update a multicast group range. + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-ranges + + $ gcloud beta network-services multicast-group-ranges + diff --git a/gcloud/network-services/multicast-group-ranges/list b/gcloud/network-services/multicast-group-ranges/list new file mode 100644 index 000000000..8c64ac2e2 --- /dev/null +++ b/gcloud/network-services/multicast-group-ranges/list @@ -0,0 +1,89 @@ +NAME + gcloud network-services multicast-group-ranges list - list multicast group + ranges + +SYNOPSIS + gcloud network-services multicast-group-ranges list --location=LOCATION + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all multicast group ranges in the specified location of the current + project. + +EXAMPLES + To list multicast group ranges in the current project, run: + + $ gcloud network-services multicast-group-ranges list \ + --location=global + +REQUIRED FLAGS + Location resource - The location of the multicast group ranges to display. + This represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-ranges list + + $ gcloud beta network-services multicast-group-ranges list + diff --git a/gcloud/network-services/multicast-group-ranges/update b/gcloud/network-services/multicast-group-ranges/update new file mode 100644 index 000000000..4d5665d96 --- /dev/null +++ b/gcloud/network-services/multicast-group-ranges/update @@ -0,0 +1,144 @@ +NAME + gcloud network-services multicast-group-ranges update - update a multicast + group range + +SYNOPSIS + gcloud network-services multicast-group-ranges update + (MULTICAST_GROUP_RANGE : --location=LOCATION) [--async] + [--description=DESCRIPTION] [--[no-]enable-logging] + [--[no-]require-explicit-accept] [--update-labels=[KEY=VALUE,...]] + [--clear-labels | --remove-labels=[KEY,...]] + [--consumer-accept-list=[CONSUMER_ACCEPT_LIST,...] + | --add-consumer-accept-list=[ADD_CONSUMER_ACCEPT_LIST,...] + --clear-consumer-accept-list + | --remove-consumer-accept-list=[REMOVE_CONSUMER_ACCEPT_LIST,...]] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Update a multicast group range in the specified location of the current + project. + +EXAMPLES + Update a multicast group range with the name 'my-multicast-group-range' and + location 'global'. + + $ gcloud network-services multicast-group-ranges update \ + my-multicast-group-range --require-explicit-accept \ + --enable-logging --location=global + +POSITIONAL ARGUMENTS + Multicast group range resource - Name of the multicast group range to be + updated. The arguments in this group can be used to specify the attributes + of this resource. (NOTE) Some attributes are not given arguments in this + group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_group_range 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. + + MULTICAST_GROUP_RANGE + ID of the multicast group range or fully qualified identifier for the + multicast group range. + + To set the multicast_group_range attribute: + ▸ provide the argument multicast_group_range on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_group_range 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. + + --description=DESCRIPTION + The description for the multicast group range. + + --[no-]enable-logging + Whether to enable logging for this multicast group range. Use + --enable-logging to enable and --no-enable-logging to disable. + + --[no-]require-explicit-accept + Whether an empty consumer accept list will reject all consumer + projects. Use --require-explicit-accept to enable and + --no-require-explicit-accept to disable. + + --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 network-services multicast-group-ranges update \ + --clear-labels + + To remove all existing labels and create two new labels, foo and baz: + + $ gcloud network-services multicast-group-ranges 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. + + Update consumer_accept_list. + + At most one of these can be specified: + + --consumer-accept-list=[CONSUMER_ACCEPT_LIST,...] + Set consumer_accept_list to new value. + + --add-consumer-accept-list=[ADD_CONSUMER_ACCEPT_LIST,...] + Add new value to consumer_accept_list list. + + At most one of these can be specified: + + --clear-consumer-accept-list + Clear consumer_accept_list value and set to empty list. + + --remove-consumer-accept-list=[REMOVE_CONSUMER_ACCEPT_LIST,...] + Remove existing value from consumer_accept_list list. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-group-ranges update + + $ gcloud beta network-services multicast-group-ranges update + diff --git a/gcloud/network-services/multicast-producer-associations/create b/gcloud/network-services/multicast-producer-associations/create new file mode 100644 index 000000000..1025a7179 --- /dev/null +++ b/gcloud/network-services/multicast-producer-associations/create @@ -0,0 +1,101 @@ +NAME + gcloud network-services multicast-producer-associations create - create a + multicast producer association + +SYNOPSIS + gcloud network-services multicast-producer-associations create + (MULTICAST_PRODUCER_ASSOCIATION : --location=LOCATION) + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + --network=NETWORK [--async] [--description=DESCRIPTION] + [--labels=[KEY=VALUE,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a multicast producer association in the specified location of the + current project. + +EXAMPLES + Create a multicast producer association with the name + 'my-multicast-producer-association', multicast-domain-activation + 'path-to-mda', network 'path-to-network', and location 'zone'. + + $ gcloud network-services multicast-producer-associations create \ + my-multicast-producer-association \ + --multicast-domain-activation=path-to-mda \ + --network=path-to-network --location=zone + +POSITIONAL ARGUMENTS + Multicast producer association resource - Name of the multicast producer + association to be created. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_producer_association 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. + + MULTICAST_PRODUCER_ASSOCIATION + ID of the multicast producer association or fully qualified + identifier for the multicast producer association. + + To set the multicast_producer_association attribute: + ▸ provide the argument multicast_producer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_producer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +REQUIRED FLAGS + --multicast-domain-activation=MULTICAST_DOMAIN_ACTIVATION + The multicast domain activation to be used. + + --network=NETWORK + The path of the multicast producer VPC network. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --description=DESCRIPTION + The description for the multicast producer association. + + --labels=[KEY=VALUE,...] + List of label KEY=VALUE pairs to add. + + Keys must start with a lowercase character and contain only hyphens + (-), underscores (_), lowercase characters, and numbers. Values must + contain only hyphens (-), underscores (_), lowercase characters, and + numbers. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-producer-associations \ + create + + $ gcloud beta network-services multicast-producer-associations create + diff --git a/gcloud/network-services/multicast-producer-associations/delete b/gcloud/network-services/multicast-producer-associations/delete new file mode 100644 index 000000000..f5cc4d06f --- /dev/null +++ b/gcloud/network-services/multicast-producer-associations/delete @@ -0,0 +1,77 @@ +NAME + gcloud network-services multicast-producer-associations delete - delete a + multicast producer association + +SYNOPSIS + gcloud network-services multicast-producer-associations delete + (MULTICAST_PRODUCER_ASSOCIATION : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a multicast producer association in the specified location of the + current project. + +EXAMPLES + To delete a multicast producer association in the current project, run: + + $ gcloud network-services multicast-producer-associations delete \ + my-multicast-producer-association --location=zone + +POSITIONAL ARGUMENTS + Multicast producer association resource - The multicast producer + association to delete. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_producer_association 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. + + MULTICAST_PRODUCER_ASSOCIATION + ID of the multicast producer association or fully qualified + identifier for the multicast producer association. + + To set the multicast_producer_association attribute: + ▸ provide the argument multicast_producer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_producer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-producer-associations \ + delete + + $ gcloud beta network-services multicast-producer-associations delete + diff --git a/gcloud/network-services/multicast-producer-associations/describe b/gcloud/network-services/multicast-producer-associations/describe new file mode 100644 index 000000000..d7ab7b5e9 --- /dev/null +++ b/gcloud/network-services/multicast-producer-associations/describe @@ -0,0 +1,74 @@ +NAME + gcloud network-services multicast-producer-associations describe - describe + a multicast producer associations + +SYNOPSIS + gcloud network-services multicast-producer-associations describe + (MULTICAST_PRODUCER_ASSOCIATION : --location=LOCATION) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Show details of a multicast producer association in the specified location + of the current project. + +EXAMPLES + To describe details of a multicast producer association in the current + project and location, run: + + $ gcloud network-services multicast-producer-associations describe \ + my-multicast-producer-association --location=zone + +POSITIONAL ARGUMENTS + Multicast producer association resource - The multicast producer + association to display. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument multicast_producer_association 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. + + MULTICAST_PRODUCER_ASSOCIATION + ID of the multicast producer association or fully qualified + identifier for the multicast producer association. + + To set the multicast_producer_association attribute: + ▸ provide the argument multicast_producer_association on the + command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + The location Id. + + To set the location attribute: + ▸ provide the argument multicast_producer_association on the + command line with a fully specified name; + ▸ provide the argument --location on the command line. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-producer-associations \ + describe + + $ gcloud beta network-services multicast-producer-associations \ + describe + diff --git a/gcloud/network-services/multicast-producer-associations/help b/gcloud/network-services/multicast-producer-associations/help new file mode 100644 index 000000000..c8cc63301 --- /dev/null +++ b/gcloud/network-services/multicast-producer-associations/help @@ -0,0 +1,38 @@ +NAME + gcloud network-services multicast-producer-associations - manage Network + Services MulticastProducerAssociations + +SYNOPSIS + gcloud network-services multicast-producer-associations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Manage Network Services MulticastProducerAssociations. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + create + Create a multicast producer association. + + delete + Delete a multicast producer association. + + describe + Describe a multicast producer associations. + + list + List multicast producer associations. + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-producer-associations + + $ gcloud beta network-services multicast-producer-associations + diff --git a/gcloud/network-services/multicast-producer-associations/list b/gcloud/network-services/multicast-producer-associations/list new file mode 100644 index 000000000..90931b603 --- /dev/null +++ b/gcloud/network-services/multicast-producer-associations/list @@ -0,0 +1,91 @@ +NAME + gcloud network-services multicast-producer-associations list - list + multicast producer associations + +SYNOPSIS + gcloud network-services multicast-producer-associations list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List all multicast producer associations in the specified location of the + current project. + +EXAMPLES + To list multicast producer associations in the current project and + location, run: + + $ gcloud network-services multicast-producer-associations list \ + --location=zone + +REQUIRED FLAGS + Location resource - The location of the multicast producer associations to + display. This represents a Cloud resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. + + To set the project attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ provide the argument --project on the command line; + ◆ set the property core/project. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. + + To set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networkservices/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/networking + +NOTES + These variants are also available: + + $ gcloud alpha network-services multicast-producer-associations list + + $ gcloud beta network-services multicast-producer-associations list + diff --git a/gcloud/oracle-database/cloud-exadata-infrastructures/create b/gcloud/oracle-database/cloud-exadata-infrastructures/create index 3d14a3138..19cfa3fec 100644 --- a/gcloud/oracle-database/cloud-exadata-infrastructures/create +++ b/gcloud/oracle-database/cloud-exadata-infrastructures/create @@ -82,7 +82,9 @@ FLAGS User friendly name for this resource. --gcp-oracle-zone=GCP_ORACLE_ZONE - Google Cloud Platform location where Oracle Exadata is hosted. + The GCP Oracle zone where Oracle Exadata Infrastructure is hosted. + Example: us-east4-b-r2. If not specified, the system will pick a zone + based on availability. --labels=[LABELS,...] Labels or tags associated with the resource. diff --git a/gcloud/source-manager/instances/create b/gcloud/source-manager/instances/create index e241626f6..0b1427834 100644 --- a/gcloud/source-manager/instances/create +++ b/gcloud/source-manager/instances/create @@ -5,7 +5,9 @@ NAME SYNOPSIS gcloud source-manager instances create (INSTANCE : --region=REGION) [--async] [--enable-workforce-identity-federation] [--kms-key=KMS_KEY] - [--max-wait=MAX_WAIT; default="60m"] [--is-private : --ca-pool=CA_POOL] + [--max-wait=MAX_WAIT; default="60m"] + [--is-private + : --ca-pool=CA_POOL --psc-allowed-projects=[PROJECTS,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -85,6 +87,10 @@ FLAGS --ca-pool=CA_POOL CA Pool path for private instance. + --psc-allowed-projects=[PROJECTS,...] + List of additional projects allowed to connect to the instance via + private service connect. + 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/sql/backups/restore b/gcloud/sql/backups/restore index 7b14ea19c..29bc79a5e 100644 --- a/gcloud/sql/backups/restore +++ b/gcloud/sql/backups/restore @@ -20,7 +20,8 @@ SYNOPSIS [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--edition=EDITION] [--enable-bin-log] [--enable-google-private-path] - [--enable-point-in-time-recovery] + [--enable-point-in-time-recovery] [--[no-]final-backup] + [--final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS] [--insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -214,6 +215,15 @@ OPTIONAL FLAGS fraction of a second, via write-ahead logs. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --[no-]final-backup + Enables the final backup to be taken at the time of instance deletion. + Use --final-backup to enable and --no-final-backup to disable. + + --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS + Specifies number of days to retain final backup. The valid range is + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. + --insights-config-query-insights-enabled Enable query insights feature to provide query and query plan analytics. diff --git a/gcloud/sql/instances/create b/gcloud/sql/instances/create index e3342db53..e2f40486e 100644 --- a/gcloud/sql/instances/create +++ b/gcloud/sql/instances/create @@ -12,19 +12,24 @@ SYNOPSIS [--availability-type=AVAILABILITY_TYPE] [--no-backup] [--backup-location=BACKUP_LOCATION] [--backup-start-time=BACKUP_START_TIME] [--cascadable-replica] - [--collation=COLLATION] [--connector-enforcement=CONNECTOR_ENFORCEMENT] - [--cpu=CPU] [--custom-subject-alternative-names=DNS,[DNS,[DNS]]] + [--collation=COLLATION] + [--connection-pool-flags=FLAG=VALUE,[FLAG=VALUE,...]] + [--connector-enforcement=CONNECTOR_ENFORCEMENT] [--cpu=CPU] + [--custom-subject-alternative-names=DNS,[DNS,[DNS]]] [--database-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--database-version=DATABASE_VERSION; default="MYSQL_8_0"] [--[no-]deletion-protection] [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] - [--edition=EDITION] [--enable-bin-log] [--[no-]enable-data-cache] + [--edition=EDITION] [--enable-bin-log] + [--[no-]enable-connection-pooling] [--[no-]enable-data-cache] [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] - [--failover-replica-name=FAILOVER_REPLICA_NAME] + [--enforce-new-sql-network-architecture] + [--failover-replica-name=FAILOVER_REPLICA_NAME] [--[no-]final-backup] + [--final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS] [--[no-]insights-config-query-insights-enabled] [--insights-config-query-plans-per-minute=INSIGHTS_CONFIG_QUERY_PLANS_PER_MINUTE] [--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH] @@ -171,6 +176,16 @@ FLAGS Cloud SQL server-level collation setting, which specifies the set of rules for comparing characters in a character set. + --connection-pool-flags=FLAG=VALUE,[FLAG=VALUE,...] + Comma-separated list of connection pool flags to set on the instance + connection pool. Use an equals sign to separate flag name and value. + More information on available flags can be found here: + https://cloud.google.com/sql/docs/mysql/managed-connection-pooling#configuration-options + for MySQL and + https://cloud.google.com/sql/docs/postgres/managed-connection-pooling#configuration-options + for PostgreSQL. (e.g., --connection-pool-flags + max_pool_size=1000,max_client_connections=20) + --connector-enforcement=CONNECTOR_ENFORCEMENT Cloud SQL Connector enforcement mode. It determines how Cloud SQL Connectors are used in the connection. See the list of modes here @@ -248,6 +263,11 @@ FLAGS fraction of a second. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --[no-]enable-connection-pooling + Enable connection pooling for the instance. Use + --enable-connection-pooling to enable and + --no-enable-connection-pooling to disable. + --[no-]enable-data-cache Enable use of data cache for accelerated read performance. This flag is only available for Enterprise_Plus edition instances. Use @@ -281,9 +301,21 @@ FLAGS fraction of a second, via write-ahead logs. Must have automatic backups enabled to use. Make sure storage can support at least 7 days of logs. + --enforce-new-sql-network-architecture + Force the instance to use the new network architecture. + --failover-replica-name=FAILOVER_REPLICA_NAME Also create a failover replica with the specified name. + --[no-]final-backup + Enables the final backup to be taken at the time of instance deletion. + Use --final-backup to enable and --no-final-backup to disable. + + --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS + Specifies number of days to retain final backup. The valid range is + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. + --[no-]insights-config-query-insights-enabled Enable query insights feature to provide query and query plan analytics. diff --git a/gcloud/sql/instances/help b/gcloud/sql/instances/help index 84dd39f4d..54b53f231 100644 --- a/gcloud/sql/instances/help +++ b/gcloud/sql/instances/help @@ -61,7 +61,7 @@ COMMANDS Releases a SQL Server Reporting Services lease on a Cloud SQL instance. reset-ssl-config - Deletes all client certificates and generates a new server certificate. + Reset SSL materials according to the reset SSL mode. restart Restarts a Cloud SQL instance. diff --git a/gcloud/sql/instances/patch b/gcloud/sql/instances/patch index 62f166c79..5b6b8d7bf 100644 --- a/gcloud/sql/instances/patch +++ b/gcloud/sql/instances/patch @@ -14,14 +14,18 @@ SYNOPSIS [--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE] [--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE] [--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME] [--diff] - [--edition=EDITION] [--[no-]enable-bin-log] [--[no-]enable-data-cache] + [--edition=EDITION] [--[no-]enable-bin-log] + [--[no-]enable-connection-pooling] [--[no-]enable-data-cache] [--[no-]enable-database-replication] [--[no-]enable-dataplex-integration] [--[no-]enable-google-ml-integration] [--[no-]enable-google-private-path] [--enable-password-policy] [--enable-point-in-time-recovery] [--[no-]enable-private-service-connect] + [--enforce-new-sql-network-architecture] [--failover-dr-replica-name=FAILOVER_DR_REPLICA_NAME] + [--[no-]final-backup] + [--final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS] [--follow-gae-app=FOLLOW_GAE_APP] [--[no-]include-replicas-for-major-version-upgrade] [--[no-]insights-config-query-insights-enabled] @@ -57,6 +61,8 @@ SYNOPSIS [--authorized-gae-apps=APP,[APP,...] | --clear-gae-apps] [--authorized-networks=NETWORK,[NETWORK,...] | --clear-authorized-networks] + [--clear-connection-pool-flags + | --connection-pool-flags=FLAG=VALUE,[FLAG=VALUE,...]] [--clear-custom-subject-alternative-names | --custom-subject-alternative-names=DNS,[DNS,[DNS]]] [--clear-database-flags | --database-flags=FLAG=VALUE,[FLAG=VALUE,...]] @@ -194,6 +200,11 @@ FLAGS sure storage can support at least 7 days of logs. Use --enable-bin-log to enable and --no-enable-bin-log to disable. + --[no-]enable-connection-pooling + Enable connection pooling for the instance. Use + --enable-connection-pooling to enable and + --no-enable-connection-pooling to disable. + --[no-]enable-data-cache Enable use of data cache for accelerated read performance. This flag is only available for Enterprise_Plus edition instances. Use @@ -239,12 +250,24 @@ FLAGS Connect. Use --enable-private-service-connect to enable and --no-enable-private-service-connect to disable. + --enforce-new-sql-network-architecture + Force the instance to use the new network architecture. + --failover-dr-replica-name=FAILOVER_DR_REPLICA_NAME Set a Disaster Recovery (DR) replica with the specified name for the primary instance. This must be one of the existing cross region replicas of the primary instance. Flag is only available for MySQL and PostgreSQL database instances. + --[no-]final-backup + Enables the final backup to be taken at the time of instance deletion. + Use --final-backup to enable and --no-final-backup to disable. + + --final-backup-retention-days=FINAL_BACKUP_RETENTION_DAYS + Specifies number of days to retain final backup. The valid range is + between 1 and 365. For instances managed by BackupDR, the valid range + is between 1 day and 99 years. Default value is 30 days. + --follow-gae-app=FOLLOW_GAE_APP First Generation instances only. The App Engine app this instance should follow. It must be in the same region as the instance. WARNING: @@ -512,6 +535,21 @@ FLAGS Clear the list of external networks that are allowed to connect to the instance. + At most one of these can be specified: + + --clear-connection-pool-flags + This will clear the connection pool flags set on the instance. + + --connection-pool-flags=FLAG=VALUE,[FLAG=VALUE,...] + Comma-separated list of connection pool flags to set on the instance + connection pool. Use an equals sign to separate flag name and value. + More information on available flags can be found here: + https://cloud.google.com/sql/docs/mysql/managed-connection-pooling#configuration-options + for MySQL and + https://cloud.google.com/sql/docs/postgres/managed-connection-pooling#configuration-options + for PostgreSQL. (e.g., --connection-pool-flags + max_pool_size=1000,max_client_connections=20) + At most one of these can be specified: --clear-custom-subject-alternative-names diff --git a/gcloud/sql/instances/reset-ssl-config b/gcloud/sql/instances/reset-ssl-config index 39ac05530..29a3e1e4b 100644 --- a/gcloud/sql/instances/reset-ssl-config +++ b/gcloud/sql/instances/reset-ssl-config @@ -1,13 +1,13 @@ NAME - gcloud sql instances reset-ssl-config - deletes all client certificates and - generates a new server certificate + gcloud sql instances reset-ssl-config - reset SSL materials according to + the reset SSL mode SYNOPSIS gcloud sql instances reset-ssl-config INSTANCE [--async] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Deletes all client certificates and generates a new server certificate. + Reset SSL materials according to the reset SSL mode. POSITIONAL ARGUMENTS INSTANCE diff --git a/gcloud/vmware/private-clouds/delete-now b/gcloud/vmware/private-clouds/delete-now new file mode 100644 index 000000000..b432327b8 --- /dev/null +++ b/gcloud/vmware/private-clouds/delete-now @@ -0,0 +1,70 @@ +NAME + gcloud vmware private-clouds delete-now - permanent deletion of a Google + Cloud VMware Engine private cloud currently in soft-deleted state + +SYNOPSIS + gcloud vmware private-clouds delete-now + (PRIVATE_CLOUD : --location=LOCATION) [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Permanently delete a private cloud that is currently in soft deletion. + +EXAMPLES + To permanently delete a private cloud called my-private-cloud currently in + soft-deleted state, run: + + $ gcloud vmware private-clouds delete-now my-private-cloud \ + --location=us-west2-a --project=my-project + + Or: + + $ gcloud vmware private-clouds delete-now my-private-cloud + + In the second example, the project and location are taken from gcloud + properties core/project and compute/zone. + +POSITIONAL ARGUMENTS + Private cloud resource - private_cloud. 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 private_cloud 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. + + PRIVATE_CLOUD + ID of the private cloud or fully qualified identifier for the private + cloud. + + To set the private-cloud attribute: + ▸ provide the argument private_cloud 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 private cloud or cluster. + + To set the location attribute: + ▸ provide the argument private_cloud on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ set the property compute/zone. + +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. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. diff --git a/gcloud/vmware/private-clouds/help b/gcloud/vmware/private-clouds/help index 9cf71936b..c1934f4ad 100644 --- a/gcloud/vmware/private-clouds/help +++ b/gcloud/vmware/private-clouds/help @@ -52,6 +52,10 @@ COMMANDS delete Delete a Google Cloud VMware Engine private cloud. + delete-now + Permanent deletion of a Google Cloud VMware Engine private cloud + currently in soft-deleted state. + describe Describe a Google Cloud VMware Engine private cloud.