From 32e56b8b994fc201e3735bbcbde7356bca583e91 Mon Sep 17 00:00:00 2001 From: Automated Date: Thu, 6 Apr 2023 10:23:36 +0000 Subject: [PATCH] gcloud: Thu Apr 6 10:23:36 UTC 2023 --- gcloud/_version | 8 +- .../cloud-bindings/create | 23 +++- .../cloud-bindings/list | 6 +- .../cloud-bindings/update | 34 +++-- gcloud/ai-platform/jobs/submit/training | 6 +- gcloud/ai/endpoints/create | 5 + gcloud/ai/endpoints/update | 5 + .../cloud-bindings/create | 19 ++- .../cloud-bindings/list | 2 +- .../cloud-bindings/update | 17 ++- gcloud/alpha/ai-platform/jobs/submit/training | 6 +- gcloud/alpha/ai/endpoints/create | 5 + gcloud/alpha/ai/endpoints/update | 5 + .../alpha/beyondcorp/app/connections/create | 11 +- .../alpha/beyondcorp/app/connections/delete | 6 +- .../alpha/beyondcorp/app/connections/describe | 4 +- .../alpha/beyondcorp/app/connections/update | 6 +- gcloud/alpha/beyondcorp/app/connectors/create | 6 +- gcloud/alpha/beyondcorp/app/connectors/delete | 6 +- .../alpha/beyondcorp/app/connectors/describe | 6 +- gcloud/alpha/beyondcorp/app/connectors/update | 6 +- .../alpha/blockchain-node-engine/nodes/create | 120 ++++++++++++++++++ .../alpha/blockchain-node-engine/nodes/help | 3 + gcloud/alpha/builds/approve | 26 ++-- .../certificate-manager/trust-configs/delete | 10 +- .../trust-configs/describe | 4 +- .../certificate-manager/trust-configs/export | 11 +- .../certificate-manager/trust-configs/help | 4 +- .../certificate-manager/trust-configs/import | 4 +- .../certificate-manager/trust-configs/list | 4 +- gcloud/alpha/compute/backend-services/create | 27 ++++ gcloud/alpha/compute/backend-services/update | 27 ++++ gcloud/alpha/compute/forwarding-rules/create | 6 +- gcloud/alpha/compute/forwarding-rules/update | 6 +- .../instances/network-interfaces/update | 16 ++- .../compute/network-endpoint-groups/update | 59 +++++++-- .../security-policies/add-user-defined-field | 63 +++++++++ gcloud/alpha/compute/security-policies/help | 7 + .../remove-user-defined-field | 46 +++++++ .../compute/security-policies/rules/create | 49 ++++++- .../compute/security-policies/rules/update | 50 +++++++- .../compute/sole-tenancy/node-groups/help | 3 + .../node-groups/perform-maintenance | 67 ++++++++++ gcloud/alpha/compute/target-instances/help | 3 + gcloud/alpha/compute/target-instances/update | 69 ++++++++++ gcloud/alpha/compute/target-pools/help | 3 + gcloud/alpha/compute/target-pools/update | 67 ++++++++++ .../compute/tpus/queued-resources/create | 18 ++- .../compute/tpus/queued-resources/delete | 8 +- gcloud/alpha/config/get | 8 +- gcloud/alpha/config/help | 8 +- gcloud/alpha/config/list | 8 +- gcloud/alpha/config/set | 8 +- gcloud/alpha/config/unset | 8 +- .../container/bare-metal/clusters/create | 58 ++++++--- .../container/bare-metal/clusters/update | 32 +++-- .../container/bare-metal/node-pools/enroll | 76 +++++++++++ .../container/bare-metal/node-pools/help | 3 + gcloud/alpha/container/vmware/clusters/delete | 6 +- gcloud/alpha/container/vmware/clusters/update | 6 +- .../alpha/container/vmware/node-pools/create | 5 + .../alpha/container/vmware/node-pools/delete | 6 +- .../connection-profiles/create/mysql | 53 ++++---- gcloud/alpha/functions/add-iam-policy-binding | 8 +- gcloud/alpha/functions/call | 8 +- gcloud/alpha/functions/delete | 8 +- gcloud/alpha/functions/deploy | 6 +- gcloud/alpha/functions/describe | 8 +- gcloud/alpha/functions/event-types/list | 6 +- gcloud/alpha/functions/get-iam-policy | 8 +- gcloud/alpha/functions/logs/read | 8 +- gcloud/alpha/functions/regions/list | 6 +- .../alpha/functions/remove-iam-policy-binding | 8 +- gcloud/alpha/functions/set-iam-policy | 8 +- .../alpha/iam/workforce-pools/providers/help | 3 + .../iam/workforce-pools/providers/keys/create | 103 +++++++++++++++ .../iam/workforce-pools/providers/keys/delete | 93 ++++++++++++++ .../workforce-pools/providers/keys/describe | 88 +++++++++++++ .../iam/workforce-pools/providers/keys/help | 51 ++++++++ .../iam/workforce-pools/providers/keys/list | 107 ++++++++++++++++ .../providers/keys/operations/describe | 100 +++++++++++++++ .../providers/keys/operations/help | 33 +++++ .../workforce-pools/providers/keys/undelete | 93 ++++++++++++++ gcloud/alpha/iap/oauth-brands/describe | 11 +- gcloud/alpha/iap/oauth-clients/delete | 6 +- gcloud/alpha/iap/oauth-clients/describe | 8 +- gcloud/alpha/iap/oauth-clients/list | 6 +- gcloud/alpha/iap/oauth-clients/reset-secret | 13 +- gcloud/alpha/ml-engine/jobs/submit/training | 6 +- gcloud/alpha/netapp/volumes/snapshots/delete | 7 +- gcloud/alpha/network-security/help | 3 + .../tls-inspection-policies/delete | 72 +++++++++++ .../tls-inspection-policies/export | 75 +++++++++++ .../tls-inspection-policies/help | 39 ++++++ .../tls-inspection-policies/import | 80 ++++++++++++ .../tls-inspection-policies/list | 87 +++++++++++++ gcloud/alpha/scc/custom-modules/sha/test | 64 ++++------ gcloud/alpha/scc/custom-modules/sha/update | 31 ++--- gcloud/alpha/storage/buckets/update | 13 +- gcloud/alpha/workstations/configs/create | 17 ++- gcloud/beta/ai-platform/jobs/submit/training | 6 +- gcloud/beta/ai/endpoints/create | 5 + gcloud/beta/ai/endpoints/update | 5 + gcloud/beta/artifacts/docker/help | 4 + gcloud/beta/artifacts/docker/upgrade/help | 29 +++++ .../artifacts/docker/upgrade/print-iam-policy | 64 ++++++++++ gcloud/beta/beyondcorp/app/connections/create | 11 +- gcloud/beta/beyondcorp/app/connections/delete | 6 +- .../beta/beyondcorp/app/connections/describe | 4 +- gcloud/beta/beyondcorp/app/connections/update | 6 +- gcloud/beta/beyondcorp/app/connectors/create | 6 +- gcloud/beta/beyondcorp/app/connectors/delete | 6 +- .../beta/beyondcorp/app/connectors/describe | 6 +- gcloud/beta/beyondcorp/app/connectors/update | 6 +- gcloud/beta/certificate-manager/help | 3 + .../certificate-manager/trust-configs/delete | 71 +++++++++++ .../trust-configs/describe | 62 +++++++++ .../certificate-manager/trust-configs/export | 71 +++++++++++ .../certificate-manager/trust-configs/help | 40 ++++++ .../certificate-manager/trust-configs/import | 77 +++++++++++ .../certificate-manager/trust-configs/list | 84 ++++++++++++ gcloud/beta/compute/forwarding-rules/create | 6 +- gcloud/beta/compute/forwarding-rules/update | 6 +- .../compute/network-endpoint-groups/update | 21 +-- gcloud/beta/config/get | 8 +- gcloud/beta/config/help | 8 +- gcloud/beta/config/list | 8 +- gcloud/beta/config/set | 8 +- gcloud/beta/config/unset | 8 +- gcloud/beta/functions/add-iam-policy-binding | 8 +- gcloud/beta/functions/call | 8 +- gcloud/beta/functions/delete | 8 +- gcloud/beta/functions/deploy | 6 +- gcloud/beta/functions/describe | 8 +- gcloud/beta/functions/event-types/list | 6 +- gcloud/beta/functions/get-iam-policy | 8 +- gcloud/beta/functions/logs/read | 8 +- gcloud/beta/functions/regions/list | 6 +- .../beta/functions/remove-iam-policy-binding | 8 +- gcloud/beta/functions/set-iam-policy | 8 +- .../beta/iam/workforce-pools/providers/help | 3 + .../iam/workforce-pools/providers/keys/create | 101 +++++++++++++++ .../iam/workforce-pools/providers/keys/delete | 91 +++++++++++++ .../workforce-pools/providers/keys/describe | 86 +++++++++++++ .../iam/workforce-pools/providers/keys/help | 49 +++++++ .../iam/workforce-pools/providers/keys/list | 105 +++++++++++++++ .../providers/keys/operations/describe | 98 ++++++++++++++ .../providers/keys/operations/help | 31 +++++ .../workforce-pools/providers/keys/undelete | 91 +++++++++++++ gcloud/beta/iap/oauth-brands/describe | 11 +- gcloud/beta/iap/oauth-clients/delete | 6 +- gcloud/beta/iap/oauth-clients/describe | 8 +- gcloud/beta/iap/oauth-clients/list | 6 +- gcloud/beta/iap/oauth-clients/reset-secret | 13 +- gcloud/beta/ml-engine/jobs/submit/training | 6 +- gcloud/beta/network-security/help | 3 + .../tls-inspection-policies/delete | 70 ++++++++++ .../tls-inspection-policies/export | 73 +++++++++++ .../tls-inspection-policies/help | 37 ++++++ .../tls-inspection-policies/import | 78 ++++++++++++ .../tls-inspection-policies/list | 85 +++++++++++++ gcloud/beta/workstations/configs/create | 17 ++- gcloud/compute/forwarding-rules/create | 8 +- gcloud/compute/forwarding-rules/update | 6 + gcloud/compute/network-endpoint-groups/update | 21 +-- gcloud/config/get | 8 +- gcloud/config/help | 8 +- gcloud/config/list | 8 +- gcloud/config/set | 8 +- gcloud/config/unset | 8 +- .../connection-profiles/create/mysql | 60 +++++---- .../connection-profiles/create/postgresql | 59 +++++---- .../connection-profiles/update | 4 +- gcloud/functions/add-iam-policy-binding | 8 +- gcloud/functions/call | 8 +- gcloud/functions/delete | 8 +- gcloud/functions/deploy | 6 +- gcloud/functions/describe | 8 +- gcloud/functions/event-types/list | 6 +- gcloud/functions/get-iam-policy | 8 +- gcloud/functions/logs/read | 8 +- gcloud/functions/regions/list | 6 +- gcloud/functions/remove-iam-policy-binding | 8 +- gcloud/functions/set-iam-policy | 8 +- gcloud/iam/workforce-pools/providers/help | 3 + .../iam/workforce-pools/providers/keys/create | 100 +++++++++++++++ .../iam/workforce-pools/providers/keys/delete | 90 +++++++++++++ .../workforce-pools/providers/keys/describe | 85 +++++++++++++ .../iam/workforce-pools/providers/keys/help | 48 +++++++ .../iam/workforce-pools/providers/keys/list | 104 +++++++++++++++ .../providers/keys/operations/describe | 97 ++++++++++++++ .../providers/keys/operations/help | 30 +++++ .../workforce-pools/providers/keys/undelete | 90 +++++++++++++ .../workload-identity-pools/providers/help | 3 + .../providers/keys/create | 99 +++++++++++++++ .../providers/keys/delete | 89 +++++++++++++ .../providers/keys/describe | 84 ++++++++++++ .../providers/keys/help | 39 ++++++ .../providers/keys/list | 103 +++++++++++++++ .../providers/keys/operations/describe | 94 ++++++++++++++ .../providers/keys/operations/help | 22 ++++ .../providers/keys/undelete | 89 +++++++++++++ gcloud/iap/oauth-brands/describe | 11 +- gcloud/iap/oauth-clients/delete | 6 +- gcloud/iap/oauth-clients/describe | 8 +- gcloud/iap/oauth-clients/list | 6 +- gcloud/iap/oauth-clients/reset-secret | 13 +- gcloud/ml-engine/jobs/submit/training | 6 +- gcloud/storage/buckets/update | 15 +-- 209 files changed, 5396 insertions(+), 561 deletions(-) create mode 100644 gcloud/alpha/blockchain-node-engine/nodes/create create mode 100644 gcloud/alpha/compute/security-policies/add-user-defined-field create mode 100644 gcloud/alpha/compute/security-policies/remove-user-defined-field create mode 100644 gcloud/alpha/compute/sole-tenancy/node-groups/perform-maintenance create mode 100644 gcloud/alpha/compute/target-instances/update create mode 100644 gcloud/alpha/compute/target-pools/update create mode 100644 gcloud/alpha/container/bare-metal/node-pools/enroll create mode 100644 gcloud/alpha/iam/workforce-pools/providers/keys/create create mode 100644 gcloud/alpha/iam/workforce-pools/providers/keys/delete create mode 100644 gcloud/alpha/iam/workforce-pools/providers/keys/describe create mode 100644 gcloud/alpha/iam/workforce-pools/providers/keys/help create mode 100644 gcloud/alpha/iam/workforce-pools/providers/keys/list create mode 100644 gcloud/alpha/iam/workforce-pools/providers/keys/operations/describe create mode 100644 gcloud/alpha/iam/workforce-pools/providers/keys/operations/help create mode 100644 gcloud/alpha/iam/workforce-pools/providers/keys/undelete create mode 100644 gcloud/alpha/network-security/tls-inspection-policies/delete create mode 100644 gcloud/alpha/network-security/tls-inspection-policies/export create mode 100644 gcloud/alpha/network-security/tls-inspection-policies/help create mode 100644 gcloud/alpha/network-security/tls-inspection-policies/import create mode 100644 gcloud/alpha/network-security/tls-inspection-policies/list create mode 100644 gcloud/beta/artifacts/docker/upgrade/help create mode 100644 gcloud/beta/artifacts/docker/upgrade/print-iam-policy create mode 100644 gcloud/beta/certificate-manager/trust-configs/delete create mode 100644 gcloud/beta/certificate-manager/trust-configs/describe create mode 100644 gcloud/beta/certificate-manager/trust-configs/export create mode 100644 gcloud/beta/certificate-manager/trust-configs/help create mode 100644 gcloud/beta/certificate-manager/trust-configs/import create mode 100644 gcloud/beta/certificate-manager/trust-configs/list create mode 100644 gcloud/beta/iam/workforce-pools/providers/keys/create create mode 100644 gcloud/beta/iam/workforce-pools/providers/keys/delete create mode 100644 gcloud/beta/iam/workforce-pools/providers/keys/describe create mode 100644 gcloud/beta/iam/workforce-pools/providers/keys/help create mode 100644 gcloud/beta/iam/workforce-pools/providers/keys/list create mode 100644 gcloud/beta/iam/workforce-pools/providers/keys/operations/describe create mode 100644 gcloud/beta/iam/workforce-pools/providers/keys/operations/help create mode 100644 gcloud/beta/iam/workforce-pools/providers/keys/undelete create mode 100644 gcloud/beta/network-security/tls-inspection-policies/delete create mode 100644 gcloud/beta/network-security/tls-inspection-policies/export create mode 100644 gcloud/beta/network-security/tls-inspection-policies/help create mode 100644 gcloud/beta/network-security/tls-inspection-policies/import create mode 100644 gcloud/beta/network-security/tls-inspection-policies/list create mode 100644 gcloud/iam/workforce-pools/providers/keys/create create mode 100644 gcloud/iam/workforce-pools/providers/keys/delete create mode 100644 gcloud/iam/workforce-pools/providers/keys/describe create mode 100644 gcloud/iam/workforce-pools/providers/keys/help create mode 100644 gcloud/iam/workforce-pools/providers/keys/list create mode 100644 gcloud/iam/workforce-pools/providers/keys/operations/describe create mode 100644 gcloud/iam/workforce-pools/providers/keys/operations/help create mode 100644 gcloud/iam/workforce-pools/providers/keys/undelete create mode 100644 gcloud/iam/workload-identity-pools/providers/keys/create create mode 100644 gcloud/iam/workload-identity-pools/providers/keys/delete create mode 100644 gcloud/iam/workload-identity-pools/providers/keys/describe create mode 100644 gcloud/iam/workload-identity-pools/providers/keys/help create mode 100644 gcloud/iam/workload-identity-pools/providers/keys/list create mode 100644 gcloud/iam/workload-identity-pools/providers/keys/operations/describe create mode 100644 gcloud/iam/workload-identity-pools/providers/keys/operations/help create mode 100644 gcloud/iam/workload-identity-pools/providers/keys/undelete diff --git a/gcloud/_version b/gcloud/_version index 08c69dd06..02fea18b5 100644 --- a/gcloud/_version +++ b/gcloud/_version @@ -1,8 +1,8 @@ -Google Cloud SDK 424.0.0 -alpha 2023.03.24 -beta 2023.03.24 +Google Cloud SDK 425.0.0 +alpha 2023.03.31 +beta 2023.03.31 bq 2.0.89 bundled-python3-unix 3.9.16 -core 2023.03.24 +core 2023.03.31 gcloud-crc32c 1.0.0 gsutil 5.21 diff --git a/gcloud/access-context-manager/cloud-bindings/create b/gcloud/access-context-manager/cloud-bindings/create index 309e5f49d..e39ef5619 100644 --- a/gcloud/access-context-manager/cloud-bindings/create +++ b/gcloud/access-context-manager/cloud-bindings/create @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud access-context-manager cloud-bindings create --group-key=GROUP_KEY - --level=[LEVEL,...] [--organization=ORGANIZATION] - [GCLOUD_WIDE_FLAG ...] + [--dry-run-level=[DRY_RUN_LEVEL,...]] [--level=[LEVEL,...]] + [--organization=ORGANIZATION] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a new cloud access binding. The access level will be bound with the @@ -19,17 +19,30 @@ EXAMPLES --group-key=my-group-key \ --level=accessPolicies/123/accessLevels/abc + To create a new cloud access binding for the dry run access level, run: + + $ gcloud access-context-manager cloud-bindings create \ + --group-key=my-group-key \ + --level=accessPolicies/123/accessLevels/abc \ + --dry-run-level=accessPolicies/123/accessLevels/def + REQUIRED FLAGS --group-key=GROUP_KEY Google Group id whose members are subject to the restrictions of this binding. +OPTIONAL FLAGS + --dry-run-level=[DRY_RUN_LEVEL,...] + The dry run access level that binds to the given group. The dry run + access level will be evaluated but won't be enforced. Denial on dry run + access level will be logged. The input must be the full identifier of + an access level, such as accessPolicies/123/accessLevels/new-def. + --level=[LEVEL,...] - The access level that will bind to the given group. The input must be - the full identifier for the access level, such as + The access level that binds to the given group. The input must be the + full identifier of an access level, such as accessPolicies/123/accessLevels/abc. -OPTIONAL FLAGS --organization=ORGANIZATION Parent organization for this binding. diff --git a/gcloud/access-context-manager/cloud-bindings/list b/gcloud/access-context-manager/cloud-bindings/list index 62a5092fa..0acaed20e 100644 --- a/gcloud/access-context-manager/cloud-bindings/list +++ b/gcloud/access-context-manager/cloud-bindings/list @@ -15,10 +15,10 @@ EXAMPLES $ gcloud access-context-manager cloud-bindings list - This will print out a list of gcpUserAccessBindings in a tabular form: + This command prints a list of gcpUserAccessBindings in a tabular form: - NAME GROUP_KEY ACCESS_LEVEL - organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N a3dad accessPolicies/9522/accessLevels/device_trusted + NAME GROUP_KEY ACCESS_LEVEL DRY_RUN_ACCESS_LEVEL + organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N a3dad accessPolicies/9522/accessLevels/device_trusted accessPolicies/9522/accessLevels/specific_location FLAGS Organization resource - The parent organization of the bindings you want diff --git a/gcloud/access-context-manager/cloud-bindings/update b/gcloud/access-context-manager/cloud-bindings/update index 172be3005..a5178f63e 100644 --- a/gcloud/access-context-manager/cloud-bindings/update +++ b/gcloud/access-context-manager/cloud-bindings/update @@ -3,26 +3,29 @@ NAME cloud access binding under an organization SYNOPSIS - gcloud access-context-manager cloud-bindings update --level=[LEVEL,...] + gcloud access-context-manager cloud-bindings update (--binding=BINDING : --organization=ORGANIZATION) + [--dry-run-level=[DRY_RUN_LEVEL,...]] [--level=[LEVEL,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Update a existing cloud access binding. You can only update the level. + Update an existing cloud access binding. You can update the level, dry run + level or both. They can't be both empty after update. EXAMPLES - To update a existing cloud access binding, run: + To update an existing cloud access binding, run: $ gcloud access-context-manager cloud-bindings update \ - --binding=my-binding-id \ - --level=accessPolicies/123/accessLevels/new-abc + --binding=my-binding-id \ + --level=accessPolicies/123/accessLevels/new-abc + + To remove level and add dry run level, run: + + $ gcloud access-context-manager cloud-bindings update \ + --binding=my-binding-id --level= \ + --dry-run-level=accessPolicies/123/accessLevels/new-def REQUIRED FLAGS - --level=[LEVEL,...] - The access level that will replace the existing level for the given - binding. The input must be the full identifier for the access level, - such as accessPolicies/123/accessLevels/new-abc. - Cloud access binding resource - The cloud access binding you want to update. The arguments in this group can be used to specify the attributes of this resource. @@ -46,6 +49,17 @@ REQUIRED FLAGS ▸ provide the argument --organization on the command line; ▸ set the property access_context_manager/organization. +OPTIONAL FLAGS + --dry-run-level=[DRY_RUN_LEVEL,...] + The dry run access level that replaces the existing dry run level for + the given binding. The input must be the full identifier of an access + level, such as accessPolicies/123/accessLevels/new-def. + + --level=[LEVEL,...] + The access level that replaces the existing level for the given + binding. The input must be the full identifier of an access level, such + as accessPolicies/123/accessLevels/new-abc. + 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/ai-platform/jobs/submit/training b/gcloud/ai-platform/jobs/submit/training index 59677f8d0..95e449d5b 100644 --- a/gcloud/ai-platform/jobs/submit/training +++ b/gcloud/ai-platform/jobs/submit/training @@ -147,7 +147,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -187,7 +187,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -305,7 +305,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. diff --git a/gcloud/ai/endpoints/create b/gcloud/ai/endpoints/create index 554c27275..c630b2dd2 100644 --- a/gcloud/ai/endpoints/create +++ b/gcloud/ai/endpoints/create @@ -73,6 +73,11 @@ OPTIONAL FLAGS --request-response-logging-table=REQUEST_RESPONSE_LOGGING_TABLE BigQuery table uri for prediction request & response logging. + You can provide table uri that does not exist, it will be created for + you. + + Value should be provided in format: bq://PROJECT_ID/DATASET/TABLE + 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/ai/endpoints/update b/gcloud/ai/endpoints/update index cf002a2f9..db090acd6 100644 --- a/gcloud/ai/endpoints/update +++ b/gcloud/ai/endpoints/update @@ -103,6 +103,11 @@ FLAGS --request-response-logging-table=REQUEST_RESPONSE_LOGGING_TABLE BigQuery table uri for prediction request & response logging. + You can provide table uri that does not exist, it will be created for + you. + + Value should be provided in format: bq://PROJECT_ID/DATASET/TABLE + 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/access-context-manager/cloud-bindings/create b/gcloud/alpha/access-context-manager/cloud-bindings/create index 3c27158e9..9db2b6b2c 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/create +++ b/gcloud/alpha/access-context-manager/cloud-bindings/create @@ -14,8 +14,13 @@ DESCRIPTION group tries to access the Google cloud console or API. EXAMPLES - To create a new cloud access binding including the dry run access level, - run: + To create a new cloud access binding, run: + + $ gcloud alpha access-context-manager cloud-bindings create \ + --group-key=my-group-key \ + --level=accessPolicies/123/accessLevels/abc + + To create a new cloud access binding for the dry run access level, run: $ gcloud alpha access-context-manager cloud-bindings create \ --group-key=my-group-key \ @@ -29,14 +34,14 @@ REQUIRED FLAGS OPTIONAL FLAGS --dry-run-level=[DRY_RUN_LEVEL,...] - The dry run access level that will bind to the given group. The dry run + The dry run access level that binds to the given group. The dry run access level will be evaluated but won't be enforced. Denial on dry run - access level will be logged. The input must be the full identifier for - access level, such as accessPolicies/123/accessLevels/new-def. + access level will be logged. The input must be the full identifier of + an access level, such as accessPolicies/123/accessLevels/new-def. --level=[LEVEL,...] - The access level that will bind to the given group. The input must be - the full identifier for the access level, such as + The access level that binds to the given group. The input must be the + full identifier of an access level, such as accessPolicies/123/accessLevels/abc. --organization=ORGANIZATION diff --git a/gcloud/alpha/access-context-manager/cloud-bindings/list b/gcloud/alpha/access-context-manager/cloud-bindings/list index 13234fe0d..70e2847f0 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/list +++ b/gcloud/alpha/access-context-manager/cloud-bindings/list @@ -15,7 +15,7 @@ EXAMPLES $ gcloud alpha access-context-manager cloud-bindings list - This will print out a list of gcpUserAccessBindings in a tabular form: + This command prints a list of gcpUserAccessBindings in a tabular form: NAME GROUP_KEY ACCESS_LEVEL DRY_RUN_ACCESS_LEVEL organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N a3dad accessPolicies/9522/accessLevels/device_trusted accessPolicies/9522/accessLevels/specific_location diff --git a/gcloud/alpha/access-context-manager/cloud-bindings/update b/gcloud/alpha/access-context-manager/cloud-bindings/update index 2560d72c6..aeaf15694 100644 --- a/gcloud/alpha/access-context-manager/cloud-bindings/update +++ b/gcloud/alpha/access-context-manager/cloud-bindings/update @@ -9,9 +9,8 @@ SYNOPSIS [GCLOUD_WIDE_FLAG ...] DESCRIPTION - (ALPHA) Update an existing cloud access binding. You can only update the - level and dry run level. For level and dry run level, you can update one of - these two or both. They can't be both empty after update. + (ALPHA) Update an existing cloud access binding. You can update the level, + dry run level or both. They can't be both empty after update. EXAMPLES To update an existing cloud access binding, run: @@ -20,7 +19,7 @@ EXAMPLES --binding=my-binding-id \ --level=accessPolicies/123/accessLevels/new-abc - To update level to empty and add dry run level, run: + To remove level and add dry run level, run: $ gcloud alpha access-context-manager cloud-bindings update \ --binding=my-binding-id --level= \ @@ -52,14 +51,14 @@ REQUIRED FLAGS OPTIONAL FLAGS --dry-run-level=[DRY_RUN_LEVEL,...] - The dry run access level that will replace the dry run existing level - for the given binding. The input must be the full identifier for access + The dry run access level that replaces the existing dry run level for + the given binding. The input must be the full identifier of an access level, such as accessPolicies/123/accessLevels/new-def. --level=[LEVEL,...] - The access level that will replace the existing level for the given - binding. The input must be the full identifier for the access level, - such as accessPolicies/123/accessLevels/new-abc. + The access level that replaces the existing level for the given + binding. The input must be the full identifier of an access level, such + as accessPolicies/123/accessLevels/new-abc. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/ai-platform/jobs/submit/training b/gcloud/alpha/ai-platform/jobs/submit/training index 037f81578..27a1284f9 100644 --- a/gcloud/alpha/ai-platform/jobs/submit/training +++ b/gcloud/alpha/ai-platform/jobs/submit/training @@ -149,7 +149,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -200,7 +200,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -322,7 +322,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. diff --git a/gcloud/alpha/ai/endpoints/create b/gcloud/alpha/ai/endpoints/create index eee9c3e5e..cfdd54f5a 100644 --- a/gcloud/alpha/ai/endpoints/create +++ b/gcloud/alpha/ai/endpoints/create @@ -73,6 +73,11 @@ OPTIONAL FLAGS --request-response-logging-table=REQUEST_RESPONSE_LOGGING_TABLE BigQuery table uri for prediction request & response logging. + You can provide table uri that does not exist, it will be created for + you. + + Value should be provided in format: bq://PROJECT_ID/DATASET/TABLE + 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/ai/endpoints/update b/gcloud/alpha/ai/endpoints/update index 4c2e7a6a5..3c17d4845 100644 --- a/gcloud/alpha/ai/endpoints/update +++ b/gcloud/alpha/ai/endpoints/update @@ -103,6 +103,11 @@ FLAGS --request-response-logging-table=REQUEST_RESPONSE_LOGGING_TABLE BigQuery table uri for prediction request & response logging. + You can provide table uri that does not exist, it will be created for + you. + + Value should be provided in format: bq://PROJECT_ID/DATASET/TABLE + 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/beyondcorp/app/connections/create b/gcloud/alpha/beyondcorp/app/connections/create index f4fdcc0f7..d8d6ee1da 100644 --- a/gcloud/alpha/beyondcorp/app/connections/create +++ b/gcloud/alpha/beyondcorp/app/connections/create @@ -33,10 +33,11 @@ EXAMPLES --display-name=connection-display-name --async POSITIONAL ARGUMENTS - Connection resource - The Beyondcorp application connection you want to - create. The arguments in this group can be used to specify the attributes - of this resource. (NOTE) Some attributes are not given arguments in this - group but can be set in other ways. To set the project attribute: + App connection resource - The Beyondcorp application connection you want + to create. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: ◆ provide the argument connection on the command line with a fully specified name; ◆ set the property core/project; @@ -45,7 +46,7 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTION - ID of the connection or fully qualified identifier for the + ID of the app connection or fully qualified identifier for the app connection. To set the app_connection attribute: ▸ provide the argument connection on the command line. diff --git a/gcloud/alpha/beyondcorp/app/connections/delete b/gcloud/alpha/beyondcorp/app/connections/delete index ca04af4ea..08ae1423d 100644 --- a/gcloud/alpha/beyondcorp/app/connections/delete +++ b/gcloud/alpha/beyondcorp/app/connections/delete @@ -15,8 +15,8 @@ EXAMPLES --project={project} --location={location} POSITIONAL ARGUMENTS - Connection resource - The Beyondcorp connection you want to delete. The - arguments in this group can be used to specify the attributes of this + App connection resource - The Beyondcorp connection you want to delete. + The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument connection on the command line with a fully @@ -27,7 +27,7 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTION - ID of the connection or fully qualified identifier for the + ID of the app connection or fully qualified identifier for the app connection. To set the app_connection attribute: ▸ provide the argument connection on the command line. diff --git a/gcloud/alpha/beyondcorp/app/connections/describe b/gcloud/alpha/beyondcorp/app/connections/describe index 42c191a7a..d2ce6843e 100644 --- a/gcloud/alpha/beyondcorp/app/connections/describe +++ b/gcloud/alpha/beyondcorp/app/connections/describe @@ -25,7 +25,7 @@ EXAMPLES updateTime, labels) POSITIONAL ARGUMENTS - Connection resource - The Beyondcorp connector you want to get details + App connection resource - The Beyondcorp connector you want to get details about. 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: @@ -37,7 +37,7 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTION - ID of the connection or fully qualified identifier for the + ID of the app connection or fully qualified identifier for the app connection. To set the app_connection attribute: ▸ provide the argument connection on the command line. diff --git a/gcloud/alpha/beyondcorp/app/connections/update b/gcloud/alpha/beyondcorp/app/connections/update index f9323fe69..1a08ec2de 100644 --- a/gcloud/alpha/beyondcorp/app/connections/update +++ b/gcloud/alpha/beyondcorp/app/connections/update @@ -24,8 +24,8 @@ EXAMPLES --update-labels=k0=value1,k1=value2 --remove-labels=k3 POSITIONAL ARGUMENTS - Connection resource - The Beyondcorp connection you want to update. The - arguments in this group can be used to specify the attributes of this + App connection resource - The Beyondcorp connection you want to update. + The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument connection on the command line with a fully @@ -36,7 +36,7 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTION - ID of the connection or fully qualified identifier for the + ID of the app connection or fully qualified identifier for the app connection. To set the app_connection attribute: ▸ provide the argument connection on the command line. diff --git a/gcloud/alpha/beyondcorp/app/connectors/create b/gcloud/alpha/beyondcorp/app/connectors/create index b60c25062..5563d7f01 100644 --- a/gcloud/alpha/beyondcorp/app/connectors/create +++ b/gcloud/alpha/beyondcorp/app/connectors/create @@ -30,7 +30,7 @@ EXAMPLES --async POSITIONAL ARGUMENTS - Connector resource - The Beyondcorp connector you want to create. The + App connector resource - The Beyondcorp connector you want to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: @@ -42,8 +42,8 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTOR - ID of the connector or fully qualified identifier for the connector. - To set the app_connector attribute: + ID of the app connector or fully qualified identifier for the app + connector. To set the app_connector attribute: ▸ provide the argument connector on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/alpha/beyondcorp/app/connectors/delete b/gcloud/alpha/beyondcorp/app/connectors/delete index 06bcc8d68..6ae0f3cb9 100644 --- a/gcloud/alpha/beyondcorp/app/connectors/delete +++ b/gcloud/alpha/beyondcorp/app/connectors/delete @@ -15,7 +15,7 @@ EXAMPLES --project={project} --location={location} POSITIONAL ARGUMENTS - Connector resource - The Beyondcorp connector you want to delete. The + App connector resource - The Beyondcorp connector you want to delete. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: @@ -27,8 +27,8 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTOR - ID of the connector or fully qualified identifier for the connector. - To set the app_connector attribute: + ID of the app connector or fully qualified identifier for the app + connector. To set the app_connector attribute: ▸ provide the argument connector on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/alpha/beyondcorp/app/connectors/describe b/gcloud/alpha/beyondcorp/app/connectors/describe index 1e2cd60a9..d31c025fa 100644 --- a/gcloud/alpha/beyondcorp/app/connectors/describe +++ b/gcloud/alpha/beyondcorp/app/connectors/describe @@ -24,7 +24,7 @@ EXAMPLES principalInfo.serviceAccount.email,createTime,updateTime,labels) POSITIONAL ARGUMENTS - Connector resource - The Beyondcorp connector you want to get details + App connector resource - The Beyondcorp connector you want to get details about. 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: @@ -36,8 +36,8 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTOR - ID of the connector or fully qualified identifier for the connector. - To set the app_connector attribute: + ID of the app connector or fully qualified identifier for the app + connector. To set the app_connector attribute: ▸ provide the argument connector on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/alpha/beyondcorp/app/connectors/update b/gcloud/alpha/beyondcorp/app/connectors/update index 824d8f19f..da9670a1c 100644 --- a/gcloud/alpha/beyondcorp/app/connectors/update +++ b/gcloud/alpha/beyondcorp/app/connectors/update @@ -21,7 +21,7 @@ EXAMPLES --update-labels=k0=value1,k1=value2 --remove-labels=k3 POSITIONAL ARGUMENTS - Connector resource - The Beyondcorp connector you want to update The + App connector resource - The Beyondcorp connector you want to update The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: @@ -33,8 +33,8 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTOR - ID of the connector or fully qualified identifier for the connector. - To set the app_connector attribute: + ID of the app connector or fully qualified identifier for the app + connector. To set the app_connector attribute: ▸ provide the argument connector on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/alpha/blockchain-node-engine/nodes/create b/gcloud/alpha/blockchain-node-engine/nodes/create new file mode 100644 index 000000000..7c1872245 --- /dev/null +++ b/gcloud/alpha/blockchain-node-engine/nodes/create @@ -0,0 +1,120 @@ +NAME + gcloud alpha blockchain-node-engine nodes create - create a Blockchain Node + Engine node + +SYNOPSIS + gcloud alpha blockchain-node-engine nodes create + (NODE_NAME : --location=LOCATION) [--async] + [--blockchain-type=BLOCKCHAIN_TYPE; default="ETHEREUM"] + [--consensus-client=CONSENSUS_CLIENT; default="LIGHTHOUSE"] + [--execution-client=EXECUTION_CLIENT; default="GETH"] + [--network=NETWORK; default="MAINNET"] + [--node-type=NODE_TYPE; default="FULL"] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new Blockchain Node Engine node with the given name and + configurations. + + If run asynchronously with --async, exits after printing one operation name + that can be used to poll the status of the creation via: + + gcloud operations describe + +EXAMPLES + To create a Blockchain Node Engine node with the name my-node in location + us-central, run: + + $ gcloud alpha blockchain-node-engine nodes create my-node \ + --location=us-central1 + +POSITIONAL ARGUMENTS + Node resource - Arguments and flags that specify the Blockchain Node + Engine node you want to create. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. To set the + project attribute: + ◆ provide the argument node_name on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + NODE_NAME + ID of the node or fully qualified identifier for the node. To set the + node_name attribute: + ▸ provide the argument node_name 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 blockchain node resource. + + To set the location attribute: + ▸ provide the argument node_name on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property web3/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --blockchain-type=BLOCKCHAIN_TYPE; default="ETHEREUM" + Blockchain type the node will connect run on. BLOCKCHAIN_TYPE must be + (only one value is supported): + + ethereum + Ethereum blockchain. + + --consensus-client=CONSENSUS_CLIENT; default="LIGHTHOUSE" + Consensus client for Ethereum nodes. CONSENSUS_CLIENT must be (only one + value is supported): + + lighthouse + Lighthouse execution client. + + --execution-client=EXECUTION_CLIENT; default="GETH" + Execution client for Ethereum nodes. EXECUTION_CLIENT must be (only one + value is supported): + + geth + Geth execution client. + + --network=NETWORK; default="MAINNET" + Blockchain network the node will connect to. NETWORK must be one of: + + goerli + Goerli & Prater Ethereum test network. + + mainnet + Primary Ethereum network, often referred to as mainnet. + + --node-type=NODE_TYPE; default="FULL" + Node type - defines whether the node retains only recent data or an + archival history. NODE_TYPE must be (only one value is supported): + + full + Node retains full history required for consensus validation, + however does not retain archival data beyond that. + +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 blockchainnodeengine/v1alpha1 API. The full + documentation for this API can be found at: https://cloud.google.com/web3 + +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/blockchain-node-engine/nodes/help b/gcloud/alpha/blockchain-node-engine/nodes/help index d707cbc95..634a4af09 100644 --- a/gcloud/alpha/blockchain-node-engine/nodes/help +++ b/gcloud/alpha/blockchain-node-engine/nodes/help @@ -16,6 +16,9 @@ GCLOUD WIDE FLAGS COMMANDS COMMAND is one of the following: + create + (ALPHA) Create a Blockchain Node Engine node. + delete (ALPHA) Delete a Blockchain Node Engine node. diff --git a/gcloud/alpha/builds/approve b/gcloud/alpha/builds/approve index 27f4fbce9..70a2b7760 100644 --- a/gcloud/alpha/builds/approve +++ b/gcloud/alpha/builds/approve @@ -2,8 +2,8 @@ NAME gcloud alpha builds approve - approve a pending build SYNOPSIS - gcloud alpha builds approve BUILD [--comment=COMMENT] [--url=URL] - [GCLOUD_WIDE_FLAG ...] + gcloud alpha builds approve (BUILD : --location=LOCATION) + [--comment=COMMENT] [--url=URL] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Approve a pending build. @@ -11,17 +11,18 @@ DESCRIPTION EXAMPLES To approve a pending build with its ID, run: - $ gcloud alpha builds approve build-id + $ gcloud alpha builds approve \ + projects/{project-id}/locations/{location}/builds/{build-id} To approve multiple pending builds, run the command in a for loop: - $ for i in $(cat build-ids.txt); do gcloud alpha builds approve \ - $i; done + $ for i in $(cat builds.txt); do gcloud alpha builds approve $i; done POSITIONAL ARGUMENTS - Build resource - Build. 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: + Build resource - Build. 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 build on the command line with a fully specified name; ◆ provide the argument --project on the command line; @@ -34,6 +35,15 @@ POSITIONAL ARGUMENTS the build attribute: ▸ provide the argument build on the command line. + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Cloud Region To set the location attribute: + ▸ provide the argument build on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + FLAGS --comment=COMMENT Optional comment to annotate the build's approval. diff --git a/gcloud/alpha/certificate-manager/trust-configs/delete b/gcloud/alpha/certificate-manager/trust-configs/delete index 3a9aa216b..dc782a903 100644 --- a/gcloud/alpha/certificate-manager/trust-configs/delete +++ b/gcloud/alpha/certificate-manager/trust-configs/delete @@ -9,6 +9,12 @@ SYNOPSIS DESCRIPTION (ALPHA) Delete the specified TrustConfig. +EXAMPLES + To delete a TrustConfig called 'my-trust-config', run: + + $ gcloud alpha certificate-manager trust-configs delete \ + my-trust-config --location=global + POSITIONAL ARGUMENTS TrustConfig resource - Name of the TrustConfig you want to delete. The arguments in this group can be used to specify the attributes of this @@ -61,5 +67,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta certificate-manager trust-configs delete diff --git a/gcloud/alpha/certificate-manager/trust-configs/describe b/gcloud/alpha/certificate-manager/trust-configs/describe index 11f0c44ad..05494e80b 100644 --- a/gcloud/alpha/certificate-manager/trust-configs/describe +++ b/gcloud/alpha/certificate-manager/trust-configs/describe @@ -58,5 +58,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta certificate-manager trust-configs describe diff --git a/gcloud/alpha/certificate-manager/trust-configs/export b/gcloud/alpha/certificate-manager/trust-configs/export index abfaa5679..4faacd5af 100644 --- a/gcloud/alpha/certificate-manager/trust-configs/export +++ b/gcloud/alpha/certificate-manager/trust-configs/export @@ -9,6 +9,13 @@ SYNOPSIS DESCRIPTION (ALPHA) Export a TrustConfig. +EXAMPLES + To export a TrustConfig, run: + + $ gcloud alpha certificate-manager trust-configs export \ + my-trust-config --destination=my-trust-config.yaml \ + --location=global + POSITIONAL ARGUMENTS TrustConfig resource - Name of the TrustConfig to export. The arguments in this group can be used to specify the attributes of this resource. (NOTE) @@ -60,5 +67,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta certificate-manager trust-configs export diff --git a/gcloud/alpha/certificate-manager/trust-configs/help b/gcloud/alpha/certificate-manager/trust-configs/help index 31d271646..2eea1919e 100644 --- a/gcloud/alpha/certificate-manager/trust-configs/help +++ b/gcloud/alpha/certificate-manager/trust-configs/help @@ -36,5 +36,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta certificate-manager trust-configs diff --git a/gcloud/alpha/certificate-manager/trust-configs/import b/gcloud/alpha/certificate-manager/trust-configs/import index 438254057..30b7e5a26 100644 --- a/gcloud/alpha/certificate-manager/trust-configs/import +++ b/gcloud/alpha/certificate-manager/trust-configs/import @@ -73,5 +73,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta certificate-manager trust-configs import diff --git a/gcloud/alpha/certificate-manager/trust-configs/list b/gcloud/alpha/certificate-manager/trust-configs/list index e0cc97244..d85eae76f 100644 --- a/gcloud/alpha/certificate-manager/trust-configs/list +++ b/gcloud/alpha/certificate-manager/trust-configs/list @@ -80,5 +80,7 @@ NOTES This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early - access allowlist. + access allowlist. This variant is also available: + + $ gcloud beta certificate-manager trust-configs list diff --git a/gcloud/alpha/compute/backend-services/create b/gcloud/alpha/compute/backend-services/create index 5408d39c4..d05d3bcaf 100644 --- a/gcloud/alpha/compute/backend-services/create +++ b/gcloud/alpha/compute/backend-services/create @@ -24,6 +24,7 @@ SYNOPSIS [--iap=disabled|enabled,[oauth2-client-id=OAUTH2-CLIENT-ID, oauth2-client-secret=OAUTH2-CLIENT-SECRET]] [--idle-timeout-sec=IDLE_TIMEOUT_SEC] + [--ip-address-selection-policy=IP_ADDRESS_SELECTION_POLICY] [--load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL"] [--locality-lb-policy=LOCALITY_LB_POLICY] [--logging-optional=LOGGING_OPTIONAL] @@ -322,6 +323,32 @@ FLAGS service-based network load balancers and internal TCP/UDP load balancers as part of a connection tracking policy. + --ip-address-selection-policy=IP_ADDRESS_SELECTION_POLICY + Specifies preference of traffic to the backend (from the proxy and from + the client for proxyless gRPC). + + Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED, + INTERNAL_MANAGED or EXTERNAL_MANAGED. + + The possible values are: + + IPV4_ONLY + Only send IPv4 traffic to the backends of the Backend Service + regardless of traffic from the client to the proxy. Only IPv4 + health-checks are used to check the health of the backends. + + PREFER_IPV6 + Prioritize the connection to the endpoints IPv6 address over its IPv4 + address (provided there is a healthy IPv6 address). + + IPV6_ONLY + Only send IPv6 traffic to the backends of the Backend Service + regardless of traffic from the client to the proxy. Only IPv6 + health-checks are used to check the health of the backends. + + IP_ADDRESS_SELECTION_POLICY must be one of: IPV4_ONLY, PREFER_IPV6, + IPV6_ONLY. + --load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL" Specifies the load balancer type. Choose EXTERNAL for load balancers that receive traffic from external clients. Choose EXTERNAL_MANAGED for diff --git a/gcloud/alpha/compute/backend-services/update b/gcloud/alpha/compute/backend-services/update index f0458bc4f..4df4eb96a 100644 --- a/gcloud/alpha/compute/backend-services/update +++ b/gcloud/alpha/compute/backend-services/update @@ -20,6 +20,7 @@ SYNOPSIS [--iap=disabled|enabled,[oauth2-client-id=OAUTH2-CLIENT-ID, oauth2-client-secret=OAUTH2-CLIENT-SECRET]] [--idle-timeout-sec=IDLE_TIMEOUT_SEC] + [--ip-address-selection-policy=IP_ADDRESS_SELECTION_POLICY] [--locality-lb-policy=LOCALITY_LB_POLICY] [--logging-optional=LOGGING_OPTIONAL] [--logging-optional-fields=[LOGGING_OPTIONAL_FIELDS,...]] @@ -241,6 +242,32 @@ FLAGS service-based network load balancers and internal TCP/UDP load balancers as part of a connection tracking policy. + --ip-address-selection-policy=IP_ADDRESS_SELECTION_POLICY + Specifies preference of traffic to the backend (from the proxy and from + the client for proxyless gRPC). + + Can only be set if load balancing scheme is INTERNAL_SELF_MANAGED, + INTERNAL_MANAGED or EXTERNAL_MANAGED. + + The possible values are: + + IPV4_ONLY + Only send IPv4 traffic to the backends of the Backend Service + regardless of traffic from the client to the proxy. Only IPv4 + health-checks are used to check the health of the backends. + + PREFER_IPV6 + Prioritize the connection to the endpoints IPv6 address over its IPv4 + address (provided there is a healthy IPv6 address). + + IPV6_ONLY + Only send IPv6 traffic to the backends of the Backend Service + regardless of traffic from the client to the proxy. Only IPv6 + health-checks are used to check the health of the backends. + + IP_ADDRESS_SELECTION_POLICY must be one of: IPV4_ONLY, PREFER_IPV6, + IPV6_ONLY. + --locality-lb-policy=LOCALITY_LB_POLICY The load balancing algorithm used within the scope of the locality. LOCALITY_LB_POLICY must be one of: INVALID_LB_POLICY, ROUND_ROBIN, diff --git a/gcloud/alpha/compute/forwarding-rules/create b/gcloud/alpha/compute/forwarding-rules/create index 6af1754ed..12d566a2c 100644 --- a/gcloud/alpha/compute/forwarding-rules/create +++ b/gcloud/alpha/compute/forwarding-rules/create @@ -289,9 +289,9 @@ OPTIONAL FLAGS address that has the --purpose=SHARED_LOADBALANCER_VIP flag set. --source-ip-ranges=SOURCE_IP_RANGE,[...] - List of comma-separated IP addresses or IP ranges. If not empty, this - Forwarding Rule will only forward the traffic when the source IP - address falls into one of the IP ranges set here. + List of comma-separated IP addresses or IP ranges. If set, this + forwarding rule only forwards traffic when the packet's source IP + address matches one of the IP ranges set here. --subnet=SUBNET (Only for --load-balancing-scheme=INTERNAL and diff --git a/gcloud/alpha/compute/forwarding-rules/update b/gcloud/alpha/compute/forwarding-rules/update index 8a498006f..f43420d5e 100644 --- a/gcloud/alpha/compute/forwarding-rules/update +++ b/gcloud/alpha/compute/forwarding-rules/update @@ -58,9 +58,9 @@ FLAGS change from PREMIUM to STANDARD and visa versa. --source-ip-ranges=SOURCE_IP_RANGE,[...] - List of comma-separated IP addresses or IP ranges. If not empty, this - Forwarding Rule will only forward the traffic when the source IP - address falls into one of the IP ranges set here. + List of comma-separated IP addresses or IP ranges. If set, this + forwarding rule only forwards traffic when the packet's source IP + address matches one of the IP ranges set here. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/alpha/compute/instances/network-interfaces/update b/gcloud/alpha/compute/instances/network-interfaces/update index 7d4e7f2e1..f3a1bb162 100644 --- a/gcloud/alpha/compute/instances/network-interfaces/update +++ b/gcloud/alpha/compute/instances/network-interfaces/update @@ -11,8 +11,11 @@ SYNOPSIS [--ipv6-address=IPV6_ADDRESS] [--ipv6-network-tier=IPV6_NETWORK_TIER] [--ipv6-prefix-length=IPV6_PREFIX_LENGTH] [--network=NETWORK] [--network-interface=NETWORK_INTERFACE; default="nic0"] - [--private-network-ip=PRIVATE_NETWORK_IP] [--stack-type=STACK_TYPE] - [--subnetwork=SUBNETWORK] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...] + [--private-network-ip=PRIVATE_NETWORK_IP] + [--security-policy=SECURITY_POLICY] + [--security-policy-region=SECURITY_POLICY_REGION] + [--stack-type=STACK_TYPE] [--subnetwork=SUBNETWORK] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute instances network-interfaces update updates @@ -102,6 +105,15 @@ FLAGS available in the new subnetwork, then another available IP address will be allocated automatically from the new subnetwork CIDR range. + --security-policy=SECURITY_POLICY + The security policy that will be set for this instance network + interface. To remove the policy from this instance network interface + set the policy to an empty string. + + --security-policy-region=SECURITY_POLICY_REGION + Region of the security policy to operate on. Overrides the default + compute/region property value for this command invocation. + --stack-type=STACK_TYPE The stack type for the default network interface. Determines if IPv6 is enabled on the default network interface. STACK_TYPE must be one of: diff --git a/gcloud/alpha/compute/network-endpoint-groups/update b/gcloud/alpha/compute/network-endpoint-groups/update index a8d970933..2de583ef4 100644 --- a/gcloud/alpha/compute/network-endpoint-groups/update +++ b/gcloud/alpha/compute/network-endpoint-groups/update @@ -4,9 +4,10 @@ NAME SYNOPSIS gcloud alpha compute network-endpoint-groups update NAME - (--add-endpoint=[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] + (--add-endpoint=[fqdn=FQDN], + [instance=INSTANCE],[ip=IP],[ipv6=IPV6],[port=PORT] | --remove-endpoint=[fqdn=FQDN], - [instance=INSTANCE],[ip=IP],[port=PORT]) + [instance=INSTANCE],[ip=IP],[ipv6=IPV6],[port=PORT]) [--global | --region=REGION | --zone=ZONE] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -37,7 +38,7 @@ REQUIRED FLAGS Exactly one of these must be specified: - --add-endpoint=[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] + --add-endpoint=[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[ipv6=IPV6],[port=PORT] The network endpoint to add to the network endpoint group. Keys used depend on the endpoint type of the NEG. @@ -51,20 +52,31 @@ REQUIRED FLAGS is deleted, then any network endpoint group that has a reference to it is updated. - *ip* - Optional IP address of the network endpoint. the IP address + *ip* - Optional IP address of the network endpoint. The IP address must belong to a VM in compute engine (either the primary IP or as part of an aliased IP range). If the IP address is not specified, then the primary IP address for the VM instance in the network that the network endpoint group belongs to is used. + *ipv6* - Optional IPv6 address of the network endpoint. The IPv6 + address must belong to a VM in compute engine (either the internal + or external IPv6 address). + + At least one of the ip and ipv6 must be specified. + *port* - Required endpoint port unless NEG default port is set. internet-ip-port - *ip* - Required IP address of the endpoint to attach. Must be + *ip* - Optional IPv4 address of the endpoint to attach. Must be publicly routable. + *ipv6* - Optional IPv6 address of the endpoint to attach. Must be + publicly routable. + + At least one of the ip and ipv6 must be specified. + *port* - Optional port of the endpoint to attach. If unspecified, the NEG default port is set. If no default port is set, the well-known port for the backend protocol is used instead @@ -85,12 +97,20 @@ REQUIRED FLAGS non-gcp-private-ip-port - *ip* - Required IP address of the network endpoint to attach. The - IP address must belong to a VM not in Compute Engine and - must be routable using a Cloud Router over VPN or an Interconnect connection. + *ip* - Optional IPv4 address of the network endpoint to attach. + The IP address must belong to a VM not in Compute Engine and must + be routable using a Cloud Router over VPN or an Interconnect + connection. - *port* - Required port of the network endpoint to attach unless the - NEG default port is set. + *ipv6* - Optional IPv6 address of the network endpoint to attach. + The IP address must belong to a VM not in Compute Engine and must + be routable using a Cloud Router over VPN or an Interconnect + connection. + + At least one of the ip and ipv6 must be specified. + + *port* - Required port of the network endpoint to attach unless + the NEG default port is set. gce-vm-primary-ip @@ -119,7 +139,7 @@ REQUIRED FLAGS IP address must be the VM's network interface address. If not specified, the primary NIC address is used. - --remove-endpoint=[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[port=PORT] + --remove-endpoint=[fqdn=FQDN],[instance=INSTANCE],[ip=IP],[ipv6=IPV6],[port=PORT] The network endpoint to detach from the network endpoint group. Keys used depend on the endpoint type of the NEG. @@ -129,14 +149,21 @@ REQUIRED FLAGS detach. If the IP address is unset, all endpoints for the instance in the NEG are detached. - *ip* - Optional IP address of the network endpoint to detach. + *ip* - Optional IPv4 address of the network endpoint to detach. + If specified port must be provided as well. + + *ipv6* - Optional IPv6 address of the network endpoint to detach. If specified port must be provided as well. *port* - Optional port of the network endpoint to detach. internet-ip-port - *ip* - Required IP address of the network endpoint to detach. + *ip* - Required IPv4 address of the network endpoint to detach. + + *ipv6* - Required IPv6 address of the network endpoint to detach. + + At least one of the ip and ipv6 must be specified. *port* - Optional port of the network endpoint to detach if the endpoint has a port specified. @@ -151,7 +178,11 @@ REQUIRED FLAGS non-gcp-private-ip-port - *ip* - Required IP address of the network endpoint to detach. + *ip* - Required IPv4 address of the network endpoint to detach. + + *ipv6* - Required IPv6 address of the network endpoint to detach. + + At least one of the ip and ipv6 must be specified. *port* - Required port of the network endpoint to detach unless NEG default port is set. diff --git a/gcloud/alpha/compute/security-policies/add-user-defined-field b/gcloud/alpha/compute/security-policies/add-user-defined-field new file mode 100644 index 000000000..bff51e2aa --- /dev/null +++ b/gcloud/alpha/compute/security-policies/add-user-defined-field @@ -0,0 +1,63 @@ +NAME + gcloud alpha compute security-policies add-user-defined-field - add a user + defined field to a Compute Engine security policy + +SYNOPSIS + gcloud alpha compute security-policies add-user-defined-field NAME + --base=BASE --offset=OFFSET --size=SIZE + --user-defined-field-name=USER_DEFINED_FIELD_NAME [--mask=MASK] + [--region=REGION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute security-policies add-user-defined-field is + used to add user defined fields to security policies. + +EXAMPLES + To add a user defined field run this: + + $ gcloud alpha compute security-policies add-user-defined-field \ + SECURITY_POLICY --user-defined-field-name=my-field --base=ipv6 \ + --offset=10 --size=3 + +POSITIONAL ARGUMENTS + NAME + Name of the security policy to update. + +REQUIRED FLAGS + --base=BASE + The base relative to which offset is measured. BASE must be one of: + ipv4, ipv6, tcp, udp. + + --offset=OFFSET + Offset of the first byte of the field (in network byte order) relative + to base. + + --size=SIZE + Size of the field in bytes. Valid values: 1-4. + + --user-defined-field-name=USER_DEFINED_FIELD_NAME + The name for the user defined field. + +OPTIONAL FLAGS + --mask=MASK + If specified, apply this mask (bitwise AND) to the field to ignore bits + before matching. Encoded as a hexadecimal number (starting with "0x"). + + --region=REGION + Region of the security policy to update. Overrides the default + compute/region property value for this command invocation. + +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/help b/gcloud/alpha/compute/security-policies/help index 1c4351550..3e22424c1 100644 --- a/gcloud/alpha/compute/security-policies/help +++ b/gcloud/alpha/compute/security-policies/help @@ -33,6 +33,9 @@ GROUPS COMMANDS COMMAND is one of the following: + add-user-defined-field + (ALPHA) Add a user defined field to a Compute Engine security policy. + create (ALPHA) Create a Compute Engine security policy. @@ -54,6 +57,10 @@ COMMANDS list-preconfigured-expression-sets (ALPHA) List all available preconfigured expression sets. + remove-user-defined-field + (ALPHA) Remove a user defined field from a Compute Engine security + policy. + update (ALPHA) Update a Compute Engine security policy. diff --git a/gcloud/alpha/compute/security-policies/remove-user-defined-field b/gcloud/alpha/compute/security-policies/remove-user-defined-field new file mode 100644 index 000000000..755b2946b --- /dev/null +++ b/gcloud/alpha/compute/security-policies/remove-user-defined-field @@ -0,0 +1,46 @@ +NAME + gcloud alpha compute security-policies remove-user-defined-field - remove a + user defined field from a Compute Engine security policy + +SYNOPSIS + gcloud alpha compute security-policies remove-user-defined-field NAME + --user-defined-field-name=USER_DEFINED_FIELD_NAME [--region=REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute security-policies remove-user-defined-field is + used to remove user defined fields from security policies. + +EXAMPLES + To remove a user defined field run this: + + $ gcloud alpha compute security-policies remove-user-defined-field \ + SECURITY_POLICY --user-defined-field-name=my-field + +POSITIONAL ARGUMENTS + NAME + Name of the security policy to update. + +REQUIRED FLAGS + --user-defined-field-name=USER_DEFINED_FIELD_NAME + The name of the user defined field to remove. + +OPTIONAL FLAGS + --region=REGION + Region of the security policy to update. Overrides the default + compute/region property value for this command invocation. + +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/create b/gcloud/alpha/compute/security-policies/rules/create index 336c11a8a..314e8a918 100644 --- a/gcloud/alpha/compute/security-policies/rules/create +++ b/gcloud/alpha/compute/security-policies/rules/create @@ -5,7 +5,15 @@ NAME SYNOPSIS gcloud alpha compute security-policies rules create PRIORITY --action=ACTION - (--expression=EXPRESSION | --src-ip-ranges=[SRC_IP_RANGE,...]) + (--expression=EXPRESSION --network-dest-ip-ranges=[DEST_IP_RANGE,...] + --network-dest-ports=[DEST_PORT,...] + --network-ip-protocols=[IP_PROTOCOL,...] + --network-src-asns=[SRC_ASN,...] + --network-src-ip-ranges=[SRC_IP_RANGE,...] + --network-src-ports=[SRC_PORT,...] + --network-src-region-codes=[SRC_REGION_CODE,...] + --network-user-defined-fields=[NAME;VALUE:VALUE:...,...] + --src-ip-ranges=[SRC_IP_RANGE,...]) [--ban-duration-sec=BAN_DURATION_SEC] [--ban-threshold-count=BAN_THRESHOLD_COUNT] [--ban-threshold-interval-sec=BAN_THRESHOLD_INTERVAL_SEC] @@ -81,11 +89,48 @@ REQUIRED FLAGS Security policy rule matcher. - Exactly one of these must be specified: + At least one of these must be specified: --expression=EXPRESSION The Cloud Armor rules language expression to match for this rule. + --network-dest-ip-ranges=[DEST_IP_RANGE,...] + The destination IPs/IP ranges to match for this rule. To match all + IPs specify *. + + --network-dest-ports=[DEST_PORT,...] + The destination ports to match for this rule. Each element can be an + 16-bit unsigned decimal number (e.g. "80") or range (e.g."0-1023"), + To match all destination ports specify *. + + --network-ip-protocols=[IP_PROTOCOL,...] + The IP protocols to match for this rule. Each element can be an 8-bit + unsigned decimal number (e.g. "6"), range (e.g."253-254"), or one of + the following protocol names: "tcp", "udp", "icmp", "esp", "ah", + "ipip", or "sctp". To match all protocols specify *. + + --network-src-asns=[SRC_ASN,...] + BGP Autonomous System Number associated with the source IP address to + match for this rule. + + --network-src-ip-ranges=[SRC_IP_RANGE,...] + The source IPs/IP ranges to match for this rule. To match all IPs + specify *. + + --network-src-ports=[SRC_PORT,...] + The source ports to match for this rule. Each element can be an + 16-bit unsigned decimal number (e.g. "80") or range (e.g."0-1023"), + To match all source ports specify *. + + --network-src-region-codes=[SRC_REGION_CODE,...] + The two letter ISO 3166-1 alpha-2 country code associated with the + source IP address to match for this rule. To match all region codes + specify *. + + --network-user-defined-fields=[NAME;VALUE:VALUE:...,...] + Each element names a defined field and lists the matching values for + that field. + --src-ip-ranges=[SRC_IP_RANGE,...] The source IPs/IP ranges to match for this rule. To match all IPs specify *. diff --git a/gcloud/alpha/compute/security-policies/rules/update b/gcloud/alpha/compute/security-policies/rules/update index 74a5fe14d..06d6f9675 100644 --- a/gcloud/alpha/compute/security-policies/rules/update +++ b/gcloud/alpha/compute/security-policies/rules/update @@ -23,8 +23,15 @@ SYNOPSIS [--redirect-target=REDIRECT_TARGET] [--redirect-type=REDIRECT_TYPE] [--request-headers-to-add=[REQUEST_HEADERS_TO_ADD,...]] [--security-policy=SECURITY_POLICY] - [--expression=EXPRESSION | --src-ip-ranges=[SRC_IP_RANGE,...]] - [GCLOUD_WIDE_FLAG ...] + [--expression=EXPRESSION --network-dest-ip-ranges=[DEST_IP_RANGE,...] + --network-dest-ports=[DEST_PORT,...] + --network-ip-protocols=[IP_PROTOCOL,...] + --network-src-asns=[SRC_ASN,...] + --network-src-ip-ranges=[SRC_IP_RANGE,...] + --network-src-ports=[SRC_PORT,...] + --network-src-region-codes=[SRC_REGION_CODE,...] + --network-user-defined-fields=[NAME;VALUE:VALUE:...,...] + --src-ip-ranges=[SRC_IP_RANGE,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) gcloud alpha compute security-policies rules update is used to @@ -211,11 +218,46 @@ FLAGS Security policy rule matcher. - At most one of these can be specified: - --expression=EXPRESSION The Cloud Armor rules language expression to match for this rule. + --network-dest-ip-ranges=[DEST_IP_RANGE,...] + The destination IPs/IP ranges to match for this rule. To match all + IPs specify *. + + --network-dest-ports=[DEST_PORT,...] + The destination ports to match for this rule. Each element can be an + 16-bit unsigned decimal number (e.g. "80") or range (e.g."0-1023"), + To match all destination ports specify *. + + --network-ip-protocols=[IP_PROTOCOL,...] + The IP protocols to match for this rule. Each element can be an 8-bit + unsigned decimal number (e.g. "6"), range (e.g."253-254"), or one of + the following protocol names: "tcp", "udp", "icmp", "esp", "ah", + "ipip", or "sctp". To match all protocols specify *. + + --network-src-asns=[SRC_ASN,...] + BGP Autonomous System Number associated with the source IP address to + match for this rule. + + --network-src-ip-ranges=[SRC_IP_RANGE,...] + The source IPs/IP ranges to match for this rule. To match all IPs + specify *. + + --network-src-ports=[SRC_PORT,...] + The source ports to match for this rule. Each element can be an + 16-bit unsigned decimal number (e.g. "80") or range (e.g."0-1023"), + To match all source ports specify *. + + --network-src-region-codes=[SRC_REGION_CODE,...] + The two letter ISO 3166-1 alpha-2 country code associated with the + source IP address to match for this rule. To match all region codes + specify *. + + --network-user-defined-fields=[NAME;VALUE:VALUE:...,...] + Each element names a defined field and lists the matching values for + that field. + --src-ip-ranges=[SRC_IP_RANGE,...] The source IPs/IP ranges to match for this rule. To match all IPs specify *. diff --git a/gcloud/alpha/compute/sole-tenancy/node-groups/help b/gcloud/alpha/compute/sole-tenancy/node-groups/help index cfc1d482c..7f4493870 100644 --- a/gcloud/alpha/compute/sole-tenancy/node-groups/help +++ b/gcloud/alpha/compute/sole-tenancy/node-groups/help @@ -38,6 +38,9 @@ COMMANDS list-nodes (ALPHA) List Compute Engine sole-tenant nodes present in a nodegroup. + perform-maintenance + (ALPHA) Perform maintenance on nodes in a Compute Engine node group. + remove-iam-policy-binding (ALPHA) Remove IAM policy binding from a Compute Engine node group. diff --git a/gcloud/alpha/compute/sole-tenancy/node-groups/perform-maintenance b/gcloud/alpha/compute/sole-tenancy/node-groups/perform-maintenance new file mode 100644 index 000000000..8a86eac3a --- /dev/null +++ b/gcloud/alpha/compute/sole-tenancy/node-groups/perform-maintenance @@ -0,0 +1,67 @@ +NAME + gcloud alpha compute sole-tenancy node-groups perform-maintenance - perform + maintenance on nodes in a Compute Engine node group + +SYNOPSIS + gcloud alpha compute sole-tenancy node-groups perform-maintenance NAME + --nodes=NODE,[NODE,...] [--start-time=START_TIME] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Perform maintenance on nodes in a Compute Engine node group. + +EXAMPLES + To perform maintenance on nodes in a node group, run: + + $ gcloud alpha compute sole-tenancy node-groups \ + perform-maintenance my-node-group --nodes=node-1,node-2 \ + --start-time=2023-05-01T00:00:00.000-08:00 + +POSITIONAL ARGUMENTS + NAME + Name of the node group to operate on. + +REQUIRED FLAGS + --nodes=NODE,[NODE,...] + The names of the nodes to perform maintenance on. + +OPTIONAL FLAGS + --start-time=START_TIME + The requested time for the maintenance window to start. The timestamp + must be an RFC3339 valid string. + + --zone=ZONE + Zone of the node group to operate on. If not specified and the + compute/zone property isn't set, you might be prompted to select a zone + (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/zone property: + + $ gcloud config set compute/zone ZONE + + A list of zones can be fetched by running: + + $ gcloud compute zones list + + To unset the property, run: + + $ gcloud config unset compute/zone + + Alternatively, the zone can be stored in the environment variable + CLOUDSDK_COMPUTE_ZONE. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. + diff --git a/gcloud/alpha/compute/target-instances/help b/gcloud/alpha/compute/target-instances/help index e73de84d1..84d11d49c 100644 --- a/gcloud/alpha/compute/target-instances/help +++ b/gcloud/alpha/compute/target-instances/help @@ -43,6 +43,9 @@ COMMANDS list (ALPHA) List Google Compute Engine target instances. + update + (ALPHA) Update a Compute Engine target instance. + 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/target-instances/update b/gcloud/alpha/compute/target-instances/update new file mode 100644 index 000000000..65ccf0558 --- /dev/null +++ b/gcloud/alpha/compute/target-instances/update @@ -0,0 +1,69 @@ +NAME + gcloud alpha compute target-instances update - update a Compute Engine + target instance + +SYNOPSIS + gcloud alpha compute target-instances update NAME + [--security-policy=SECURITY_POLICY] + [--security-policy-region=SECURITY_POLICY_REGION] [--zone=ZONE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute target-instances update updates a Compute + Engine target instance. + +EXAMPLES + To update the security policy run this: + + $ gcloud alpha compute target-instances update TARGET_INSTANCE \ + --security-policy='my-policy' + +POSITIONAL ARGUMENTS + NAME + Name of the target instance to update. + +FLAGS + --security-policy=SECURITY_POLICY + The security policy that will be set for this target instance. To + remove the policy from this target instance set the policy to an empty + string. + + --security-policy-region=SECURITY_POLICY_REGION + Region of the security policy to operate on. Overrides the default + compute/region property value for this command invocation. + + --zone=ZONE + Zone of the target instance to update. 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/target-pools/help b/gcloud/alpha/compute/target-pools/help index 6dec26498..0afa17aff 100644 --- a/gcloud/alpha/compute/target-pools/help +++ b/gcloud/alpha/compute/target-pools/help @@ -58,6 +58,9 @@ COMMANDS set-backup (ALPHA) Set a backup pool for a target pool. + update + (ALPHA) Update a Compute Engine target pool. + 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/target-pools/update b/gcloud/alpha/compute/target-pools/update new file mode 100644 index 000000000..fcd004a82 --- /dev/null +++ b/gcloud/alpha/compute/target-pools/update @@ -0,0 +1,67 @@ +NAME + gcloud alpha compute target-pools update - update a Compute Engine target + pool + +SYNOPSIS + gcloud alpha compute target-pools update NAME [--region=REGION] + [--security-policy=SECURITY_POLICY] + [--security-policy-region=SECURITY_POLICY_REGION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) gcloud alpha compute target-pools update updates a Compute Engine + target pool. + +EXAMPLES + To update the security policy run this: + + $ gcloud alpha compute target-pools update TARGET_POOL \ + --security-policy='my-policy' + +POSITIONAL ARGUMENTS + NAME + The name of the target pool. + +FLAGS + --region=REGION + Region of the target pool to update. If not specified, you might be + prompted to select a region (interactive mode only). + + To avoid prompting when this flag is omitted, you can set the + compute/region property: + + $ gcloud config set compute/region REGION + + A list of regions can be fetched by running: + + $ gcloud compute regions list + + To unset the property, run: + + $ gcloud config unset compute/region + + Alternatively, the region can be stored in the environment variable + CLOUDSDK_COMPUTE_REGION. + + --security-policy=SECURITY_POLICY + The security policy that will be set for this target pool. To remove + the policy from this target pool set the policy to an empty string. + + --security-policy-region=SECURITY_POLICY_REGION + Region of the security policy to operate on. Overrides the default + compute/region property value for this command invocation. + +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/tpus/queued-resources/create b/gcloud/alpha/compute/tpus/queued-resources/create index c0e751ce5..eab5f5285 100644 --- a/gcloud/alpha/compute/tpus/queued-resources/create +++ b/gcloud/alpha/compute/tpus/queued-resources/create @@ -8,10 +8,12 @@ SYNOPSIS --runtime-version=RUNTIME_VERSION (--node-id=NODE_ID | --node-count=NODE_COUNT --node-prefix=NODE_PREFIX) [--async] [--best-effort] [--guaranteed] [--internal-ips] + [--network=NETWORK; default="default"] [--reservation-host-folder=RESERVATION_HOST_FOLDER] [--reservation-host-organization=RESERVATION_HOST_ORGANIZATION] [--reservation-host-project=RESERVATION_HOST_PROJECT] [--reserved] - [--valid-after-duration=VALID_AFTER_DURATION] + [--scopes=[SCOPES,...]] [--service-account=SERVICE_ACCOUNT] + [--subnetwork=SUBNETWORK] [--valid-after-duration=VALID_AFTER_DURATION] [--valid-after-time=VALID_AFTER_TIME] [--valid-until-duration=VALID_UNTIL_DURATION] [--valid-until-time=VALID_UNTIL_TIME] [GCLOUD_WIDE_FLAG ...] @@ -127,6 +129,9 @@ OPTIONAL FLAGS default is that external IP addresses will be associated with the TPU workers. + --network=NETWORK; default="default" + Network that this TPU will be a part of. + --reservation-host-folder=RESERVATION_HOST_FOLDER The folder hosting the reservation that the TPU should use. Only one reservation host entity may be specified. @@ -144,6 +149,17 @@ OPTIONAL FLAGS If this flag is set the guaranteed flag is also set. + --scopes=[SCOPES,...] + List of comma-separated scopes to be made available for the service + account. + + --service-account=SERVICE_ACCOUNT + Email address of the service account. If empty, default Google Compute + Engine service account will be used. + + --subnetwork=SUBNETWORK + Subnetwork that this TPU will be a part of. + --valid-after-duration=VALID_AFTER_DURATION A duration before which the TPU must not be provisioned, relative to the current time. See $ gcloud topic datetimes for information on diff --git a/gcloud/alpha/compute/tpus/queued-resources/delete b/gcloud/alpha/compute/tpus/queued-resources/delete index 6749de047..4484bec41 100644 --- a/gcloud/alpha/compute/tpus/queued-resources/delete +++ b/gcloud/alpha/compute/tpus/queued-resources/delete @@ -4,7 +4,8 @@ NAME SYNOPSIS gcloud alpha compute tpus queued-resources delete - (QUEUED_RESOURCE : --zone=ZONE) [--async] [GCLOUD_WIDE_FLAG ...] + (QUEUED_RESOURCE : --zone=ZONE) [--async] [--force] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Delete an existing Queued Resource. @@ -56,6 +57,11 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. + --force + If set to true, any nodes in this queued resource will also be deleted. + Otherwise, the request will only work if the queued resource has no + nodes. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/config/get b/gcloud/alpha/config/get index 82a186b59..154a93f74 100644 --- a/gcloud/alpha/config/get +++ b/gcloud/alpha/config/get @@ -893,7 +893,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1283,6 +1284,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/alpha/config/help b/gcloud/alpha/config/help index 800a43c34..a45b8729a 100644 --- a/gcloud/alpha/config/help +++ b/gcloud/alpha/config/help @@ -925,7 +925,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1315,6 +1316,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/alpha/config/list b/gcloud/alpha/config/list index b4140b35f..e6dbc5332 100644 --- a/gcloud/alpha/config/list +++ b/gcloud/alpha/config/list @@ -937,7 +937,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1327,6 +1328,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/alpha/config/set b/gcloud/alpha/config/set index 6f4e955d4..5c515b35f 100644 --- a/gcloud/alpha/config/set +++ b/gcloud/alpha/config/set @@ -940,7 +940,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1330,6 +1331,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/alpha/config/unset b/gcloud/alpha/config/unset index e68e0d5c5..5ae2f2e25 100644 --- a/gcloud/alpha/config/unset +++ b/gcloud/alpha/config/unset @@ -901,7 +901,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1291,6 +1292,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/alpha/container/bare-metal/clusters/create b/gcloud/alpha/container/bare-metal/clusters/create index 32650c6d7..ef1261ea3 100644 --- a/gcloud/alpha/container/bare-metal/clusters/create +++ b/gcloud/alpha/container/bare-metal/clusters/create @@ -21,8 +21,6 @@ SYNOPSIS : --control-plane-node-labels=[KEY=VALUE,...] --control-plane-node-taints=[KEY=VALUE:EFFECT,...]))) : --api-server-args=[KEY=VALUE,...]) - (--island-mode-pod-address-cidr-blocks=POD_ADDRESS,[POD_ADDRESS,...] - --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...]) ((--lvp-node-mounts-config-path=LVP_NODE_MOUNTS_CONFIG_PATH --lvp-node-mounts-config-storage-class=LVP_NODE_MOUNTS_CONFIG_STORAGE_CLASS) ((--lvp-share-path=LVP_SHARE_PATH --lvp-share-storage-class=LVP_SHARE_STORAGE_CLASS) : --shared-path-pv-count=SHARED_PATH_PV_COUNT)) [--admin-users=ADMIN_USERS] [--annotations=[KEY=VALUE,...]] [--async] @@ -32,6 +30,10 @@ SYNOPSIS ...]] [--validate-only] [--container-runtime=CONTAINER_RUNTIME --max-pods-per-node=MAX_PODS_PER_NODE] + [[(--island-mode-pod-address-cidr-blocks=POD_ADDRESS,[POD_ADDRESS,...] + --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...]) + : --enable-advanced-networking + --enable-multi-nic-config --enable-sr-iov-config]] [--uri=URI : --no-proxy=[NO_PROXY,...]] [GCLOUD_WIDE_FLAG ...] DESCRIPTION @@ -202,24 +204,6 @@ REQUIRED FLAGS --control-plane-node-taints=[KEY=VALUE:EFFECT,...] Node taint applied to every Kubernetes node in a node pool. - Populate one of the network configs. - - This must be specified. - - Island mode CIDR network configuration. - - --island-mode-pod-address-cidr-blocks=POD_ADDRESS,[POD_ADDRESS,...] - IPv4 address range for all pods in the cluster. - - This flag argument must be specified if any of the other arguments - in this group are specified. - - --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...] - IPv4 address range for all services in the cluster. - - This flag argument must be specified if any of the other arguments - in this group are specified. - Anthos on bare metal cluster storage configuration. This must be specified. @@ -311,6 +295,40 @@ OPTIONAL FLAGS --max-pods-per-node=MAX_PODS_PER_NODE Maximum number of pods a node can run. + Anthos on bare metal cluster network configurations. + + --enable-advanced-networking + Enables the use of advanced Anthos networking features, such as + Bundled Load Balancing with BGP or the egress NAT gateway. + + Multiple networking interfaces cluster configurations. + + --enable-multi-nic-config + If set, enable multiple network interfaces for your pods. + + SR-IOV networking operator configurations. + + --enable-sr-iov-config + If set, install the SR-IOV operator. + + Populate one of the network configs. + + This must be specified. + + Island mode CIDR network configuration. + + --island-mode-pod-address-cidr-blocks=POD_ADDRESS,[POD_ADDRESS,...] + IPv4 address range for all pods in the cluster. + + This flag argument must be specified if any of the other + arguments in this group are specified. + + --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...] + IPv4 address range for all services in the cluster. + + This flag argument must be specified if any of the other + arguments in this group are specified. + Anthos on bare metal cluster proxy configuration. --uri=URI diff --git a/gcloud/alpha/container/bare-metal/clusters/update b/gcloud/alpha/container/bare-metal/clusters/update index 0d6e0c471..821f20c9d 100644 --- a/gcloud/alpha/container/bare-metal/clusters/update +++ b/gcloud/alpha/container/bare-metal/clusters/update @@ -6,15 +6,15 @@ SYNOPSIS gcloud alpha container bare-metal clusters update (CLUSTER : --location=LOCATION) [--admin-users=ADMIN_USERS] [--allow-missing] [--async] [--description=DESCRIPTION] - [--enable-application-logs] - [--island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...]] - [--login-user=LOGIN_USER] + [--enable-application-logs] [--login-user=LOGIN_USER] [--maintenance-address-cidr-blocks=[MAINTENANCE_ADDRESS_CIDR_BLOCKS, ...]] [--validate-only] [--version=VERSION] [--api-server-args=[KEY=VALUE,...] --control-plane-node-configs=[labels=LABELS],[node-ip=NODE-IP] --control-plane-node-labels=[KEY=VALUE,...] --control-plane-node-taints=[KEY=VALUE:EFFECT,...]] + [--island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...] + --disable-sr-iov-config | --enable-sr-iov-config] [--metal-lb-address-pools=[addresses=ADDRESSES], [avoid-buggy-ips=AVOID-BUGGY-IPS], [manual-assign=MANUAL-ASSIGN],[pool=POOL] @@ -88,13 +88,6 @@ FLAGS Whether collection of application logs/metrics should be enabled (in addition to system logs/metrics). - Populate one of the network configs. - - Island mode CIDR network configuration. - - --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...] - IPv4 address range for all services in the cluster. - Anthos on bare metal node access related settings for the user cluster. --login-user=LOGIN_USER @@ -136,6 +129,25 @@ FLAGS --control-plane-node-taints=[KEY=VALUE:EFFECT,...] Node taint applied to every Kubernetes node in a node pool. + Anthos on bare metal cluster network configurations. + + Populate one of the network configs. + + Island mode CIDR network configuration. + + --island-mode-service-address-cidr-blocks=SERVICE_ADDRESS,[...] + IPv4 address range for all services in the cluster. + + SR-IOV networking operator configurations. + + At most one of these can be specified: + + --disable-sr-iov-config + If set, the SR-IOV operator won't be installed. + + --enable-sr-iov-config + If set, install the SR-IOV operator. + Anthos on bare metal cluster load balancer configuration. Populate one of the load balancers. diff --git a/gcloud/alpha/container/bare-metal/node-pools/enroll b/gcloud/alpha/container/bare-metal/node-pools/enroll new file mode 100644 index 000000000..ded4472df --- /dev/null +++ b/gcloud/alpha/container/bare-metal/node-pools/enroll @@ -0,0 +1,76 @@ +NAME + gcloud alpha container bare-metal node-pools enroll - enroll a node pool of + a user cluster in Anthos on bare metal + +SYNOPSIS + gcloud alpha container bare-metal node-pools enroll + (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--async] + [--validate-only] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Enroll a node pool of a user cluster in Anthos on bare metal. + +EXAMPLES + To enroll a node pool named my-node-pool in a cluster named my-cluster + managed in location us-west1, run: + + $ gcloud alpha container bare-metal node-pools enroll my-node-pool \ + --cluster=my-cluster --location=us-west1 + +POSITIONAL ARGUMENTS + Node pool resource - node pool to enroll 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 node_pool 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. + + NODE_POOL + ID of the node_pool or fully qualified identifier for the node_pool. + To set the node_pool attribute: + ▸ provide the argument node_pool on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --cluster=CLUSTER + cluster of the node_pool. To set the cluster attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --cluster on the command line. + + --location=LOCATION + Google Cloud location for the node_pool. To set the location + attribute: + ▸ provide the argument node_pool on the command line with a fully + specified name; + ▸ provide the argument --location on the command line; + ▸ set the property container_bare_metal/location. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --validate-only + If set, only validate the request, but do not actually perform the + operation. + +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/container/bare-metal/node-pools/help b/gcloud/alpha/container/bare-metal/node-pools/help index a13a3f1b6..65004aab5 100644 --- a/gcloud/alpha/container/bare-metal/node-pools/help +++ b/gcloud/alpha/container/bare-metal/node-pools/help @@ -25,6 +25,9 @@ COMMANDS describe (ALPHA) Describe a node pool in an Anthos cluster on bare metal. + enroll + (ALPHA) Enroll a node pool of a user cluster in Anthos on bare metal. + list (ALPHA) List node pools in an Anthos cluster on bare metal. diff --git a/gcloud/alpha/container/vmware/clusters/delete b/gcloud/alpha/container/vmware/clusters/delete index 5418b2e2e..75bd8858f 100644 --- a/gcloud/alpha/container/vmware/clusters/delete +++ b/gcloud/alpha/container/vmware/clusters/delete @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha container vmware clusters delete (CLUSTER : --location=LOCATION) [--allow-missing] [--async] [--force] - [--ignore-errors] [GCLOUD_WIDE_FLAG ...] + [--ignore-errors] [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Delete an Anthos cluster on VMware. @@ -60,6 +60,10 @@ FLAGS If set, the deletion of a VMware user cluster resource will succeed even if errors occur during deletion. + --validate-only + If set, only validate the request, but do not actually perform the + operation. + GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, diff --git a/gcloud/alpha/container/vmware/clusters/update b/gcloud/alpha/container/vmware/clusters/update index 2a1f8671f..9942195ef 100644 --- a/gcloud/alpha/container/vmware/clusters/update +++ b/gcloud/alpha/container/vmware/clusters/update @@ -10,7 +10,7 @@ SYNOPSIS [avoid-buggy-ips=AVOID-BUGGY-IPS], [manual-assign=MANUAL-ASSIGN],[pool=POOL]] [--static-ip-config-ip-blocks=[gateway=GATEWAY], - [ips=IPS],[netmask=NETMASK]] [--version=VERSION] + [ips=IPS],[netmask=NETMASK]] [--validate-only] [--version=VERSION] [--add-annotations=[KEY1=VALUE1,KEY2=VALUE2,...] | --remove-annotations=[KEY1,KEY2,...]] [--cpus=CPUS --memory=MEMORY --disable-auto-resize @@ -117,6 +117,10 @@ FLAGS Use quote around the flag value to escape semicolon in the terminal. + --validate-only + If set, only validate the request, but do not actually perform the + operation. + --version=VERSION Anthos Cluster on VMware version for the user cluster resource diff --git a/gcloud/alpha/container/vmware/node-pools/create b/gcloud/alpha/container/vmware/node-pools/create index 75159a824..552c43a57 100644 --- a/gcloud/alpha/container/vmware/node-pools/create +++ b/gcloud/alpha/container/vmware/node-pools/create @@ -10,6 +10,7 @@ SYNOPSIS --node-labels=[KEY=VALUE,...] --node-taints=[KEY=VALUE:EFFECT,...] --replicas=REPLICAS) [--annotations=[KEY=VALUE,...]] [--async] [--display-name=DISPLAY_NAME] + [--validate-only] [--max-replicas=MAX_REPLICAS --min-replicas=MIN_REPLICAS] [GCLOUD_WIDE_FLAG ...] @@ -110,6 +111,10 @@ OPTIONAL FLAGS --display-name=DISPLAY_NAME Display name for the resource. + --validate-only + If set, only validate the request, but do not actually perform the + operation. + Node pool autoscaling --max-replicas=MAX_REPLICAS diff --git a/gcloud/alpha/container/vmware/node-pools/delete b/gcloud/alpha/container/vmware/node-pools/delete index c87257d24..f515ac4e0 100644 --- a/gcloud/alpha/container/vmware/node-pools/delete +++ b/gcloud/alpha/container/vmware/node-pools/delete @@ -5,7 +5,7 @@ NAME SYNOPSIS gcloud alpha container vmware node-pools delete (NODE_POOL : --cluster=CLUSTER --location=LOCATION) [--allow-missing] - [--async] [--ignore-errors] [GCLOUD_WIDE_FLAG ...] + [--async] [--ignore-errors] [--validate-only] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Delete a node pool in an Anthos cluster on VMware. @@ -64,6 +64,10 @@ FLAGS If set, the deletion of a VMware node pool resource will succeed even if errors occur during deletion. + --validate-only + If set, only validate the request, but do not actually perform the + operation. + 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/database-migration/connection-profiles/create/mysql b/gcloud/alpha/database-migration/connection-profiles/create/mysql index 4388b149e..d2b005bdc 100644 --- a/gcloud/alpha/database-migration/connection-profiles/create/mysql +++ b/gcloud/alpha/database-migration/connection-profiles/create/mysql @@ -4,13 +4,13 @@ NAME SYNOPSIS gcloud alpha database-migration connection-profiles create mysql - (CONNECTION_PROFILE : --region=REGION) --host=HOST --port=PORT - --username=USERNAME (--password=PASSWORD | --prompt-for-password) - [--no-async] [--display-name=DISPLAY_NAME] [--instance=INSTANCE] + (CONNECTION_PROFILE : --region=REGION) [--no-async] + [--display-name=DISPLAY_NAME] [--instance=INSTANCE] [--labels=[KEY=VALUE,...]] [--provider=PROVIDER] [--ca-certificate=CA_CERTIFICATE : --certificate=CERTIFICATE --private-key=PRIVATE_KEY] - [GCLOUD_WIDE_FLAG ...] + [--host=HOST --port=PORT --username=USERNAME (--password=PASSWORD + | --prompt-for-password)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a Database Migration Service connection profile for MySQL. @@ -56,29 +56,7 @@ POSITIONAL ARGUMENTS a fully specified name; ▸ provide the argument --region on the command line. -REQUIRED FLAGS - --host=HOST - IP or hostname of the source database. - - --port=PORT - Network port of the source database. - - --username=USERNAME - Username that Database Migration Service uses to connect to the - database. Database Migration Service encrypts the value when storing - it. - - Exactly one of these must be specified: - - --password=PASSWORD - Password for the user that Database Migration Service uses to connect - to the source database. Database Migration Service encrypts the value - when storing it, and the field is not returned on request. - - --prompt-for-password - Prompt for the password used to connect to the database. - -OPTIONAL FLAGS +FLAGS --no-async Waits for the operation in progress to complete before returning. @@ -118,6 +96,27 @@ OPTIONAL FLAGS the Client Certificate. Database Migration Service encrypts the value when storing it. + --host=HOST + IP or hostname of the source database. + + --port=PORT + Network port of the source database. + + --username=USERNAME + Username that Database Migration Service uses to connect to the + database. Database Migration Service encrypts the value when storing + it. + + Exactly one of these must be specified: + + --password=PASSWORD + Password for the user that Database Migration Service uses to connect + to the source database. Database Migration Service encrypts the value + when storing it, and the field is not returned on request. + + --prompt-for-password + Prompt for the password used to connect to the database. + 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/functions/add-iam-policy-binding b/gcloud/alpha/functions/add-iam-policy-binding index ff1f02cb0..c335f80f5 100644 --- a/gcloud/alpha/functions/add-iam-policy-binding +++ b/gcloud/alpha/functions/add-iam-policy-binding @@ -69,9 +69,11 @@ REQUIRED FLAGS OPTIONAL FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/functions/call b/gcloud/alpha/functions/call index 98cb8ac86..7349327c5 100644 --- a/gcloud/alpha/functions/call +++ b/gcloud/alpha/functions/call @@ -54,9 +54,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. At most one of these can be specified: diff --git a/gcloud/alpha/functions/delete b/gcloud/alpha/functions/delete index bd70d3361..b1c830dd8 100644 --- a/gcloud/alpha/functions/delete +++ b/gcloud/alpha/functions/delete @@ -40,9 +40,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/functions/deploy b/gcloud/alpha/functions/deploy index 36fb57fc7..69056b6a5 100644 --- a/gcloud/alpha/functions/deploy +++ b/gcloud/alpha/functions/deploy @@ -130,9 +130,9 @@ FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. --ignore-file=IGNORE_FILE Override the .gcloudignore file and use the specified file instead. diff --git a/gcloud/alpha/functions/describe b/gcloud/alpha/functions/describe index abd4b95eb..2a3819f7f 100644 --- a/gcloud/alpha/functions/describe +++ b/gcloud/alpha/functions/describe @@ -41,9 +41,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/functions/event-types/list b/gcloud/alpha/functions/event-types/list index 3d2f18522..7bcfa307c 100644 --- a/gcloud/alpha/functions/event-types/list +++ b/gcloud/alpha/functions/event-types/list @@ -19,9 +19,9 @@ DESCRIPTION FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/functions/get-iam-policy b/gcloud/alpha/functions/get-iam-policy index 725254b46..1586f9d52 100644 --- a/gcloud/alpha/functions/get-iam-policy +++ b/gcloud/alpha/functions/get-iam-policy @@ -47,9 +47,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/functions/logs/read b/gcloud/alpha/functions/logs/read index 7fab12b25..32be4c312 100644 --- a/gcloud/alpha/functions/logs/read +++ b/gcloud/alpha/functions/logs/read @@ -30,9 +30,11 @@ FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. --limit=LIMIT; default=20 Number of log entries to be fetched; must not be greater than 1000. diff --git a/gcloud/alpha/functions/regions/list b/gcloud/alpha/functions/regions/list index 3a54d28d1..2f6e67361 100644 --- a/gcloud/alpha/functions/regions/list +++ b/gcloud/alpha/functions/regions/list @@ -13,9 +13,9 @@ DESCRIPTION FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/alpha/functions/remove-iam-policy-binding b/gcloud/alpha/functions/remove-iam-policy-binding index b7bc0cfa6..c9baf66cf 100644 --- a/gcloud/alpha/functions/remove-iam-policy-binding +++ b/gcloud/alpha/functions/remove-iam-policy-binding @@ -70,9 +70,11 @@ REQUIRED FLAGS OPTIONAL FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/functions/set-iam-policy b/gcloud/alpha/functions/set-iam-policy index 84796ac9d..086d59ed9 100644 --- a/gcloud/alpha/functions/set-iam-policy +++ b/gcloud/alpha/functions/set-iam-policy @@ -50,9 +50,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/alpha/iam/workforce-pools/providers/help b/gcloud/alpha/iam/workforce-pools/providers/help index cafb69382..d22364db6 100644 --- a/gcloud/alpha/iam/workforce-pools/providers/help +++ b/gcloud/alpha/iam/workforce-pools/providers/help @@ -18,6 +18,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + keys + (ALPHA) Create and manage IAM workforce pool provider keys. + operations (ALPHA) Manage IAM workforce pool provider long-running operations. diff --git a/gcloud/alpha/iam/workforce-pools/providers/keys/create b/gcloud/alpha/iam/workforce-pools/providers/keys/create new file mode 100644 index 000000000..f80fb0c42 --- /dev/null +++ b/gcloud/alpha/iam/workforce-pools/providers/keys/create @@ -0,0 +1,103 @@ +NAME + gcloud alpha iam workforce-pools providers keys create - create a new + workforce pool provider key + +SYNOPSIS + gcloud alpha iam workforce-pools providers keys create + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) --spec=SPEC + --use=USE [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Create a new workforce pool provider key. + +EXAMPLES + The following command creates a workforce pool provider key with the ID + my-key. Explicit values for all required and optional parameters are + provided. + + $ gcloud alpha iam workforce-pools providers keys create my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" --use="ENCRYPTION" --spec="RSA_4096" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + create. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool on the command line. + +REQUIRED FLAGS + --spec=SPEC + The specifications for the key. SPEC must be one of: + key-spec-unspecified, rsa-2048, rsa-3072, rsa-4096. + + --use=USE + The purpose of the key. USE must be one of: encryption, + key-use-unspecified. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud iam workforce-pools providers keys create + + $ gcloud beta iam workforce-pools providers keys create + diff --git a/gcloud/alpha/iam/workforce-pools/providers/keys/delete b/gcloud/alpha/iam/workforce-pools/providers/keys/delete new file mode 100644 index 000000000..6ffacc8d0 --- /dev/null +++ b/gcloud/alpha/iam/workforce-pools/providers/keys/delete @@ -0,0 +1,93 @@ +NAME + gcloud alpha iam workforce-pools providers keys delete - delete a workforce + pool provider key + +SYNOPSIS + gcloud alpha iam workforce-pools providers keys delete + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete a workforce pool provider key. + +EXAMPLES + The following command deletes a workforce pool provider key with the ID + my-key. + + $ gcloud alpha iam workforce-pools providers keys delete my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + delete. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud iam workforce-pools providers keys delete + + $ gcloud beta iam workforce-pools providers keys delete + diff --git a/gcloud/alpha/iam/workforce-pools/providers/keys/describe b/gcloud/alpha/iam/workforce-pools/providers/keys/describe new file mode 100644 index 000000000..bd21ddd60 --- /dev/null +++ b/gcloud/alpha/iam/workforce-pools/providers/keys/describe @@ -0,0 +1,88 @@ +NAME + gcloud alpha iam workforce-pools providers keys describe - describe a + workforce pool provider key + +SYNOPSIS + gcloud alpha iam workforce-pools providers keys describe + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a workforce pool provider key. + +EXAMPLES + The following command describes a workforce pool provider key with the ID + my-key. + + $ gcloud alpha iam workforce-pools providers keys describe my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + describe. The arguments in this group can be used to specify the + attributes of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud iam workforce-pools providers keys describe + + $ gcloud beta iam workforce-pools providers keys describe + diff --git a/gcloud/alpha/iam/workforce-pools/providers/keys/help b/gcloud/alpha/iam/workforce-pools/providers/keys/help new file mode 100644 index 000000000..165d8fd7b --- /dev/null +++ b/gcloud/alpha/iam/workforce-pools/providers/keys/help @@ -0,0 +1,51 @@ +NAME + gcloud alpha iam workforce-pools providers keys - create and manage IAM + workforce pool provider keys + +SYNOPSIS + gcloud alpha iam workforce-pools providers keys GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) The gcloud alpha iam workforce-pools providers keys group lets you + create and manage IAM workforce pool provider keys. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + operations + (ALPHA) Manage IAM workforce pool provider key long-running operations. + +COMMANDS + COMMAND is one of the following: + + create + (ALPHA) Create a new workforce pool provider key. + + delete + (ALPHA) Delete a workforce pool provider key. + + describe + (ALPHA) Describe a workforce pool provider key. + + list + (ALPHA) List workforce pool provider keys. + + undelete + (ALPHA) Undelete a workforce pool provider key. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud iam workforce-pools providers keys + + $ gcloud beta iam workforce-pools providers keys + diff --git a/gcloud/alpha/iam/workforce-pools/providers/keys/list b/gcloud/alpha/iam/workforce-pools/providers/keys/list new file mode 100644 index 000000000..b8b74844a --- /dev/null +++ b/gcloud/alpha/iam/workforce-pools/providers/keys/list @@ -0,0 +1,107 @@ +NAME + gcloud alpha iam workforce-pools providers keys list - list workforce pool + provider keys + +SYNOPSIS + gcloud alpha iam workforce-pools providers keys list + (--provider=PROVIDER + : --location=LOCATION --workforce-pool=WORKFORCE_POOL) + [--show-deleted] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List workforce pool provider keys. + +EXAMPLES + The following command lists the keys in the workforce pool provider with ID + my-provider, including soft-deleted keys: + + $ gcloud alpha iam workforce-pools providers keys list \ + --workforce-pool="my-workforce-pool" --provider="my-provider" \ + --location="global" --show-deleted + +REQUIRED FLAGS + Workforce pool provider resource - The parent workforce pool provider of + the keys to list. The arguments in this group can be used to specify the + attributes of this resource. + + This must be specified. + + --provider=PROVIDER + ID of the workforce pool provider or fully qualified identifier for + the workforce pool provider. To set the provider attribute: + ▸ provide the argument --provider 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 for the workforce pool. To set the location attribute: + ▸ provide the argument --provider on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument --provider on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool on the command line. + +FLAGS + --show-deleted + Show soft-deleted keys by specifying this flag. + +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. + +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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud iam workforce-pools providers keys list + + $ gcloud beta iam workforce-pools providers keys list + diff --git a/gcloud/alpha/iam/workforce-pools/providers/keys/operations/describe b/gcloud/alpha/iam/workforce-pools/providers/keys/operations/describe new file mode 100644 index 000000000..ccfa4c492 --- /dev/null +++ b/gcloud/alpha/iam/workforce-pools/providers/keys/operations/describe @@ -0,0 +1,100 @@ +NAME + gcloud alpha iam workforce-pools providers keys operations describe - + describe a workforce pool provider key operation + +SYNOPSIS + gcloud alpha iam workforce-pools providers keys operations describe + (OPERATION : --key=KEY --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Describe a workforce pool provider key operation. + +EXAMPLES + To describe the long-running workforce pool provider key operation with the + ID my-operation, run: + + $ gcloud alpha iam workforce-pools providers keys operations \ + describe my-operation --workforce-pool="my-workforce-pool" \ + --provider="my-provider" --key="my-key" --location="global" + +POSITIONAL ARGUMENTS + Workforce pool provider key operation resource - The workforce pool + provider key long-running operation to describe. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + OPERATION + ID of the workforce pool provider key operation or fully qualified + identifier for the workforce pool provider key operation. To set the + operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --key=KEY + The ID for the key, which becomes the final component of the resource + name. This value must be 4-32 characters, and may contain the + characters [a-z0-9-]. The prefix gcp- is reserved for use by Google, + and may not be specified. + + To set the key attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --key on the command line. + + --location=LOCATION + The location for the workforce pool. To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud iam workforce-pools providers keys operations describe + + $ gcloud beta iam workforce-pools providers keys operations describe + diff --git a/gcloud/alpha/iam/workforce-pools/providers/keys/operations/help b/gcloud/alpha/iam/workforce-pools/providers/keys/operations/help new file mode 100644 index 000000000..f98b5159d --- /dev/null +++ b/gcloud/alpha/iam/workforce-pools/providers/keys/operations/help @@ -0,0 +1,33 @@ +NAME + gcloud alpha iam workforce-pools providers keys operations - manage IAM + workforce pool provider key long-running operations + +SYNOPSIS + gcloud alpha iam workforce-pools providers keys operations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Commands for managing IAM workforce pool provider key long-running + operations. + +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 workforce pool provider key operation. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud iam workforce-pools providers keys operations + + $ gcloud beta iam workforce-pools providers keys operations + diff --git a/gcloud/alpha/iam/workforce-pools/providers/keys/undelete b/gcloud/alpha/iam/workforce-pools/providers/keys/undelete new file mode 100644 index 000000000..dd06b99ed --- /dev/null +++ b/gcloud/alpha/iam/workforce-pools/providers/keys/undelete @@ -0,0 +1,93 @@ +NAME + gcloud alpha iam workforce-pools providers keys undelete - undelete a + workforce pool provider key + +SYNOPSIS + gcloud alpha iam workforce-pools providers keys undelete + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Undelete a workforce pool provider key. + +EXAMPLES + The following command undeletes a workforce pool provider key with the ID + my-key. + + $ gcloud alpha iam workforce-pools providers keys undelete my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + undelete. The arguments in this group can be used to specify the + attributes of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. These variants are also available: + + $ gcloud iam workforce-pools providers keys undelete + + $ gcloud beta iam workforce-pools providers keys undelete + diff --git a/gcloud/alpha/iap/oauth-brands/describe b/gcloud/alpha/iap/oauth-brands/describe index de838505d..5e20a076a 100644 --- a/gcloud/alpha/iap/oauth-brands/describe +++ b/gcloud/alpha/iap/oauth-brands/describe @@ -19,9 +19,10 @@ EXAMPLES $ gcloud alpha iap oauth-brands describe NAME --project=PROJECT_ID POSITIONAL ARGUMENTS - Name resource - Name of the Cloud OAuth brand to describe. 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: + Brand resource - Name of the Cloud OAuth brand to describe. 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 name on the command line with a fully specified name; ◆ provide the argument --project on the command line; @@ -30,8 +31,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - brand attribute: + ID of the brand or fully qualified identifier for the brand. To set + the brand attribute: ▸ provide the argument name on the command line. GCLOUD WIDE FLAGS diff --git a/gcloud/alpha/iap/oauth-clients/delete b/gcloud/alpha/iap/oauth-clients/delete index 3d28a5f9a..8f53499d1 100644 --- a/gcloud/alpha/iap/oauth-clients/delete +++ b/gcloud/alpha/iap/oauth-clients/delete @@ -23,7 +23,7 @@ EXAMPLES --project=PROJECT_ID POSITIONAL ARGUMENTS - Name resource - Name of the Cloud IAP OAuth client to delete. The + Proxy client resource - Name of the Cloud IAP OAuth client 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: @@ -35,8 +35,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - identity_aware_proxy_clients attribute: + ID of the proxy client or fully qualified identifier for the proxy + client. To set the identity_aware_proxy_clients attribute: ▸ provide the argument name on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/alpha/iap/oauth-clients/describe b/gcloud/alpha/iap/oauth-clients/describe index fb603de98..713b226da 100644 --- a/gcloud/alpha/iap/oauth-clients/describe +++ b/gcloud/alpha/iap/oauth-clients/describe @@ -20,8 +20,8 @@ EXAMPLES $ gcloud alpha iap oauth-clients describe NAME --brand=BRAND POSITIONAL ARGUMENTS - Name resource - Name of the Cloud IAP OAuth client to describe. The - arguments in this group can be used to specify the attributes of this + Proxy client resource - Name of the Cloud IAP OAuth client 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 name on the command line with a fully specified @@ -32,8 +32,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - identity_aware_proxy_clients attribute: + ID of the proxy client or fully qualified identifier for the proxy + client. To set the identity_aware_proxy_clients attribute: ▸ provide the argument name on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/alpha/iap/oauth-clients/list b/gcloud/alpha/iap/oauth-clients/list index 9b362fee0..433344d7e 100644 --- a/gcloud/alpha/iap/oauth-clients/list +++ b/gcloud/alpha/iap/oauth-clients/list @@ -18,7 +18,7 @@ EXAMPLES $ gcloud alpha iap oauth-clients list BRAND POSITIONAL ARGUMENTS - Name resource - Name of the Cloud OAuth brand to list Cloud IAP OAuth + Brand resource - Name of the Cloud OAuth brand to list Cloud IAP OAuth clients under. 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: @@ -30,8 +30,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - brand attribute: + ID of the brand or fully qualified identifier for the brand. To set + the brand attribute: ▸ provide the argument name on the command line. LIST COMMAND FLAGS diff --git a/gcloud/alpha/iap/oauth-clients/reset-secret b/gcloud/alpha/iap/oauth-clients/reset-secret index 6d67cc622..766086403 100644 --- a/gcloud/alpha/iap/oauth-clients/reset-secret +++ b/gcloud/alpha/iap/oauth-clients/reset-secret @@ -21,10 +21,11 @@ EXAMPLES $ gcloud alpha iap oauth-clients reset-secret NAME --brand=BRAND POSITIONAL ARGUMENTS - Name resource - Name of the Cloud IAP OAuth client whose secret will be - reset. 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: + Proxy client resource - Name of the Cloud IAP OAuth client whose secret + will be reset. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: ◆ provide the argument name on the command line with a fully specified name; ◆ provide the argument --project on the command line; @@ -33,8 +34,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - identity_aware_proxy_clients attribute: + ID of the proxy client or fully qualified identifier for the proxy + client. To set the identity_aware_proxy_clients attribute: ▸ provide the argument name on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/alpha/ml-engine/jobs/submit/training b/gcloud/alpha/ml-engine/jobs/submit/training index 19d689661..82223575b 100644 --- a/gcloud/alpha/ml-engine/jobs/submit/training +++ b/gcloud/alpha/ml-engine/jobs/submit/training @@ -149,7 +149,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -200,7 +200,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -322,7 +322,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. diff --git a/gcloud/alpha/netapp/volumes/snapshots/delete b/gcloud/alpha/netapp/volumes/snapshots/delete index b39e4a644..3bdbcf72f 100644 --- a/gcloud/alpha/netapp/volumes/snapshots/delete +++ b/gcloud/alpha/netapp/volumes/snapshots/delete @@ -4,8 +4,8 @@ NAME SYNOPSIS gcloud alpha netapp volumes snapshots delete - (SNAPSHOT : --location=LOCATION) [--async] [--description=DESCRIPTION] - [--volume=VOLUME] [GCLOUD_WIDE_FLAG ...] + (SNAPSHOT : --location=LOCATION) [--async] [--volume=VOLUME] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Deletes a Cloud NetApp Volume Snapshot. @@ -46,9 +46,6 @@ FLAGS Return immediately, without waiting for the operation in progress to complete. - --description=DESCRIPTION - A description of the Cloud NetApp Snapshot - Volume resource - The Volume to take a Snapshot of. 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: diff --git a/gcloud/alpha/network-security/help b/gcloud/alpha/network-security/help index e5550de90..3cdd1db29 100644 --- a/gcloud/alpha/network-security/help +++ b/gcloud/alpha/network-security/help @@ -27,6 +27,9 @@ GROUPS server-tls-policies (ALPHA) Manage Network Security ServerTlsPolicies. + tls-inspection-policies + (ALPHA) Manage Network Security TLS Inspection Policies. + url-lists (ALPHA) Manage Network Security UrlLists. diff --git a/gcloud/alpha/network-security/tls-inspection-policies/delete b/gcloud/alpha/network-security/tls-inspection-policies/delete new file mode 100644 index 000000000..0d16d2709 --- /dev/null +++ b/gcloud/alpha/network-security/tls-inspection-policies/delete @@ -0,0 +1,72 @@ +NAME + gcloud alpha network-security tls-inspection-policies delete - delete TLS + Inspection Policy + +SYNOPSIS + gcloud alpha network-security tls-inspection-policies delete + (TLS_INSPECTION_POLICY : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Delete the specified TLS Inspection Policy. + +EXAMPLES + To delete a TLS Inspection Policy called 'my-tls-inspection-policy', run: + + $ gcloud alpha network-security tls-inspection-policies delete \ + my-tls-inspection-policy --location=$REGION + +POSITIONAL ARGUMENTS + Tls inspection policy resource - Name of the TLS Inspection Policy you + want to delete. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument tls_inspection_policy on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TLS_INSPECTION_POLICY + ID of the tls inspection policy or fully qualified identifier for the + tls inspection policy. To set the tls_inspection_policy attribute: + ▸ provide the argument tls_inspection_policy 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 tls_inspection_policy 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 networksecurity/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security tls-inspection-policies delete + diff --git a/gcloud/alpha/network-security/tls-inspection-policies/export b/gcloud/alpha/network-security/tls-inspection-policies/export new file mode 100644 index 000000000..17e161329 --- /dev/null +++ b/gcloud/alpha/network-security/tls-inspection-policies/export @@ -0,0 +1,75 @@ +NAME + gcloud alpha network-security tls-inspection-policies export - export TLS + Inspection Policy + +SYNOPSIS + gcloud alpha network-security tls-inspection-policies export + (TLS_INSPECTION_POLICY : --location=LOCATION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Export a TLS Inspection Policy. + +EXAMPLES + To export a TLS Inspection Policy, run: + + $ gcloud alpha network-security tls-inspection-policies export \ + my-tls-inspection-policy \ + --destination=my-tls-inspection-policy.yaml --location=$REGION + +POSITIONAL ARGUMENTS + Tls inspection policy 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 tls_inspection_policy on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TLS_INSPECTION_POLICY + ID of the tls inspection policy or fully qualified identifier for the + tls inspection policy. To set the tls_inspection_policy attribute: + ▸ provide the argument tls_inspection_policy 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 tls_inspection_policy on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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 networksecurity/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security tls-inspection-policies export + diff --git a/gcloud/alpha/network-security/tls-inspection-policies/help b/gcloud/alpha/network-security/tls-inspection-policies/help new file mode 100644 index 000000000..8d41260e6 --- /dev/null +++ b/gcloud/alpha/network-security/tls-inspection-policies/help @@ -0,0 +1,39 @@ +NAME + gcloud alpha network-security tls-inspection-policies - manage Network + Security TLS Inspection Policies + +SYNOPSIS + gcloud alpha network-security tls-inspection-policies COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Manage Network Security TLS Inspection Policies. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (ALPHA) Delete TLS Inspection Policy. + + export + (ALPHA) Export TLS Inspection Policy. + + import + (ALPHA) Import TLS Inspection Policy. + + list + (ALPHA) List TLS Inspection Policies. + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security tls-inspection-policies + diff --git a/gcloud/alpha/network-security/tls-inspection-policies/import b/gcloud/alpha/network-security/tls-inspection-policies/import new file mode 100644 index 000000000..a89ba880d --- /dev/null +++ b/gcloud/alpha/network-security/tls-inspection-policies/import @@ -0,0 +1,80 @@ +NAME + gcloud alpha network-security tls-inspection-policies import - import TLS + Inspection Policy + +SYNOPSIS + gcloud alpha network-security tls-inspection-policies import + (TLS_INSPECTION_POLICY : --location=LOCATION) [--async] + [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) Import a TLS Inspection Policy. + +EXAMPLES + To import a TLS Inspection Policy from a YAML file, run: $ gcloud alpha network-security tls-inspection-policies import \ + my-tls-inspection-policy \ + --source=my-tls-inspection-policy.yaml --location=$REGION + +POSITIONAL ARGUMENTS + Tls inspection policy resource - Name of the TLS Inspection Policy to + import. 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 tls_inspection_policy on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TLS_INSPECTION_POLICY + ID of the tls inspection policy or fully qualified identifier for the + tls inspection policy. To set the tls_inspection_policy attribute: + ▸ provide the argument tls_inspection_policy 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 tls_inspection_policy 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. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +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 networksecurity/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security tls-inspection-policies import + diff --git a/gcloud/alpha/network-security/tls-inspection-policies/list b/gcloud/alpha/network-security/tls-inspection-policies/list new file mode 100644 index 000000000..e46e325d0 --- /dev/null +++ b/gcloud/alpha/network-security/tls-inspection-policies/list @@ -0,0 +1,87 @@ +NAME + gcloud alpha network-security tls-inspection-policies list - list TLS + Inspection Policies + +SYNOPSIS + gcloud alpha network-security tls-inspection-policies list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (ALPHA) List all TLS Inspection Policies in the specified location of the + current project. + +EXAMPLES + To list TLS Inspection Policies in the current project, run: $ gcloud alpha network-security tls-inspection-policies list \ + --location=$REGION + +REQUIRED FLAGS + Location resource - The project of the TLS Inspection Policies to display. + This represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1alpha1 API. The full documentation + for this API can be found at: https://cloud.google.com/networking + +NOTES + This command is currently in alpha and might change without notice. If this + command fails with API permission errors despite specifying the correct + project, you might be trying to access an API with an invitation-only early + access allowlist. This variant is also available: + + $ gcloud beta network-security tls-inspection-policies list + diff --git a/gcloud/alpha/scc/custom-modules/sha/test b/gcloud/alpha/scc/custom-modules/sha/test index 2d9039a44..9af4e92c7 100644 --- a/gcloud/alpha/scc/custom-modules/sha/test +++ b/gcloud/alpha/scc/custom-modules/sha/test @@ -6,7 +6,7 @@ SYNOPSIS gcloud alpha scc custom-modules sha test CUSTOM_MODULE --test-data-from-file=TEST_DATA_FROM_FILE [--custom-config-from-file=CUSTOM_CONFIG_FROM_FILE] - [--display-name=DISPLAY_NAME] [--enablement-state=ENABLEMENT_STATE] + [--display-name=DISPLAY_NAME] [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -19,58 +19,49 @@ EXAMPLES $ gcloud alpha scc custom-modules sha test 123456 \ --organization=organizations/123 \ - --display-name="test_display_name"--enablement-state="ENABLED" \ - --custom-config-from-file=/tmp/custom_config.yaml \ - --test-data-from-file=/tmp/test_data.yaml + --display-name="test_display_name"--custom-config-from-file=/\ + tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml $ gcloud alpha scc custom-modules sha test 123456 \ --organization=123 \ - --display-name="test_display_name"--enablement-state="ENABLED" \ - --custom-config-from-file=/tmp/custom_config.yaml \ - --test-data-from-file=/tmp/test_data.yaml + --display-name="test_display_name"--custom-config-from-file=/\ + tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml $ gcloud alpha scc custom-modules sha test \ organizations/123/securityHealthAnalyticsSettings/\ customModules/123456 \ - --display-name="test_display_name"--enablement-state="ENABLED" \ - --custom-config-from-file=/tmp/custom_config.yaml \ - --test-data-from-file=/tmp/test_data.yaml + --display-name="test_display_name"--custom-config-from-file=/\ + tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml To test a Security Health Analytics custom module with id 123456 for folder 456, run: $ gcloud alpha scc custom-modules sha test 123456 \ --folder=folders/456 \ - --display-name="test_display_name"--enablement-state="ENABLED" \ - --custom-config-from-file=/tmp/custom_config.yaml \ - --test-data-from-file=/tmp/test_data.yaml + --display-name="test_display_name"--custom-config-from-file=/\ + tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml $ gcloud alpha scc custom-modules sha test 123456 --folder=456 \ - --display-name="test_display_name"--enablement-state="ENABLED" \ - --custom-config-from-file=/tmp/custom_config.yaml \ - --test-data-from-file=/tmp/test_data.yaml + --display-name="test_display_name"--custom-config-from-file=/\ + tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml $ gcloud alpha scc custom-modules sha test \ folders/456/securityHealthAnalyticsSettings/customModules/\ 123456 \ - --display-name="test_display_name"--enablement-state="ENABLED" \ - --custom-config-from-file=/tmp/custom_config.yaml \ - --test-data-from-file=/tmp/test_data.yaml + --display-name="test_display_name"--custom-config-from-file=/\ + tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml To test a Security Health Analytics custom module with id 123456 for project 789, run: $ gcloud alpha scc custom-modules sha test 123456 \ --project=projects/789 \ - --display-name="test_display_name"--enablement-state="ENABLED" \ - --custom-config-from-file=/tmp/custom_config.yaml \ - --test-data-from-file=/tmp/test_data.yaml + --display-name="test_display_name"--custom-config-from-file=/\ + tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml $ gcloud alpha scc custom-modules sha test 123456 --project=789 \ - --display-name="test_display_name"--enablement-state="ENABLED" \ - --custom-config-from-file=/tmp/custom_config.yaml \ - --test-data-from-file=/tmp/test_data.yaml + --display-name="test_display_name"--custom-config-from-file=/\ + tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml $ gcloud alpha scc custom-modules sha test \ projects/789/securityHealthAnalyticsSettings/customModules/\ 123456 \ - --display-name="test_display_name"--enablement-state="ENABLED" \ - --custom-config-from-file=/tmp/custom_config.yaml \ - --test-data-from-file=/tmp/test_data.yaml + --display-name="test_display_name"--custom-config-from-file=/\ + tmp/custom_config.yaml --test-data-from-file=/tmp/test_data.yaml POSITIONAL ARGUMENTS CUSTOM_MODULE @@ -79,22 +70,19 @@ POSITIONAL ARGUMENTS REQUIRED FLAGS --test-data-from-file=TEST_DATA_FROM_FILE - Path to a yaml file containing the resource data to test the Security + Path to a YAML file containing the resource data to test the Security Health Analytics custom module against. OPTIONAL FLAGS --custom-config-from-file=CUSTOM_CONFIG_FROM_FILE - Path to a yaml file containing the custom configuration for the - Security Health Analytics custom module. + Path to a YAML file containing the custom configuration for the + Security Health Analytics custom module. If not specified, the existing + module with the given ID or resource name is used. --display-name=DISPLAY_NAME - The text that will be used to represent a Security Health Analytics - custom module display name. Display name must be at most 64 characters. - - --enablement-state=ENABLEMENT_STATE - The enablement state of the Security Health Analytics custom module. - ENABLEMENT_STATE must be one of: disabled, enabled, - enablement-state-unspecified, inherited. + Display name of the Security Health Analytics custom module. Display + name must be at most 64 characters. Only relevant when + --custom-config-from-file is also specified. At most one of these can be specified: diff --git a/gcloud/alpha/scc/custom-modules/sha/update b/gcloud/alpha/scc/custom-modules/sha/update index 59bc039c6..d1427dd76 100644 --- a/gcloud/alpha/scc/custom-modules/sha/update +++ b/gcloud/alpha/scc/custom-modules/sha/update @@ -5,8 +5,7 @@ NAME SYNOPSIS gcloud alpha scc custom-modules sha update CUSTOM_MODULE [--custom-config-from-file=CUSTOM_CONFIG_FROM_FILE] - [--display-name=DISPLAY_NAME] [--enablement-state=ENABLEMENT_STATE] - [--update-mask=UPDATE_MASK] + [--enablement-state=ENABLEMENT_STATE] [--update-mask=UPDATE_MASK] [--folder=FOLDER | --organization=ORGANIZATION | --project=PROJECT] [GCLOUD_WIDE_FLAG ...] @@ -18,52 +17,42 @@ EXAMPLES organization 123, run: $ gcloud alpha scc custom-modules sha update 123456 \ - --organization=organizations/123 \ - --display-name="test_display_name" \ - --enablement-state="ENABLED" \ + --organization=organizations/123 --enablement-state="ENABLED" \ --custom-config-from-file=custom_config.yaml $ gcloud alpha scc custom-modules sha update 123456 \ - --organization=123 --display-name="test_display_name" \ - --enablement-state="ENABLED" \ + --organization=123 --enablement-state="ENABLED" \ --custom-config-from-file=custom_config.yaml $ gcloud alpha scc custom-modules sha update \ organizations/123/securityHealthAnalyticsSettings/\ - customModules/123456 --display-name="test_display_name" \ - --enablement-state="ENABLED" \ + customModules/123456 --enablement-state="ENABLED" \ --custom-config-from-file=custom_config.yaml To update a Security Health Analytics custom module with id 123456 for folder 456, run: $ gcloud alpha scc custom-modules sha update 123456 \ - --folder=folders/456 --display-name="test_display_name" \ - --enablement-state="ENABLED" \ + --folder=folders/456 --enablement-state="ENABLED" \ --custom-config-from-file=custom_config.yaml $ gcloud alpha scc custom-modules sha update 123456 --folder=456 \ - --display-name="test_display_name" \ --enablement-state="ENABLED" \ --custom-config-from-file=custom_config.yaml $ gcloud alpha scc custom-modules sha update \ folders/456/securityHealthAnalyticsSettings/customModules/\ - 123456 --display-name="test_display_name" \ - --enablement-state="ENABLED" \ + 123456 --enablement-state="ENABLED" \ --custom-config-from-file=custom_config.yaml To update a Security Health Analytics custom module with id 123456 for project 789, run: $ gcloud alpha scc custom-modules sha update 123456 \ - --project=projects/789 --display-name="test_display_name" \ - --enablement-state="ENABLED" \ + --project=projects/789 --enablement-state="ENABLED" \ --custom-config-from-file=custom_config.yaml $ gcloud alpha scc custom-modules sha update 123456 --project=789 \ - --display-name="test_display_name" \ --enablement-state="ENABLED" \ --custom-config-from-file=custom_config.yaml $ gcloud alpha scc custom-modules sha update \ projects/789/securityHealthAnalyticsSettings/customModules/\ - 123456 --display-name="test_display_name" \ - --enablement-state="ENABLED" \ + 123456 --enablement-state="ENABLED" \ --custom-config-from-file=custom_config.yaml POSITIONAL ARGUMENTS @@ -76,10 +65,6 @@ FLAGS Path to a yaml file containing the custom configuration for the Security Health Analytics custom module. - --display-name=DISPLAY_NAME - The text that will be used to represent a Security Health Analytics - custom module display name. Display name must be at most 64 characters - --enablement-state=ENABLEMENT_STATE The enablement state of the Security Health Analytics custom module. ENABLEMENT_STATE must be one of: disabled, enabled, diff --git a/gcloud/alpha/storage/buckets/update b/gcloud/alpha/storage/buckets/update index 672c5c547..6d403facb 100644 --- a/gcloud/alpha/storage/buckets/update +++ b/gcloud/alpha/storage/buckets/update @@ -163,8 +163,8 @@ FLAGS } ] - For more information about supported endpoints for CORS, see [Cloud - Storage CORS support] + For more information about supported endpoints for CORS, see Cloud + Storage CORS support (https://cloud.google.com/storage/docs/cross-origin#server-side-support). At most one of these can be specified: @@ -246,11 +246,10 @@ FLAGS Unsets the public access prevention setting on a bucket. --[no-]pap, --[no-]public-access-prevention - If True, sets public access prevention to "enforced". If False, sets - public access prevention to "inherited". For details on how exactly - public access is blocked, see: - http://cloud.google.com/storage/docs/public-access-prevention. Use - --public-access-prevention to enable and + If True, sets public access prevention + (https://cloud.google.com/storage/docs/public-access-prevention) to + "enforced". If False, sets public access prevention to "inherited". + Use --public-access-prevention to enable and --no-public-access-prevention to disable. At most one of these can be specified: diff --git a/gcloud/alpha/workstations/configs/create b/gcloud/alpha/workstations/configs/create index e05136916..f87b2c2ea 100644 --- a/gcloud/alpha/workstations/configs/create +++ b/gcloud/alpha/workstations/configs/create @@ -24,7 +24,9 @@ SYNOPSIS [--shielded-secure-boot] [--shielded-vtpm] [--container-custom-image=CONTAINER_CUSTOM_IMAGE | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE; - default="codeoss"] [GCLOUD_WIDE_FLAG ...] + default="codeoss"] + [--kms-key=KMS_KEY : --kms-key-service-account=KMS_KEY_SERVICE_ACCOUNT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (ALPHA) Create a workstation configuration. @@ -224,6 +226,19 @@ FLAGS webstorm WebStorm + Encryption key settings + + --kms-key=KMS_KEY + The customer-managed encryption key to use for this config. If not + specified, a Google-managed encryption key is used. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --kms-key-service-account=KMS_KEY_SERVICE_ACCOUNT + The service account associated with the provided customer-managed + encryption key. + 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/ai-platform/jobs/submit/training b/gcloud/beta/ai-platform/jobs/submit/training index eaf8f3d0c..7c09018f6 100644 --- a/gcloud/beta/ai-platform/jobs/submit/training +++ b/gcloud/beta/ai-platform/jobs/submit/training @@ -149,7 +149,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -200,7 +200,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -322,7 +322,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. diff --git a/gcloud/beta/ai/endpoints/create b/gcloud/beta/ai/endpoints/create index cdf11b153..96f3e8be8 100644 --- a/gcloud/beta/ai/endpoints/create +++ b/gcloud/beta/ai/endpoints/create @@ -73,6 +73,11 @@ OPTIONAL FLAGS --request-response-logging-table=REQUEST_RESPONSE_LOGGING_TABLE BigQuery table uri for prediction request & response logging. + You can provide table uri that does not exist, it will be created for + you. + + Value should be provided in format: bq://PROJECT_ID/DATASET/TABLE + 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/ai/endpoints/update b/gcloud/beta/ai/endpoints/update index 0f39128a3..ab97b6354 100644 --- a/gcloud/beta/ai/endpoints/update +++ b/gcloud/beta/ai/endpoints/update @@ -103,6 +103,11 @@ FLAGS --request-response-logging-table=REQUEST_RESPONSE_LOGGING_TABLE BigQuery table uri for prediction request & response logging. + You can provide table uri that does not exist, it will be created for + you. + + Value should be provided in format: bq://PROJECT_ID/DATASET/TABLE + 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/artifacts/docker/help b/gcloud/beta/artifacts/docker/help index 987d0d372..5031cf9dd 100644 --- a/gcloud/beta/artifacts/docker/help +++ b/gcloud/beta/artifacts/docker/help @@ -48,6 +48,10 @@ GROUPS tags (BETA) Manage Artifact Registry container image tags. + upgrade + (BETA) Commands to support Container Registry to Artifact Registry + upgrade. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/artifacts/docker/upgrade/help b/gcloud/beta/artifacts/docker/upgrade/help new file mode 100644 index 000000000..a6064a846 --- /dev/null +++ b/gcloud/beta/artifacts/docker/upgrade/help @@ -0,0 +1,29 @@ +NAME + gcloud beta artifacts docker upgrade - commands to support Container + Registry to Artifact Registry upgrade + +SYNOPSIS + gcloud beta artifacts docker upgrade COMMAND [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) To print an equivalant Artifact Registry IAM policy for + 'gcr.io/my-project' within scope projects/my-project: + + $ gcloud beta artifacts docker upgrade print-iam-policy gcr.io \ + --project=my-project + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + print-iam-policy + (BETA) Print an Artifact Registry IAM policy for Container Registry to + Artifact Registry upgrade. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/artifacts/docker/upgrade/print-iam-policy b/gcloud/beta/artifacts/docker/upgrade/print-iam-policy new file mode 100644 index 000000000..65a9114df --- /dev/null +++ b/gcloud/beta/artifacts/docker/upgrade/print-iam-policy @@ -0,0 +1,64 @@ +NAME + gcloud beta artifacts docker upgrade print-iam-policy - print an Artifact + Registry IAM policy for Container Registry to Artifact Registry upgrade + +SYNOPSIS + gcloud beta artifacts docker upgrade print-iam-policy DOMAIN + [--folder=FOLDER_ID | --organization=ORGANIZATION_ID] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Print an Artifact Registry IAM policy that is equivalent to the IAM + policy applied to the storage bucket for the specified Container Registry + hostname. Apply the returned policy to the Artifact Registry repository + that will replace the specified host. By default, this command only + considers IAM policies within the project-level scope, so policies that are + at the folder or organization level will not be included in the generated + policy. To change the scope, use the --organization or --folder flags. + +EXAMPLES + To print an equivalant Artifact Registry IAM policy for 'gcr.io/my-project' + within scope projects/my-project: + + $ gcloud beta artifacts docker upgrade print-iam-policy upgrade \ + print-iam-policy gcr.io --project=my-project + + To print an equivalant Artifact Registry IAM policy for 'gcr.io/my-project' + within scope folders/123: + + $ gcloud beta artifacts docker upgrade print-iam-policy upgrade \ + print-iam-policy gcr.io --project=my-project --folder=123 + + To print an equivalant Artifact Registry IAM policy for 'gcr.io/my-project' + within scope organizations/123: + + $ gcloud beta artifacts docker upgrade print-iam-policy upgrade \ + print-iam-policy gcr.io --project=my-project --organization=123 + +POSITIONAL ARGUMENTS + DOMAIN + A Container Registry domain. Valid values are: [gcr.io, asia.gcr.io, + eu.gcr.io, us.gcr.io] + +FLAGS + At most one of these can be specified: + + --folder=FOLDER_ID + Folder ID on which to scope IAM analysis. Only policies defined at or + below this folder will be included in the analysis. + + --organization=ORGANIZATION_ID + Organization ID on which to scope IAM analysis. Only policies defined + at or below this organization will be included in the analysis. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +NOTES + This command is currently in beta and might change without notice. + diff --git a/gcloud/beta/beyondcorp/app/connections/create b/gcloud/beta/beyondcorp/app/connections/create index 358fa1ea3..d441a8747 100644 --- a/gcloud/beta/beyondcorp/app/connections/create +++ b/gcloud/beta/beyondcorp/app/connections/create @@ -33,10 +33,11 @@ EXAMPLES --display-name=connection-display-name --async POSITIONAL ARGUMENTS - Connection resource - The Beyondcorp application connection you want to - create. The arguments in this group can be used to specify the attributes - of this resource. (NOTE) Some attributes are not given arguments in this - group but can be set in other ways. To set the project attribute: + App connection resource - The Beyondcorp application connection you want + to create. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: ◆ provide the argument connection on the command line with a fully specified name; ◆ set the property core/project; @@ -45,7 +46,7 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTION - ID of the connection or fully qualified identifier for the + ID of the app connection or fully qualified identifier for the app connection. To set the app_connection attribute: ▸ provide the argument connection on the command line. diff --git a/gcloud/beta/beyondcorp/app/connections/delete b/gcloud/beta/beyondcorp/app/connections/delete index d15392c50..4eb2c03a7 100644 --- a/gcloud/beta/beyondcorp/app/connections/delete +++ b/gcloud/beta/beyondcorp/app/connections/delete @@ -15,8 +15,8 @@ EXAMPLES --project={project} --location={location} POSITIONAL ARGUMENTS - Connection resource - The Beyondcorp connection you want to delete. The - arguments in this group can be used to specify the attributes of this + App connection resource - The Beyondcorp connection you want to delete. + The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument connection on the command line with a fully @@ -27,7 +27,7 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTION - ID of the connection or fully qualified identifier for the + ID of the app connection or fully qualified identifier for the app connection. To set the app_connection attribute: ▸ provide the argument connection on the command line. diff --git a/gcloud/beta/beyondcorp/app/connections/describe b/gcloud/beta/beyondcorp/app/connections/describe index d6205ff04..ca81d4b79 100644 --- a/gcloud/beta/beyondcorp/app/connections/describe +++ b/gcloud/beta/beyondcorp/app/connections/describe @@ -25,7 +25,7 @@ EXAMPLES updateTime, labels) POSITIONAL ARGUMENTS - Connection resource - The Beyondcorp connector you want to get details + App connection resource - The Beyondcorp connector you want to get details about. 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: @@ -37,7 +37,7 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTION - ID of the connection or fully qualified identifier for the + ID of the app connection or fully qualified identifier for the app connection. To set the app_connection attribute: ▸ provide the argument connection on the command line. diff --git a/gcloud/beta/beyondcorp/app/connections/update b/gcloud/beta/beyondcorp/app/connections/update index 70f1900d8..b0d05d598 100644 --- a/gcloud/beta/beyondcorp/app/connections/update +++ b/gcloud/beta/beyondcorp/app/connections/update @@ -24,8 +24,8 @@ EXAMPLES --update-labels=k0=value1,k1=value2 --remove-labels=k3 POSITIONAL ARGUMENTS - Connection resource - The Beyondcorp connection you want to update. The - arguments in this group can be used to specify the attributes of this + App connection resource - The Beyondcorp connection you want to update. + The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: ◆ provide the argument connection on the command line with a fully @@ -36,7 +36,7 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTION - ID of the connection or fully qualified identifier for the + ID of the app connection or fully qualified identifier for the app connection. To set the app_connection attribute: ▸ provide the argument connection on the command line. diff --git a/gcloud/beta/beyondcorp/app/connectors/create b/gcloud/beta/beyondcorp/app/connectors/create index cd4c03d02..ad60d1eda 100644 --- a/gcloud/beta/beyondcorp/app/connectors/create +++ b/gcloud/beta/beyondcorp/app/connectors/create @@ -30,7 +30,7 @@ EXAMPLES --async POSITIONAL ARGUMENTS - Connector resource - The Beyondcorp connector you want to create. The + App connector resource - The Beyondcorp connector you want to create. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: @@ -42,8 +42,8 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTOR - ID of the connector or fully qualified identifier for the connector. - To set the app_connector attribute: + ID of the app connector or fully qualified identifier for the app + connector. To set the app_connector attribute: ▸ provide the argument connector on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/beta/beyondcorp/app/connectors/delete b/gcloud/beta/beyondcorp/app/connectors/delete index 0ad66a75c..1e5ec1b23 100644 --- a/gcloud/beta/beyondcorp/app/connectors/delete +++ b/gcloud/beta/beyondcorp/app/connectors/delete @@ -15,7 +15,7 @@ EXAMPLES --project={project} --location={location} POSITIONAL ARGUMENTS - Connector resource - The Beyondcorp connector you want to delete. The + App connector resource - The Beyondcorp connector you want to delete. The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: @@ -27,8 +27,8 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTOR - ID of the connector or fully qualified identifier for the connector. - To set the app_connector attribute: + ID of the app connector or fully qualified identifier for the app + connector. To set the app_connector attribute: ▸ provide the argument connector on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/beta/beyondcorp/app/connectors/describe b/gcloud/beta/beyondcorp/app/connectors/describe index 462e7db64..fe10e2588 100644 --- a/gcloud/beta/beyondcorp/app/connectors/describe +++ b/gcloud/beta/beyondcorp/app/connectors/describe @@ -24,7 +24,7 @@ EXAMPLES principalInfo.serviceAccount.email,createTime,updateTime,labels) POSITIONAL ARGUMENTS - Connector resource - The Beyondcorp connector you want to get details + App connector resource - The Beyondcorp connector you want to get details about. 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: @@ -36,8 +36,8 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTOR - ID of the connector or fully qualified identifier for the connector. - To set the app_connector attribute: + ID of the app connector or fully qualified identifier for the app + connector. To set the app_connector attribute: ▸ provide the argument connector on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/beta/beyondcorp/app/connectors/update b/gcloud/beta/beyondcorp/app/connectors/update index f90d2fc6c..302bed060 100644 --- a/gcloud/beta/beyondcorp/app/connectors/update +++ b/gcloud/beta/beyondcorp/app/connectors/update @@ -21,7 +21,7 @@ EXAMPLES --update-labels=k0=value1,k1=value2 --remove-labels=k3 POSITIONAL ARGUMENTS - Connector resource - The Beyondcorp connector you want to update The + App connector resource - The Beyondcorp connector you want to update The arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute: @@ -33,8 +33,8 @@ POSITIONAL ARGUMENTS This must be specified. CONNECTOR - ID of the connector or fully qualified identifier for the connector. - To set the app_connector attribute: + ID of the app connector or fully qualified identifier for the app + connector. To set the app_connector attribute: ▸ provide the argument connector on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/beta/certificate-manager/help b/gcloud/beta/certificate-manager/help index 3bc345e2e..7ed1723f0 100644 --- a/gcloud/beta/certificate-manager/help +++ b/gcloud/beta/certificate-manager/help @@ -31,6 +31,9 @@ GROUPS operations (BETA) Manage Certificate Manager operations. + trust-configs + (BETA) Manage Certificate Manager trust configs. + NOTES This command is currently in beta and might change without notice. These variants are also available: diff --git a/gcloud/beta/certificate-manager/trust-configs/delete b/gcloud/beta/certificate-manager/trust-configs/delete new file mode 100644 index 000000000..0c62b42af --- /dev/null +++ b/gcloud/beta/certificate-manager/trust-configs/delete @@ -0,0 +1,71 @@ +NAME + gcloud beta certificate-manager trust-configs delete - delete TrustConfig + +SYNOPSIS + gcloud beta certificate-manager trust-configs delete + (TRUST_CONFIG : --location=LOCATION) [--async] [--etag=ETAG] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete the specified TrustConfig. + +EXAMPLES + To delete a TrustConfig called 'my-trust-config', run: + + $ gcloud beta certificate-manager trust-configs delete \ + my-trust-config --location=global + +POSITIONAL ARGUMENTS + TrustConfig resource - Name of the TrustConfig you want to delete. The + arguments in this group can be used to specify the attributes of this + resource. (NOTE) Some attributes are not given arguments in this group but + can be set in other ways. To set the project attribute: + ◆ provide the argument trust_config on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TRUST_CONFIG + ID of the trustConfig or fully qualified identifier for the + trustConfig. To set the trust_config attribute: + ▸ provide the argument trust_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument trust_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --etag=ETAG + The current etag of the asset. If an etag is provided and does not + match the current etag of the asset, the deletion will be blocked. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha certificate-manager trust-configs delete + diff --git a/gcloud/beta/certificate-manager/trust-configs/describe b/gcloud/beta/certificate-manager/trust-configs/describe new file mode 100644 index 000000000..5f53f2b6a --- /dev/null +++ b/gcloud/beta/certificate-manager/trust-configs/describe @@ -0,0 +1,62 @@ +NAME + gcloud beta certificate-manager trust-configs describe - show details about + a TrustConfig + +SYNOPSIS + gcloud beta certificate-manager trust-configs describe + (TRUST_CONFIG : --location=LOCATION) [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Show details about a TrustConfig. + +EXAMPLES + To show details about an existing trust config, run: + + $ gcloud beta certificate-manager trust-configs describe \ + my-trust-config + +POSITIONAL ARGUMENTS + TrustConfig resource - The TrustConfig you want 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 trust_config on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TRUST_CONFIG + ID of the trustConfig or fully qualified identifier for the + trustConfig. To set the trust_config attribute: + ▸ provide the argument trust_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument trust_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha certificate-manager trust-configs describe + diff --git a/gcloud/beta/certificate-manager/trust-configs/export b/gcloud/beta/certificate-manager/trust-configs/export new file mode 100644 index 000000000..89153c0c8 --- /dev/null +++ b/gcloud/beta/certificate-manager/trust-configs/export @@ -0,0 +1,71 @@ +NAME + gcloud beta certificate-manager trust-configs export - export TrustConfig + +SYNOPSIS + gcloud beta certificate-manager trust-configs export + (TRUST_CONFIG : --location=LOCATION) [--destination=DESTINATION] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Export a TrustConfig. + +EXAMPLES + To export a TrustConfig, run: + + $ gcloud beta certificate-manager trust-configs export \ + my-trust-config --destination=my-trust-config.yaml \ + --location=global + +POSITIONAL ARGUMENTS + TrustConfig resource - Name of the TrustConfig to export. 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 trust_config on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TRUST_CONFIG + ID of the trustConfig or fully qualified identifier for the + trustConfig. To set the trust_config attribute: + ▸ provide the argument trust_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument trust_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha certificate-manager trust-configs export + diff --git a/gcloud/beta/certificate-manager/trust-configs/help b/gcloud/beta/certificate-manager/trust-configs/help new file mode 100644 index 000000000..de5de6c8a --- /dev/null +++ b/gcloud/beta/certificate-manager/trust-configs/help @@ -0,0 +1,40 @@ +NAME + gcloud beta certificate-manager trust-configs - manage Certificate Manager + trust configs + +SYNOPSIS + gcloud beta certificate-manager trust-configs COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Certificate Manager trust configs. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (BETA) Delete TrustConfig. + + describe + (BETA) Show details about a TrustConfig. + + export + (BETA) Export TrustConfig. + + import + (BETA) Import TrustConfig. + + list + (BETA) List all TrustConfigs in a project. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha certificate-manager trust-configs + diff --git a/gcloud/beta/certificate-manager/trust-configs/import b/gcloud/beta/certificate-manager/trust-configs/import new file mode 100644 index 000000000..41eceb660 --- /dev/null +++ b/gcloud/beta/certificate-manager/trust-configs/import @@ -0,0 +1,77 @@ +NAME + gcloud beta certificate-manager trust-configs import - import TrustConfig + +SYNOPSIS + gcloud beta certificate-manager trust-configs import + (TRUST_CONFIG : --location=LOCATION) [--async] [--source=SOURCE] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Import a TrustConfig. + +EXAMPLES + To import a TrustConfig from a YAML file, run: + + $ gcloud beta certificate-manager trust-configs import \ + my-trust-config --source=my-trust-config.yaml --location=global + +POSITIONAL ARGUMENTS + TrustConfig resource - Name of the TrustConfig to import. 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 trust_config on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TRUST_CONFIG + ID of the trustConfig or fully qualified identifier for the + trustConfig. To set the trust_config attribute: + ▸ provide the argument trust_config on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --location=LOCATION + Certificate Manager location. To set the location attribute: + ▸ provide the argument trust_config on the command line with a + fully specified name; + ▸ provide the argument --location on the command line; + ▸ default value of location is [global]. + +FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha certificate-manager trust-configs import + diff --git a/gcloud/beta/certificate-manager/trust-configs/list b/gcloud/beta/certificate-manager/trust-configs/list new file mode 100644 index 000000000..d0a4ce818 --- /dev/null +++ b/gcloud/beta/certificate-manager/trust-configs/list @@ -0,0 +1,84 @@ +NAME + gcloud beta certificate-manager trust-configs list - list all TrustConfigs + in a project + +SYNOPSIS + gcloud beta certificate-manager trust-configs list [--location=LOCATION] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [--uri] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List existing TrustConfigs. + +EXAMPLES + To list existing TrustConfigs, run: + + $ gcloud beta certificate-manager trust-configs list + +FLAGS + Location resource - The location (defaults to global) of the resources. + 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; + ◆ default value of location is [global] with a fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + --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; + ▸ default value of location is [global]. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the certificatemanager/v1 API. The full documentation for + this API can be found at: https://cloud.google.com/certificate-manager + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha certificate-manager trust-configs list + diff --git a/gcloud/beta/compute/forwarding-rules/create b/gcloud/beta/compute/forwarding-rules/create index 1819cfd8f..dcf57b6bd 100644 --- a/gcloud/beta/compute/forwarding-rules/create +++ b/gcloud/beta/compute/forwarding-rules/create @@ -288,9 +288,9 @@ OPTIONAL FLAGS address that has the --purpose=SHARED_LOADBALANCER_VIP flag set. --source-ip-ranges=SOURCE_IP_RANGE,[...] - List of comma-separated IP addresses or IP ranges. If not empty, this - Forwarding Rule will only forward the traffic when the source IP - address falls into one of the IP ranges set here. + List of comma-separated IP addresses or IP ranges. If set, this + forwarding rule only forwards traffic when the packet's source IP + address matches one of the IP ranges set here. --subnet=SUBNET (Only for --load-balancing-scheme=INTERNAL and diff --git a/gcloud/beta/compute/forwarding-rules/update b/gcloud/beta/compute/forwarding-rules/update index 7562979dc..5ed775886 100644 --- a/gcloud/beta/compute/forwarding-rules/update +++ b/gcloud/beta/compute/forwarding-rules/update @@ -53,9 +53,9 @@ FLAGS rule's target is a service attachment (--target-service-attachment). --source-ip-ranges=SOURCE_IP_RANGE,[...] - List of comma-separated IP addresses or IP ranges. If not empty, this - Forwarding Rule will only forward the traffic when the source IP - address falls into one of the IP ranges set here. + List of comma-separated IP addresses or IP ranges. If set, this + forwarding rule only forwards traffic when the packet's source IP + address matches one of the IP ranges set here. --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value diff --git a/gcloud/beta/compute/network-endpoint-groups/update b/gcloud/beta/compute/network-endpoint-groups/update index cc4590f73..9baf0207c 100644 --- a/gcloud/beta/compute/network-endpoint-groups/update +++ b/gcloud/beta/compute/network-endpoint-groups/update @@ -51,7 +51,7 @@ REQUIRED FLAGS is deleted, then any network endpoint group that has a reference to it is updated. - *ip* - Optional IP address of the network endpoint. the IP address + *ip* - Optional IP address of the network endpoint. The IP address must belong to a VM in compute engine (either the primary IP or as part of an aliased IP range). If the IP address is not specified, then the primary IP address for the VM instance in @@ -62,7 +62,7 @@ REQUIRED FLAGS internet-ip-port - *ip* - Required IP address of the endpoint to attach. Must be + *ip* - Required IPv4 address of the endpoint to attach. Must be publicly routable. *port* - Optional port of the endpoint to attach. If unspecified, @@ -85,12 +85,13 @@ REQUIRED FLAGS non-gcp-private-ip-port - *ip* - Required IP address of the network endpoint to attach. The - IP address must belong to a VM not in Compute Engine and - must be routable using a Cloud Router over VPN or an Interconnect connection. + *ip* - Required IPv4 address of the network endpoint to attach. + The IP address must belong to a VM not in Compute Engine and must + be routable using a Cloud Router over VPN or an Interconnect + connection. - *port* - Required port of the network endpoint to attach unless the - NEG default port is set. + *port* - Required port of the network endpoint to attach unless + the NEG default port is set. gce-vm-ip @@ -116,14 +117,14 @@ REQUIRED FLAGS detach. If the IP address is unset, all endpoints for the instance in the NEG are detached. - *ip* - Optional IP address of the network endpoint to detach. + *ip* - Optional IPv4 address of the network endpoint to detach. If specified port must be provided as well. *port* - Optional port of the network endpoint to detach. internet-ip-port - *ip* - Required IP address of the network endpoint to detach. + *ip* - Required IPv4 address of the network endpoint to detach. *port* - Optional port of the network endpoint to detach if the endpoint has a port specified. @@ -138,7 +139,7 @@ REQUIRED FLAGS non-gcp-private-ip-port - *ip* - Required IP address of the network endpoint to detach. + *ip* - Required IPv4 address of the network endpoint to detach. *port* - Required port of the network endpoint to detach unless NEG default port is set. diff --git a/gcloud/beta/config/get b/gcloud/beta/config/get index be1212d61..4e75b7b64 100644 --- a/gcloud/beta/config/get +++ b/gcloud/beta/config/get @@ -893,7 +893,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1283,6 +1284,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/beta/config/help b/gcloud/beta/config/help index 56f6613e4..51dfb01dd 100644 --- a/gcloud/beta/config/help +++ b/gcloud/beta/config/help @@ -925,7 +925,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1315,6 +1316,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/beta/config/list b/gcloud/beta/config/list index 085df539a..6f9c73e6f 100644 --- a/gcloud/beta/config/list +++ b/gcloud/beta/config/list @@ -937,7 +937,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1327,6 +1328,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/beta/config/set b/gcloud/beta/config/set index 1d8ee24cb..7f723e4e0 100644 --- a/gcloud/beta/config/set +++ b/gcloud/beta/config/set @@ -940,7 +940,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1330,6 +1331,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/beta/config/unset b/gcloud/beta/config/unset index 120ebec04..264bbb5c6 100644 --- a/gcloud/beta/config/unset +++ b/gcloud/beta/config/unset @@ -901,7 +901,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1291,6 +1292,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/beta/functions/add-iam-policy-binding b/gcloud/beta/functions/add-iam-policy-binding index 3b1bc776f..e73159768 100644 --- a/gcloud/beta/functions/add-iam-policy-binding +++ b/gcloud/beta/functions/add-iam-policy-binding @@ -69,9 +69,11 @@ REQUIRED FLAGS OPTIONAL FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/functions/call b/gcloud/beta/functions/call index e8812af98..6b73cdf19 100644 --- a/gcloud/beta/functions/call +++ b/gcloud/beta/functions/call @@ -54,9 +54,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. At most one of these can be specified: diff --git a/gcloud/beta/functions/delete b/gcloud/beta/functions/delete index 1dd6caa8c..e98b080c5 100644 --- a/gcloud/beta/functions/delete +++ b/gcloud/beta/functions/delete @@ -40,9 +40,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/functions/deploy b/gcloud/beta/functions/deploy index 0e32291ba..52c5dcb92 100644 --- a/gcloud/beta/functions/deploy +++ b/gcloud/beta/functions/deploy @@ -126,9 +126,9 @@ FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. --ignore-file=IGNORE_FILE Override the .gcloudignore file and use the specified file instead. diff --git a/gcloud/beta/functions/describe b/gcloud/beta/functions/describe index 179cf16fd..6eeee77de 100644 --- a/gcloud/beta/functions/describe +++ b/gcloud/beta/functions/describe @@ -40,9 +40,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/functions/event-types/list b/gcloud/beta/functions/event-types/list index 2cdafee3c..de84fe0a9 100644 --- a/gcloud/beta/functions/event-types/list +++ b/gcloud/beta/functions/event-types/list @@ -19,9 +19,9 @@ DESCRIPTION FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/functions/get-iam-policy b/gcloud/beta/functions/get-iam-policy index d02428762..916462f3d 100644 --- a/gcloud/beta/functions/get-iam-policy +++ b/gcloud/beta/functions/get-iam-policy @@ -47,9 +47,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/functions/logs/read b/gcloud/beta/functions/logs/read index 9fb530930..3ddb0fe9d 100644 --- a/gcloud/beta/functions/logs/read +++ b/gcloud/beta/functions/logs/read @@ -30,9 +30,11 @@ FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. --limit=LIMIT; default=20 Number of log entries to be fetched; must not be greater than 1000. diff --git a/gcloud/beta/functions/regions/list b/gcloud/beta/functions/regions/list index 6424c8c24..2eb19eca7 100644 --- a/gcloud/beta/functions/regions/list +++ b/gcloud/beta/functions/regions/list @@ -13,9 +13,9 @@ DESCRIPTION FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/beta/functions/remove-iam-policy-binding b/gcloud/beta/functions/remove-iam-policy-binding index df4c294a0..cf24b8be9 100644 --- a/gcloud/beta/functions/remove-iam-policy-binding +++ b/gcloud/beta/functions/remove-iam-policy-binding @@ -70,9 +70,11 @@ REQUIRED FLAGS OPTIONAL FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/functions/set-iam-policy b/gcloud/beta/functions/set-iam-policy index 527496163..116b4d332 100644 --- a/gcloud/beta/functions/set-iam-policy +++ b/gcloud/beta/functions/set-iam-policy @@ -50,9 +50,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/beta/iam/workforce-pools/providers/help b/gcloud/beta/iam/workforce-pools/providers/help index 186304d36..10140ff9e 100644 --- a/gcloud/beta/iam/workforce-pools/providers/help +++ b/gcloud/beta/iam/workforce-pools/providers/help @@ -18,6 +18,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + keys + (BETA) Create and manage IAM workforce pool provider keys. + operations (BETA) Manage IAM workforce pool provider long-running operations. diff --git a/gcloud/beta/iam/workforce-pools/providers/keys/create b/gcloud/beta/iam/workforce-pools/providers/keys/create new file mode 100644 index 000000000..d8abe48f1 --- /dev/null +++ b/gcloud/beta/iam/workforce-pools/providers/keys/create @@ -0,0 +1,101 @@ +NAME + gcloud beta iam workforce-pools providers keys create - create a new + workforce pool provider key + +SYNOPSIS + gcloud beta iam workforce-pools providers keys create + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) --spec=SPEC + --use=USE [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Create a new workforce pool provider key. + +EXAMPLES + The following command creates a workforce pool provider key with the ID + my-key. Explicit values for all required and optional parameters are + provided. + + $ gcloud beta iam workforce-pools providers keys create my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" --use="ENCRYPTION" --spec="RSA_4096" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + create. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool on the command line. + +REQUIRED FLAGS + --spec=SPEC + The specifications for the key. SPEC must be one of: + key-spec-unspecified, rsa-2048, rsa-3072, rsa-4096. + + --use=USE + The purpose of the key. USE must be one of: encryption, + key-use-unspecified. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud iam workforce-pools providers keys create + + $ gcloud alpha iam workforce-pools providers keys create + diff --git a/gcloud/beta/iam/workforce-pools/providers/keys/delete b/gcloud/beta/iam/workforce-pools/providers/keys/delete new file mode 100644 index 000000000..14bc7bdf0 --- /dev/null +++ b/gcloud/beta/iam/workforce-pools/providers/keys/delete @@ -0,0 +1,91 @@ +NAME + gcloud beta iam workforce-pools providers keys delete - delete a workforce + pool provider key + +SYNOPSIS + gcloud beta iam workforce-pools providers keys delete + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete a workforce pool provider key. + +EXAMPLES + The following command deletes a workforce pool provider key with the ID + my-key. + + $ gcloud beta iam workforce-pools providers keys delete my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + delete. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud iam workforce-pools providers keys delete + + $ gcloud alpha iam workforce-pools providers keys delete + diff --git a/gcloud/beta/iam/workforce-pools/providers/keys/describe b/gcloud/beta/iam/workforce-pools/providers/keys/describe new file mode 100644 index 000000000..e9023dfa3 --- /dev/null +++ b/gcloud/beta/iam/workforce-pools/providers/keys/describe @@ -0,0 +1,86 @@ +NAME + gcloud beta iam workforce-pools providers keys describe - describe a + workforce pool provider key + +SYNOPSIS + gcloud beta iam workforce-pools providers keys describe + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a workforce pool provider key. + +EXAMPLES + The following command describes a workforce pool provider key with the ID + my-key. + + $ gcloud beta iam workforce-pools providers keys describe my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + describe. The arguments in this group can be used to specify the + attributes of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud iam workforce-pools providers keys describe + + $ gcloud alpha iam workforce-pools providers keys describe + diff --git a/gcloud/beta/iam/workforce-pools/providers/keys/help b/gcloud/beta/iam/workforce-pools/providers/keys/help new file mode 100644 index 000000000..41680766c --- /dev/null +++ b/gcloud/beta/iam/workforce-pools/providers/keys/help @@ -0,0 +1,49 @@ +NAME + gcloud beta iam workforce-pools providers keys - create and manage IAM + workforce pool provider keys + +SYNOPSIS + gcloud beta iam workforce-pools providers keys GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) The gcloud beta iam workforce-pools providers keys group lets you + create and manage IAM workforce pool provider keys. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + operations + (BETA) Manage IAM workforce pool provider key long-running operations. + +COMMANDS + COMMAND is one of the following: + + create + (BETA) Create a new workforce pool provider key. + + delete + (BETA) Delete a workforce pool provider key. + + describe + (BETA) Describe a workforce pool provider key. + + list + (BETA) List workforce pool provider keys. + + undelete + (BETA) Undelete a workforce pool provider key. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud iam workforce-pools providers keys + + $ gcloud alpha iam workforce-pools providers keys + diff --git a/gcloud/beta/iam/workforce-pools/providers/keys/list b/gcloud/beta/iam/workforce-pools/providers/keys/list new file mode 100644 index 000000000..21ec14192 --- /dev/null +++ b/gcloud/beta/iam/workforce-pools/providers/keys/list @@ -0,0 +1,105 @@ +NAME + gcloud beta iam workforce-pools providers keys list - list workforce pool + provider keys + +SYNOPSIS + gcloud beta iam workforce-pools providers keys list + (--provider=PROVIDER + : --location=LOCATION --workforce-pool=WORKFORCE_POOL) + [--show-deleted] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List workforce pool provider keys. + +EXAMPLES + The following command lists the keys in the workforce pool provider with ID + my-provider, including soft-deleted keys: + + $ gcloud beta iam workforce-pools providers keys list \ + --workforce-pool="my-workforce-pool" --provider="my-provider" \ + --location="global" --show-deleted + +REQUIRED FLAGS + Workforce pool provider resource - The parent workforce pool provider of + the keys to list. The arguments in this group can be used to specify the + attributes of this resource. + + This must be specified. + + --provider=PROVIDER + ID of the workforce pool provider or fully qualified identifier for + the workforce pool provider. To set the provider attribute: + ▸ provide the argument --provider 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 for the workforce pool. To set the location attribute: + ▸ provide the argument --provider on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument --provider on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool on the command line. + +FLAGS + --show-deleted + Show soft-deleted keys by specifying this flag. + +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. + +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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud iam workforce-pools providers keys list + + $ gcloud alpha iam workforce-pools providers keys list + diff --git a/gcloud/beta/iam/workforce-pools/providers/keys/operations/describe b/gcloud/beta/iam/workforce-pools/providers/keys/operations/describe new file mode 100644 index 000000000..b532f2312 --- /dev/null +++ b/gcloud/beta/iam/workforce-pools/providers/keys/operations/describe @@ -0,0 +1,98 @@ +NAME + gcloud beta iam workforce-pools providers keys operations describe - + describe a workforce pool provider key operation + +SYNOPSIS + gcloud beta iam workforce-pools providers keys operations describe + (OPERATION : --key=KEY --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Describe a workforce pool provider key operation. + +EXAMPLES + To describe the long-running workforce pool provider key operation with the + ID my-operation, run: + + $ gcloud beta iam workforce-pools providers keys operations \ + describe my-operation --workforce-pool="my-workforce-pool" \ + --provider="my-provider" --key="my-key" --location="global" + +POSITIONAL ARGUMENTS + Workforce pool provider key operation resource - The workforce pool + provider key long-running operation to describe. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + OPERATION + ID of the workforce pool provider key operation or fully qualified + identifier for the workforce pool provider key operation. To set the + operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --key=KEY + The ID for the key, which becomes the final component of the resource + name. This value must be 4-32 characters, and may contain the + characters [a-z0-9-]. The prefix gcp- is reserved for use by Google, + and may not be specified. + + To set the key attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --key on the command line. + + --location=LOCATION + The location for the workforce pool. To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud iam workforce-pools providers keys operations describe + + $ gcloud alpha iam workforce-pools providers keys operations describe + diff --git a/gcloud/beta/iam/workforce-pools/providers/keys/operations/help b/gcloud/beta/iam/workforce-pools/providers/keys/operations/help new file mode 100644 index 000000000..7eb073a3b --- /dev/null +++ b/gcloud/beta/iam/workforce-pools/providers/keys/operations/help @@ -0,0 +1,31 @@ +NAME + gcloud beta iam workforce-pools providers keys operations - manage IAM + workforce pool provider key long-running operations + +SYNOPSIS + gcloud beta iam workforce-pools providers keys operations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Commands for managing IAM workforce pool provider key long-running + operations. + +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 a workforce pool provider key operation. + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud iam workforce-pools providers keys operations + + $ gcloud alpha iam workforce-pools providers keys operations + diff --git a/gcloud/beta/iam/workforce-pools/providers/keys/undelete b/gcloud/beta/iam/workforce-pools/providers/keys/undelete new file mode 100644 index 000000000..92ea88075 --- /dev/null +++ b/gcloud/beta/iam/workforce-pools/providers/keys/undelete @@ -0,0 +1,91 @@ +NAME + gcloud beta iam workforce-pools providers keys undelete - undelete a + workforce pool provider key + +SYNOPSIS + gcloud beta iam workforce-pools providers keys undelete + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Undelete a workforce pool provider key. + +EXAMPLES + The following command undeletes a workforce pool provider key with the ID + my-key. + + $ gcloud beta iam workforce-pools providers keys undelete my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + undelete. The arguments in this group can be used to specify the + attributes of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + This command is currently in beta and might change without notice. These + variants are also available: + + $ gcloud iam workforce-pools providers keys undelete + + $ gcloud alpha iam workforce-pools providers keys undelete + diff --git a/gcloud/beta/iap/oauth-brands/describe b/gcloud/beta/iap/oauth-brands/describe index febd321a3..27155c7d9 100644 --- a/gcloud/beta/iap/oauth-brands/describe +++ b/gcloud/beta/iap/oauth-brands/describe @@ -19,9 +19,10 @@ EXAMPLES $ gcloud beta iap oauth-brands describe NAME --project=PROJECT_ID POSITIONAL ARGUMENTS - Name resource - Name of the Cloud OAuth brand to describe. 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: + Brand resource - Name of the Cloud OAuth brand to describe. 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 name on the command line with a fully specified name; ◆ provide the argument --project on the command line; @@ -30,8 +31,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - brand attribute: + ID of the brand or fully qualified identifier for the brand. To set + the brand attribute: ▸ provide the argument name on the command line. GCLOUD WIDE FLAGS diff --git a/gcloud/beta/iap/oauth-clients/delete b/gcloud/beta/iap/oauth-clients/delete index 1e9ec5d5c..92935de60 100644 --- a/gcloud/beta/iap/oauth-clients/delete +++ b/gcloud/beta/iap/oauth-clients/delete @@ -23,7 +23,7 @@ EXAMPLES --project=PROJECT_ID POSITIONAL ARGUMENTS - Name resource - Name of the Cloud IAP OAuth client to delete. The + Proxy client resource - Name of the Cloud IAP OAuth client 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: @@ -35,8 +35,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - identity_aware_proxy_clients attribute: + ID of the proxy client or fully qualified identifier for the proxy + client. To set the identity_aware_proxy_clients attribute: ▸ provide the argument name on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/beta/iap/oauth-clients/describe b/gcloud/beta/iap/oauth-clients/describe index a987ddb9c..a82a53c1f 100644 --- a/gcloud/beta/iap/oauth-clients/describe +++ b/gcloud/beta/iap/oauth-clients/describe @@ -20,8 +20,8 @@ EXAMPLES $ gcloud beta iap oauth-clients describe NAME --brand=BRAND POSITIONAL ARGUMENTS - Name resource - Name of the Cloud IAP OAuth client to describe. The - arguments in this group can be used to specify the attributes of this + Proxy client resource - Name of the Cloud IAP OAuth client 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 name on the command line with a fully specified @@ -32,8 +32,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - identity_aware_proxy_clients attribute: + ID of the proxy client or fully qualified identifier for the proxy + client. To set the identity_aware_proxy_clients attribute: ▸ provide the argument name on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/beta/iap/oauth-clients/list b/gcloud/beta/iap/oauth-clients/list index ef7679cf9..732ee54b3 100644 --- a/gcloud/beta/iap/oauth-clients/list +++ b/gcloud/beta/iap/oauth-clients/list @@ -18,7 +18,7 @@ EXAMPLES $ gcloud beta iap oauth-clients list BRAND POSITIONAL ARGUMENTS - Name resource - Name of the Cloud OAuth brand to list Cloud IAP OAuth + Brand resource - Name of the Cloud OAuth brand to list Cloud IAP OAuth clients under. 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: @@ -30,8 +30,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - brand attribute: + ID of the brand or fully qualified identifier for the brand. To set + the brand attribute: ▸ provide the argument name on the command line. LIST COMMAND FLAGS diff --git a/gcloud/beta/iap/oauth-clients/reset-secret b/gcloud/beta/iap/oauth-clients/reset-secret index e4a1e5c97..490016923 100644 --- a/gcloud/beta/iap/oauth-clients/reset-secret +++ b/gcloud/beta/iap/oauth-clients/reset-secret @@ -21,10 +21,11 @@ EXAMPLES $ gcloud beta iap oauth-clients reset-secret NAME --brand=BRAND POSITIONAL ARGUMENTS - Name resource - Name of the Cloud IAP OAuth client whose secret will be - reset. 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: + Proxy client resource - Name of the Cloud IAP OAuth client whose secret + will be reset. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: ◆ provide the argument name on the command line with a fully specified name; ◆ provide the argument --project on the command line; @@ -33,8 +34,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - identity_aware_proxy_clients attribute: + ID of the proxy client or fully qualified identifier for the proxy + client. To set the identity_aware_proxy_clients attribute: ▸ provide the argument name on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/beta/ml-engine/jobs/submit/training b/gcloud/beta/ml-engine/jobs/submit/training index 4fbdf362e..e467bd809 100644 --- a/gcloud/beta/ml-engine/jobs/submit/training +++ b/gcloud/beta/ml-engine/jobs/submit/training @@ -149,7 +149,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -200,7 +200,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -322,7 +322,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. diff --git a/gcloud/beta/network-security/help b/gcloud/beta/network-security/help index e7e225a7e..4643b3d10 100644 --- a/gcloud/beta/network-security/help +++ b/gcloud/beta/network-security/help @@ -27,6 +27,9 @@ GROUPS server-tls-policies (BETA) Manage Network Security ServerTlsPolicies. + tls-inspection-policies + (BETA) Manage Network Security TLS Inspection Policies. + url-lists (BETA) Manage Network Security UrlLists. diff --git a/gcloud/beta/network-security/tls-inspection-policies/delete b/gcloud/beta/network-security/tls-inspection-policies/delete new file mode 100644 index 000000000..8c0873ed9 --- /dev/null +++ b/gcloud/beta/network-security/tls-inspection-policies/delete @@ -0,0 +1,70 @@ +NAME + gcloud beta network-security tls-inspection-policies delete - delete TLS + Inspection Policy + +SYNOPSIS + gcloud beta network-security tls-inspection-policies delete + (TLS_INSPECTION_POLICY : --location=LOCATION) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Delete the specified TLS Inspection Policy. + +EXAMPLES + To delete a TLS Inspection Policy called 'my-tls-inspection-policy', run: + + $ gcloud beta network-security tls-inspection-policies delete \ + my-tls-inspection-policy --location=$REGION + +POSITIONAL ARGUMENTS + Tls inspection policy resource - Name of the TLS Inspection Policy you + want to delete. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument tls_inspection_policy on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TLS_INSPECTION_POLICY + ID of the tls inspection policy or fully qualified identifier for the + tls inspection policy. To set the tls_inspection_policy attribute: + ▸ provide the argument tls_inspection_policy 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 tls_inspection_policy 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 networksecurity/v1beta1 API. The full documentation + 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: + + $ gcloud alpha network-security tls-inspection-policies delete + diff --git a/gcloud/beta/network-security/tls-inspection-policies/export b/gcloud/beta/network-security/tls-inspection-policies/export new file mode 100644 index 000000000..0d3874f87 --- /dev/null +++ b/gcloud/beta/network-security/tls-inspection-policies/export @@ -0,0 +1,73 @@ +NAME + gcloud beta network-security tls-inspection-policies export - export TLS + Inspection Policy + +SYNOPSIS + gcloud beta network-security tls-inspection-policies export + (TLS_INSPECTION_POLICY : --location=LOCATION) + [--destination=DESTINATION] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Export a TLS Inspection Policy. + +EXAMPLES + To export a TLS Inspection Policy, run: + + $ gcloud beta network-security tls-inspection-policies export \ + my-tls-inspection-policy \ + --destination=my-tls-inspection-policy.yaml --location=$REGION + +POSITIONAL ARGUMENTS + Tls inspection policy 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 tls_inspection_policy on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TLS_INSPECTION_POLICY + ID of the tls inspection policy or fully qualified identifier for the + tls inspection policy. To set the tls_inspection_policy attribute: + ▸ provide the argument tls_inspection_policy 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 tls_inspection_policy on the command line + with a fully specified name; + ▸ provide the argument --location on the command line. + +FLAGS + --destination=DESTINATION + Path to a YAML file where the configuration will be exported. The + exported data will not contain any output-only fields. Alternatively, + you may omit this flag to write to standard output. For a schema + describing the export/import format, see + $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + +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 networksecurity/v1beta1 API. The full documentation + 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: + + $ gcloud alpha network-security tls-inspection-policies export + diff --git a/gcloud/beta/network-security/tls-inspection-policies/help b/gcloud/beta/network-security/tls-inspection-policies/help new file mode 100644 index 000000000..561705970 --- /dev/null +++ b/gcloud/beta/network-security/tls-inspection-policies/help @@ -0,0 +1,37 @@ +NAME + gcloud beta network-security tls-inspection-policies - manage Network + Security TLS Inspection Policies + +SYNOPSIS + gcloud beta network-security tls-inspection-policies COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Manage Network Security TLS Inspection Policies. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +COMMANDS + COMMAND is one of the following: + + delete + (BETA) Delete TLS Inspection Policy. + + export + (BETA) Export TLS Inspection Policy. + + import + (BETA) Import TLS Inspection Policy. + + list + (BETA) List TLS Inspection Policies. + +NOTES + This command is currently in beta and might change without notice. This + variant is also available: + + $ gcloud alpha network-security tls-inspection-policies + diff --git a/gcloud/beta/network-security/tls-inspection-policies/import b/gcloud/beta/network-security/tls-inspection-policies/import new file mode 100644 index 000000000..16e90f193 --- /dev/null +++ b/gcloud/beta/network-security/tls-inspection-policies/import @@ -0,0 +1,78 @@ +NAME + gcloud beta network-security tls-inspection-policies import - import TLS + Inspection Policy + +SYNOPSIS + gcloud beta network-security tls-inspection-policies import + (TLS_INSPECTION_POLICY : --location=LOCATION) [--async] + [--source=SOURCE] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) Import a TLS Inspection Policy. + +EXAMPLES + To import a TLS Inspection Policy from a YAML file, run: $ gcloud beta network-security tls-inspection-policies import \ + my-tls-inspection-policy \ + --source=my-tls-inspection-policy.yaml --location=$REGION + +POSITIONAL ARGUMENTS + Tls inspection policy resource - Name of the TLS Inspection Policy to + import. 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 tls_inspection_policy on the command line with a + fully specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + TLS_INSPECTION_POLICY + ID of the tls inspection policy or fully qualified identifier for the + tls inspection policy. To set the tls_inspection_policy attribute: + ▸ provide the argument tls_inspection_policy 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 tls_inspection_policy 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. + + --source=SOURCE + Path to a YAML file containing the configuration export data. The YAML + file must not contain any output-only fields. Alternatively, you may + omit this flag to read from standard input. For a schema describing the + export/import format, see: $CLOUDSDKROOT/lib/googlecloudsdk/schemas/... + + $CLOUDSDKROOT is can be obtained with the following command: + + $ gcloud info --format='value(installation.sdk_root)' + +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 networksecurity/v1beta1 API. The full documentation + 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: + + $ gcloud alpha network-security tls-inspection-policies import + diff --git a/gcloud/beta/network-security/tls-inspection-policies/list b/gcloud/beta/network-security/tls-inspection-policies/list new file mode 100644 index 000000000..af6fb680f --- /dev/null +++ b/gcloud/beta/network-security/tls-inspection-policies/list @@ -0,0 +1,85 @@ +NAME + gcloud beta network-security tls-inspection-policies list - list TLS + Inspection Policies + +SYNOPSIS + gcloud beta network-security tls-inspection-policies list + --location=LOCATION [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [--uri] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + (BETA) List all TLS Inspection Policies in the specified location of the + current project. + +EXAMPLES + To list TLS Inspection Policies in the current project, run: $ gcloud beta network-security tls-inspection-policies list \ + --location=$REGION + +REQUIRED FLAGS + Location resource - The project of the TLS Inspection Policies to display. + This represents a Cloud resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument --location on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + --location=LOCATION + ID of the location or fully qualified identifier for the location. To + set the location attribute: + ▸ provide the argument --location on the command line. + +LIST COMMAND FLAGS + --filter=EXPRESSION + Apply a Boolean filter EXPRESSION to each resource item to be listed. + If the expression evaluates True, then that item is listed. For more + details and examples of filter expressions, run $ gcloud topic filters. + This flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --limit=LIMIT + Maximum number of resources to list. The default is unlimited. This + flag interacts with other flags that are applied in this order: + --flatten, --sort-by, --filter, --limit. + + --page-size=PAGE_SIZE + Some services group resource list output into pages. This flag + specifies the maximum number of resources per page. The default is + determined by the service if it supports paging, otherwise it is + unlimited (no paging). Paging may be applied before or after --filter + and --limit depending on the service. + + --sort-by=[FIELD,...] + Comma-separated list of resource field key names to sort by. The + default order is ascending. Prefix a field with ``~'' for descending + order on that field. This flag interacts with other flags that are + applied in this order: --flatten, --sort-by, --filter, --limit. + + --uri + Print a list of resource URIs instead of the default output, and change + the command output to a list of URIs. If this flag is used with + --format, the formatting is applied on this URI list. To display URIs + alongside other keys instead, use the uri() transform. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the networksecurity/v1beta1 API. The full documentation + 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: + + $ gcloud alpha network-security tls-inspection-policies list + diff --git a/gcloud/beta/workstations/configs/create b/gcloud/beta/workstations/configs/create index 0f9ba7a23..a982026ea 100644 --- a/gcloud/beta/workstations/configs/create +++ b/gcloud/beta/workstations/configs/create @@ -24,7 +24,9 @@ SYNOPSIS [--shielded-secure-boot] [--shielded-vtpm] [--container-custom-image=CONTAINER_CUSTOM_IMAGE | --container-predefined-image=CONTAINER_PREDEFINED_IMAGE; - default="codeoss"] [GCLOUD_WIDE_FLAG ...] + default="codeoss"] + [--kms-key=KMS_KEY : --kms-key-service-account=KMS_KEY_SERVICE_ACCOUNT] + [GCLOUD_WIDE_FLAG ...] DESCRIPTION (BETA) Create a workstation configuration. @@ -224,6 +226,19 @@ FLAGS webstorm WebStorm + Encryption key settings + + --kms-key=KMS_KEY + The customer-managed encryption key to use for this config. If not + specified, a Google-managed encryption key is used. + + This flag argument must be specified if any of the other arguments in + this group are specified. + + --kms-key-service-account=KMS_KEY_SERVICE_ACCOUNT + The service account associated with the provided customer-managed + encryption key. + 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/compute/forwarding-rules/create b/gcloud/compute/forwarding-rules/create index 84ceb2bd4..f566c0fb7 100644 --- a/gcloud/compute/forwarding-rules/create +++ b/gcloud/compute/forwarding-rules/create @@ -20,7 +20,8 @@ SYNOPSIS [--load-balancing-scheme=LOAD_BALANCING_SCHEME] [--network=NETWORK] [--network-tier=NETWORK_TIER] [--service-directory-registration=SERVICE_DIRECTORY_REGISTRATION] - [--service-label=SERVICE_LABEL] [--subnet=SUBNET] + [--service-label=SERVICE_LABEL] + [--source-ip-ranges=SOURCE_IP_RANGE,[...]] [--subnet=SUBNET] [--subnet-region=SUBNET_REGION] [--target-instance-zone=TARGET_INSTANCE_ZONE] [--target-pool-region=TARGET_POOL_REGION] @@ -280,6 +281,11 @@ OPTIONAL FLAGS --service-label flag if the forwarding rule references an internal IP address that has the --purpose=SHARED_LOADBALANCER_VIP flag set. + --source-ip-ranges=SOURCE_IP_RANGE,[...] + List of comma-separated IP addresses or IP ranges. If set, this + forwarding rule only forwards traffic when the packet's source IP + address matches one of the IP ranges set here. + --subnet=SUBNET (Only for --load-balancing-scheme=INTERNAL and --load-balancing-scheme=INTERNAL_MANAGED) Subnetwork that this diff --git a/gcloud/compute/forwarding-rules/update b/gcloud/compute/forwarding-rules/update index 9b54035ba..f00b4ad7b 100644 --- a/gcloud/compute/forwarding-rules/update +++ b/gcloud/compute/forwarding-rules/update @@ -4,6 +4,7 @@ NAME SYNOPSIS gcloud compute forwarding-rules update NAME [--allow-global-access] + [--source-ip-ranges=SOURCE_IP_RANGE,[...]] [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...] @@ -45,6 +46,11 @@ FLAGS forwarding rules of type INTERNAL, the target must be either a backend service or a target instance. + --source-ip-ranges=SOURCE_IP_RANGE,[...] + List of comma-separated IP addresses or IP ranges. If set, this + forwarding rule only forwards traffic when the packet's source IP + address matches one of the IP ranges set here. + --update-labels=[KEY=VALUE,...] List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created. diff --git a/gcloud/compute/network-endpoint-groups/update b/gcloud/compute/network-endpoint-groups/update index 85a239046..859524eed 100644 --- a/gcloud/compute/network-endpoint-groups/update +++ b/gcloud/compute/network-endpoint-groups/update @@ -51,7 +51,7 @@ REQUIRED FLAGS is deleted, then any network endpoint group that has a reference to it is updated. - *ip* - Optional IP address of the network endpoint. the IP address + *ip* - Optional IP address of the network endpoint. The IP address must belong to a VM in compute engine (either the primary IP or as part of an aliased IP range). If the IP address is not specified, then the primary IP address for the VM instance in @@ -62,7 +62,7 @@ REQUIRED FLAGS internet-ip-port - *ip* - Required IP address of the endpoint to attach. Must be + *ip* - Required IPv4 address of the endpoint to attach. Must be publicly routable. *port* - Optional port of the endpoint to attach. If unspecified, @@ -85,12 +85,13 @@ REQUIRED FLAGS non-gcp-private-ip-port - *ip* - Required IP address of the network endpoint to attach. The - IP address must belong to a VM not in Compute Engine and - must be routable using a Cloud Router over VPN or an Interconnect connection. + *ip* - Required IPv4 address of the network endpoint to attach. + The IP address must belong to a VM not in Compute Engine and must + be routable using a Cloud Router over VPN or an Interconnect + connection. - *port* - Required port of the network endpoint to attach unless the - NEG default port is set. + *port* - Required port of the network endpoint to attach unless + the NEG default port is set. gce-vm-ip @@ -116,14 +117,14 @@ REQUIRED FLAGS detach. If the IP address is unset, all endpoints for the instance in the NEG are detached. - *ip* - Optional IP address of the network endpoint to detach. + *ip* - Optional IPv4 address of the network endpoint to detach. If specified port must be provided as well. *port* - Optional port of the network endpoint to detach. internet-ip-port - *ip* - Required IP address of the network endpoint to detach. + *ip* - Required IPv4 address of the network endpoint to detach. *port* - Optional port of the network endpoint to detach if the endpoint has a port specified. @@ -138,7 +139,7 @@ REQUIRED FLAGS non-gcp-private-ip-port - *ip* - Required IP address of the network endpoint to detach. + *ip* - Required IPv4 address of the network endpoint to detach. *port* - Required port of the network endpoint to detach unless NEG default port is set. diff --git a/gcloud/config/get b/gcloud/config/get index 9216fe7b0..c4d6ad4c7 100644 --- a/gcloud/config/get +++ b/gcloud/config/get @@ -893,7 +893,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1283,6 +1284,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/config/help b/gcloud/config/help index 78a7f7d83..01c623069 100644 --- a/gcloud/config/help +++ b/gcloud/config/help @@ -925,7 +925,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1315,6 +1316,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/config/list b/gcloud/config/list index a746767ca..d4fe7d203 100644 --- a/gcloud/config/list +++ b/gcloud/config/list @@ -937,7 +937,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1327,6 +1328,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/config/set b/gcloud/config/set index 33178da49..c3b303288 100644 --- a/gcloud/config/set +++ b/gcloud/config/set @@ -940,7 +940,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1330,6 +1331,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/config/unset b/gcloud/config/unset index 526fd6952..4f7479523 100644 --- a/gcloud/config/unset +++ b/gcloud/config/unset @@ -901,7 +901,8 @@ AVAILABLE PROPERTIES gen2 Default environment to use when working with Cloud Functions resources. When neither --gen2 nor --no-gen2 is provided, the - decision of whether to use Generation 2 falls back to this value. + decision of whether to use Generation 2 falls back to this value if + set. region Default region to use when working with Cloud Functions resources. @@ -1291,6 +1292,11 @@ AVAILABLE PROPERTIES rsync_files_directory Directory path to intermediary files created by rsync. + rsync_list_chunk_size + Number of files processed at a time by the rsync command when it + builds and compares the list of files at the source and + destination. + s3_endpoint_url If set, boto3 client will connect to this endpoint. Otherwise, boto3 selects a default endpoint based on the AWS service used. diff --git a/gcloud/database-migration/connection-profiles/create/mysql b/gcloud/database-migration/connection-profiles/create/mysql index 1cef36e71..59af300e1 100644 --- a/gcloud/database-migration/connection-profiles/create/mysql +++ b/gcloud/database-migration/connection-profiles/create/mysql @@ -4,14 +4,13 @@ NAME SYNOPSIS gcloud database-migration connection-profiles create mysql - (CONNECTION_PROFILE : --region=REGION) --host=HOST --port=PORT - --username=USERNAME (--password=PASSWORD | --prompt-for-password) - [--no-async] [--cloudsql-instance=CLOUDSQL_INSTANCE] - [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] - [--provider=PROVIDER] + (CONNECTION_PROFILE : --region=REGION) [--no-async] + [--cloudsql-instance=CLOUDSQL_INSTANCE] [--display-name=DISPLAY_NAME] + [--labels=[KEY=VALUE,...]] [--provider=PROVIDER] [--ca-certificate=CA_CERTIFICATE : --client-certificate=CLIENT_CERTIFICATE --private-key=PRIVATE_KEY] - [GCLOUD_WIDE_FLAG ...] + [--host=HOST --port=PORT --username=USERNAME (--password=PASSWORD + | --prompt-for-password)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Database Migration Service connection profile for MySQL. @@ -57,35 +56,13 @@ POSITIONAL ARGUMENTS a fully specified name; ▸ provide the argument --region on the command line. -REQUIRED FLAGS - --host=HOST - IP or hostname of the source database. - - --port=PORT - Network port of the source database. - - --username=USERNAME - Username that Database Migration Service uses to connect to the - database. Database Migration Service encrypts the value when storing - it. - - Exactly one of these must be specified: - - --password=PASSWORD - Password for the user that Database Migration Service uses to connect - to the source database. Database Migration Service encrypts the value - when storing it, and the field is not returned on request. - - --prompt-for-password - Prompt for the password used to connect to the database. - -OPTIONAL FLAGS +FLAGS --no-async Waits for the operation in progress to complete before returning. --cloudsql-instance=CLOUDSQL_INSTANCE - If the source is a Cloud SQL database, use this field to provide the - Cloud SQL instance ID of the source. + If the source or destination is a Cloud SQL database, then use this + field to provide the respective Cloud SQL instance ID. --display-name=DISPLAY_NAME A user-friendly name for the connection profile. The display name can @@ -120,6 +97,27 @@ OPTIONAL FLAGS the Client Certificate. Database Migration Service encrypts the value when storing it. + --host=HOST + IP or hostname of the source database. + + --port=PORT + Network port of the source database. + + --username=USERNAME + Username that Database Migration Service uses to connect to the + database. Database Migration Service encrypts the value when storing + it. + + Exactly one of these must be specified: + + --password=PASSWORD + Password for the user that Database Migration Service uses to connect + to the source database. Database Migration Service encrypts the value + when storing it, and the field is not returned on request. + + --prompt-for-password + Prompt for the password used to connect to the database. + 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/database-migration/connection-profiles/create/postgresql b/gcloud/database-migration/connection-profiles/create/postgresql index 496459e2e..f3cf575c7 100644 --- a/gcloud/database-migration/connection-profiles/create/postgresql +++ b/gcloud/database-migration/connection-profiles/create/postgresql @@ -4,13 +4,13 @@ NAME SYNOPSIS gcloud database-migration connection-profiles create postgresql - (CONNECTION_PROFILE : --region=REGION) --host=HOST --port=PORT - --username=USERNAME (--password=PASSWORD | --prompt-for-password) - [--no-async] [--cloudsql-instance=CLOUDSQL_INSTANCE] - [--display-name=DISPLAY_NAME] [--labels=[KEY=VALUE,...]] + (CONNECTION_PROFILE : --region=REGION) [--no-async] + [--cloudsql-instance=CLOUDSQL_INSTANCE] [--display-name=DISPLAY_NAME] + [--labels=[KEY=VALUE,...]] [--ca-certificate=CA_CERTIFICATE : --client-certificate=CLIENT_CERTIFICATE --private-key=PRIVATE_KEY] - [GCLOUD_WIDE_FLAG ...] + [--host=HOST --port=PORT --username=USERNAME (--password=PASSWORD + | --prompt-for-password)] [GCLOUD_WIDE_FLAG ...] DESCRIPTION Create a Database Migration Service connection profile for PostgreSQL. @@ -56,35 +56,13 @@ POSITIONAL ARGUMENTS a fully specified name; ▸ provide the argument --region on the command line. -REQUIRED FLAGS - --host=HOST - IP or hostname of the source database. - - --port=PORT - Network port of the source database. - - --username=USERNAME - Username that Database Migration Service uses to connect to the - database. Database Migration Service encrypts the value when storing - it. - - Exactly one of these must be specified: - - --password=PASSWORD - Password for the user that Database Migration Service uses to connect - to the source database. Database Migration Service encrypts the value - when storing it, and the field is not returned on request. - - --prompt-for-password - Prompt for the password used to connect to the database. - -OPTIONAL FLAGS +FLAGS --no-async Waits for the operation in progress to complete before returning. --cloudsql-instance=CLOUDSQL_INSTANCE - If the source is a Cloud SQL database, use this field to provide the - Cloud SQL instance ID of the source. + If the source or destination is a Cloud SQL database, then use this + field to provide the respective Cloud SQL instance ID. --display-name=DISPLAY_NAME A user-friendly name for the connection profile. The display name can @@ -115,6 +93,27 @@ OPTIONAL FLAGS the Client Certificate. Database Migration Service encrypts the value when storing it. + --host=HOST + IP or hostname of the source database. + + --port=PORT + Network port of the source database. + + --username=USERNAME + Username that Database Migration Service uses to connect to the + database. Database Migration Service encrypts the value when storing + it. + + Exactly one of these must be specified: + + --password=PASSWORD + Password for the user that Database Migration Service uses to connect + to the source database. Database Migration Service encrypts the value + when storing it, and the field is not returned on request. + + --prompt-for-password + Prompt for the password used to connect to the database. + 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/database-migration/connection-profiles/update b/gcloud/database-migration/connection-profiles/update index e716a787b..9718e23be 100644 --- a/gcloud/database-migration/connection-profiles/update +++ b/gcloud/database-migration/connection-profiles/update @@ -69,8 +69,8 @@ FLAGS Service encrypts the value when storing it. --cloudsql-instance=CLOUDSQL_INSTANCE - If the source is a Cloud SQL database, use this field to provide the - Cloud SQL instance ID of the source. + If the source or destination is a Cloud SQL database, then use this + field to provide the respective Cloud SQL instance ID. --display-name=DISPLAY_NAME A user-friendly name for the connection profile. The display name can diff --git a/gcloud/functions/add-iam-policy-binding b/gcloud/functions/add-iam-policy-binding index c5a08b1f4..e26005a91 100644 --- a/gcloud/functions/add-iam-policy-binding +++ b/gcloud/functions/add-iam-policy-binding @@ -69,9 +69,11 @@ REQUIRED FLAGS OPTIONAL FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/functions/call b/gcloud/functions/call index 8491e87e7..b07aee9cc 100644 --- a/gcloud/functions/call +++ b/gcloud/functions/call @@ -54,9 +54,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. At most one of these can be specified: diff --git a/gcloud/functions/delete b/gcloud/functions/delete index d6a8d7190..f35325709 100644 --- a/gcloud/functions/delete +++ b/gcloud/functions/delete @@ -40,9 +40,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/functions/deploy b/gcloud/functions/deploy index 52359cdc2..c0a065ebf 100644 --- a/gcloud/functions/deploy +++ b/gcloud/functions/deploy @@ -119,9 +119,9 @@ FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. --ignore-file=IGNORE_FILE Override the .gcloudignore file and use the specified file instead. diff --git a/gcloud/functions/describe b/gcloud/functions/describe index b6a878dfb..1279c3b1f 100644 --- a/gcloud/functions/describe +++ b/gcloud/functions/describe @@ -40,9 +40,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/functions/event-types/list b/gcloud/functions/event-types/list index 5fbb0b189..b0ef8ed29 100644 --- a/gcloud/functions/event-types/list +++ b/gcloud/functions/event-types/list @@ -19,9 +19,9 @@ DESCRIPTION FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/functions/get-iam-policy b/gcloud/functions/get-iam-policy index 73ee68a59..bc27e6f86 100644 --- a/gcloud/functions/get-iam-policy +++ b/gcloud/functions/get-iam-policy @@ -47,9 +47,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/functions/logs/read b/gcloud/functions/logs/read index 4e340ab22..37eb6c8ac 100644 --- a/gcloud/functions/logs/read +++ b/gcloud/functions/logs/read @@ -30,9 +30,11 @@ FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. --limit=LIMIT; default=20 Number of log entries to be fetched; must not be greater than 1000. diff --git a/gcloud/functions/regions/list b/gcloud/functions/regions/list index 40950e89b..af9e4d040 100644 --- a/gcloud/functions/regions/list +++ b/gcloud/functions/regions/list @@ -13,9 +13,9 @@ DESCRIPTION FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. LIST COMMAND FLAGS --filter=EXPRESSION diff --git a/gcloud/functions/remove-iam-policy-binding b/gcloud/functions/remove-iam-policy-binding index 543234a56..127f062fd 100644 --- a/gcloud/functions/remove-iam-policy-binding +++ b/gcloud/functions/remove-iam-policy-binding @@ -70,9 +70,11 @@ REQUIRED FLAGS OPTIONAL FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/functions/set-iam-policy b/gcloud/functions/set-iam-policy index ddda22627..364cc8c00 100644 --- a/gcloud/functions/set-iam-policy +++ b/gcloud/functions/set-iam-policy @@ -50,9 +50,11 @@ POSITIONAL ARGUMENTS FLAGS --gen2 If enabled, this command will use Cloud Functions (Second generation). - If disabled, Cloud Functions (First generation) will be used. If not - specified, the value of this flag will be taken from the functions/gen2 - configuration property. + If disabled with --no-gen2, Cloud Functions (First generation) will be + used. If not specified, the value of this flag will be taken from the + functions/gen2 configuration property. If the functions/gen2 + configuration property is not set, defaults to looking up the given + function and using its generation. GCLOUD WIDE FLAGS These flags are available to all commands: --access-token-file, --account, diff --git a/gcloud/iam/workforce-pools/providers/help b/gcloud/iam/workforce-pools/providers/help index db5960c53..d6ee3f161 100644 --- a/gcloud/iam/workforce-pools/providers/help +++ b/gcloud/iam/workforce-pools/providers/help @@ -17,6 +17,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + keys + Create and manage IAM workforce pool provider keys. + operations Manage IAM workforce pool provider long-running operations. diff --git a/gcloud/iam/workforce-pools/providers/keys/create b/gcloud/iam/workforce-pools/providers/keys/create new file mode 100644 index 000000000..d263f3e18 --- /dev/null +++ b/gcloud/iam/workforce-pools/providers/keys/create @@ -0,0 +1,100 @@ +NAME + gcloud iam workforce-pools providers keys create - create a new workforce + pool provider key + +SYNOPSIS + gcloud iam workforce-pools providers keys create + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) --spec=SPEC + --use=USE [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new workforce pool provider key. + +EXAMPLES + The following command creates a workforce pool provider key with the ID + my-key. Explicit values for all required and optional parameters are + provided. + + $ gcloud iam workforce-pools providers keys create my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" --use="ENCRYPTION" --spec="RSA_4096" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + create. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool on the command line. + +REQUIRED FLAGS + --spec=SPEC + The specifications for the key. SPEC must be one of: + key-spec-unspecified, rsa-2048, rsa-3072, rsa-4096. + + --use=USE + The purpose of the key. USE must be one of: encryption, + key-use-unspecified. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + These variants are also available: + + $ gcloud alpha iam workforce-pools providers keys create + + $ gcloud beta iam workforce-pools providers keys create + diff --git a/gcloud/iam/workforce-pools/providers/keys/delete b/gcloud/iam/workforce-pools/providers/keys/delete new file mode 100644 index 000000000..4c3b4bd5c --- /dev/null +++ b/gcloud/iam/workforce-pools/providers/keys/delete @@ -0,0 +1,90 @@ +NAME + gcloud iam workforce-pools providers keys delete - delete a workforce pool + provider key + +SYNOPSIS + gcloud iam workforce-pools providers keys delete + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a workforce pool provider key. + +EXAMPLES + The following command deletes a workforce pool provider key with the ID + my-key. + + $ gcloud iam workforce-pools providers keys delete my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + delete. The arguments in this group can be used to specify the attributes + of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + These variants are also available: + + $ gcloud alpha iam workforce-pools providers keys delete + + $ gcloud beta iam workforce-pools providers keys delete + diff --git a/gcloud/iam/workforce-pools/providers/keys/describe b/gcloud/iam/workforce-pools/providers/keys/describe new file mode 100644 index 000000000..e1d0bf636 --- /dev/null +++ b/gcloud/iam/workforce-pools/providers/keys/describe @@ -0,0 +1,85 @@ +NAME + gcloud iam workforce-pools providers keys describe - describe a workforce + pool provider key + +SYNOPSIS + gcloud iam workforce-pools providers keys describe + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a workforce pool provider key. + +EXAMPLES + The following command describes a workforce pool provider key with the ID + my-key. + + $ gcloud iam workforce-pools providers keys describe my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + describe. The arguments in this group can be used to specify the + attributes of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + These variants are also available: + + $ gcloud alpha iam workforce-pools providers keys describe + + $ gcloud beta iam workforce-pools providers keys describe + diff --git a/gcloud/iam/workforce-pools/providers/keys/help b/gcloud/iam/workforce-pools/providers/keys/help new file mode 100644 index 000000000..6ad845d92 --- /dev/null +++ b/gcloud/iam/workforce-pools/providers/keys/help @@ -0,0 +1,48 @@ +NAME + gcloud iam workforce-pools providers keys - create and manage IAM workforce + pool provider keys + +SYNOPSIS + gcloud iam workforce-pools providers keys GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + The gcloud iam workforce-pools providers keys group lets you create and + manage IAM workforce pool provider keys. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + operations + Manage IAM workforce pool provider key long-running operations. + +COMMANDS + COMMAND is one of the following: + + create + Create a new workforce pool provider key. + + delete + Delete a workforce pool provider key. + + describe + Describe a workforce pool provider key. + + list + List workforce pool provider keys. + + undelete + Undelete a workforce pool provider key. + +NOTES + These variants are also available: + + $ gcloud alpha iam workforce-pools providers keys + + $ gcloud beta iam workforce-pools providers keys + diff --git a/gcloud/iam/workforce-pools/providers/keys/list b/gcloud/iam/workforce-pools/providers/keys/list new file mode 100644 index 000000000..95eca2d61 --- /dev/null +++ b/gcloud/iam/workforce-pools/providers/keys/list @@ -0,0 +1,104 @@ +NAME + gcloud iam workforce-pools providers keys list - list workforce pool + provider keys + +SYNOPSIS + gcloud iam workforce-pools providers keys list + (--provider=PROVIDER + : --location=LOCATION --workforce-pool=WORKFORCE_POOL) + [--show-deleted] [--filter=EXPRESSION] [--limit=LIMIT] + [--page-size=PAGE_SIZE] [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List workforce pool provider keys. + +EXAMPLES + The following command lists the keys in the workforce pool provider with ID + my-provider, including soft-deleted keys: + + $ gcloud iam workforce-pools providers keys list \ + --workforce-pool="my-workforce-pool" --provider="my-provider" \ + --location="global" --show-deleted + +REQUIRED FLAGS + Workforce pool provider resource - The parent workforce pool provider of + the keys to list. The arguments in this group can be used to specify the + attributes of this resource. + + This must be specified. + + --provider=PROVIDER + ID of the workforce pool provider or fully qualified identifier for + the workforce pool provider. To set the provider attribute: + ▸ provide the argument --provider 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 for the workforce pool. To set the location attribute: + ▸ provide the argument --provider on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument --provider on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool on the command line. + +FLAGS + --show-deleted + Show soft-deleted keys by specifying this flag. + +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. + +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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + These variants are also available: + + $ gcloud alpha iam workforce-pools providers keys list + + $ gcloud beta iam workforce-pools providers keys list + diff --git a/gcloud/iam/workforce-pools/providers/keys/operations/describe b/gcloud/iam/workforce-pools/providers/keys/operations/describe new file mode 100644 index 000000000..3977eb606 --- /dev/null +++ b/gcloud/iam/workforce-pools/providers/keys/operations/describe @@ -0,0 +1,97 @@ +NAME + gcloud iam workforce-pools providers keys operations describe - describe a + workforce pool provider key operation + +SYNOPSIS + gcloud iam workforce-pools providers keys operations describe + (OPERATION : --key=KEY --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a workforce pool provider key operation. + +EXAMPLES + To describe the long-running workforce pool provider key operation with the + ID my-operation, run: + + $ gcloud iam workforce-pools providers keys operations describe \ + my-operation --workforce-pool="my-workforce-pool" \ + --provider="my-provider" --key="my-key" --location="global" + +POSITIONAL ARGUMENTS + Workforce pool provider key operation resource - The workforce pool + provider key long-running operation to describe. The arguments in this + group can be used to specify the attributes of this resource. + + This must be specified. + + OPERATION + ID of the workforce pool provider key operation or fully qualified + identifier for the workforce pool provider key operation. To set the + operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --key=KEY + The ID for the key, which becomes the final component of the resource + name. This value must be 4-32 characters, and may contain the + characters [a-z0-9-]. The prefix gcp- is reserved for use by Google, + and may not be specified. + + To set the key attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --key on the command line. + + --location=LOCATION + The location for the workforce pool. To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + These variants are also available: + + $ gcloud alpha iam workforce-pools providers keys operations describe + + $ gcloud beta iam workforce-pools providers keys operations describe + diff --git a/gcloud/iam/workforce-pools/providers/keys/operations/help b/gcloud/iam/workforce-pools/providers/keys/operations/help new file mode 100644 index 000000000..fac9d3b76 --- /dev/null +++ b/gcloud/iam/workforce-pools/providers/keys/operations/help @@ -0,0 +1,30 @@ +NAME + gcloud iam workforce-pools providers keys operations - manage IAM workforce + pool provider key long-running operations + +SYNOPSIS + gcloud iam workforce-pools providers keys operations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing IAM workforce pool provider key long-running + operations. + +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 a workforce pool provider key operation. + +NOTES + These variants are also available: + + $ gcloud alpha iam workforce-pools providers keys operations + + $ gcloud beta iam workforce-pools providers keys operations + diff --git a/gcloud/iam/workforce-pools/providers/keys/undelete b/gcloud/iam/workforce-pools/providers/keys/undelete new file mode 100644 index 000000000..0bc515113 --- /dev/null +++ b/gcloud/iam/workforce-pools/providers/keys/undelete @@ -0,0 +1,90 @@ +NAME + gcloud iam workforce-pools providers keys undelete - undelete a workforce + pool provider key + +SYNOPSIS + gcloud iam workforce-pools providers keys undelete + (KEY : --location=LOCATION + --provider=PROVIDER --workforce-pool=WORKFORCE_POOL) [--async] + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Undelete a workforce pool provider key. + +EXAMPLES + The following command undeletes a workforce pool provider key with the ID + my-key. + + $ gcloud iam workforce-pools providers keys undelete my-key \ + --location="global" --workforce-pool="my-workforce-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workforce pool provider key resource - The workforce pool provider key to + undelete. The arguments in this group can be used to specify the + attributes of this resource. + + This must be specified. + + KEY + ID of the workforce pool provider key or fully qualified identifier + for the workforce pool provider key. To set the key attribute: + ▸ provide the argument key 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 for the workforce pool. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID to use for the workforce pool provider, which becomes the + final component of the resource name. This value must be unique + within the workforce pool, 4-32 characters in length, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workforce-pool=WORKFORCE_POOL + The ID to use for the workforce pool, which becomes the final + component of the resource name. This value must be a globally unique + string of 6 to 63 lowercase letters, digits, or hyphens. It must + start with a letter, and cannot have a trailing hyphen. The prefix + gcp- is reserved for use by Google, and may not be specified. + + To set the workforce-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workforce-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ + +NOTES + These variants are also available: + + $ gcloud alpha iam workforce-pools providers keys undelete + + $ gcloud beta iam workforce-pools providers keys undelete + diff --git a/gcloud/iam/workload-identity-pools/providers/help b/gcloud/iam/workload-identity-pools/providers/help index 3250c090c..871fa53ed 100644 --- a/gcloud/iam/workload-identity-pools/providers/help +++ b/gcloud/iam/workload-identity-pools/providers/help @@ -17,6 +17,9 @@ GCLOUD WIDE FLAGS GROUPS GROUP is one of the following: + keys + Manage IAM workload identity pool provider keys. + operations Manage IAM workload identity pool provider long running operations. diff --git a/gcloud/iam/workload-identity-pools/providers/keys/create b/gcloud/iam/workload-identity-pools/providers/keys/create new file mode 100644 index 000000000..a1b7ae8c8 --- /dev/null +++ b/gcloud/iam/workload-identity-pools/providers/keys/create @@ -0,0 +1,99 @@ +NAME + gcloud iam workload-identity-pools providers keys create - create a new + workload identity pool provider key + +SYNOPSIS + gcloud iam workload-identity-pools providers keys create + (KEY : --location=LOCATION + --provider=PROVIDER --workload-identity-pool=WORKLOAD_IDENTITY_POOL) + --spec=SPEC --use=USE [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Create a new workload identity pool provider key. + +EXAMPLES + The following command creates a workload identity pool provider key in the + default project with the ID my-key. Explicit values for all required and + optional parameters are provided. + + $ gcloud iam workload-identity-pools providers keys create my-key \ + --location="global" \ + --workload-identity-pool="my-workload-identity-pool" \ + --provider="my-provider" --use="ENCRYPTION" --spec="RSA_4096" + +POSITIONAL ARGUMENTS + Workload identity pool provider key resource - The workload identity pool + provider key to create. The arguments in this group can be used to specify + the attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + KEY + ID of the workload identity pool provider key or fully qualified + identifier for the workload identity pool provider key. To set the + key attribute: + ▸ provide the argument key 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 name. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID for the provider, which becomes the final component of the + resource name. This value must be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workload-identity-pool=WORKLOAD_IDENTITY_POOL + The ID to use for the pool, which becomes the final component of the + resource name. This value should be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the workload-identity-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workload-identity-pool on the command + line. + +REQUIRED FLAGS + --spec=SPEC + The specifications for the key. SPEC must be one of: + key-spec-unspecified, rsa-2048, rsa-3072, rsa-4096. + + --use=USE + The purpose of the key. USE must be one of: encryption, + key-use-unspecified. + +OPTIONAL FLAGS + --async + Return immediately, without waiting for the operation in progress to + complete. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --access-token-file, --account, + --billing-project, --configuration, --flags-file, --flatten, --format, + --help, --impersonate-service-account, --log-http, --project, --quiet, + --trace-token, --user-output-enabled, --verbosity. + + Run $ gcloud help for details. + +API REFERENCE + This command uses the iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ diff --git a/gcloud/iam/workload-identity-pools/providers/keys/delete b/gcloud/iam/workload-identity-pools/providers/keys/delete new file mode 100644 index 000000000..d56d0a47a --- /dev/null +++ b/gcloud/iam/workload-identity-pools/providers/keys/delete @@ -0,0 +1,89 @@ +NAME + gcloud iam workload-identity-pools providers keys delete - delete a + workload identity pool provider key + +SYNOPSIS + gcloud iam workload-identity-pools providers keys delete + (KEY : --location=LOCATION + --provider=PROVIDER --workload-identity-pool=WORKLOAD_IDENTITY_POOL) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Delete a workload identity pool provider key. + +EXAMPLES + The following command deletes a workload identity pool provider key in the + default project with the ID my-key. + + $ gcloud iam workload-identity-pools providers keys delete my-key \ + --location="global" \ + --workload-identity-pool="my-workload-identity-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workload identity pool provider key resource - The workload identity pool + provider key 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 key on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + KEY + ID of the workload identity pool provider key or fully qualified + identifier for the workload identity pool provider key. To set the + key attribute: + ▸ provide the argument key 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 name. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID for the provider, which becomes the final component of the + resource name. This value must be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workload-identity-pool=WORKLOAD_IDENTITY_POOL + The ID to use for the pool, which becomes the final component of the + resource name. This value should be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the workload-identity-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workload-identity-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ diff --git a/gcloud/iam/workload-identity-pools/providers/keys/describe b/gcloud/iam/workload-identity-pools/providers/keys/describe new file mode 100644 index 000000000..7996abe95 --- /dev/null +++ b/gcloud/iam/workload-identity-pools/providers/keys/describe @@ -0,0 +1,84 @@ +NAME + gcloud iam workload-identity-pools providers keys describe - describe a + workload identity pool provider key + +SYNOPSIS + gcloud iam workload-identity-pools providers keys describe + (KEY : --location=LOCATION + --provider=PROVIDER --workload-identity-pool=WORKLOAD_IDENTITY_POOL) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a workload identity pool provider key. + +EXAMPLES + The following command describes a workload identity pool provider key in + the default project with the ID my-key. + + $ gcloud iam workload-identity-pools providers keys describe \ + my-key --location="global" \ + --workload-identity-pool="my-workload-identity-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workload identity pool provider key resource - The workload identity pool + provider key 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 key on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + KEY + ID of the workload identity pool provider key or fully qualified + identifier for the workload identity pool provider key. To set the + key attribute: + ▸ provide the argument key 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 name. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID for the provider, which becomes the final component of the + resource name. This value must be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workload-identity-pool=WORKLOAD_IDENTITY_POOL + The ID to use for the pool, which becomes the final component of the + resource name. This value should be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the workload-identity-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workload-identity-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ diff --git a/gcloud/iam/workload-identity-pools/providers/keys/help b/gcloud/iam/workload-identity-pools/providers/keys/help new file mode 100644 index 000000000..6aa41aa79 --- /dev/null +++ b/gcloud/iam/workload-identity-pools/providers/keys/help @@ -0,0 +1,39 @@ +NAME + gcloud iam workload-identity-pools providers keys - manage IAM workload + identity pool provider keys + +SYNOPSIS + gcloud iam workload-identity-pools providers keys GROUP | COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing IAM workload identity pool provider keys. + +GCLOUD WIDE FLAGS + These flags are available to all commands: --help. + + Run $ gcloud help for details. + +GROUPS + GROUP is one of the following: + + operations + Manage IAM workload identity pool provider key long running operations. + +COMMANDS + COMMAND is one of the following: + + create + Create a new workload identity pool provider key. + + delete + Delete a workload identity pool provider key. + + describe + Describe a workload identity pool provider key. + + list + List workload identity pool provider keys. + + undelete + Undelete a workload identity pool provider key. diff --git a/gcloud/iam/workload-identity-pools/providers/keys/list b/gcloud/iam/workload-identity-pools/providers/keys/list new file mode 100644 index 000000000..034dc930c --- /dev/null +++ b/gcloud/iam/workload-identity-pools/providers/keys/list @@ -0,0 +1,103 @@ +NAME + gcloud iam workload-identity-pools providers keys list - list workload + identity pool provider keys + +SYNOPSIS + gcloud iam workload-identity-pools providers keys list + (--provider=PROVIDER : --location=LOCATION + --workload-identity-pool=WORKLOAD_IDENTITY_POOL) [--show-deleted] + [--filter=EXPRESSION] [--limit=LIMIT] [--page-size=PAGE_SIZE] + [--sort-by=[FIELD,...]] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + List workload identity pool provider keys. + +EXAMPLES + The following command lists all keys in the workload identity pool + provider, including soft-deleted keys: + + $ gcloud iam workload-identity-pools providers keys list \ + --workload-identity-pool="my-workload-identity-pool" \ + --provider="my-provider" --location="global" --show-deleted + +REQUIRED FLAGS + Workload identity pool provider resource - The parent workload identity + pool provider to list keys for. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. To set the + project attribute: + ◆ provide the argument --provider on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + --provider=PROVIDER + ID of the workload identity pool provider or fully qualified + identifier for the workload identity pool provider. To set the + provider attribute: + ▸ provide the argument --provider 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 name. To set the location attribute: + ▸ provide the argument --provider on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --workload-identity-pool=WORKLOAD_IDENTITY_POOL + The ID to use for the pool, which becomes the final component of the + resource name. This value should be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the workload-identity-pool attribute: + ▸ provide the argument --provider on the command line with a fully + specified name; + ▸ provide the argument --workload-identity-pool on the command + line. + +FLAGS + --show-deleted + Whether to return soft-deleted resources. + +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. + +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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ diff --git a/gcloud/iam/workload-identity-pools/providers/keys/operations/describe b/gcloud/iam/workload-identity-pools/providers/keys/operations/describe new file mode 100644 index 000000000..4138bd79e --- /dev/null +++ b/gcloud/iam/workload-identity-pools/providers/keys/operations/describe @@ -0,0 +1,94 @@ +NAME + gcloud iam workload-identity-pools providers keys operations describe - + describe a workload identity pool provider key operation + +SYNOPSIS + gcloud iam workload-identity-pools providers keys operations describe + (OPERATION : --key=KEY --location=LOCATION + --provider=PROVIDER --workload-identity-pool=WORKLOAD_IDENTITY_POOL) + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Describe a workload identity pool provider key operation. + +EXAMPLES + To describe the long-running workload identity pool provider key operation + with the ID my-operation, run: + + $ gcloud iam workload-identity-pools providers keys operations \ + describe my-operation --workload-identity-pool="my-pool" \ + --provider="my-provider" --key="my-key" --location="global" + +POSITIONAL ARGUMENTS + Workload identity pool provider key operation resource - The workload + identity pool provider key long-running operation 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 operation on the command line with a fully + specified name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + OPERATION + ID of the workload identity pool provider key operation or fully + qualified identifier for the workload identity pool provider key + operation. To set the operation attribute: + ▸ provide the argument operation on the command line. + + This positional argument must be specified if any of the other + arguments in this group are specified. + + --key=KEY + The ID for the key, which becomes the final component of the resource + name. This value must be 4-32 characters, and may contain the + characters [a-z0-9-]. The prefix gcp- is reserved for use by Google, + and may not be specified. + + To set the key attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --key on the command line. + + --location=LOCATION + The location name. To set the location attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID for the provider, which becomes the final component of the + resource name. This value must be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workload-identity-pool=WORKLOAD_IDENTITY_POOL + The ID to use for the pool, which becomes the final component of the + resource name. This value should be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the workload-identity-pool attribute: + ▸ provide the argument operation on the command line with a fully + specified name; + ▸ provide the argument --workload-identity-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ diff --git a/gcloud/iam/workload-identity-pools/providers/keys/operations/help b/gcloud/iam/workload-identity-pools/providers/keys/operations/help new file mode 100644 index 000000000..2d0b6fd29 --- /dev/null +++ b/gcloud/iam/workload-identity-pools/providers/keys/operations/help @@ -0,0 +1,22 @@ +NAME + gcloud iam workload-identity-pools providers keys operations - manage IAM + workload identity pool provider key long running operations + +SYNOPSIS + gcloud iam workload-identity-pools providers keys operations COMMAND + [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Commands for managing IAM workload identity pool provider key long running + operations. + +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 a workload identity pool provider key operation. diff --git a/gcloud/iam/workload-identity-pools/providers/keys/undelete b/gcloud/iam/workload-identity-pools/providers/keys/undelete new file mode 100644 index 000000000..9d8c2ee27 --- /dev/null +++ b/gcloud/iam/workload-identity-pools/providers/keys/undelete @@ -0,0 +1,89 @@ +NAME + gcloud iam workload-identity-pools providers keys undelete - undelete a + workload identity pool provider key + +SYNOPSIS + gcloud iam workload-identity-pools providers keys undelete + (KEY : --location=LOCATION + --provider=PROVIDER --workload-identity-pool=WORKLOAD_IDENTITY_POOL) + [--async] [GCLOUD_WIDE_FLAG ...] + +DESCRIPTION + Undelete a workload identity pool provider key. + +EXAMPLES + The following command undeletes a workload identity pool provider key in + the default project with the ID my-key. + + $ gcloud iam workload-identity-pools providers keys undelete \ + my-key --location="global" \ + --workload-identity-pool="my-workload-identity-pool" \ + --provider="my-provider" + +POSITIONAL ARGUMENTS + Workload identity pool provider key resource - The workload identity pool + provider key to undelete. The arguments in this group can be used to + specify the attributes of this resource. (NOTE) Some attributes are not + given arguments in this group but can be set in other ways. To set the + project attribute: + ◆ provide the argument key on the command line with a fully specified + name; + ◆ set the property core/project; + ◆ provide the argument --project on the command line. + + This must be specified. + + KEY + ID of the workload identity pool provider key or fully qualified + identifier for the workload identity pool provider key. To set the + key attribute: + ▸ provide the argument key 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 name. To set the location attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --location on the command line. + + --provider=PROVIDER + The ID for the provider, which becomes the final component of the + resource name. This value must be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the provider attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --provider on the command line. + + --workload-identity-pool=WORKLOAD_IDENTITY_POOL + The ID to use for the pool, which becomes the final component of the + resource name. This value should be 4-32 characters, and may contain + the characters [a-z0-9-]. The prefix gcp- is reserved for use by + Google, and may not be specified. + + To set the workload-identity-pool attribute: + ▸ provide the argument key on the command line with a fully + specified name; + ▸ provide the argument --workload-identity-pool 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 iam/v1 API. The full documentation for this API can + be found at: https://cloud.google.com/iam/ diff --git a/gcloud/iap/oauth-brands/describe b/gcloud/iap/oauth-brands/describe index a5bd7a1d9..9bb2ad09a 100644 --- a/gcloud/iap/oauth-brands/describe +++ b/gcloud/iap/oauth-brands/describe @@ -18,9 +18,10 @@ EXAMPLES $ gcloud iap oauth-brands describe NAME --project=PROJECT_ID POSITIONAL ARGUMENTS - Name resource - Name of the Cloud OAuth brand to describe. 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: + Brand resource - Name of the Cloud OAuth brand to describe. 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 name on the command line with a fully specified name; ◆ provide the argument --project on the command line; @@ -29,8 +30,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - brand attribute: + ID of the brand or fully qualified identifier for the brand. To set + the brand attribute: ▸ provide the argument name on the command line. GCLOUD WIDE FLAGS diff --git a/gcloud/iap/oauth-clients/delete b/gcloud/iap/oauth-clients/delete index c17dce7d5..90422699c 100644 --- a/gcloud/iap/oauth-clients/delete +++ b/gcloud/iap/oauth-clients/delete @@ -23,7 +23,7 @@ EXAMPLES --project=PROJECT_ID POSITIONAL ARGUMENTS - Name resource - Name of the Cloud IAP OAuth client to delete. The + Proxy client resource - Name of the Cloud IAP OAuth client 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: @@ -35,8 +35,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - identity_aware_proxy_clients attribute: + ID of the proxy client or fully qualified identifier for the proxy + client. To set the identity_aware_proxy_clients attribute: ▸ provide the argument name on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/iap/oauth-clients/describe b/gcloud/iap/oauth-clients/describe index d8cb0e087..70a743837 100644 --- a/gcloud/iap/oauth-clients/describe +++ b/gcloud/iap/oauth-clients/describe @@ -20,8 +20,8 @@ EXAMPLES $ gcloud iap oauth-clients describe NAME --brand=BRAND POSITIONAL ARGUMENTS - Name resource - Name of the Cloud IAP OAuth client to describe. The - arguments in this group can be used to specify the attributes of this + Proxy client resource - Name of the Cloud IAP OAuth client 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 name on the command line with a fully specified @@ -32,8 +32,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - identity_aware_proxy_clients attribute: + ID of the proxy client or fully qualified identifier for the proxy + client. To set the identity_aware_proxy_clients attribute: ▸ provide the argument name on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/iap/oauth-clients/list b/gcloud/iap/oauth-clients/list index dcc9c4880..17f1afec7 100644 --- a/gcloud/iap/oauth-clients/list +++ b/gcloud/iap/oauth-clients/list @@ -17,7 +17,7 @@ EXAMPLES $ gcloud iap oauth-clients list BRAND POSITIONAL ARGUMENTS - Name resource - Name of the Cloud OAuth brand to list Cloud IAP OAuth + Brand resource - Name of the Cloud OAuth brand to list Cloud IAP OAuth clients under. 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: @@ -29,8 +29,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - brand attribute: + ID of the brand or fully qualified identifier for the brand. To set + the brand attribute: ▸ provide the argument name on the command line. LIST COMMAND FLAGS diff --git a/gcloud/iap/oauth-clients/reset-secret b/gcloud/iap/oauth-clients/reset-secret index aca192fd9..46b7db4d6 100644 --- a/gcloud/iap/oauth-clients/reset-secret +++ b/gcloud/iap/oauth-clients/reset-secret @@ -21,10 +21,11 @@ EXAMPLES $ gcloud iap oauth-clients reset-secret NAME --brand=BRAND POSITIONAL ARGUMENTS - Name resource - Name of the Cloud IAP OAuth client whose secret will be - reset. 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: + Proxy client resource - Name of the Cloud IAP OAuth client whose secret + will be reset. The arguments in this group can be used to specify the + attributes of this resource. (NOTE) Some attributes are not given + arguments in this group but can be set in other ways. To set the project + attribute: ◆ provide the argument name on the command line with a fully specified name; ◆ provide the argument --project on the command line; @@ -33,8 +34,8 @@ POSITIONAL ARGUMENTS This must be specified. NAME - ID of the name or fully qualified identifier for the name. To set the - identity_aware_proxy_clients attribute: + ID of the proxy client or fully qualified identifier for the proxy + client. To set the identity_aware_proxy_clients attribute: ▸ provide the argument name on the command line. This positional argument must be specified if any of the other diff --git a/gcloud/ml-engine/jobs/submit/training b/gcloud/ml-engine/jobs/submit/training index 53135411c..8056a011e 100644 --- a/gcloud/ml-engine/jobs/submit/training +++ b/gcloud/ml-engine/jobs/submit/training @@ -146,7 +146,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -186,7 +186,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. @@ -304,7 +304,7 @@ FLAGS type Type of the accelerator. Choices are - nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4 + nvidia-tesla-a100,nvidia-tesla-k80,nvidia-tesla-p100,nvidia-tesla-p4,nvidia-tesla-t4,nvidia-tesla-v100,tpu-v2,tpu-v2-pod,tpu-v3,tpu-v3-pod,tpu-v4-pod count Number of accelerators to attach to each machine running the job. diff --git a/gcloud/storage/buckets/update b/gcloud/storage/buckets/update index f411402b6..50966a0b0 100644 --- a/gcloud/storage/buckets/update +++ b/gcloud/storage/buckets/update @@ -33,7 +33,7 @@ SYNOPSIS | --web-main-page-suffix=WEB_MAIN_PAGE_SUFFIX] [GCLOUD_WIDE_FLAG ...] DESCRIPTION - Update a bucket. + Update the settings for a bucket. EXAMPLES The following command updates the default storage class of a Cloud Storage @@ -169,8 +169,8 @@ FLAGS } ] - For more information about supported endpoints for CORS, see [Cloud - Storage CORS support] + For more information about supported endpoints for CORS, see Cloud + Storage CORS support (https://cloud.google.com/storage/docs/cross-origin#server-side-support). At most one of these can be specified: @@ -252,11 +252,10 @@ FLAGS Unsets the public access prevention setting on a bucket. --[no-]pap, --[no-]public-access-prevention - If True, sets public access prevention to "enforced". If False, sets - public access prevention to "inherited". For details on how exactly - public access is blocked, see: - http://cloud.google.com/storage/docs/public-access-prevention. Use - --public-access-prevention to enable and + If True, sets public access prevention + (https://cloud.google.com/storage/docs/public-access-prevention) to + "enforced". If False, sets public access prevention to "inherited". + Use --public-access-prevention to enable and --no-public-access-prevention to disable. At most one of these can be specified: